SMTP

如何在 VergeOS 中配置、测试和排查 SMTP 邮件设置，包括中继配置、TLS、队列管理、邮件日志以及投递问题排查。

本页提供 VergeOS 系统中 SMTP 的配置和管理说明。 订阅 （用于系统警报和通知）依赖于有效的 SMTP 配置。

直接发送或通过 SMTP 中继发送

SMTP 可配置为直接从内置的 VergeOS 邮件服务器发送电子邮件，或者通过中继邮件服务器发送。

由于 SMTP 的配置本质上可能较为复杂且容易出错（DNS、反向 DNS 记录、防火墙规则等），一些客户会选择使用商业电子邮件中继服务，以便于使用、安全性和合规性方面的原因。该服务提供商可以为您的 SMTP 配置提供正确的中继设置。

SMTP 配置

1. 从以下位置开始： SMTP 仪表板（系统 > SMTP）.
2. 单击 编辑设置 左侧菜单中的。
3. 配置 设置：

   • 使用 TLS： 启用/禁用 TLS 加密；在使用电子邮件中继主机时，必须设置为与目标系统要求相匹配。只要支持，始终使用 TLS。
   • 主机名： 使用内置 SMTP 服务器时，请务必使用能够清晰标识其用途的有效 FQDN，确保主机名通过 DNS 解析到正确的 IP，并验证该主机名已配置正确的 SPF、DMARC 和反向 DNS 记录。在使用中继时，具体的主机名也可能很重要，具体取决于中继服务器的要求和策略。
   • 发件人名称： 在电子邮件中显示的发件人名称
   • 发件人地址： 在电子邮件中显示的源电子邮件地址
   • 中继主机： 电子邮件中继服务器的地址（直接发送时留空）
   • 中继端口： 中继主机使用的 TCP 端口，例如 25（未加密）、587（TLS）、465（SSL/旧版已弃用）；直接发送时留空
   • 使用 SASL 认证： 通常在使用中继主机时需要有效的身份验证凭据；启用此选项可输入访问中继服务器所需的用户名/密码。
4. 单击 提交 以保存配置。

测试 SMTP 配置

1. 从以下位置开始： SMTP 仪表板（系统 > SMTP）.
2. 单击 发送测试邮件 左侧菜单中的。
3. 输入一个 电子邮件地址 作为发送目标。
4. 单击 发送.
5. 如果未收到测试消息，请参阅 故障排除 部分。

SMTP 队列管理

该 邮件队列 包含等待发送的电子邮件。

删除 SMTP 队列

在与邮件投递相关的情况下，可能需要删除 SMTP 队列，例如 SMTP 长时间中断后积压了大量邮件，或者在排查问题时需要从干净状态开始。以下说明将清除邮件队列中的所有条目，且这些条目不会重新生成。

1. 从以下位置开始： SMTP 仪表板（系统 > SMTP）.
2. 删除前评估队列条目： 最新条目显示在本页的 邮件队列 部分；要查看更大的队列，请点击左侧菜单中的 邮件队列 条目。
3. 单击 删除队列 左侧菜单中的。

刷新（加速）SMTP 队列

刷新 SMTP 队列会强制邮件服务器重新评估并尝试发送队列中的每一条记录，从而加快消息发送。这通常用于先前问题（配置错误、网络中断、服务延迟等）导致大量消息卡住，而这些问题现在可能已解决。刷新队列不会删除消息，而是会加快发送过程。

1. 从以下位置开始： SMTP 仪表板（系统 > SMTP）.
2. 单击 刷新队列 左侧菜单中的。
3. 单击 是 以确认操作。

SMTP 日志

查看已发送消息的日志（邮件日志）

1. 从以下位置开始： SMTP 仪表板（系统 > SMTP）.
2. 查看仪表板中 邮件日志 部分的最新条目。
3. 要查看更多条目（查看更早的记录），请点击 邮件日志 左侧菜单中的。 上一页/下一页 页面底部的按钮可让您在大型日志的分页间滚动。

查看 SMTP 系统事件

1. 从以下位置开始： SMTP 仪表板（系统 > SMTP）.
2. 查看仪表板中 日志 部分位于仪表板底部。
3. 要查看更多条目（查看更早的记录），请点击 日志 左侧菜单中的。 上一页/下一页 页面底部的按钮可让您在大型日志的分页间滚动。

SMTP 报告

SMTP 报告提供 最近 SMTP 活动的摘要，其中包含警告、错误、发送/接收字节数、按收件人和发件人统计的消息数量等信息。使用左侧菜单选项运行 今日报告 或 昨日报告.

SMTP 故障排除

检查垃圾邮件文件夹

确认消息没有被发送到收件人的垃圾邮件/垃圾文件夹。

检查日志

SMTP 日志中的错误消息可在邮件发送失败时提供信息，例如关于 SMTP 设置不正确或 SMTP 已禁用的警告等。检查 SMTP 页面底部的 日志 部分 。

验证适当的防火墙规则和网络策略

默认情况下，外发 SMTP 连接通常会被阻止。请确保端口 25、587 或 465（取决于您的配置）已开放并允许；在某些情况下，这可能需要联系您的服务提供商。

使用中继：

确认中继设置

• 某些电子邮件服务器需要明确的中继权限。确保电子邮件服务器允许您的 VergeOS 系统中继消息，通常可通过启用身份验证或将 IP 地址加入白名单来实现。
• 您可能需要将“发件人地址”字段配置为与您发送电子邮件的域名相同。通常，您的中继主机已为您的域名配置了正确的 SPF/DMARC/反向 DNS 记录，但它无权以默认的 [e-mail] 地址发送电子邮件。
• 确认为中继服务器配置了正确的服务器地址和端口。验证您使用的是中继邮件系统所期望的名称/地址。
• 确认 TLS 设置符合中继服务器要求。许多电子邮件服务器需要 TLS 安全连接。

某些电子邮件服务器会使用 STARTTLS，即连接从标准 SMTP 端口（25 或 587）上的未加密连接开始，并在连接建立后协商加密。

直接发送：

验证 SPF/DMARC/反向 DNS 记录 如果电子邮件被标记为垃圾邮件或发送失败，请确保已正确配置反向 DNS 记录，并且您的域名具有正确的 SPF（发件人策略框架）和 DMARC（基于域的消息认证、报告与一致性）记录。当这些记录与您的系统不匹配时，尝试发送的消息可能会被检测为冒名顶替，从而导致投递失败和/或电子邮件被标记为可疑。反复的冒名顶替行为可能会导致您的域名/IP 被列入黑名单，进而影响未来的邮件投递。