Guida alla Configurazione del Servizio Mailpit in ServBay
ServBay integra il pacchetto software Mailpit, offrendo un pratico server email locale pensato per gli sviluppatori che desiderano testare e fare debug delle funzionalità di invio email nelle proprie applicazioni. In questo articolo troverai istruzioni dettagliate su come installare, abilitare e configurare Mailpit su ServBay, con una panoramica sulle quattro principali schede di configurazione: Common, SMTP, POP3 e Relay.
Panoramica sul pacchetto Mailpit
Mailpit è uno strumento open source che fornisce un server locale SMTP/POP3 facile da usare e un’interfaccia web intuitiva. Raccoglie tutte le email inviate dalla tua applicazione permettendoti di visualizzare contenuti, intestazioni, allegati e altro ancora in un’unica posizione, senza rischiare di inviare email di test a reali caselle di posta. Questo semplifica molto il flusso di lavoro di sviluppo e debugging, soprattutto per funzioni come registrazione utenti, reset password e notifiche che prevedono l’invio di email.
In ServBay, Mailpit è integrato come pacchetto software fondamentale: puoi installarlo e gestirlo facilmente, mentre il potente sistema PKI di ServBay configura automaticamente certificati SSL/TLS a garanzia di un ambiente di test sicuro.
Installazione e abilitazione del pacchetto Mailpit
Prima di usare Mailpit come server email locale, occorre installare e attivare il pacchetto Mailpit in ServBay.
- Avvia l’applicazione ServBay.
- Dal menu di navigazione a sinistra, seleziona
Pacchetti
. - Nella lista dei pacchetti, trova la sezione
Servizi Generali
. - Individua il pacchetto
Mailpit
. - Se Mailpit non è installato, clicca sul pulsante verde di installazione sulla destra.
- Una volta installato, attiva Mailpit cliccando sull’apposito interruttore a fianco.
Grazie al potente sistema PKI di ServBay, i certificati SSL necessari per l’interfaccia web di Mailpit e per i servizi SMTP/POP3 vengono creati e configurati automaticamente. Questo significa che puoi abilitare la crittografia STARTTLS o SSL/TLS fin da subito e in modo sicuro, senza dover richiedere o configurare manualmente i certificati.
Interfaccia Web di gestione delle email
Mailpit fornisce una potente interfaccia web per visualizzare e gestire le email intercettate. ServBay configura tutto automaticamente: dopo aver abilitato Mailpit, puoi accedere direttamente all’interfaccia tramite il browser:
Indirizzo: https://mail.servbay.host
Attraverso questa interfaccia, puoi sfogliare la lista delle email ricevute, visualizzare dettagli di ogni messaggio (incluso HTML, testo semplice e codice sorgente), cercare, eliminare mail e molto altro.
Configurazione del pacchetto Mailpit
ServBay offre una configurazione grafica per tutti i parametri di Mailpit. Dal menu a sinistra di ServBay, seleziona Mail
, poi clicca su Mailpit Service Config
per accedere al pannello impostazioni. Qui troverai le quattro principali schede di configurazione: Common, SMTP, POP3 e Relay.
1. Scheda Common
Nella scheda Common puoi gestire le opzioni generali di Mailpit:
- Max Messages: imposta il numero massimo di email che il server Mailpit può archiviare. Quando il limite viene superato, le email più vecchie saranno cancellate automaticamente.
- Max Age: definisce per quanti giorni le email verranno conservate sul server Mailpit. Oltre tale periodo, i messaggi verranno eliminati automaticamente.
- SpamAssassin: abilita o disabilita il filtro antispam SpamAssassin. Se attivato, Mailpit cercherà di identificare e segnalare le email come spam.
- Webhook URL: configura un indirizzo Webhook. Quando Mailpit riceve una nuova email, invierà una richiesta HTTP POST a questo URL per notificare sistemi o servizi esterni. Utile per l’integrazione con test automatici o sistemi di notifica.
- Webhook Limit: imposta il numero massimo di email per le quali verrà inviata una notifica con Webhook.
2. Scheda SMTP
TIP
Grazie al sistema PKI avanzato di ServBay, i certificati SSL vengono generati e configurati automaticamente. Puoi abilitare direttamente le connessioni crittografate STARTTLS o SSL/TLS senza ulteriori configurazioni o richieste di certificati.
Questa scheda permette di configurare il server SMTP di Mailpit. Le tue applicazioni si collegheranno a questo server per inviare email di test:
- SMTP Port: imposta la porta su cui Mailpit ascolta per le connessioni SMTP. L’applicazione deve inviare le email a questa porta su
127.0.0.1
olocalhost
. Il valore predefinito è1025
. - STARTTLS: abilita o disabilita la crittografia STARTTLS, che permette di passare a una connessione sicura dopo averla stabilita.
- SSL/TLS: abilita o disabilita la crittografia SSL/TLS, che attiva la sicurezza già dall’apertura della connessione.
- Username: imposta il nome utente per autenticarsi sul server SMTP (opzionale). Se impostato, l’applicazione dovrà fornire queste credenziali per inviare email.
- Password: imposta la password associata all’username SMTP (opzionale).
- Max Recipients: limita il numero massimo di destinatari per ogni singola email, evitando l’invio accidentale a troppi indirizzi contemporaneamente.
- Allowed Recipients: specifica l’elenco di indirizzi o domini per cui le email saranno accettate (opzionale). Se lasciato vuoto, ogni destinatario sarà accettato. Se compilato, solo i destinatari nell’elenco potranno ricevere email da Mailpit.
3. Scheda POP3
TIP
Grazie al sistema PKI avanzato di ServBay, i certificati SSL vengono generati e configurati automaticamente. Puoi abilitare facilmente la crittografia SSL/TLS per le connessioni POP3 senza procedure aggiuntive.
La scheda POP3 permette di configurare il server POP3 di Mailpit. Se hai bisogno di testare la ricezione delle email nelle tue applicazioni, connetti il client a questo server:
- Enable POP3 Server: abilita o disabilita la funzionalità server POP3 di Mailpit.
- POP3 Server Port: imposta la porta su cui il server POP3 ascolta. Il valore predefinito è
1110
. - Username: specifica il nome utente per l’accesso POP3 (opzionale). Se impostato, il client dovrà fornire queste credenziali.
- Password: definisce la password abbinata all’username POP3 (opzionale).
- SSL/TLS: abilita o disabilita la connessione sicura tramite SSL/TLS.
4. Scheda Relay
Questa scheda serve a configurare il relay SMTP di Mailpit, ossia la possibilità di inoltrare alcune o tutte le email intercettate verso un reale server SMTP esterno:
- Enable SMTP Relay: abilita o disabilita la funzione di relay SMTP.
- Host: inserisci l’indirizzo del server SMTP esterno a cui inoltrare la posta (esempi:
smtp.gmail.com
,smtp.sendgrid.net
). - Port: imposta la porta del server SMTP esterno. Tipicamente
25
(SMTP standard),465
(SMTPS), o587
(Submission). - STARTTLS: abilita o disabilita la connessione crittografata STARTTLS verso il relay.
- Allow Insecure: consenti la connessione a server SMTP relay con certificati non attendibili (opzione sconsigliata in produzione).
- Auth: scegli il metodo di autenticazione da usare con il server relay. Opzioni comuni sono
Login
(invio username e password),Plain
(simile a Login), eCRAM-MD5
(meccanismo di autenticazione challenge-response). - Username: nome utente per autenticarsi sul server SMTP relay.
- Password: password per il relay SMTP.
- Return Path: imposta l’indirizzo per le notifiche di mancato recapito (
Return-Path
header). - Allowed Recipients: elenco di indirizzi o domini recipienti abilitati all’inoltro (opzionale).
- Blocked Recipients: elenco di indirizzi o domini da bloccare all’inoltro (opzionale).
- Relay All: se attivo, Mailpit proverà a inoltrare tutte le email raccolte (soggetto alle restrizioni di Allowed/Blocked Recipients).
- Relay Matching: se attivo, solo le email che corrispondono alle regole di Allowed o Blocked Recipients saranno inoltrate.
Salvataggio delle configurazioni
Dopo qualsiasi modifica alle impostazioni di Mailpit, ricordati di cliccare sul pulsante Save
in fondo alla pagina per salvare le nuove configurazioni.
Il pulsante Reset
ripristina tutte le impostazioni di Mailpit ai valori predefiniti.
Domande Frequenti (FAQ)
- D: Perché il mio programma non visualizza le email inviate in Mailpit?
- R: Verifica la configurazione di invio email della tua applicazione (solitamente host e porta SMTP). Deve puntare a Mailpit attivo su ServBay, ovvero
127.0.0.1
olocalhost
e alla porta SMTP configurata (di default 1025). Assicurati anche che Mailpit sia avviato e in esecuzione; puoi controllarne lo stato dall’elenco dei pacchetti in ServBay.
- R: Verifica la configurazione di invio email della tua applicazione (solitamente host e porta SMTP). Deve puntare a Mailpit attivo su ServBay, ovvero
- D: Devo configurare manualmente certificati SSL per Mailpit?
- R: No, non è necessario. Il sistema PKI di ServBay genera e configura automaticamente i certificati per l’interfaccia web, servizi SMTP e POP3 (per connessioni STARTTLS/SSL/TLS). Basta abilitare le opzioni di cifratura dalla relativa scheda impostazioni.
- D: Quali sono username e password predefiniti per l’interfaccia web di Mailpit?
- R: Di default, l’accesso all’interfaccia web tramite
https://mail.servbay.host
non richiede credenziali. Anche i servizi SMTP e POP3 non prevedono autenticazione a meno che tu non imposti username e password specifici nelle rispettive schede di configurazione.
- R: Di default, l’accesso all’interfaccia web tramite
Sommario
Con il pacchetto Mailpit integrato in ServBay puoi facilmente realizzare un ambiente locale per il testing delle email. Configura SMTP, POP3 e Relay secondo necessità e sfrutta l’intuitiva interfaccia web per semplificare e accelerare lo sviluppo e il debug delle funzionalità email nella tua applicazione.
Ricorda: dopo ogni modifica della configurazione, potrebbe essere necessario riavviare il pacchetto Mailpit affinché le modifiche abbiano effetto. Puoi eseguire il riavvio direttamente dall’interfaccia di gestione pacchetti di ServBay con l’apposito pulsante.