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

nut-cgi 镜像文档

镜像概述

nut-cgi镜像是一个基于debian:latest的基础Docker镜像，集成了nut-cgi（Network UPS Tools的CGI组件）和lighttpd Web服务器。该镜像用于提供UPS（不间断电源）状态监控的Web界面，通过配置hosts.conf文件指定需要监控的UPS系统，容器默认在80端口提供Web服务。

核心功能和特性

• 集成组件：包含nut-cgi工具和lighttpd Web服务器，无需额外安装即可使用
• 配置灵活：通过hosts.conf文件自定义监控的UPS系统
• 基于Debian：使用最新Debian系统作为基础，稳定性高
• 端口监听：容器默认监听80端口，可通过端口映射暴露服务

使用场景

• 服务器机房UPS状态集中监控
• 数据中心UPS设备远程管理
• 需通过Web界面实时查看UPS运行状态的场景
• 对UPS状态进行集中展示和管理的环境

使用方法

前置条件

• 已安装Docker环境
• 准备自定义的hosts.conf配置文件（用于指定监控的UPS系统）

基本部署步骤

1. 创建hosts.conf配置文件（示例见配置说明部分）
2. 使用docker run命令启动容器，映射端口并挂载配置文件
3. 通过浏览器访问映射的端口，查看UPS监控界面

配置说明

hosts.conf配置文件

hosts.conf用于配置需要监控的UPS系统，格式如下：

# Network UPS Tools: 示例hosts.conf
#
# 此文件用于控制CGI程序。如果未安装CGI程序，可忽略或删除此文件。
#
# -----------------------------------------------------------------------
#
# upsstats在显示默认模板(upsstats.html)时会使用MONITOR条目列表。
# 模板中的"FOREACHUPS"指令将使用此文件查找运行upsd的系统。
#
# upsstats和upsimage也使用此文件确定是否可以监控某个主机，防止未授权查询。
#
# upsset通过此文件提供可查看和控制的系统列表。
#
# -----------------------------------------------------------------------
#
# 使用方法：列出需要监控的运行upsd的系统
#
# MONITOR <系统> "<主机描述>"
#
# 示例：
#
# MONITOR myups@localhost "本地UPS"
# MONITOR su2200@10.64.1.1 "财务部门UPS"
# MONITOR *** " Sierra高中数据机房 #1"

配置说明：

• MONITOR：定义需要监控的UPS系统
• <系统>：格式为[UPS名称]@[主机地址]，其中主机地址为运行upsd服务的服务器地址
• <主机描述>：对该UPS系统的描述信息，将显示在Web界面中

部署示例

Docker Run命令

bash
docker run -d \
  --name=nut \
  -p 8000:80 \
  -v /path/to/hosts.conf:/etc/nut/hosts.conf \
  --restart unless-stopped \
  danielb7390/nut-cgi

参数说明：

• -d：后台运行容器
• --name=nut：指定容器名称为nut
• -p 8000:80：将容器的80端口映射到主机的8000端口
• -v /path/to/hosts.conf:/etc/nut/hosts.conf：挂载本地hosts.conf文件到容器内指定路径
• --restart unless-stopped：容器退出时除非手动停止，否则自动重启
• danielb7390/nut-cgi：使用的镜像名称

访问监控界面

启动容器后，通过浏览器访问 http://<主机IP>:8000 即可查看UPS监控界面，显示hosts.conf中配置的所有UPS系统状态。