折腾家里云（二）： 配置UPS系统，入手伊顿Eaton 9PX3000IRT2U和9PXEBM72RT2U电池包，并配置NUT共享网络UPS

连接与识别#

我的 UPS 没有选装网络卡，所以用一根 USB type-B（打印机线）直接把 UPS 接到服务器上。

1
root@poweredge-r730:~# lsusb
2
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
3
Bus 001 Device 002: ID 8087:800a Intel Corp. Hub
4
Bus 001 Device 003: ID 413c:a001 Dell Computer Corp. Hub
5
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
6
Bus 002 Device 002: ID 8087:8002 Intel Corp. 8 channel internal hub
7
Bus 002 Device 003: ID 0463:ffff MGE UPS Systems UPS    <---这个

0463 是 MGE（后来被伊顿收购）的 USB Vendor ID，ffff 则是 UPS 类设备的通用 Product ID，伊顿/MGE 系的 UPS（9PX、5PX、5SC 等）基本都是这一对 ID。

为什么不用伊顿官方软件

伊顿官方的 Intelligent Power Protector (IPP) 配置全走 Web 界面，对”一台 UPS 通过局域网通知多台设备”这种多机联动支持得很差。而 NUT 是 Linux 世界的标准做法：配置全是纯文本，天然支持一台 UPS 共享给整个局域网。

NUT 架构#

NUT（Network UPS Tools）把”和 UPS 说话”和”要不要关机”这两件事拆成了两个独立的进程，中间用一套很简单的文本协议连接。

1
┌──────────────┐   USB (HID)    ┌────────────────┐
2
│  Eaton 9PX   │◀─────────────▶│   usbhid-ups   │  ← 驱动
3
└──────────────┘                └───────┬────────┘
4
                                        │ /run/nut/usbhid-ups-eaton9px
5
                                        ▼
6
                                 ┌─────────────┐
7
                                 │    upsd     │  ← 数据服务器
8
                                 └──────┬──────┘
9
           127.0.0.1:3493 ──────────────┤────────────── 10.10.10.2:3493
10
                                        │  TCP 3493（NUT 明文协议）
11
        ┌───────────────────────────────┼───────────────────────────────┐
12
        ▼                               ▼                               ▼
13
┌───────────────┐             ┌───────────────┐               ┌───────────────┐
14
│    upsmon     │             │    upsmon     │               │ upsc / upsrw  │
15
│   (primary)   │             │  (secondary)  │               │   查询工具     │
16
│   R730 本机    │             │   fnOS NAS    │               │               │
17
└───────────────┘             └───────────────┘               └───────────────┘

装包：

1
apt install nut nut-server nut-client

Debian 13 上装完会自动带上 systemd 集成：nut-driver-enumerator.path 会根据 ups.conf 自动生成 nut-driver@eaton9px.service，不需要手动启动驱动。

服务端配置（R730，MODE=netserver）#

nut.conf 里的 MODE 决定这台机器扮演什么角色：

1
MODE=netserver

• standalone：本机接 UPS、自己监控、自己关机（单机场景）
• netserver：本机接 UPS，并把数据用 upsd 共享给局域网（本例）
• netclient：本机不接 UPS，只连别人的 upsd（后文的二级节点）

1
[eaton9px]
2
    driver = usbhid-ups
3
    port = auto
4
    vendorid = 0463
5
    productid = ffff
6
    desc = "Eaton 9PX UPS (USB)"
7
    # UPS 收到断电指令后延迟 60 秒才切断输出（默认 20 秒），给服务器留更多关机时间
8
    offdelay = 60
9
    # 市电恢复后 90 秒再开启输出，尽量避免"刚关机就来电、来电又断电"的反复横跳
10
    ondelay = 90

1
LISTEN 127.0.0.1 3493
2
LISTEN 10.10.10.2 3493

1
# 本机 upsmon，是 primary，需要设置 FSD 的权限
2
[upsmon]
3
    password = <你的密码>
4
    upsmon primary
5

6
# 二级节点（NAS），只需要能登录读取状态
7
[fnos-upsmon]
8
    password = <你的密码>
9
    upsmon secondary
10

11
[cyan-fnos-upsmon]
12
    password = <你的密码>
13
    upsmon secondary

1
MONITOR eaton9px@localhost 1 upsmon <密码> primary
2

3
MINSUPPLIES 1
4
SHUTDOWNCMD "/sbin/shutdown -h +0"
5
POLLFREQ 5
6
POLLFREQALERT 5
7
HOSTSYNC 180
8
DEADTIME 15
9
POWERDOWNFLAG "/etc/killpower"
10
OFFDURATION 30
11
RBWARNTIME 43200
12
NOCOMMWARNTIME 300
13
FINALDELAY 5

让 UPS 在服务器关机后也断电#

这一步是很多人会漏掉的：服务器关机了，但 UPS 还在放电。如果停电时间很长，电池会被彻底耗干；如果”关机后立刻来电”，服务器又会在电池剩一点点的时候启动，接着再停一次电——这就是所谓的 power race。

NUT 的解法是三级配合：

1. upsmon 判定要关机时，创建 POWERDOWNFLAG 文件（本例是 /etc/killpower）
2. 系统关机走到最后，systemd 会执行 /usr/lib/systemd/system-shutdown/nutshutdown
3. 该脚本先用 upsmon -K 检查标志文件是否存在，存在就调用 upsdrvctl shutdown 命令 UPS 切断输出（延迟 offdelay 秒）

