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.
Proceso de configuración recomendado
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.
postfixpostfix-pcresi su política de servidor ya lo espera en otro lugardovecot-coredovecot-imapddovecot-pop3ddovecot-lmtpdrspamdredis-server(recomendado a Rspamd)dnsutilsopenssl
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,tmpydrafts - 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
myhostnameosmtp_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=noneuna 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
myhostnameosmtp_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_miltersyrspamadm 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.comy 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_signingen 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