在 Email Routing 中,路由规则将电子邮件模式与目标配对——目标可以是已验证的电子邮件地址或 Worker。您可以将电子邮件路由到:
- 已验证的电子邮件地址
- 带有
email处理程序的 Workers
这使您可以将电子邮件路由到首选收件箱,或在决定如何处理电子邮件之前使用 Workers 应用逻辑。您可以有多条路由规则,将来自特定发件人的电子邮件路由到特定邮箱。
目标地址是 Email Routing 将邮件转发到的已验证电子邮件地址。在创建路由规则之前,您必须添加并验证至少一个目标地址。
目标地址在账户级别共享,可与账户中的任何其他域名一起重复使用。
您也可以通过 REST API 或 Workers 绑定直接发送到已验证的目标地址,在任何方案上均免费——包括仅配置了 Email Routing 的情况。发送到已验证目标地址不计入您的月度配额或每日发送限制。有关详细信息,请参阅定价。
-
登录 Cloudflare 仪表板 ↗并选择您的账户。
-
前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由) > Destination Addresses。
前往 Email Routing ↗ -
在 Destination addresses(目标地址) 下,在内联表单中输入要用作目标的电子邮件地址并提交。
-
Cloudflare 会向该地址发送验证电子邮件。打开该电子邮件并选择 Verify email address(验证电子邮件地址) 以激活它。
在目标地址通过验证之前,指向该地址的任何路由规则都会保持禁用状态。
Destination Addresses 页面列出了账户上的每个地址,包括待验证的地址。从此页面您可以重新发送验证电子邮件或删除目标地址。
-
登录 Cloudflare 仪表板 ↗并选择您的账户和域名。
-
前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由) > Routing Rules(路由规则)。
前往 Email Routing ↗ -
选择 Create routing rule(创建路由规则)。
-
在 Email pattern(电子邮件模式) 中,输入要使用的电子邮件地址的 local part(例如
my-new-email),并选择您的域名。 -
在 Action(操作) 下拉菜单中,选择此路由规则应执行的操作。有关更多信息,请参阅路由规则操作。
-
在 Destination(目标) 中,选择要将电子邮件转发到的已验证地址或 Worker——例如
[email protected]。要添加新的目标地址,请参阅添加目标地址。
创建路由规则时,您必须指定 Action(操作):
- Send to an email(发送到电子邮件):电子邮件将路由到您的目标地址。
- Send to a Worker(发送到 Worker):电子邮件将由您的 Worker 中的逻辑处理。
- Drop(丢弃):删除匹配规则的电子邮件而不进行路由。如果您出于隐私原因希望使某个电子邮件地址看起来有效,这可能很有用。
-
在 Cloudflare 仪表板中,前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由)。
前往 Email Routing ↗ -
选择 Routing Rules(路由规则)。
-
找到要暂停的路由规则,并将状态按钮切换为 Disabled(已禁用)。
您的路由规则现已禁用。它不会将电子邮件转发到目标地址或 Worker。要再次转发电子邮件,请将路由规则状态按钮切换为 Active(活动)。
-
在 Cloudflare 仪表板中,前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由)。
前往 Email Routing ↗ -
选择 Routing Rules(路由规则)。
-
找到要编辑的路由规则,然后选择 Edit(编辑)。
-
对规则进行适当的更改。
- 登录 Cloudflare 仪表板 ↗并选择您的账户和域名。
- 前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由) > Routing Rules(路由规则)。
- 找到要删除的路由规则。
- 选择 Delete(删除) 并确认操作。
启用此功能后,Email Routing 会将发送到您域名的每封电子邮件(包括拼写错误的 local part)转发到单一目标。例如,如果您为 [email protected] 创建了规则,而发件人误输入 [email protected],在启用 Catch-all rule(全部捕获规则) 的情况下,该电子邮件仍会被处理。
要启用全部捕获规则:
-
在 Cloudflare 仪表板中,前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由)。
前往 Email Routing ↗ -
选择 Routing Rules(路由规则)。
-
启用 Catch-all rule(全部捕获规则),使其显示为 Active(活动)。
-
在 Action(操作) 下拉菜单中,选择如何处理这些电子邮件。有关更多信息,请参阅路由规则操作。
-
选择 Save(保存)。
Email Routing 支持子地址(也称为 plus addressing),定义见 RFC 5233 ↗。这使您可以使用 "+" 分隔符,用任意详细信息增强路由规则。
您可以在 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由) > Settings(设置) 启用子地址。
启用后,您可以将子地址与任何路由规则一起使用。例如,如果您向 [email protected] 发送电子邮件,它将由 [email protected] 路由规则匹配。+detail 部分不影响规则匹配,但会保留在 message.to 中,可由 Worker、Agent 应用 ↗ 或通过活动日志进行检查。
如果已存在针对 [email protected] 的路由规则,它优先于 [email protected] 的规则。这可防止破坏现有路由规则,并允许某些子地址被特定规则捕获。
如果你的路由规则将邮件发送到 Worker,可以在 Worker 的 Wrangler 配置文件中定义它们,而不必在仪表板中创建。将入站地址添加到顶层 addresses 字段:
此功能需要 Wrangler 4.113.0 或更高版本。
{
"$schema": "./node_modules/wrangler/config-schema.json",
"name": "my-worker",
"main": "src/index.ts",
"upload_source_maps": true,
// Set this to today's date
"compatibility_date": "2026-11-14",
"addresses": [
"[email protected]",
"*@example.com"
]
}name = "my-worker"
main = "src/index.ts"
upload_source_maps = true
# Set this to today's date
compatibility_date = "2026-11-14"
addresses = ["[email protected]", "*@example.com"]每个条目要么是字面收件人地址(例如 [email protected]),会为该地址创建路由规则;要么是 *@domain 全部捕获(例如 *@example.com),会为该域名配置全部捕获规则。全部捕获条目仅支持 apex 域名。要将发送到 Email Routing 子域名的邮件进行路由,请列出每个字面收件人地址,例如 [email protected]。
每个条目都使用 Send to a Worker(发送到 Worker) 操作,将邮件路由到你正在部署的 Worker。
addresses 字段仅能放在顶层,并应用于该 Worker 的每个环境。Wrangler 会忽略 env 下的 addresses 值。
如果省略 addresses,Wrangler 不会更改 Email Routing 规则。如果将 addresses 设为空数组,Wrangler 会移除此 Worker 管理的所有 Email Routing 规则。
当你运行 wrangler deploy 或 wrangler triggers deploy 时,Wrangler 会按你列出的地址协调 Email Routing 规则。它会为新条目添加规则、更新其管理的规则,并移除不再列出的受管规则。Wrangler 会打印计划的更改,并在应用破坏性更改(例如删除或接管规则)前要求你确认。在非交互环境中,Wrangler 不会应用破坏性更改,并会在部署 Worker 后以错误退出。
要在不部署或不检查远程规则的情况下验证本地配置,请运行 wrangler deploy --dry-run。
- Email handler — 使用
email()处理程序以编程方式处理电子邮件。 - Email Routing REST API — 以编程方式管理路由规则和目标地址。
- 域名配置 — 管理 Email Routing 的 DNS 记录。
- 电子邮件路由示例 — 包括垃圾邮件过滤和电子邮件存储在内的高级模式。