Repolode
Enviar
Pouzor

Pouzor/homelable

Visualizador self-hosted para homelabs que mapea dispositivos, escanea la red, importa datos de Zigbee, Z-Wave y Proxmox, y supervisa su estado en tiempo real.

Alternativa open source a:Lucidchartdraw.io

Ver en GitHubSitio web
Estrellas
4,509
Forks
204
Issues abiertos
34
Último commit
hace 5 días

¿Qué es?

Homelable es una herramienta self-hosted para dibujar y documentar un homelab. Realiza un escaneo de red basado en nmap que coloca las máquinas y los servicios detectados en una cola de pendientes, desde la que se pueden aprobar e incorporar a un lienzo interactivo. También puede importar la topología de dispositivos de Zigbee2MQTT y Z-Wave JS UI mediante MQTT, así como el inventario de Proxmox VE a través de su REST API.

Se puede comprobar el estado de cada nodo del lienzo mediante ping, HTTP/HTTPS, TCP, SSH, métricas de Prometheus o un endpoint /health; los resultados se muestran en tiempo real en el diagrama. Además del mapa de red, el proyecto incluye un lienzo de rack para montar dispositivos en posiciones U y conectar puertos, y un espacio de documentación en Markdown donde cada dispositivo cuenta con un documento generado, junto a las páginas escritas por los usuarios.

La aplicación ofrece una REST API con documentación de Swagger, una vista Live View de solo lectura y una vista de documentación protegidas por claves, un endpoint de estadísticas para gethomepage y un servidor MCP para que los asistentes de IA puedan leer y modificar la topología.

Funciones clave

  • 01Escaneo de red con nmap que pone los dispositivos detectados en una cola para su aprobación
  • 02Comprobaciones del estado de cada nodo en tiempo real mediante ping, HTTP, TCP, SSH, Prometheus o /health
  • 03Importación de Zigbee2MQTT y Z-Wave JS UI mediante MQTT
  • 04Importación desde Proxmox VE de hosts, máquinas virtuales y contenedores LXC
  • 05Lienzo de rack con montaje en posiciones de altura U y conexión entre puertos
  • 06Espacio de documentación en Markdown con historial de versiones y documentos de dispositivos
  • 07REST API con Swagger UI y un servidor MCP para asistentes de IA

Casos de uso

  • Mapear las máquinas, los switches y los servicios de un homelab en un solo diagrama
  • Supervisar desde un dashboard qué servicios self-hosted están en línea
  • Llevar un registro de la distribución física del rack y del cableado de una pequeña sala de servidores
  • Importar dispositivos domésticos inteligentes Zigbee y Z-Wave al mismo mapa de red

Inicio rápido

  1. 1

    Instala con Docker usando las imágenes de GHCR ya compiladas (consulta INSTALLATION.md).

  2. 2

    O instala directamente en un host Debian/Ubuntu con el script incluido.

    sudo bash scripts/install-baremetal.sh

Antes de usarlo

  • El escáner no informa de direcciones MAC cuando el backend se ejecuta en una red puente de Docker.
  • Algunos tipos de escaneo de nmap, como el escaneo SYN y la detección del sistema operativo, requieren privilegios de root.
  • Para importar Zigbee y Z-Wave se necesita un broker MQTT independiente en ejecución.

En colecciones

Apps autoalojadas

Temas

#homelab#network-diagram#self-hosted#monitoring#network-scanner#proxmox#zigbee#mqtt#diagram#homelab-infrastructure-observability

Preguntas frecuentes

¿Qué es homelable?
Visualizador self-hosted para homelabs que mapea dispositivos, escanea la red, importa datos de Zigbee, Z-Wave y Proxmox, y supervisa su estado en tiempo real. Homelable es una herramienta self-hosted para dibujar y documentar un homelab. Realiza un escaneo de red basado en nmap que coloca las máquinas y los servicios detectados en una cola de pendientes, desde la que se pueden aprobar e incorporar a un lienzo interactivo. También puede importar la topología de dispositivos de Zigbee2MQTT y Z-Wave JS UI mediante MQTT, así como el inventario de Proxmox VE a través de su REST API.
¿homelable es gratuito? ¿Qué licencia tiene?
homelable es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿homelable sigue mantenido?
Mantenimiento activo. El último commit de homelable fue el 19 oct 2026.
¿Para qué puedo usar homelable?
Mapear las máquinas, los switches y los servicios de un homelab en un solo diagrama Supervisar desde un dashboard qué servicios self-hosted están en línea Llevar un registro de la distribución física del rack y del cableado de una pequeña sala de servidores Importar dispositivos domésticos inteligentes Zigbee y Z-Wave al mismo mapa de red
¿Cómo se instala homelable?
Instala con Docker usando las imágenes de GHCR ya compiladas (consulta INSTALLATION.md). O instala directamente en un host Debian/Ubuntu con el script incluido.: sudo bash scripts/install-baremetal.sh
¿Dónde consigo homelable?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Pouzor/homelable

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados