配置

唯一真相源

manager.config.yaml 是唯一真相源：endpoints（每个 DSH 进程的入口 + spawn 生命 周期）、agents（工作区绑定）、runner（超时/静默/预算）、pricing（峰谷窗口 + 周末规则）、brain.daily_budget_usd（主脑派工熔断）。

[!IMPORTANT] 密钥只进 .env（GW_KEY_* / BRAIN_TOKEN），永不入库。

域名 + TLS

安装时回答域名问题并选 TLS 模式。证书的三种提供方式见 快速开始。生产环境 manager 自动开启安全 Cookie。

节点级 DSH 版本

节点向导可填 dsh_version，按版本矩阵 SUPPORTED_DSH（每行 = DSH 版本 ↔ facade ref 配对）校验：未知版本直接拒绝，未验证配对安装带黄字警告。切版本是 /nodes 页的 页面操作（容器 = 换镜像重建；进程 = 重播种 + 重装 + 重启）。

facade 防火墙白名单（跨公网前必须收紧）

节点 facade 端口（如 3081）暴露在服务器上，必须只放行 manager 的出口 IP。GUI 走用户侧 SSH 隧道（loopback），不受影响。

• Linux（ufw）： sudo ufw allow from <manager出口IP> to any port 3081 proto tcp && sudo ufw enable
• Linux（firewalld）： sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="<manager出口IP>" port port="3081" protocol="tcp" accept' && sudo firewall-cmd --reload
• 云安全组：入方向仅允许 <manager出口IP>/32 → 节点端口，其余拒绝。

验收：从非白名单 IP curl facade → 拒绝；manager 侧探活正常（/nodes 页节点仍 live）。

限流与规模

• 通道限流：join 签发 20/分、agent 注册 10/分、指令长轮询 240/分、事件回报 240/分、吊销/轮换 20/分——全部按每 agent/每用户独立计数。
• 单 manager 舒适区 ≤50 台机器；更大舰队走多 manager 分片（规划中）。