E-mail

Utilisez Sites → e-mail pour inspecter la disponibilité du serveur de courrier, vérifier les enregistrements DNS requis, et fournir des boîtes aux lettres réelles dans la configuration en direct Postfix et Dovecot pour le domaine du site.

Herne fournit désormais de vraies boîtes aux lettres à un seul serveur lorsque le serveur est correctement préparé. Webmail, alias et topologies de courrier multi-serveurs restent hors de portée.

Stratégie de fourniture

Herne Phase 2 utilise un chemin de fourniture de courrier à serveur unique basé sur des fichiers. La base de données des panels reste la source de vérité, et Herne génère des artefacts Postfix et Dovecot à partir de ces données sous une racine gérée dédiée.

Le chemin principal pris en charge sur un nouveau serveur est maintenant l'installateur Herne unifié:

curl -fsSL https://raw.githubusercontent.com/fklavyenet/herne/main/install.sh | sudo bash

Répondez à yes lorsque l'installateur demande s'il doit installer la pile de courrier, puis fournissez EMAIL_HOSTING_SERVER_HOSTNAME afin que Herne puisse configurer un nom d'hôte de messagerie canonique cohérent pour Postfix. Une fois la pile locale prête, utilisez les pages de messagerie du panneau pour fournir des domaines et des boîtes aux lettres.

Si Herne est déjà installé et que vous ajoutez du courrier plus tard, le chemin autonome reste :

php artisan herne:install-mail-stack --check
php artisan herne:install-mail-stack --apply
php artisan herne:email:check-server

Ce que gère 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 écrit les fichiers sources, exécute postmap pour les cartes Postfix, crée des répertoires Maildir et recharge postfix et dovecot seulement après que les nouveaux fichiers ont été mis en scène avec succès.

Paquets Ubuntu requis

L'installateur peut les installer automatiquement sur Debian et Ubuntu avec apt non interactif lorsque l'opérateur l'exécute en tant que racine ou avec sudo sans mot de passe.

  • postfix
  • postfix-pcre si votre politique de serveur l'attend déjà ailleurs
  • dovecot-core
  • dovecot-imapd
  • dovecot-pop3d
  • dovecot-lmtpd
  • rspamd
  • redis-server (recommandé pour Rspamd)
  • dnsutils
  • openssl

Contrôles de la disponibilité

Herne vérifie ces exécutables : postfix, postconf, postmap, dovecot, doveconf, rspamd, rspamadm, openssl, systemctl, ss, ainsi que dig ou host.

Herne vérifie également les services postfix, dovecot, rspamd et redis-server, les ports de messagerie 25, 465, 587, 143, 993, 110 et 995, ainsi que les règles UFW si UFW est installé.

Phase 2 vérifie également le câblage d'intégration et la préparation du système de fichiers : l'utilisateur/groupe vmail, la racine vmail en écriture, la racine de configuration gérée par Herne et si postconf -n / doveconf -n référencent réellement les fichiers gérés par Herne.

Modèle d'utilisateur de courrier virtuel prévu

Herne installe et utilise un compte système dédié pour le stockage de la boîte aux lettres, généralement vmail:vmail. Herne s'attend à ce que Maildir stocke sous /var/vmail et archives supprimé de la boîte aux lettres stockage sous /var/vmail/.trash.

Herne préfère UID/GID 5000 lorsqu'il est libre, mais elle revient en toute sécurité si cette identité est déjà utilisée.

Version initiale du webmail

Herne comprend un Webmail MVP de première partie léger à /webmail. Il s'agit d'un flux de connexion de boîte aux lettres séparé et ne nécessite pas de compte de panneau Herne.

  • Les utilisateurs de la boîte aux lettres se connectent avec l'adresse e-mail complète et le mot de passe de la boîte aux lettres.
  • Seules les boîtes aux lettres Herne actives, fournies en direct, peuvent se connecter.
  • Le MVP prend en charge la boîte de réception, la lecture, l'envoi, la réponse et la suppression.
  • Le courrier sortant utilise toujours l'adresse de la boîte aux lettres connectée comme expéditeur.
  • Les pièces jointes, la gestion des dossiers, les alias/transferts, la quarantaine de spam, l'édition de texte riche et le webmail multi-serveurs sont en dehors du MVP.

Le courrier entrant utilise l’extension PHP imap avec IMAP, généralement sur le port 993 avec SSL. L’envoi SMTP utilise les identifiants de la boîte aux lettres et le serveur de messagerie configuré, généralement EMAIL_HOSTING_SERVER_HOSTNAME ou mail.{domain}, sur le port 587 avec STARTTLS.

Stockage Webmail vs Stockage Maildir

Les données d'exécution Webmail et le stockage réel de la boîte aux lettres sont volontairement séparés:

  • Webmail stockage app/runtime: /var/www/{site}/webmail
  • Sous-répertoires Webmail : cache, tmp et drafts
  • Boîte aux lettres réelle Stockage Maildir : /var/vmail/{domain}/{local_part}/Maildir

Le répertoire de messagerie Web n'est pas sous le web_root public et n'est pas automatiquement inclus dans les sauvegardes de fichiers du site. Le MVP ne déplace pas la livraison de courrier Dovecot sous /var/www, en préservant le modèle de permission vmail existant.

Commandes de serveur utiles

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

Enregistrements DNS Herne s'attend

dig MX example.com
dig TXT example.com
dig TXT herne._domainkey.example.com
dig TXT _dmarc.example.com

Le panneau génère des enregistrements MX, SPF, DKIM et DMARC recommandés pour chaque domaine de messagerie et les vérifie par rapport au DNS public. Un domaine est uniquement marqué DNS-ready lorsque les enregistrements requis sont réellement présents ou explicitement compatibles.

État de la messagerie et délivrabilité

La phase 3 ajoute une couche de diagnostic-première santé. Herne ne calcule pas un faux score de la livraison. Il stocke plutôt un instantané structuré compact avec des constatations explicites, des catégories groupées et des corrections recommandées.

Catégories du diagnostic

  • Identité DNS: MX, SPF, DKIM, DMARC présence et résistance de base
  • Identité de l’hôte : nom d’hôte du serveur, identité HELO de Postfix, résolution A/AAAA du serveur de messagerie, PTR et cohérence entre les DNS direct et inverse
  • Accessibilité SMTP : État Postfix plus auditeurs locaux pour 25, 465 et 587
  • IMAP/POP/TLS basiques : État Dovecot plus auditeurs locaux pour 143, 993, 110 et 995, et contrôles partiels de la santé TLS lorsque cela est pratique
  • Prérequis anti-spam : Rspamd, Redis quand prévu, force de la politique DMARC, largeur de la politique SPF, disponibilité DKIM DNS, câblage de milter Postfix et alignement du sélecteur de signature DKIM sortant
  • Intégrité de la fourniture : état du panneau par rapport à la présence d'artefacts vivants et à la dérive de l'état généré
  • Visibilité du pare-feu : état UFW et si les ports de courrier apparaissent autorisés lorsque UFW est actif

Significations de l'état

  • passer : la vérification a réussi sur la base des preuves que Herne pourrait rassembler
  • avertissement : l'installation peut fonctionner, mais une faiblesse ou un décalage est visible
  • échec: une condition préalable attendue est clairement manquante ou cassée
  • inconnu : la vérification n'a pas pu être prouvée en toute sécurité dans l'environnement actuel
  • non disponible : l'outil nécessaire pour la vérification n'existe pas localement

Pourquoi PTR importe

De nombreux serveurs de réception attendent que l’adresse IP d’envoi ait un DNS inverse et que le PTR corresponde à un hôte de messagerie valide. Herne ne vérifie le PTR que s’il peut déterminer l’IP publique de manière fiable. Vous pouvez définir EMAIL_HEALTH_PUBLIC_IPV4 et EMAIL_HEALTH_PUBLIC_IPV6 si la découverte à partir du routage local est ambiguë.

Conditions de bon fonctionnement

  • MX pointe vers le nom d'hôte de e-mail prévu
  • Le nom d'hôte du e-mail résout le serveur actuel IP
  • PTR pointe vers le même hôte de messagerie ou un équivalent cohérent
  • Postfix myhostname ou smtp_helo_name utilise le même hôte de messagerie canonique
  • SPF est présent et n'est pas trop permissif
  • DKIM est publié et correspond au sélecteur configuré
  • Postfix effectue des trajets vers le courrier sortant par Rspamd et Rspamd avec les mêmes affichages Herne dans DNS
  • DMARC existe et idéalement se déplace au-delà de p=none une fois les flux d'envoi validés
  • Postfix et Dovecot sont actifs, les auditeurs attendus étant présents
  • Les artefacts de fourniture en direct existent et correspondent à l'état du panneau

Corrections communes

  • Missing MX: publiez un enregistrement MX pointant vers le hôte de messagerie configuré
  • Missing PTR : demandez au fournisseur d'hébergement de définir DNS inversement pour le serveur IP
  • Incassable PTR: aligner PTR, MX et A/AAAA autour d'un hôte de messagerie cohérent
  • Désaccord HELO : définissez Postfix myhostname ou smtp_helo_name au nom d'hôte du e-mail canonique
  • SPF trop large: remplacer les règles permissive SPF par une politique d'expéditeur plus étroite
  • DKIM DNS passe mais Gmail n'affiche toujours pas DKIM : vérifiez smtpd_milters, non_smtpd_milters et rspamadm configdump dkim_signing
  • DMARC p=none : passer à la quarantaine ou rejeter après validation des expéditeurs légitimes
  • Soumission manquante: activer la soumission Postfix sur le port 587
  • Incertitude TLS : installez ou corrigez le certificat couvrant le hôte de messagerie configuré
  • Dérivé de provisionnement : utiliser la réapprovisionnement du domaine ou l'action de reconstruction complète pour régénérer les artefacts

