Zainstaluj Mailpit w CasaOS, korzystając z oficjalnego obrazu Dockera axllent/mailpit, portu 8025 dla skrzynki odbiorczej w interfejsie WWW oraz portu 1025 dla SMTP. Trwałe mapowanie /data jest potrzebne tylko wtedy, gdy chcesz zachować wiadomości i ustawienia po odtworzeniu kontenera.
Stary poradnik BigBearCasaOS nadal jest przydatny jako przykład instalacji jednym kliknięciem, ale aktualna dokumentacja Mailpit projektu upstream zawiera już dokładny obraz Dockera, opcję trwałej bazy danych, opcje uwierzytelniania oraz ustawienia TLS i przekazywania wiadomości. To one powinny stanowić podstawę poradnika na 2026 rok.
Do czego służy Mailpit
Mailpit to lokalny serwer SMTP do testowania aplikacji przez programistów. Aplikacje wysyłają testowe wiadomości do Mailpit zamiast do prawdziwego dostawcy poczty, a Ty przeglądasz je w przeglądarce.
Nie jest to zwykła produkcyjna skrzynka pocztowa ani serwer pocztowy dostępny z internetu.
Użyj oficjalnego obrazu Dockera
Aktualny poradnik Dockera dla Mailpit opisuje obraz:
axllent/mailpitMapowanie portów w CasaOS
- 8025/TCP: interfejs WWW Mailpit
- 1025/TCP: odbiornik SMTP
Jeśli inna usługa korzysta już z któregoś z tych portów hosta, zmień port po stronie hosta, pozostawiając bez zmian port po stronie kontenera.
Podstawowe ustawienia niestandardowej aplikacji w CasaOS
image: axllent/mailpit
restart: unless-stopped
ports:
- "8025:8025"
- "1025:1025"Po uruchomieniu otwórz adres http://CASAOS-IP:8025.
Skieruj aplikację do Mailpit
W przypadku innego kontenera działającego w tej samej sieci Dockera użyj nazwy usługi lub kontenera Mailpit oraz portu 1025. W przypadku aplikacji działającej w sieci LAN użyj adresu IP hosta CasaOS i opublikowanego portu SMTP hosta.
Zapisuj wiadomości trwale tylko wtedy, gdy tego potrzebujesz
Aktualna dokumentacja Mailpit obsługuje bazę danych SQLite w katalogu /data, korzystając z ustawienia:
MP_DATABASE=/data/mailpit.dbJeśli chcesz zachować historię wiadomości po wymianie kontenera, zamapuj folder AppData CasaOS na /data.
Zachowaj prywatność Mailpit
Testowa skrzynka odbiorcza może zawierać linki do resetowania haseł, powiadomienia API oraz dane aplikacji. Nie udostępniaj bezpośrednio internetu interfejsu WWW ani nieuwierzytelnionego odbiornika SMTP.
Aktualny poradnik konfiguracji Mailpit opisuje uwierzytelnianie HTTP, SMTP i POP3 oraz opcje TLS.
Kiedy nie trzeba publikować portu 1025
Jeśli wiadomości do Mailpit wysyłają wyłącznie kontenery w tej samej sieci Compose, możesz pominąć publikowanie portu SMTP na hoście i pozostawić go dostępnym tylko wewnątrz Dockera.
Poradnik dotyczący sieci Dockera wyjaśnia ten sam model izolacji.
Przetestuj ścieżkę SMTP przed podłączeniem aplikacji
Po uruchomieniu Mailpit sprawdź, czy interfejs WWW otwiera się prawidłowo, a następnie wyślij jedną testową wiadomość z prostego klienta SMTP lub swojej aplikacji. Jeśli wiadomość natychmiast pojawi się w skrzynce odbiorczej Mailpit, oznacza to, że zarówno ścieżka sieciowa, jak i odbiornik SMTP działają.
Jeśli aplikacja zgłasza odmowę połączenia, sprawdź, czy korzysta z prawidłowej nazwy hosta w swoim kontekście sieciowym. Kontener powinien zwykle używać nazwy usługi Mailpit, a laptop w sieci LAN — adresu IP hosta CasaOS.
Włącz uwierzytelnianie tylko wtedy, gdy wymaga tego test
Mailpit może akceptować nieuwierzytelniony SMTP na potrzeby prostego programowania lokalnego, ale aktualne opcje konfiguracji obsługują również uwierzytelnianie SMTP i interfejsu WWW. Włącz je, gdy z laboratorium korzysta wielu użytkowników lub gdy usługa jest dostępna spoza jednej zaufanej sieci Dockera.
Oddziel pocztę testową od produkcyjnej
Mailpit służy do przechwytywania wiadomości, aby nie trafiały przypadkowo do prawdziwych użytkowników. Jawnie kieruj aplikacje deweloperskie i testowe do Mailpit, a dane uwierzytelniające produkcyjnego SMTP przechowuj w osobnej konfiguracji. Zapobiega to wysłaniu do klientów testowej wiadomości o resetowaniu hasła lub zalewu powiadomień.
Ustaw limit wiadomości w długo działających laboratoriach
Mailpit może przechowywać tysiące wiadomości. W stale działającym środowisku CI lub laboratorium domowym ustaw rozsądny limit i zapisuj trwale tylko te dane, których rzeczywiście potrzebujesz. W przeciwnym razie małe narzędzie testowe może z czasem stać się kolejną bazą danych wymagającą utrzymania.
FAQ
Jakie są domyślne porty Mailpit?
8025 dla interfejsu WWW oraz 1025 dla SMTP.
Czy Mailpit wysyła prawdziwe wiadomości e-mail?
Jego głównym zadaniem jest lokalne przechwytywanie testowej poczty. Można go skonfigurować do przekazywania wiadomości, ale wymaga to osobnej, jawnej konfiguracji.
Czy potrzebuję bazy danych?
Nie, jeśli wykonujesz tymczasowe testy. Użyj opcji bazy danych SQLite, jeśli chcesz zachować historię wiadomości.
Czy należy publicznie udostępniać Mailpit?
Nie. Pozostaw go w zaufanej sieci albo zabezpiecz uwierzytelnianiem i TLS.
