📬 Discourse 的邮件配置不是“可选项”，而是社区能否正常运转的基础。注册验证、找回密码、通知提醒、邮件回复发帖、管理员激活等流程都依赖邮件系统；如果 SMTP 没配好，论坛可能看起来已经安装成功，实际上用户却无法完成注册或收到通知。
一、为什么建议使用专业邮件服务
自建邮件服务器看似省钱，但实际需要处理反垃圾策略、IP 信誉、SPF、DKIM、DMARC、退信、限流等问题。Discourse 官方文档也明确建议使用专门的邮件服务，因为邮件投递配置复杂，任何一个环节配置错误都可能导致邮件无法送达或投递不稳定，详见 Discourse 邮件服务建议。
常见选择包括 Brevo、Mailgun、SendGrid、Amazon SES 等。选择服务商时，不要只看价格，还要关注是否支持 SMTP、是否允许论坛类通知邮件、是否提供域名验证、是否能查看投递日志，以及是否支持退信处理。对于新站来说，稳定送达比“免费额度”更重要。✅
二、准备工作：域名、邮箱与 DNS
配置前建议先准备一个专门的发信子域名，例如 mail.example.com 或 discourse.example.com。Discourse 官方邮件安装说明提醒，邮件服务中应验证并使用子域名，而不是只验证主域名，否则邮件配置可能不完整，参考 官方 INSTALL-email 文档。
DNS 方面通常需要配置 SPF、DKIM，有些服务商还会要求 DMARC 或 CNAME 记录。具体记录值必须以邮件服务商后台给出的为准，不要照抄别人的域名示例。配置完成后，建议等待 DNS 生效，再进入 Discourse 安装或修改配置，避免因为解析未生效而误判 SMTP 参数错误。
三、核心 SMTP 配置项
自托管 Discourse 通常在 /var/discourse/containers/app.yml 中配置邮件参数，也可以在安装时通过 ./discourse-setup 按提示填写。官方排错文档列出的典型配置包括 SMTP 地址、端口、用户名、密码和开发者邮箱等，详见 Discourse 邮件排错指南。
DISCOURSE_DEVELOPER_EMAILS: 'admin@example.com'
DISCOURSE_SMTP_ADDRESS: smtp.example.com
DISCOURSE_SMTP_PORT: 587
DISCOURSE_SMTP_USER_NAME: user@example.com
DISCOURSE_SMTP_PASSWORD: your_password
DISCOURSE_NOTIFICATION_EMAIL: noreply@example.com
其中 DISCOURSE_NOTIFICATION_EMAIL 很关键，它是论坛通知邮件的发件人地址。很多服务商要求发件地址必须属于已验证域名，或者必须与 SMTP 认证账号、授权发信身份一致。如果这里乱填，可能出现“发件人不被允许”“Sender rejected”等错误。
四、端口与加密方式怎么选
多数邮件服务推荐使用 587 端口配合 STARTTLS，这是比较常见的 SMTP 提交方式。部分服务商也支持 465 端口，但如果使用 465，通常需要确认是否要启用强制 TLS。不同服务商的要求不完全一致，所以端口、加密方式、用户名格式都应以服务商后台说明为准。
如果服务器无法连接 SMTP 服务，问题可能不在 Discourse，而在云服务器供应商限制了邮件端口。Discourse 官方排错建议可用类似 telnet smtp.mailgun.org 587 的方式测试服务器到 SMTP 服务的连通性；如果连接失败，可以尝试服务商支持的其他端口，或联系云厂商确认是否屏蔽了邮件发送端口，见 官方排错说明。
五、修改配置后如何生效
修改 app.yml 后，配置不会自动生效。稳妥做法是重建容器：
cd /var/discourse/
./launcher rebuild app
如果只是调整 SMTP 参数，官方排错文档也提到可以通过销毁并启动容器来应用变更，这通常比完整 rebuild 更快：
cd /var/discourse
./launcher destroy app
./launcher start app
不过，如果你不确定改动范围，或者同时调整了多个环境变量，建议直接 rebuild。虽然耗时更久，但更容易排除缓存、旧配置未加载等干扰因素。
六、安装后如何测试邮件
如果管理员账号收不到激活邮件，可以先运行 ./discourse-doctor。根据官方说明，该工具会检查多种邮件配置问题，并给出相应建议，适合新安装后无法收信的场景，参考 Troubleshoot email on a new Discourse install。
进入后台后，也可以在管理面板的邮件相关页面查看发送日志、失败记录和服务器设置。排查时重点看错误信息，而不是反复更换配置。常见线索包括认证失败、域名未验证、发件人不匹配、端口连接超时、DNS 记录缺失、密码中含特殊字符导致 YAML 解析异常等。
七、常见问题清单 🧪
- 收不到注册邮件：先检查 SMTP 是否能发送测试邮件，再查看垃圾箱和邮件服务商投递日志。
- 认证失败：确认 SMTP 用户名和密码是否来自邮件服务商的 SMTP 凭据，而不是普通登录密码。
- 发件人被拒绝：检查 DISCOURSE_NOTIFICATION_EMAIL 是否属于已验证域名，是否被服务商允许发信。
- 配置看似正确但不生效：确认 app.yml 缩进正确、没有多余注释符号，并在修改后重启或重建容器。
- 端口无法连接：测试服务器到 SMTP 地址和端口的连通性，必要时联系云服务器厂商放行。
八、入站邮件与邮件回复
除了发送通知，Discourse 还支持通过邮件创建主题、发送群组消息或回复内容。启用这类功能前，需要在后台开启 email-in 相关设置，并为分类或群组配置接收地址。官方文档说明了通过入站邮件创建主题或群组消息的配置方式，详见 入站邮件配置指南。
入站邮件比普通 SMTP 发信更复杂，因为它涉及收信、解析、权限判断、用户匹配和垃圾内容控制。建议先把基础发信配置稳定运行，再逐步开启邮件回复或邮件发帖功能。对于公开社区，还应谨慎设置允许通过邮件发帖的用户组，避免滥用。
总结
Discourse 邮件配置的关键不是“填上 SMTP 就完事”，而是把 发信身份、DNS 验证、端口加密、容器生效、日志排错 连成一条完整链路。推荐流程是：先选可靠邮件服务商，再验证专用子域名，随后填写 SMTP 参数，修改后重启或重建容器，最后用 discourse-doctor 和后台日志测试。只要按这个顺序排查，大多数邮件问题都能定位清楚。🚀
