文档改进建议:
在配置 SMTP 与外部提供商(我使用的是 SendGrid)时,我没有收到注册电子邮件。运行 discourse-doctor 识别出错误:“原因:550 发件人地址与已验证的发件人身份不匹配”。
虽然我在 SendGrid 中已验证了顶级域名(example.com)用于发送,但我尚未验证 discourse 子域名(discourse.example.com),因此 SendGrid 拒绝了 API 调用。
虽然这只花了大约 15 分钟才弄清楚,但我觉得在 app.yml 和安装脚本中添加一个额外的注释会很有帮助,让新用户在未来安装 Discourse 时更容易理解,从而减少摩擦。此外,直接引用故障排除页面也会很有帮助。
类似这样:
# 大多数 SMTP 提供商都需要经过身份验证的域名或经过身份验证的电子邮件地址才能发送电子邮件。请确保您已将发送域名(example.com)、子域名(discourse.example.com)以及“notifications”电子邮件地址与您的 SMTP 提供商进行身份验证,然后再注册新用户,以确保电子邮件的可送达性。
#
# `discourse-doctor` 命令可以帮助测试您的电子邮件配置。
# 请参阅:https://meta.discourse.org/t/troubleshoot-email-on-a-new-discourse-install