brandawg93/peanut

Network UPS Tools 轻量级仪表盘镜像

镜像概述与主要用途

本镜像是一个专为Network UPS Tools (NUT) 设计的轻量级Web仪表盘，提供UPS（不间断电源）状态的可视化监控功能。它能够与NUT服务器无缝集成，通过简洁直观的界面实时展示UPS运行状态、电池信息、负载情况等关键指标，帮助用户快速掌握UPS设备的运行状况。

核心功能与特性

• 轻量级设计：资源占用低，适合在嵌入式设备、小型服务器等资源受限环境部署
• 实时监控：实时显示UPS核心状态，包括电源状态（在线/离线）、电池电量、负载百分比、输入/输出电压等
• 简洁界面：直观的Web用户界面，关键信息一目了然，无需复杂操作
• 易于部署：基于Docker容器化设计，部署流程简单，配置步骤少
• NUT兼容：全面支持Network UPS Tools协议，可与主流NUT服务器版本适配

使用场景与适用范围

• 个人用户：家庭服务器、网络设备UPS状态监控
• 小型企业：办公环境或小型机房的UPS集中监控
• IT运维：服务器机房UPS状态实时跟踪，及时发现电源异常
• NUT用户：为已部署NUT系统的环境提供可视化补充，替代命令行监控方式

部署与使用方法

前提条件

• 已部署并运行Network UPS Tools (NUT) 服务器
• NUT服务器已配置允许网络访问（默认端口3493）
• 部署环境已安装Docker引擎或Docker Compose

Docker Run 快速部署

bash
docker run -d \
  --name nut-dashboard \
  -p 8080:8080 \
  -e NUT_HOST=192.168.1.10 \  # 替换为NUT服务器IP或主机名
  -e NUT_PORT=3493 \          # NUT服务器端口，默认3493
  -e NUT_USER=admin \         # NUT认证用户名（如启用）
  -e NUT_PASSWORD=secret \    # NUT认证密码（如启用）
  --restart unless-stopped \
  nut-dashboard-image:latest  # 替换为实际镜像名称

Docker Compose 配置示例

yaml
version: '3.8'

services:
  nut-dashboard:
    image: docker.xuanyuan.run/nut-dashboard-image:latest  # 替换为实际镜像名称
    container_name: nut-dashboard
    ports:
      - "8080:8080"  # 宿主机端口:容器端口
    environment:
      - NUT_HOST=nut-server  # NUT服务器IP或主机名（建议使用容器网络别名）
      - NUT_PORT=3493
      - NUT_USER=upsmon      # NUT监控用户
      - NUT_PASSWORD=upsmonpass  # NUT用户密码
      - REFRESH_INTERVAL=10  # 数据刷新间隔（秒），默认5秒
      - WEB_PORT=8080        # 容器内Web服务端口
    restart: unless-stopped
    networks:
      - nut-network  # 建议与NUT服务器加入同一网络以使用容器名称通信

networks:
  nut-network:
    driver: bridge

环境变量配置说明

访问与使用

1. 部署完成后，通过浏览器访问 http://<宿主机IP>:<映射端口>（如 http://192.168.1.20:8080）
2. 首次访问即可看到UPS状态概览页面，包含以下核心信息：
   • UPS当前状态（在线/电池供电/旁路等）
   • 电池剩余电量百分比
   • 负载百分比
   • 电池预计续航时间
   • 输入/输出电压与频率

配置注意事项

• NUT服务器配置：需确保NUT服务器的upsd.conf中允许仪表盘容器的IP访问，或配置LISTEN 0.0.0.0 3493允许所有IP访问（生产环境建议限制来源IP）
• 认证配置：若NUT服务器启用认证（upsd.users中配置用户），必须正确设置NUT_USER和NUT_PASSWORD环境变量
• 网络连通性：容器与NUT服务器之间需保证网络通畅，可通过docker exec -it nut-dashboard ping <NUT_HOST>测试连通性
• 端口冲突：若宿主机8080端口已被占用，可通过-p <自定义端口>:8080映射至其他端口

常见问题解决

• 无法连接NUT服务器：检查NUT_HOST和NUT_PORT配置是否正确，验证NUT服务器是否正常运行，网络访问是否受限
• 数据不刷新：检查REFRESH_INTERVAL配置，确认浏览器未阻止页面自动刷新
• 认证失败：验证NUT_USER和NUT_PASSWORD是否与NUT服务器配置一致，可通过upsc -l <NUT_HOST>命令测试NUT服务器认证