botsudo/nut-upsd Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Network UPS Tools服务器

!Docker镜像大小

Network UPS Tools服务器的Docker镜像，发布于Docker Hub，源码托管在GitHub。

镜像概述和主要用途

本镜像提供完整的UPS监控服务（仅支持USB驱动），可用于连接和管理UPS设备，通过网络提供UPS状态监控和管理功能。

核心功能和特性

• 支持USB连接的UPS设备监控
• 通过环境变量实现配置自定义
• 提供upsd服务，默认监听3493端口
• 支持设置UPS名称、描述、驱动程序等参数
• 可配置系统 shutdown 命令

使用场景和适用范围

适用于需要通过网络监控和管理UPS设备的场景，如家庭服务器、小型数据中心或网络机房，帮助用户实时了解UPS状态并在断电时执行必要的系统保护操作。

使用方法和配置说明

基本使用

启动容器命令示例：

sh
docker run \
    --name nut-upsd \
    --detach \
    --publish 3493:3493 \
    --device /dev/bus/usb/xxx/yyy \
    --env SHUTDOWN_CMD="my-shutdown-command-from-container" \
    botsudo/nut-upsd

通过环境变量自动配置

本镜像支持通过环境变量进行自定义配置，以下是可用的环境变量说明：

UPS_NAME

• 默认值：ups
• 说明：UPS的名称

UPS_DESC

• 默认值：Eaton 5SC
• 说明：UPS的简短描述，upsd会向请求连接的客户端提供此描述

UPS_DRIVER

• 默认值：usbhid-ups
• 说明：用于监控UPS的驱动程序

UPS_PORT

• 默认值：auto
• 说明：UPS连接的串行端口

API_PORT

• 默认值：3493
• 说明：upsd服务使用的端口

API_ADDRESS

• 默认值：0.0.0.0
• 说明：upsd服务绑定的地址

API_USER

• 默认值：upsmon
• 说明：upsmon与upsd进程通信使用的用户名

API_PASSWORD

• 默认值：secret
• 说明：upsmon用户的密码

SHUTDOWN_CMD

• 默认值：echo 'System shutdown is not configured!'
• 说明：当系统需要关闭时，upsmon将运行的命令（在容器内执行）