rssd/nut-upsd Docker 镜像 - 轩辕镜像

镜像概述

upshift/nut-upsd是一个运行Network UPS Tools (NUT)服务器的Docker镜像，主要用于通过网络监控和管理UPS（不间断电源）设备。该镜像基于轻量级的Alpine Linux构建，确保资源占用低且运行高效，当前已更新至NUT 2.8.4版本，并使用最新Alpine基础镜像以提升兼容性和安全性。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，系统资源占用低，适合嵌入式环境和资源受限场景。
• 版本更新：NUT版本从2.8.0升级至2.8.4，包含最新功能改进、bug修复及安全更新；基础镜像从Alpine 3.15更新为Alpine latest，确保依赖包为最新稳定版。
• 灵活配置：新增MAXAGE环境变量，支持自定义UPS监控数据的最大老化时间，优化数据时效性管理。
• 标准化兼容：遵循NUT官方规范，支持主流UPS设备驱动，可与NUT客户端工具（如upsc、upsmon）无缝集成。

使用场景

• 服务器机房：集中监控多台UPS设备的状态（如电量、负载、输入输出电压等），实现统一管理。
• 家庭/小型办公：监控单台UPS，在断电时通过NUT客户端触发设备安全关机。
• 远程运维：通过网络远程访问UPS状态数据，集成至监控系统（如Prometheus、Zabbix）实现告警通知。
• 嵌入式系统：在低功耗设备（如树莓派）上部署，为边缘计算节点提供UPS保护监控。

使用方法

前提条件

• 已安装Docker引擎（19.03+版本推荐）。
• 准备UPS设备对应的NUT配置文件（如ups.conf、upsd.conf、upsd.users），配置内容需根据UPS型号及连接方式（USB/网络）调整。

基础部署步骤

1. 创建本地配置目录
   在宿主机创建NUT配置文件存放目录（如/opt/nut/config），并放入自定义配置文件：

   bash
   mkdir -p /opt/nut/config
   # 示例ups.conf（根据实际UPS型号修改）
   echo "myups driver=usbhid-ups port=auto" > /opt/nut/config/ups.conf
   # 示例upsd.conf（允许所有IP访问，生产环境需限制）
   echo "LISTEN 0.0.0.0 3493" > /opt/nut/config/upsd.conf
   # 示例upsd.users（添加管理员用户）
   echo -e "[admin]\npassword=secret\nactions=set\ninstcmds=all" > /opt/nut/config/upsd.users
   

2. 启动容器
   使用docker run命令启动镜像，挂载配置目录并映射NUT默认端口（3493）：

   bash
   docker run -d \
     --name nut-upsd \
     -p 3493:3493 \  # NUT服务器默认端口
     -v /opt/nut/config:/etc/nut \  # 挂载本地配置目录至容器内NUT配置路径
     -e MAXAGE=60 \  # 可选：设置UPS数据最大老化时间为60秒
     --restart unless-stopped \  # 容器退出时自动重启
     upshift/nut-upsd
   

3. 验证部署
   通过NUT客户端工具（如upsc）检查连接状态：

   bash
   # 安装NUT客户端（宿主机操作）
   sudo apt install nut-client  # Debian/Ubuntu
   # 或
   sudo yum install nut-client  # RHEL/CentOS
   
   # 查询UPS状态（myups为ups.conf中定义的UPS名称）
   upsc myups@localhost
   

配置参数说明

环境变量

配置文件

容器依赖外部挂载的NUT配置文件实现功能定制，核心配置文件说明：

• ups.conf：定义UPS设备信息，包括设备名称、驱动类型、连接端口等（必填）。
• upsd.conf：配置NUT服务器监听地址、端口及访问控制规则（必填）。
• upsd.users：定义访问NUT服务器的用户及权限（如监控、控制权限，必填）。
• upsmon.conf：若需容器内运行NUT监控进程（可选，通常由客户端实现），可添加此文件配置监控规则。

注意事项

• 安全建议：生产环境中，upsd.conf应限制允许访问的IP地址，upsd.users使用强密码并最小化权限。
• 设备权限：若UPS通过USB连接宿主机，需在docker run命令中添加--device=/dev/bus/usb（或具体USB设备路径）以允许容器访问USB设备。
• 日志查看：通过docker logs nut-upsd查看容器运行日志，排查配置错误或连接问题。