Przewodnik konfiguracji usługi Mailpit w ServBay

ServBay integruje pakiet Mailpit, zapewniając wygodny, lokalny serwer pocztowy stworzony z myślą o deweloperach do testowania i debugowania funkcji wysyłki e-maili w aplikacjach. W tym artykule pokazujemy krok po kroku, jak zainstalować, uruchomić i skonfigurować Mailpit w środowisku ServBay, opisując cztery główne zakładki konfiguracyjne: Common, SMTP, POP3 oraz Relay.

Przegląd pakietu Mailpit

Mailpit to narzędzie open-source, które dostarcza prosty w obsłudze lokalny serwer SMTP/POP3 oraz intuicyjny interfejs webowy. Pozwala przechwycić wszystkie e-maile wysyłane przez Twoją aplikację, umożliwiając wgląd w treść, nagłówki czy załączniki bez wysyłania testowej poczty do prawdziwej skrzynki odbiorczej. To znacznie upraszcza proces rozwoju i debugowania, zwłaszcza podczas pracy nad funkcjami wymagającymi wysyłki e-mail, np. rejestracją, resetowaniem hasła czy powiadomieniami.

W ServBay Mailpit stanowi kluczowy pakiet, którym możesz łatwo zarządzać i instalować. Dzięki zaawansowanemu systemowi PKI, ServBay automatycznie konfiguruje certyfikaty SSL/TLS, zapewniając bezpieczne testy.

Instalacja i uruchomienie pakietu Mailpit

Aby korzystać z Mailpit jako lokalnego serwera mailowego, najpierw zainstaluj i włącz go w aplikacji ServBay.

1. Otwórz ServBay.
2. Wybierz Pakiety z lewego panelu nawigacji.
3. Wśród dostępnych pakietów znajdź kategorię Usługi ogólne.
4. Wyszukaj pakiet Mailpit.
5. Jeśli Mailpit nie jest zainstalowany, kliknij zielony przycisk instalacji po prawej stronie.
6. Po zakończeniu instalacji, przestaw przycisk obok nazwy pakietu, aby aktywować Mailpit.

Dzięki zaawansowanemu systemowi PKI, ServBay automatycznie generuje i konfiguruje niezbędne certyfikaty SSL dla interfejsu webowego Mailpit oraz usług SMTP i POP3. Oznacza to, że możesz natychmiast uruchomić STARTTLS lub SSL/TLS bez ręcznego wnioskowania lub ustawiania certyfikatów.

Webowy panel zarządzania pocztą

Mailpit oferuje rozbudowany interfejs webowy, który pozwala przeglądać i zarządzać przechwyconymi mailami. W ServBay konfiguracja ta jest wykonywana automatycznie – po włączeniu pakietu Mailpit, dostęp do panelu otrzymasz od razu z przeglądarki:

Adres: https://mail.servbay.host

W tym panelu możesz swobodnie przeglądać listę odebranej poczty, podglądać szczegóły pojedynczych wiadomości (HTML, tekst, źródło), wyszukiwać e-maile, a także je usuwać.

Konfiguracja pakietu Mailpit

W ServBay dostępny jest graficzny panel konfiguracji parametrów Mailpit. W lewym menu wybierz Mail, a następnie kliknij Mailpit Service Config, by przejść do ustawień. Zobaczysz cztery główne zakładki: Common, SMTP, POP3 i Relay.

1. Zakładka Common

Tutaj skonfigurujesz ogólne parametry i zachowania Mailpit:

• Max Messages: Określ maksymalną liczbę wiadomości, które serwer Mailpit może przechowywać. Po przekroczeniu limitu najstarsze maile zostaną automatycznie usunięte.
• Max Age: Ustaw maksymalny czas przechowywania e-maili (w dniach) na serwerze Mailpit. Po jego upływie, wiadomości zostaną usunięte.
• SpamAssassin: Włącz lub wyłącz filtrowanie spamu (SpamAssassin). Po aktywacji Mailpit będzie próbował oznaczać spam.
• Webhook URL: Wprowadź adres webhooka. Gdy Mailpit odbierze nową wiadomość, wyśle HTTP POST pod ten adres, powiadamiając zewnętrzne systemy lub usługi – przydatne do automatyzacji testów lub powiadomień.
• Webhook Limit: Ustal ograniczenie liczby powiadomień webhook (maksymalne wysyłane wiadomości).

2. Zakładka SMTP

TIP

Dzięki wbudowanemu systemowi PKI, ServBay automatycznie generuje i konfiguruje certyfikaty SSL. Możesz natychmiast włączyć połączenia STARTTLS lub SSL/TLS, bez konieczności ręcznego ustawiania certyfikatów.

W tej zakładce ustawisz parametry serwera SMTP Mailpit. To tu powinien łączyć się Twój system/aplikacja, aby wysyłać testowe maile:

• SMTP Port: Numer portu, na którym nasłuchuje serwer SMTP Mailpit. Aplikacja powinna kierować e-maile na 127.0.0.1 lub localhost oraz ten port (domyślnie 1025).
• STARTTLS: Włącz/wyłącz szyfrowanie STARTTLS. Zabezpiecza połączenie po jego zestawieniu.
• SSL/TLS: Włącz/wyłącz szyfrowanie SSL/TLS. Połączenie od początku jest zabezpieczone.
• Username: Nazwa użytkownika SMTP (opcjonalna). Po ustawieniu, aplikacja podczas wysyłki musi się uwierzytelnić.
• Password: Hasło SMTP (opcjonalne). Razem z Username umożliwia uwierzytelnianie.
• Max Recipients: Maksymalna liczba odbiorców pojedynczego maila – ogranicza masowe wysyłki.
• Allowed Recipients: Lista adresów lub domen odbiorców, którzy mogą przyjąć pocztę (opcjonalne). Jeśli puste, Mailpit przyjmuje pocztę dla każdego adresata. Po wypełnieniu – tylko na wskazane adresy/domeny.

