Homelable: визуализация и мониторинг сети домашней лаборатории

Homelable: визуализация и мониторинг сети домашней лаборатории

Homelable — это инструмент для визуализации инфраструктуры домашней лаборатории с возможностью мониторинга в реальном времени. Он помогает отслеживать состояние сетевых устройств и документировать их.

Проект выделяется среди аналогичных решений своей самодостаточностью и интерактивностью. Homelable позволяет создавать диаграммы сети, а также предоставляет функции сканирования и отслеживания состояния устройств, что может быть полезно для администраторов домашних сетей и облачных разработчиков. Если у тебя много устройств и ты хочешь упорядочить информацию о них, этот инструмент как раз для тебя.

Разработка на TypeScript, установка возможна через Docker. Следует учитывать, что проект может быть ещё на ранней стадии, что может сказаться на функциональности. Если ты ищешь готовое решение для продакшна, возможно, стоит подождать следующих версий.

Homelable — это саморазворачиваемое решение для визуализации инфраструктуры, которое позволяет осуществлять мониторинг, документирование и сканирование твоей локальной сети. Проект предназначен для тех, кто управляет домашними лабораториями (homelab) и хочет иметь полное представление о своих устройствах и сервисах.

Основные возможности

  • Сканирование сети и выявление подключенных устройств, а также предоставление статуса в реальном времени.
  • Документация для каждого устройства, созданная на основе результатов сканирования.
  • Визуализация сетевой инфраструктуры и физической компоновки твоего оборудования (например, стоек и кабелей).
  • Интеграция с системами Zigbee и Z-Wave для отображения топологии сети.
  • Импорт данных из Proxmox для автоматического получения информации о виртуальных машинах и контейнерах.
  • Доступ к документам через публичный просмотр в реальном времени.
  • REST API для интеграции и автоматизации взаимодействия с системой.

Установка

Установить Homelable можно несколькими способами — через Docker, как LXC-контейнер в Proxmox, или на bare metal (без Docker). Вот основные команды для установки:

sudo bash scripts/install-baremetal.sh

Подробные инструкции находятся в файле INSTALLATION.md.

Как это работает

Homelable использует сканер сети для обнаружения устройств, который применяет команду nmap. Каждое устройство получает документ, где зафиксированы его идентификация и характеристики. Все устройства можно визуализировать на специальной панели, где ты можешь дополнительно создавать и редактировать документацию в формате markdown.

Кроме того, поддерживается интеграция с протоколами Zigbee и Z-Wave, что позволяет автоматически отображать устройства из этих сетей на диаграмме.

Ограничения

  • При запуске сканирования из Docker могут отсутствовать MAC-адреса подключенных устройств.
  • Некоторые типы сканирования требуют повышенных привилегий (root), особенно на macOS.
  • Функционал живого просмотра (Live View) и публичной документации должен быть активирован вручную и требует настройки секретных ключей.
  • API не защищен от несанкционированного доступа, поэтому рекомендуется держать Homelable в пределах локальной сети.

Поддержка

Проект активен на GitHub, и разработчики принимают issues от пользователей. Также доступна документация, где можно найти описания всех функций и API.

Получение местоположения твоих устройств, создание схем и поддержка в документации — это лишь некоторые из множества функций, которые предоставляет Homelable для управления твоей домашней лабораторией.

Радар проекта: 79 из 100 — зрелый и живой проект

ИмпульсТемпЗрелостьСообществоСвежестьСтартПродакшенДовериеДокументацияЭкосистема79
  • Импульс 62 ≈ 26 звёзд в день
  • Темп разработки 94 217 коммитов за 12 недель
  • Зрелость 81 проекту 8 месяцев, 56 релизов
  • Сообщество 63 27 участников, 220 форков
  • Свежесть 95 последний коммит — 8 дней назад
  • Быстрый старт 90 есть: команда установки, Docker, сайт/демо
  • Готовность к продакшену 80 релиз v3.6.0, автосборка
  • Безопасность и доверие 55 лицензия MIT
  • Документация 97 README 22.7 тыс. знаков, 50 разделов, папка docs
  • Экосистема 71 20 подписчиков на обновления, 9 тем
Как считаем

Только открытые данные GitHub на 07.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.

  • Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
  • Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
  • Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
  • Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
  • Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
  • Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
  • Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
  • Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
  • Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
  • Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.

Открыть на GitHub: Pouzor/homelable →

Что нового на GitHub — короткие обзоры на русском Новые обзоры приходят в Telegram. Без спама, по делу.
Подписаться

Похожие статьи

Популярные темы на сайте