SuperAPI AI 工具集

build-cloudflare-email-sending

部署与运维

查看项目

更新于 10-16 06:16

技能介绍

用途:该技能面向使用 Cloudflare Email Service(2026-04 起开放测试)发送事务邮件,包括域名开通、选择发送路径,以及从 Resend、SES、Postmark、SendGrid 迁移;也可修复 Supabase Auth 内置邮件限流或重新品牌化注册/重置/魔法链接邮件;适用于在 Workers 上接线 send_email 绑定、为 Cloudflare 之外的后端(Railway、Fly、Vercel、VPS)搭建 Worker 中继,或排查 cf-bounce DNS、DKIM/SPF 冲突与配额错误。注意它是发送产品,不涉及 Email Routing/接收,也不是已退役的 MailChannels 路径。

主要能力与关键事实:发送域名的 DNS 区域必须托管在 Cloudflare,否则无法自动创建退信 MX、SPF、DKIM、DMARC。API 令牌创建受控制台限制,而 Worker 绑定无需令牌。配额默认约 1,000 封/天,Workers Paid(5 美元/月)含 3,000 封/月,超出 0.35 美元/1k;预估超 1,000 封/天应尽早提交提额表单。

使用方式:先用 wrangler --version(需 >= 4.110)与 wrangler whoami 检查环境,多账号需设置 CLOUDFLARE_ACCOUNT_ID。开通域名:wrangler email sending enable <domain>,再 dns get 检查生成的记录并验证传播。发送路径按架构选择:Workers 内用 send_email 绑定;外部后端用 Worker 中继模板;仅支持 SMTP 的旧应用连 smtp.mx.cloudflare.net:465,用户为 api_token;一次性验证用 wrangler email sending send。注意绑定地址对象形状为 {email, name},REST 为 {address, name}。迁移时不要硬切换,用配置回退保留旧提供商 2–4 周,并逐条验证:Worker 鉴权、真实发送返回 message_id、邮件真实到达、旧提供商日志无新增、配额余量。

限制与卫生:AUTH_TOKEN 只存 wrangler secret 与后端密钥库,绝不进 git、wrangler.jsonc、文档或聊天;轮换需成对操作;SMTP 令牌仅限 Email Sending: Edit。硬退信会自动抑制收件人,解除需提交支持工单,因此测试务必使用可控真实邮箱。其余映射、DNS 细节与代码差异见随附参考文档。