El servicio se despliega mediante una instancia de Docker, permitiendo una integración directa con el socket de Docker para monitorizar otros contenedores.
| Atributo | Detalle |
|---|---|
| Contenedor | homepage |
| Ruta en Host | /opt/docker/homepage |
| Imagen | ghcr.io/gethomepage/homepage:latest |
| Estado | Privado (Protegido por red local/VPN) |
Para garantizar que el panel esté disponible tanto dentro como fuera del hogar de forma segura, se utiliza una URL personalizada bajo el dominio del proyecto.
Enlace de Acceso: https://noc00.recunchobit.site (El acceso requiere validación previa o conexión mediante túnel seguro).
La visibilidad del NOC00 no es directa; depende de una coreografía técnica entre tres componentes clave:
Es el único punto de entrada desde internet. Cuando realizas una petición a la URL externa:
Gestión SSL: Nginx recibe la petición y aplica el certificado de seguridad para cifrar la comunicación.
Redirección Interna: Actúa como puente, enviando el tráfico desde el puerto público (443) hacia el puerto interno de Docker donde corre homepage (puerto 3000).
Aislamiento: Oculta la dirección IP real y los puertos internos del nodo Atlas.
Mientras Nginx gestiona quién entra desde fuera, Pi-hole gestiona la resolución dentro de la red local:
DNS Local: Permite que, al escribir la URL dentro de casa, el tráfico no salga a internet para volver a entrar, sino que se resuelva directamente hacia la IP del servidor (Split-DNS).
Limpieza de Interfaz: Filtra posibles rastreadores de los widgets del dashboard, manteniendo la interfaz limpia y optimizando el tiempo de carga.
Es el contenedor final que recibe la petición procesada por Nginx. Su función es leer los archivos YAML en /opt/docker/homepage/config/ y presentar la información consolidada del resto de los 20 contenedores.
La configuración del dashboard es totalmente declarativa y se gestiona mediante archivos YAML situados en la carpeta de configuración del host.
/opt/docker/homepage/config/:services.yaml: Definición de los servicios mostrados y sus widgets de estado.
widgets.yaml: Configuración de información del sistema (CPU, RAM, Temperatura del N150).
bookmarks.yaml: Enlaces rápidos a utilidades externas.
docker.yaml: Configuración del acceso al socket para lectura de estados.
El NOC00 está diseñado para comunicarse con el resto de la infraestructura:
Docker API: Muestra estadísticas de CPU/RAM de cada contenedor de forma individual.
Monitorización: Integración de widgets de Uptime Kuma para ver el tiempo de actividad de un vistazo.
Sistema: Lectura directa de las métricas del kernel de Debian 13 para supervisar el Nodo Atlas.
Nota de Seguridad: Este dashboard contiene rutas y accesos a herramientas sensibles como Nginx Proxy Manager y Zabbix entre otros. Es accesible mediante una capa de autenticación adicional.
La implementación del NOC00 en el ecosistema RecunchoBit no se limita a un simple lanzador de enlaces; funciona como una capa de agregación de datos que unifica la gestión del Nodo Atlas. El sistema se basa en tres pilares técnicos: la monitorización del ciclo de vida de los contenedores, la extracción de métricas mediante APIs REST y una configuración totalmente declarativa.
El corazón de la monitorización reside en la comunicación directa con el socket de Docker del host (/var/run/docker.sock). Para que el dashboard sea "consciente" del estado del hardware, se ha implementado un acceso de solo lectura que permite a la interfaz obtener métricas de CPU y memoria en tiempo real.
Un aspecto crítico de este montaje es la gestión de permisos. Debido a que el socket de Docker en Debian está restringido por seguridad, el contenedor del dashboard se ha configurado para operar dentro del grupo de sistema correspondiente. Esta configuración evita errores de acceso (EACCES) y permite que el sistema muestre indicadores de salud ("Healthy") de forma nativa, relacionando cada widget con su proceso real en la infraestructura.
La visualización de datos específicos de aplicaciones se gestiona a través de widgets que realizan peticiones directas a las APIs de los servicios internos. Un hito importante en este despliegue es la transición a Pi-hole v6, que introduce una arquitectura API basada en estándares REST modernos.
A diferencia de versiones anteriores, la integración con la v6 requiere una autenticación basada en App Passwords. El NOC00 está configurado para comunicarse con el nuevo punto de enlace de la API, tratando a la aplicación como una entidad independiente que requiere credenciales de aplicación específicas. Esto permite visualizar métricas críticas como el volumen de consultas bloqueadas y el estado de la base de datos de filtrado (Gravity) de forma fluida y segura.
El acceso al dashboard está optimizado para funcionar bajo un esquema de Split-DNS. Mediante la combinación de Nginx Proxy Manager y Pi-hole, se ha logrado una experiencia de usuario transparente:
La resolución de nombres interna permite que, cuando se accede desde la red local, el tráfico no salga a internet, comunicándose directamente con la IP del Nodo Atlas. Para el acceso externo, Nginx actúa como terminador SSL, cifrando la comunicación y redirigiendo las peticiones al puerto interno del dashboard. Esta estructura garantiza que los enlaces (href) sean universales, funcionando exactamente igual tanto dentro como fuera de la red privada.
Nota Técnica: El sistema utiliza archivos YAML para definir su estructura, lo que permite una portabilidad total. Cualquier cambio en la infraestructura se refleja en el dashboard mediante un proceso de carga en caliente, minimizando el tiempo de inactividad de la monitorización.