type
Post
status
Published
date
Oct 30, 2025
tags
Docker
Nas
category
插件
password
slug
summary
PeaNUT 是一款专为 网络不间断电源（UPS） 监控而设计的轻量级仪表板工具。它通过 Network UPS Tools (NUT) 提供关键 UPS 数据，让用户可以轻松查看 UPS 状态，并在必要时进行交互操作。PeaNUT 采用 Apache-2.0 开源许可证，支持 Docker 部署 或从源代码编译安装。
为什么选择 PeaNUT？
- 轻量简洁
- 小巧的 Web 仪表板，实时显示 UPS 状态。
- 不需要额外繁琐的安装和配置。
- 多平台兼容
- 可在 Linux 系统上部署。
- 支持 Docker 容器化部署，快速启动与管理。
- 集成 NUT
- 利用 Network UPS Tools 获取 UPS 数据。
- 支持多种 UPS 型号和协议。
- 交互式监控
- 实时查看电池电量、负载、输入输出电压等。
- 可通过界面执行 UPS 相关命令（如关机或重启操作）。
核心功能概览
功能 | 说明 |
实时 UPS 数据监控 | 电池状态、负载、电压、温度等关键参数 |
Web 仪表板 | 浏览器访问即可查看状态 |
Docker 部署 | 快速启动、轻松管理 |
配置文件映射 | 可将配置文件持久化 |
自动重启 | Docker 容器崩溃或重启后自动恢复 |
开源自由 | Apache-2.0 许可证，可自由使用和修改 |
<ins/>
快速启动指南
方法一：使用 Docker 部署
- 拉取并运行容器
打开终端，执行以下命令：
- 访问仪表板
- 打开浏览器，访问：
http://localhost:8080 - 查看 UPS 实时状态与参数。
方法二：使用 docker-compose.yml 部署
- 创建 docker-compose.yml 文件：
- 启动容器：
- 访问仪表板
打开浏览器访问：
http://localhost:8080，即可查看 UPS 数据。配置与实用技巧
- 持久化配置
- 将
/config映射到主机路径，保证容器重启后配置不丢失。
- 自定义端口
- 通过环境变量
WEB_PORT修改 Web 仪表板端口。
- 监控多个 UPS
- 配置 NUT 支持多 UPS，将所有 UPS 信息集中显示在 PeaNUT 仪表板。
- 与自动化脚本结合
- 可结合告警系统或脚本，实现 UPS 状态异常时自动通知或断电保护操作。
总结
PeaNUT 是一款 轻量、开源、易部署的 UPS 监控工具，特别适合希望快速查看 UPS 状态、实现远程管理的用户。通过 Docker 容器化部署，它可以快速启动、持续运行，并提供持久化配置和 Web 仪表板访问，让 UPS 管理变得直观、高效。
🔗 GitHub 项目地址：PeaNUT
<ins/>