跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

电子邮件路由规则与地址

最后更新 查看 MarkdownAgent 设置

在 Email Routing 中,路由规则将电子邮件模式与目标配对——目标可以是已验证的电子邮件地址或 Worker。您可以将电子邮件路由到:

  • 已验证的电子邮件地址
  • 带有 email 处理程序的 Workers

这使您可以将电子邮件路由到首选收件箱,或在决定如何处理电子邮件之前使用 Workers 应用逻辑。您可以有多条路由规则,将来自特定发件人的电子邮件路由到特定邮箱。

目标地址

目标地址是 Email Routing 将邮件转发到的已验证电子邮件地址。在创建路由规则之前,您必须添加并验证至少一个目标地址。

目标地址在账户级别共享,可与账户中的任何其他域名一起重复使用。

您也可以通过 REST API 或 Workers 绑定直接发送到已验证的目标地址,在任何方案上均免费——包括仅配置了 Email Routing 的情况。发送到已验证目标地址不计入您的月度配额或每日发送限制。有关详细信息,请参阅定价。

添加目标地址

  1. 登录 Cloudflare 仪表板 ↗并选择您的账户。

  2. 前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由) > Destination Addresses。

    前往 Email Routing ↗
  3. 在 Destination addresses(目标地址) 下,在内联表单中输入要用作目标的电子邮件地址并提交。

  4. Cloudflare 会向该地址发送验证电子邮件。打开该电子邮件并选择 Verify email address(验证电子邮件地址) 以激活它。

在目标地址通过验证之前,指向该地址的任何路由规则都会保持禁用状态。

管理目标地址

Destination Addresses 页面列出了账户上的每个地址,包括待验证的地址。从此页面您可以重新发送验证电子邮件或删除目标地址。

路由规则

  1. 登录 Cloudflare 仪表板 ↗并选择您的账户和域名。

  2. 前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由) > Routing Rules(路由规则)。

    前往 Email Routing ↗
  3. 选择 Create routing rule(创建路由规则)。

  4. 在 Email pattern(电子邮件模式) 中,输入要使用的电子邮件地址的 local part(例如 my-new-email),并选择您的域名。

  5. 在 Action(操作) 下拉菜单中,选择此路由规则应执行的操作。有关更多信息,请参阅路由规则操作。

  6. 在 Destination(目标) 中,选择要将电子邮件转发到的已验证地址或 Worker——例如 [email protected]。要添加新的目标地址,请参阅添加目标地址。

路由规则操作

创建路由规则时,您必须指定 Action(操作):

  • Send to an email(发送到电子邮件):电子邮件将路由到您的目标地址。
  • Send to a Worker(发送到 Worker):电子邮件将由您的 Worker 中的逻辑处理。
  • Drop(丢弃):删除匹配规则的电子邮件而不进行路由。如果您出于隐私原因希望使某个电子邮件地址看起来有效,这可能很有用。

禁用路由规则

  1. 在 Cloudflare 仪表板中,前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由)。

    前往 Email Routing ↗
  2. 选择 Routing Rules(路由规则)。

  3. 找到要暂停的路由规则,并将状态按钮切换为 Disabled(已禁用)。

您的路由规则现已禁用。它不会将电子邮件转发到目标地址或 Worker。要再次转发电子邮件,请将路由规则状态按钮切换为 Active(活动)。

编辑路由规则

  1. 在 Cloudflare 仪表板中,前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由)。

    前往 Email Routing ↗
  2. 选择 Routing Rules(路由规则)。

  3. 找到要编辑的路由规则,然后选择 Edit(编辑)。

  4. 对规则进行适当的更改。

删除路由规则

  1. 登录 Cloudflare 仪表板 ↗并选择您的账户和域名。
  2. 前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由) > Routing Rules(路由规则)。
  3. 找到要删除的路由规则。
  4. 选择 Delete(删除) 并确认操作。

全部捕获规则

启用此功能后,Email Routing 会将发送到您域名的每封电子邮件(包括拼写错误的 local part)转发到单一目标。例如,如果您为 [email protected] 创建了规则,而发件人误输入 [email protected],在启用 Catch-all rule(全部捕获规则) 的情况下,该电子邮件仍会被处理。

要启用全部捕获规则:

  1. 在 Cloudflare 仪表板中,前往 Compute(计算) > Email Service(电子邮件服务) > Email Routing(电子邮件路由)。

    前往 Email Routing ↗
  2. 选择 Routing Rules(路由规则)。

  3. 启用 Catch-all rule(全部捕获规则),使其显示为 Active(活动)。

  4. 在 Action(操作) 下拉菜单中,选择如何处理这些电子邮件。有关更多信息,请参阅路由规则操作。

  5. 选择 Save(保存)。

子地址(Subaddressing)

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] 的规则。这可防止破坏现有路由规则,并允许某些子地址被特定规则捕获。

使用 Wrangler 配置规则

如果你的路由规则将邮件发送到 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。

后续步骤

这篇文档对您有帮助吗?