Repolode
Предложить
Pouzor

Pouzor/homelable

Самостоятельно размещаемый визуализатор homelab: отображает устройства, сканирует сеть, импортирует данные из Zigbee, Z-Wave и Proxmox и показывает текущий статус.

Open source альтернатива:Lucidchartdraw.io

Открыть на GitHubСайт
Звёзды
4,509
Форки
204
Открытые issues
34
Последний коммит
5 дней назад

Что это?

Homelable — это самостоятельно размещаемый инструмент для создания схемы homelab и ведения документации. Он сканирует сеть с помощью nmap и добавляет найденные устройства и сервисы в очередь на проверку: после подтверждения их можно разместить на интерактивном холсте. Также приложение умеет импортировать топологию устройств из Zigbee2MQTT и Z-Wave JS UI через MQTT, а инвентарные данные — из Proxmox VE через REST API.

Для каждого узла на холсте можно проверять доступность с помощью ping, HTTP/HTTPS, TCP, SSH, метрик Prometheus или эндпоинта /health; результаты в реальном времени отображаются на схеме. Помимо карты сети, в проекте есть холст стойки для размещения устройств по U-позициям и соединения портов патч-кордами, а также пространство для документации в Markdown: для каждого устройства автоматически создаётся документ, наряду со страницами, написанными пользователями.

Приложение предоставляет REST API с документацией Swagger, доступные только для чтения Live View и представление документации, защищённые ключами, эндпоинт статистики для gethomepage и MCP-сервер, через который AI-ассистенты могут читать и изменять топологию.

Ключевые возможности

  • 01Сканирование сети с помощью nmap и добавление найденных устройств в очередь на подтверждение
  • 02Проверка статуса каждого узла в реальном времени через ping, HTTP, TCP, SSH, Prometheus или /health
  • 03Импорт данных из Zigbee2MQTT и Z-Wave JS UI через MQTT
  • 04Импорт хостов, виртуальных машин и контейнеров LXC из Proxmox VE
  • 05Холст стойки с размещением устройств по высоте в U и соединением портов патч-кордами
  • 06Пространство документации в Markdown с историей версий и документами устройств
  • 07REST API с Swagger UI и MCP-сервер для AI-ассистентов

Сценарии использования

  • Отображение машин, коммутаторов и сервисов домашней лаборатории на одной схеме
  • Мониторинг доступности самостоятельно размещённых сервисов с помощью панели управления
  • Учёт физического расположения оборудования и кабельных соединений в небольшой серверной
  • Импорт устройств умного дома Zigbee и Z-Wave на общую карту сети

Быстрый старт

  1. 1

    Установите с помощью Docker, используя готовые образы GHCR (см. INSTALLATION.md).

  2. 2

    Или установите напрямую на хост Debian/Ubuntu с помощью включённого скрипта.

    sudo bash scripts/install-baremetal.sh

Что важно знать

  • Сканер не сообщает MAC-адреса, если бэкенд работает в мостовой сети Docker.
  • Для некоторых типов сканирования nmap, таких как SYN-сканирование и определение ОС, требуются права root.
  • Для импорта Zigbee и Z-Wave требуется отдельный работающий брокер MQTT.

В подборках

Самостоятельно размещаемые приложения

Темы

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

Частые вопросы

Что такое homelable?
Самостоятельно размещаемый визуализатор homelab: отображает устройства, сканирует сеть, импортирует данные из Zigbee, Z-Wave и Proxmox и показывает текущий статус. Homelable — это самостоятельно размещаемый инструмент для создания схемы homelab и ведения документации. Он сканирует сеть с помощью nmap и добавляет найденные устройства и сервисы в очередь на проверку: после подтверждения их можно разместить на интерактивном холсте. Также приложение умеет импортировать топологию устройств из Zigbee2MQTT и Z-Wave JS UI через MQTT, а инвентарные данные — из Proxmox VE через REST API.
homelable можно использовать бесплатно? Какая у него лицензия?
homelable распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
homelable всё ещё поддерживается?
Активно поддерживается. Последний коммит в homelable — 19 окт. 2026 г..
Для чего можно использовать homelable?
Отображение машин, коммутаторов и сервисов домашней лаборатории на одной схеме Мониторинг доступности самостоятельно размещённых сервисов с помощью панели управления Учёт физического расположения оборудования и кабельных соединений в небольшой серверной Импорт устройств умного дома Zigbee и Z-Wave на общую карту сети
Как установить homelable?
Установите с помощью Docker, используя готовые образы GHCR (см. INSTALLATION.md). Или установите напрямую на хост Debian/Ubuntu с помощью включённого скрипта.: sudo bash scripts/install-baremetal.sh
Где скачать homelable?
Исходный код и инструкции по установке — на GitHub: https://github.com/Pouzor/homelable

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты