Repolode
Enviar
Pouzor

Pouzor/homelable

Visualizador self-hosted de homelab que mapeia dispositivos, escaneia a rede, importa Zigbee, Z-Wave e Proxmox e monitora o status em tempo real.

Alternativa open source a:Lucidchartdraw.io

Ver no GitHubSite
Estrelas
4,509
Forks
204
Issues abertas
34
Último commit
há 5 dias

O que é?

Homelable é uma ferramenta self-hosted para desenhar e documentar um homelab. Ela executa uma varredura de rede baseada em nmap, que coloca máquinas e serviços descobertos em uma fila de aprovação. Depois, eles podem ser aprovados e adicionados a uma tela interativa. Também é possível importar a topologia dos dispositivos do Zigbee2MQTT e do Z-Wave JS UI via MQTT, além do inventário do Proxmox VE pela API REST.

É possível verificar o status de cada nó na tela usando ping, HTTP/HTTPS, TCP, SSH, métricas do Prometheus ou um endpoint /health, com os resultados exibidos em tempo real no diagrama. Além do mapa de rede, o projeto inclui uma tela de rack para posicionar dispositivos em unidades U e conectar portas, além de um espaço de documentação em Markdown, onde cada dispositivo recebe um documento gerado automaticamente junto das páginas escritas pelos usuários.

O app oferece uma API REST com documentação Swagger, uma Live View somente para leitura e uma visualização da documentação protegidas por chaves, um endpoint de estatísticas para o gethomepage e um servidor MCP para que assistentes de IA possam ler e modificar a topologia.

Recursos principais

  • 01Varredura de rede com nmap que coloca os dispositivos descobertos em uma fila de aprovação
  • 02Verificação do status de cada nó em tempo real via ping, HTTP, TCP, SSH, Prometheus ou /health
  • 03Importação do Zigbee2MQTT e do Z-Wave JS UI via MQTT
  • 04Importação de hosts, VMs e contêineres LXC do Proxmox VE
  • 05Tela de rack com posicionamento por altura em U e conexão entre portas
  • 06Espaço de documentação em Markdown com histórico de versões e documentos dos dispositivos
  • 07API REST com Swagger UI e servidor MCP para assistentes de IA

Casos de uso

  • Mapear máquinas, switches e serviços de um homelab em um único diagrama
  • Monitorar em um dashboard quais serviços self-hosted estão online
  • Acompanhar o layout físico do rack e o cabeamento de uma pequena sala de servidores
  • Importar dispositivos Zigbee e Z-Wave de uma casa inteligente para o mesmo mapa de rede

Início rápido

  1. 1

    Instale com Docker usando as imagens pré-compiladas do GHCR (consulte INSTALLATION.md).

  2. 2

    Ou instale diretamente em um host Debian/Ubuntu com o script incluído.

    sudo bash scripts/install-baremetal.sh

Antes de usar

  • O scanner não informa endereços MAC quando o backend é executado em uma rede bridge do Docker.
  • Alguns tipos de varredura do nmap, como a varredura SYN e a detecção de sistema operacional, exigem privilégios de root.
  • A importação de Zigbee e Z-Wave requer um broker MQTT separado em execução.

Em coleções

Apps auto-hospedados

Tópicos

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

Perguntas frequentes

O que é homelable?
Visualizador self-hosted de homelab que mapeia dispositivos, escaneia a rede, importa Zigbee, Z-Wave e Proxmox e monitora o status em tempo real. Homelable é uma ferramenta self-hosted para desenhar e documentar um homelab. Ela executa uma varredura de rede baseada em nmap, que coloca máquinas e serviços descobertos em uma fila de aprovação. Depois, eles podem ser aprovados e adicionados a uma tela interativa. Também é possível importar a topologia dos dispositivos do Zigbee2MQTT e do Z-Wave JS UI via MQTT, além do inventário do Proxmox VE pela API REST.
homelable é gratuito? Qual é a licença?
homelable é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
homelable ainda é mantido?
Manutenção ativa. O último commit de homelable foi em 19 de out. de 2026.
Para que posso usar homelable?
Mapear máquinas, switches e serviços de um homelab em um único diagrama Monitorar em um dashboard quais serviços self-hosted estão online Acompanhar o layout físico do rack e o cabeamento de uma pequena sala de servidores Importar dispositivos Zigbee e Z-Wave de uma casa inteligente para o mesmo mapa de rede
Como instalar homelable?
Instale com Docker usando as imagens pré-compiladas do GHCR (consulte INSTALLATION.md). Ou instale diretamente em um host Debian/Ubuntu com o script incluído.: sudo bash scripts/install-baremetal.sh
Onde consigo homelable?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Pouzor/homelable

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados