Nutzen Sie Websites → E-Mail, um die Mail-Server-Bereitschaft zu prüfen, die erforderlichen DNS-Einträge zu verifizieren und echte Postfächer für die Website-Domain in die laufende Postfix- und Dovecot-Umgebung zu provisionieren.
Wenn der Server korrekt vorbereitet ist, provisioniert Herne jetzt echte Single-Server-Postfächer. Webmail, Aliase und Multi-Server-Mail-Topologien bleiben weiter außerhalb des Umfangs.
Bereitstellungsstrategie
Herne Phase 2 verwendet einen dateibasierten Single-Server-Mail-Provisioning-Pfad. Die Panel-Datenbank bleibt die Quelle der Wahrheit, und Herne generiert Postfix- und Dovecot-Artefakte aus diesen Daten unter einer dedizierten verwalteten Wurzel.
Empfohlener Einrichtungsablauf
Der primäre unterstützte Pfad auf einem neuen Server ist jetzt das einheitliche Herne-Installationsprogramm:
curl -fsSL https://raw.githubusercontent.com/fklavyenet/herne/main/install.sh | sudo bash
Antworte yes, wenn der Installer fragt, ob er den Mail-Stack installieren soll, dann gib EMAIL_HOSTING_SERVER_HOSTNAME an, damit Herne einen zusammenhängenden kanonischen Mail-Hostnamen für Postfix konfigurieren kann. Nachdem der lokale Stapel fertig ist, verwenden Sie das Panel E-Mail-Seiten, um Domains und Postfächer bereitzustellen.
Wenn Herne bereits installiert ist und Sie später E-Mails hinzufügen, bleibt der eigenständige Pfad bestehen:
php artisan herne:install-mail-stack --check
php artisan herne:install-mail-stack --apply
php artisan herne:email:check-server
Was Herne verwaltet
/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 schreibt die Quelldateien, führt postmap für die Postfix-Tabellen aus und legt die Maildir-Verzeichnisse an. Erst wenn die neuen Dateien erfolgreich bereitgestellt sind, lädt Herne postfix und dovecot neu.
Erforderliche Ubuntu-Pakete
Der Installer kann diese automatisch auf Debian und Ubuntu mit nicht-interaktivem apt installieren, wenn der Operator es als root oder mit passwortlos sudo ausführt.
postfixpostfix-pcrewenn Ihre Server-Richtlinie es bereits an anderer Stelle erwartetdovecot-coredovecot-imapddovecot-pop3ddovecot-lmtpdrspamdredis-server(empfohlen für Rspamd)dnsutilsopenssl
Bereitschaftsprüfungen
Herne prüft, ob diese Programme vorhanden sind: postfix, postconf, postmap, dovecot, doveconf, rspamd, rspamadm, openssl, systemctl, ss und entweder dig oder host.
Herne prüft außerdem die Dienste postfix, dovecot, rspamd und redis-server, die E-Mail-Ports 25, 465, 587, 143, 993, 110 und 995 sowie die UFW-Regeln, falls UFW installiert ist.
Phase 2 überprüft auch die Integrationsverdrahtung und Dateisystembereitschaft: den vmail Benutzer / Gruppe, den beschreibbaren vmail-Root, den Herne-verwalteten Config-Root und ob postconf -n / doveconf -n tatsächlich auf die Herne-verwalteten Dateien verweisen.
Erwartetes Modell für virtuelle E-Mail-Benutzer
Herne installiert und verwendet ein dediziertes Systemkonto für die Postfachspeicherung, typischerweise vmail:vmail. Herne erwartet Maildir Storage unter /var/vmail und archiviert gelöschten Postfach Storage unter /var/vmail/.trash.
Herne bevorzugt UID / GID 5000, wenn sie frei ist, fällt aber sicher zurück, wenn diese Identität bereits verwendet wird.
Erste Webmail-Version
Herne stellt unter /webmail die erste Version seines eigenen schlanken Webmails bereit. Die Anmeldung am Postfach ist separat und erfordert kein Herne-Panel-Konto.
- Postfachbenutzer melden sich mit der vollständigen E-Mail-Adresse und dem Postfachkennwort an.
- Nur aktive, live bereitgestellte Herne-Postfächer können sich anmelden.
- Der MVP unterstützt Posteingang, Lesen, Senden, Antworten und Löschen.
- Ausgehende Mails verwenden immer die angemeldete Postfachadresse als Absender.
- Anhänge, Ordnerverwaltung, Aliase / Spediteure, Spam-Quarantäne, Rich Text Editing und Multi-Server-Webmail befinden sich außerhalb des MVP.
Für eingehende E-Mails nutzt PHP die Erweiterung imap für IMAP, in der Regel über Port 993 mit SSL. Beim SMTP-Versand werden die Zugangsdaten des Postfachs verwendet. Die Verbindung zum konfigurierten Mailserver (in der Regel EMAIL_HOSTING_SERVER_HOSTNAME oder mail.{domain}) erfolgt über Port 587 mit STARTTLS.
Webmail-Speicher und Maildir-Speicher
Webmail-Laufzeitdaten und realer Postfachspeicher sind bewusst getrennt:
- Webmail-App/Laufzeitspeicher:
/var/www/{site}/webmail - Webmail-Laufzeit-Unterverzeichnisse:
cache,tmpunddrafts - Echter Postfach-Maildir-Speicher:
/var/vmail/{domain}/{local_part}/Maildir
Das Webmail-Verzeichnis ist nicht unter der Öffentlichkeit web_root und wird nicht automatisch in Site-Datei-Backups enthalten. Der MVP verschiebt die Dovecot-Mailzustellung nicht unter /var/www, wobei das bestehende vmail Berechtigungsmodell beibehalten wird.
Nützliche Serverbefehle
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
Von Herne erwartete DNS-Einträge
dig MX example.com
dig TXT example.com
dig TXT herne._domainkey.example.com
dig TXT _dmarc.example.com
Das Panel generiert empfohlene MX-, SPF-, DKIM- und DMARC-Datensätze für jede Mail-Domain und überprüft sie mit öffentlichen DNS. Eine Domain wird nur dann als DNS-ready markiert, wenn die erforderlichen Datensätze tatsächlich vorhanden oder explizit kompatibel sind.
E-Mail-Zustand und Zustellbarkeit
Phase 3 fügt eine Diagnostik-erste Gesundheitsschicht hinzu. Herne berechnet keinen Fake Deliveryability Score. Stattdessen speichert es einen kompakten strukturierten Snapshot mit expliziten Ergebnissen, gruppierten Kategorien und empfohlenen Fixes.
Kategorien der Zustandsprüfung
- DNS-Identität: MX, SPF, DKIM, DMARC-Präsenz und grundlegende Stärke
- Host-Identität: Server-Hostname, Postfix HELO-Identität, Mail-Host-A/AAAA-Auflösung, PTR und vorausbestätigte Reverse-DNS-Kohärenz
- SMTP Erreichbarkeit: Postfix Zustand plus lokale Zuhörer für 25, 465 und 587
- IMAP / POP / TLS Grundlagen: Dovecot Zustand plus lokale Zuhörer für 143, 993, 110 und 995 und teilweise TLS Sanity Checks, wenn praktisch
- Anti-Spam-Voraussetzungen: Rspamd, Redis, wenn erwartet, DMARC-Policy-Stärke, SPF-Policy-Breite, DKIM-DNS-Bereitschaft, Postfix-Milter-Verdrahtung und ausgehende DKIM-Signierungs-Selektor-Ausrichtung
- Aktualität der Bereitstellung: Panel-Status, tatsächlich vorhandene Dateien und Abweichungen in der erzeugten Konfiguration
- Firewall-Sichtbarkeit: UFW-Status und ob Mail-Ports erlaubt erscheinen, wenn UFW aktiv ist
Bedeutung der Statuswerte
- Pass: die Prüfung war erfolgreich aufgrund der Beweise, die Herne sammeln konnte
- Warnung: das Setup funktioniert möglicherweise, aber eine Schwäche oder ein Missverhältnis ist sichtbar
- Fehler: eine erwartete Voraussetzung fehlt oder ist eindeutig defekt
- unbekannt: die Prüfung konnte in der aktuellen Umgebung nicht sicher nachgewiesen werden
- nicht verfügbar: das für die Prüfung benötigte Tooling existiert lokal nicht
Warum PTR wichtig ist
Viele Empfangssysteme erwarten, dass die sendende IP Reverse-DNS hat und dass PTR mit einem vernünftigen E-Mail-Hostnamen übereinstimmt. Herne überprüft PTR nur, wenn es die öffentliche IP ehrlich bestimmen kann. Sie können EMAIL_HEALTH_PUBLIC_IPV4 und EMAIL_HEALTH_PUBLIC_IPV6 festlegen, wenn die lokale routenbasierte Entdeckung mehrdeutig ist.
Erwarteter Normalzustand
- MX verweist auf den vorgesehenen Mail-Hostnamen
- Der Mail-Hostname wird auf die aktuelle Server-IP zurück aufgelöst
- PTR verweist auf den gleichen Mail-Hostnamen oder ein kohärentes Äquivalent
- Postfix
myhostnameodersmtp_helo_nameverwendet den gleichen kanonischen Mail-Hostnamen - SPF ist vorhanden und nicht übermäßig permissiv
- DKIM wird veröffentlicht und entspricht dem konfigurierten Selektor
- Postfix leitet ausgehende E-Mails über Rspamd- und Rspamd-Zeichen mit demselben Selektor, den Herne in DNS anzeigt
- DMARC existiert und bewegt sich im Idealfall über
p=nonehinaus, sobald Sendeflüsse validiert sind - Postfix und Dovecot sind aktiv, mit den erwarteten Zuhörern anwesend
- Die Live-Provisioning-Artefakte existieren und entsprechen dem Bedienfeldzustand
Häufige Lösungen
- Fehlende MX: Veröffentlichen eines MX-Records, der auf den konfigurierten E-Mail-Hostnamen verweist
- Fehlende PTR: Bitten Sie den Hosting-Provider, Reverse-DNS für die Server-IP festzulegen
- PTR-Mismatch: Ausrichtung von PTR, MX und A/AAAA um einen kohärenten E-Mail-Hostnamen
- HELO-Fehlanpassung: Setzen Sie Postfix
myhostnameodersmtp_helo_nameauf den kanonischen Mail-Hostnamen - SPF zu breit: Ersetzen Sie permissive SPF-Regeln durch eine engere Absenderrichtlinie
- DKIM DNS geht weiter, aber Gmail zeigt immer noch kein DKIM an: check
smtpd_milters,non_smtpd_miltersundrspamadm configdump dkim_signing - DMARC
p=none: in Quarantäne gehen oder ablehnen, nachdem legitime Absender validiert wurden - Einreichung fehlt: Postfix-Einreichung auf Port 587 aktivieren
- TLS-Unsicherheit: Installieren oder Beheben des Zertifikats, das den konfigurierten E-Mail-Hostnamen abdeckt
- Provisionsdrift: Verwenden Sie die Domain-Reprovision oder die vollständige Rekonstruktionsaktion, um Artefakte zu regenerieren
Gmail-Spamprobleme beheben
Wenn macOS Mail, Webmail und serverseitige Sendungen alle Gmail erreichen, aber in Spam landen, behandeln Sie es als ein Problem mit der sendenden Identität oder Reputation und nicht als ein Client-Setup-Problem.
- Führen Sie
php artisan herne:email:health example.comaus und beheben Sie zuerst PTR, HELO-Hostname, SPF, DKIM, DMARC, milter und Provisioning-Warnungen. - Reverse DNS sollte von der sendenden IP auf denselben kanonischen Hostnamen verweisen, der von MX, A, Postfix, SMTP HELO und TLS verwendet wird.
- Bitten Sie den Benutzer, in Gmail Original anzeigen aufzurufen und die Zeilen SPF, DKIM, DMARC und Authentication-Results mitzuteilen. Ziehen Sie keine Schlüsse allein daraus, in welchem Ordner die Nachricht gelandet ist.
- Wenn Gmail eine fehlende oder fehlerhafte DKIM-Signatur meldet, obwohl Herne DNS DKIM als bereit anzeigt, prüfen Sie die Signaturkette für ausgehende E-Mails. Kontrollieren Sie die Postfix-Milter-Anbindung, Rspamd
dkim_signing, den Selektor, den Domain-Block und den Lesezugriff auf den privaten Schlüssel. - Verwenden Sie die Gmail Postmaster Tools und eine schrittweise Aufwärmphase für neue IPs, neue Domains oder kürzlich reparierte E-Mail-Identität. Die Authentifizierung kann vergehen, bevor der Ruf für die Platzierung im Posteingang stark genug ist.
Postfix-Integration
Der Installer aktualisiert /etc/postfix/main.cf chirurgisch mit den Herne-verwalteten Kartenreferenzen und ermöglicht die Einreichung in /etc/postfix/master.cf. Ein Referenz-Snippet wird immer noch in stubs/email/postfix-maincf-snippet.txt für Betreiber ausgeliefert, die die Zielverdrahtung überprüfen möchten.
Dovecot-Integration
Der Installer wechselt Dovecot zu einem Herne-verwalteten Passwd-Datei-Incluse, schreibt den Maildir, LMTP und Postfix Auth Socket-Snippet und speichert Backup-Kopien, bevor er die Live-Dateien berührt. Ein Referenz-Snippet wird immer noch in stubs/email/dovecot-auth-snippet.conf versendet.
Fehler am SMTP-Authentifizierungssocket für Webmail
Wenn Webmail-Send mit Connection to "mail.example.com:587" has been closed unexpectedly und /var/log/mail.log zeigt SASL: Connect to Dovecot auth socket 'private/auth' failed oder no SASL authentication mechanisms fehlschlägt, kann die Postfix-Einreichung Dovecot SASL nicht auth erreichen.
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'
Der erwartete Dovecot-Hörer ist /var/spool/postfix/private/auth mit Modus 0660, Benutzer postfix und Gruppe postfix. Postfix sollte smtpd_sasl_type = dovecot, smtpd_sasl_path = private/auth und smtpd_sasl_auth_enable = yes verwenden.
Sicherungen und Reparaturmodus
Vor Änderungen an der Systemkonfiguration legt Herne Sicherungen mit Zeitstempel unter /etc/herne-mail/backups/{timestamp}/... ab. Führen Sie php artisan herne:install-mail-stack --repair erneut aus, wenn die zuvor funktionierende Herne-Mailkonfiguration vom vorgesehenen Zustand abweicht oder Teile der Konfiguration von Hand bearbeitet wurden.
Wann der Vorgang aus Sicherheitsgründen abgelehnt wird
Herne weigert sich standardmäßig, automatisch anzuwenden, wenn es eine scheinbar inkompatible bestehende Postfix- oder Dovecot-Einrichtung erkennt, wenn der kanonische Mail-Hostname fehlt oder wenn der Befehl nicht über den Root-Level-Zugriff verfügt, der erforderlich ist, um die Systemkonfiguration sicher zu ändern.
Passwort-Hashverfahren
Herne verwendet SHA512-CRYPT für die Live Dovecot passwd-Datei. Panelseitige Mailbox-Passwörter bleiben separat in der Anwendungsdatenbank gehasht.
Sudoers-Anforderungen
Das frühere Verfahren zur E-Mail-Bereitstellung erforderte für Herne eng begrenzten sudo-Zugriff. Hier ist die Befehlsliste dieses Verfahrens:
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
Verhalten beim Löschen
Beim Löschen eines Postfachs entfernt Herne den aktiven Authentifizierungs- und Zuordnungseintrag und baut die verwalteten Dateien neu auf. Die Postfachdaten werden unter /var/vmail/.trash/{timestamp}-{domain}-{local_part} archiviert, ohne sie endgültig zu löschen.
Weiterhin nicht enthalten
- Roundcube oder ein vollwertiger Webmail-Client der Desktop-Klasse
- Aliase und Weiterleitungen UI
- Oberfläche für die Spam-Quarantäne
- Anhänge- und Ordnerverwaltung in Webmail
- Multiserver-Mail-Cluster