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:
+19
-37
@@ -1,44 +1,26 @@
|
||||
# Node 设计
|
||||
# Node(已移除,docs/11 §4)
|
||||
|
||||
Node 是无前端、纯后端的邮件转发节点。
|
||||
v2 起 WmailHub 邮件架构中**不存在 Node**。旧方案 `Cloudflare -> Email Worker -> Node -> Console`
|
||||
废弃,新方案为 `Cloudflare -> Email Worker -> Console`。
|
||||
|
||||
核心流程:
|
||||
## 为什么删除 Node
|
||||
|
||||
```text
|
||||
Email Worker -> Node -> Console
|
||||
```
|
||||
Node 原来的职责只有「接收邮件 -> 转发邮件」,却额外引入:
|
||||
|
||||
## Node 职责
|
||||
- 一次网络跳转
|
||||
- 一套部署
|
||||
- 一套认证
|
||||
- 一个故障点
|
||||
- 一套重试
|
||||
- 一套日志
|
||||
- 一套版本管理
|
||||
|
||||
- 接收 Email Worker 请求
|
||||
- 验证 Worker 请求
|
||||
- 获取邮件
|
||||
- 安全转发到 Console
|
||||
- 有限重试临时网络错误
|
||||
- 心跳
|
||||
- 上报版本和状态
|
||||
Email Worker 已经能够接收邮件、读取 envelope sender/recipient、执行业务前置判断(authorize)、
|
||||
调用 HTTPS API(ingest)、执行 `message.setReject()` 并把原始邮件交给 Console,因此 Node 没有独立价值。
|
||||
|
||||
## Node 不负责
|
||||
## 现状
|
||||
|
||||
- Domain 路由
|
||||
- Mailbox 路由
|
||||
- Webhook
|
||||
- MCP
|
||||
- API
|
||||
- 用户权限
|
||||
- 邮件业务存储
|
||||
- 邮件规则
|
||||
|
||||
Node 收到什么就转发什么。
|
||||
|
||||
## Node Scope
|
||||
|
||||
Node 只能服务创建它的 Cloudflare Account。不得通过普通业务请求把 Node 任意绑定到其他 Account。
|
||||
|
||||
## 配置
|
||||
|
||||
Node 至少需要 node_id、cloudflare_account_id、console_endpoint、credential。
|
||||
|
||||
credential secret 必须安全保存。
|
||||
|
||||
Node 可以有限重试 Console 网络错误,但不承担长期邮件队列职责。
|
||||
- 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)。
|
||||
|
||||
Reference in New Issue
Block a user