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 更新
This commit is contained in:
+41
-21
@@ -1,31 +1,57 @@
|
||||
# WmailHub 系统架构
|
||||
# WmailHub 系统架构(v2,docs/11)
|
||||
|
||||
最终架构是两层邮件接收:
|
||||
|
||||
```text
|
||||
Internet
|
||||
|
|
||||
v
|
||||
Cloudflare Email Routing
|
||||
|
|
||||
v
|
||||
Email Worker
|
||||
|
|
||||
| HTTPS + HMAC(authorize / ingest)
|
||||
v
|
||||
WmailHub Console
|
||||
|
|
||||
+-- D1
|
||||
+-- R2
|
||||
+-- Webhook
|
||||
+-- API
|
||||
+-- MCP
|
||||
```
|
||||
|
||||
Node 已从邮件架构中移除(v1 的 `Email Worker -> Node -> Console` 链路废弃)。
|
||||
|
||||
## Console
|
||||
|
||||
Console = Frontend + Management Node,是系统控制中心。
|
||||
Console = Frontend + Management API,是系统唯一业务控制中心。
|
||||
|
||||
负责 Cloudflare OAuth、Node、Domain、Mailbox、Email、Webhook、API、MCP 以及数据存储。
|
||||
负责 Cloudflare OAuth、Cloudflare Account、Domain、Mailbox、邮箱启用/禁用、Email Storage(D1 + R2)、Webhook、REST API、MCP、TTL Cleanup、Email Routing 配置、Email Worker 部署与 Worker Credential。
|
||||
|
||||
## Node
|
||||
Console 是"是否允许接收邮件"的唯一事实来源。
|
||||
|
||||
Node 是纯后端、无前端的邮件转发节点。
|
||||
## Email Worker
|
||||
|
||||
唯一核心流程:Cloudflare Email Worker -> Node -> Console。
|
||||
Email Worker 是邮件入口 + SMTP reject 执行者,只负责:
|
||||
|
||||
Node 不负责 Domain、Mailbox、Webhook、MCP、API、用户权限或业务路由。
|
||||
1. 接收 Cloudflare Email Routing 邮件,读取 `message.from` / `message.to`;
|
||||
2. 调用 Console `POST /internal/email/authorize` 询问是否接收;
|
||||
3. 明确拒绝时执行 `message.setReject()`;
|
||||
4. 明确允许时把 raw MIME 提交到 Console `POST /internal/email/ingest`;
|
||||
5. 处理内部异常(超时/5xx 一律按临时错误,不伪装成邮箱不存在)。
|
||||
|
||||
## Cloudflare Worker
|
||||
|
||||
Email Worker 是邮件入口,只负责接收 Cloudflare Email Event 并安全转发给 Node。
|
||||
Worker 不创建邮箱、不做域名管理、不存业务数据、不实现 Webhook/API/MCP。
|
||||
|
||||
## 控制平面
|
||||
|
||||
```text
|
||||
Cloudflare Account
|
||||
+-- Node
|
||||
+-- Domain
|
||||
+-- Mailbox
|
||||
+-- Email Worker
|
||||
+-- Email Worker(账号级一个)
|
||||
+-- WorkerCredential
|
||||
```
|
||||
|
||||
这些资源关系由 Console 管理。
|
||||
@@ -33,15 +59,9 @@ Cloudflare Account
|
||||
## 数据平面
|
||||
|
||||
```text
|
||||
Email Worker -> Node -> Console
|
||||
Email Worker -> Console(authorize + ingest)-> D1 / R2 / Webhook
|
||||
```
|
||||
|
||||
Node 不参与业务决策。
|
||||
## 归属范围
|
||||
|
||||
## Node Scope
|
||||
|
||||
第一版一个 Node 绑定一个 Cloudflare Account。Node A 不允许处理 Account B 的资源。
|
||||
|
||||
## 扩展
|
||||
|
||||
未来可以有多个 Node,例如 Node JP、Node US、Node EU。每个 Node 默认仍绑定一个 Cloudflare Account。
|
||||
一个账号绑定一个 Cloudflare Account 与一个 Email Worker;Worker credential 不允许处理其它账号的域名。
|
||||
|
||||
Reference in New Issue
Block a user