1
# 手动检查标志文件状态，正常运行时应当输出 "Power down flag is not set"
2
upsmon -K

之后只要市电恢复，UPS 会在 ondelay 秒后自动给负载上电，服务器再依靠 BIOS 的”上电自启”（R730 里是 AC Power Recovery）自动开机。

FSD：一次断电通知背后的完整流程#

FSD 是 Forced Shutdown（强制关机），是 NUT 里最巧妙的一个设计。关键点在于：primary 并不是”挨个通知”二级节点的，而是把 FSD 标志写进 upsd，所有连上来的 upsmon 自己会看到。

在 upsd 看来，FSD 标志等价于”市电断电 + 电池低电量”，也就是 critical 状态。所以从二级节点的视角，“UPS 真的快没电了”和”primary 让我关机”是同一件事，走的是同一套逻辑：

几个容易踩的点：

1. 只有 upsmon primary 用户有 FSD 权限。 如果二级节点连上来的账号被误配成 primary（或反之），就会表现为”通知发出去了但没人关机”或”该等的没等”。
2. HOSTSYNC 与 FINALDELAY 的配对（见上一节）。
3. SHUTDOWNEXIT 默认为 yes：二级节点一旦开始执行 SHUTDOWNCMD，upsmon 就会退出，从而断开与 upsd 的连接；primary 正是靠着”客户端一个个掉线”来判断二级节点是否已经进入关机流程。所以如果某台二级节点关机特别慢（比如 NAS 要停 Docker），要么调大 primary 的 HOSTSYNC，要么用 upssched 让它更早开始关机。
4. upsmon -c fsd 会立刻走完整流程（包括让机器关机），演练时请慎用。

二级节点（fnOS / NAS）配置#

二级节点不接 UPS，也不需要驱动，只要装 nut-client（提供 upsmon）即可：

1
apt install nut-client

1
MODE=netclient

1
# 用户名密码要和 R730 上 /etc/nut/upsd.users 里的完全一致
2
MONITOR eaton9px@10.10.10.2 1 fnos-upsmon <密码> secondary
3

4
MINSUPPLIES 1
5
SHUTDOWNCMD "/sbin/shutdown -h +0"
6
FINALDELAY 5

NOTE

POWERDOWNFLAG 在 secondary 上其实没有意义——二级节点没有驱动，无法命令 UPS 断电，nutshutdown 会因为找不到 upsdrvctl 而跳过这一步。不配置它也没问题，只要保证 SHUTDOWNCMD 正确即可。

验证连通性：

1
# 在二级节点上列出能看到哪些 UPS
2
upsc -l 10.10.10.2
3
# 读取关键变量
4
upsc eaton9px@10.10.10.2 ups.status battery.charge battery.runtime

如果报 Access denied，八成是 upsd.users 里没有对应的用户名/密码，或者 upsd.conf 里少了一行 LISTEN。

日常使用：几个常用命令#

1
upsc eaton9px                              # 打印全部 102 个变量
2
upsc eaton9px ups.status battery.charge battery.runtime ups.load
3
upsc -l                                    # 列出本机 upsd 能看到的 UPS
4
upsrw -l eaton9px                          # 列出可写变量
5
upscmd -l eaton9px                         # 列出支持的即时命令
6
upscmd eaton9px beeper.mute                # 静音（半夜停电时你会用到的）
7
upscmd eaton9px test.battery.start.quick   # 手动启动一次电池自检
8
upsmon -c reload                           # 重载 upsmon.conf

实测这台 9PX3000IRT2U 在 12% 负载（约 320W）下的状态：

1
$ upsc eaton9px | grep -E "ups.status|battery.charge:|battery.runtime:|ups.load|ups.realpower:"
2
battery.charge: 100
3
battery.runtime: 11803        # ≈ 3 小时 16 分
4
ups.load: 12
5
ups.realpower: 320
6
ups.status: OL CHRG

ups.status 的常见组合

ups.status 可能是多个 flag 的组合，用空格分隔，常见的有：

flag	含义
OL	On Line，市电在线
OB	On Battery，电池供电
LB	Low Battery，低电量（触发关机的关键）
CHRG / DISCHRG	充电中 / 放电中
BYPASS	旁路供电（有电但不受保护）
FSD	已收到强制关机指令
OVER	过载
CAL	电池校准中

监控：把状态推到 Uptime Kuma#

光有日志还不够，我需要”手机能收到告警”。upsmon 默认只会在 syslog 和终端 wall 里喊（NOTIFYFLAG 的默认行为），要自己写 NOTIFYCMD 才能推送到手机。所以写了个常驻脚本，把状态变化推到 Uptime Kuma 的 Push 监控：

1
[Unit]
2
Description=NUT UPS status push to Uptime Kuma
3
Wants=network-online.target
4
After=network-online.target nut-server.service
5

6
[Service]
7
Type=simple
8
ExecStart=/usr/local/bin/nut-ups-push.sh
9
Restart=always
10
RestartSec=15
11
Environment="LOG_FILE="
12

13
[Install]
14
WantedBy=multi-user.target

脚本逻辑很简单：每 5 秒 upsc 一次，把状态归并成 online / battery / lowbatt / bypass / commbad 几种模式，模式一变就立即推送；一直正常时则每 10 分钟推一次心跳。推送内容带上当前功率、电池百分比和预计剩余时间：

实测记录#

截至写这篇文章时，这套系统已经挡下了几次停电：