Email Routing 说明文档

# Cloudflare 电子邮件路由技能参考 ## 概述 Cloudflare 电子邮件路由允许为您的域名创建自定义电子邮件地址，并将其路由到已验证的目标地址。它是免费的、注重隐私的（无存储/访问），并包含用于程序化电子邮件处理的 Email Workers。 **适用于所有使用 Cloudflare 作为权威域名服务器的 Cloudflare 客户。** ## 快速入门 typescript // 基础邮件处理器 export default { async email(message, env, ctx) { // 关键：必须在响应前消耗流 const parser = new PostalMime.default(); const email = await parser.parse(await message.raw.arrayBuffer()); // 处理邮件 console.log(`发件人: ${message.from}, 主题: ${email.subject}`); // 转发或拒绝 await message.forward("[email protected]"); } } satisfies ExportedHandler; ## 阅读顺序 **根据您的目标从这里开始：** 1. **刚接触电子邮件路由？** → [configuration.md](configuration.md) → [patterns.md](patterns.md) 2. **添加 Workers？** → [api.md](api.md) § Worker 运行时 API → [patterns.md](patterns.md) 3. **发送邮件？** → [api.md](api.md) § SendEmail 绑定 4. **通过 API 管理？** → [api.md](api.md) § REST API 操作 5. **调试问题？** → [gotchas.md](gotchas.md) ## 决策树 需要接收邮件？ ├─ 仅简单转发？ → 仪表板规则 (configuration.md) ├─ 复杂逻辑/过滤？ → Email Workers (api.md + patterns.md) └─ 解析附件/正文？ → postal-mime 库 (patterns.md § 解析邮件) 需要发送邮件？ ├─ 从 Worker 发送？ → SendEmail 绑定 (api.md § SendEmail) └─ 从外部应用发送？ → 使用外部 SMTP/API 服务 遇到问题？ ├─ 邮件未送达？ → gotchas.md § 邮件认证 ├─ Worker 崩溃？ → gotchas.md § 流消耗 └─ 转发失败？ → gotchas.md § 目标验证 ## 关键概念 **路由规则**: 通过仪表板/API 配置的基于模式的转发。简单但功能有限。 **Email Workers**: 具有完整邮件访问权限的自定义 TypeScript 处理器。处理复杂逻辑、解析、存储、拒绝。 **SendEmail 绑定**: 用于 Workers 的出站邮件 API。仅限事务性邮件（非营销/群发）。 **ForwardableEmailMessage**: 传入邮件的运行时接口。提供标头、原始流、转发/拒绝方法。 ## 本参考内容 - **[configuration.md](configuration.md)** - 设置、部署、wrangler 配置 - **[api.md](api.md)** - REST API + Worker 运行时 API + 类型