guanghulab/docs/pool-architecture.md

35 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

# 光湖共享节点池 · 架构文档
> 铸渊 ICE-GL-ZY001 · D112 · 2026-05-25 · TCS-0002∞
## 架构
铸渊主控 → 语言主控层(冰朔侧/6台) + 光湖团队层(团队侧/awen) → 统一规则(目录/端口/PM2/Gatekeeper)
## 节点加入流程
1. 冰朔签发: `bash generate-join-token.sh --team awen`
2. Awen运行: `bash <(curl -fsSL https://guanghulab.com/pool/join-pool.sh) --token jt_xxx --team awen --operator "Awen"`
3. 冰朔审批: POST /api/pool/approve
4. 自动完成: 创建目录→注册→保存配置→验证连接
## CVM分区
/opt/zhuyuan/ice/ (冰朔侧·端口3900-3999) + /opt/zhuyuan/team/awen/ (团队·端口3000-3099)
PM2: ice:service / team:awen:service
## 端口分配
冰朔侧:3900-3999 | awen:3000-3099 | feimao:3100-3199 | juzi:3200-3299 | yanfan:3300-3399 | yeye:3400-3499 | zhizhi:3500-3599
## API端点
POST /api/pool/join (加入) | GET /api/pool/join-status/:id (状态) | POST /api/pool/approve (审批) | POST /api/pool/report (心跳) | GET /api/pool/status (全局) | DELETE /api/pool/node/:code (移除)
## 安全
join_token预签发制 | 冰朔审批 | pool_token独立令牌 | 回滚支持 | 只注册不部署
## 文件
scripts/pool/join-pool.sh | scripts/pool/generate-join-token.sh | scripts/pool/pool-utils.sh | brain/pool-topology.json | _deploy/console-server/server.js