Zapomnij o ręcznie aktualizowanych diagramach w Draw.io i wiecznym „czekaj, zaraz znajdę gdzie jest ten cholerny host” – Homelable samo ogarnie Twój homelab. Masz rozproszone notatki, stare schematy w PDF‑ach i w głowie miks: „tu Proxmox, tu LXC, tu Docker, a Zigbee gdzieś w HA”?
Homelable zbierze to w jedną, żywą mapę: hosty, VM‑ki, kontenery, routery, switche, Zigbee/Z‑Wave i IoT – wszystko na jednym interaktywnym diagramie, który aktualizuje się ze skanów sieci i status‑checków.
To projekt do wizualizacji i monitoringu infrastruktury homelabu, z funkcjami autodetekcji urządzeń w sieci i prostego rysowania topologii.
Co to jest Homelable?
- Homelable to „self-hosted homelab infrastructure visualizer” – aplikacja webowa do tworzenia interaktywnej mapy Twojej infrastruktury (routery, switche, serwery, Proxmox, VM‑ki, kontenery, IoT, Zigbee, Z‑Wave itp.).
- Projekt jest nastawiony na homelaby: skanuje sieci ZigBee Wave, LAN (nmap, ARP, mDNS/Bonjour) i potrafi rozpoznawać typowe urządzenia IoT (np. Shelly, Sonoff, Tapo, Philips Hue, ESP32), żeby od razu dodać je jako węzły na diagramie.
Do czego służy w praktyce?
- Tworzysz interaktywny diagram sieci/serwerów: każdy host to węzeł na canvasie, między nimi rysujesz powiązania (uplinki, VLANy, połączenia LXC/VM‑>Docker itp.), a aplikacja trzyma to jako żyjącą dokumentację homelabu.
- Ma live status‑checks – system okresowo sprawdza dostępność węzłów (ping/porty/API) i pokazuje ich stan na diagramie, więc widzisz od razu, co padło albo jest „unhealthy”.
Funkcje, które mogą Cię zainteresować
- Skanowanie sieci: nmap z dwufazowym skanem (ARP + porty) + nasłuch mDNS/Bonjour, z nakładką na IoT‑fingerprinting (MAC OUI, typowe porty, protokoły), co ułatwia automatyczne wciąganie smart‑urządzeń do topologii.
- Automatyczne modelowanie sieci Zigbee i Z‑Wave: wykryte urządzenia z tych sieci mogą być odwzorowane jako węzły z relacjami do koordynatora/bridga, co pozwala wizualnie ogarnąć mesh (np. routery Zigbee, end‑device’y) w kontekście reszty infrastruktury.
- Automatyczne modelowanie Proxmoxa: hosty Proxmox, VM‑ki, LXC oraz ich powiązania sieciowe mogą być przedstawione jako zagnieżdżone elementy, co ułatwia zrozumienie relacji „bare metal → hypervisor → VM/LXC → kontener/Docker”.
- Modelowanie „nested” infrastruktury poza Proxmoxem: kontenery Docker mogą być osadzone w VM, LXC albo fizycznych hostach; są też grupy/„zones” z możliwością zwijania, żeby ogarnąć większe setupy.
- Zaawansowana personalizacja wyglądu: edytor styli pozwala ustawić kolory, rozmiary, animacje i opacity dla typów węzłów (router, switch, serwer, Proxmox host, Zigbee/Z‑Wave device itd.) oraz krawędzi, z możliwością masowego zastosowania zmian do całego diagramu.
Sposoby uruchomienia
- Standalone/self‑hosted: jako kontener (Docker/LXC, ewentualnie obraz pod Proxmoxa), klasyczna aplikacja webowa z backendem i frontendem.
- Tryb „frontend only”: można używać samego frontendu, który zapisuje dane w localStorage przeglądarki – bez backendu i logowania.
- Integracja z Home Assistant: osobny projekt homelable-hacs integruje panel bezpośrednio z HA (panel w HA, auth HA, dystrybucja przez HACS), jeśli chcesz widzieć mapę homelabu w swoim dashboardzie HA.
Dla kogo to ma sens?
- Dla kogoś z rozbudowanym homelabem (kilka hostów, Proxmox, kontenery, IoT, Zigbee/Z‑Wave), kto chce mieć czytelną, żywą dokumentację infrastruktury zamiast ręcznie utrzymywanego diagramu w np. draw.io.
- Dla użytkowników Home Assistanta, którzy chcą zintegrować wizualizację homelabu z panelem automatyzacji i mieć szybki podgląd statusu urządzeń z poziomu tego samego środowiska.
🔗 Github: https://github.com/Pouzor/homelable
📚 Strona projektu: https://homelable.net
