Correo

Use Sitios → Correo para revisar la preparación del servidor de correo, verificar los registros DNS necesarios y aprovisionar buzones reales para el dominio del sitio en la instalación activa de Postfix y Dovecot.

Si el servidor está preparado correctamente, Herne ya puede aprovisionar buzones reales en un único servidor. El webmail, los alias y las topologías de correo multi-servidor siguen fuera de alcance.

Estrategia de aprovisionamiento

Herne Phase 2 utiliza una ruta de suministro de correo de un servidor único basado en archivos. La base de datos del panel sigue siendo la fuente de la verdad, y Herne genera artefactos Postfix y Dovecot de esos datos bajo una raíz gestionada dedicada.

La ruta principal compatible en un servidor fresco es ahora el instalador Herne unificado:

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

Respuesta yes cuando el instalador pregunta si debe instalar la pila de correo, entonces proporcione EMAIL_HOSTING_SERVER_HOSTNAME por lo que Herne puede configurar un nombre de host de correo canónico coherente para Postfix. Después de que la pila local esté lista, utilice las páginas de correo electrónico del panel para proporcionar dominios y buzones de correo.

Si Herne ya está instalado y usted está añadiendo correo más tarde, el camino independiente permanece:

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

Qué administra 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 escribe los archivos de origen, ejecuta postmap para las tablas de Postfix, crea los directorios Maildir y recarga postfix y dovecot solo cuando los nuevos archivos se han preparado correctamente.

Paquetes de Ubuntu necesarios

El instalador puede instalar estos automáticamente en Debian y Ubuntu con no interactivo apt cuando el operador lo ejecute como raíz o sin contraseña sudo.

  • postfix
  • postfix-pcre si su política de servidor ya lo espera en otro lugar
  • dovecot-core
  • dovecot-imapd
  • dovecot-pop3d
  • dovecot-lmtpd
  • rspamd
  • redis-server (recomendado a Rspamd)
  • dnsutils
  • openssl

Comprobaciones previas

Herne comprueba la presencia de estos programas: postfix, postconf, postmap, dovecot, doveconf, rspamd, rspamadm, openssl, systemctl, ss y uno de estos dos: dig o host.

Herne también comprueba los postfix, dovecot, rspamd, y redis-server servicios, los puertos de correo 25, 465, 587, 143, 993, 110, y 995, más las reglas UFW cuando se instala UFW.

La fase 2 también comprueba el cableado de integración y la preparación del sistema de ficheros: el usuario/grupo vmail, la raíz de vmail, la raíz de config gestionada por Herne, y si postconf -n / doveconf -nreferencia realmente los archivos gestionados por Herne.

Modelo previsto de usuarios virtuales de correo

Herne instala y utiliza una cuenta de sistema dedicada para el almacenamiento de buzón, típicamente vmail:vmail. Herne espera almacenamiento Maildir bajo /var/vmail y archivos borrados almacenamiento de buzón bajo /var/vmail/.trash.

Herne prefiere UID/GID 5000 cuando es libre, pero se vuelve seguro si esa identidad ya está en uso.

Versión inicial de Webmail

Herne incluye en /webmail una primera versión ligera de su propio Webmail. El inicio de sesión del buzón es independiente y no requiere una cuenta en el panel Herne.

  • Los usuarios de Mailbox se registran con la dirección de correo electrónico completa y contraseña de correo electrónico.
  • Sólo los buzones de Herne activas y provistas en vivo pueden iniciar sesión.
  • El MVP admite Inbox, read, send, reply y delete.
  • El correo de salida siempre utiliza la dirección de correo de entrada registrada como el remitente.
  • Los adjuntos, la gestión de carpetas, alias/parawarders, cuarentena de spam, edición de texto rica y correo web multiservidor están fuera del MVP.

Para el correo entrante se usa la extensión imap de PHP para IMAP, normalmente a través del puerto 993 con SSL. El envío por SMTP utiliza las credenciales del buzón y se conecta al servidor de correo configurado, normalmente EMAIL_HOSTING_SERVER_HOSTNAME o mail.{domain}, por el puerto 587 con STARTTLS.

Almacenamiento de Webmail y Maildir

Los datos de tiempo de ejecución del Webmail y el almacenamiento real del buzón de correo son intencionalmente separados:

  • Almacenamiento de la aplicación de correo web y de su entorno de ejecución: /var/www/{site}/webmail
  • Subdirectorios de tiempo de ejecución de correos web: cache, tmp y drafts
  • Almacenamiento Maildir real: /var/vmail/{domain}/{local_part}/Maildir

El directorio webmail no está bajo el público web_root y no se incluye automáticamente en las copias de seguridad de archivos del sitio. El MVP no mueve la entrega de correo Dovecot bajo /var/www, preservando el modelo de permiso vmail existente.

Comandos útiles del servidor

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

Registros DNS que espera Herne

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

El panel genera los registros recomendados MX, SPF, DKIM y DMARC para cada dominio de correo y los verifica contra DNS público. Un dominio sólo está marcado DNS-ready cuando los registros requeridos están realmente presentes o explícitamente compatibles.

Estado y entregabilidad del correo

Fase 3 añade una capa de salud diagnóstica-primera. Herne no calcula una puntuación falsa de entregabilidad. En su lugar, almacena una instantánea estructurada compacta con hallazgos explícitos, categorías agrupadas y correcciones recomendadas.

Categorías de estado

  • Identidad DNS: presencia y comprobación básica de MX, SPF, DKIM y DMARC
  • Identidad anfitriona: nombre de servidor, identidad de correo HELO, resolución de A/AAAAAA, PTR y coherencia DNS confirmada en el futuro
  • SMTP: Posfix state plus local listeners for 25, 465, and 587
  • Comprobaciones básicas de IMAP, POP y TLS: estado de Dovecot, servicios que escuchan localmente en los puertos 143, 993, 110 y 995, y comprobaciones parciales de TLS cuando sea viable
  • Prerrequisitos anti-spam: Rspamd, Redis cuando se espera, DMARC policy strength, SPF policy panth, DKIM DNS preparedness, Postfix milter wiring, and outbound DKIM signing selector alignment
  • Integridad del aprovisionamiento: estado del panel, presencia de archivos activos y diferencias en la configuración generada
  • Visibilidad del cortafuegos: estado UFW y si los puertos de correo aparecen permitidos cuando UFW está activo

Significado de los estados

  • paso: el cheque tuvo éxito basándose en evidencia que Herne pudo reunir
  • advertencia: la configuración puede funcionar, pero una debilidad o desajuste es visible
  • Fallo: un requisito previsto está claramente perdido o roto
  • desconocida: el cheque no se pudo probar con seguridad en el entorno actual
  • no disponible: la herramienta necesaria para el cheque no existe localmente

Por qué importa PTR

Muchos sistemas de recepción esperan que la IP de envío tenga DNS inverso y que PTR se alinea con un nombre de host de correo sensible. Herne comprueba PTR sólo cuando puede determinar la IP pública honestamente. Puede establecer EMAIL_HEALTH_PUBLIC_IPV4 y EMAIL_HEALTH_PUBLIC_IPV6 si el descubrimiento local basado en la ruta es ambiguo.

Estado normal esperado

  • MX apunta al nombre de host de correo deseado
  • El nombre de host por correo se resuelve de nuevo al servidor actual IP
  • PTR señala el mismo nombre de host por correo o un equivalente coherente
  • Postfix myhostname o smtp_helo_nameutiliza el mismo nombre de host por correo canónico
  • SPF está presente y no es excesivamente permisivo
  • DKIM es publicado y coincide con el selector configurado
  • Postfix viaja por correo a través de señales Rspamd y Rspamd con el mismo selector que Herne muestra en DNS
  • DMARC existe e idealmente se mueve más allá p=none una vez que se validan los flujos de envío
  • Postfix y Dovecot están activos, con los oyentes esperados presentes
  • Los artefactos de provisión en vivo existen y coinciden con el estado del panel

Soluciones habituales

  • Desaparecido MX: publicar un registro MX señalando el nombre de host configurado
  • Falta PTR: pida al proveedor de alojamiento que establezca DNS inverso para el servidor IP
  • Desigualdad de PTR: alinear PTR, MX y A/AAAA alrededor de un nombre de host coherente
  • Desigualdad de HELO: establecer Postfix myhostname o smtp_helo_nameal nombre de host de correo canónico
  • SPF demasiado amplia: reemplazar reglas permisivas SPF con una política más estrecha del remitente
  • DKIM DNS pasa pero Gmail todavía no muestra DKIM: cheque smtpd_milters, non_smtpd_milters y rspamadm configdump dkim_signing
  • DMARC p=none: pasar a cuarentena o rechazar después de validar los envíos legítimos
  • Falta de presentación: habilitar la presentación de Postfix en el puerto 587
  • Incierto TLS: instalar o fijar el certificado que cubre el nombre de host configurado
  • Suministro de deriva: utilice la reprovisión de dominios o la acción de reconstrucción completa para regenerar artefactos

Solucionar problemas de spam en Gmail

Si macOS Mail, Webmail y servidor-side envía todo el alcance de Gmail pero aterriza en spam, tratarlo como un problema de identidad o reputación que envía en lugar de un problema de configuración del cliente.

  • Ejecutar php artisan herne:email:health example.com y fijar PTR, HELO hostname, SPF, DKIM, DMARC, milter, y la provisión de advertencias primero.
  • DNS inverso debe apuntar desde la IP que envía al mismo nombre de host canónico utilizado por MX, A, Postfix, SMTP HELO y TLS.
  • Pide al usuario que abra Mostrar original en Gmail y facilite las líneas SPF, DKIM, DMARC y Authentication-Results. Evita sacar conclusiones solo a partir de la carpeta en la que cayó el mensaje.
  • Si Gmail muestra que DKIM falta o falla aunque Herne DNS indique que está listo, verifica la cadena de firma saliente. Comprueba la conexión al milter de Postfix, dkim_signing en Rspamd, el selector, el bloque del dominio y que se pueda leer la clave privada.
  • Utilice Gmail Postmaster Tools y un período de calentamiento gradual para nuevos IPs, nuevos dominios o identidad de correo recientemente reparada. La autenticación puede pasar antes de que la reputación sea lo suficientemente fuerte para la colocación de la caja.

Integración con Postfix

El instalador actualiza /etc/postfix/main.cf quirúrgicamente con las referencias del mapa gestionado por Herne y permite sumisión en /etc/postfix/master.cf. Un fragmento de referencia todavía se envía en stubs/email/postfix-maincf-snippet.txt para los operadores que quieren revisar el cableado de destino.

Integración con Dovecot

El instalador cambia Dovecot a un fichero de passwd gestionado por Herne incluyen, escribe el Maildir, LMTP y Postfix auth socket snippet, y mantiene copias de seguridad antes de tocar los archivos en vivo. Un fragmento de referencia todavía se envía en stubs/email/dovecot-auth-snippet.conf.

Solucionar problemas del socket de autenticación SMTP de Webmail

Si Webmail envía fallas con Connection to "mail.example.com:587" has been closed unexpectedly y /var/log/mail.logmuestra SASL: Connect to Dovecot auth socket 'private/auth' failed o no SASL authentication mechanisms, la sumisión de Postfix no puede llegar a 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'

El oyente Dovecot esperado es /var/spool/postfix/private/auth con modo 0660, usuario postfix y grupo postfix. El postfijo debe utilizar smtpd_sasl_type = dovecot, smtpd_sasl_path = private/auth, y smtpd_sasl_auth_enable = yes.

Copias de seguridad y modo de reparación

Antes de cambiar la configuración del sistema, Herne guarda copias de seguridad con marca de tiempo en /etc/herne-mail/backups/{timestamp}/.... Vuelve a ejecutar php artisan herne:install-mail-stack --repair si el servicio de correo de Herne funcionaba antes y su configuración se ha desviado del estado esperado, o si un operador modificó manualmente parte de la configuración.

Casos en que se rechaza la operación por seguridad

Herne se niega a aplicar automáticamente por defecto cuando detecta una configuración de Postfix o Dovecot aparentemente incompatible, cuando el nombre de host de correo canónico falta, o cuando el comando no tiene el acceso de nivel raíz requerido para cambiar el configuración del sistema de forma segura.

Esquema de hash de contraseñas

Herne utiliza SHA512-CRYPT para el archivo de Pasillo Dovecot vivo. Las contraseñas del buzón lateral del panel permanecen separadamente en la base de datos de la aplicación.

Requisitos de sudoers

El procedimiento anterior de aprovisionamiento de correo requería acceso sudo de alcance limitado para Herne. Esta era su lista de comandos:

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

Comportamiento al eliminar

Al eliminar un buzón, Herne quita la entrada activa de autenticación y asignación, regenera los archivos que administra y archiva los datos del buzón en /var/vmail/.trash/{timestamp}-{domain}-{local_part} sin eliminarlos definitivamente.

Aún fuera del alcance

  • Roundcube o un cliente de correo electrónico de clase completa
  • Aliases y reenvíos UI
  • Interfaz de cuarentena de spam
  • Adjuntos y gestión de carpetas en Webmail
  • Grupos de correo multiservidor