Email Workers 说明文档

# Cloudflare Email Workers 使用 Cloudflare Workers 运行时以编程方式处理入站电子邮件。 ## 概述 Email Workers 可以在边缘实现自定义的电子邮件处理逻辑。使用与 HTTP 请求相同的 Workers 运行时，构建垃圾邮件过滤器、自动回复器、工单系统、通知处理器等。 **核心能力**： - 处理入站邮件并获取完整消息访问权限 - 转发至已验证的目标地址 - 发送带有正确线程的回复 - 解析 MIME 内容和附件 - 与 KV、R2、D1 及外部 API 集成 ## 快速开始 ### 最小化 ES 模块处理器 typescript export default { async email(message, env, ctx) { // 拒绝垃圾邮件 if (message.from.includes('spam.com')) { message.setReject('Blocked'); return; } // 转发至收件箱 await message.forward('[email protected]'); } }; ### 核心操作 | 操作 | 方法 | 使用场景 | |-----------|--------|----------| | 转发 | `message.forward(to, headers?)` | 路由至已验证的目标地址 | | 拒绝 | `message.setReject(reason)` | 通过 SMTP 错误拦截 | | 回复 | `message.reply(emailMessage)` | 带线程的自动回复 | | 解析 | postal-mime 库 | 提取主题、正文、附件 | ## 阅读顺序 为了全面理解，请按以下顺序阅读文件： 1. **README.md** (本文档) - 概述与快速开始 2. **configuration.md** - 设置、部署、绑定 3. **api.md** - 完整的 API 参考 4. **patterns.md** - 实际实现示例 5. **gotchas.md** - 关键陷阱与调试 ## 本参考文档包含 | 文件 | 描述 | 关键主题 | |------|-------------|------------| | [api.md](./api.md) | 完整 API 参考 | ForwardableEmailMessage, SendEmail 绑定, reply() 方法, postal-mime/mimetext API | | [configuration.md](./configuration.md) | 设置与配置 | wrangler.jsonc, 绑定, 部署, 依赖项 | | [patterns.md](./patterns.md) | 实际示例 | KV 允许列表, 带线程的自动回复, 附件提取, Webhook 通知 | | [gotchas.md](./gotchas.md) | 陷阱与调试 | 流消耗, ctx.waitUntil 错误, 安全性, 限制 | ## 架构 入站邮件 → 电子邮件路由 → Email Worker ↓ 处理 + 决策 ↓ ┌───────────────┼───────────────┐ ↓ ↓