octop-usage用量看板(部署于vm103)

MiniMax Token 计划的用量/额度统计小服务:给家族提供 usage.bianquezhiyin.cn 看板,顺手承担机器的网络监控(netwatch)。

访问方式

• 对外:https://usage.bianquezhiyin.cn(hk-yunmai 反代)
• 内网:http://100.64.0.20:8099
• 服务管理:systemctl status octop-usage

技术架构

• /opt/octop-usage/app.py(Python,systemd 常驻,15M 内存,极轻量)
• /opt/octop-usage/mx_key.txt:MiniMax API key(明文)
• 数据来源:直读 MiniMax 计费 API(无本地库,从服务名"Octop Usage Dashboard (MiniMax Token Plan)"推断)
• 姊妹服务:/opt/netwatch/netwatch.sh(网络连通性监控,systemd 列表里有 octop-usage 与 netwatch 相关单元)

数据(存储/备份情况)

• 无持久化数据(用量从上游 API 拉取),无备份需求;唯一资产是 mx_key.txt
• 日志:journalctl -u octop-usage

使用方法

• 打开看板即可查各 key 的额度消耗
• 改 key:编辑 /opt/octop-usage/mx_key.txt 后 sudo systemctl restart octop-usage

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

• sudo systemctl restart octop-usage
• 日志:journalctl -u octop-usage -n 100
• 开机自启:enabled(已确认)

现状与风险

• 低:key 明文放在盘上(内网机,可接受但建议收权)
• 低:与 8099 同机的 3000(NewAPI)、8088(OCtop)若同被限流,看板会一起超时
• 无重大风险:无库无常驻状态,坏了 restart 即恢复

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

1. key 收权:sudo chmod 600 /opt/octop-usage/mx_key.txt && sudo chown root:root /opt/octop-usage/mx_key.txt(按服务运行身份调整属主)
2. 确认 app.py 是否写日志到本地:grep -n log /opt/octop-usage/app.py | head,有则加轮转
3. 看板可达性监控:netwatch.sh 追加 curl -fsS -m 5 http://127.0.0.1:8099 >/dev/null || echo 'usage down' >> /var/log/netwatch.log
4. 若 key 轮换:改完重启并验证 curl -fsS http://127.0.0.1:8099 | head -5