文档运行一个联邦节点
运行一个联邦节点
运营一个主权节点。
一个联邦节点参与跨设备免疫的流言传播,却从不看到原始用户数据。这是可选的 — 但节点越多,网络就越去中心化。
01
节点做什么
一个节点接收来自其区域内设备的哈希模式广播,与对等节点运行法定人数协议,并将已确认的模式重新广播给与之相连的设备。它从不接收或存储任何可识别用户身份的内容。
构造上保障隐私
协议层只承载 SHA-256 哈希和宽泛的区域分桶。不存在让节点接收 IP、邮箱或 GPS 坐标的代码路径。这由一个自动化测试强制执行,一旦边界被突破,它就会让构建失败。
02
硬件要求
一个节点是一个 Rust 守护进程加一个 PostgreSQL 16 实例。最低配置:
- 4 vCPU、16 GB 内存、200 GB SSD
- 可靠的连接、可公开访问的端口(默认 8443)
- 用于对等身份密钥的 YubiHSM 2 或等价物(推荐)
- 时间同步(NTP)— 法定人数协议对时钟偏差敏感
03
安装
shell# 1. PostgreSQL 16 (skipped if you already have one)
sudo apt-get install -y postgresql-16
# 2. The federation daemon
curl -L -o lydos-fed-2026.06.r1.tar.gz \
https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/lydos-fed.tar.gz
curl -L -o release.manifest.json \
https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/release.manifest.json
# 3. Verify the bundle (the same protocol as the phone image)
./verify-bundle.sh --bundle lydos-fed-2026.06.r1.tar.gz --manifest release.manifest.json
# expects: signatures 3 / 3, hash match
# 4. Install
sudo tar -xzf lydos-fed-2026.06.r1.tar.gz -C /opt/lydos-fed
sudo /opt/lydos-fed/install.sh04
对等身份密钥仪式
节点的对等身份密钥为它发出的每条广播签名。在一场 M-of-N 官员仪式下,于 YubiHSM 内部生成它。三名官员,三分之二可签署新密钥。在你的内部日志中记录该仪式。
shell/opt/lydos-fed/bin/lydos-fed key generate --hsm yubihsm \
--slot 1 --label fed-peer-2026.06 \
--officers 2-of-3热密钥警告
不要在工作站上生成此密钥。私有的那一半绝不能出现在任何你无法掌控的进程内存中。HSM 强制执行这一点。
05
加入对等注册表
shell# Submit your node's public identity to the registry
/opt/lydos-fed/bin/lydos-fed join \
--registry https://registry.lydos.ailydian.com \
--pubkey-path /opt/lydos-fed/keys/fed-peer-2026.06.pub注册表为你的条目签名并重新广播。其他节点会主动联系并完成握手。典型的接入耗时 10–30 分钟。
06
监控
守护进程在 /metrics 上暴露 Prometheus 指标,在 /health 上暴露 JSON 健康快照。将其接入你现有的仪表板,或直接查询它。
shellcurl https://your-node.example/health
# {
# "version": "2026.06.r1",
# "peers_online": "11/11",
# "quorum": "ok",
# "audit_chain_head": "3571a6c8…",
# "uptime_seconds": 123456
# }07
备份与恢复
PostgreSQL 卷是你唯一需要备份的有状态组件。密钥存放于 HSM 中,仅可通过仪式重建。守护进程配置可从 /etc/lydos-fed 复现。
恢复很快
一个全新节点加入联邦,向对等节点询问当前链头,然后追平。我们在生产环境中观察到的最长追平时间是从冷启动到进入法定人数 18 分钟。