NUT项目在Raspberry Pi上的服务启动问题排查与解决

问题背景

在Raspberry Pi 3上运行Debian系统时，用户尝试配置Network UPS Tools(NUT)项目来监控CyberPower UPS设备。虽然UPS驱动能够成功启动，但nut-server服务却无法正常启动，导致无法通过NUT监控UPS状态。

问题现象

用户遇到的主要症状包括：

1. 通过systemctl启动nut-server服务时显示启动失败
2. 直接运行upsd命令时没有任何输出就退出
3. 日志中没有显示任何有用的错误信息

排查过程

初步检查

首先确认了NUT的版本为2.8.0-7，这是一个较新的版本。检查UPS驱动状态发现已经成功启动：

systemctl status nut-driver@cyberpower

驱动日志显示设备已被正确识别，且没有明显的错误信息。

调试日志配置

尝试在upsd.conf中添加调试选项：

DEBUG_MIN 6

但日志中仍未显示任何有用信息，说明问题可能发生在服务启动的早期阶段。

直接执行测试

绕过systemd服务直接执行upsd二进制文件：

/lib/nut/upsd

发现服务能够正常启动，这表明问题可能出在服务启动脚本或配置上。

配置文件检查

检查/etc/nut目录下的配置文件权限，确认所有文件都正确设置了权限和属主：

tree /etc/nut/ -pugaf

权限设置符合预期，没有发现问题。

启动脚本分析

深入检查发现NUT使用了一个包装脚本/sbin/upsd，其内容如下：

#!/bin/sh

[ -r /etc/nut/nut.conf ] && . /etc/nut/nut.conf

case "$MODE" in
  standalone|netserver)
    exec /lib/nut/upsd "$@"
  ;;
  none|netclient)
    echo "upsd disabled, please adjust the configuration to your needs"
    echo "Then set MODE to a suitable value in /etc/nut/nut.conf to enable it"
    exit 0
  ;;
  *)
    exit 1
  ;;
esac

关键发现

检查nut.conf文件时发现配置错误：

MODE=nutserver

而脚本中检查的是"netserver"模式，两者不匹配导致脚本直接退出。

解决方案

将nut.conf中的模式配置修改为：

MODE=netserver

修改后，nut-server服务能够正常启动，问题得到解决。

经验总结

1. 配置验证：在修改配置文件后，应该仔细检查关键参数的值是否符合预期格式和大小写要求。

2. 调试技巧：当服务无法启动且没有日志输出时，可以尝试直接执行二进制文件来缩小问题范围。

3. 包装脚本：理解系统服务的启动流程和包装脚本的作用对于排查问题非常重要。

4. 权限检查：虽然本次问题与权限无关，但检查配置文件的权限和属主是一个良好的排障习惯。

5. 配置参数：NUT项目使用MODE参数来区分不同的运行模式，正确理解这些模式的含义对于配置至关重要。

通过这次排障过程，我们不仅解决了具体问题，也加深了对Linux服务管理和NUT项目配置的理解。