Files
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

1.0 KiB

Node(已移除,docs/11 §4)

v2 起 WmailHub 邮件架构中不存在 Node。旧方案 Cloudflare -> Email Worker -> Node -> Console 废弃,新方案为 Cloudflare -> Email Worker -> Console。

为什么删除 Node

Node 原来的职责只有「接收邮件 -> 转发邮件」,却额外引入:

  • 一次网络跳转
  • 一套部署
  • 一套认证
  • 一个故障点
  • 一套重试
  • 一套日志
  • 一套版本管理

Email Worker 已经能够接收邮件、读取 envelope sender/recipient、执行业务前置判断(authorize)、 调用 HTTPS API(ingest)、执行 message.setReject() 并把原始邮件交给 Console,因此 Node 没有独立价值。

现状

  • Console 的 /api/internal/nodes/* 内部协议与 /internal/enroll 端点已删除。
  • 数据模型不再有 nodes/node_credentials;账号实体为 cloudflare_accounts, Email Worker 与 Console 的认证凭据为 worker_credentials(docs/05)。
  • 账号概念保留:「账号」= 已连接的 Cloudflare Account(Connect Cloudflare Account 流程,docs/02)。