v1.0.0 Manual oficial · 5 grupos de temas · 24 guias focados

Documentação do nextxch

Manual de referência bem organizado, cobrindo instalação, DNS, segurança, groupware, automação via CLI e operação: cada guia específico documenta os valores padrão exatos e as boas práticas para produção.

Primeiros passos

De um host Windows, Linux ou Docker novo até a matriz de portas do perímetro.

Rede, DNS & criptografia

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

Transporte de e-mail & defesa

Fila SMTP, diagnóstico de MX ao vivo, SpamGuard ML, greylisting, ClamAV, Fail2Ban & um gateway de e-mail na frente.

Clientes, groupware & CLI

Configuração de iPhone segura para mensageiros, Outlook para Windows, calendário & contatos do Webmail, chaves de API & CLI.

Cap. 10 →

Configuração de iPhone, dispositivos móveis & WhatsApp

Os usuários devem conseguir configurar e-mail, calendário, contatos e notas no iOS e no macOS em menos de 30 segundos, sem digitar portas nem expor seus m...

Cap. 11 →

Webmail, calendário (CalDAV) & contatos

Diferentemente de backends de e-mail que oferecem apenas protocolos, o nextxch inclui um Webmail PWA rápido e instalável (/mail/) com um calendário de groupware completo (mês, semana, d...

Cap. 12 →

Configurar o Outlook para Windows

O Microsoft Outlook para Windows se conecta ao nextxch via IMAP (entrada) e SMTP (saída). Isso se aplica ao Outlook clássico (Microsoft 365 Apps, Out...

Cap. 13 →

nextxch-cli: comandos, consultas & IaC

Com o nextxch-cli, você gerencia domínios, caixas de correio, listas de distribuição, aliases, chaves de API com escopo, rotas SMTP de saída (incl. substituições de TLS), aquecim...

Cap. 13b →

Configuração como código (GitOps)

Todo o estado do servidor como arquivos YAML no Git: locatários, domínios (seletores DKIM, MTA-STS, roteamento), caixas de correio com aliases, encaminhamento e resposta autom...

Cap. 14 →

Schema de objetos da API & CLI (todos os campos)

Esta referência documenta cada propriedade JSON, tipo de dado, valor de enum, configuração padrão e função RBAC mínima de todos os 12 objetos de gerenciamento (/api/...

Cap. 15 →

Chaves de API, Send API & SSO

Aplicações web, ferramentas de tickets, sistemas ERP e pipelines de CI/CD nunca devem compartilhar senhas de caixas de correio de pessoas. Em Chaves de API, SSO & regras (#pApiAuth), mi...

Cap. 16 →

LDAP, AD, Entra ID & SSO

Em Admin > Fontes de identidade, você conecta um locatário ou domínios individuais ao Active Directory ou LDAP (login por bind, sincronização de usuários, grupos aninhados e...

Cap. 16a →

SSO Kerberos (entrada do Windows)

Com Kerberos, PCs Windows na rede da empresa entram sem solicitação de senha: webmail e admin via SPNEGO ("Entrar com Windows"), Out...

Cap. 16b →

OAuth para Thunderbird, Outlook & CLI

O nextxch é seu próprio servidor de autorização OAuth 2.1: os apps de e-mail fazem login no navegador pelo login normal do webmail (incluindo 2FA e chaves de acesso),...

Conformidade, armazenamento & operação

Message Trace, arquivo GoBD WORM, SQLite / SQL Server / PostgreSQL 18 & atualizações.

Referência rápida: as 5 portas de entrada necessárias

Além disso, a porta TCP 25 de saída deve estar aberta para a internet para a entrega direta via MX.

TCP 25ESMTP MX de entrada & saída
TCP 443HTTPS: Webmail, Admin, DAV, Push
TCP 465SMTPS Client Submission (TLS)
TCP 587Submission (STARTTLS)
TCP 993Caixa de correio IMAPS & push IDLE

Perguntas operacionais frequentes

Quais portas de firewall são estritamente necessárias para o nextxch?

A operação completa de e-mail, Webmail PWA, Mobile Push e CalDAV/CardDAV requer 5 portas TCP de entrada: 25 (ESMTP MX de entrada), 443 (HTTPS para Webmail, Admin, JMAP, CalDAV/CardDAV & Mobile Push), 465 (SMTPS TLS implícito), 587 (Submission STARTTLS) e 993 (IMAPS). As portas opcionais são 80 (Let's Encrypt HTTP-01), 143 (IMAP STARTTLS), 4190 (ManageSieve) e 995 (POP3S) / 110 (POP3 STLS) se o POP3 estiver ativado, além da porta TCP 25 de saída para a internet.

Por que uma verificação de porta externa pode expirar quando os dois servidores estão atrás do mesmo pfSense ou gateway SSL?

Quando um servidor web e um servidor de e-mail compartilham um firewall (como pfSense, OPNsense ou HAProxy) sem Hairpin NAT (NAT Reflection), os pacotes enviados de dentro do gateway para o seu próprio IP WAN público são descartados. A partir da v1.2.4, o nextxch detecta automaticamente topologias de gateway compartilhado por meio de sondagem por caminhos separados. Para clientes da LAN, recomenda-se configurar substituições de host Split-DNS ou NAT Reflection pura.

Como compartilhar com segurança um perfil de configuração de iPhone ou smartphone via WhatsApp ou Microsoft Teams?

Em Contas & listas -> Configuração de dispositivo no /admin/ (ou nas configurações do Webmail), o nextxch gera um link de página de configuração válido por 24 horas (/onboarding/setup/{token}) vinculado a uma senha de app dedicada por dispositivo. Crawlers de prévia do WhatsApp, Teams, Telegram ou Slack nunca consomem o token, e WebViews dentro de apps exibem um aviso limpo de transferência para o Safari, para que o iOS instale corretamente o perfil .mobileconfig assinado.

Quais são os limites recomendados do SpamGuard para produção?

Mantenha JunkThreshold em 4.5 (envia e-mails suspeitos para Spam) e RejectThreshold em 9.0 (rejeição SMTP 550 definitiva para spam evidente), combinados com o greylisting inteligente (240 segundos em prefixos IPv4 /24 e IPv6 /64). MTAs legítimos passam pelo greylisting automaticamente na nova tentativa e ficam em cache por 30 dias, evitando perda de dados por falsos positivos.

Qual mecanismo de banco de dados devo escolher: SQLite WAL, Microsoft SQL Server ou PostgreSQL 18?

Até ~250 caixas de correio ativas em um único host, o SQLite WAL embutido oferece leituras abaixo de um milissegundo sem nenhuma manutenção de DBA. Ambientes Windows com Microsoft SQL Server existente (2019-2025, Express ou Azure SQL) obtêm clustering nativo com vários nós e busca prontos para uso, enquanto clusters Linux de alta disponibilidade se beneficiam do LISTEN/NOTIFY do PostgreSQL 18.