一、目标

  1. 让 PVE 的 APC UPS 事件(断电/来电/低电/关机等)推送通知到手机(Server酱³)。
  2. 把通知服务做成内网可复用的独立 Docker 服务。
  3. 解决 NUT 驱动偶发”读不到 UPS”(Data stale)不自愈的问题,加自动重启守护。
  4. 守护需防夜间刷屏(静音窗 + 持久故障封顶),保留详细文件路径与使用说明,方便调试/删除。

二、最终架构

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_THRESHOLD3连续异常几次才重启 driver
COOLDOWN600s两次重启最小间隔,防重启风暴
MAX_GIVEUP3连续”重启后仍失败”达此数→停止重启/推送
QUITE_START / QUITE_END2330 / 0800夜间静音时段(跨午夜)

行为

  1. 正常取数:静默;若刚从异常恢复,补发一条”取数恢复正常”。
  2. 连续异常达 3 次(≈90s):自动 systemctl restart nut-driver@ups。
    • 重启成功 → 发”已自动重启驱动(恢复成功)”。
    • 重启后仍失败 → 发”仍异常 N/3”,并累计。
  3. 持久故障封顶:连续”重启后仍失败”达 3 次 → 判定持久故障,停止自动重启、停止推送,只记日志;发一条 force 通知”已停止自动重启,请人工检查 USB”;之后某次恢复时补发一条”已恢复”并重新监控。
  4. 夜间静音窗(23:30–08:00):窗口内重启照做(保命优先)但不推送,仅写 journal;唯独”恢复”类通知为 force,静音窗内也会推送(好消息随时告知)。
  5. 冷却期内达阈值但未到重启时间 → 只提示一次后静默。

效果(出门在外、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