nextxch 文档

完整的邮件、Webmail PWA、移动推送和 CalDAV/CardDAV 运行需要 5 个入站 TCP 端口：25（ESMTP MX 入站）、443（用于 Webmail、管理、JMAP、CalDAV/CardDAV & 移动推送的 HTTPS）、465（SMTPS 隐式 TLS）、587（Submission STARTTLS）和 993（IMAPS）。可选端口为 80（Let's Encrypt HTTP-01）、143（IMAP STARTTLS）、4190（ManageSieve），启用 POP3 时还有 995（POP3S）/ 110（POP3 STLS），此外还需要通往互联网的出站 TCP 端口 25。

当 Web 服务器和邮件服务器共用一个防火墙（如 pfSense、OPNsense 或 HAProxy）且未启用 Hairpin NAT (NAT Reflection) 时，从网关内部发往您自己公网 WAN IP 的数据包会被丢弃。自 v1.2.4 起，nextxch 通过分路探测自动检测共置网关拓扑。对于局域网客户端，建议配置 Split-DNS 主机覆盖或 Pure NAT Reflection。

在 /admin/ 的 账户与列表 -> 设备设置 中（或在 Webmail 设置中），nextxch 会生成一个有效期 24 小时的设置页面链接（/onboarding/setup/{token}），并以一个专用的设备应用密码为支撑。WhatsApp、Teams、Telegram 或 Slack 的预览爬虫永远不会消耗该令牌，应用内 WebView 会显示简洁的 Safari 跳转提示，使 iOS 能顺利安装已签名的 .mobileconfig 描述文件。

将 JunkThreshold 保持在 4.5（可疑邮件路由到垃圾邮件文件夹），RejectThreshold 保持在 9.0（对明确的垃圾邮件以 SMTP 550 硬拒收），并搭配智能灰名单（对 IPv4 /24 和 IPv6 /64 前缀为 240 秒）。合法的 MTA 在重试时会自动通过灰名单并被缓存 30 天，避免误判导致数据丢失。

单台主机上最多约 250 个活动邮箱时，内嵌 SQLite WAL 可提供亚毫秒级读取，且无需 DBA 维护。已有 Microsoft SQL Server（2019-2025、Express 或 Azure SQL）的 Windows 环境可开箱即用地获得原生多节点集群和搜索功能，而 Linux 高可用集群则受益于 PostgreSQL 18 LISTEN/NOTIFY。