E-Mail

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.

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.

  • postfix
  • postfix-pcre wenn Ihre Server-Richtlinie es bereits an anderer Stelle erwartet
  • dovecot-core
  • dovecot-imapd
  • dovecot-pop3d
  • dovecot-lmtpd
  • rspamd
  • redis-server (empfohlen für Rspamd)
  • dnsutils
  • openssl

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, tmp und drafts
  • 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 myhostname oder smtp_helo_name verwendet 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=none hinaus, 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 myhostname oder smtp_helo_name auf 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_milters und rspamadm 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.com aus 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