Utilizzare i Siti → Email per ispezionare la disponibilità di mail-server, verificare i record DNS richiesti e fornire caselle di posta reali nella configurazione live Postfix e Dovecot per il dominio del sito.
Herne ora fornisce delle vere caselle di posta a un server quando il server è preparato correttamente. Webmail, alias e multi-server le topologie di posta rimangono fuori campo.
Strategia di provisioning
Herne Phase 2 utilizza un percorso di provisioning di posta a singolo server basato su file. Il database dei pannelli rimane la fonte della verità, e Herne genera artefatti Postfix e Dovecot da quei dati sotto una radice gestita dedicata.
Percorso di configurazione consigliato
Il percorso principale supportato su un server fresco è ora l'installatore Herne unificato:
curl -fsSL https://raw.githubusercontent.com/fklavyenet/herne/main/install.sh | sudo bash
Risposta yes quando l'installatore chiede se dovrebbe installare lo stack di posta, quindi fornire EMAIL_HOSTING_SERVER_HOSTNAME in modo che Herne possa configurare un nome host mail canonico coerente per Postfix. Dopo che lo stack locale è pronto, utilizzare le pagine di e-mail del pannello per fornire domini e caselle di posta.
Se Herne è già installato e si sta aggiungendo la posta in seguito, il percorso standalone rimane:
php artisan herne:install-mail-stack --check
php artisan herne:install-mail-stack --apply
php artisan herne:email:check-server
Cosa gestisce Herne
/etc/herne-mail/generated/postfix/virtual_domains/etc/herne-mail/generated/postfix/virtual_mailboxes/etc/herne-mail/generated/dovecot/passwd/etc/herne-mail/generated/state.json/var/vmail/{domain}/{local_part}/Maildir
Herne scrive i file di origine, esegue postmap per le mappe Postfix, crea directory Maildir e ricarica postfix e dovecot solo dopo che i nuovi file vengono in scena con successo.
Pacchetti Ubuntu richiesti
L'installatore può installarli automaticamente su Debian e Ubuntu con apt non interattivo quando l'operatore lo esegue come root o con sudo senza password.
postfixpostfix-pcrese la politica del server lo aspetta già altrovedovecot-coredovecot-imapddovecot-pop3ddovecot-lmtpdrspamdredis-server(consigliato per Rspamd)dnsutilsopenssl
Controlli di disponibilità
Herne verifica questi eseguibili: postfix, postconf, postmap, dovecot, doveconf, rspamd, rspamadm, openssl, systemctl, ss e uno tra dig e host.
Herne verifica anche i servizi postfix, dovecot, rspamd e redis-server, le porte di posta 25, 465, 587, 143, 993, 110 e 995 e le regole UFW se UFW è installato.
La fase 2 controlla anche il cablaggio di integrazione e la disponibilità del filesystem: l'utente/gruppo vmail, la radice vmail scrivibile, la radice di configurazione gestita da Herne, e se postconf -n / doveconf -n effettivamente fanno riferimento ai file gestiti da Herne.
Modello utente di posta virtuale atteso
Herne installa e utilizza un account di sistema dedicato per la memorizzazione della casella di posta, tipicamente vmail:vmail. Herne si aspetta che lo storage Maildir sotto /var/vmail e gli archivi cancellati casella di posta in /var/vmail/.trash.
Herne preferisce UID/GID 5000 quando libero, ma rientra in sicurezza se l'identità è già in uso.
Prima versione della webmail
Herne include un leggero Webmail MVP di prima parte a /webmail. Questo è un flusso di login separato casella di posta e non richiede un account pannello Herne.
- Gli utenti di Mailbox entrano con l'indirizzo e-mail completo e la password della casella di posta.
- Solo le mailbox attive e provviste di Herne possono entrare.
- MVP supporta Posta in arrivo, leggere, inviare, rispondere ed eliminare.
- La posta in uscita utilizza sempre l'indirizzo di posta registrato come mittente.
- Gli allegati, la gestione delle cartelle, gli alias/forwarders, la quarantena dello spam, l'editing di testo ricco e il webmail multi-server sono al di fuori del MVP.
La posta in arrivo usa l’estensione PHP imap con IMAP, di norma sulla porta 993 con SSL. L’invio SMTP usa le credenziali della casella e il server di posta configurato, di norma EMAIL_HOSTING_SERVER_HOSTNAME o mail.{domain}, sulla porta 587 con STARTTLS.
Webmail storage vs archiviazione Maildir
I dati di runtime Webmail e l'archiviazione reale della casella di posta sono intenzionalmente separati:
- Webmail App/runtime storage:
/var/www/{site}/webmail - Sottodirectory runtime Webmail:
cache,tmpedrafts - Magazzinaggio Maildir reale:
/var/vmail/{domain}/{local_part}/Maildir
La directory webmail non è sotto il pubblico web_root e non è automaticamente inclusa nei backup dei file del sito. MVP non sposta la consegna di posta Dovecot sotto /var/www, mantenendo il modello di autorizzazione vmail esistente.
Comandi utili del server
php artisan herne:install-mail-stack --check
php artisan herne:install-mail-stack --apply
php artisan herne:install-mail-stack --repair
systemctl status postfix
systemctl status dovecot
systemctl status rspamd
ss -ltnp | grep -E ':25|:465|:587|:143|:993|:110|:995'
postconf -n
doveconf -n
php artisan herne:email:check-server
php artisan herne:email:health example.com
php artisan herne:email:provision-domain example.com
php artisan herne:email:provision-mailbox support@example.com
php artisan herne:email:rebuild
DNS registra Herne si aspetta
dig MX example.com
dig TXT example.com
dig TXT herne._domainkey.example.com
dig TXT _dmarc.example.com
Il pannello genera i record raccomandati MX, SPF, DKIM e DMARC per ogni dominio di posta e li verifica contro DNS pubblico. Un dominio è contrassegnato solo da DNS quando i record richiesti sono effettivamente presenti o esplicitamente compatibili.
Stato della posta e consegna
La fase 3 aggiunge uno strato diagnostico-primo della salute. Herne non calcola un falso punteggio di consegna. Invece memorizza una snapshot strutturata compatta con risultati espliciti, categorie raggruppate e correzioni consigliate.
Categorie del controllo
- Identità DNS: MX, SPF, DKIM, presenza DMARC e forza di base
- Identità dell’host: nome host del server, identità HELO di Postfix, risoluzione A/AAAA dell’host di posta, PTR e coerenza tra DNS diretto e inverso
- Raggiungibilità SMTP: Postfix State più ascoltatori locali per 25, 465 e 587
- IMAP/POP/TLS basi: Dovecot stato più ascoltatori locali per 143, 993, 110 e 995, e parziale TLS sanity controlli quando pratico
- Prerequisiti antispam: Rspamd, Redis quando previsto, DMARC forza di politica, SPF larghezza della politica, DKIM DNS prontezza, cablaggio milter Postfix e allineamento di selettore di firma DKIM in uscita
- Provisione dell'integrità: stato del pannello contro presenza di artefatti vivi e deriva generata-stato
- Visibilità del firewall: stato UFW e se le porte della posta appaiono permesse quando UFW è attivo
Significati di stato
- Passaggio: il controllo è riuscito sulla base delle prove che Herne potrebbe raccogliere
- avvertimento: la configurazione può funzionare, ma una debolezza o un errore è visibile
- fallire: un prerequisito atteso è chiaramente mancante o rotto
- sconosciuto: il controllo non potrebbe essere dimostrato in modo sicuro nell'ambiente attuale
- non disponibile: l'attrezzo necessario per il controllo non esiste localmente
Perché PTR è importante
Molti sistemi riceventi si aspettano che l’indirizzo IP di invio abbia un DNS inverso e che il record PTR corrisponda a un nome host di posta valido. Herne verifica il PTR solo quando può determinare con affidabilità l’IP pubblico. Se il rilevamento in base alle rotte locali è ambiguo, puoi impostare EMAIL_HEALTH_PUBLIC_IPV4 e EMAIL_HEALTH_PUBLIC_IPV6.
Condizioni di funzionamento corretto
- MX indica il nome host della posta in questione
- Il nome host della posta si risolve nuovamente al server corrente IP
- PTR indica lo stesso nome host della posta o un equivalente coerente
- Postfix
myhostnameosmtp_helo_nameutilizza lo stesso nome host della posta canonica - SPF è presente e non eccessivamente permissivo
- DKIM è pubblicato e corrisponde al selettore configurato
- Postfix esegue la posta in uscita attraverso segnali Rspamd e Rspamd con lo stesso selettore che mostra Herne in DNS
- DMARC esiste e si muove idealmente oltre
p=noneuna volta che i flussi di invio vengono convalidati - Postfix e Dovecot sono attivi, con gli ascoltatori attesi presenti
- I manufatti in tensione esistono e lo stato del pannello di corrispondenza
Correzioni comuni
- Missing MX: pubblicare un record MX indicando il nome host della posta configurato
- Mancante PTR: chiedere al provider di hosting di impostare invertire DNS per il server IP
- PTR mismatch: allineare PTR, MX e A/AAAA intorno a un nome host di posta coerente
- HELO mismatch: impostare Postfix
myhostnameosmtp_helo_nameal nome host della posta canonica - SPF troppo ampio: sostituire le regole permissive SPF con una politica di mittente più stretta
- DKIM DNS passa ma Gmail non mostra ancora DKIM: controlla
smtpd_milters,non_smtpd_milterserspamadm configdump dkim_signing - DMARC
p=none: trasferirsi in quarantena o rifiutare dopo aver convalidato i mittenti legittimi - Mancanza della sottomissione: abilitare la presentazione Postfix sulla porta 587
- incertezza TLS: installare o correggere il certificato che copre il nome host di posta configurato
- Provisione della deriva: utilizzare il riprogrammazione del dominio o l'azione completa di ricostruzione per rigenerare artefatti
Risoluzione dei problemi di spam Gmail
Se macOS Mail, Webmail e server-side invia tutti i Gmail di accesso ma atterrare nello spam, trattalo come un problema di identità di invio o reputazione piuttosto che un problema di configurazione del client.
- Eseguire
php artisan herne:email:health example.come correggere PTR, HELO hostname, SPF, DKIM, DMARC, milter e avvisi di provisioning prima. - Invertire DNS dovrebbe indicare l'invio di IP allo stesso nome host canonico utilizzato da MX, A, Postfix, SMTP HELO e TLS.
- Chiedi all'utente di aprire Gmail Mostra originale e segnalare le linee SPF, DKIM, DMARC e Authentication-Results. Non indovinare dal posizionamento in arrivo da solo.
- Se Gmail mostra DKIM mancante o in mancanza mentre Herne DNS dice che DKIM è pronto, verificare il percorso di acquisizione in uscita: cablaggio milter Postfix, Rspamd
dkim_signing, selettore, blocco di dominio e leggibilità chiave privata. - Utilizzare Gmail Postmaster Tools e un periodo di riscaldamento graduale per il nuovo IPs, nuovi domini, o l'identità di posta riparata recentemente. L'autenticazione può passare prima che la reputazione è abbastanza forte per il posizionamento in arrivo.
Integrazione Postfix
L'installatore aggiorna chirurgicamente /etc/postfix/main.cf con i riferimenti della mappa gestiti da Herne e consente la presentazione in /etc/postfix/master.cf. Un cecchino di riferimento è ancora spedito in stubs/email/postfix-maincf-snippet.txt per gli operatori che vogliono rivedere il cablaggio di destinazione.
Integrazione Dovecot
Il programma di installazione configura Dovecot per includere un file passwd gestito da Herne, scrive la configurazione di Maildir, LMTP e del socket di autenticazione Postfix e conserva copie di backup prima di modificare i file in uso. Una configurazione di riferimento è ancora inclusa in stubs/email/dovecot-auth-snippet.conf.
Risoluzione dei problemi dell'orbita di autenticazione Webmail SMTP
Se Webmail invia fallisce con Connection to "mail.example.com:587" has been closed unexpectedly e /var/log/mail.log mostra SASL: Connect to Dovecot auth socket 'private/auth' failed o no SASL authentication mechanisms, la sottomissione Postfix non può raggiungere Dovecot SASL auth.
php artisan herne:install-mail-stack --check
php artisan herne:install-mail-stack --repair
sudo systemctl reload dovecot
sudo systemctl reload postfix
sudo ls -la /var/spool/postfix/private/auth
sudo postconf -n | grep -E 'smtpd_sasl_type|smtpd_sasl_path|smtpd_sasl_auth_enable'
sudo doveconf -n | grep -A8 -B2 '/var/spool/postfix/private/auth'
L'ascoltatore Dovecot atteso è /var/spool/postfix/private/auth con la modalità 0660, l'utente postfix e il gruppo postfix. Postfix dovrebbe usare smtpd_sasl_type = dovecot, smtpd_sasl_path = private/auth e smtpd_sasl_auth_enable = yes.
Modalità di backup e riparazione
Prima di cambiare configurazione del sistema, Herne memorizza i backup timestamped sotto /etc/herne-mail/backups/{timestamp}/.... Ri-correre php artisan herne:install-mail-stack --repair se uno stack di posta Herne precedentemente funzionante si è allontanato o se un operatore ha parzialmente modificato la configurazione a mano.
Casi di rifiuto sicuri
Herne rifiuta di applicare automaticamente per impostazione predefinita quando rileva una configurazione Postfix o Dovecot esistente apparentemente incompatibile, quando manca il nome host della posta canonica, o quando il comando non ha l'accesso root-level necessario per modificare la configurazione del sistema in modo sicuro.
Schema della password
Herne utilizza SHA512-CRYPT per il live Dovecot passwd-file. Le password della casella di posta a pannello rimangono schiacciate separatamente nel database delle applicazioni.
Requisiti di improvvisi
Herne ha bisogno di un accesso sudo strettamente mirato per le operazioni di provisioning della posta.
www-data ALL=(root) NOPASSWD: /usr/bin/install -d *
www-data ALL=(root) NOPASSWD: /usr/bin/install -m *
www-data ALL=(root) NOPASSWD: /bin/cp -f *
www-data ALL=(root) NOPASSWD: /bin/mv *
www-data ALL=(root) NOPASSWD: /bin/rm -rf /etc/herne-mail/.staging-*, /bin/rm -rf /etc/herne-mail/.backup-*
www-data ALL=(root) NOPASSWD: /usr/sbin/postmap *
www-data ALL=(root) NOPASSWD: /usr/bin/test *
www-data ALL=(root) NOPASSWD: /usr/bin/id *
www-data ALL=(root) NOPASSWD: /usr/bin/getent group *
www-data ALL=(root) NOPASSWD: /usr/bin/systemctl reload postfix
www-data ALL=(root) NOPASSWD: /usr/bin/systemctl reload dovecot
Comportamento di cancellazione
La cancellazione della cassetta postale e' conservatrice. Herne rimuove l'ingresso live auth/map, ricostruisce i manufatti gestiti e archivia la casella di posta in /var/vmail/.trash/{timestamp}-{domain}-{local_part} invece di eliminarla definitivamente.
Ancora fuori portata
- Roundcube o un client webmail di classe desktop completo
- Alias e spedizionieri UI
- Spam quarantena UI
- Allegati e gestione delle cartelle in Webmail
- cluster di posta multi-server