Files

T

bigcode fec96e49cc feat: v2.0.0 邮件接收架构改造 —— 移除 Node,Email Worker 直连 Console(docs/11)

- 两阶段接收:POST /internal/email/authorize(accept/reject/temporary_error)+ POST /internal/email/ingest(raw MIME 直传)
- Worker-Console 协议:Authorization: WmailHub-Worker + timestamp/nonce/body-hash/HMAC,nonce 防重放,凭据撤销即时生效
- 数据模型:nodes/node_credentials -> cloudflare_accounts/worker_credentials(迁移 0003),emails/domains 归属 account_id
- 接入流程 Connect Cloudflare Account:OAuth 自动同步域名 + 部署账号级 Email Worker + 签发 Worker 凭据;rotate 自动重部署
- 动态邮箱:创建/删除/禁用下一封邮件立即生效;拒绝码 DOMAIN_*/MAILBOX_*;超时/5xx 不伪装成邮箱不存在
- 删除 node/ 目录、旧 /api/internal/nodes 协议、ingress/enrollment 概念;dev.ts 简化为 console + email worker 双进程
- 前端:账号页 Email Worker/凭据管理,设置窗口移除默认 Ingress,仪表盘/文案同步;版本 2.0.0
- 测试 62 项全过(新增 authorize 决策矩阵 + Worker 两阶段临时错误语义);本机虚拟 E2E 12 场景全通
- docs 00-10 同步改写;README 更新

2026-09-30 13:10:26 +08:00

2.1 KiB

Raw Blame History

WmailHub 实施计划(v2,docs/11 §20)

Phase 1 Console 重构(数据模型)

Cloudflare Account(cloudflare_accounts)、Domain、Mailbox、WorkerCredential; 迁移 0003 移除 nodes / node_credentials,emails/domains 归属改为 account_id。

Phase 2 Authorization API

POST /internal/email/authorize:recipient/sender -> accept | reject(code+reason) | temporary_error; 拒绝码 DOMAIN_NOT_FOUND / DOMAIN_DISABLED / MAILBOX_NOT_FOUND / MAILBOX_DISABLED / RECEIVING_DISABLED。

Phase 3 Email Worker

email handler + HMAC 签名 + authorize + setReject + ingest(共享逻辑见 shared/src/email-worker-template.ts 与 worker/src)。

Phase 4 Mail Ingest API

POST /internal/email/ingest:message/rfc822 原文直传(不转 JSON 字符串), 复验 recipient(动态邮箱),只允许 accept 后调用。

Phase 5 Cloudflare 自动配置

Connect Cloudflare Account:OAuth -> Account/Zone 发现 -> 域名同步 -> Email Worker 部署(注入 CONSOLE_URL/WORKER_ID/WORKER_SECRET)-> WorkerCredential 签发; 逐域名:Email Routing + catch-all 规则。

Phase 6 邮件存储

D1 元数据 + R2 raw MIME/附件 + MIME 解析(降级入库)+ 大小/数量限额。

Phase 7 Webhook / REST API / MCP / TTL

三级 Webhook(邮箱 -> 域名 -> 全局,冻结投递配置)、Bearer API/MCP Key、MCP 工具、 Cron 清理(过期邮件 + orphan + nonce/state)+ Webhook 重试。

Phase 8 完整测试

存在邮箱 -> 接收成功;
不存在邮箱 -> message.setReject()(MAILBOX_NOT_FOUND);
禁用邮箱 -> setReject(MAILBOX_DISABLED);
禁用域名 -> setReject(DOMAIN_DISABLED);
Console 超时 -> temporary_error,不能变成 mailbox not found;
Console 5xx -> temporary_error;
ingest 失败 -> 不伪造业务拒绝;
Worker credential revoke/rotate -> Worker 无法访问 Console;
新建邮箱后测试立即接收;
删除邮箱后测试立即拒绝;
多域名并发测试;
catch-all 地址测试。

最终验收

运行架构必须是 Internet -> Cloudflare Email Routing -> Email Worker -> Console(D1/R2/Webhook/API/MCP); 不得存在 Email Worker -> Node -> Console。

2.1 KiB Raw Blame History