5.0 KiB
Homegate: запуск и настройка через браузер
Используйте образ gitea.hyperdog.dev/dizyaka/homegate:0.4.2 после успешной публикации
версии в Gitea Actions. Содержимое compose.simple.yaml сохраните
на сервере как compose.yaml. Файл не содержит адресов, environment, secrets или паролей.
docker compose pull
docker compose up -d --remove-orphans
Для приватного пакета один раз выполните docker login gitea.hyperdog.dev.
Это авторизация скачивания образа; параметры Homegate через неё не передаются.
Откройте http://IP-СЕРВЕРА:8098. Панель открывается без логина и показывает форму
первой настройки. Укажите прямо в ней:
- IP NPM, домашние подсети и доменные зоны;
- URL административного API NPM, его логин и пароль;
- URL Pi-hole 6 и его пароль, режим «Pi-hole без пароля» либо ручной режим DNS;
- при необходимости другой URL SSH-конфига и PEM корневого CA для HTTPS API.
Нажмите Сохранить и начать, затем добавляйте сервисы и SSH-хосты. Вся последующая
настройка доступна в разделе Настройки. Адреса и credentials перечитываются
контроллером без перезапуска. Пустое поле пароля при редактировании сохраняет прежнее значение. Если в Pi-hole пароль
отключён, включите Pi-hole без пароля: сохранённый пароль подключения будет удалён,
и Homegate будет работать с API без токена сессии. Адрес Pi-hole укажите без /admin и /api.
UI, контроллер и SSH-export работают в одном контейнере. До завершения первой настройки
работает только UI; запросы к NPM/Pi-hole ещё не выполняются. Открытые порты: 8098 для
панели и 8099 для /ssh-config. До настройки UI принимает подключения с loopback,
RFC1918 и ULA адресов; после настройки действует список разрешённых подсетей.
Пароль NPM и, если включён, пароль Pi-hole вводятся в форме и сохраняются в config volume. Они не возвращаются в API состояния, скачиваемом YAML или SSH-конфиге. Локальные HTTPS сертификаты и ключ CA Homegate создаёт сам. Публичный корневой сертификат скачивается в разделе Сертификаты; установите его на клиентские устройства для доверия HTTPS.
Обновление с прежнего Compose
Сохраните имя проекта homegate и volumes config, state, control из прежнего файла.
Новый Compose использует те же данные: сервисы, SSH, история и CA сохраняются.
Замените файл на compose.simple.yaml и выполните команды выше. --remove-orphans
удаляет прежние отдельные контейнеры initialize, ui, ssh-export, освобождая их порты;
volumes остаются. Адреса и credentials API из прежнего окружения один раз введите в UI.
Проверки
Unit/HTTP-тесты проверяют первичную настройку без env, LAN-доступ, сохранение credentials,
их отсутствие в публичных ответах, изменение API-подключений и остановку дочерних процессов.
ci/check_compose.py проверяет, что простой Compose не требует environment/configs/secrets.
Контейнерную проверку запускайте только локально на отдельном временном Compose-проекте:
ci/smoke_setup.py выполняется внутри контейнера с аргументом write, а после перезапуска —
с verify. Используются API-заглушки на loopback и временные пароли. В Gitea Actions
контейнеры Homegate не запускаются: только тесты, проверка Compose, сборка и публикация образа.