Smail/docs/邮件协议监听配置说明.md

邮件协议监听配置说明

配置入口

进入“设置 → 配置管理”，分别打开 SMTP 配置、IMAP 配置、POP3 配置。

配置页面	监听用途	默认端口
SMTP 配置	接收邮件，支持 STARTTLS	25
SMTP 配置	客户端提交，使用 STARTTLS	587
SMTP 配置	隐式 TLS	465
IMAP 配置	隐式 TLS	993
POP3 配置	使用 STLS 升级加密	110
POP3 配置	隐式 TLS	995

SMTP 页面中的发信中继是外部服务器连接配置，与本机监听端口无关。IMAP 当前仅提供隐式 TLS，不提供明文或 STARTTLS 监听。

“邮箱策略”自动读取这三个页面的已应用端口，不能再单独修改端口。该汇总不是在线检测，也不展示尚未应用的候选端口。

保存与生效

1. 修改对应协议端口，完成近期登录认证并验证配置。
2. 保存候选后核对内容，再应用配置。
3. 根据待重启提示重启后端，使新监听端口生效，并同步调整客户端、反代或防火墙。

IMAP、POP3、邮箱策略是独立页面，但共用邮箱配置分区。候选会提示涉及哪些页面，需要逐页核对；应用时该分区一起生效。配置端口不能与其他邮件监听或 Web 监听冲突。

存储与旧配置兼容

• SMTP 监听保存在 SMTP 分区的 listener，不覆盖 relay。
• IMAP、POP3 分别保存在邮箱分区的 imap、pop3，保留 policy。
• 未配置新 SMTP 收信端口、POP3 STLS 端口时，兼容旧策略端口；未配置其他端口时采用表中默认值。零值表示兼容默认，不表示禁用服务。
• 旧 policy.imapPort 从未控制实际监听，保留该字段但不把原有 TLS 端口从 993 自动迁移到 143。
• 保持原有配置分区文件结构，无需新增独立 IMAP、POP3 配置文件。