邮件投递问题排查

你邀请了某个人，但对方什么都没收到。你申请了一个魔法链接，但收件箱一直是空的。这一页解释了为什么预期中的邮件会不见踪影，以及如何查明实际发生了什么。

最常见的原因：全新实例默认不发送邮件

在一个刚刚自行托管的实例上，KolleK 的邮件发送方式默认是记录邮件而不是真正发送邮件。每封邮件都会被正常撰写并记录下来，但在运营者配置好真正的邮件服务之前，什么都不会真正离开服务器。

这是有意设计的，这样一个尚未配置好的实例就不会悄无声息地失败，也不会意外造成垃圾邮件。但这也意味着，在一次全新安装中，邀请邮件、魔法链接、密码重置邮件，以及安全提醒邮件看起来全都会"消失"。

如果你是这个实例的运营者，请按照设置邮件发送配置 SMTP 或 Resend。

如果是别人在运营它，请把这个页面指给他们看，应用内部没有任何东西是你能改的。

查看实际发送了什么

KolleK 会记录发给你的每一封邮件，以及它的投递状态。前往你的个人资料，打开已发送邮件历史记录。每一条记录都会显示发送时间，以及在有追踪信息的情况下，是否已送达或被退回。

如何解读你看到的结果：

• 邮件已列出，且标记为已送达。 KolleK 已经完成了它的工作，请检查你的垃圾邮件文件夹，并在收件箱中搜索发件人地址。
• 邮件已列出，且标记为已退回。 你的邮件服务商拒收了这封邮件。请检查你个人资料中的地址是否正确，以及你的服务商是否在拦截这个实例的发件地址。
• 邮件已列出，但没有投递信息。 在通过普通 SMTP 发送邮件的实例上，投递追踪功能不可用，这属于正常情况，没有退回记录已经是个好迹象。
• 邮件根本没有列出。 说明这封邮件从未被生成过，通常意味着对应的操作没有完成，请重新尝试一次那个操作。

关于这个界面的完整说明，参见你的个人活动日志和已发送邮件。

邀请一直没有送达受邀人

邀请邮件是发给受邀人的，所以它不会出现在你自己的已发送历史记录里。请让受邀人检查垃圾邮件文件夹，确认你输入的邮箱地址是否正确，并记住邀请会在七天后过期。如果不确定，重新发一份就好。在一个全新的实例上，请先按上面的说明检查邮件配置。

验证邮件、重置邮件和魔法链接被归入垃圾邮件

来自一个小型自托管实例的事务性邮件，正是垃圾邮件过滤器格外警惕的那种类型。把其中一封邮件标记为"非垃圾邮件"，通常就能让你的邮件服务商学会不再拦截。运营者可以通过正确配置发件方来提升送达率，具体做法见设置邮件发送。

接下来可以做什么

• 运营者配置真正的邮件投递，参见设置邮件发送。
• 查看你个人的邮件历史，参见你的个人活动日志和已发送邮件。
• 了解每种邮件是什么、什么时候会触发，参见KolleK 发送的邮件。