Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| a83d897b70 | |||
| 6844ccf0b9 | |||
| dd0f4ff8a8 |
@@ -8,4 +8,5 @@
|
|||||||
!ui/dist/
|
!ui/dist/
|
||||||
!ui/dist/**
|
!ui/dist/**
|
||||||
!bootstrap.py
|
!bootstrap.py
|
||||||
|
!standalone.py
|
||||||
!VERSION
|
!VERSION
|
||||||
|
|||||||
@@ -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:
|
||||||
|
|||||||
@@ -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"]
|
||||||
|
|||||||
16
README.md
16
README.md
@@ -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 на вашем сервере не проверены.
|
||||||
|
|
||||||
## Быстрый запуск из исходников
|
## Быстрый запуск из исходников
|
||||||
|
|
||||||
|
|||||||
62
REGISTRY.md
62
REGISTRY.md
@@ -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
54
SIMPLE.md
Normal 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, сборка и публикация образа.
|
||||||
3
WEB.md
3
WEB.md
@@ -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).
|
||||||
Ниже — вариант сборки из исходников.
|
Ниже — вариант сборки из исходников.
|
||||||
|
|
||||||
|
|||||||
@@ -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
111
ci/smoke_setup.py
Normal 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.')
|
||||||
@@ -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
20
compose.simple.yaml
Normal 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:
|
||||||
@@ -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
|
||||||
|
|||||||
23
homegate.py
23
homegate.py
@@ -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()
|
||||||
|
|||||||
118
homegate_ui.py
118
homegate_ui.py
@@ -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
111
standalone.py
Normal 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
158
tests/test_setup.py
Normal 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
13
ui/dist/app.js
vendored
@@ -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
1
ui/dist/index.html
vendored
@@ -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
70
ui/dist/settings.js
vendored
Normal 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;
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user