node-registry 节点注册中心(部署于 bianque-life 扁鹊生活)

内网机上报组网信息的注册表服务(备份中转站):POST /api/nodes/report 上报,GET /api/nodes 查询。

访问方式

• 地址:http://100.64.0.4:8905(仅绑 Tailscale IP,内网可达)
• 端点:GET /health、GET /api/nodes、POST /api/nodes/report

技术架构

• 栈:FastAPI + uvicorn(python3 -m uvicorn node-registry:app --host 100.64.0.4 --port 8905 --workers 1)
• 入口:/opt/node-registry/node-registry.py
• 进程管理:用户级 systemd(node-registry.service)
• 端口:100.64.0.4:8905(内网)
• 依赖:仅标准库+fastapi;数据文件 nodes.json(原子写:tmp+rename)

数据

• 数据库:nodes.json(节点注册表:组网IP+局域网IP+端口+用户)
• 备份情况:无备份(nodes.json 很小,可随 /opt 备份)

使用方法

• 内网机定时 curl POST 上报;控制台/脚本 GET /api/nodes 拉最新表

维护方式

• 启停:systemctl --user restart node-registry(root 用户)
• 日志:journald(--user)
• 配置:无;数据 /opt/node-registry/nodes.json

现状与风险

• 运行 1 天+;仅内网监听,安全面小
• 属"备注册中心"角色(主注册中心待确认,疑在 fnos99/kaku2025)

优化建议

• 备份:cp nodes.json 纳入 /opt 每日 tar
• 可维护性:上报端加轻量 token 防误写
• 性能:单 worker 足够