cybermainstay/nut-upsd

Network UPS Tools UPSD 镜像

镜像概述

本镜像为Network UPS Tools（NUT）的UPSD守护进程提供容器化运行环境，基于Alpine系统构建，不包含Web组件。支持两种运行模式，可根据需求灵活配置UPS设备管理方案。

核心功能

1. 双模式运行：支持single（单设备自动配置）和custom（自定义配置）两种模式，通过UNIT_MODE环境变量切换。
2. 环境变量配置：single模式下可通过环境变量快速配置UPS名称、驱动、端口、厂商ID等参数。
3. 自定义配置支持：custom模式下可映射本地配置文件目录，实现复杂场景下的UPS管理。
4. 安全设备映射：采用设备映射替代特权模式，提升容器运行安全性。

使用场景

• 家庭或小型办公环境中UPS设备的状态监控与管理。
• 企业IT系统中UPS设备的集中化管理需求。
• 需要与UPS设备通信以实现断电保护的场景。

配置说明

环境变量

部署步骤

1. 获取设备信息：部署容器后执行docker exec <容器名> nut-scanner -U获取UPS的厂商ID和产品ID。
2. 设备映射：根据扫描结果配置容器的设备映射（如/dev/bus/usb/002:/dev/bus/usb/002）。

Docker-Compose示例

单设备模式（UNIT_MODE=single）

yaml
version: '3.3'
services:
  nuts:
    image: cybermainstay/nut-upsd:latest
    container_name: nuts
    networks:
      - monitoring
    devices:
      - /dev/bus/usb/002:/dev/bus/usb/002
    device_cgroup_rules:
      - 'a 189:* rwm'
    mem_limit: 200m
    mem_reservation: 50m
    environment:
      UPS_NAME: APC1500
      UPS_DRIVER: usbhid-ups
      UPS_DESC: "APC1500VA Powering the firewall"
      UPS_VENDORID: "0744"
      UPS_PRODUCTID: "0532"
      UPSMON_PASS: "SuperSecretPASSWORD"
    restart: on-failure:2

networks:
  monitoring:
    external: false

自定义模式（UNIT_MODE=custom）

yaml
version: '3.3'
services:
  nuts:
    image: cybermainstay/nut-upsd:latest
    container_name: nuts
    networks:
      - monitoring
    volumes:
      - /srv/docker/volumes/nuts:/opt/nut/conf/
    devices:
      - /dev/bus/usb/002:/dev/bus/usb/002
    device_cgroup_rules:
      - 'a 189:* rwm'
    mem_limit: 200m
    mem_reservation: 50m
    environment:
      UNIT_MODE: custom
    restart: on-failure:2

networks:
  monitoring:
    external: false

自定义配置文件

custom模式下需在本地目录创建以下配置文件，并映射到容器的/opt/nut/conf/目录：

• nut.conf：NUT运行模式配置
• ups.conf：UPS设备配置
• upsd.conf：upsd守护进程配置
• upsd.users：用户权限配置
• upsmon.conf：UPS监控配置

配置文件修改后需重启容器生效。