zedred/apcupsd-cgi

apcupsd-cgi Docker镜像文档

镜像概述和主要用途

apcupsd-cgi是一个基于Debian Buster的Docker镜像，集成了nginx-light Web服务器、fcgiwrap CGI服务器和apcupsd-cgi工具，提供APC UPS电源管理的Web界面。该镜像用于通过浏览器监控和管理APC UPS设备状态，需配合主机上运行的apcupsd守护进程使用。

前提要求

硬件要求

• 支持监控的APC UPS设备（通过USB线缆或网络连接）

软件要求

• 在主机上安装apcupsd守护进程（用于与UPS通信）：
  • Debian/Ubuntu系统安装命令：

    bash
    sudo apt install apcupsd
    

主机配置步骤

1. 验证UPS连接（USB连接时）：

   bash
   sudo lsusb
   

   应显示"American Power Conversion Uninterruptible Power Supply"设备。

2. 配置apcupsd.conf：

   bash
   sudo nano /etc/apcupsd/apcupsd.conf
   

   USB连接的最小配置参数：

   参数	设置	说明
   UPSCABLE	usb	定义线缆连接类型
   UPSTYPE	usb	定义UPS类型
   DEVICE		留空以自动配置USB端口
   NETSERVER	on	启用网络信息服务器
   NISIP	0.0.0.0	NIS服务器监听的IP地址

3. 配置默认设置：

   bash
   sudo nano /etc/default/apcupsd
   

   设置：ISCONFIGURED=yes

4. 启动apcupsd服务：

   bash
   # 检查状态
   sudo systemctl status apcupsd
   
   # 启用并启动服务（若未运行）
   sudo systemctl enable apcupsd && sudo systemctl start apcupsd
   
   # 验证UPS状态
   apcaccess status
   

核心功能和特性

• 基于Debian Buster系统，轻量稳定
• 集成nginx-light作为Web服务器，资源占用低
• 包含fcgiwrap作为CGI服务器，处理apcupsd-cgi请求
• 预配置连接主机apcupsd守护进程（默认端口3551）
• 直接通过Web界面提供multimon.cgi监控功能
• 暴露80端口，支持主机端口映射

使用场景和适用范围

• 家庭或小型办公室APC UPS设备监控
• 需要通过Web界面远程查看UPS状态的场景
• 已在主机部署apcupsd守护进程的环境
• 希望通过Docker容器快速部署UPS监控界面的用户

使用方法和配置说明

基本运行命令

bash
docker run -d -p 4321:80 --restart=unless-stopped --name apcupsd-cgi docker.xuanyuan.run/zedred/apcupsd-cgi

说明：将容器80端口映射到主机4321端口（可根据需要修改主机端口）

Docker Compose配置

yaml
version: "2.1"
services:
  apcupsd-cgi:
      image: docker.xuanyuan.run/zedred/apcupsd-cgi
      container_name: apcupsd-cgi
      restart: unless-stopped
      ports:
        - 4321:80  # 主机端口:容器端口

自定义镜像

1. 克隆仓库：

   bash
   git clone https://github.com/zedred79/docker-apcupsd-cgi.git
   

2. 修改配置文件（根据需求调整nginx或apcupsd-cgi配置）

3. 构建自定义镜像：

   bash
   sudo docker build -t yourname/apcupsd-cgi .
   

访问Web界面

启动容器后，通过以下地址访问UPS监控界面：

[***]你的主机IP:4321