server-workbench 服务器全景工作台 v1/v2(部署于 maizihehuo)

自研运维中枢:纳管 14 台服务器的全景状态、Agent 指标采集、SSH 密钥分发、告警与自动供给,是整个集群的"驾驶舱"。

访问方式

• v1:https://workbench.bianquezhiyin.cn/(→ 127.0.0.1:8765)
• v2:https://workbench2.bianquezhiyin.cn/(→ 127.0.0.1:8767,新功能工作台)
• 配套组件:node-registry(100.64.0.21:8905,内网机 IP 上报中转)、wb-agent(本机监控代理)、wb-provision(8090,供给服务)
• SSH 后:systemctl status server-workbench-v2

技术架构

• v1:/opt/server-workbench,Python FastAPI/uvicorn(8765),SQLite,配置 config/servers.json(14 台:麦子合伙主控、2025卡酷、一脉、腾讯云扁鹊、火山云、腾讯云硅谷、飞牛零氪、扁鹊生活、云麦香港、pve-fnos、immortalwrt 旁路由、workbuddy-host、vm103、pve-home)
• v2:/opt/server-workbench-v2,同栈 + 独立 DB_PATH data/workbench.db,含 bump_static.sh 静态发布脚本
• 采集:各被管机部署 server-agent(如 kaku2025 的 9101)+ wb-agent;kaku2025 经反向隧道 wb-hk-tunnel(vpn:19225→kaku:9101)上报
• 供给:wb-provision provision_server.py(8090)+ provision_server.py CLI + maizi_helper.py,新机初始化
• 目录体积大(5.8G+3.9G),内含 backups/ 历史备份

数据

• SQLite:/opt/server-workbench-v2/data/workbench.db(v2);v1 同构
• 配置:config/servers.json(含各机地址;SSH 私钥在 ssh_keys/ 目录 —— 位置敏感,不列内容)
• 备份:两目录各有 backup.sh + backups/;kaku2025 侧亦有 3:00 备份 cron
• 告警快照:backup_alerts_20261007021112

使用方法

• 工作台 Web:服务器列表、状态面板、Agent 图表(数据源含 n9e/Prometheus)
• 增加被管机:写 servers.json → 放置密钥 → 目标机装 server-agent/wb-agent
• 供给新机:用 wb-provision 的 provision 流程

维护方式

• 启停:systemctl restart server-workbench / server-workbench-v2 / wb-agent
• 日志:journalctl -u server-workbench-v2 -f
• 配置:/opt/server-workbench*/config/servers.json;环境变量在 systemd unit(CONFIG_PATH、SSH_KEYS_DIR、DB_PATH)
• 静态更新:v2 目录 bash bump_static.sh

现状与风险

• v1/v2/agent 全部 active
• ssh_keys 目录集中保存全集群私钥,是最高敏感资产
• v1 与 v2 并行,部分功能重复;目录含大量历史备份占 10G
• kaku2025 侧还有一套工作台副本(8765),配置可能漂移

优化建议

1. 【安全】chmod 700 /opt/server-workbench*/ssh_keys;评估迁移到加密存储/1Password;审计 servers.json 与实际机器的一致性
2. 【可维护性】确认 v2 为准后,将 v1 数据(告警/DB)迁移合并并归档 v1(tar czf /opt/backups/workbench-v1.tgz /opt/server-workbench --exclude=ssh_keys)
3. 【备份】backups/ 内文件清理到最近 14 天:find /opt/server-workbench*/backups -mtime +14 -delete(先核对)
4. 【安全】wb-provision(8090)与 node-registry(8905)确认仅内网可达;8090 目前仅本机,保持
5. 【可维护性】把 14 台机器清单与各机 agent 部署方式写入 workbench 自身 README,避免知识只在人脑