Network UPS Tools (NUT) 配置指南：实现低电量自动关机

前言

Network UPS Tools (NUT) 是一个功能强大的开源UPS监控工具套件，能够为各种不间断电源设备提供监控和管理功能。本文将详细介绍如何正确配置NUT的upsmon服务，实现当UPS电池电量低时自动安全关闭系统的完整流程。

核心组件与工作原理

NUT系统由三个主要组件构成：

1. 驱动层(nut-driver)：负责与具体UPS硬件通信
2. 服务层(nut-server/upsd)：提供集中监控和管理接口
3. 监控层(nut-monitor/upsmon)：执行状态监控和触发关机操作

当配置正确时，upsmon会持续监控UPS状态，在检测到低电量(LB)条件时，按照以下流程执行关机：

1. 触发强制关机(FSD)标志
2. 创建电源关闭标志文件
3. 执行系统关机命令
4. 在系统关机后期通过nutshutdown脚本通知UPS切断电源

关键配置步骤

1. 基础配置文件设置

nut.conf 确定运行模式：

MODE=netserver

ups.conf 配置UPS设备：

[pi]
    driver = upsplus
    port = /dev/i2c-1
    desc = "RaspberryPi_UPSPlus"

upsmon.conf 关键参数：

RUN_AS_USER nut
MONITOR pi@localhost 1 upsmon pass master
SHUTDOWNCMD "/sbin/shutdown -h +0"
POWERDOWNFLAG /run/nut/killpower  # 推荐使用临时文件系统位置

2. 权限与文件系统注意事项

• 确保/run/nut目录存在且nut用户有权限
• 不要手动创建POWERDOWNFLAG文件，upsmon会自动管理
• 推荐将POWERDOWNFLAG放在/run或/dev/shm等临时文件系统

3. 系统服务配置

对于systemd系统，需特别注意：

1. nut-monitor.service应保持Type=forking
2. 确保/usr/lib/systemd/system-shutdown/nutshutdown脚本存在
3. 服务启动顺序应为：driver → server → monitor

常见问题排查

1. POWERDOWNFLAG文件问题

若出现"POWERDOWNFLAG does not contain the upsmon magic string"错误：

• 删除现有的标志文件
• 检查文件路径权限
• 确认upsmon有权限写入该位置

2. 关机流程不完整

如果系统关机但UPS未断电：

• 验证nutshutdown脚本是否被执行
• 检查系统日志中nutshutdown的输出
• 确认UPS驱动支持-k关机参数

3. 服务启动问题

当upsmon无法保持运行时：

• 检查PID文件权限(应属于nut用户)
• 验证RUN_AS_USER配置
• 考虑增加调试选项(-D)排查启动问题

高级配置建议

1. 多UPS环境：使用nut-driver@.service为每个UPS创建独立服务实例
2. 调试模式：临时启用驱动调试(driver.debug=1)进行问题诊断
3. 自定义通知：通过NOTIFYMSG和NOTIFYFLAG配置警报消息
4. 关机延迟：设置FINALDELAY确保关键服务有足够时间关闭

版本兼容性提示

不同NUT版本间存在行为差异：

• 2.7.4使用单一nut-driver.service
• 2.8.0+引入nut-driver@.service模板
• 新版改进了systemd集成和调试功能

建议尽可能使用最新稳定版本以获得最佳功能和兼容性。

结语

正确配置NUT的自动关机功能需要理解其多组件协作机制，特别注意权限、文件系统和关机流程的完整链路。通过本文介绍的配置方法和排查技巧，用户可以建立可靠的UPS监控和自动关机系统，有效保护设备免受意外断电损害。