Guardian
Guardian es un panel de control auto-alojado y ultraligero para homelabs con Docker. Proporciona telemetría del host, salud de contenedores y lanzador de aplicaciones en una sola interfaz React/Node.js.
Ficha actualizada 22 sept 2026, 15:37 · upstream 22 sept 2026, 11:26 · release v1.0.0
Qué es Guardian
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Guardian es un panel de control auto-alojado diseñado específicamente para entornos de homelab con Docker. Su arquitectura ultraligera elimina la necesidad de bases de datos o agentes externos, funcionando con menos de 40 MB de RAM y utilizando Server-Sent Events (SSE) para actualizaciones en tiempo real sin polling constante. El sistema lee directamente el kernel del host a través de /proc y /sys para métricas como uso de CPU, memoria, temperatura y estado de discos S.M.A.R.T., mientras consulta el socket Docker para la salud de los contenedores.
La interfaz incluye un lanzador de aplicaciones que descubre automáticamente los contenedores activos, permitiendo iniciar servicios con widgets en tiempo real y soporte para múltiples redes (LAN, Tailscale). Además, gestiona historial de métricas tiered almacenado localmente, permitiendo análisis de tendencias a largo plazo sin sobrecargar la memoria.
El panel ofrece herramientas de mantenimiento como limpieza de imágenes huérfanas, visualización de logs estructurados y control de energía (apagado/reinicio) cuando se habilita mediante variables de entorno. Su diseño modular permite despliegues flexibles en diferentes distribuciones Linux, siempre que se configuren correctamente los montajes del sistema de archivos del host.
- Monitorización integral de homelab con telemetría del host y contenedores
- Dashboard unificado para gestión de recursos (CPU, RAM, temperatura)
- Lanzador de aplicaciones con widgets en tiempo real para servicios como Jellyfin
- Historial de métricas persistente para análisis de tendencias a 30 días
- Control de energía para reinicio o apagado del servidor físico
- Auditoría de salud de endpoints HTTP y detección de fallos en contenedores
- Consumo mínimo de memoria (<40 MB RAM) ideal para hardware limitado
- Arquitectura sin base de datos, todo persistido en archivos JSON locales
- Telemetría en tiempo real mediante Server-Sent Events (SSE)
- Streaming de estadísticas de contenedores con bajo overhead de red
- Soporte nativo para múltiples sistemas de archivos y montajes NAS
- Historial de métricas tiered optimizado para almacenamiento local
- Requiere acceso directo al socket Docker y montajes del host (/proc, /sys)
- No funciona en entornos sin acceso al kernel (sin /proc o /sys)
- Control de energía desactivado por defecto por seguridad
- Configuración inicial manual de rutas de host si no se usan los valores predeterminados
- Dependencia de la persistencia de datos en un volumen específico para historial y logs
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Utilizar docker-compose con montajes read-only (/host/) para evitar corrupción del sistema. Persistir el volumen guardian_data para mantener historial y configuración. Ajustar límites de recursos (memory, cpus) según la capacidad del host. Verificar rutas de host antes de iniciar si se usa un contenedor anidado o paths personalizados.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.