PeaNUT：高效自托管UPS监控仪表盘，实时追踪电池电量负载状态与运行时间，支持多设备管理和NUT协议集成

随着飞牛品牌推出UPS产品，当前使用不间断电源的NAS爱好者群体正在迅速扩大。不间断电源（UPS）作为保障电子设备稳定供电的核心组件，用户往往需要实时掌握其运行状态，例如电池剩余电量、当前负载水平或整体工作状况。

一、PeaNUT概述：自托管UPS监控工具简介

PeaNUT是一款专为监控和管理支持Network UPS Tools（NUT）协议的UPS设备而设计的轻量级自托管仪表盘应用。该工具通过直观的Web界面动态展示UPS的关键参数，包括电池充电状态、负载百分比和运行模式等核心信息，并具备多设备同步监控能力与简易配置流程。截至2025年4月，该项目在GitHub平台上已收获超过700个星标，在自托管技术社区中获得了广泛认可与使用。

推荐用户通过Docker容器化方式部署PeaNUT（执行命令docker pull brandawg93/peanut:latest），仅需简单配置即可在NAS设备上快速运行。应用通过NUT协议与UPS硬件建立通信连接，用户需要提供NUT服务器的IP地址与端口号（默认值为3493）。配置过程主要依托Web管理界面完成，同时也支持直接编辑YAML配置文件（路径为/config/settings.yml）。此外，PeaNUT还集成用户身份验证、终端命令交互和多语言界面支持（依托Crowdin翻译平台），成为自托管环境下UPS监控管理的理想解决方案。

二、PeaNUT核心功能与优势解析

1. 直观易用的监控仪表盘

PeaNUT的Web界面采用简洁明了的设计风格，基于Next.js框架与TailwindCSS样式库构建，具备响应式布局特性，完美适配个人电脑与移动设备屏幕。仪表盘实时呈现UPS设备的核心运行数据，具体包含以下内容：

• 电池剩余电量（对应参数battery.charge，以百分比形式显示）
• 电池预估运行时间（对应参数battery.runtime）
• UPS当前负载水平（对应参数ups.load，以百分比数值呈现）
• 设备运行状态（对应参数ups.status，例如“在线运行”、“电池供电”、“低电量警告”等状态）
  关键数据通过Chart.js图表库进行可视化展示，并从v4.0.0版本开始优化多设备并行监控功能。用户可以快速评估设备健康状态，界面响应迅速（实测启动时间仅需39毫秒）。

2. 灵活简便的部署方案

PeaNUT支持基于Docker的容器化部署模式，配置文件结构清晰易懂：

services:  
  peanut:  
    image:brandawg93/peanut:latest  
    container_name:PeaNUT  
    ports:  
      -8080:8080  
    environment:  
      -NUT_HOST=192.168.31.40  
      -NUT_PORT=3493  
      -WEB_PORT=8080  
    volumes:  
      - /path/to/config:/config

3. 多设备支持与终端交互功能

PeaNUT支持监控同一NUT服务器下的多个UPS设备（自v4.0.0版本起），每个设备的监测数据独立显示在界面中。最新v5.5.0版本新增了自定义终端功能，用户可以直接通过Web界面与NUT服务器进行命令交互，执行设备调试或状态查询操作（对应GitHub议题#192）。这一特性对于需要进行深度故障诊断的技术用户尤为实用。

4. 用户认证与安全防护机制

PeaNUT提供可选的用户认证功能，通过设置环境变量WEB_USERNAME和WEB_PASSWORD启用登录保护机制。API接口调用需要包含Base64编码的认证凭据（格式为用户名:密码），有效防止未授权访问。配置数据持久化存储在容器的/config/settings.yml文件中，支持卷挂载方式确保数据安全不丢失。

5. 广泛兼容性与社区生态支持

PeaNUT兼容多种主流UPS品牌与型号，官方Wiki文档列出了经过测试的设备清单，包括APC Back-UPS系列、CPS LX1325GU型号、Eaton Ellipse Eco 800等（对应GitHub议题#7）。用户可以通过提交带tested device标签的Issue补充兼容设备信息，社区维护的兼容列表持续更新完善。项目还整合Crowdin翻译平台，支持多语言界面显示，方便全球不同地区用户使用。

6. 与Homepage仪表盘集成能力

PeaNUT支持通过customapi组件与Homepage仪表盘进行深度集成，允许用户自定义数据显示字段。示例配置如下：

widget:  
  type:customapi  
url:http://{HOSTNAME}:{PORT}/api/v1/devices/ups  
mappings:  
    -field:battery.charge  
      label:BatteryCharge  
      format:percent  
    -field:ups.status  
      label:UPSStatus  
      format:text  
      remap:  
        -value:OL  
          to: Online

这种集成方式使得PeaNUT能够无缝融入用户现有的自托管应用生态系统。

三、PeaNUT总结与未来发展展望

PeaNUT凭借其轻量级架构、易用性设计和专业专注的特性，成为基于NUT协议的UPS监控领域的优选工具。它不仅提供直观的数据展示界面和多设备管理功能，还通过终端交互、用户认证和Homepage集成等特性显著提升实用价值。无论是自托管技术爱好者还是小型办公环境用户，PeaNUT都能让UPS设备管理变得更加简单高效。

如果对PeaNUT感兴趣，可以尝试使用Docker Compose进行快速部署（执行命令docker-compose up -d），或访问官方Wiki页面（https://github.com/Brandawg93/PeaNUT/wiki）查阅完整兼容设备列表。希望支持项目发展？提交功能建议、测试新型号UPS设备或参与Crowdin翻译工作都是有效的贡献方式。PeaNUT的维护者@Brandawg93持续进行版本更新（最新v5.5.0修复了认证相关缺陷，对应GitHub议题#195），未来版本可能加入消息通知集成或更丰富的数据可视化功能。

立即部署PeaNUT工具吧！让UPS设备运行状态尽在掌握，为关键设备提供更全面的电力保障！