3 Commits

Author SHA1 Message Date
a83d897b70 Add first-run web setup and Compose without environment or secrets
All checks were successful
Test and publish Homegate / checks (push) Successful in 29s
Test and publish Homegate / publish (push) Successful in 12m46s
2026-10-14 03:26:50 +03:00
6844ccf0b9 Fix inline configs and secrets in registry Compose deployment
All checks were successful
Test and publish Homegate / checks (push) Successful in 28s
Test and publish Homegate / publish (push) Has been skipped
2026-10-14 02:54:23 +03:00
dd0f4ff8a8 Explain missing registry secrets before publishing
All checks were successful
Test and publish Homegate / checks (push) Successful in 26s
Test and publish Homegate / publish (push) Has been skipped
2026-10-14 02:02:16 +03:00
20 changed files with 771 additions and 62 deletions

View File

@@ -8,4 +8,5 @@
!ui/dist/ !ui/dist/
!ui/dist/** !ui/dist/**
!bootstrap.py !bootstrap.py
!standalone.py
!VERSION !VERSION

View File

@@ -33,6 +33,7 @@ jobs:
- name: JavaScript and shell syntax - name: JavaScript and shell syntax
run: | run: |
node --check ui/dist/app.js node --check ui/dist/app.js
node --check ui/dist/settings.js
for script in setup.sh run-local.sh ci/smoke_image.sh; do sh -n "$script"; done for script in setup.sh run-local.sh ci/smoke_image.sh; do sh -n "$script"; done
- name: Compose contracts - name: Compose contracts
env: env:
@@ -60,6 +61,23 @@ jobs:
DOCKER_BUILD_SUMMARY: "false" DOCKER_BUILD_SUMMARY: "false"
DOCKER_BUILD_RECORD_UPLOAD: "false" DOCKER_BUILD_RECORD_UPLOAD: "false"
steps: steps:
- name: Validate registry credentials
shell: bash
env:
REGISTRY_USERNAME: ${{ secrets.REGISTRY_USERNAME }}
REGISTRY_TOKEN: ${{ secrets.REGISTRY_TOKEN }}
run: |
set -euo pipefail
missing=0
if [ -z "${REGISTRY_USERNAME:-}" ]; then
echo "::error::Missing Actions secret REGISTRY_USERNAME. Set it in Repository Settings > Actions > Secrets to the Gitea username that owns REGISTRY_TOKEN."
missing=1
fi
if [ -z "${REGISTRY_TOKEN:-}" ]; then
echo "::error::Missing Actions secret REGISTRY_TOKEN. Set it in Repository Settings > Actions > Secrets to a Gitea personal access token with write:package permission. Actions Variables and runner environment variables do not populate secrets.REGISTRY_TOKEN."
missing=1
fi
exit "$missing"
- name: Checkout release - name: Checkout release
uses: https://github.com/actions/checkout@v4 uses: https://github.com/actions/checkout@v4
with: with:

View File

@@ -2,12 +2,13 @@ FROM python:3.13-slim-bookworm
WORKDIR /app WORKDIR /app
COPY requirements.txt . COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt RUN pip install --no-cache-dir -r requirements.txt
COPY homegate.py sync_ssh.py homegate_ui.py bootstrap.py VERSION . COPY homegate.py sync_ssh.py homegate_ui.py bootstrap.py standalone.py VERSION .
COPY ui/dist ./ui/dist COPY ui/dist ./ui/dist
ARG VERSION=0.4.0 ARG VERSION=0.4.1
LABEL org.opencontainers.image.title="Homegate" \ LABEL org.opencontainers.image.title="Homegate" \
org.opencontainers.image.description="LAN DNS, HTTPS and SSH management for Pi-hole and NPM" \ org.opencontainers.image.description="LAN DNS, HTTPS and SSH management for Pi-hole and NPM" \
org.opencontainers.image.version=$VERSION org.opencontainers.image.version=$VERSION
RUN mkdir -p /config /data /control && chown 1000:1000 /config /data /control
USER 1000:1000 USER 1000:1000
ENTRYPOINT ["python", "/app/homegate.py"] ENTRYPOINT ["python", "/app/homegate.py"]
CMD ["run"] CMD ["run"]

View File

@@ -1,4 +1,4 @@
# Homegate 0.4 # Homegate 0.4.1
Дополнение к **существующим Pi-hole и Nginx Proxy Manager** для домашней сети: Дополнение к **существующим Pi-hole и Nginx Proxy Manager** для домашней сети:
@@ -6,12 +6,14 @@
https://pve.home → NPM:443 → https://192.168.0.137:8006 https://pve.home → NPM:443 → https://192.168.0.137:8006
``` ```
Вы описываете сервисы в `config/services.yaml`. Homegate создаёт локальные DNS-записи, Вы добавляете сервисы в веб-панели. Homegate создаёт локальные DNS-записи,
сертификаты и Proxy Hosts, затем поддерживает их актуальными. Развёртывание — Docker Compose. сертификаты и Proxy Hosts, затем поддерживает их актуальными. Развёртывание — Docker Compose.
Веб-панель Homegate управляет сервисами, доменными зонами, SSH и настройками сети. Веб-панель Homegate управляет сервисами, доменными зонами, SSH и настройками сети.
Отдельный контейнер публикует SSH-конфиг без авторизации для устройств домашней подсети. SSH-конфиг публикуется без авторизации для устройств домашней подсети.
Новое в 0.4: [один Compose-файл, готовый образ и Gitea Actions](REGISTRY.md). **Простой запуск 0.4.1: [Compose без env и secrets, вся настройка в UI](SIMPLE.md).**
Откройте `http://IP-СЕРВЕРА:8098` и заполните адреса NPM/Pi-hole в форме. Пароль панели не нужен.
Расширенный вариант с отдельными контейнерами: [Compose и Gitea Actions](REGISTRY.md).
Также доступны: [веб-панель и локальный запуск](WEB.md), [SSH-конфиг и скрипт для ПК](SSH.md), [кастомные доменные зоны и миграция CA](DOMAINS.md). Также доступны: [веб-панель и локальный запуск](WEB.md), [SSH-конфиг и скрипт для ПК](SSH.md), [кастомные доменные зоны и миграция CA](DOMAINS.md).
**Для HTTPS без предупреждений нужно один раз установить `root-ca.crt` на каждое **Для HTTPS без предупреждений нужно один раз установить `root-ca.crt` на каждое
@@ -63,12 +65,12 @@ DNS указывает на **NPM**, а не на Proxmox. Порт и прот
- Если Pi-hole и NPM на одном IP, их web-порты должны различаться: например NPM - Если Pi-hole и NPM на одном IP, их web-порты должны различаться: например NPM
`80/81/443`, Pi-hole web `8080`, DNS `53`. Homegate этот конфликт автоматически не исправляет. `80/81/443`, Pi-hole web `8080`, DNS `53`. Homegate этот конфликт автоматически не исправляет.
Проверены Compose-конфигурация, shell-синтаксис и 55 тестов: сертификаты, настоящее TLS-рукопожатие Проверены Compose-конфигурация, shell-синтаксис и 63 теста: сертификаты, настоящее TLS-рукопожатие
в стандартных и кастомных зонах, продление, повторный запуск, конфликты, ошибки API, в стандартных и кастомных зонах, продление, повторный запуск, конфликты, ошибки API,
смена CA, HTTP-обработчик выгрузки, LAN ACL и отказ опасных SSH-директив. смена CA, HTTP-обработчик выгрузки, LAN ACL и отказ опасных SSH-директив.
Подключение дополнительного файла также проверено настоящим `ssh -G` с сохранением личных настроек. Подключение дополнительного файла также проверено настоящим `ssh -G` с сохранением личных настроек.
HTTP API в тестах имитируются по официальным контрактам. **Запуск образа, реальные API NPM/Pi-hole, HTTP API в тестах имитируются по официальным контрактам. Сборка и локальный запуск контейнеров
HTTPS-сервисы и noVNC на вашем сервере ещё не проверены:** локальная служба Docker при подготовке не работала. проверены отдельно. Реальные API NPM/Pi-hole, HTTPS-сервисы и noVNC на вашем сервере не проверены.
## Быстрый запуск из исходников ## Быстрый запуск из исходников

View File

@@ -1,5 +1,8 @@
# Один Compose-файл и Gitea Container Registry # Один Compose-файл и Gitea Container Registry
Для запуска без environment, secrets и пароля панели используйте [compose.simple.yaml](SIMPLE.md):
все адреса и подключения задаются в UI. Ниже описан расширенный вариант с отдельными контейнерами.
Homegate 0.4 поддерживает два способа установки: Homegate 0.4 поддерживает два способа установки:
| Файл | Назначение | | Файл | Назначение |
@@ -7,8 +10,21 @@ Homegate 0.4 поддерживает два способа установки:
| `compose.registry.yaml` | Готовый образ из Gitea; именованные volumes, автоматическая первичная настройка | | `compose.registry.yaml` | Готовый образ из Gitea; именованные volumes, автоматическая первичная настройка |
| `compose.yaml` | Прежний запуск из исходников с `build`, `setup.sh` и каталогами на хосте | | `compose.yaml` | Прежний запуск из исходников с `build`, `setup.sh` и каталогами на хосте |
Gitea здесь ещё не подключена, образ не опубликован. Workflow готов к запуску в вашем Для установки дождитесь успешной публикации образа в Gitea Actions.
репозитории. Имена `git.example.home` и `your-user` ниже — примеры. Имена `git.example.home` и `your-user` ниже — примеры.
В варианте с одним файлом Compose записывает `configs.content` и `secrets.environment`
в файловую систему контейнера до его запуска. Поэтому у `initialize`, `homegate` и `ui`
задано `read_only: false`; у `ssh-export` остаётся `read_only: true`. Иначе создание
контейнера завершается ошибкой `cannot create config/secret ... in read-only service`.
Это ограничение проверяется в `ci/check_compose.py` без запуска контейнеров.
Ограничения UID, capabilities и `no-new-privileges` сохраняются. В варианте установки
из исходников configs/secrets берутся из файлов на хосте и не требуют этого исключения.
Если скачали ранний `compose.registry.yaml` для `0.4.0`, добавьте `read_only: false`
в каждый из сервисов `initialize`, `homegate`, `ui` после `<<: *runtime`, затем выполните
`docker compose up -d`. Исправление совместимо с образом `0.4.0`; новый образ не нужен.
Сохраняйте прежнее имя Compose-проекта и volumes с настройками и CA.
## 1. Настройте репозиторий и runner один раз ## 1. Настройте репозиторий и runner один раз
@@ -42,10 +58,24 @@ Gitea здесь ещё не подключена, образ не опубли
обеспечивает совместимость с инсталляциями, где job token не может публиковать пакеты. обеспечивает совместимость с инсталляциями, где job token не может публиковать пакеты.
Не добавляйте сюда пароли NPM, Pi-hole или панели — они нужны только при развёртывании. Не добавляйте сюда пароли NPM, Pi-hole или панели — они нужны только при развёртывании.
Если публикация завершается с `Password required`, шаг входа в registry получил пустой
`REGISTRY_TOKEN`. Предупреждение Node.js про `punycode` не является причиной этой ошибки.
В **User Settings → Applications → Manage Access Tokens** создайте токен с правом
`write:package`, затем сохраните его значение в **Repository Settings → Actions → Secrets**
под именем `REGISTRY_TOKEN`. `REGISTRY_USERNAME` должен содержать логин владельца токена.
Значения в **Actions → Variables**, `.env` production-сервера или окружении runner
не подставляются в `${{ secrets.REGISTRY_TOKEN }}`.
После сохранения secrets повторно запустите упавший workflow для того же тега через
**Re-run** в Actions. Для исправления credentials новый тег не нужен. Workflow проверяет
наличие обоих secrets в начале job публикации, не выводя их значения в лог.
Эта проверка не проверяет права токена: корректность credentials проверяет вход в registry,
а право на публикацию — push образа.
По умолчанию registry берётся из адреса Gitea, image — из `owner/repository` в нижнем регистре: По умолчанию registry берётся из адреса Gitea, image — из `owner/repository` в нижнем регистре:
```text ```text
git.example.home/your-user/homegate:0.4.0 git.example.home/your-user/homegate:0.4.1
``` ```
Если registry доступен по другому имени/порту, задайте Actions **variable** `REGISTRY`, Если registry доступен по другому имени/порту, задайте Actions **variable** `REGISTRY`,
@@ -59,11 +89,11 @@ git.example.home/your-user/homegate:0.4.0
## 2. Выпустите образ ## 2. Выпустите образ
Файл `VERSION` сейчас содержит `0.4.0`. После загрузки проверенного кода в Gitea: Файл `VERSION` сейчас содержит `0.4.1`. После загрузки проверенного кода в Gitea:
```sh ```sh
git tag v0.4.0 git tag v0.4.1
git push origin v0.4.0 git push origin v0.4.1
``` ```
При следующем выпуске измените `VERSION`, закоммитьте его вместе с изменениями и создайте При следующем выпуске измените `VERSION`, закоммитьте его вместе с изменениями и создайте
@@ -80,7 +110,7 @@ Workflow `.gitea/workflows/release.yaml` выполняет:
3. Только для push тега `v*`, после успешных проверок — проверку `VERSION`, сборку 3. Только для push тега `v*`, после успешных проверок — проверку `VERSION`, сборку
`linux/amd64` + `linux/arm64` и публикацию в Gitea Container Registry. `linux/amd64` + `linux/arm64` и публикацию в Gitea Container Registry.
Образ получает два тега: `0.4.0` и `sha-<полный SHA коммита>`. Тег `latest` не создаётся. Образ получает два тега: `0.4.1` и `sha-<полный SHA коммита>`. Тег `latest` не создаётся.
`org.opencontainers.image.source` связывает метаданные образа с URL исходников. `org.opencontainers.image.source` связывает метаданные образа с URL исходников.
Права на просмотр/скачивание пакета проверьте в Gitea Packages отдельно от доступа к коду. Права на просмотр/скачивание пакета проверьте в Gitea Packages отдельно от доступа к коду.
Workflow не запускает контейнеры Homegate и не развёртывает приложение. Workflow не запускает контейнеры Homegate и не развёртывает приложение.
@@ -106,7 +136,7 @@ sh ci/smoke_image.sh homegate:test
В Bash укажите свои адреса. Здесь `.10`, `.11` и `.2` — примеры: В Bash укажите свои адреса. Здесь `.10`, `.11` и `.2` — примеры:
```bash ```bash
export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.4.0 export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.4.1
export HOMEGATE_LAN_IP=192.168.0.10 export HOMEGATE_LAN_IP=192.168.0.10
export HOMEGATE_PROXY_IP=192.168.0.11 export HOMEGATE_PROXY_IP=192.168.0.11
export HOMEGATE_ALLOWED_NETWORKS='[192.168.0.0/24]' export HOMEGATE_ALLOWED_NETWORKS='[192.168.0.0/24]'
@@ -236,14 +266,18 @@ docker compose start homegate ui ssh-export
## Что проверено ## Что проверено
Локально проходят 55 тестов, включая первый запуск, сохранение пользовательских изменений Локально проходят 63 теста, включая первый запуск, сохранение пользовательских изменений
и CA, отказ от повреждённого конфига и проверку адреса/версии публикуемого образа. и CA, отказ от повреждённого конфига и проверку адреса/версии публикуемого образа.
Оба Compose-файла проверяются установленным Docker Compose. Синтаксис shell, JavaScript Оба Compose-файла проверяются установленным Docker Compose, включая совместимость
и YAML workflow проверен. Docker daemon при подготовке выключен, поэтому сборка образа `read_only` с источниками configs/secrets. Синтаксис shell, JavaScript и YAML workflow проверен.
и исполнение самого workflow локально не проверены. Контейнерный smoke-test остаётся После исправления `read_only` локально проверены сборка образа для ARM64 и контейнерный
ручной проверкой и исключён из Gitea Actions. smoke-test на Docker Compose 5.3.1: инициализация volumes, вход в панель, изоляция secrets,
SSH-export и сохранение настроек/CA при повторной инициализации. Проверка использует
временные volumes без портов хоста и без доступа к NPM/Pi-hole; их реальные API этим тестом
не проверяются. Контейнерный smoke-test остаётся ручной проверкой и исключён из Gitea Actions.
Официальные контракты: [Gitea Container Registry](https://docs.gitea.com/usage/packages/container/), Официальные контракты: [Gitea Container Registry](https://docs.gitea.com/usage/packages/container/),
[Gitea Actions](https://docs.gitea.com/usage/actions/quickstart/), [Gitea Actions](https://docs.gitea.com/usage/actions/quickstart/),
[Compose secrets из environment](https://docs.docker.com/reference/compose-file/secrets/), [Compose secrets из environment](https://docs.docker.com/reference/compose-file/secrets/),
[Compose configs с content](https://docs.docker.com/reference/compose-file/configs/). [Compose configs с content](https://docs.docker.com/reference/compose-file/configs/),
[ограничение read_only в реализации Compose](https://github.com/docker/compose/blob/v2.40.0/pkg/compose/secrets.go).

54
SIMPLE.md Normal file
View File

@@ -0,0 +1,54 @@
# Homegate: запуск и настройка через браузер
Используйте образ `gitea.hyperdog.dev/dizyaka/homegate:0.4.1` после успешной публикации
версии в Gitea Actions. Содержимое [compose.simple.yaml](compose.simple.yaml) сохраните
на сервере как `compose.yaml`. Файл не содержит адресов, environment, secrets или паролей.
```sh
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 и его пароль либо ручной режим DNS;
- при необходимости другой URL SSH-конфига и PEM корневого CA для HTTPS API.
Нажмите **Сохранить и начать**, затем добавляйте сервисы и SSH-хосты. Вся последующая
настройка доступна в разделе **Настройки**. Адреса и credentials перечитываются
контроллером без перезапуска. Пустое поле пароля при редактировании сохраняет прежнее значение.
UI, контроллер и SSH-export работают в одном контейнере. До завершения первой настройки
работает только UI; запросы к NPM/Pi-hole ещё не выполняются. Открытые порты: `8098` для
панели и `8099` для `/ssh-config`. До настройки UI принимает подключения с loopback,
RFC1918 и ULA адресов; после настройки действует список разрешённых подсетей.
Пароли NPM/Pi-hole нужны их API, вводятся в форме и сохраняются в 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, сборка и публикация образа.

View File

@@ -1 +1 @@
0.4.0 0.4.1

3
WEB.md
View File

@@ -54,6 +54,9 @@ sh outputs/homegate/run-local.sh
## Панель для домашней сети через Docker ## Панель для домашней сети через Docker
В версии 0.4.1 есть [простой Compose](SIMPLE.md): панель без логина, первичная настройка
и подключения к NPM/Pi-hole целиком в UI. `UI_ORIGIN`, LAN-IP и credentials в окружении не нужны.
Для готового образа и автоматического создания volumes используйте [один Compose-файл](REGISTRY.md). Для готового образа и автоматического создания volumes используйте [один Compose-файл](REGISTRY.md).
Ниже — вариант сборки из исходников. Ниже — вариант сборки из исходников.

View File

@@ -7,7 +7,32 @@ import yaml
import homegate as h import homegate as h
def check_read_only_resources(model):
# compose config accepts this combination, but container creation rejects it.
for name, service in model['services'].items():
if not service.get('read_only'):
continue
for kind in ('configs', 'secrets'):
for resource in service.get(kind, []):
source = resource['source']
definition = model[kind][source]
assert 'file' in definition, (
f'{name}: read_only requires a file source for {kind}.{source}; '
'Compose cannot inject content/environment into a read-only container'
)
def main(): def main():
simple = json.loads(subprocess.check_output(
['docker', 'compose', '--env-file', os.devnull, '-f', 'compose.simple.yaml',
'config', '--format', 'json']))
assert set(simple['services']) == {'homegate'}
service = simple['services']['homegate']
assert not service.get('environment') and not service.get('env_file')
assert not simple.get('secrets') and not simple.get('configs')
assert service['image'] == 'gitea.hyperdog.dev/dizyaka/homegate:' + Path('VERSION').read_text().strip()
assert {p['published'] for p in service['ports']} == {'8098', '8099'}
assert {v['source'] for v in service['volumes']} == {'config', 'state', 'control'}
env = dict(os.environ, HOMEGATE_IMAGE='registry.example/homegate/homegate:0.4.0', env = dict(os.environ, HOMEGATE_IMAGE='registry.example/homegate/homegate:0.4.0',
HOMEGATE_LAN_IP='192.168.0.10', HOMEGATE_PROXY_IP='192.168.0.10', HOMEGATE_LAN_IP='192.168.0.10', HOMEGATE_PROXY_IP='192.168.0.10',
HOMEGATE_ALLOWED_NETWORKS='[192.168.0.0/24]', HOMEGATE_ZONES='[home, home.arpa]', HOMEGATE_ALLOWED_NETWORKS='[192.168.0.0/24]', HOMEGATE_ZONES='[home, home.arpa]',
@@ -18,6 +43,7 @@ def main():
model = json.loads(subprocess.check_output( model = json.loads(subprocess.check_output(
['docker', 'compose', '--env-file', os.devnull, '-f', 'compose.registry.yaml', ['docker', 'compose', '--env-file', os.devnull, '-f', 'compose.registry.yaml',
'config', '--format', 'json'], env=env)) 'config', '--format', 'json'], env=env))
check_read_only_resources(model)
assert set(model['services']) == {'initialize', 'homegate', 'ssh-export', 'ui'} assert set(model['services']) == {'initialize', 'homegate', 'ssh-export', 'ui'}
for name, service in model['services'].items(): for name, service in model['services'].items():
assert 'build' not in service, name assert 'build' not in service, name
@@ -31,6 +57,7 @@ def main():
assert model['services']['initialize']['network_mode'] == 'none' assert model['services']['initialize']['network_mode'] == 'none'
assert not model['services']['initialize'].get('secrets') assert not model['services']['initialize'].get('secrets')
assert not model['services']['ssh-export'].get('secrets') assert not model['services']['ssh-export'].get('secrets')
assert model['services']['ssh-export']['read_only']
assert [v['source'] for v in model['services']['ui']['secrets']] == ['ui_password'] assert [v['source'] for v in model['services']['ui']['secrets']] == ['ui_password']
for name in ('ui', 'ssh-export'): for name in ('ui', 'ssh-export'):
assert all(v['target'] != '/data' for v in model['services'][name]['volumes']) assert all(v['target'] != '/data' for v in model['services'][name]['volumes'])
@@ -38,8 +65,10 @@ def main():
assert all('environment' in s and 'file' not in s for s in model['secrets'].values()) assert all('environment' in s and 'file' not in s for s in model['secrets'].values())
seed = h.validate_config(yaml.safe_load(model['configs']['initial-config']['content'])) seed = h.validate_config(yaml.safe_load(model['configs']['initial-config']['content']))
assert seed['services'] == [] and seed['ssh_hosts'] == [] assert seed['services'] == [] and seed['ssh_hosts'] == []
subprocess.run(['docker', 'compose', '--env-file', '.env.example', '-f', 'compose.yaml', source_model = json.loads(subprocess.check_output(
'config', '--quiet'], check=True, env=env) ['docker', 'compose', '--env-file', '.env.example', '-f', 'compose.yaml',
'config', '--format', 'json'], env=env))
check_read_only_resources(source_model)
# The one-file deployment cannot accidentally fall back to all host interfaces. # The one-file deployment cannot accidentally fall back to all host interfaces.
del env['HOMEGATE_LAN_IP'] del env['HOMEGATE_LAN_IP']
missing = subprocess.run(['docker', 'compose', '--env-file', os.devnull, missing = subprocess.run(['docker', 'compose', '--env-file', os.devnull,

111
ci/smoke_setup.py Normal file
View File

@@ -0,0 +1,111 @@
"""Run manually inside a disposable standalone container: python - write|verify < this file."""
import hashlib
import http.cookiejar
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
import json
from pathlib import Path
import sys
import threading
import time
import urllib.error
import urllib.request
origin = 'http://127.0.0.1:8081'
opener = urllib.request.build_opener(urllib.request.ProxyHandler({}),
urllib.request.HTTPCookieProcessor(http.cookiejar.CookieJar()))
csrf = ''
def request(path, body=None):
headers = {}
if body is not None:
headers = {'Origin': origin, 'Content-Type': 'application/json', 'X-Homegate-CSRF': csrf}
payload = json.dumps(body).encode() if body is not None else None
with opener.open(urllib.request.Request(origin + path, payload, headers), timeout=3) as response:
data = response.read()
return json.loads(data) if 'application/json' in response.headers.get('Content-Type', '') else data
def wait_for(predicate):
deadline = time.monotonic() + 20
while time.monotonic() < deadline:
value = predicate()
if value:
return value
time.sleep(0.25)
raise AssertionError('Timed out waiting for controller')
def session_ready():
try:
return request('/api/session')
except urllib.error.HTTPError:
raise
except urllib.error.URLError:
return None
session = wait_for(session_ready)
assert session['authenticated']
csrf = session['csrf']
state = request('/api/state')
assert not state['auth_required']
assert b'renderManagedSettings' in request('/settings.js')
if sys.argv[-1] == 'write':
assert state['setup_required']
seen = []
class API(BaseHTTPRequestHandler):
def do_GET(self):
length = int(self.headers.get('Content-Length', '0'))
body = json.loads(self.rfile.read(length)) if length else None
if self.path == '/api/tokens':
seen.append((self.server.server_port, body['identity'], body['secret']))
value = {'token': 'disposable-token'}
elif self.path == '/api/auth':
value = {'session': {'valid': True, 'sid': 'disposable-sid', 'csrf': 'disposable-csrf'}}
elif self.path == '/api/config/dns':
value = {'config': {'dns': {'hosts': [], 'cnameRecords': []}}}
else:
value = []
data = json.dumps(value).encode()
self.send_response(200)
self.send_header('Content-Type', 'application/json')
self.send_header('Content-Length', str(len(data)))
self.end_headers()
self.wfile.write(data)
do_POST = do_GET
do_DELETE = do_GET
def log_message(self, *args):
pass
servers = [ThreadingHTTPServer(('127.0.0.1', port), API) for port in (18181, 18182)]
for server in servers:
threading.Thread(target=server.serve_forever, daemon=True).start()
try:
config = state['config']
config.update(proxy_ip='192.168.42.11', allowed_networks=['10.0.0.0/8', '172.16.0.0/12', '192.168.0.0/16'],
ssh_hosts=[{'aliases': ['qa-nas'], 'host': '192.168.42.50', 'port': 22, 'user': 'test'}])
links = {'npm_url': 'http://127.0.0.1:18181', 'npm_identity': 'test@example.invalid',
'npm_password': 'disposable-npm-password', 'pihole_url': 'http://127.0.0.1:18181',
'pihole_password': 'disposable-pihole-password'}
state = request('/api/settings', {'config': config, 'connections': links, 'revision': state['revision']})
assert not state['setup_required']
wait_for(lambda: request('/api/state')['controller'].get('ok'))
assert (18181, 'test@example.invalid', 'disposable-npm-password') in seen
ca_before = Path('/data/root-ca.crt').read_bytes()
links.update(npm_url='http://127.0.0.1:18182', npm_password='changed-npm-password')
request('/api/settings', {'config': config, 'connections': links, 'revision': state['revision']})
wait_for(lambda: (18182, 'test@example.invalid', 'changed-npm-password') in seen)
assert Path('/data/root-ca.crt').read_bytes() == ca_before
assert 'changed-npm-password' not in json.dumps(request('/api/state'))
with opener.open('http://127.0.0.1:8080/healthz') as response:
assert response.status == 200
assert b'Host qa-nas' in request('/downloads/ssh-config')
Path('/data/.qa-fingerprint').write_text(hashlib.sha256(ca_before).hexdigest())
print('Standalone: no-env onboarding, real HTTP settings, NPM/Pi-hole mock login, live API reload, CA and SSH verified.')
finally:
for server in servers:
server.shutdown()
else:
assert not state['setup_required']
assert state['connections']['npm_url'] == 'http://127.0.0.1:18182'
assert state['connections']['npm_password_set']
assert state['config']['ssh_hosts'][0]['aliases'] == ['qa-nas']
assert hashlib.sha256(Path('/data/root-ca.crt').read_bytes()).hexdigest() == Path('/data/.qa-fingerprint').read_text()
assert b'Host qa-nas' in request('/downloads/ssh-config')
print('Standalone restart: setup, credentials, SSH inventory and CA retained; no login or environment required.')

View File

@@ -1,6 +1,6 @@
# Download this file only. Supply settings/passwords via the shell or an optional .env. # Download this file only. Supply settings/passwords via the shell or an optional .env.
# Docker Compose >= 2.30.0 (not docker stack deploy). See REGISTRY.md. # Docker Compose >= 2.30.0 (not docker stack deploy). See REGISTRY.md.
# Example image: git.example.home/your-user/homegate:0.4.0 # Example image: git.example.home/your-user/homegate:0.4.1
name: homegate name: homegate
x-runtime: &runtime x-runtime: &runtime
@@ -31,6 +31,8 @@ x-environment: &environment
services: services:
initialize: initialize:
<<: *runtime <<: *runtime
# Compose copies configs.content into the container before starting it.
read_only: false
entrypoint: [python, /app/bootstrap.py] entrypoint: [python, /app/bootstrap.py]
command: [] command: []
user: "0:0" user: "0:0"
@@ -52,6 +54,8 @@ services:
homegate: homegate:
<<: *runtime <<: *runtime
# Compose requires a writable root filesystem for secrets.environment.
read_only: false
depends_on: depends_on:
initialize: initialize:
condition: service_completed_successfully condition: service_completed_successfully
@@ -98,6 +102,8 @@ services:
ui: ui:
<<: *runtime <<: *runtime
# Compose requires a writable root filesystem for secrets.environment.
read_only: false
entrypoint: [python, /app/homegate_ui.py] entrypoint: [python, /app/homegate_ui.py]
command: [] command: []
depends_on: depends_on:

20
compose.simple.yaml Normal file
View File

@@ -0,0 +1,20 @@
name: homegate
services:
homegate:
image: gitea.hyperdog.dev/dizyaka/homegate:0.4.1
entrypoint: [python, /app/standalone.py]
restart: unless-stopped
init: true
ports:
- "8098:8081"
- "8099:8080"
volumes:
- config:/config
- state:/data
- control:/control
volumes:
config:
state:
control:

View File

@@ -2,7 +2,7 @@ name: homegate
services: services:
homegate: homegate:
build: . build: .
image: homegate:0.4.0 image: homegate:0.4.1
restart: unless-stopped restart: unless-stopped
init: true init: true
user: "${LOCAL_UID:-1000}:${LOCAL_GID:-1000}" user: "${LOCAL_UID:-1000}:${LOCAL_GID:-1000}"
@@ -50,7 +50,7 @@ services:
ssh-export: ssh-export:
build: . build: .
image: homegate:0.4.0 image: homegate:0.4.1
command: [serve] command: [serve]
restart: unless-stopped restart: unless-stopped
init: true init: true
@@ -87,7 +87,7 @@ services:
ui: ui:
build: . build: .
image: homegate:0.4.0 image: homegate:0.4.1
entrypoint: [python, /app/homegate_ui.py] entrypoint: [python, /app/homegate_ui.py]
command: [] command: []
restart: unless-stopped restart: unless-stopped

View File

@@ -359,9 +359,11 @@ def export_handler(config_path):
def serve_export(config_path): def serve_export(config_path):
load_config(config_path) load_config(config_path)
# Compose requires an explicit private host IP; never publish on every host interface. # The standalone deployment enforces LAN access through the configured subnets.
bind_ip = private_address(os.environ.get("SSH_BIND_IP", "")) bind_ip = "LAN (configured in the web panel)"
require(ipaddress.ip_address(bind_ip).version == 4, "SSH_BIND_IP must be a private IPv4 address") if os.environ.get("HOMEGATE_MANAGED_UI") != "1":
bind_ip = private_address(os.environ.get("SSH_BIND_IP", ""))
require(ipaddress.ip_address(bind_ip).version == 4, "SSH_BIND_IP must be a private IPv4 address")
with ThreadingHTTPServer(("0.0.0.0", 8080), export_handler(config_path)) as server: with ThreadingHTTPServer(("0.0.0.0", 8080), export_handler(config_path)) as server:
LOG.info("SSH export available through Docker binding %s; path /ssh-config", bind_ip) LOG.info("SSH export available through Docker binding %s; path /ssh-config", bind_ip)
server.serve_forever() server.serve_forever()
@@ -565,15 +567,22 @@ def secret(name):
def cycle(config, state, ca, registry): def cycle(config, state, ca, registry):
verify = os.environ.get("API_CA_BUNDLE") or True verify = os.environ.get("API_CA_BUNDLE") or True
npm = NPM(os.environ.get("NPM_URL", ""), "NPM", verify) settings_file = os.environ.get("HOMEGATE_CONNECTIONS")
settings = read_json(Path(settings_file)) if settings_file else None
if settings is not None and settings.get("api_ca_pem"):
ca_path = Path(settings_file).with_name("management-ca.pem")
atomic(ca_path, settings["api_ca_pem"].encode(), 0o600)
verify = str(ca_path)
npm = NPM(settings["npm_url"] if settings is not None else os.environ.get("NPM_URL", ""), "NPM", verify)
dns = None dns = None
dns_error = False dns_error = False
try: try:
npm.login(os.environ.get("NPM_IDENTITY", ""), secret("NPM")) npm.login(settings["npm_identity"] if settings is not None else os.environ.get("NPM_IDENTITY", ""),
settings["npm_password"] if settings is not None else secret("NPM"))
if config["dns_mode"] == "pihole6": if config["dns_mode"] == "pihole6":
dns = PiHole(os.environ.get("PIHOLE_URL", ""), "PIHOLE", verify) dns = PiHole(settings["pihole_url"] if settings is not None else os.environ.get("PIHOLE_URL", ""), "PIHOLE", verify)
try: try:
dns.login(secret("PIHOLE")) dns.login(settings["pihole_password"] if settings is not None else secret("PIHOLE"))
except (Error, OSError) as exc: except (Error, OSError) as exc:
LOG.error("Pi-hole login unavailable; continuing proxy maintenance: %s", exc) LOG.error("Pi-hole login unavailable; continuing proxy maintenance: %s", exc)
dns.close() dns.close()

View File

@@ -31,26 +31,32 @@ class UIError(Exception):
class Panel: class Panel:
def __init__(self, config, control, origin, local=False, password_file=None, ssh_url=""): def __init__(self, config, control, origin, local=False, password_file=None, ssh_url="", auth_required=True, connections_file=None):
self.config = Path(config) self.config = Path(config)
self.control = Path(control) self.control = Path(control)
self.connections_file = Path(connections_file) if connections_file else None
self.origin = origin.rstrip("/") self.origin = origin.rstrip("/")
self.authority = urlsplit(self.origin).netloc self.authority = urlsplit(self.origin).netloc
parsed_origin = urlsplit(self.origin) parsed_origin = urlsplit(self.origin)
if (parsed_origin.scheme not in ("http", "https") or not self.authority if not (self.connections_file and not self.origin) and (parsed_origin.scheme not in ("http", "https") or not self.authority
or parsed_origin.path or parsed_origin.query or parsed_origin.fragment or parsed_origin.username): or parsed_origin.path or parsed_origin.query or parsed_origin.fragment or parsed_origin.username):
raise UIError("UI_ORIGIN must be the exact http(s)://host:port of the panel") raise UIError("UI_ORIGIN must be the exact http(s)://host:port of the panel")
self.local = local self.local = local
self.auth_required = auth_required and not local
self.password_file = password_file self.password_file = password_file
self.ssh_url = ssh_url self.ssh_url = ssh_url
self.sessions = {} self.sessions = {}
self.attempts = defaultdict(list) self.attempts = defaultdict(list)
self.mutex = threading.RLock() self.mutex = threading.RLock()
if not local and (not password_file or len(Path(password_file).read_text().strip()) < 12): if self.auth_required and (not password_file or len(Path(password_file).read_text().strip()) < 12):
raise UIError("UI password must contain at least 12 characters; run setup.sh") raise UIError("UI password must contain at least 12 characters; run setup.sh")
h.load_config(self.config) if self.config.exists() or not self.connections_file:
h.load_config(self.config)
def config_data(self): def config_data(self):
if self.connections_file and not self.config.exists():
return {"proxy_ip": "", "allowed_networks": [], "domain_zones": ["home", "home.arpa"],
"dns_mode": "pihole6", "interval_seconds": 60, "services": [], "ssh_hosts": []}, ""
raw = self.config.read_bytes() raw = self.config.read_bytes()
value = yaml.safe_load(raw) value = yaml.safe_load(raw)
h.validate_config(value) h.validate_config(value)
@@ -64,6 +70,8 @@ class Panel:
return True return True
if self.local: if self.local:
return False return False
if self.connections_file and not self.config.exists():
return any(address.version == net.version and address in net for net in h.PRIVATE)
c = h.load_config(self.config) c = h.load_config(self.config)
return any(address.version == net.version and address in net for net in return any(address.version == net.version and address in net for net in
(ipaddress.ip_network(n) for n in c["allowed_networks"])) (ipaddress.ip_network(n) for n in c["allowed_networks"]))
@@ -107,8 +115,52 @@ class Panel:
snapshot = h.read_json(self.control / "status.json", {}) snapshot = h.read_json(self.control / "status.json", {})
fresh = bool(snapshot) and time.time() - snapshot.get("time", 0) < snapshot.get("max_age", 180) fresh = bool(snapshot) and time.time() - snapshot.get("time", 0) < snapshot.get("max_age", 180)
history = h.read_json(self.control / "ui-history.json", []) history = h.read_json(self.control / "ui-history.json", [])
connections = h.read_json(self.connections_file, {}) if self.connections_file else None
public_connections = None if connections is None else {
**{key: connections.get(key, "") for key in ("npm_url", "npm_identity", "pihole_url", "ssh_public_url", "api_ca_pem")},
**{key + "_set": bool(connections.get(key)) for key in ("npm_password", "pihole_password")},
}
return {"config": value, "revision": revision, "mode": "local" if self.local else "lan", return {"config": value, "revision": revision, "mode": "local" if self.local else "lan",
"ssh_url": self.ssh_url, "controller": {**snapshot, "fresh": fresh}, "history": history[:8]} "setup_required": self.connections_file is not None and (not self.config.exists() or not self.connections_file.exists()),
"connections": public_connections,
"auth_required": self.auth_required,
"ssh_url": connections.get("ssh_public_url", "") if connections is not None else self.ssh_url,
"controller": {**snapshot, "fresh": fresh}, "history": history[:8]}
def save_settings(self, config, connections, revision):
if self.connections_file is None:
raise UIError("Connections are managed by the existing deployment", 409)
h.validate_config(config)
h.require(isinstance(connections, dict), "Connections must be an object")
with self.mutex:
if self.config_data()[1] != revision:
raise UIError("Настройки уже изменились. Обновите страницу.", 409)
values = h.read_json(self.connections_file, {})
allowed = {"npm_url", "npm_identity", "npm_password", "pihole_url", "pihole_password", "ssh_public_url", "api_ca_pem"}
h.require(not set(connections) - allowed, "Unknown connection field")
for key, value in connections.items():
h.require(isinstance(value, str), f"{key} must be text")
if key.endswith("_password") and not value and values.get(key):
continue
values[key] = value if key.endswith("_password") else value.strip()
h.require(bool(values.get("npm_identity")), "Укажите логин Nginx Proxy Manager")
h.require(bool(values.get("npm_password")), "Укажите пароль Nginx Proxy Manager")
for key in ("npm_url", "pihole_url"):
if key == "pihole_url" and config["dns_mode"] == "manual" and not values.get(key):
continue
client = h.API(values.get(key, ""), key.removesuffix("_url").upper())
client.close()
values.setdefault("pihole_password", "")
if values.get("ssh_public_url"):
url = urlsplit(values["ssh_public_url"])
h.require(url.scheme in ("http", "https") and url.hostname and not url.username and not url.fragment,
"Укажите полный http(s) URL SSH-конфига")
if values.get("api_ca_pem"):
h.require(bool(h.x509.load_pem_x509_certificates(values["api_ca_pem"].encode())), "Некорректный PEM сертификата API")
h.save_json(self.connections_file, values)
result = self.save(config, revision)
self.request_sync()
return result
def save(self, value, revision): def save(self, value, revision):
h.validate_config(value) h.validate_config(value)
@@ -117,11 +169,13 @@ class Panel:
lock_path = self.config.parent / ".ui-config.lock" lock_path = self.config.parent / ".ui-config.lock"
with lock_path.open("a") as lock: with lock_path.open("a") as lock:
fcntl.flock(lock, fcntl.LOCK_EX) fcntl.flock(lock, fcntl.LOCK_EX)
original = self.config.read_bytes() original = self.config.read_bytes() if self.config.exists() else None
if hashlib.sha256(original).hexdigest() != revision: current_revision = hashlib.sha256(original).hexdigest() if original is not None else ""
if current_revision != revision:
raise UIError("Настройки уже изменились. Обновите страницу и повторите сохранение.", 409) raise UIError("Настройки уже изменились. Обновите страницу и повторите сохранение.", 409)
backup = self.config.parent / "backups" / f"services-{time.time_ns()}.yaml" backup = self.config.parent / "backups" / f"services-{time.time_ns()}.yaml"
h.atomic(backup, original) if original is not None:
h.atomic(backup, original)
# Preserve readability for the export container running under the same UID. # Preserve readability for the export container running under the same UID.
h.atomic(self.config, data, 0o644) h.atomic(self.config, data, 0o644)
backups = sorted(backup.parent.glob("services-*.yaml")) backups = sorted(backup.parent.glob("services-*.yaml"))
@@ -167,24 +221,44 @@ def handler_for(panel):
self.wfile.write(body) self.wfile.write(body)
def dispatch(self): def dispatch(self):
if self.headers.get("Host", "") != panel.authority: host = self.headers.get("Host", "")
if panel.authority and host != panel.authority:
raise UIError("Unexpected Host", 403) raise UIError("Unexpected Host", 403)
if not panel.authority:
parsed = urlsplit("http://" + host)
if not parsed.hostname or parsed.username or parsed.path or parsed.query or parsed.fragment:
raise UIError("Unexpected Host", 403)
try:
address = ipaddress.ip_address(parsed.hostname)
allowed_host = address.is_loopback or any(address.version == net.version and address in net for net in h.PRIVATE)
except ValueError:
zones = panel.config_data()[0].get("domain_zones", h.DEFAULT_ZONES)
allowed_host = parsed.hostname == "localhost" or any(parsed.hostname == zone or parsed.hostname.endswith("." + zone) for zone in zones)
if not allowed_host:
raise UIError("Open the panel using the server LAN IP or a configured local domain", 403)
if not panel.allowed(self.client_address[0]): if not panel.allowed(self.client_address[0]):
raise UIError("Доступ разрешён только из домашней сети", 403) raise UIError("Доступ разрешён только из домашней сети", 403)
path = urlsplit(self.path).path path = urlsplit(self.path).path
if self.command == "GET" and path in ("/", "/app.js", "/style.css", "/favicon.svg"): if self.command == "GET" and path == "/healthz":
name = {"/": "index.html", "/app.js": "app.js", "/style.css": "style.css", "/favicon.svg": "favicon.svg"}[path] return self.respond(200, {"ok": True})
if self.command == "GET" and path in ("/", "/app.js", "/settings.js", "/style.css", "/favicon.svg"):
name = {"/": "index.html", "/app.js": "app.js", "/settings.js": "settings.js", "/style.css": "style.css", "/favicon.svg": "favicon.svg"}[path]
content_type = {"index.html": "text/html; charset=utf-8", "app.js": "text/javascript; charset=utf-8", content_type = {"index.html": "text/html; charset=utf-8", "app.js": "text/javascript; charset=utf-8",
"style.css": "text/css; charset=utf-8", "favicon.svg": "image/svg+xml"}[name] "settings.js": "text/javascript; charset=utf-8", "style.css": "text/css; charset=utf-8", "favicon.svg": "image/svg+xml"}[name]
return self.respond(200, (BASE / "ui" / "dist" / name).read_bytes(), content_type) return self.respond(200, (BASE / "ui" / "dist" / name).read_bytes(), content_type)
token, session = panel.session(self.headers.get("Cookie")) token, session = panel.session(self.headers.get("Cookie"))
if self.command == "GET" and path == "/api/session": if self.command == "GET" and path == "/api/session":
if panel.local and session is None: if not panel.auth_required and session is None:
token, session = panel.new_session() token, session = panel.new_session()
return self.respond(200, {"authenticated": bool(session), "local": panel.local, return self.respond(200, {"authenticated": bool(session), "local": panel.local,
"csrf": session["csrf"] if session else None}, cookie=token if session else None) "csrf": session["csrf"] if session else None}, cookie=token if session else None)
if self.command == "POST": if self.command == "POST":
if self.headers.get("Origin") != panel.origin: origin = self.headers.get("Origin", "")
parsed = urlsplit(origin)
valid_origin = origin == panel.origin if panel.origin else (
parsed.scheme in ("http", "https") and parsed.netloc == host
and not parsed.path and not parsed.query and not parsed.fragment and not parsed.username)
if not valid_origin:
raise UIError("Invalid request origin", 403) raise UIError("Invalid request origin", 403)
if self.headers.get("Content-Type", "").split(";")[0] != "application/json": if self.headers.get("Content-Type", "").split(";")[0] != "application/json":
raise UIError("JSON required", 415) raise UIError("JSON required", 415)
@@ -194,7 +268,7 @@ def handler_for(panel):
body = json.loads(self.rfile.read(size)) body = json.loads(self.rfile.read(size))
if not isinstance(body, dict): if not isinstance(body, dict):
raise UIError("JSON object required") raise UIError("JSON object required")
if path == "/api/login" and not panel.local: if path == "/api/login" and panel.auth_required:
token, session = panel.login(body.get("password"), self.client_address[0]) token, session = panel.login(body.get("password"), self.client_address[0])
return self.respond(200, {"csrf": session["csrf"]}, cookie=token) return self.respond(200, {"csrf": session["csrf"]}, cookie=token)
if session is None: if session is None:
@@ -222,6 +296,8 @@ def handler_for(panel):
raise UIError("Invalid session token", 403) raise UIError("Invalid session token", 403)
if path == "/api/config": if path == "/api/config":
return self.respond(200, panel.save(body["config"], body["revision"])) return self.respond(200, panel.save(body["config"], body["revision"]))
if path == "/api/settings":
return self.respond(200, panel.save_settings(body["config"], body["connections"], body["revision"]))
if path == "/api/sync": if path == "/api/sync":
return self.respond(202, panel.request_sync()) return self.respond(202, panel.request_sync())
if path == "/api/logout": if path == "/api/logout":
@@ -257,17 +333,21 @@ def main():
args = p.parse_args() args = p.parse_args()
if args.local and args.host != "127.0.0.1": if args.local and args.host != "127.0.0.1":
raise UIError("Local no-login mode must bind to loopback") raise UIError("Local no-login mode must bind to loopback")
if not args.local: managed = os.environ.get("HOMEGATE_MANAGED_UI") == "1"
if not args.local and not managed:
bind_ip = os.environ.get("UI_BIND_IP", "") bind_ip = os.environ.get("UI_BIND_IP", "")
h.private_address(bind_ip) h.private_address(bind_ip)
h.require(ipaddress.ip_address(bind_ip).version == 4, "UI_BIND_IP must be a private IPv4 address") h.require(ipaddress.ip_address(bind_ip).version == 4, "UI_BIND_IP must be a private IPv4 address")
origin = os.environ.get("UI_ORIGIN", f"http://{args.host}:{args.port}") origin = os.environ.get("UI_ORIGIN", "" if managed else f"http://{args.host}:{args.port}")
auth_mode = os.environ.get("UI_AUTH_MODE", "password")
h.require(auth_mode in ("password", "none"), "UI_AUTH_MODE must be password or none")
panel = Panel(os.environ.get("HOMEGATE_CONFIG", "/config/services.yaml"), panel = Panel(os.environ.get("HOMEGATE_CONFIG", "/config/services.yaml"),
os.environ.get("HOMEGATE_CONTROL", "/control"), origin, args.local, os.environ.get("HOMEGATE_CONTROL", "/control"), origin, args.local,
os.environ.get("UI_PASSWORD_FILE", "/run/secrets/ui_password"), os.environ.get("UI_PASSWORD_FILE", "/run/secrets/ui_password"),
os.environ.get("SSH_PUBLIC_URL", "")) os.environ.get("SSH_PUBLIC_URL", ""), auth_required=auth_mode != "none",
connections_file=os.environ.get("HOMEGATE_CONNECTIONS") if managed else None)
with ThreadingHTTPServer((args.host, args.port), handler_for(panel)) as server: with ThreadingHTTPServer((args.host, args.port), handler_for(panel)) as server:
print(f"Homegate Local: {origin}", flush=True) print(f"Homegate UI: {origin or f'http://{args.host}:{args.port}'}", flush=True)
server.serve_forever() server.serve_forever()

111
standalone.py Normal file
View File

@@ -0,0 +1,111 @@
"""Run the controller, passwordless LAN panel and SSH export in one container."""
import argparse
import os
from pathlib import Path
import signal
import subprocess
import sys
import threading
import time
import urllib.request
import yaml
import homegate as h
BASE = Path(__file__).resolve().parent
def runtime_environment(source):
env = dict(source)
defaults = {
"HOMEGATE_CONFIG": "/config/services.yaml", "HOMEGATE_STATE": "/data",
"HOMEGATE_CONTROL": "/control", "HOMEGATE_CONNECTIONS": "/config/connections.json",
"HOMEGATE_MANAGED_UI": "1",
"UI_AUTH_MODE": "none", "UI_LISTEN_HOST": "0.0.0.0", "UI_LISTEN_PORT": "8081",
"PYTHONDONTWRITEBYTECODE": "1", "PYTHONUNBUFFERED": "1",
}
for key, value in defaults.items():
env.setdefault(key, value)
return env
def prepare(env):
for directory in (Path(env["HOMEGATE_CONFIG"]).parent, Path(env["HOMEGATE_STATE"]), Path(env["HOMEGATE_CONTROL"])):
directory.mkdir(parents=True, exist_ok=True)
def configured(env):
return all(Path(env[key]).is_file() for key in ("HOMEGATE_CONFIG", "HOMEGATE_CONNECTIONS"))
def supervise(commands, env, deferred=()):
stopped = threading.Event()
previous = {sig: signal.signal(sig, lambda *_: stopped.set())
for sig in (signal.SIGTERM, signal.SIGINT)}
children = []
try:
for command in commands:
if stopped.is_set():
return 0
children.append(subprocess.Popen(command, env=env))
while not stopped.wait(0.25):
if deferred and configured(env):
for command in deferred:
children.append(subprocess.Popen(command, env=env))
deferred = ()
for child in children:
if child.poll() is not None:
print(f"Homegate process exited with status {child.returncode}; restarting the container", flush=True)
return 1
return 0
finally:
for child in children:
if child.poll() is None:
child.terminate()
deadline = time.monotonic() + 8
for child in children:
try:
child.wait(timeout=max(0, deadline - time.monotonic()))
except subprocess.TimeoutExpired:
child.kill()
child.wait()
for sig, handler in previous.items():
signal.signal(sig, handler)
def health(env):
opener = urllib.request.build_opener(urllib.request.ProxyHandler({}))
requests = ["http://127.0.0.1:8081/healthz"]
if configured(env):
requests.append("http://127.0.0.1:8080/healthz")
for request in requests:
with opener.open(request, timeout=3) as response:
response.read()
return 0
def main():
os.umask(0o077)
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("command", nargs="?", default="all",
choices=("all", "once", "validate", "fingerprint", "rotate-ca", "ssh-config"))
parser.add_argument("--health", action="store_true")
args = parser.parse_args()
env = runtime_environment(os.environ)
if args.health:
return health(env)
prepare(env)
controller = [sys.executable, str(BASE / "homegate.py")]
if args.command != "all":
h.require(configured(env), "Complete the first-run setup in the web panel")
return subprocess.call(controller + [args.command], env=env)
return supervise([[sys.executable, str(BASE / "homegate_ui.py")]], env,
deferred=[controller + ["run"], controller + ["serve"]])
if __name__ == "__main__":
try:
sys.exit(main())
except (h.Error, OSError, ValueError, TypeError, KeyError, yaml.YAMLError) as exc:
print(f"Homegate: {exc}", file=sys.stderr)
sys.exit(1)

158
tests/test_setup.py Normal file
View File

@@ -0,0 +1,158 @@
"""First-run UI, stored connections, live controller reload and process supervision."""
import copy
import json
import os
from pathlib import Path
import subprocess
import sys
import tempfile
import unittest
from unittest.mock import patch
import homegate as h
import homegate_ui as ui
import standalone
from test_ssh_and_zones import MemorySocket
class SetupTests(unittest.TestCase):
def setUp(self):
temp = tempfile.TemporaryDirectory()
self.addCleanup(temp.cleanup)
self.root = Path(temp.name)
self.config = self.root / 'config/services.yaml'
self.config.parent.mkdir()
self.connections = self.config.with_name('connections.json')
self.control = self.root / 'control'
self.panel = ui.Panel(self.config, self.control, '', auth_required=False, connections_file=self.connections)
self.cookie = ''
self.csrf = ''
self.settings = {'config': {'proxy_ip': '192.168.0.11', 'allowed_networks': ['192.168.0.0/24'],
'domain_zones': ['home', 'home.arpa'], 'dns_mode': 'pihole6', 'interval_seconds': 60,
'services': [], 'ssh_hosts': []}, 'connections': {'npm_url': 'http://192.168.0.11:81',
'npm_identity': 'admin@example.com', 'npm_password': 'test-npm-secret',
'pihole_url': 'http://192.168.0.2', 'pihole_password': 'test-pihole-secret'}, 'revision': ''}
def request(self, path='/api/state', body=None, peer='192.168.0.20', headers=None):
method = 'GET' if body is None else 'POST'
payload = b'' if body is None else json.dumps(body).encode()
heads = {'Host': '192.168.0.10:8098', 'Cookie': self.cookie}
if body is not None:
heads.update({'Origin': 'http://192.168.0.10:8098', 'Content-Type': 'application/json',
'Content-Length': str(len(payload)), 'X-Homegate-CSRF': self.csrf})
heads.update(headers or {})
raw = f'{method} {path} HTTP/1.1\r\n' + ''.join(f'{k}: {v}\r\n' for k, v in heads.items()) + '\r\n'
sock = MemorySocket(raw.encode() + payload)
ui.handler_for(self.panel)(sock, (peer, 5000), None)
head, data = sock.output.split(b'\r\n\r\n', 1)
response_headers = dict(line.decode().split(': ', 1) for line in head.split(b'\r\n')[1:])
if 'application/json' in response_headers.get('Content-Type', ''):
data = json.loads(data)
return int(head.split()[1]), data, response_headers
def connect(self):
code, body, headers = self.request('/api/session')
self.assertEqual(code, 200)
self.assertTrue(body['authenticated'])
self.cookie = headers['Set-Cookie'].split(';')[0]
self.csrf = body['csrf']
def install(self):
self.connect()
code, state, _ = self.request('/api/settings', self.settings)
self.assertEqual(code, 200, state)
self.assertFalse(state['setup_required'])
return state
def test_blank_volume_opens_setup_without_password_or_env(self):
self.connect()
code, state, _ = self.request()
self.assertEqual(code, 200)
self.assertTrue(state['setup_required'])
self.assertFalse(state['auth_required'])
self.assertEqual(state['config']['services'], [])
self.assertEqual(self.request('/healthz')[0], 200)
self.assertEqual(self.request('/settings.js')[0], 200)
self.assertFalse(self.config.exists())
def test_setup_persists_and_keeps_secrets_out_of_state_and_exports(self):
state = self.install()
stored = h.read_json(self.connections)
self.assertEqual(stored['npm_password'], 'test-npm-secret')
self.assertEqual(self.connections.stat().st_mode & 0o777, 0o600)
self.assertTrue(state['connections']['npm_password_set'])
self.assertNotIn('test-npm-secret', json.dumps(state))
self.assertNotIn(b'test-npm-secret', self.request('/downloads/services.yaml')[1])
self.assertTrue((self.control / 'sync-request.json').exists())
restarted = ui.Panel(self.config, self.control, '', auth_required=False, connections_file=self.connections)
self.assertFalse(restarted.status()['setup_required'])
self.assertEqual(restarted.status()['connections']['npm_url'], stored['npm_url'])
def test_save_again_preserves_blank_passwords_and_changes_api_url(self):
state = self.install()
settings = copy.deepcopy(self.settings)
settings['revision'] = state['revision']
settings['connections']['npm_url'] = 'http://192.168.0.12:81'
settings['connections']['npm_password'] = ''
code, _, _ = self.request('/api/settings', settings)
self.assertEqual(code, 200)
stored = h.read_json(self.connections)
self.assertEqual(stored['npm_password'], 'test-npm-secret')
self.assertEqual(stored['npm_url'], 'http://192.168.0.12:81')
def test_invalid_settings_and_stale_revision_do_not_change_credentials(self):
state = self.install()
before = self.connections.read_bytes()
for field, value in [('npm_url', 'http://192.168.0.12/api'), ('api_ca_pem', 'not a certificate')]:
settings = copy.deepcopy(self.settings)
settings['revision'] = state['revision']
settings['connections'][field] = value
self.assertEqual(self.request('/api/settings', settings)[0], 400)
self.assertEqual(self.connections.read_bytes(), before)
self.assertEqual(self.request('/api/settings', self.settings)[0], 409)
self.assertEqual(self.connections.read_bytes(), before)
def test_acl_host_and_same_origin_work_without_fixed_origin(self):
self.connect()
self.assertEqual(self.request(peer='8.8.8.8')[0], 403)
for headers in ({'Host': 'attacker.example'}, {'Origin': 'http://attacker.example'}, {'X-Homegate-CSRF': ''}):
self.assertEqual(self.request('/api/settings', self.settings, headers=headers)[0], 403)
self.install()
self.assertEqual(self.request(peer='192.168.1.20')[0], 403)
self.assertEqual(self.request(headers={'Host': 'homegate.home'})[0], 200)
def test_controller_reloads_connections_on_each_cycle(self):
self.install()
with patch.dict(os.environ, {'HOMEGATE_CONNECTIONS': str(self.connections)}, clear=True), patch.object(h, 'NPM') as npm, patch.object(h, 'PiHole') as dns, patch.object(h, 'reconcile'):
h.cycle(self.settings['config'], self.root, None, {})
npm.assert_called_with('http://192.168.0.11:81', 'NPM', True)
npm.return_value.login.assert_called_with('admin@example.com', 'test-npm-secret')
dns.return_value.login.assert_called_with('test-pihole-secret')
settings = h.read_json(self.connections)
settings.update(npm_url='http://192.168.0.12:81', npm_password='changed')
h.save_json(self.connections, settings)
h.cycle(self.settings['config'], self.root, None, {})
npm.assert_called_with('http://192.168.0.12:81', 'NPM', True)
npm.return_value.login.assert_called_with('admin@example.com', 'changed')
class StandaloneTests(unittest.TestCase):
def test_no_user_environment_required(self):
env = standalone.runtime_environment({})
self.assertEqual(env['UI_AUTH_MODE'], 'none')
self.assertEqual(env['HOMEGATE_MANAGED_UI'], '1')
self.assertNotIn('HOMEGATE_LAN_IP', env)
self.assertNotIn('NPM_PASSWORD', env)
def test_child_failure_stops_remaining_processes(self):
processes = []
popen = subprocess.Popen
def start(*args, **kwargs):
process = popen(*args, **kwargs)
processes.append(process)
return process
with patch.object(standalone.subprocess, 'Popen', side_effect=start):
result = standalone.supervise([[sys.executable, '-c', 'raise SystemExit(3)'],
[sys.executable, '-c', 'import time; time.sleep(60)']], {})
self.assertEqual(result, 1)
self.assertTrue(all(process.poll() is not None for process in processes))

13
ui/dist/app.js vendored
View File

@@ -31,13 +31,14 @@ const services = () => data.config.services || [];
const sshEntries = () => [...services().filter(r=>r.enabled!==false&&r.ssh&&r.ssh.enabled!==false).map(r=>({aliases:[...(r.ssh.alias?[r.ssh.alias]:[]),r.hostname].filter((x,i,a)=>a.indexOf(x)===i),host:r.ssh.host||new URL(r.upstream).hostname,port:r.ssh.port||22,user:r.ssh.user})),...(data.config.ssh_hosts||[]).filter(r=>r.enabled!==false)]; const sshEntries = () => [...services().filter(r=>r.enabled!==false&&r.ssh&&r.ssh.enabled!==false).map(r=>({aliases:[...(r.ssh.alias?[r.ssh.alias]:[]),r.hostname].filter((x,i,a)=>a.indexOf(x)===i),host:r.ssh.host||new URL(r.upstream).hostname,port:r.ssh.port||22,user:r.ssh.user})),...(data.config.ssh_hosts||[]).filter(r=>r.enabled!==false)];
const controller = () => data.controller || {}; const controller = () => data.controller || {};
const isApplied = () => controller().fresh && controller().ok && controller().applied_revision===data.revision; const isApplied = () => controller().fresh && controller().ok && controller().applied_revision===data.revision;
const sshUrl = () => data.ssh_url || `http://${data.config.proxy_ip}:8099/ssh-config`; const sshUrl = () => data.ssh_url || `http://${location.hostname}:8099/ssh-config`;
async function api(path, body) { async function api(path, body, retry=true) {
const options = {credentials:'same-origin',headers:{}}; const options = {credentials:'same-origin',headers:{}};
if(body!==undefined){options.method='POST';options.headers={'Content-Type':'application/json','X-Homegate-CSRF':csrf};options.body=JSON.stringify(body);} if(body!==undefined){options.method='POST';options.headers={'Content-Type':'application/json','X-Homegate-CSRF':csrf};options.body=JSON.stringify(body);}
const r=await fetch(path,options); const r=await fetch(path,options);
const value=(r.headers.get('content-type')||'').includes('application/json')?await r.json():await r.text(); const value=(r.headers.get('content-type')||'').includes('application/json')?await r.json():await r.text();
if(r.status===401 && retry && path!=='/api/session' && data?.auth_required===false){const session=await api('/api/session');csrf=session.csrf;return api(path,body,false);}
if(!r.ok) {if(r.status===401&&path!=='/api/login')showLogin();throw new Error(value.error||`Ошибка ${r.status}`);} if(!r.ok) {if(r.status===401&&path!=='/api/login')showLogin();throw new Error(value.error||`Ошибка ${r.status}`);}
return value; return value;
} }
@@ -50,7 +51,7 @@ function nav(){
$('#navigation').innerHTML=pages.map(([id,label,i])=>`<a class="nav-item ${tab===id?'active':''}" href="#${id}" ${tab===id?'aria-current="page"':''}>${icon(i,18)}<span>${label}</span>${id==='services'?`<span class="nav-count">${services().length}</span>`:''}</a>`).join(''); $('#navigation').innerHTML=pages.map(([id,label,i])=>`<a class="nav-item ${tab===id?'active':''}" href="#${id}" ${tab===id?'aria-current="page"':''}>${icon(i,18)}<span>${label}</span>${id==='services'?`<span class="nav-count">${services().length}</span>`:''}</a>`).join('');
$('#crumb').textContent=pages.find(p=>p[0]===tab)[1]; $('#crumb').textContent=pages.find(p=>p[0]===tab)[1];
} }
function statusStrip(){const c=controller();if(!c.fresh)return `<div class="status-strip">${icon('info',15)}<span><strong>Контроллер пока не подключён.</strong> Настройки сохраняются здесь. Для применения запустите Homegate в Docker.</span><button class="btn link" data-action="guide">Подключить ${icon('arrow',12)}</button></div>`; function statusStrip(){const c=controller();if(!c.fresh&&data.connections)return `<div class="status-strip">${icon('clock',15)}<span>Контроллер запускается. Состояние подключений появится здесь автоматически.</span></div>`;if(!c.fresh)return `<div class="status-strip">${icon('info',15)}<span><strong>Контроллер пока не подключён.</strong> Настройки сохраняются здесь. Для применения запустите Homegate в Docker.</span><button class="btn link" data-action="guide">Подключить ${icon('arrow',12)}</button></div>`;
if(!c.ok)return `<div class="status-strip bad">${icon('info',15)}<span><strong>Не удалось применить настройки.</strong> ${esc(c.error||'Проверьте подключение к Pi-hole и NPM.')}</span><button class="btn link" data-action="sync">Повторить</button></div>`; if(!c.ok)return `<div class="status-strip bad">${icon('info',15)}<span><strong>Не удалось применить настройки.</strong> ${esc(c.error||'Проверьте подключение к Pi-hole и NPM.')}</span><button class="btn link" data-action="sync">Повторить</button></div>`;
if(!isApplied())return `<div class="status-strip">${icon('clock',15)}<span><strong>Есть новые настройки.</strong> Контроллер применит их в следующем цикле.</span><button class="btn link" data-action="sync">Применить сейчас</button></div>`; if(!isApplied())return `<div class="status-strip">${icon('clock',15)}<span><strong>Есть новые настройки.</strong> Контроллер применит их в следующем цикле.</span><button class="btn link" data-action="sync">Применить сейчас</button></div>`;
return `<div class="status-strip good">${icon('check',15)}<span>Конфигурация применена <strong>в ${time(c.time)}</strong>. Доступность самих VM проверяется отдельно.</span><button class="btn link" data-action="sync">Обновить ${icon('refresh',12)}</button></div>`; return `<div class="status-strip good">${icon('check',15)}<span>Конфигурация применена <strong>в ${time(c.time)}</strong>. Доступность самих VM проверяется отдельно.</span><button class="btn link" data-action="sync">Обновить ${icon('refresh',12)}</button></div>`;
@@ -69,9 +70,9 @@ function renderServices(){const c=controller();const first=services().find(r=>r.
function renderDomains(){const root=controller().root;return heading('Доменные зоны','Свои имена для разных частей вашей домашней сети.',`<button class="btn primary" data-action="add-zone">${icon('plus',15)} Добавить зону</button>`)+`<div class="zones-grid">${zones().map((z,i)=>{const count=services().filter(r=>r.hostname===z||r.hostname.endsWith('.'+z)).length;const covered=root&&root.zones.some(p=>z===p||z.endsWith('.'+p));return `<article class="panel zone-card"><div class="zone-top"><span class="zone-symbol">${icon('globe',21)}</span><button class="icon-button danger" data-action="remove-zone" data-index="${i}" aria-label="Удалить зону ${esc(z)}">${icon('trash',14)}</button></div><div class="zone-name">.${esc(z)}</div><p class="zone-caption">${count} ${count===1?'сервис':'сервисов'} в этой зоне</p><div class="zone-foot">${root?(covered?badge('Разрешена CA','success'):badge('Нужна смена CA')):badge('CA ещё не создан','muted')}<span class="mono">DNS / TLS</span></div></article>`;}).join('')}</div><div class="info-box">${icon('info',19)}<p><strong>Домены работают внутри вашей сети.</strong><br>Pi-hole направляет имена на NPM. Для домашних сетей подходит <span class="mono">home.arpa</span>; можно использовать и собственные зоны.</p></div>${root?`<div class="info-box warning">${icon('shield',19)}<p><strong>Новая зона может потребовать нового корневого сертификата.</strong><br>Если зона вне ограничений текущего CA, выполните миграцию и установите новый корень на устройства. <button class="btn link" data-action="ca-guide">Инструкция ${icon('arrow',12)}</button></p></div>`:''}`;} function renderDomains(){const root=controller().root;return heading('Доменные зоны','Свои имена для разных частей вашей домашней сети.',`<button class="btn primary" data-action="add-zone">${icon('plus',15)} Добавить зону</button>`)+`<div class="zones-grid">${zones().map((z,i)=>{const count=services().filter(r=>r.hostname===z||r.hostname.endsWith('.'+z)).length;const covered=root&&root.zones.some(p=>z===p||z.endsWith('.'+p));return `<article class="panel zone-card"><div class="zone-top"><span class="zone-symbol">${icon('globe',21)}</span><button class="icon-button danger" data-action="remove-zone" data-index="${i}" aria-label="Удалить зону ${esc(z)}">${icon('trash',14)}</button></div><div class="zone-name">.${esc(z)}</div><p class="zone-caption">${count} ${count===1?'сервис':'сервисов'} в этой зоне</p><div class="zone-foot">${root?(covered?badge('Разрешена CA','success'):badge('Нужна смена CA')):badge('CA ещё не создан','muted')}<span class="mono">DNS / TLS</span></div></article>`;}).join('')}</div><div class="info-box">${icon('info',19)}<p><strong>Домены работают внутри вашей сети.</strong><br>Pi-hole направляет имена на NPM. Для домашних сетей подходит <span class="mono">home.arpa</span>; можно использовать и собственные зоны.</p></div>${root?`<div class="info-box warning">${icon('shield',19)}<p><strong>Новая зона может потребовать нового корневого сертификата.</strong><br>Если зона вне ограничений текущего CA, выполните миграцию и установите новый корень на устройства. <button class="btn link" data-action="ca-guide">Инструкция ${icon('arrow',12)}</button></p></div>`:''}`;}
function renderSSH(){const entries=sshEntries();return heading('SSH-доступ','Один дополнительный конфиг для всех ваших компьютеров.',`<a class="btn" href="/downloads/sync_ssh.py">${icon('download',14)} Скрипт для ПК</a><a class="btn primary" href="/downloads/ssh-config">${icon('download',14)} Скачать конфиг</a>`)+`<div class="two-col"><section class="code-panel"><div class="code-top"><span>~/.ssh/config.d/homegate.conf</span><button class="icon-button" data-action="copy-ssh-config" aria-label="Скопировать SSH-конфиг">${icon('copy',15)}</button></div><pre id="ssh-preview">Загружаем конфиг…</pre></section><section class="panel panel-pad"><div class="panel-heading">Подключите за пару минут</div><div class="step"><span class="step-number">1</span><div><strong>Скачайте скрипт на компьютер</strong><p>Python 3.9+ и OpenSSH. Приватные ключи остаются у вас.</p><a class="btn small" href="/downloads/sync_ssh.py">${icon('download',12)} sync_ssh.py</a></div></div><div class="step"><span class="step-number">2</span><div><strong>Подключите дополнительный файл</strong><p>Основной SSH-конфиг сохраняется. Для Windows используйте <span class="mono">py -3</span>.</p><div class="command-line"><code>python3 sync_ssh.py ${esc(sshUrl())} --install</code><button class="icon-button" data-action="copy-install" aria-label="Скопировать команду установки">${icon('copy',13)}</button></div></div></div><div class="step"><span class="step-number">3</span><div><strong>Подключайтесь по имени</strong><p>При следующих обновлениях запустите скрипт без <span class="mono">--install</span>.</p><div class="command-line"><code>ssh ${esc(entries[0]?.aliases[0]||'имя-сервера')}</code><button class="icon-button" data-action="copy-ssh-command" aria-label="Скопировать SSH-команду">${icon('copy',13)}</button></div></div></div></section></div><div class="info-box">${icon('lock',18)}<p><strong>Открытая выгрузка только для вашей LAN.</strong><br><span class="mono">${esc(sshUrl())}</span><br>${data.mode==='local'?'Этот адрес заработает после запуска ssh-export в Docker. Сейчас конфиг можно скачать кнопкой выше.':'Доступ ограничен разрешёнными подсетями. Пароль панели для этой выгрузки не нужен.'}</p></div><div class="section-heading"><h2>Серверы без веб-интерфейса <span class="count-label">${(data.config.ssh_hosts||[]).length}</span></h2><button class="btn small" data-action="add-ssh">${icon('plus',13)} Добавить SSH-хост</button></div><section class="panel"><div class="table-scroll"><table><thead><tr><th>Псевдонимы</th><th>Адрес</th><th>Пользователь</th><th></th></tr></thead><tbody>${(data.config.ssh_hosts||[]).map((r,i)=>`<tr><td><strong>${esc(r.aliases.join(', '))}</strong> ${r.enabled===false?badge('Выключен','muted'):''}</td><td class="mono">${esc(r.host)}:${r.port||22}</td><td>${esc(r.user||'Из личного конфига')}</td><td><div class="row-actions"><button class="icon-button" data-action="edit-ssh" data-index="${i}" aria-label="Изменить SSH-хост">${icon('edit',14)}</button><button class="icon-button danger" data-action="remove-ssh" data-index="${i}" aria-label="Удалить SSH-хост">${icon('trash',14)}</button></div></td></tr>`).join('')||`<tr><td colspan="4"><div class="empty">${icon('server',25)}<p>Здесь можно добавить NAS, backup-сервер или любую машину с SSH.<br>SSH веб-сервисов настраивается в карточке сервиса.</p></div></td></tr>`}</tbody></table></div></section>`;} function renderSSH(){const entries=sshEntries();return heading('SSH-доступ','Один дополнительный конфиг для всех ваших компьютеров.',`<a class="btn" href="/downloads/sync_ssh.py">${icon('download',14)} Скрипт для ПК</a><a class="btn primary" href="/downloads/ssh-config">${icon('download',14)} Скачать конфиг</a>`)+`<div class="two-col"><section class="code-panel"><div class="code-top"><span>~/.ssh/config.d/homegate.conf</span><button class="icon-button" data-action="copy-ssh-config" aria-label="Скопировать SSH-конфиг">${icon('copy',15)}</button></div><pre id="ssh-preview">Загружаем конфиг…</pre></section><section class="panel panel-pad"><div class="panel-heading">Подключите за пару минут</div><div class="step"><span class="step-number">1</span><div><strong>Скачайте скрипт на компьютер</strong><p>Python 3.9+ и OpenSSH. Приватные ключи остаются у вас.</p><a class="btn small" href="/downloads/sync_ssh.py">${icon('download',12)} sync_ssh.py</a></div></div><div class="step"><span class="step-number">2</span><div><strong>Подключите дополнительный файл</strong><p>Основной SSH-конфиг сохраняется. Для Windows используйте <span class="mono">py -3</span>.</p><div class="command-line"><code>python3 sync_ssh.py ${esc(sshUrl())} --install</code><button class="icon-button" data-action="copy-install" aria-label="Скопировать команду установки">${icon('copy',13)}</button></div></div></div><div class="step"><span class="step-number">3</span><div><strong>Подключайтесь по имени</strong><p>При следующих обновлениях запустите скрипт без <span class="mono">--install</span>.</p><div class="command-line"><code>ssh ${esc(entries[0]?.aliases[0]||'имя-сервера')}</code><button class="icon-button" data-action="copy-ssh-command" aria-label="Скопировать SSH-команду">${icon('copy',13)}</button></div></div></div></section></div><div class="info-box">${icon('lock',18)}<p><strong>Открытая выгрузка только для вашей LAN.</strong><br><span class="mono">${esc(sshUrl())}</span><br>${data.mode==='local'?'Этот адрес заработает после запуска ssh-export в Docker. Сейчас конфиг можно скачать кнопкой выше.':'Доступ ограничен разрешёнными подсетями. Пароль панели для этой выгрузки не нужен.'}</p></div><div class="section-heading"><h2>Серверы без веб-интерфейса <span class="count-label">${(data.config.ssh_hosts||[]).length}</span></h2><button class="btn small" data-action="add-ssh">${icon('plus',13)} Добавить SSH-хост</button></div><section class="panel"><div class="table-scroll"><table><thead><tr><th>Псевдонимы</th><th>Адрес</th><th>Пользователь</th><th></th></tr></thead><tbody>${(data.config.ssh_hosts||[]).map((r,i)=>`<tr><td><strong>${esc(r.aliases.join(', '))}</strong> ${r.enabled===false?badge('Выключен','muted'):''}</td><td class="mono">${esc(r.host)}:${r.port||22}</td><td>${esc(r.user||'Из личного конфига')}</td><td><div class="row-actions"><button class="icon-button" data-action="edit-ssh" data-index="${i}" aria-label="Изменить SSH-хост">${icon('edit',14)}</button><button class="icon-button danger" data-action="remove-ssh" data-index="${i}" aria-label="Удалить SSH-хост">${icon('trash',14)}</button></div></td></tr>`).join('')||`<tr><td colspan="4"><div class="empty">${icon('server',25)}<p>Здесь можно добавить NAS, backup-сервер или любую машину с SSH.<br>SSH веб-сервисов настраивается в карточке сервиса.</p></div></td></tr>`}</tbody></table></div></section>`;}
function renderCertificates(){const root=controller().root;const certs=controller().certificates||[];return heading('Сертификаты','Доверенный HTTPS для локальных адресов.',`<button class="btn" data-action="ca-guide">${icon('refresh',14)} Смена CA</button>${root?`<a class="btn primary" href="/downloads/root-ca.crt">${icon('download',14)} Скачать корневой CA</a>`:''}`)+`<div class="two-col"><section class="panel certificate-card"><div class="certificate-art">${icon('shield',29)}</div><h2>Homegate Local Root CA</h2><p class="panel-description">Ваш центр сертификации внутри домашней сети.</p><div class="key-details"><div class="detail-line"><span>Состояние</span>${root?badge('Создан','success'):badge('Ожидает запуска','muted')}</div><div class="detail-line"><span>Действует до</span><strong>${date(root?.expires)}</strong></div><div class="detail-line"><span>Зоны в сертификате</span><strong>${esc(root?.zones.join(', ')||'Определятся при первом запуске')}</strong></div><div class="detail-line"><span>Срок сертификата сервиса</span><strong>90 дней</strong></div><div class="detail-line"><span>Продление</span><strong>Когда осталось менее 30 дней</strong></div></div>${root?`<span class="note">Отпечаток SHA-256</span><div class="fingerprint">${esc(root.fingerprint)}</div>`:`<div class="info-box">${icon('info',17)}<p>Корень создаётся контроллером. Сейчас панель не видит его данные.</p></div>`}</section><div class="stack"><section class="panel panel-pad"><div class="panel-heading">Установите доверие на устройства</div><p class="panel-description">Сертификат на сервере не добавляет доверие на компьютере или телефоне.</p><div class="step"><span class="step-number">1</span><div><strong>Скачайте только root-ca.crt</strong><p>Сверьте отпечаток с сервером. Приватный ключ CA никогда не публикуется в панели.</p></div></div><div class="step"><span class="step-number">2</span><div><strong>Импортируйте как доверенный корневой CA</strong><p>Windows — доверенные корневые центры.<br>macOS — Связка ключей → System → Always Trust.<br>iOS — включите Full Trust после установки.</p></div></div><div class="step"><span class="step-number">3</span><div><strong>Откройте сервис по доменному имени</strong><p>Например, https://${esc(services()[0]?.hostname||'service.home')}. Проверка сертификата по IP — другой запрос.</p></div></div></section><div class="info-box warning">${icon('shield',17)}<p>Проверка TLS между NPM и самой VM настраивается отдельно для каждого сервиса.</p></div></div></div><div class="section-heading"><h2>Сертификаты сервисов</h2><span class="section-kicker">Данные контроллера</span></div><section class="panel"><table><thead><tr><th>Домен</th><th>Действует до</th></tr></thead><tbody>${certs.map(c=>`<tr><td class="domain-link">${icon('lock',12)} ${esc(c.hostname)}</td><td>${date(c.expires)}</td></tr>`).join('')||'<tr><td colspan="2"><div class="empty"><p>После первого применения здесь появятся выданные сертификаты.</p></div></td></tr>'}</tbody></table></section>`;} function renderCertificates(){const root=controller().root;const certs=controller().certificates||[];return heading('Сертификаты','Доверенный HTTPS для локальных адресов.',`<button class="btn" data-action="ca-guide">${icon('refresh',14)} Смена CA</button>${root?`<a class="btn primary" href="/downloads/root-ca.crt">${icon('download',14)} Скачать корневой CA</a>`:''}`)+`<div class="two-col"><section class="panel certificate-card"><div class="certificate-art">${icon('shield',29)}</div><h2>Homegate Local Root CA</h2><p class="panel-description">Ваш центр сертификации внутри домашней сети.</p><div class="key-details"><div class="detail-line"><span>Состояние</span>${root?badge('Создан','success'):badge('Ожидает запуска','muted')}</div><div class="detail-line"><span>Действует до</span><strong>${date(root?.expires)}</strong></div><div class="detail-line"><span>Зоны в сертификате</span><strong>${esc(root?.zones.join(', ')||'Определятся при первом запуске')}</strong></div><div class="detail-line"><span>Срок сертификата сервиса</span><strong>90 дней</strong></div><div class="detail-line"><span>Продление</span><strong>Когда осталось менее 30 дней</strong></div></div>${root?`<span class="note">Отпечаток SHA-256</span><div class="fingerprint">${esc(root.fingerprint)}</div>`:`<div class="info-box">${icon('info',17)}<p>Корень создаётся контроллером. Сейчас панель не видит его данные.</p></div>`}</section><div class="stack"><section class="panel panel-pad"><div class="panel-heading">Установите доверие на устройства</div><p class="panel-description">Сертификат на сервере не добавляет доверие на компьютере или телефоне.</p><div class="step"><span class="step-number">1</span><div><strong>Скачайте только root-ca.crt</strong><p>Сверьте отпечаток с сервером. Приватный ключ CA никогда не публикуется в панели.</p></div></div><div class="step"><span class="step-number">2</span><div><strong>Импортируйте как доверенный корневой CA</strong><p>Windows — доверенные корневые центры.<br>macOS — Связка ключей → System → Always Trust.<br>iOS — включите Full Trust после установки.</p></div></div><div class="step"><span class="step-number">3</span><div><strong>Откройте сервис по доменному имени</strong><p>Например, https://${esc(services()[0]?.hostname||'service.home')}. Проверка сертификата по IP — другой запрос.</p></div></div></section><div class="info-box warning">${icon('shield',17)}<p>Проверка TLS между NPM и самой VM настраивается отдельно для каждого сервиса.</p></div></div></div><div class="section-heading"><h2>Сертификаты сервисов</h2><span class="section-kicker">Данные контроллера</span></div><section class="panel"><table><thead><tr><th>Домен</th><th>Действует до</th></tr></thead><tbody>${certs.map(c=>`<tr><td class="domain-link">${icon('lock',12)} ${esc(c.hostname)}</td><td>${date(c.expires)}</td></tr>`).join('')||'<tr><td colspan="2"><div class="empty"><p>После первого применения здесь появятся выданные сертификаты.</p></div></td></tr>'}</tbody></table></section>`;}
function renderSettings(){const c=data.config;return heading('Настройки сети','Адрес прокси, разрешённые подсети и частота обновления.')+`<div class="settings-grid"><form id="settings-form" class="panel"><section class="form-section"><h2>Ваша локальная сеть</h2><p>Доменные имена сервисов будут указывать на адрес NPM.</p><div class="form-grid"><label class="field">IP Nginx Proxy Manager<input name="proxy_ip" value="${esc(c.proxy_ip)}" required><small>Например, 192.168.0.10</small></label><label class="field">Обновление, секунд<input name="interval_seconds" type="number" min="30" max="3600" value="${c.interval_seconds||60}" required></label><label class="field full">Разрешённые подсети<textarea name="allowed_networks" rows="3" required>${esc(c.allowed_networks.join('\n'))}</textarea><small>По одной подсети в строке. Например, 192.168.0.0/24. Влияет на веб-сервисы и доступ к панели/SSH-выгрузке.</small></label></div></section><section class="form-section"><h2>Локальный DNS</h2><p>Выберите, кто создаёт записи для сервисов.</p><label class="field">Управление записями<select name="dns_mode"><option value="pihole6" ${c.dns_mode!=='manual'?'selected':''}>Автоматически — Pi-hole 6</option><option value="manual" ${c.dns_mode==='manual'?'selected':''}>Вручную — Pi-hole 5 или другой DNS</option></select></label><div id="settings-error" class="form-error" hidden></div></section><div class="form-footer"><button class="btn primary" type="submit">${icon('check',14)} Сохранить настройки</button></div></form><div class="stack"><section class="panel panel-pad"><div class="panel-heading">Подключения</div><p class="panel-description">Пароли остаются в Docker secrets на сервере.</p><div class="integration"><span class="integration-icon">${icon('globe',19)}</span><div><strong>Pi-hole</strong><small>${c.dns_mode==='manual'?'Ручное управление DNS':'DNS-записи через API'}</small></div>${badge(controller().fresh&&controller().ok?'Синхронизирован':'Нет данных',controller().fresh&&controller().ok?'success':'muted')}</div><div class="integration"><span class="integration-icon">${icon('route',19)}</span><div><strong>Nginx Proxy Manager</strong><small>Прокси и HTTPS</small></div>${badge(controller().fresh&&controller().ok?'Синхронизирован':'Нет данных',controller().fresh&&controller().ok?'success':'muted')}</div><p class="note">Адреса API и учётные данные задаются в .env и secrets/ при установке.</p><button class="btn small" data-action="guide" type="button">Как подключить ${icon('arrow',12)}</button></section><section class="panel panel-pad"><div class="panel-heading">Последние изменения</div>${data.history.length?data.history.map(item=>`<div class="history-item">${icon('check',13)}<p>${esc(item.text)}</p><time>${time(item.time)}</time></div>`).join(''):'<p class="panel-description">Здесь появятся сохранения из панели.</p>'}</section><a class="btn" href="/downloads/services.yaml">${icon('download',14)} Скачать текущий YAML</a></div></div>`;} function renderSettings(){if(data.connections)return renderManagedSettings();const c=data.config;return heading('Настройки сети','Адрес прокси, разрешённые подсети и частота обновления.')+`<div class="settings-grid"><form id="settings-form" class="panel"><section class="form-section"><h2>Ваша локальная сеть</h2><p>Доменные имена сервисов будут указывать на адрес NPM.</p><div class="form-grid"><label class="field">IP Nginx Proxy Manager<input name="proxy_ip" value="${esc(c.proxy_ip)}" required><small>Например, 192.168.0.10</small></label><label class="field">Обновление, секунд<input name="interval_seconds" type="number" min="30" max="3600" value="${c.interval_seconds||60}" required></label><label class="field full">Разрешённые подсети<textarea name="allowed_networks" rows="3" required>${esc(c.allowed_networks.join('\n'))}</textarea><small>По одной подсети в строке. Например, 192.168.0.0/24. Влияет на веб-сервисы и доступ к панели/SSH-выгрузке.</small></label></div></section><section class="form-section"><h2>Локальный DNS</h2><p>Выберите, кто создаёт записи для сервисов.</p><label class="field">Управление записями<select name="dns_mode"><option value="pihole6" ${c.dns_mode!=='manual'?'selected':''}>Автоматически — Pi-hole 6</option><option value="manual" ${c.dns_mode==='manual'?'selected':''}>Вручную — Pi-hole 5 или другой DNS</option></select></label><div id="settings-error" class="form-error" hidden></div></section><div class="form-footer"><button class="btn primary" type="submit">${icon('check',14)} Сохранить настройки</button></div></form><div class="stack"><section class="panel panel-pad"><div class="panel-heading">Подключения</div><p class="panel-description">Пароли остаются в Docker secrets на сервере.</p><div class="integration"><span class="integration-icon">${icon('globe',19)}</span><div><strong>Pi-hole</strong><small>${c.dns_mode==='manual'?'Ручное управление DNS':'DNS-записи через API'}</small></div>${badge(controller().fresh&&controller().ok?'Синхронизирован':'Нет данных',controller().fresh&&controller().ok?'success':'muted')}</div><div class="integration"><span class="integration-icon">${icon('route',19)}</span><div><strong>Nginx Proxy Manager</strong><small>Прокси и HTTPS</small></div>${badge(controller().fresh&&controller().ok?'Синхронизирован':'Нет данных',controller().fresh&&controller().ok?'success':'muted')}</div><p class="note">Адреса API и учётные данные задаются в .env и secrets/ при установке.</p><button class="btn small" data-action="guide" type="button">Как подключить ${icon('arrow',12)}</button></section><section class="panel panel-pad"><div class="panel-heading">Последние изменения</div>${data.history.length?data.history.map(item=>`<div class="history-item">${icon('check',13)}<p>${esc(item.text)}</p><time>${time(item.time)}</time></div>`).join(''):'<p class="panel-description">Здесь появятся сохранения из панели.</p>'}</section><a class="btn" href="/downloads/services.yaml">${icon('download',14)} Скачать текущий YAML</a></div></div>`;}
function render(){if(!data)return;tab=pages.some(p=>p[0]===location.hash.slice(1))?location.hash.slice(1):'services';nav();$('#content').innerHTML=({services:renderServices,domains:renderDomains,ssh:renderSSH,certificates:renderCertificates,settings:renderSettings})[tab]();$('#yaml-download').innerHTML=icon('download',16);$('#logout').hidden=data.mode==='local';$('#service-search')?.addEventListener('input',e=>{search=e.target.value;$('#service-rows').innerHTML=serviceRows();});if(tab==='ssh')api('/api/ssh-config').then(text=>{if($('#ssh-preview'))$('#ssh-preview').textContent=text;}).catch(e=>toast(e.message,true));if(tab==='settings'){const form=$('#settings-form');form.addEventListener('input',()=>settingsDirty=true);form.addEventListener('submit',saveSettings);}} function render(){if(!data)return;tab=pages.some(p=>p[0]===location.hash.slice(1))?location.hash.slice(1):'services';if(data.setup_required)tab='settings';nav();$('#content').innerHTML=({services:renderServices,domains:renderDomains,ssh:renderSSH,certificates:renderCertificates,settings:renderSettings})[tab]();$('#yaml-download').innerHTML=icon('download',16);$('#logout').hidden=data.auth_required===false;$('#yaml-download').hidden=data.setup_required;$('#service-search')?.addEventListener('input',e=>{search=e.target.value;$('#service-rows').innerHTML=serviceRows();});if(tab==='ssh')api('/api/ssh-config').then(text=>{if($('#ssh-preview'))$('#ssh-preview').textContent=text;}).catch(e=>toast(e.message,true));if(tab==='settings'){const form=$('#settings-form');form.addEventListener('input',()=>settingsDirty=true);form.addEventListener('submit',data.connections?saveManagedSettings:saveSettings);if(data.connections)bindManagedSettings(form);}}
async function refresh(){data=await api('/api/state');render();} async function refresh(){data=await api('/api/state');render();}
async function saveConfig(config){if(busy)throw new Error('Подождите завершения сохранения');busy=true;try{data=await api('/api/config',{config,revision:data.revision});settingsDirty=false;render();toast(controller().fresh?'Настройки сохранены. Контроллер применит их в следующем цикле.':'Настройки сохранены локально. Для применения подключите контроллер.');}finally{busy=false;}} async function saveConfig(config){if(busy)throw new Error('Подождите завершения сохранения');busy=true;try{data=await api('/api/config',{config,revision:data.revision});settingsDirty=false;render();toast(controller().fresh?'Настройки сохранены. Контроллер применит их в следующем цикле.':'Настройки сохранены локально. Для применения подключите контроллер.');}finally{busy=false;}}
@@ -85,7 +86,7 @@ async function modalSave(config){try{await saveConfig(config);$('#modal').close(
function zoneModal(){showModal('Новая доменная зона','Все сервисы этой зоны будут доступны через локальный DNS.',`<form id="modal-form"><div class="modal-body"><label class="field">Доменная зона<input name="zone" placeholder="lab.internal" required autocomplete="off"><small>Без *. Поддомены сервисов добавляются отдельно.</small></label>${controller().root?'<div class="info-box warning"><p>Для зоны вне ограничений текущего корня потребуется смена CA и установка нового сертификата на устройства.</p></div>':''}<div class="form-error" id="modal-error" hidden></div></div></form>`,modalFooter('Добавить зону'));$('#modal-form').addEventListener('submit',async e=>{e.preventDefault();const z=new FormData(e.target).get('zone').trim().toLowerCase().replace(/^\.+|\.+$/g,'');const c=clone(data.config);c.domain_zones=[...zones(),z];await modalSave(c);});} function zoneModal(){showModal('Новая доменная зона','Все сервисы этой зоны будут доступны через локальный DNS.',`<form id="modal-form"><div class="modal-body"><label class="field">Доменная зона<input name="zone" placeholder="lab.internal" required autocomplete="off"><small>Без *. Поддомены сервисов добавляются отдельно.</small></label>${controller().root?'<div class="info-box warning"><p>Для зоны вне ограничений текущего корня потребуется смена CA и установка нового сертификата на устройства.</p></div>':''}<div class="form-error" id="modal-error" hidden></div></div></form>`,modalFooter('Добавить зону'));$('#modal-form').addEventListener('submit',async e=>{e.preventDefault();const z=new FormData(e.target).get('zone').trim().toLowerCase().replace(/^\.+|\.+$/g,'');const c=clone(data.config);c.domain_zones=[...zones(),z];await modalSave(c);});}
function sshModal(index=-1){const r=index<0?{}:data.config.ssh_hosts[index];showModal(index<0?'Новый SSH-хост':'Настройки SSH-хоста','Прямое подключение к машине без создания веб-прокси.',`<form id="modal-form"><div class="modal-body"><div class="form-grid"><label class="field full">Псевдонимы через запятую<input name="aliases" value="${esc(r.aliases?.join(', ')||'')}" placeholder="backup, backup.lab.internal" required></label><label class="field">IP сервера<input name="host" value="${esc(r.host||'')}" placeholder="192.168.0.150" required></label><label class="field">Порт<input name="port" type="number" min="1" max="65535" value="${r.port||22}" required></label><label class="field full">Пользователь<input name="user" value="${esc(r.user||'')}" placeholder="Из личного SSH-конфига"></label><label class="check-line"><input name="enabled" type="checkbox" ${r.enabled!==false?'checked':''}> Включить в выгрузку</label></div><div class="form-error" id="modal-error" hidden></div></div></form>`,modalFooter());$('#modal-form').addEventListener('submit',async e=>{e.preventDefault();const f=new FormData(e.target);const item={aliases:f.get('aliases').split(',').map(x=>x.trim().toLowerCase()).filter(Boolean),host:f.get('host').trim(),port:Number(f.get('port')),enabled:f.has('enabled')};if(f.get('user').trim())item.user=f.get('user').trim();const c=clone(data.config);c.ssh_hosts||=[];if(index<0)c.ssh_hosts.push(item);else c.ssh_hosts[index]=item;await modalSave(c);});} function sshModal(index=-1){const r=index<0?{}:data.config.ssh_hosts[index];showModal(index<0?'Новый SSH-хост':'Настройки SSH-хоста','Прямое подключение к машине без создания веб-прокси.',`<form id="modal-form"><div class="modal-body"><div class="form-grid"><label class="field full">Псевдонимы через запятую<input name="aliases" value="${esc(r.aliases?.join(', ')||'')}" placeholder="backup, backup.lab.internal" required></label><label class="field">IP сервера<input name="host" value="${esc(r.host||'')}" placeholder="192.168.0.150" required></label><label class="field">Порт<input name="port" type="number" min="1" max="65535" value="${r.port||22}" required></label><label class="field full">Пользователь<input name="user" value="${esc(r.user||'')}" placeholder="Из личного SSH-конфига"></label><label class="check-line"><input name="enabled" type="checkbox" ${r.enabled!==false?'checked':''}> Включить в выгрузку</label></div><div class="form-error" id="modal-error" hidden></div></div></form>`,modalFooter());$('#modal-form').addEventListener('submit',async e=>{e.preventDefault();const f=new FormData(e.target);const item={aliases:f.get('aliases').split(',').map(x=>x.trim().toLowerCase()).filter(Boolean),host:f.get('host').trim(),port:Number(f.get('port')),enabled:f.has('enabled')};if(f.get('user').trim())item.user=f.get('user').trim();const c=clone(data.config);c.ssh_hosts||=[];if(index<0)c.ssh_hosts.push(item);else c.ssh_hosts[index]=item;await modalSave(c);});}
function confirmModal(title,text,action){showModal(title,'',`<div class="modal-body"><p class="note">${text}</p><div class="form-error" id="modal-error" hidden></div></div>`,`<div class="form-footer"><button class="btn" data-action="close-modal">Отмена</button><button class="btn danger" id="confirm-action">Подтвердить</button></div>`);$('#confirm-action').addEventListener('click',action);} function confirmModal(title,text,action){showModal(title,'',`<div class="modal-body"><p class="note">${text}</p><div class="form-error" id="modal-error" hidden></div></div>`,`<div class="form-footer"><button class="btn" data-action="close-modal">Отмена</button><button class="btn danger" id="confirm-action">Подтвердить</button></div>`);$('#confirm-action').addEventListener('click',action);}
function guide(ca=false){const command=ca?'docker compose stop homegate\ndocker compose run --rm homegate rotate-ca\n# Установите новый state/root-ca.crt на устройства\ndocker compose up -d homegate':'sh setup.sh\n# Укажите адреса и пароли в .env / secrets\ndocker compose up -d --build';showModal(ca?'Смена корневого сертификата':'Подключите Homegate к вашей сети',ca?'Выполните на Docker-хосте после добавления новых зон.':'Панель готовит конфигурацию. Контроллер применяет её к Pi-hole и NPM.',`<div class="modal-body"><div class="code-panel"><div class="code-top"><span>На вашем сервере</span><button class="icon-button" id="copy-guide" aria-label="Скопировать команды">${icon('copy',15)}</button></div><pre>${esc(command)}</pre></div><p class="note">${ca?'Старый CA будет сохранён в state/ca-history. Новый корень нужно установить на все устройства до перезапуска контроллера. Эта операция не выполняется нажатием кнопки в панели.':'В .env задайте NPM_URL, NPM_IDENTITY, PIHOLE_URL и LAN-адреса панели/SSH. Пароли хранятся отдельно. В настройках панели проверьте IP NPM и разрешённые подсети.'}</p>${!ca?'<div class="info-box"><p>Для HTTPS без предупреждений установите root-ca.crt на клиентские устройства. Панель никогда не подменяет отсутствующие данные статусом «работает».</p></div>':''}</div>`,`<div class="form-footer"><button class="btn primary" data-action="close-modal">Понятно</button></div>`);$('#copy-guide').addEventListener('click',()=>copy(command));} function guide(ca=false){if(!ca&&data.connections){location.hash='settings';return;}const command=ca?'docker compose stop homegate\ndocker compose run --rm homegate rotate-ca\n# Установите новый state/root-ca.crt на устройства\ndocker compose up -d homegate':'sh setup.sh\n# Укажите адреса и пароли в .env / secrets\ndocker compose up -d --build';showModal(ca?'Смена корневого сертификата':'Подключите Homegate к вашей сети',ca?'Выполните на Docker-хосте после добавления новых зон.':'Панель готовит конфигурацию. Контроллер применяет её к Pi-hole и NPM.',`<div class="modal-body"><div class="code-panel"><div class="code-top"><span>На вашем сервере</span><button class="icon-button" id="copy-guide" aria-label="Скопировать команды">${icon('copy',15)}</button></div><pre>${esc(command)}</pre></div><p class="note">${ca?'Старый CA будет сохранён в state/ca-history. Новый корень нужно установить на все устройства до перезапуска контроллера. Эта операция не выполняется нажатием кнопки в панели.':'В .env задайте NPM_URL, NPM_IDENTITY, PIHOLE_URL и LAN-адреса панели/SSH. Пароли хранятся отдельно. В настройках панели проверьте IP NPM и разрешённые подсети.'}</p>${!ca?'<div class="info-box"><p>Для HTTPS без предупреждений установите root-ca.crt на клиентские устройства. Панель никогда не подменяет отсутствующие данные статусом «работает».</p></div>':''}</div>`,`<div class="form-footer"><button class="btn primary" data-action="close-modal">Понятно</button></div>`);$('#copy-guide').addEventListener('click',()=>copy(command));}
async function saveSettings(e){e.preventDefault();const f=new FormData(e.target);const c=clone(data.config);c.proxy_ip=f.get('proxy_ip').trim();c.allowed_networks=f.get('allowed_networks').split(/\n|,/).map(x=>x.trim()).filter(Boolean);c.dns_mode=f.get('dns_mode');c.interval_seconds=Number(f.get('interval_seconds'));try{await saveConfig(c);}catch(err){$('#settings-error').hidden=false;$('#settings-error').textContent=friendlyError(err);}} async function saveSettings(e){e.preventDefault();const f=new FormData(e.target);const c=clone(data.config);c.proxy_ip=f.get('proxy_ip').trim();c.allowed_networks=f.get('allowed_networks').split(/\n|,/).map(x=>x.trim()).filter(Boolean);c.dns_mode=f.get('dns_mode');c.interval_seconds=Number(f.get('interval_seconds'));try{await saveConfig(c);}catch(err){$('#settings-error').hidden=false;$('#settings-error').textContent=friendlyError(err);}}
document.addEventListener('click',async e=>{const button=e.target.closest('[data-action]');if(!button)return;const i=Number(button.dataset.index);const a=button.dataset.action;try{ document.addEventListener('click',async e=>{const button=e.target.closest('[data-action]');if(!button)return;const i=Number(button.dataset.index);const a=button.dataset.action;try{

1
ui/dist/index.html vendored
View File

@@ -8,6 +8,7 @@
<meta name="description" content="Управление локальными сервисами, доменными зонами, HTTPS и SSH-доступом."> <meta name="description" content="Управление локальными сервисами, доменными зонами, HTTPS и SSH-доступом.">
<link rel="icon" href="/favicon.svg" type="image/svg+xml"> <link rel="icon" href="/favicon.svg" type="image/svg+xml">
<link rel="stylesheet" href="/style.css"> <link rel="stylesheet" href="/style.css">
<script src="/settings.js" defer></script>
<script src="/app.js" defer></script> <script src="/app.js" defer></script>
</head> </head>
<body> <body>

70
ui/dist/settings.js vendored Normal file
View File

@@ -0,0 +1,70 @@
function renderManagedSettings() {
const c = data.config, links = data.connections, first = data.setup_required;
const passwordField = (name, title) => `<label class="field full">${title}<input name="${name}" type="password" autocomplete="new-password" placeholder="${links[name + '_set'] ? 'Сохранён. Оставьте пустым, чтобы не менять' : 'Пароль существующего сервиса'}" ${name === 'npm_password' && !links.npm_password_set ? 'required' : ''}></label>`;
return heading(first ? 'Подключим вашу домашнюю сеть' : 'Настройки и подключения',
first ? 'Заполните адреса здесь — Homegate сохранит настройки и начнёт работать.' : 'Все параметры сохраняются здесь и применяются автоматически.') + `
<div class="settings-grid"><form id="settings-form" class="panel">
<section class="form-section"><h2>Ваша сеть</h2><p>Сервисы будут открываться через Nginx Proxy Manager.</p>
<div class="form-grid">
<label class="field">IP Nginx Proxy Manager<input name="proxy_ip" value="${esc(c.proxy_ip)}" placeholder="192.168.0.11" required><small>Адрес, на который должны указывать домены сервисов.</small></label>
<label class="field">Обновление, секунд<input name="interval_seconds" type="number" min="30" max="3600" value="${c.interval_seconds || 60}" required></label>
<label class="field full">Домашние подсети<textarea name="allowed_networks" rows="2" placeholder="192.168.0.0/24" required>${esc(c.allowed_networks.join('\n'))}</textarea><small>Укажите вашу LAN. Можно несколько подсетей, по одной в строке.</small></label>
<label class="field full">Доменные зоны<textarea name="domain_zones" rows="2" required>${esc((c.domain_zones || ['home','home.arpa']).join('\n'))}</textarea><small>Например: home, home.arpa, lab.internal.</small></label>
</div>
</section>
<section class="form-section"><h2>Nginx Proxy Manager</h2><p>Homegate создаёт прокси и загружает сертификаты через API.</p>
<div class="form-grid">
<label class="field full">Адрес панели NPM<input name="npm_url" type="url" value="${esc(links.npm_url)}" placeholder="http://192.168.0.11:81" required><small>Без /api в конце.</small></label>
<label class="field full">Логин NPM<input name="npm_identity" value="${esc(links.npm_identity)}" placeholder="admin@example.com" autocomplete="username" required></label>
${passwordField('npm_password', 'Пароль NPM')}
</div>
</section>
<section class="form-section"><h2>DNS</h2><div class="form-grid">
<label class="field full">Создание DNS-записей<select name="dns_mode"><option value="pihole6" ${c.dns_mode !== 'manual' ? 'selected' : ''}>Автоматически — Pi-hole 6</option><option value="manual" ${c.dns_mode === 'manual' ? 'selected' : ''}>Вручную — другой DNS</option></select></label>
<div id="pihole-fields" class="field full" ${c.dns_mode === 'manual' ? 'hidden' : ''}>
<label class="field">Адрес Pi-hole<input name="pihole_url" type="url" value="${esc(links.pihole_url)}" placeholder="http://192.168.0.2" ${c.dns_mode !== 'manual' ? 'required' : ''}><small>Без /admin и /api в конце.</small></label>
${passwordField('pihole_password', 'Пароль Pi-hole')}
</div>
</div></section>
<section class="form-section"><details><summary>Дополнительные настройки</summary><div class="form-grid">
<label class="field full">URL SSH-конфига<input name="ssh_public_url" type="url" value="${esc(links.ssh_public_url)}" placeholder="${esc(sshUrl())}"><small>Оставьте пустым для адреса этого сервера на порту 8099.</small></label>
<label class="field full">Корневой сертификат API, PEM<textarea name="api_ca_pem" rows="4" placeholder="-----BEGIN CERTIFICATE-----">${esc(links.api_ca_pem)}</textarea><small>Нужен только если HTTPS API NPM или Pi-hole использует собственный CA.</small></label>
</div></details><div id="settings-error" class="form-error" hidden></div></section>
<div class="form-footer"><button class="btn primary" type="submit">${icon('check',14)} ${first ? 'Сохранить и начать' : 'Сохранить и применить'}</button></div>
</form><div class="stack"><section class="panel panel-pad"><div class="panel-heading">${first ? 'Всё настраивается здесь' : 'Подключения'}</div>
<p class="panel-description">Адреса, домены и доступ к вашим сервисам сохраняются на сервере. После перезапуска ничего вводить заново не нужно.</p>
<div class="integration"><span class="integration-icon">${icon('route',19)}</span><div><strong>Nginx Proxy Manager</strong><small>Прокси и HTTPS для ваших VM</small></div></div>
<div class="integration"><span class="integration-icon">${icon('globe',19)}</span><div><strong>Pi-hole</strong><small>Локальные DNS-записи</small></div></div>
<p class="note">Пароли в форме — от уже работающих NPM и Pi-hole. Панель Homegate открывается без логина.</p>
</section>${!first ? statusStrip() : ''}</div></div>`;
}
function bindManagedSettings(form) {
form.elements.dns_mode.addEventListener('change', () => {
const manual = form.elements.dns_mode.value === 'manual';
document.querySelector('#pihole-fields').hidden = manual;
form.elements.pihole_url.required = !manual;
});
}
async function saveManagedSettings(event) {
event.preventDefault();
const form = event.target, fields = new FormData(form), config = clone(data.config);
const list = name => fields.get(name).split(/\n|,/).map(value => value.trim()).filter(Boolean);
Object.assign(config, {proxy_ip: fields.get('proxy_ip').trim(), allowed_networks: list('allowed_networks'),
domain_zones: list('domain_zones'), dns_mode: fields.get('dns_mode'), interval_seconds: Number(fields.get('interval_seconds'))});
const connections = Object.fromEntries(['npm_url','npm_identity','npm_password','pihole_url','pihole_password','ssh_public_url','api_ca_pem'].map(key => [key, fields.get(key)]));
const first = data.setup_required, button = form.querySelector('[type=submit]');
button.disabled = true;
try {
data = await api('/api/settings', {config, connections, revision: data.revision});
settingsDirty = false;
if(first) location.hash = 'services';
render();
toast(first ? 'Готово. Добавьте первый сервис.' : 'Настройки сохранены. Подключения обновляются.');
} catch(error) {
document.querySelector('#settings-error').hidden = false;
document.querySelector('#settings-error').textContent = friendlyError(error);
button.disabled = false;
}
}