Brandawg93/PeaNUT

这是什么？

核心功能

• 01通过 NUT 监控网络中的多台 UPS，查看实时状态和统计数据
• 02在界面中对 UPS 执行命令并修改可写参数
• 03提供 REST API 和 WebSocket 接口，便于与其他工具集成
• 04支持 Prometheus 指标和 InfluxDB v2，可接入 Grafana 仪表盘
• 05为 Homepage 和 Glance 仪表盘提供组件
• 06单用户认证，密码使用 bcrypt 加密存储

适用场景

• 在浏览器中查看家庭或办公室 UPS 的电量、剩余供电时间和负载
• 将 UPS 指标接入已有的 Prometheus 或 Grafana 监控体系
• 在自托管的 Homepage 或 Glance 首页上显示 UPS 状态
• 部署在树莓派 4 或其他 arm64 主机上，靠近 NAS 或服务器机柜运行

快速上手

1. 1

   使用 Docker 运行 PeaNUT 容器

   docker run -v ${PWD}/config:/config -p 8080:8080 --restart unless-stopped --env WEB_PORT=8080 brandawg93/peanut
2. 2

   在浏览器中打开 localhost:8080 访问仪表板

使用前须知

• !需要已配置 UPS 设备的 NUT 服务器才能监控。
• !自 5.17.0 版本起不再支持 Raspberry Pi 3 及更老型号（arm/v7）。

收录于专题

标签

常见问题

PeaNUT 是什么？

基于 Network UPS Tools (NUT) 的轻量级 UPS 监控仪表盘。 PeaNUT 是一个 Web 仪表盘，用于展示通过 NUT 服务器接入的 UPS（不间断电源）设备的状态和实时数据。支持同时查看多台 UPS，对设备执行命令、修改可写参数，并可通过终端直接访问 NUT 服务器。

PeaNUT 可以免费使用吗？用的什么许可证？

PeaNUT 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

PeaNUT 还在维护吗？

活跃维护中。PeaNUT 最近一次提交是在 2026年11月1日。

PeaNUT 适合用来做什么？

在浏览器中查看家庭或办公室 UPS 的电量、剩余供电时间和负载 将 UPS 指标接入已有的 Prometheus 或 Grafana 监控体系 在自托管的 Homepage 或 Glance 首页上显示 UPS 状态 部署在树莓派 4 或其他 arm64 主机上，靠近 NAS 或服务器机柜运行

PeaNUT 怎么安装和运行？

使用 Docker 运行 PeaNUT 容器: docker run -v ${PWD}/config:/config -p 8080:8080 --restart unless-stopped --env WEB_PORT=8080 brandawg93/peanut 在浏览器中打开 localhost:8080 访问仪表板

在哪里获取 PeaNUT？

源代码和安装说明在 GitHub 上：https://github.com/Brandawg93/PeaNUT