v1.0.0 Manual oficial · 5 grupos temáticos · 24 guías específicas

Documentación de nextxch

Manual de referencia claramente organizado que abarca instalación, DNS, seguridad, groupware, automatización con CLI y operación: cada guía específica documenta los valores predeterminados exactos y las buenas prácticas de producción.

Primeros pasos

Desde un host Windows, Linux o Docker recién instalado hasta la matriz de puertos perimetrales.

Redes, DNS & criptografía

Entregabilidad 10/10 con FCrDNS/PTR, Dual-DKIM, IPv6, pfSense & DANE con Let's Encrypt.

Transporte y defensa del correo

Cola SMTP, diagnóstico MX en vivo, SpamGuard ML, greylisting, ClamAV, Fail2Ban & un gateway de correo antepuesto.

Clientes, groupware & CLI

Configuración de iPhone apta para mensajería, Outlook para Windows, calendario y contactos del Webmail, claves de API y CLI.

Cap. 10 →

Configuración de iPhone, móvil & WhatsApp

Los usuarios deben poder configurar correo, calendario, contactos y notas en iOS y macOS en menos de 30 segundos sin escribir puertos ni exponer su m...

Cap. 11 →

Webmail, calendario (CalDAV) & contactos

A diferencia de los backends de correo que solo ofrecen protocolos, nextxch incluye un Webmail PWA rápido e instalable (/mail/) con un calendario de groupware completo (mes, semana, d...

Cap. 12 →

Configurar Outlook para Windows

Microsoft Outlook para Windows se conecta a nextxch mediante IMAP (entrante) y SMTP (saliente). Esto se aplica a Outlook clásico (Microsoft 365 Apps, Out...

Cap. 13 →

nextxch-cli: comandos, consultas & IaC

Con nextxch-cli usted gestiona dominios, buzones, listas de distribución, alias, claves API con ámbito, rutas SMTP salientes (incl. excepciones TLS), calentamiento de IP...

Cap. 13b →

Configuración como código (GitOps)

Todo el estado del servidor como archivos YAML en Git: inquilinos, dominios (selectores DKIM, MTA-STS, enrutamiento), buzones con alias, reenvío y fuera de la of...

Cap. 14 →

Esquema de objetos de API & CLI (todos los campos)

Esta referencia documenta cada propiedad JSON, tipo de datos, valor de enumeración, valor predeterminado y rol RBAC mínimo de los 12 objetos de gestión (/api/...

Cap. 15 →

Claves API, Send API & SSO

Las aplicaciones web, las herramientas de tickets, los sistemas ERP y los pipelines de CI/CD nunca deben compartir contraseñas de buzones de personas. En Claves de API, SSO & reglas (#pApiAuth), mi...

Cap. 16 →

LDAP, AD, Entra ID & SSO

En Admin > Fuentes de identidad conecta un inquilino o dominios concretos a Active Directory o LDAP (inicio de sesión mediante bind, sincronización de usuarios, grupos anidados y...

Cap. 16a →

Kerberos SSO (inicio de sesión de Windows)

Con Kerberos, los PC con Windows de la red corporativa inician sesión sin solicitud de contraseña: Webmail y administración mediante SPNEGO ("Iniciar sesión con Windows"), Out...

Cap. 16b →

OAuth para Thunderbird, Outlook & CLI

nextxch es su propio servidor de autorización OAuth 2.1: las aplicaciones de correo inician sesión en el navegador mediante el inicio de sesión normal del webmail (incluidos 2FA y llaves de acceso),...

Cumplimiento, almacenamiento & operación

Message Trace, archivo GoBD WORM, SQLite / SQL Server / PostgreSQL 18 & actualizaciones.

Referencia rápida: los 5 puertos de entrada necesarios

Además, el puerto TCP 25 saliente debe estar abierto hacia Internet para la entrega MX directa.

TCP 25ESMTP MX entrante y saliente
TCP 443HTTPS: Webmail, administración, DAV, push
TCP 465Envío SMTPS de clientes (TLS)
TCP 587Submission (STARTTLS)
TCP 993Buzón IMAPS y push IDLE

Preguntas frecuentes de operación

¿Qué puertos del firewall son estrictamente necesarios para nextxch?

El funcionamiento completo de correo, Webmail PWA, Mobile Push y CalDAV/CardDAV requiere 5 puertos TCP de entrada: 25 (ESMTP MX entrante), 443 (HTTPS para Webmail, administración, JMAP, CalDAV/CardDAV & Mobile Push), 465 (SMTPS con TLS implícito), 587 (Submission STARTTLS) y 993 (IMAPS). Los puertos opcionales son 80 (Let's Encrypt HTTP-01), 143 (IMAP STARTTLS), 4190 (ManageSieve) y 995 (POP3S) / 110 (POP3 STLS) si POP3 está activado, además del puerto TCP 25 saliente hacia Internet.

¿Por qué puede agotarse el tiempo de una comprobación de puertos externa cuando ambos servidores están detrás del mismo pfSense o gateway SSL?

Cuando un servidor web y un servidor de correo comparten un firewall (como pfSense, OPNsense o HAProxy) sin Hairpin NAT (NAT Reflection), se descartan los paquetes enviados desde dentro del gateway a su propia IP WAN pública. A partir de la v1.2.4, nextxch detecta automáticamente las topologías con gateway compartido mediante sondeo de rutas divididas. Para los clientes de la LAN se recomienda configurar anulaciones de host Split-DNS o Pure NAT Reflection.

¿Cómo comparto de forma segura un perfil de configuración de iPhone o smartphone a través de WhatsApp o Microsoft Teams?

En Cuentas & listas -> Configuración de dispositivos dentro de /admin/ (o en la configuración del Webmail), nextxch genera un enlace a una página de configuración válido 24 horas (/onboarding/setup/{token}), respaldado por una contraseña de aplicación dedicada por dispositivo. Los rastreadores de vista previa de WhatsApp, Teams, Telegram o Slack nunca consumen el token, y los WebViews integrados en las aplicaciones muestran un aviso limpio de traspaso a Safari para que iOS instale correctamente el perfil .mobileconfig firmado.

¿Cuáles son los umbrales de SpamGuard recomendados para producción?

Mantenga JunkThreshold en 4.5 (envía el correo sospechoso a Spam) y RejectThreshold en 9.0 (rechazo SMTP 550 definitivo para el spam evidente), junto con el greylisting inteligente (240 segundos en prefijos IPv4 /24 e IPv6 /64). Los MTA legítimos superan el greylisting automáticamente al reintentar y se almacenan en caché durante 30 días, lo que evita pérdidas de datos por falsos positivos.

¿Qué motor de base de datos debo elegir: SQLite WAL, Microsoft SQL Server o PostgreSQL 18?

Hasta ~250 buzones activos en un único host, SQLite WAL integrado ofrece lecturas por debajo del milisegundo sin mantenimiento de DBA. Las empresas Windows con Microsoft SQL Server existente (2019-2025, Express o Azure SQL) obtienen de serie clustering nativo de varios nodos y búsqueda, mientras que los clústeres Linux de alta disponibilidad se benefician de PostgreSQL 18 LISTEN/NOTIFY.