RepoRadar 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 для управления твоей домашней лабораторией.
Открыть на GitHub: Pouzor/homelable →
