fifth-domain/server-tools/light-lake-node-bootstrap

光湖灯塔节点初始化模板

所有接入光湖灯塔体系的服务器使用同一套可重复、可审计、可回滚的基础环境。京东云北京 JD-FD-PRIMARY / JD-OPS-CENTER 是第一台真实样板节点。

固定基线

• Ubuntu Server 22.04 LTS、x86_64；
• Node.js 20、Python 3、Git、jq、Docker、Nginx（默认停止，配置完成前不开放 80/443）；
• /opt/guanghu 放只读部署代码，/etc/guanghu 放节点配置和受保护 secrets；
• /var/lib/guanghu 放运行状态与回执，/var/backups/guanghu 放部署前快照；
• Gatekeeper v3.2 仅监听 127.0.0.1:3911，不直接暴露公网；
• 每个节点拥有独立 node_id、独立 SSH key_id、独立地图与回执链。

安装

在一台全新的 Ubuntu 22.04 节点上，以 root 执行：

NODE_ID=JD-FD-PRIMARY \
NODE_NAME='京东云北京 · 第五域国内主节点' \
NODE_ROLES='fd-primary,ops-center,lighthouse-node' \
bash server-tools/light-lake-node-bootstrap/install.sh

脚本可重复执行。重复部署会先把节点配置和 systemd 单元备份到 /var/backups/guanghu/bootstrap/。

验收与回滚

guanghu-node-health
guanghu-node-rollback

健康检查必须同时证明节点身份、Gatekeeper systemd 状态、私网健康端点、仓库提交和磁盘状态。 回滚不删除 secrets，不清空运行数据，也不修改 SSH 公钥。