Sistema web de monitoreo de UPS basado en Network UPS Tools (NUT), con estado en tiempo real, gráficos históricos, alertas e informes programados, desplegable mediante Docker.
Brandawg93/PeaNUT
Un panel web ligero para supervisar dispositivos UPS gestionados por Network UPS Tools (NUT).
- Estrellas
- 1,722
- Forks
- 51
- Issues abiertos
- 26
- Último commit
- hace 5 días
¿Qué es?
PeaNUT es un panel web que muestra el estado y las estadísticas en tiempo real de dispositivos UPS (sistemas de alimentación ininterrumpida) expuestos por un servidor NUT. Permite consultar varias unidades UPS, ejecutar comandos y cambiar ajustes modificables, además de acceder al servidor NUT desde una terminal.
Además del panel integrado, PeaNUT ofrece una API REST y un endpoint WebSocket, así como métricas de Prometheus e integración con InfluxDB v2 para Grafana. También incluye widgets para los paneles Homepage y Glance. La configuración se realiza principalmente desde la interfaz web, con la opción de usar un archivo YAML, y se ejecuta como contenedor Docker en linux/amd64 y linux/arm64 (Raspberry Pi 4 o posterior).
La autenticación es para un solo usuario y usa contraseñas cifradas con bcrypt. Se puede configurar automáticamente mediante variables de entorno o desactivar por completo.
Funciones clave
- 01Supervisa varios dispositivos UPS de la red a través de NUT, con estado y estadísticas en tiempo real
- 02Ejecuta comandos y modifica variables editables de los dispositivos UPS desde la interfaz
- 03Ofrece una API REST y un endpoint WebSocket para integrarse con otras herramientas
- 04Proporciona métricas de Prometheus y compatibilidad con InfluxDB v2 para paneles de Grafana
- 05Incluye widgets para los paneles Homepage y Glance
- 06Ofrece autenticación para un solo usuario con contraseñas cifradas con bcrypt
Casos de uso
- Consultar desde el navegador la carga de la batería, la autonomía y el consumo de un UPS doméstico o de oficina
- Incorporar métricas de UPS a una infraestructura de monitorización existente con Prometheus o Grafana
- Mostrar el estado del UPS en una página de inicio autoalojada de Homepage o Glance
- Ejecutarlo en una Raspberry Pi 4 u otro equipo arm64 cerca de un NAS o un rack de servidores
Inicio rápido
- 1
Ejecuta el contenedor PeaNUT con Docker
docker run -v ${PWD}/config:/config -p 8080:8080 --restart unless-stopped --env WEB_PORT=8080 brandawg93/peanut - 2
Abre el panel en tu navegador en localhost:8080
Antes de usarlo
- Se requiere un servidor NUT con dispositivos UPS que supervisar.
- A partir de la versión 5.17.0, Raspberry Pi 3 y anteriores (arm/v7) ya no son compatibles.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es PeaNUT?
- Un panel web ligero para supervisar dispositivos UPS gestionados por Network UPS Tools (NUT). PeaNUT es un panel web que muestra el estado y las estadísticas en tiempo real de dispositivos UPS (sistemas de alimentación ininterrumpida) expuestos por un servidor NUT. Permite consultar varias unidades UPS, ejecutar comandos y cambiar ajustes modificables, además de acceder al servidor NUT desde una terminal.
- ¿PeaNUT es gratuito? ¿Qué licencia tiene?
- PeaNUT es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿PeaNUT sigue mantenido?
- Mantenimiento activo. El último commit de PeaNUT fue el 1 nov 2026.
- ¿Para qué puedo usar PeaNUT?
- Consultar desde el navegador la carga de la batería, la autonomía y el consumo de un UPS doméstico o de oficina Incorporar métricas de UPS a una infraestructura de monitorización existente con Prometheus o Grafana Mostrar el estado del UPS en una página de inicio autoalojada de Homepage o Glance Ejecutarlo en una Raspberry Pi 4 u otro equipo arm64 cerca de un NAS o un rack de servidores
- ¿Cómo se instala PeaNUT?
- Ejecuta el contenedor PeaNUT con Docker: docker run -v ${PWD}/config:/config -p 8080:8080 --restart unless-stopped --env WEB_PORT=8080 brandawg93/peanut Abre el panel en tu navegador en localhost:8080
- ¿Dónde consigo PeaNUT?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Brandawg93/PeaNUT
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Conjunto de dashboards personalizados de Grafana para visualizar datos de TeslaMate sobre viajes, carga, eficiencia, estado de la batería y kilometraje.
Una distribución de OpenTelemetry Collector con pipelines programables basados en expresiones para métricas, logs, trazas y perfiles, diseñada para integrarse con Prometheus.
Software autohospedado que ejecuta pruebas de velocidad de Internet programadas y conserva los resultados durante el periodo configurable que elijas.
Un exporter de Prometheus que recopila datos del conjunto *arr (Sonarr, Radarr, Lidarr, etc.) para supervisar y graficar su estado y rendimiento.
Crea y administra dashboards de Grafana y alertas preconfiguradas para servicios e infraestructura habituales, sin tener que escribir consultas a mano.