> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/smtp.md).

# SMTP

本页提供 VergeOS 系统中 SMTP 的配置和管理说明。 [订阅](/run-the-platform/zh/xi-tong-guan-li/subscriptions-overview.md) （用于系统警报和通知）依赖于有效的 SMTP 配置。

{% hint style="info" %}
**直接发送或通过 SMTP 中继发送**

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

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

## 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-troubleshooting) 部分。

## 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 记录，但它无权以默认的 <system@cloud.verge.io> 地址发送电子邮件。
* 确认为中继服务器配置了正确的服务器地址和端口。验证您使用的是中继邮件系统所期望的名称/地址。
* 确认 TLS 设置符合中继服务器要求。许多电子邮件服务器需要 TLS 安全连接。

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

### 直接发送：

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/smtp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.