gpdm/nut-upsd

nut-upsd

这是nut-upsd Docker镜像，实现了来自Network UPS Tools的UPS驱动程序和upsd守护进程。本镜像设计为通用容器，支持从单个容器监控多个UPS设备，区别于“一个容器对应一个UPS”的传统实现；缺点是需通过配置文件而非环境变量配置。

核心功能

• 运行NUT的UPS驱动程序与upsd守护进程
• 支持单个容器监控多台UPS设备
• 需通过配置文件完成设备、守护进程及用户权限设置

使用场景

适用于数据中心、服务器机房、小型企业IT环境等需集中监控多台UPS设备的场景，帮助用户实时掌握UPS状态，保障电力供应稳定性。

配置说明

必要配置文件

镜像仅运行UPS驱动与upsd守护进程，需准备以下文件：

• ups.conf：UPS设备参数配置
• upsd.conf：upsd守护进程配置
• upsd.users：用户权限与访问控制配置

配置步骤

1. 创建上述三个配置文件（可参考https://github.com/gpdm/nut/tree/master/nut-upsd/files/etc/nut）
2. 保存至持久化目录（如/data/dockers/nut-upsd/config）
3. 设置权限与所有权：

   bash
   cd /data/dockers/nut-upsd/config
   chmod 0400 ups.conf upsd.conf upsd.users
   chown 100:101 ups.conf upsd.conf upsd.users
   

4. 运行容器时挂载配置目录：-v /path/to/nut-config:/etc/nut

注意：未挂载配置卷或缺少文件将导致容器启动失败！

设备映射

需将UPS设备映射至容器，两种方式可选：

特权模式（不推荐）

启动时添加--privileged参数，安全性低但配置简单。

设备模式（推荐）

仅映射所需设备，步骤如下：

1. 用lsusb获取UPS设备信息（如Bus 005 Device 002对应路径/dev/bus/usb/005/002）
2. 用ls -l /dev/bus/usb/005/002获取主次设备号（如189:513）
3. 启动时添加映射参数：

   bash
   --device /dev/bus/usb/005/002 --device-cgroup-rule='c 189:513 rw'
   

部署示例

拉取镜像

bash
docker pull docker.xuanyuan.run/gpdm/nut-upsd[:<tag>]

• latest：最新版本（可能不稳定）
• 版本标签：稳定版本（若存在）

特权模式运行

bash
docker run -d \
  -p 3493:3493 \
  -v /data/dockers/nut-upsd/config:/etc/nut \
  --privileged \
  docker.xuanyuan.run/gpdm/nut-upsd:latest

设备模式运行（双UPS示例）

bash
docker run -d \
  -p 3493:3493 \
  -v /data/dockers/nut-upsd/config:/etc/nut \
  --device /dev/bus/usb/005/002 --device-cgroup-rule='c 189:513 rw' \
  --device /dev/bus/usb/006/002 --device-cgroup-rule='c 189:641 rw' \
  gpdm/nut-upsd:latest