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

抑制列表

Suppression lists prevent Email Service from sending to recipients who should not receive mail. Cloudflare adds entries after eligible bounces and spam complaints. You can also add entries manually.

最后更新 查看 MarkdownAgent 设置

Email Sending 抑制列表包含 Email Service 不会联系的收件人。抑制可保护你的发件人声誉,并帮助避免发送不需要的邮件。

Cloudflare 会在符合条件的投递失败和垃圾邮件投诉后创建抑制项。你也可以为不应接收邮件的收件人手动添加条目。

要添加或移除条目,请参阅管理抑制。抑制仅适用于 Email Sending。

抑制范围

每条抑制都有范围。该范围控制抑制应用于哪些发送域名:

范围 应用于
account 账户中的每个发送域名及其子域名
sending_domain 单个发送域名,例如 mail.myappexample.com

邮件的发送域名是其发件人地址的域名。对于 REST API 和 Workers 绑定,这是 from 地址;对于 SMTP,这是信封 MAIL FROM 地址。

sending_domain 抑制仅匹配其精确域名。针对 myappexample.com 的抑制不会阻止来自 mail.myappexample.com 的邮件,针对 mail.myappexample.com 的抑制也不会阻止来自 myappexample.com 的邮件。

如果地址具有 account 抑制,或对该邮件发送域名具有 sending_domain 抑制,Email Service 就会抑制该收件人。

退信和投诉抑制使用 sending_domain 范围,值为发生退信或收到投诉的那封邮件的发送域名。当 Cloudflare 无法识别原始邮件的发送域名时,投诉会创建 account 抑制。

抑制规则

下表说明自动与手动创建规则及其过期时间:

原因 创建时机 过期时间
手动(manual) 你通过仪表板或 API 添加该收件人 你选择的时间,或不设过期
垃圾邮件投诉(complaint) Cloudflare 收到并验证来自收件人邮件提供商的投诉 不过期
硬退信(hard_bounce) 发生其他符合条件的收件人端永久拒收 7 天
硬退信(hard_bounce) 收件人邮箱或域名不存在,或收件人端问题在多次投递尝试后仍持续 不过期
软退信(soft_bounce) 发生符合条件的收件人端临时失败,例如邮箱已满或速率限制 默认 24 小时

账户 Email Sending 抑制管理 REST API 可能返回 reason 为 policy 的 Cloudflare 管理条目。客户端必须使用 read_only 判断是否可修改,而不能从 reason 推断。

当 read_only 为 true 时,你无法更新或删除该条目。要调查此类条目,请联系 Cloudflare 支持。

手动抑制

手动抑制让你添加 Email Service 无法观察到的应用层决策。例如,如果用户在你的应用中手动退订邮件,你可以将该电子邮件添加到 Email Service 抑制列表。

创建条目时你可以选择过期时间。没有过期时间的条目会一直保持有效,直到你删除它。

你还要选择范围。手动抑制默认使用 account 范围。Email Service 不会检查你的账户是否从某个 sending_domain 值发送。针对你并未用来发送的域名的抑制永远不会拦截邮件。

垃圾邮件投诉

当收件人将邮件标记为垃圾邮件时,邮件提供商会发送反馈报告。Cloudflare 会在创建投诉抑制之前验证这些报告。

投诉抑制创建时不设过期时间。当 read_only 为 false 时,你可以更改或删除该条目。

我们建议仅在收件人通过你的应用再次选择加入后再更改或删除投诉抑制。

硬退信

硬退信是对一次投递尝试的永久拒收。部分地址在所有者修复邮箱或域名后可能再次有效。

当邮箱或域名不存在时,Email Service 会创建不过期的抑制。当收件人端问题在多次投递尝试后仍持续且没有成功投递时,同样会创建不过期的抑制。

其他符合条件的硬退信抑制持续七天。

软退信

软退信是临时的收件人端失败。例如邮箱已满、服务器暂时不可用,或收件人端速率限制。

符合条件的软退信抑制默认持续 24 小时。抑制过期后,Email Service 会恢复发送。

并非每次临时投递失败都会创建抑制。例如,Email Service 不会因发件人端身份验证或信誉问题而抑制收件人。

按发送方式执行

每个发送域名都有 丢弃已抑制收件人 设置。该设置默认关闭。

发送方式 设置关闭 设置开启
REST API 任一收件人被抑制时返回 400 并拒绝请求。 移除已抑制收件人并处理其余收件人。
Workers 绑定 任一收件人被抑制时抛出 E_RECIPIENT_SUPPRESSED 并拒绝 send() 调用。 移除已抑制收件人并处理其余收件人。
SMTP 任一收件人被抑制时拒绝该邮件。 移除已抑制收件人并处理其余收件人。若没有剩余收件人,SMTP 可能返回不含 Message-ID 的 250 2.0.0 Ok,并且不会投递任何内容。

已抑制收件人不计入你的月度配额或每日发送限制。它们会在邮件发送日志中显示为 Rejected(已拒绝)。

最佳实践

  • 为退订添加手动抑制。
  • 当收件人不得从你的任何域名接收邮件时,使用 account 范围。当该决策仅适用于一个子域名时,使用 sending_domain 范围。
  • 要求收件人通过你的应用再次选择加入。
  • 删除抑制前先验证地址。
  • 调查反复退信中的模式。
  • 让临时抑制自动过期。

相关资源

这篇文档对您有帮助吗?