Skip to content

多服务器架构 ​

📐 实现状态:设计稿 · 未实现(2026-09-20 更新) ​

本页所述的「多服务器角色裁剪」方案在代码中仍零实现。

  • 文中提及的 SERVER_ROLE、MODULE_* 等环境变量在全仓没有任何引用,.env.example 里也没有;
  • 当前加载器(src/framework/lifecycle/loader/registry/)是全量加载,不存在按角色裁剪模块的能力。

2026-09-20 更新两处已过时的事实:

  1. 配套的 Docker 制品已落地(Dockerfile / docker-compose.yml / docker/entrypoint.mjs, 外加 compose 全栈冒烟流水线)→ 见 Docker 部署。
  2. 本页原先列出的横向扩展阻断项已全部修复并有关卡守护:调度器分布式锁(E1)、 守卫配置跨实例同步(E2)、遥测与 WS 广播外置(E3)。可复跑 npm run verify:all 验证。 也就是说「多个实例同时跑同一业务」已经安全,未完成的只是「按角色裁剪模块」。

请勿据此规划部署。 本页保留作设计参考,不代表现状。

架构概览 ​

┌──────────────┐          ┌──────────────┐
│  主服务器     │          │  子服务器 A   │
│  (Auth)      │          │  (业务A)      │
│              │          │              │
│  OAuth2.1    │◄────────►│  业务 API    │
│  User/IAM    │  验证Token│  应用数据    │
│  Session     │          │  本地权限     │
└──────┬───────┘          └──────────────┘
       │
       ▼
┌──────────────┐
│  共享数据库    │
│  MySQL/Redis │
└──────────────┘

配置开关 ​

通过 .env 控制模块加载:

主服务器:

ini
SERVER_ROLE=auth
MODULE_OAUTH21=true
MODULE_USER=true
MODULE_IAM=true
MODULE_NOTICE=true
MODULE_SESSION=true

子服务器:

ini
SERVER_ROLE=app
MODULE_OAUTH21=false
MODULE_USER=false
MODULE_IAM=false
MODULE_SESSION=true

AUTH_SERVER_URL=https://auth.example.com
AUTH_SERVER_PUBLIC_KEY=-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----

Token 验证 ​

主服务器签发 JWT(RS256),子服务器用公钥验证:

主服务器:  私钥签名 → Access Token (JWT)
子服务器:  公钥验证 → 解析出 sub, role, scope 等 claims

优势:

  • 子服务器验证 Token 是本地操作,零网络开销
  • 公钥可以安全分发
  • 即使主服务器临时不可用,已签发的 Token 仍可被验证

子服务器分类 ​

类型用户授权用户数据状态同步典型场景
用户型需要有需要用户后台、SaaS
服务型不需要无不需要定时任务、数据同步
混合型部分需要部分部分需要电商

用户状态同步 ​

核心原则:只通知该用户授权过的应用。

Auth 服务:
  用户被封禁
    → 查询 oauth_user_approval: 该用户授权了 App A、App B
    → POST https://app-a.example.com/internal/webhook/user-state
    → POST https://app-b.example.com/internal/webhook/user-state
    → App C 不通知
变更类型紧急程度同步方案
用户封禁/注销立即Token 黑名单 + Webhook
角色/权限变更尽快Webhook 通知
资料更新最终一致短 Token 自动刷新

方案对比 ​

维度方案 A:配置开关方案 B:独立数据库方案 C:微服务
改动量小中大
部署复杂度低中高
数据隔离无有有
独立扩缩容不支持不支持支持
适用阶段初期/中期中期大规模

基于 GPL-3.0 许可发布