# 光湖共享节点池 · 架构文档

> 铸渊 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