Gmail dépannage des pourriels

Si macOS Mail, Webmail et server-side envoient tous les messages à Gmail mais atterrissent dans le spam, traitez-le comme un problème d'identité ou de réputation d'envoi plutôt qu'un problème de configuration client.

  • Exécutez php artisan herne:email:health example.com et corrigez PTR, HELO hostname, SPF, DKIM, DMARC, milter, et les avertissements de fourniture d'abord.
  • Le DNS inverse doit pointer du IP envoyé au même nom d'hôte canonique utilisé par MX, A, Postfix, SMTP HELO et TLS.
  • Demandez à l'utilisateur d'ouvrir Gmail Afficher l'original et de rapporter les lignes SPF, DKIM, DMARC et Authentification-Résultats. Ne devinez pas du placement de la boîte de réception seul.
  • Si Gmail affiche DKIM manquant ou défaillant alors que Herne DNS dit DKIM est prêt, vérifiez le chemin de signature sortant : câblage Milter Postfix, Rspamd dkim_signing, sélecteur, bloc de domaine et lisibilité des clés privées.
  • Utilisez les outils Gmail Postmaster et une période de réchauffage progressive pour les nouveaux IPs, nouveaux domaines ou récemment réparés. L'authentification peut passer avant que la réputation soit assez forte pour le placement de boîte de réception.

Intégration Postfix

L'installateur met à jour chirurgicalement /etc/postfix/main.cf avec les références de cartes gérées par Herne et permet la soumission dans /etc/postfix/master.cf. Un extrait de référence est toujours expédié dans stubs/email/postfix-maincf-snippet.txt pour les opérateurs qui veulent revoir le câblage cible.

Intégration Dovecot

L’installateur configure Dovecot pour inclure un fichier passwd géré par Herne, écrit la configuration de Maildir, de LMTP et du socket d’authentification Postfix, puis conserve des copies avant de toucher aux fichiers utilisés. Un exemple de configuration reste fourni dans stubs/email/dovecot-auth-snippet.conf.

Webmail SMTP dépannage de la socket auth

Si l'envoi de Webmail échoue avec Connection to "mail.example.com:587" has been closed unexpectedly et /var/log/mail.log montre SASL: Connect to Dovecot auth socket 'private/auth' failed ou no SASL authentication mechanisms, la soumission de Postfix ne peut pas atteindre 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'auditeur Dovecot attendu est /var/spool/postfix/private/auth avec le mode 0660, l'utilisateur postfix et le groupe postfix. Postfix devrait utiliser smtpd_sasl_type = dovecot, smtpd_sasl_path = private/auth et smtpd_sasl_auth_enable = yes.

Mode sauvegarde et réparation

Avant de changer la configuration du système, Herne stocke les sauvegardes horodatées sous /etc/herne-mail/backups/{timestamp}/.... Re-lancez php artisan herne:install-mail-stack --repair si une pile de courrier Herne déjà en service dérive ou si un opérateur a partiellement édité la configuration à la main.

Cas de refus en toute sécurité

Herne refuse automatiquement d'appliquer par défaut lorsqu'il détecte une configuration Postfix ou Dovecot existante apparemment incompatible, lorsque le nom de l'hôte du e-mail canonique est manquant, ou lorsque la commande n'a pas l'accès root-level nécessaire pour modifier la configuration du système en toute sécurité.

Système de mot de passe

Herne utilise SHA512-CRYPT pour le fichier en direct Dovecot passwd. Les mots de passe de boîte aux lettres côté panneau restent hashés séparément dans la base de données des applications.

Exigences concernant les sudoeurs

Herne a besoin d'un accès au sudo étroitement encadré pour les opérations de fourniture de courrier. Les commandes exactes requises sont:

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

Comportement de suppression

La suppression de la boîte aux lettres est conservatrice. Herne supprime l'entrée auth/map en direct, reconstruise les artefacts gérés et archive la boîte aux lettres dans /var/vmail/.trash/{timestamp}-{domain}-{local_part} au lieu de la supprimer définitivement.

Toujours hors de portée

  • Roundcube ou un client Webmail de classe bureau complet
  • Aliases et transitaires UI
  • quarantaine pourriel UI
  • Pièces jointes et gestion de dossiers dans Webmail
  • Clusters de courrier multi-serveurs