1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/docs/maciej-patelczyk_masqmail_pl.txt	Thu Sep 18 18:58:49 2008 +0200
     1.3 @@ -0,0 +1,338 @@
     1.4 +DebianUsers.pl (beta)
     1.5 +Ślad: » MasqMail -- szybkie wprowadzenie
     1.6 +Start Artykuły Tips & Tricks Wideo Wyszukaj w serwisie Archiwum
     1.7 +Spis treści
     1.8 +
     1.9 +  • Streszczenie
    1.10 +  • Prawa autorskie
    1.11 +  • Spis treści
    1.12 +  • 1. O programie
    1.13 +  • 2. Konfiguracja
    1.14 +  • 2.1. Plik masqmail.conf
    1.15 +  • 2.2. Wysyłanie poczty
    1.16 +  • 2.3. Pobieranie poczty
    1.17 +  • 3. MasqMail w systemie
    1.18 +  • 4. Podsumowanie
    1.19 +  • 5. Pliki konfiguracyjne
    1.20 +  • Dyskusja
    1.21 +
    1.22 +  drukuj wersja do wydruku
    1.23 +
    1.24 +MasqMail -- szybkie wprowadzenie
    1.25 +
    1.26 +Maciej Patelczyk <maf@ubik.zamek.gda.pl>
    1.27 +
    1.28 +Streszczenie
    1.29 +
    1.30 +MasqMail jest serwerem poczty zaprojektowanym dla hostów nie posiadających
    1.31 +stałego połączenia z siecią Internet, takich jak proste sieci komputerowe, czy
    1.32 +pojedyncze komputery, łączące się z Internetem poprzez modem. Program potrafi
    1.33 +obsługiwać połączenia do różnych dostawców Internetu (ang. ISP – Internet
    1.34 +Services Provider). Jest zamiennikiem dla programu Sendmail, czy innych
    1.35 +serwerów pocztowych (ang. MTA – Mail Transfer Agent), takich jak Qmail czy
    1.36 +Exim. Może również służyć jako klient POP3.
    1.37 +
    1.38 +Takiej treści wstęp widnieje na stronie podręcznika systemowego do programu.
    1.39 +Trafiłem na niego szukając w Debianie jakiegoś serwera poczty dla hosta
    1.40 +łączącego się z Internetem poprzez modem. Nie miałem ochoty konfigurować
    1.41 +serwera Exim, więc szukałem czegoś innego. Po przeczytaniu opisu, MasqMail
    1.42 +wydał mi się idealny dla moich potrzeb.
    1.43 +
    1.44 +Prawa autorskie
    1.45 +
    1.46 +Copyright (C) 2003 Maciej Patelczyk. All rights reserved.
    1.47 +
    1.48 +Udziela się zgody na kopiowanie, rozpowszechnianie i/lub modyfikowanie tego
    1.49 +dokumentu zgodnie z zasadami Licencji Wolnej Dokumentacji (GNU Free
    1.50 +Documentation Licence) w wersji 1.1 lub jakiejkolwiek późniejszej wersji
    1.51 +opublikowanej przez Fundację Wolnego Oprogramowania (Free Software Foundation).
    1.52 +Kopię tej licencji można znaleźć na stronach Fundacji Wolnego Oprogramowania.
    1.53 +
    1.54 +Spis treści
    1.55 +
    1.56 +1. O programie2. Konfiguracja2.1. Plik masqmail.conf2.2. Wysyłanie poczty2.3.
    1.57 +Pobieranie poczty3. MasqMail w systemie4. Podsumowanie5. Pliki konfiguracyjne
    1.58 +
    1.59 +1. O programie
    1.60 +
    1.61 +MasqMail został oryginalnie napisany przez Olivera Kurtha, zaś Gregor Hoffleit
    1.62 +przystosował program do wymogów dystrybucji i przygotował dla niej paczkę.
    1.63 +
    1.64 +MasqMail jest bardzo prostym serwerem pocztowym. Nie warto go stosować, jeżeli
    1.65 +host jest na stałe podłączony do Internetu. Jako serwer pocztowy, potrafi
    1.66 +rozsyłać wiadomości przy pomocy protokołu SMTP/ESMTP, a jako program do
    1.67 +pobierania poczty obsługuje protokoły POP3 i APOP. Ponieważ MasqMail miał być
    1.68 +przede wszystkim zamiennikiem dla programu Sendmail, to używa podobnych jak on
    1.69 +opcji wywołania, choć nie wszystkie z nich są jednak zaimplementowane.
    1.70 +
    1.71 +MasqMail doskonale nadaje się do zastosowania w laptopach i domowych
    1.72 +komputerach, łączących się od czasu do czasu z Siecią poprzez modem. Sprawdza
    1.73 +się również jako serwer poczty dla małych sieci komputerowych nie posiadających
    1.74 +stałego łącza z Internetem. Działając jako serwer poczty przyjmuje pocztę,
    1.75 +kolejkuję ją, a gdy wykryje połączenie z Internetem, to natychmiast stara się
    1.76 +ją rozesłać. Potrafi określić czy adresat (host) należy do wewnętrznej sieci, a
    1.77 +jeżeli tak, to nie będzie jej kolejkował, tylko niezwłocznie wyśle.
    1.78 +
    1.79 +2. Konfiguracja
    1.80 +
    1.81 +Główny plik konfiguracyjny programu to plik ”/etc/masqmail/masqmail.conf”. W
    1.82 +pliku tym, oprócz głównych ustawień programu, opisuje się sposoby zachowania
    1.83 +się serwera w zależności od używanego dostawcy Internetu. Można w nim określić
    1.84 +kto może wysyłać pocztę, do jakich hostów i za pomocą jakiego połączenia to
    1.85 +robi.
    1.86 +
    1.87 +2.1. Plik masqmail.conf
    1.88 +
    1.89 +Pierwszą rzeczą jaką zwykle się konfiguruje jest nazwa hosta:
    1.90 +
    1.91 +host_name="host.domena.pl"
    1.92 +
    1.93 +Następnie określane są te hosty, które będą traktowane jako lokalne, czyli
    1.94 +należące do lokalnej sieci komputerowej. Podaje się tutaj listę, w której
    1.95 +separatorem jest ”';'”.
    1.96 +
    1.97 +local_hosts="host;host.domena.pl;localhost"
    1.98 +
    1.99 +Później informujemy serwer, aby nasłuchiwał na odpowiednich portach:
   1.100 +
   1.101 +listen_addresses="nazwa_hosta:25;localhost:25"
   1.102 +
   1.103 +Możemy również określić, na jaki port będą wysyłane wiadomości:
   1.104 +
   1.105 +remote_port=25
   1.106 +
   1.107 +Katalog, w którym umieszczona będzie kolejka wiadomości i temu podobne określa
   1.108 +się za pomocą zmiennej „spool_dir”:
   1.109 +
   1.110 +spool_dir="/var/spool/masqmail"
   1.111 +
   1.112 +Katalog, w którym zapisywane będą lokalne wiadomości wskazuje zmienna
   1.113 +„mail_dir”:
   1.114 +
   1.115 +mail_dir="/var/mail"
   1.116 +
   1.117 +Program może samodzielnie zapisywać zdarzenia lub może do tego celu użyć demona
   1.118 +„syslogd”. Ustawienie zmiennej na ”'true'” powoduje, iż wszelkie zdarzenia
   1.119 +loguje „syslogd”:
   1.120 +
   1.121 +use_syslog=false
   1.122 +
   1.123 +Trzeba jeszcze ustawić katalog, w którym zapisywane będą logi:
   1.124 +
   1.125 +log_dir="/var/log/masqmail"
   1.126 +
   1.127 +Ustawienie poniższej zmiennej na ”'true'” powoduje, że wiadomości nie będą
   1.128 +natychmiastowo wysyłane, ale kolejkowane i rozsyłane przy następnym cyklu:
   1.129 +
   1.130 +do_queue=false
   1.131 +
   1.132 +Trzeba również skonfigurować sposób w jaki serwer będzie wykrywał stan online.
   1.133 +Najprościej do tego celu wykorzystać metodę „file”.
   1.134 +
   1.135 +online_detect = file
   1.136 +online_file = "/tmp/connect_route"
   1.137 +
   1.138 +Przy połączeniu z Siecią, skrypt startowy znajdujący się w katalogu ”/etc/ppp/
   1.139 +ip-up.d” utworzy zadany plik, którego zawartością będzie nazwa dostawcy
   1.140 +Internetu, za pośrednictwem którego nastąpiło połącznie. Przy rozłączeniu plik
   1.141 +ten zostanie skasowany.
   1.142 +
   1.143 +Potrzebne jest również ustawienie sposobu lokalnego dostarczenia poczty (na
   1.144 +przykład po ściągnięciu ze skrzynki). Najprościej zrobić to w następujący
   1.145 +sposób:
   1.146 +
   1.147 +mda="/usr/bin/procmail -Y -d ${rcpt_local}"
   1.148 +
   1.149 +Oczywiście program „procmail” musi być zainstalowany.
   1.150 +
   1.151 +Dalsze sekcje zawierają konfigurację aliasów, którą tutaj pominę. Więcej
   1.152 +szczegółów na ten temat można znaleźć w dostępnej dokumentacji.
   1.153 +
   1.154 +Ostatnią rzeczą do skonfigurowania w pliku „masqmail.conf” jest
   1.155 +przyporządkowanie poszczególnym dostawcom Internetu określonych zachowań
   1.156 +serwera, które opisane są w osobnych plikach.
   1.157 +
   1.158 +Wysyłaniem poczty poprzez jedno połączenie może sterować jeden lub kilka plików
   1.159 +„route”. Można utworzyć listę, której separatorem jest znak ”';'”.
   1.160 +
   1.161 +connect_route.nazwa_połączenia = "/etc/masqmail/nazwa_połączenia.route"
   1.162 +
   1.163 +lub
   1.164 +
   1.165 +connect_route.foo = "/etc/masqmail/foo.route;/etc/masqmail/bar.route"
   1.166 +
   1.167 +Choć nazwy plików mogą być dowolne, to warto się jednak trzymać schematu: nazwa
   1.168 +pliku odpowiada nazwie dostawcy Internetu, natomiast
   1.169 +„connect_route.nazwa_połączenia” musi dokładnie odpowiadać nazwie zestawionego
   1.170 +połączenia. Serwer odczyta bowiem nazwę połączenia z pliku ”/tmp/connect_route”
   1.171 +i będzie próbował znaleźć odpowiedni wpis w ”/etc/masqmail/masqmail.conf”.
   1.172 +
   1.173 +Przy pobieraniu poczty poprzez MasqMail należy jeszcze skonfigurować, skąd
   1.174 +pobierać pocztę:
   1.175 +
   1.176 +get.nazwa_połączenia = /etc/masqmail/nazwa_konta.get
   1.177 +
   1.178 +Jeżeli poczta będzie ściągana z więcej niż jednego konta, to wpis należy po
   1.179 +prostu zwielokrotnić, zmieniając nazwy plików:
   1.180 +
   1.181 +get.nazwa_połączenia = /etc/masqmail/konto_1.get
   1.182 +get.nazwa_połączenia = /etc/masqmail/konta_2.get
   1.183 +
   1.184 +Jeżeli wywołamy MasqMail z argumentem ”-g”, to zacznie on po kolei pobierać
   1.185 +pocztę według podanej kolejności.
   1.186 +
   1.187 +2.2. Wysyłanie poczty
   1.188 +
   1.189 +Aby móc wysyłać pocztę przy użyciu MasqMaila, potrzeba skonfigurować
   1.190 +przynajmniej jeden plik „route”. Poniżej zamieszczona jest minimalna potrzebna
   1.191 +konfiguracja.
   1.192 +
   1.193 +MasqMail umożliwia łącznie się z różnymi dostawcami Internetu, zaimplementowano
   1.194 +więc w nim mechanizm pozwalający określać, jaki użytkownik może wysyłać pocztę
   1.195 +danym połączeniem. Jeżeli nie jest to istotne lub połączenie odbywa się tylko
   1.196 +poprzez jednego dostawcę, to wystarczy podstawić wartość pustą. Przed wysłaniem
   1.197 +poczty sprawdzana jest lokalna część adresu i na tej podstawie podejmowana jest
   1.198 +decyzja.
   1.199 +
   1.200 +allowed_mail_locals = "janek;tadek;kasia"
   1.201 +
   1.202 +lub gdy nie ma ograniczeń:
   1.203 +
   1.204 +allowed_mail_locals = ""
   1.205 +
   1.206 +Innym kryterium jest lista niedozwolonych domen. Można ustalić, czy za pomocą
   1.207 +danego połączenia można wysyłać pocztę do określonych domen. Można podać listę,
   1.208 +w której akceptowane są znaki ”'*'” oraz ”'?'”. Separatorem jak zwykle jest
   1.209 +znak ”';'”.
   1.210 +
   1.211 +not_allowed_rcpt_domains = "*.foo.bar"
   1.212 +
   1.213 +Trzeba też określić, czy serwer ma rozsyłać pocztę bezpośrednio do każdego
   1.214 +hosta, czy też cała poczta ma wędrować do innego serwera pocztowego,
   1.215 +najczęściej będącego w posiadaniu dostawcy Internetu. Generalnie lepiej
   1.216 +przesłać całą pocztę do innego serwera i niech tamten się martwi, co dalej z
   1.217 +nią zrobić. Nie ustawienie zmiennej „mail_host” powoduje, iż poczta będzie
   1.218 +rozsyłana bezpośrednio do adresatów.
   1.219 +
   1.220 +mail_host = "mail.isp.pl"
   1.221 +
   1.222 +Ustawienie wartości zmiennej „do_correct_helo” na ”'true'” powoduje, że w
   1.223 +komunikacie HELO/EHLO wysyłana jest nazwa hosta taka, jaka jest widziana z
   1.224 +zewnątrz sieci. Niektórzy dostawcy przy połączeniu nadają łączącym się hostom
   1.225 +oprócz adresu IP również nazwę. Zarówno adres jak i nazwa mogą być znane tylko
   1.226 +w obrębie sieci danego dostawcy, dlatego wysyłając taką nazwę serwerowi
   1.227 +pocztowemu, który sprawdza, czy dany host istnieje można spotkać się z odmową
   1.228 +przyjęcia poczty. Warto zatem ustawić tę zmienną:
   1.229 +
   1.230 +do_correct_helo = true
   1.231 +
   1.232 +W sumie to już wszystko na temat konfiguracji wysyłanej poczty. W dalszej
   1.233 +części pliku są sekcje dotyczące zamiany nagłówków „From:” i „Return-Path:”.
   1.234 +Jeżeli chcesz dowiedzieć się więcej na ten temat, zajrzyj do dokumentacji.
   1.235 +
   1.236 +2.3. Pobieranie poczty
   1.237 +
   1.238 +Jeżeli MasqMail ma służyć również do pobierania poczty z różnych skrzynek
   1.239 +pocztowych, to trzeba stworzyć proste pliki odpowiedzialne za obsługę każdego
   1.240 +konta z osobna.
   1.241 +
   1.242 +Typowy plik „nazwa_konta.get” wygląda następująco:
   1.243 +
   1.244 +# Protokół. W tej chwili są zaimplementowane tylko protokoły 'pop3' i 'apop'.
   1.245 +# Apop (szyfrowanie haseł) jest polecany, jeżeli tylko serwer go wspiera.
   1.246 +protocol=pop3
   1.247 +
   1.248 +# Serwer pocztowy:
   1.249 +server = pop.example.org
   1.250 +
   1.251 +# Nazwa konta:
   1.252 +user=nazwa_użytkownika
   1.253 +
   1.254 +# Hasło:
   1.255 +pass="moje hasło"
   1.256 +
   1.257 +# Lokalny adres, gdzie pobrana poczta ma być dostarczona:
   1.258 +address=nazwa_użytkonika@localhost
   1.259 +
   1.260 +# Czy kasować pocztę z serwera po jej pobraniu? Wartość "false" oznacza
   1.261 +# ksujesz poczty na serwerze, to zdecydowanie ustaw tutaj wartość
   1.262 +# "true", inaczej otrzymasz tę samą pocztę za każdym cyklem pobierania.
   1.263 +# Masqmail kompletnie ignoruje jakiekolwiek nagłówki (niektóre mogą oznaczać
   1.264 +# przeczytanie już wiadomości).
   1.265 +do_uidl=false
   1.266 +
   1.267 +Jak widać, nie ma tu żadnej magii. Tyle na temat konfiguracji pobierania
   1.268 +poczty.
   1.269 +
   1.270 +3. MasqMail w systemie
   1.271 +
   1.272 +MasqMail jest wywoływany przy starcie systemu. Domyślnie jest uruchamiany z
   1.273 +argumentami ”-bd” i ”-q10m”. Pierwszy z nich oznacza, że program startuje jako
   1.274 +demon i nasłuchuje na określonym porcie, zazwyczaj na 25. Drugi oznacza, iż
   1.275 +kolejkowanie wiadomości lokalnych ma się odbywać co 10 minut. Nie dotyczy to
   1.276 +wiadomości dla hostów nie ujętych jako lokalne.
   1.277 +
   1.278 +Gdy nastąpi połączenie z Internetem, to wywołany zostanie skrypt ”/etc/ppp/
   1.279 +ip-up.d/1masqmail”. Jego zawartość jest mniej więcej taka, jak poniżej
   1.280 +(większość pominięto):
   1.281 +
   1.282 +echo -n "$PROVIDER" > /tmp/connect_route
   1.283 +chmod 0644 /tmp/connect_route
   1.284 +
   1.285 +/usr/sbin/masqmail -qo &
   1.286 +
   1.287 +if grep -qsx "^get.$PROVIDER.*=.*" /etc/masqmail/masqmail.conf; then
   1.288 +    /usr/sbin/masqmail -g &
   1.289 +fi
   1.290 +
   1.291 +Natychmiast po ustanowieniu połączenia skrypt tworzy plik ”/tmp/connect_route”
   1.292 +z informacją, z którym dostawcą Internetu nastąpiło połączenie. Jest to
   1.293 +zazwyczaj argument demona „pppd”. Następnie MasqMail wywoływany jest z
   1.294 +argumentem ”-qo”, co oznacza iż cała poczta przeznaczona do adresatów
   1.295 +nielokalnych zostanie rozesłana, o ile to oczywiście jest możliwe. Na końcu
   1.296 +sprawdzane jest, czy MasqMail ma działać dla zadanego dostawcy jako program do
   1.297 +ściągania poczty. Jeżeli tak, to poprzez wywołanie go z argumentem ”-g” nastąpi
   1.298 +sprawdzenie i ściągnięcie poczty z określonych wcześniej kont.
   1.299 +
   1.300 +Przy rozłączaniu wykonywany jest skrypt ”/etc/ppp/ip-down.d/99masqmail”, który
   1.301 +właściwie tylko kasuje plik ”/tmp/connect_route”:
   1.302 +
   1.303 +if [ -f /tmp/connect_route ]; then
   1.304 +    rm -f /tmp/connect_route
   1.305 +fi
   1.306 +
   1.307 +4. Podsumowanie
   1.308 +
   1.309 +Przedstawiono tutaj jedynie podstawową konfigurację programu, która w
   1.310 +zupełności powinna wystarczyć osobom łączącym się z Internetem za pomocą
   1.311 +modemu. Na stronach podręcznika systemowego i w katalogu ”/usr/share/doc/
   1.312 +masqmail” zamieszczono więcej informacji. Jeżeli MasqMail ma działać jako
   1.313 +serwer pocztowy dla małej sieci osiedlowej z jednym połączeniem modemowym, to
   1.314 +lepiej zajrzeć do dokumentacji i dokładnie ją przestudiować.
   1.315 +
   1.316 +5. Pliki konfiguracyjne
   1.317 +
   1.318 +Poniżej zamieszczono odnośniki do przetłumaczonych plików konfiguracyjnych:
   1.319 +
   1.320 +  • masqmail.conf
   1.321 +  • example.route
   1.322 +  • example.get
   1.323 +
   1.324 +Dyskusja
   1.325 +
   1.326 +articles/41.txt · ostatnio zmienione: 2008/01/11 21:41 (edycja zewnętrzna)
   1.327 +
   1.328 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   1.329 +
   1.330 +  • Indeks
   1.331 +  • Ostatnie zmiany
   1.332 +
   1.333 +[                    ][Szukaj]
   1.334 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   1.335 +
   1.336 +  • Zaloguj
   1.337 +
   1.338 + 
   1.339 + 
   1.340 +Recent changes RSS feed Creative Commons License Donate Driven by DokuWiki
   1.341 +*