jchonig/nut-cgi Docker 镜像 - 轩辕镜像

docker-nut-cgi

镜像概述和主要用途

该容器包含Network UPS Tools的CGI工具和fcgiwrap，专门设计用于与nginx容器配合使用。由于许多nginx容器基于Alpine Linux，而Alpine系统未提供Nut CGI工具，本容器基于Ubuntu构建，预装了nut-cgi和fcgiwrap，可有效解决这一兼容性问题。

核心功能和特性

• 集成Network UPS Tools (NUT)的CGI工具，支持UPS设备状态监控与管理
• 包含fcgiwrap，实现CGI与FastCGI协议转换，适配nginx的FastCGI接口
• 基于Ubuntu系统构建，解决Alpine Linux环境下无法使用Nut CGI工具的问题
• 支持通过环境变量配置用户权限、时区等参数，灵活适配不同部署需求

使用场景和适用范围

适用于需要通过nginx Web服务器提供NUT CGI监控界面的场景，特别适合以下情况：

• 已部署基于Alpine Linux的nginx容器，无法直接使用Nut CGI工具
• 需要通过Web界面监控UPS设备状态和性能数据
• 希望采用容器化方式简化NUT CGI工具的部署和管理

使用方法和配置说明

docker-compose部署

兼容docker-compose v3架构，以下是典型配置示例：

yaml
---
version: "3"
services:
  nut-cgi:
    image: jchonig/nut-cgi
    container_name: nut-cgi
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
    volumes:
      - nut-html:/config/www/nut
      - /etc/nut/hosts.conf:/etc/nut/hosts.conf:ro
    expose:
      - 8081
    restart: unless-stopped

  nginx:
    # nginx容器配置
    volumes:
      # 其他卷配置...
      - nut-html:/config/www/nut:ro  # 只读挂载nut-cgi的Web文件
    restart: unless-stopped
    depends_on: nut-cgi  # 确保nut-cgi容器先启动

volumes:
  nut-html:  # 用于在nut-cgi和nginx之间共享Web文件的命名卷

参数说明

环境变量 (-e)

卷映射 (-v)

应用设置

必要配置步骤

1. 映射NUT配置文件
   将主机的NUT hosts.conf文件挂载到容器中：/etc/nut/hosts.conf:/etc/nut/hosts.conf:ro，确保容器能正确识别UPS设备。

2. 配置nginx
   在nginx配置中添加以下location块，实现对NUT CGI的反向代理：

nginx
location /nut {
    root /config/www;
    try_files $uri/index.html =404;  # 处理静态Web文件
}
location /cgi-bin/nut/ {
    gzip off;
    root /usr/lib;

    include /etc/nginx/fastcgi_params;
    fastcgi_pass nut-cgi:8081;  # 连接nut-cgi容器的8081端口
    fastcgi_param SCRIPT_FILENAME /usr/lib/$fastcgi_script_name;
}

3. 权限设置
   通过PUID和PGID环境变量设置与nginx运行用户一致的权限，避免文件访问权限问题。

4. 时区配置
   设置正确的TZ环境变量（如Asia/Shanghai），确保日志和时间显示准确。