3. Zakładka POP3

TIP

Dzięki systemowi PKI ServBay, certyfikaty SSL są skonfigurowane automatycznie. Możesz bezpośrednio korzystać z szyfrowanych połączeń SSL/TLS do odbierania poczty – bez ręcznej konfiguracji certyfikatu.

Tutaj skonfigurujesz serwer odbiorczy POP3 Mailpit. Przydatne do testowania odbioru poczty przez Twoją aplikację:

• Enable POP3 Server: Włącz/wyłącz serwer POP3.
• POP3 Server Port: Numer portu nasłuchującego POP3 Mailpit (domyślnie 1110).
• Username: Nazwa użytkownika POP3 (opcjonalna). Po skonfigurowaniu, klient pocztowy wymaga logowania.
• Password: Hasło POP3 (opcjonalne). Razem z Username służy do uwierzytelnienia.
• SSL/TLS: Włącz/wyłącz szyfrowanie SSL/TLS dla połączeń POP3.

4. Zakładka Relay

Służy do przekazywania (forwardowania) wybranych lub wszystkich maili z Mailpit na zewnętrzny serwer SMTP:

• Enable SMTP Relay: Włącz/wyłącz przekazywanie wiadomości SMTP poza Mailpit.
• Host: Adres zewnętrznego serwera SMTP do przekazywania maili (np. smtp.gmail.com, smtp.sendgrid.net).
• Port: Port zewnętrznego serwera SMTP. Domyślnie 25 (standard), 465 (SMTPS), lub 587 (Submission).
• STARTTLS: Włącz/wyłącz szyfrowane połączenie STARTTLS z zewnętrznym hostem.
• Allow Insecure: Pozwala łączyć się z zewnętrznymi serwerami SMTP z niezweryfikowanymi certyfikatami (niezalecane w produkcji!).
• Auth: Wybór metody uwierzytelniania. Popularne opcje: Login (użytkownik i hasło), Plain (jak Login), oraz CRAM-MD5 (mechanizm wyzwanie/odpowiedź).
• Username: Nazwa użytkownika do połączenia z relay SMTP.
• Password: Hasło do relay SMTP.
• Return Path: Adres zwrotny (nagłówek Return-Path) dla przekazywanych maili.
• Allowed Recipients: Lista adresów/domen, którym można przekazywać pocztę (opcjonalna).
• Blocked Recipients: Lista adresów/domen, którym blokuje się przekazywanie poczty (opcjonalna).
• Relay All: Jeśli zaznaczone, Mailpit przekaże wszystkie przechwycone maile (ograniczane przez Allowed/Blocked Recipients).
• Relay Matching: Przekazuje tylko maile spełniające zasady z Allowed Recipients lub Blocked Recipients.

Zapisywanie ustawień

Po wprowadzeniu jakichkolwiek zmian w konfiguracji Mailpit, pamiętaj by kliknąć przycisk Save na dole ekranu.

Opcja Reset pozwala przywrócić ustawienia domyślne Mailpit.

Najczęstsze pytania (FAQ)

• Q: Dlaczego maile wysłane z mojej aplikacji nie trafiają do Mailpit?
  • A: Sprawdź konfigurację modułu pocztowego aplikacji (najczęściej host i port SMTP) – powinny kierować na adres, pod którym działa Mailpit w ServBay (127.0.0.1 albo localhost) oraz na konfigurację portu SMTP (domyślnie 1025). Dodatkowo upewnij się, że pakiet Mailpit w ServBay jest aktywny – stan znajdziesz w liście pakietów.
• Q: Czy muszę ręcznie konfigurować certyfikaty SSL dla Mailpit?
  • A: Nie potrzeba. Dzięki systemowi PKI, ServBay automatycznie generuje i konfiguruje niezbędne certyfikaty SSL dla WWW, SMTP i POP3 (STARTTLS/SSL/TLS). Wystarczy w odpowiednich zakładkach włączyć szyfrowanie.
• Q: Jakie są domyślne dane logowania do panelu WWW Mailpit?
  • A: Panel webowy Mailpit pod adresem https://mail.servbay.host domyślnie nie wymaga loginu ani hasła. SMTP i POP3 także domyślnie nie wymagają uwierzytelnienia. Jeśli chcesz wymusić logowanie dla SMTP lub POP3, ustaw hasło i nazwę użytkownika w odpowiedniej zakładce.

Podsumowanie

Dzięki rozbudowanej integracji pakietu Mailpit z ServBay, w prosty sposób zbudujesz lokalne środowisko do testowania maili. Konfigurując SMTP, POP3 oraz ustawienia relay i korzystając z czytelnego panelu webowego, znacznie podniesiesz efektywność oraz wygodę rozwijania i testowania funkcji e-mail w projektach developerskich.

Pamiętaj, że po jakiejkolwiek modyfikacji ustawień Mailpit, w celu ich zastosowania może być konieczne jego ponowne uruchomienie. W panelu pakietów ServBay znajdź Mailpit i użyj przycisku restartu.