为家里所有设备配置 UPS 监控，NUT 服务器搭建笔记

dong4j2025-03-312025-11-30

random-pic-api

前言

说实话，我被 UPS 电源监控搞得快烦死了。

自从给家里整了套 UPS 后，就面临一个很现实的问题：家里设备越来越多，怎么让所有设备都能知道 UPS 的状态？

一开始我只是简单地把 NAS 接到 UPS 上，想着至少 NAS 能安全关机就行。但慢慢地问题就来了：

NAS 确实能安全关机，但其他设备呢？ - 正在下载的服务器、正在编码的视频工作站…
无法提前预警 - UPS 快没电了，其他设备还在正常工作，突然断电就懵了
手动管理太麻烦 - 每台设备都要单独配置，而且不同的系统配置方法还不一样

最尴尬的是有一次，UPS 已经开始最后的关机倒计时了，我还在旁边悠闲地刷视频，结果”啪”一下，全屋断电…

这时候我意识到，我需要的是一个统一的 UPS 监控方案。

NUT 是什么？

在网上查了一圈，发现了一个叫 NUT (Network UPS Tools) 的开源项目。说实话，这个名字一开始我还以为是坚果相关的工具，后来才发现是 Network UPS Tools 的缩写…

NUT 的核心理念很简单：让 UPS 成为网络设备。

传统的 UPS 配置是：

UPS → USB/串口 → 单台设备

而 NUT 的配置是：

UPS → 服务器(NUT Server) → 网络 → 所有设备(NUT Clients)

这样，任何支持 NUT 协议的设备都能通过局域网获取 UPS 状态，包括：

📊 UPS 负载百分比
🔋 电池剩余容量
⏱️ 预计剩余时间
📡 UPS 电压、频率等详细信息

群晖 NAS 作为 NUT 服务器

我家里的 DS923+ 很自然就成了 NUT 服务器的首选。毕竟 NAS 通常是 24/7 开机，而且已经通过 USB 连接着 UPS。

Linux 客户端配置

先从最常用的开始，家里的几台 Ubuntu 服务器都需要监控 UPS：

# 安装 NUT 客户端
apt install nut

# 配置 NUT 客户端模式
# /etc/nut/nut.conf
MODE=netclient

这里的 MODE=netclient 很关键，告诉 NUT 这是客户端模式，会通过网络连接 NUT 服务器。

# 配置 UPS 监控
# /etc/nut/upsmon.conf
MONITOR ups@192.168.31.2 1 monuser secret slave

# 关机命令设置
#SHUTDOWNCMD "/sbin/shutdown -h +0"
SHUTDOWNCMD "/usr/local/bin/ups-shutdown-notify.sh"

这里有个小细节：我把默认的关机命令换成了自定义的脚本。为什么呢？

因为直接关机太粗暴了！我想要在关机前做一些收尾工作：

给手机发送通知
关闭一些重要服务
记录关机日志

启动服务并测试：

systemctl start nut-client && systemctl status nut-client && systemctl enable nut-client

# 测试连接
upsc ups@192.168.31.2

如果看到 UPS 的详细信息输出，说明连接成功了！

监控和日志

为了让监控更直观，我还加了日志和通知：

# 查看 UPS 关机日志
tail -100f /var/log/ups_shutdown.log

# 我的自定义关机脚本
/usr/local/bin/ups-shutdown-notify.sh

这个通知脚本很有意思，我用它来：

给手机发 Telegram 通知（UPS 即将关机）
记录关机原因和剩余电量
清理临时文件
优雅关闭 Docker 容器

这样即使我不在家，也能知道家里的电源状况。

macOS 客户端配置

我主力用的 MacBook 当然也不能落下。macOS 配置其实更简单：

# 通过 Homebrew 安装
brew install nut

# 复制配置文件模板
cp /opt/homebrew/etc/nut/nut.conf.sample /opt/homebrew/etc/nut/nut.conf
code /opt/homebrew/etc/nut/nut.conf

设置客户端模式：

1	MODE=netclient

然后配置监控：

1
2
3

# 复制监控配置模板
cp /opt/homebrew/etc/nut/upsmon.conf.sample /opt/homebrew/etc/nut/upsmon.conf
code /opt/homebrew/etc/nut/upsmon.conf

添加监控配置：

1 2	MONITOR ups@192.168.31.2 1 monuser secret slave SHUTDOWNCMD "/usr/local/bin/ups-shutdown-notify.sh"

启动 NUT 服务后，macOS 的菜单栏就会显示电池图标，实时显示 UPS 状态。

遇到的坑：群晖 5 客户端限制

正当我为所有设备都配置好 NUT 而沾沾自喜时，问题来了…

群晖的 WebUI 只允许最多 5 个客户端连接！

我家里的设备可远远超过 5 台：

3 台 Ubuntu 服务器
2 台 MacBook
1 台 Windows 工作站
1 台 OpenWrt 软路由
还有各种测试设备…

第 6 台设备连接时，直接就被拒绝了！

一开始我还以为是配置问题，反复检查用户名密码，确认无误后才发现是群晖的硬性限制。

突破限制的方法

说实话，一开始我都想放弃群晖了，准备专门用一台 Linux 当 NUT 服务器。

但后来发现，群晖的 NUT 服务器功能其实是完整的，只是 WebUI 做了限制。我们可以直接修改底层配置文件！

群晖的 NUT 配置都在 /usr/syno/etc/ups 目录中，我们需要修改 synoups.conf 文件：

ups_mode="usb"
ups_wait_time="45"
ups_enabled="yes"
ups_safeshutdown="yes"
ups_acl="192.168.31.119|192.168.31.118|192.168.31.117|192.168.31.9|192.168.31.4|192.168.31.5|"

关键在于 ups_acl 这个配置项。WebUI 只能设置 5 个 IP，但我们可以直接编辑这个文件，把所有需要监控的设备 IP 都加上。

⚠️ 重要提醒：

每次修改完需要重启 NUT 服务
群晖系统更新可能会覆盖这个配置
IP 格式必须是 IP| 结尾

用户认证信息

群晖 NUT 服务器的默认认证信息可以在 upsd.users 文件中找到：

1 2	# 默认用户名密码 monuser:secret

当然，为了安全起见，建议修改默认密码。不过家里环境，默认密码也还好。

我的配置总结

经过这一番折腾，现在家里的网络环境是这样的：

                 UPS (USB)
                    ↓
           群晖 DS923+ (NUT Server)
                    ↓
              局域网 (192.168.31.x)
                    ↓
┌─────────────┬─────────────┬─────────────┐
│ Linux 服务器 │ macOS 设备  │ Windows PC  │
└─────────────┴─────────────┴─────────────┘

所有设备都能：