运维Agent与辅助服务(部署于pve-home)

自研服务器运维体系(WB/Server Agent)在宿主机上的落点:whisper 语音服务、磁盘温度监控、UPS 断电保护、frp 穿透与 IP 上报,9101 端口经反向隧道汇报给 HK 网关。

访问方式

• SSH 上机后查看:/opt/wb-agent/、/opt/server-agent/、/opt/whisper/、/opt/disk-temp/、/opt/frp/
• agent 上报端口仅本机 9101,外部经 HK 网关(43.161.234.104 等)反向端口 19216-19220 段访问各机

技术架构

• Python 3.13 自研 agent:/opt/wb-agent/agent.py(keeper.sh 每 5 分钟保活 + @reboot 自启)+ /opt/server-agent/agent.py(多版本 .bak 备份至 20261019)
• whisper.service:/opt/whisper/server.py + venv + models(本地语音转文字)
• disk-temp.service:/opt/disk-temp/server.py(硬盘温度监控,配合 smartmontools)
• frp:/opt/frp/(frpc+frps 同机,frpc.toml 有多份 .bak,近期改过)
• UPS:NUT 三件套(nut-server/nut-monitor/nut-driver@smartups),3493 端口
• IP 上报:/usr/local/bin/report-ip.sh 每 10 分钟 + @reboot

数据(存储/备份情况)

• agent 日志在 /opt/wb-agent/logs/;代码有手工 .bak 习惯(无 git)
• 无独立数据库;agent 状态数据待确认(可能上报集中存在 HK 网关)
• OSX-KVM(OpenCore 引导文件)为遗留,待确认弃用

使用方法

• 看运行状态:systemctl status whisper disk-temp frpc;tail -f /opt/wb-agent/logs/*.log
• 手动保活:bash /opt/wb-agent/keeper.sh

维护方式(启停/日志/配置)

• 启停:systemctl restart whisper / disk-temp / frpc;agent 由 cron keeper.sh 自动拉起
• 配置:/opt/wb-agent/agent.conf、/opt/frp/frpc.toml
• 改 agent 代码前先 cp agent.py agent.py.bak.$(date +%m%d)(沿用现有惯例)

现状与风险

• 中:agent 体系为自研单点,代码分散在各机 /opt 下且无版本管理,出问题靠 .bak 回滚
• 中:8000 端口 python 服务对内网开放(用途待确认),需核对是否敏感
• 低:frps+frpc 同机并存,拓扑易混乱;OSX-KVM 占空间
• 低:postfix(25 仅本机)只为系统邮件

优化建议(3-6条,给可直接执行的命令)

1. 给 agent 代码建 git 仓:cd /opt/wb-agent && git init && git add -A && git commit -m "baseline"
2. 确认 8000 端口用途:ps -fp 2667; ls -l /proc/2667/cwd,无关则加防火墙:pve-firewall 规则限制来源
3. 验证 UPS 断电联动是否配置:grep -r shutdown /etc/nut/
4. 清理 OSX-KVM 遗留(确认后):du -sh /opt/OSX-KVM && mv /opt/OSX-KVM /mnt/pve/backup/archive-osxkvm/
5. whisper 模型占用检查:du -sh /opt/whisper/models/*,长期不用可下线服务:systemctl disable --now whisper