sjdaws/nut

Network UPS Tools (NUT) Docker镜像

镜像概述

Network UPS Tools (NUT) 是一款开源的UPS管理套件，该Docker镜像提供了便捷部署方式，用于监控、管理和保护连接的不间断电源(UPS)设备。通过NUT，用户可以实时获取UPS状态信息（如负载、电池容量、输入电压等），并在断电时自动执行安全关机流程，防止数据丢失或设备损坏。

核心功能与特性

• 多设备支持：兼容超过1000种不同品牌和型号的UPS设备，包括APC、CyberPower、Tripp Lite等主流品牌
• 实时监控：提供UPS状态实时监控，包括输入/输出电压、负载百分比、电池容量、运行时间估计等关键参数
• 自动保护机制：支持断电时自动触发服务器/设备安全关机流程，可配置延迟时间和触发条件
• 网络访问：通过网络接口（HTTP、SNMP、NUT协议）提供远程监控能力，支持多设备集中管理
• 可扩展性：支持自定义配置和脚本，满足特定场景下的自动化需求

使用场景

• 服务器机房：保护服务器、网络设备在断电时安全关闭
• 家庭/小型办公：保障NAS、路由器、小型服务器等关键设备的电力稳定性
• 数据中心：集中监控多台UPS设备，实现统一管理和告警
• 工业环境：为工业控制设备提供电力故障保护

使用方法与配置说明

基本运行命令

bash
docker run -d \
  --name nut-server \
  --restart=always \
  -p 3493:3493 \  # NUT默认端口
  -v /path/to/nut/config:/etc/nut \  # 挂载配置文件目录
  -v /dev/bus/usb:/dev/bus/usb \  # 若UPS通过USB连接，需挂载USB设备
  --device=/dev/ttyUSB0:/dev/ttyUSB0 \  # 若UPS通过串口连接，指定串口设备
  nutupsd/nut

环境变量配置

配置文件说明

核心配置文件位于/etc/nut目录，主要包括：

• ups.conf：UPS设备配置，定义UPS名称、驱动和连接参数
• upsd.conf：服务器配置，设置监听端口和访问控制
• upsd.users：用户认证配置，定义访问NUT服务器的用户和权限
• upsmon.conf：监控客户端配置，设置监控参数和自动关机规则

Docker Compose示例

yaml
version: '3'
services:
  nut-server:
    image: docker.xuanyuan.run/nutupsd/nut
    container_name: nut-server
    restart: always
    ports:
      - "3493:3493"
    volumes:
      - ./nut-config:/etc/nut
      - /dev/bus/usb:/dev/bus/usb
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0
    environment:
      - UPS_NAME=myups
      - UPS_DRIVER=usbhid-ups
      - UPS_PORT=auto
      - ALLOW_FROM=0.0.0.0/0

访问与监控

1. 通过NUT客户端：使用upsc命令查询UPS状态

   bash
   upsc myups@localhost:3493
   

2. Web界面：可搭配NUT的Web管理工具（如nut-webui）实现图形化监控

3. SNMP访问：配置SNMP模块后，可通过SNMP协议集成到监控系统（如Zabbix、Prometheus）

注意事项

• 确保宿主机对UPS设备有读写权限，USB设备可能需要添加--privileged参数或调整udev规则
• 不同UPS型号需使用对应驱动，具体驱动列表可参考NUT官方兼容性列表
• 首次使用需根据UPS型号配置ups.conf，不正确的驱动或端口配置会导致设备无法识别