HomelabHero CLI
HomelabHero за одну команду превращает свежий LXC в центр управления домашней лабораторией с Claude Code и брокером доступов.
- 105 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент выполняет команды на реальных серверах и сетевом оборудовании.
- Установщик запускается от root через curl и bash.
Установка
- Работает в
Ручная установка
apt update && apt install -y curl && curl -fsSL https://raw.githubusercontent.com/serversathome/homelabhero/main/install.sh | bashКоманда из README для свежего Ubuntu 26.04 LXC. Установщик задает вопросы и подключает серверы.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет команды на реальных серверах и сетевом оборудовании.
- Установщик запускается от root через curl и bash.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
HomelabHero ставит на свежий контейнер Ubuntu 26.04 Claude Code, веб-интерфейс claudecodeui и набор скиллов с контекстом по диагностике. Агент работает с серверами TrueNAS, Proxmox, Linux и MikroTik по SSH только через команду `hh run <алиас> "<команда>"`. Пароли и ключи лежат в хранилище, к которому у пользователя агента нет доступа. Брокер через одно узкое правило sudoers находит узел, достает ключ, открывает соединение и отдает только вывод. Дополнительно команды `hh overview`, `hh inventory`, `hh scan` и `hh doctor` показывают состояние узлов, запущенные службы и найденные хосты. Четыре интеграции (UniFi, Firewalla, NetBird, Cloudflare) работают по своим API, первые две только на чтение.
Для кого. Владельцам домашних лабораторий на Proxmox, TrueNAS и MikroTik, которые хотят поручать агенту диагностику, не отдавая ему пароли.
Подходит, если
- Нужен обзор состояния всех серверов одной командой.
- Агенту надо зайти по SSH на несколько машин, не видя учетных данных.
- Требуется понять, что запущено на хостах: виртуальные машины, контейнеры, приложения.
- Нужно посмотреть клиентов, точки доступа и тревоги в UniFi или Firewalla без права изменений.
Не подходит, если
- ОС не Ubuntu или Debian: установщик использует `apt`, `systemd` и `visudo`.
- Контроль над доступами нужен на уровне организации с аудитом.
- Агента нельзя допускать к сетевому оборудованию совсем.
Пример запроса к агенту
Сделай обзор состояния всех зарегистрированных узлов через `hh overview` и покажи, где диск заполнен больше чем на 80 процентов.Ограничения
Установка идет скриптом `curl | bash` от root в новом LXC с Ubuntu 26.04: сначала прочитайте `install.sh`. Две интеграции, NetBird (с токеном администратора) и Cloudflare (с токеном на редактирование), могут менять настройки, опасные операции требуют `--force`. В документе `docs/security.md` перечислено, что не защищено моделью, например команды через `hh run` выполняются с правами заданной учетной записи. В репозитории не указана лицензия. Автообновление до версии 1.6.1 ломалось, запустите `hh update` вручную.
Как отключить. Следуйте разделу об удалении в `docs/layout.md`: остановите службы, удалите пользователей и хранилище, которые создал установщик, и сам LXC, если он выделен только под HomelabHero.
Частые вопросы
Как установить?
В свежем Ubuntu 26.04 LXC выполните `apt update && apt install -y curl && curl -fsSL https://raw.githubusercontent.com/serversathome/homelabhero/main/install.sh | bash` и ответьте на вопросы установщика.
Видит ли Claude пароли?
Нет, по заявлению авторов: агент работает от пользователя `hhagent`, а хранилище читает только отдельный владелец. Границы защиты разобраны в `docs/security.md`.
Через какой порт открывается интерфейс?
Установщик в конце печатает ссылку на порт 3001.
Как обновить?
Выполните `hh update`. Для установки старше июля 2026 лучше повторить установщик, он сохранит пользователей и список серверов.
Что умеют интеграции?
UniFi и Firewalla только читают данные. NetBird и Cloudflare могут менять настройки по именованным операциям.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСамохостящийся хаб для домашней лаборатории со встроенным MCP-сервером: у агента 32 инструмента с правами по ключам API
CLI на Go сравнивает сервер с прошлым снимком, сообщает только значимые перемены и отдает их агенту через MCP
Панель домашней лаборатории с MCP-сервером только для чтения: хосты, Docker, GPU, память видеокарт и службы
Brig запускает Claude Code и другие кодинг-агенты в изолированной microVM на вашем компьютере с доступом только к одному проекту.
Docker-песочница для кодинг-агентов: образ на Debian с Copilot CLI, Codex и Pi, а доступ по SSH, RDP и Docker включается флагами.
Контейнер для Claude Code, Codex, Copilot, OpenCode и Pi: агент работает без подтверждений, а выход в сеть режет шлюз.
Коротко о README
Установщик за одну команду собирает LXC с агентом, интерфейсом и брокером. Команды `hh` скрывают учетные данные от модели.