一、目标
- 让 PVE 的 APC UPS 事件(断电/来电/低电/关机等)推送通知到手机(Server酱³)。
- 把通知服务做成内网可复用的独立 Docker 服务。
- 解决 NUT 驱动偶发”读不到 UPS”(Data stale)不自愈的问题,加自动重启守护。
- 守护需防夜间刷屏(静音窗 + 持久故障封顶),保留详细文件路径与使用说明,方便调试/删除。
二、最终架构
APC BK650M2-CH (USB)
│
▼
PVE NUT (netserver, upsd:3493, master)
│ UPS 事件触发 NOTIFYCMD
▼
/usr/local/bin/ups-notify.sh → HTTP POST(中文 title/body)
│
▼
104 LXC notify-gw 容器(docker-compose, python:3-alpine, host网络:8000)
│ 接收 title/body,正文每行转"空行",发 JSON {title,desp}
▼
Server酱³ (6069.push.ft07.com) → 手机(标题 + 分行正文)
另有守护 nut-driver-watchdog:每 30s 检查 driver 是否卡死,卡死自动重启(带静音窗与故障封顶)并通知。
三、PVE 侧做了什么
1. NUT 现状(原本已有,仅确认/复用)
- UPS:APC Back-UPS BK650M2-CH(USB,051d:0002),当前负载约 10%,满电续航约 57 分钟。
- 模式:
MODE=netserver,upsd监听0.0.0.0:3493。 - 账号:
monuser/master、slave/slave等。 - 关机策略:
battery.charge.low=40(电量降到 40% 触发低电→关机)、battery.runtime.low=-1(不看剩余时间,只看电量%)。
2. 新增通知脚本 /usr/local/bin/ups-notify.sh
- 把 NUT 事件映射成中文标题+中文正文,POST 到
http://192.168.100.4:8000/notify。 - 覆盖 10 种事件:ONLINE / ONBATT / LOWBATT / FSD / COMMOK / COMMBAD / SHUTDOWN / REPLBATT / NOCOMM / NOPARENT(另有
*兜底,非标准事件会显示原文)。
3. 修改 upsmon.conf(每步均先备份 upsmon.conf.bak.*)
- 新增
NOTIFYCMD /usr/local/bin/ups-notify.sh - 新增 10 条
NOTIFYFLAG <事件> SYSLOG+WALL+EXEC(EXEC 是让 upsmon 真正调用脚本的关键,默认没有) nut-monitor已 reload,active。
4. 新增守护 /usr/local/sbin/nut-driver-watch.sh + systemd timer
- 文件:
/usr/local/sbin/nut-driver-watch.sh(检查脚本,含完整路径说明)/etc/systemd/system/nut-driver-watchdog.service/etc/systemd/system/nut-driver-watchdog.timer(每 30s,OnBootSec=60)- 状态文件
/run/nut-driver-watch.state(tmpfs,重启即清)
- 逻辑见第五节详述。
- 实测:停掉 driver → 90s 内自动拉起恢复 OL,并发出通知 ✅
四、104 LXC 侧做了什么
1. 部署通知网关(Docker Compose)
- 目录:
/root/notify-gw/(与 lucky/adguard/nutweb 同风格) - 文件:
docker-compose.yml、gateway.py(Python 标准库,零依赖) - 镜像:
docker.1panel.live/library/python:3-alpine(53.7MB;Docker Hub 直连不通,换国内源拉到) - 容器:
notify-gw,network_mode: host,监听0.0.0.0:8000,restart: unless-stopped - 网关逻辑:收
title/body(表单或 JSON)→ 转 Server酱³ 的 JSON{title, desp};正文每行用空行\n\n拼接,保证手机分行显示。
2. 关键踩坑与解决
- 放弃 Apprise 方案:其
form:///json://插件硬编码字段名message,而 Server酱³ 只认desp,导致正文丢失(只显示标题)。故自写 Python 网关精确发{title,desp}。 - Docker bridge 网络不通外网(容器内超时、宿主正常)→ 改
network_mode: host解决。 - 换行:单
\n被 Server酱³ 当一行;改空行\n\n才分行(实测验证)。
3. 清理
- 删除无用镜像:
caronc/apprise(273MB)、hello-world - 清理调试残留:
/root/apprise*、pull*.out/log - 104 磁盘 ~2.3G(85%)
五、守护脚本策略详解(防刷屏)
核心参数(脚本头部,可改)
| 参数 | 默认 | 含义 |
|---|---|---|
FAIL_THRESHOLD | 3 | 连续异常几次才重启 driver |
COOLDOWN | 600s | 两次重启最小间隔,防重启风暴 |
MAX_GIVEUP | 3 | 连续”重启后仍失败”达此数→停止重启/推送 |
QUITE_START / QUITE_END | 2330 / 0800 | 夜间静音时段(跨午夜) |
行为
- 正常取数:静默;若刚从异常恢复,补发一条”取数恢复正常”。
- 连续异常达 3 次(≈90s):自动
systemctl restart nut-driver@ups。- 重启成功 → 发”已自动重启驱动(恢复成功)”。
- 重启后仍失败 → 发”仍异常 N/3”,并累计。
- 持久故障封顶:连续”重启后仍失败”达 3 次 → 判定持久故障,停止自动重启、停止推送,只记日志;发一条 force 通知”已停止自动重启,请人工检查 USB”;之后某次恢复时补发一条”已恢复”并重新监控。
- 夜间静音窗(23:30–08:00):窗口内重启照做(保命优先)但不推送,仅写 journal;唯独”恢复”类通知为 force,静音窗内也会推送(好消息随时告知)。
- 冷却期内达阈值但未到重启时间 → 只提示一次后静默。
效果(出门在外、driver 一直坏的最坏情况)
- 不再每 10 分钟刷一条;
- 夜间 23:30–08:00 完全静音,不吵睡觉;
- 最多:白天几条”仍在尝试”→ 一条”持久故障已停止”→ 恢复后一条”已恢复”。
已修的坑
QUITE_END=0800 会被 bash 当八进制解析崩溃(value too great for base),已用 10# 十进制解析修复并验证时间窗正确。
六、验证结果
- 方法1(手动跑脚本)10 种事件全部发送成功(rc=0)。
- 真实链路:PVE → 104 网关 → Server酱³ → 手机,http=204,标题+正文中文、正文分行正常。
- 驱动守护:制造 Data stale → 90s 自动恢复 + 通知 ✅
- 静音窗内普通通知只进日志、force 恢复通知仍推送 ✅
- 时间窗判断:22:00 推送 / 23:30–07:59 静音 / 08:00 起推送 ✅
七、日常使用 / 调试 / 删除
内网任意服务发通知:
curl -X POST http://192.168.100.4:8000/notify \
--data-urlencode "title=标题" \
--data-urlencode "body=第一行
第二行"UPS 事件手动测试(方法1):
/usr/local/bin/ups-notify.sh ONBATT # 市电中断
/usr/local/bin/ups-notify.sh ONLINE # 市电恢复
/usr/local/bin/ups-notify.sh LOWBATT # 电池低
# 其它: FSD COMMOK COMMBAD SHUTDOWN REPLBATT NOCOMM NOPARENT驱动守护调试:
journalctl -u nut-driver-watchdog.service -n 50 --no-pager
journalctl -t nut-watch -n 50 --no-pager
/usr/local/sbin/nut-driver-watch.sh # 手动跑一次
cat /run/nut-driver-watch.state # 当前状态(fail_count/consec_fail/giveup...)改策略: 编辑 /usr/local/sbin/nut-driver-watch.sh 头部变量后 systemctl restart nut-driver-watchdog.timer。
删除守护(全部为新增文件,可安全删):
systemctl disable --now nut-driver-watchdog.timer
rm -f /etc/systemd/system/nut-driver-watchdog.{service,timer} \
/usr/local/sbin/nut-driver-watch.sh
systemctl daemon-reload删除通知网关:
cd /root/notify-gw && docker compose down
rm -rf /root/notify-gw
# PVE 侧可选:注释 upsmon.conf 的 NOTIFYCMD/NOTIFYFLAG,reload nut-monitor回滚 upsmon.conf: 恢复 /etc/nut/upsmon.conf.bak.* 之一后 systemctl reload-or-restart nut-monitor。
回滚守护脚本: `/usr/local/sbin/nut-driver-w