Add UI DNS challenge issuance and automatic home NPM renewal
All checks were successful
Test and publish Homegate / checks (push) Successful in 29s
Test and publish Homegate / publish (push) Successful in 12m43s

This commit is contained in:
2026-10-15 05:42:15 +03:00
parent eeffcfb616
commit 5661de72b7
22 changed files with 1051 additions and 43 deletions

View File

@@ -4,6 +4,9 @@
!homegate.py !homegate.py
!sync_ssh.py !sync_ssh.py
!homegate_ui.py !homegate_ui.py
!dns_challenge.py
!dns-providers-legacy.json
!THIRD_PARTY_NOTICES.md
!ui/ !ui/
!ui/dist/ !ui/dist/
!ui/dist/** !ui/dist/**

View File

@@ -35,6 +35,7 @@ jobs:
node --check ui/dist/app.js node --check ui/dist/app.js
node --check ui/dist/settings.js node --check ui/dist/settings.js
node --check ui/dist/certificates.js node --check ui/dist/certificates.js
node --check ui/dist/dns-challenge.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:

View File

@@ -5,6 +5,57 @@
а домашний NPM направляет запрос в локальный Nextcloud и предъявляет публичный сертификат. а домашний NPM направляет запрос в локальный Nextcloud и предъявляет публичный сертификат.
Установка корневого CA на телефон для такого сертификата не требуется. Установка корневого CA на телефон для такого сертификата не требуется.
## Выпуск и автопродление через DNS challenge
Этот вариант не зависит от VDS: сертификат выпускает и продлевает **домашний NPM**.
Нужен зарегистрированный публичный домен и API-доступ к его DNS-провайдеру.
Публичные A/AAAA-записи продолжают указывать на VDS; для проверки владения доменом
NPM временно создаёт TXT-запись `_acme-challenge`. Открывать домашние порты в интернет
не требуется. Зоны `.home`, `.local` и другие внутренние имена для Let's Encrypt не подходят.
1. В **Настройки → Доменные зоны** добавьте `hyperdog.dev`.
2. Добавьте сервис с доменом `disk.hyperdog.dev` и локальным адресом Nextcloud.
3. В **HTTPS-сертификат → Источник** выберите **Let’s Encrypt — DNS challenge**.
4. Укажите домены сертификата и выберите DNS-провайдера. Скопируйте показанный шаблон
в поле **API-доступ DNS-провайдера**, заменив значения своим токеном.
Для Cloudflare используйте API Token с разрешением **Zone:DNS:Edit**, ограниченный нужной зоной.
5. При необходимости задайте время ожидания DNS; пустое поле оставляет значение плагина.
Подтвердите условия Let's Encrypt и нажмите **Выпустить сертификат**.
6. Дождитесь результата. Форма сама выберет полученный сертификат домашнего NPM.
Нажмите **Добавить сервис** или **Сохранить** — Homegate создаст локальный DNS и прокси.
Отдельный выпуск доступен в **Сертификаты → Выпустить Let’s Encrypt**. Можно указать
несколько имён или wildcard, например `*.hyperdog.dev`. Он покрывает `disk.hyperdog.dev`,
но не `hyperdog.dev` и не `deep.disk.hyperdog.dev`. После отдельного выпуска выберите
сертификат в карточках нужных сервисов.
### Продление и хранение токена
Домашний NPM сохраняет DNS credentials и автоматически использует их при продлении.
Homegate передаёт их только в запросе выпуска и не сохраняет в своих файлах,
YAML, состоянии задания или логах. В Compose и env добавлять ничего не нужно.
Сертификат остаётся под тем же ID; Homegate не заменяет его сертификатом локального CA.
Резервируйте данные домашнего NPM, включая `/data` и `/etc/letsencrypt`.
Для выпуска и продления домашнему NPM нужен исходящий доступ к интернету, DNS-провайдеру
и Let's Encrypt. При временном отсутствии интернета уже выпущенный сертификат работает
до истечения срока; локальный Nextcloud остаётся доступен. Подключение к NPM на VDS
не используется и его production-конфигурация не меняется.
Современный NPM возвращает список провайдеров через API и использует email своей
учётной записи. Для старых версий без этого API Homegate показывает каталог NPM 2.12.6
и дополнительное поле email. Доступность конкретного плагина зависит от версии домашнего NPM.
Выпуск идёт в фоне и может занять до 15 минут. Если соединение прервалось или Homegate
перезапустился, нажмите **Проверить результат**: это только чтение списка сертификатов.
Повторный выпуск автоматически не отправляется. Уже существующий действующий сертификат
с тем же набором доменов и провайдером используется повторно. В этом случае новый токен
не записывается поверх старого; ротация credentials существующего сертификата выполняется в NPM.
Если выпуск отклонён, проверьте токен, права на зону и журнал домашнего NPM.
Протокол: [Let's Encrypt DNS-01](https://letsencrypt.org/docs/challenge-types/#dns-01-challenge).
Права Cloudflare: [документация DNS-плагина Certbot](https://certbot-dns-cloudflare.readthedocs.io/en/stable/).
## Уже есть подходящий сертификат в домашнем NPM ## Уже есть подходящий сертификат в домашнем NPM
1. В **Настройки → Доменные зоны** добавьте `hyperdog.dev`. 1. В **Настройки → Доменные зоны** добавьте `hyperdog.dev`.
@@ -79,3 +130,9 @@ HTTPS работает до истечения сохранённого серт
[исходниками NPM 2.12.6](https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.12.6/backend/internal/certificate.js). [исходниками NPM 2.12.6](https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.12.6/backend/internal/certificate.js).
Тесты используют изолированные HTTP-заглушки и настоящие X.509 сертификаты. Тесты используют изолированные HTTP-заглушки и настоящие X.509 сертификаты.
Реальные credentials и сертификаты production VDS для разработки не использовались. Реальные credentials и сертификаты production VDS для разработки не использовались.
DNS challenge проверен по контрактам NPM
[2.12.6](https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.12.6/backend/routes/nginx/certificates.js)
и [2.16.0](https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.16.0/backend/routes/nginx/certificates.js).
Тесты проверяют фоновый выпуск, восстановление после таймаута, отсутствие повторного
ACME-запроса, фильтрацию credentials и запрет записи на VDS. Интерфейс проверен
с локальной заглушкой NPM; реальный ACME-выпуск и изменение публичного DNS при разработке не выполнялись.

View File

@@ -2,9 +2,9 @@ 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 standalone.py VERSION . COPY homegate.py sync_ssh.py homegate_ui.py dns_challenge.py dns-providers-legacy.json THIRD_PARTY_NOTICES.md bootstrap.py standalone.py VERSION .
COPY ui/dist ./ui/dist COPY ui/dist ./ui/dist
ARG VERSION=0.5.0 ARG VERSION=0.6.0
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

View File

@@ -1,4 +1,4 @@
# Homegate 0.5.0 # Homegate 0.6.0
Дополнение к **существующим Pi-hole и Nginx Proxy Manager** для домашней сети: Дополнение к **существующим Pi-hole и Nginx Proxy Manager** для домашней сети:
@@ -11,14 +11,15 @@ https://pve.home → NPM:443 → https://192.168.0.137:8006
Веб-панель Homegate управляет сервисами, доменными зонами, SSH и настройками сети. Веб-панель Homegate управляет сервисами, доменными зонами, SSH и настройками сети.
SSH-конфиг публикуется без авторизации для устройств домашней подсети. SSH-конфиг публикуется без авторизации для устройств домашней подсети.
**Простой запуск 0.5.0: [Compose без env и secrets, вся настройка в UI](SIMPLE.md).** **Простой запуск 0.6.0: [Compose без env и secrets, вся настройка в UI](SIMPLE.md).**
Откройте `http://IP-СЕРВЕРА:8098` и заполните адреса NPM/Pi-hole в форме. Пароль панели не нужен. Откройте `http://IP-СЕРВЕРА:8098` и заполните адреса NPM/Pi-hole в форме. Пароль панели не нужен.
Расширенный вариант с отдельными контейнерами: [Compose и Gitea Actions](REGISTRY.md). Расширенный вариант с отдельными контейнерами: [Compose и Gitea Actions](REGISTRY.md).
Также доступны: [веб-панель и локальный запуск](WEB.md), [SSH-конфиг и скрипт для ПК](SSH.md), [кастомные доменные зоны и миграция CA](DOMAINS.md). Также доступны: [веб-панель и локальный запуск](WEB.md), [SSH-конфиг и скрипт для ПК](SSH.md), [кастомные доменные зоны и миграция CA](DOMAINS.md).
**Для публичного домена можно выбрать существующий сертификат NPM или обновляемую **Для публичного домена можно выпустить Let's Encrypt через DNS challenge с автопродлением
копию с NPM на VDS — без установки CA на телефон.** Настройка целиком через UI: в домашнем NPM, выбрать существующий сертификат или обновляемую копию с NPM на VDS —
[сертификаты NPM и синхронизация с VDS](CERTIFICATES.md). без установки CA на телефон.** Настройка целиком через UI:
[DNS challenge, сертификаты NPM и синхронизация с VDS](CERTIFICATES.md).
Для режима **Homegate — локальный CA** нужно один раз установить `root-ca.crt` на каждое Для режима **Homegate — локальный CA** нужно один раз установить `root-ca.crt` на каждое
клиентское устройство. Для внутренних имён `.home` публичный сертификат Let's Encrypt клиентское устройство. Для внутренних имён `.home` публичный сертификат Let's Encrypt
не подходит. Установка корневого сертификата на сервер не устанавливает доверие на не подходит. Установка корневого сертификата на сервер не устанавливает доверие на

View File

@@ -75,7 +75,7 @@ Homegate 0.4 поддерживает два способа установки:
По умолчанию registry берётся из адреса Gitea, image — из `owner/repository` в нижнем регистре: По умолчанию registry берётся из адреса Gitea, image — из `owner/repository` в нижнем регистре:
```text ```text
git.example.home/your-user/homegate:0.5.0 git.example.home/your-user/homegate:0.6.0
``` ```
Если registry доступен по другому имени/порту, задайте Actions **variable** `REGISTRY`, Если registry доступен по другому имени/порту, задайте Actions **variable** `REGISTRY`,
@@ -89,16 +89,16 @@ git.example.home/your-user/homegate:0.5.0
## 2. Выпустите образ ## 2. Выпустите образ
Файл `VERSION` сейчас содержит `0.5.0`. После загрузки проверенного кода в Gitea: Файл `VERSION` сейчас содержит `0.6.0`. После загрузки проверенного кода в Gitea:
```sh ```sh
git tag v0.5.0 git tag v0.6.0
git push origin v0.5.0 git push origin v0.6.0
``` ```
При следующем выпуске измените `VERSION`, закоммитьте его вместе с изменениями и создайте При следующем выпуске измените `VERSION`, закоммитьте его вместе с изменениями и создайте
соответствующий тег. Тег должен совпасть с файлом `VERSION`: например `v0.5.0` и `0.5.0`. соответствующий тег. Тег должен совпасть с файлом `VERSION`: например `v0.6.0` и `0.6.0`.
Предварительные версии вида `v0.5.0-rc.1` также поддерживаются. Полный номер задаётся Предварительные версии вида `v0.6.0-rc.1` также поддерживаются. Полный номер задаётся
в `VERSION`; примеры в Compose, Dockerfile и документации при выпуске также обновите. в `VERSION`; примеры в Compose, Dockerfile и документации при выпуске также обновите.
Workflow `.gitea/workflows/release.yaml` выполняет: Workflow `.gitea/workflows/release.yaml` выполняет:
@@ -110,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.5.0` и `sha-<полный SHA коммита>`. Тег `latest` не создаётся. Образ получает два тега: `0.6.0` и `sha-<полный SHA коммита>`. Тег `latest` не создаётся.
`org.opencontainers.image.source` связывает метаданные образа с URL исходников. `org.opencontainers.image.source` связывает метаданные образа с URL исходников.
Права на просмотр/скачивание пакета проверьте в Gitea Packages отдельно от доступа к коду. Права на просмотр/скачивание пакета проверьте в Gitea Packages отдельно от доступа к коду.
Workflow не запускает контейнеры Homegate и не развёртывает приложение. Workflow не запускает контейнеры Homegate и не развёртывает приложение.
@@ -136,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.5.0 export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.6.0
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]'
@@ -214,7 +214,7 @@ CA самой VM для `upstream_ca_file` по-прежнему устанав
Обновление до уже опубликованной версии: Обновление до уже опубликованной версии:
```sh ```sh
export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.5.0 export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.6.0
docker compose pull docker compose pull
docker compose up -d docker compose up -d
``` ```

View File

@@ -1,6 +1,6 @@
# Homegate: запуск и настройка через браузер # Homegate: запуск и настройка через браузер
Используйте образ `gitea.hyperdog.dev/dizyaka/homegate:0.5.0` после успешной публикации Используйте образ `gitea.hyperdog.dev/dizyaka/homegate:0.6.0` после успешной публикации
версии в Gitea Actions. Содержимое [compose.simple.yaml](compose.simple.yaml) сохраните версии в Gitea Actions. Содержимое [compose.simple.yaml](compose.simple.yaml) сохраните
на сервере как `compose.yaml`. Файл не содержит адресов, environment, secrets или паролей. на сервере как `compose.yaml`. Файл не содержит адресов, environment, secrets или паролей.
@@ -37,8 +37,13 @@ RFC1918 и ULA адресов; после настройки действует
скачивается в разделе **Сертификаты**; установите его на клиентские устройства для доверия HTTPS. скачивается в разделе **Сертификаты**; установите его на клиентские устройства для доверия HTTPS.
Для публичных доменов, например `disk.hyperdog.dev`, можно использовать сертификат NPM Для публичных доменов, например `disk.hyperdog.dev`, можно использовать сертификат NPM
без установки CA на устройства. В карточке сервиса выберите **Существующий сертификат без установки CA на устройства. В карточке сервиса выберите **Let’s Encrypt — DNS challenge**,
домашнего NPM** или **Копия из NPM на VDS — автообновление**. Подключение к VDS укажите DNS-провайдера и API-токен по шаблону. Домашний NPM выпустит сертификат и будет
продлевать его автоматически; VDS не участвует. После выпуска сохраните сервис.
В Compose ничего добавлять не нужно.
Также доступны **Существующий сертификат домашнего NPM** и
**Копия из NPM на VDS — автообновление**. Подключение к VDS
задаётся в разделе **Настройки → Сертификаты с NPM на VDS**. задаётся в разделе **Настройки → Сертификаты с NPM на VDS**.
Подробные шаги и поведение при продлении: [CERTIFICATES.md](CERTIFICATES.md). Подробные шаги и поведение при продлении: [CERTIFICATES.md](CERTIFICATES.md).

26
THIRD_PARTY_NOTICES.md Normal file
View File

@@ -0,0 +1,26 @@
# Third-party notices
`dns-providers-legacy.json` contains provider names and credential templates from
[Nginx Proxy Manager v2.12.6](https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.12.6/global/certbot-dns-plugins.json).
MIT License
Copyright (c) 2017
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

View File

@@ -1 +1 @@
0.5.0 0.6.0

View File

@@ -1,6 +1,6 @@
# Download this file only. Supply settings/passwords via the shell or an optional .env. # Download this file only. Supply settings/passwords via the shell or an optional .env.
# Docker Compose >= 2.30.0 (not docker stack deploy). See REGISTRY.md. # Docker Compose >= 2.30.0 (not docker stack deploy). See REGISTRY.md.
# Example image: git.example.home/your-user/homegate:0.5.0 # Example image: git.example.home/your-user/homegate:0.6.0
name: homegate name: homegate
x-runtime: &runtime x-runtime: &runtime

View File

@@ -2,7 +2,7 @@ name: homegate
services: services:
homegate: homegate:
image: gitea.hyperdog.dev/dizyaka/homegate:0.5.0 image: gitea.hyperdog.dev/dizyaka/homegate:0.6.0
entrypoint: [python, /app/standalone.py] entrypoint: [python, /app/standalone.py]
restart: unless-stopped restart: unless-stopped
init: true init: true

View File

@@ -2,7 +2,7 @@ name: homegate
services: services:
homegate: homegate:
build: . build: .
image: homegate:0.5.0 image: homegate:0.6.0
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.5.0 image: homegate:0.6.0
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.5.0 image: homegate:0.6.0
entrypoint: [python, /app/homegate_ui.py] entrypoint: [python, /app/homegate_ui.py]
command: [] command: []
restart: unless-stopped restart: unless-stopped

380
dns-providers-legacy.json Normal file
View File

@@ -0,0 +1,380 @@
{
"source": "https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.12.6/global/certbot-dns-plugins.json",
"providers": [
{
"id": "acmedns",
"name": "ACME-DNS",
"credentials": "dns_acmedns_api_url = http://acmedns-server/\ndns_acmedns_registration_file = /data/acme-registration.json"
},
{
"id": "active24",
"name": "Active24",
"credentials": "dns_active24_api_key = <identifier>\ndns_active24_secret = <secret>"
},
{
"id": "aliyun",
"name": "Aliyun",
"credentials": "dns_aliyun_access_key = 12345678\ndns_aliyun_access_key_secret = 1234567890abcdef1234567890abcdef"
},
{
"id": "azure",
"name": "Azure",
"credentials": "# This plugin supported API authentication using either Service Principals or utilizing a Managed Identity assigned to the virtual machine.\n# Regardless which authentication method used, the identity will need the “DNS Zone Contributor” role assigned to it.\n# As multiple Azure DNS Zones in multiple resource groups can exist, the config file needs a mapping of zone to resource group ID. Multiple zones -> ID mappings can be listed by using the key dns_azure_zoneX where X is a unique number. At least 1 zone mapping is required.\n\n# Using a service principal (option 1)\ndns_azure_sp_client_id = 912ce44a-0156-4669-ae22-c16a17d34ca5\ndns_azure_sp_client_secret = E-xqXU83Y-jzTI6xe9fs2YC~mck3ZzUih9\ndns_azure_tenant_id = ed1090f3-ab18-4b12-816c-599af8a88cf7\n\n# Using used assigned MSI (option 2)\n# dns_azure_msi_client_id = 912ce44a-0156-4669-ae22-c16a17d34ca5\n\n# Using system assigned MSI (option 3)\n# dns_azure_msi_system_assigned = true\n\n# Zones (at least one always required)\ndns_azure_zone1 = example.com:/subscriptions/c135abce-d87d-48df-936c-15596c6968a5/resourceGroups/dns1\ndns_azure_zone2 = example.org:/subscriptions/99800903-fb14-4992-9aff-12eaf2744622/resourceGroups/dns2"
},
{
"id": "baidu",
"name": "baidu",
"credentials": "dns_baidu_access_key = 12345678\ndns_baidu_secret_key = 1234567890abcdef1234567890abcdef"
},
{
"id": "beget",
"name": "Beget",
"credentials": "# Beget API credentials used by Certbot\nbeget_plugin_username = username\nbeget_plugin_password = password"
},
{
"id": "bunny",
"name": "bunny.net",
"credentials": "# Bunny API token used by Certbot (see https://dash.bunny.net/account/settings)\ndns_bunny_api_key = xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
},
{
"id": "cdmon",
"name": "cdmon",
"credentials": "dns_cdmon_api_key=your-cdmon-api-token\ndns_cdmon_domain=your_domain_is_optional"
},
{
"id": "cloudflare",
"name": "Cloudflare",
"credentials": "# Cloudflare API token\ndns_cloudflare_api_token=0123456789abcdef0123456789abcdef01234567"
},
{
"id": "cloudns",
"name": "ClouDNS",
"credentials": "# Target user ID (see https://www.cloudns.net/api-settings/)\n\tdns_cloudns_auth_id=1234\n\t# Alternatively, one of the following two options can be set:\n\t# dns_cloudns_sub_auth_id=1234\n\t# dns_cloudns_sub_auth_user=foobar\n\n\t# API password\n\tdns_cloudns_auth_password=password1"
},
{
"id": "cloudxns",
"name": "CloudXNS",
"credentials": "dns_cloudxns_api_key = 1234567890abcdef1234567890abcdef\ndns_cloudxns_secret_key = 1122334455667788"
},
{
"id": "constellix",
"name": "Constellix",
"credentials": "dns_constellix_apikey = 5fb4e76f-ac91-43e5-f982458bc595\ndns_constellix_secretkey = 47d99fd0-32e7-4e07-85b46d08e70b\ndns_constellix_endpoint = https://api.dns.constellix.com/v1"
},
{
"id": "corenetworks",
"name": "Core Networks",
"credentials": "dns_corenetworks_username = asaHB12r\ndns_corenetworks_password = secure_password"
},
{
"id": "cpanel",
"name": "cPanel",
"credentials": "cpanel_url = https://cpanel.example.com:2083\ncpanel_username = your_username\ncpanel_password = your_password\ncpanel_token = your_api_token"
},
{
"id": "ddnss",
"name": "DDNSS",
"credentials": "dns_ddnss_token = YOUR_DDNSS_API_TOKEN"
},
{
"id": "desec",
"name": "deSEC",
"credentials": "dns_desec_token = YOUR_DESEC_API_TOKEN\ndns_desec_endpoint = https://desec.io/api/v1/"
},
{
"id": "duckdns",
"name": "DuckDNS",
"credentials": "dns_duckdns_token=your-duckdns-token"
},
{
"id": "digitalocean",
"name": "DigitalOcean",
"credentials": "dns_digitalocean_token = 0000111122223333444455556666777788889999aaaabbbbccccddddeeeeffff"
},
{
"id": "directadmin",
"name": "DirectAdmin",
"credentials": "directadmin_url = https://my.directadminserver.com:2222\ndirectadmin_username = username\ndirectadmin_password = aSuperStrongPassword"
},
{
"id": "dnsimple",
"name": "DNSimple",
"credentials": "dns_dnsimple_token = MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAw"
},
{
"id": "dnsmadeeasy",
"name": "DNS Made Easy",
"credentials": "dns_dnsmadeeasy_api_key = 1c1a3c91-4770-4ce7-96f4-54c0eb0e457a\ndns_dnsmadeeasy_secret_key = c9b5625f-9834-4ff8-baba-4ed5f32cae55"
},
{
"id": "dnsmulti",
"name": "DnsMulti",
"credentials": "# See https://go-acme.github.io/lego/dns/#dns-providers for list of providers and their settings\n# Example provider configuration for DreamHost\n# dns_multi_provider = dreamhost\n# DREAMHOST_API_KEY = ABCDEFG1234"
},
{
"id": "dnspod",
"name": "DNSPod",
"credentials": "dns_dnspod_email = \"email@example.com\"\ndns_dnspod_api_token = \"id,key\""
},
{
"id": "domainoffensive",
"name": "DomainOffensive (do.de)",
"credentials": "dns_domainoffensive_api_token = YOUR_DO_DE_AUTH_TOKEN"
},
{
"id": "domeneshop",
"name": "Domeneshop",
"credentials": "dns_domeneshop_client_token=YOUR_DOMENESHOP_CLIENT_TOKEN\ndns_domeneshop_client_secret=YOUR_DOMENESHOP_CLIENT_SECRET"
},
{
"id": "dynu",
"name": "Dynu",
"credentials": "dns_dynu_auth_token = YOUR_DYNU_AUTH_TOKEN"
},
{
"id": "easydns",
"name": "easyDNS",
"credentials": "dns_easydns_usertoken = YOUR_EASYDNS_USERTOKEN\ndns_easydns_userkey = YOUR_EASYDNS_USERKEY\ndns_easydns_endpoint = https://rest.easydns.net"
},
{
"id": "eurodns",
"name": "EuroDNS",
"credentials": "dns_eurodns_applicationId = myuser\ndns_eurodns_apiKey = mysecretpassword\ndns_eurodns_endpoint = https://rest-api.eurodns.com/user-api-gateway/proxy"
},
{
"id": "firstdomains",
"name": "First Domains",
"credentials": "dns_firstdomains_username = myremoteuser\ndns_firstdomains_password = verysecureremoteuserpassword"
},
{
"id": "freedns",
"name": "FreeDNS",
"credentials": "dns_freedns_username = myremoteuser\ndns_freedns_password = verysecureremoteuserpassword"
},
{
"id": "gandi",
"name": "Gandi Live DNS",
"credentials": "# Gandi personal access token\ndns_gandi_token=PERSONAL_ACCESS_TOKEN"
},
{
"id": "gcore",
"name": "Gcore DNS",
"credentials": "dns_gcore_apitoken = 0123456789abcdef0123456789abcdef01234567"
},
{
"id": "godaddy",
"name": "GoDaddy",
"credentials": "dns_godaddy_secret = 0123456789abcdef0123456789abcdef01234567\ndns_godaddy_key = abcdef0123456789abcdef01234567abcdef0123"
},
{
"id": "google",
"name": "Google",
"credentials": "{\n\"type\": \"service_account\",\n...\n}"
},
{
"id": "googledomains",
"name": "GoogleDomainsDNS",
"credentials": "dns_google_domains_access_token = 0123456789abcdef0123456789abcdef01234567\ndns_google_domains_zone = \"example.com\""
},
{
"id": "he",
"name": "Hurricane Electric",
"credentials": "dns_he_user = Me\ndns_he_pass = my HE password"
},
{
"id": "hetzner",
"name": "Hetzner",
"credentials": "dns_hetzner_api_token = 0123456789abcdef0123456789abcdef"
},
{
"id": "hostingnl",
"name": "Hosting.nl",
"credentials": "dns_hostingnl_api_key = 0123456789abcdef0123456789abcdef"
},
{
"id": "hover",
"name": "Hover",
"credentials": "dns_hover_hoverurl = https://www.hover.com\ndns_hover_username = hover-admin-username\ndns_hover_password = hover-admin-password\ndns_hover_totpsecret = 2fa-totp-secret"
},
{
"id": "infomaniak",
"name": "Infomaniak",
"credentials": "dns_infomaniak_token = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
},
{
"id": "inwx",
"name": "INWX",
"credentials": "dns_inwx_url = https://api.domrobot.com/xmlrpc/\ndns_inwx_username = your_username\ndns_inwx_password = your_password\ndns_inwx_shared_secret = your_shared_secret optional"
},
{
"id": "ionos",
"name": "IONOS",
"credentials": "dns_ionos_prefix = myapikeyprefix\ndns_ionos_secret = verysecureapikeysecret\ndns_ionos_endpoint = https://api.hosting.ionos.com"
},
{
"id": "ispconfig",
"name": "ISPConfig",
"credentials": "dns_ispconfig_username = myremoteuser\ndns_ispconfig_password = verysecureremoteuserpassword\ndns_ispconfig_endpoint = https://localhost:8080"
},
{
"id": "isset",
"name": "Isset",
"credentials": "dns_isset_endpoint=\"https://customer.isset.net/api\"\ndns_isset_token=\"<token>\""
},
{
"id": "joker",
"name": "Joker",
"credentials": "dns_joker_username = <Dynamic DNS Authentication Username>\ndns_joker_password = <Dynamic DNS Authentication Password>\ndns_joker_domain = <Dynamic DNS Domain>"
},
{
"id": "leaseweb",
"name": "LeaseWeb",
"credentials": "dns_leaseweb_api_token = 01234556789"
},
{
"id": "linode",
"name": "Linode",
"credentials": "dns_linode_key = 0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ64\ndns_linode_version = [<blank>|3|4]"
},
{
"id": "loopia",
"name": "Loopia",
"credentials": "dns_loopia_user = user@loopiaapi\ndns_loopia_password = abcdef0123456789abcdef01234567abcdef0123"
},
{
"id": "luadns",
"name": "LuaDNS",
"credentials": "dns_luadns_email = user@example.com\ndns_luadns_token = 0123456789abcdef0123456789abcdef"
},
{
"id": "mijnhost",
"name": "mijn.host",
"credentials": "dns_mijn_host_api_key=0123456789abcdef0123456789abcdef"
},
{
"id": "namecheap",
"name": "Namecheap",
"credentials": "dns_namecheap_username = 123456\ndns_namecheap_api_key = 0123456789abcdef0123456789abcdef01234567"
},
{
"id": "netcup",
"name": "netcup",
"credentials": "dns_netcup_customer_id = 123456\ndns_netcup_api_key = 0123456789abcdef0123456789abcdef01234567\ndns_netcup_api_password = abcdef0123456789abcdef01234567abcdef0123"
},
{
"id": "nicru",
"name": "nic.ru",
"credentials": "dns_nicru_client_id = application-id\ndns_nicru_client_secret = application-token\ndns_nicru_username = 0001110/NIC-D\ndns_nicru_password = password\ndns_nicru_scope = .+:.+/zones/example.com(/.+)?\ndns_nicru_service = DNS_SERVICE_NAME\ndns_nicru_zone = example.com"
},
{
"id": "njalla",
"name": "Njalla",
"credentials": "dns_njalla_token = 0123456789abcdef0123456789abcdef01234567"
},
{
"id": "nsone",
"name": "NS1",
"credentials": "dns_nsone_api_key = MDAwMDAwMDAwMDAwMDAw"
},
{
"id": "oci",
"name": "Oracle Cloud Infrastructure DNS",
"credentials": "[DEFAULT]\nuser = ocid1.user.oc1...\nfingerprint = xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx\ntenancy = ocid1.tenancy.oc1...\nregion = us-ashburn-1\nkey_file = ~/.oci/oci_api_key.pem"
},
{
"id": "ovh",
"name": "OVH",
"credentials": "dns_ovh_endpoint = ovh-eu\ndns_ovh_application_key = MDAwMDAwMDAwMDAw\ndns_ovh_application_secret = MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAw\ndns_ovh_consumer_key = MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAw"
},
{
"id": "plesk",
"name": "Plesk",
"credentials": "dns_plesk_username = your-username\ndns_plesk_password = secret\ndns_plesk_api_url = https://plesk-api-host:8443"
},
{
"id": "porkbun",
"name": "Porkbun",
"credentials": "dns_porkbun_key=your-porkbun-api-key\ndns_porkbun_secret=your-porkbun-api-secret"
},
{
"id": "powerdns",
"name": "PowerDNS",
"credentials": "dns_powerdns_api_url = https://api.mypowerdns.example.org\ndns_powerdns_api_key = AbCbASsd!@34"
},
{
"id": "regru",
"name": "reg.ru",
"credentials": "dns_username=username\ndns_password=password"
},
{
"id": "rfc2136",
"name": "RFC 2136",
"credentials": "# Target DNS server\ndns_rfc2136_server = 192.0.2.1\n# Target DNS port\ndns_rfc2136_port = 53\n# TSIG key name\ndns_rfc2136_name = keyname.\n# TSIG key secret\ndns_rfc2136_secret = 4q4wM/2I180UXoMyN4INVhJNi8V9BCV+jMw2mXgZw/CSuxUT8C7NKKFs AmKd7ak51vWKgSl12ib86oQRPkpDjg==\n# TSIG key algorithm\ndns_rfc2136_algorithm = HMAC-SHA512"
},
{
"id": "rockenstein",
"name": "rockenstein AG",
"credentials": "dns_rockenstein_token=<token>"
},
{
"id": "route53",
"name": "Route 53 (Amazon)",
"credentials": "[default]\naws_access_key_id=AKIAIOSFODNN7EXAMPLE\naws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
},
{
"id": "spaceship",
"name": "Spaceship",
"credentials": "[spaceship]\napi_key=your_api_key\napi_secret=your_api_secret"
},
{
"id": "strato",
"name": "Strato",
"credentials": "dns_strato_username = user\ndns_strato_password = pass\n# uncomment if youre using two factor authentication:\n# dns_strato_totp_devicename = 2fa_device\n# dns_strato_totp_secret = 2fa_secret\n#\n# uncomment if domain name contains special characters\n# insert domain display name as seen on your account page here\n# dns_strato_domain_display_name = my-punicode-url.de\n#\n# if youre not using strato.de or another special endpoint you can customise it below\n# you will probably only need to adjust the host, but you can also change the complete endpoint url\n# dns_strato_custom_api_scheme = https\n# dns_strato_custom_api_host = www.strato.de\n# dns_strato_custom_api_port = 443\n# dns_strato_custom_api_path = \"/apps/CustomerService\""
},
{
"id": "selectelv2",
"name": "Selectel api v2",
"credentials": "dns_selectel_api_v2_account_id = your_account_id\ndns_selectel_api_v2_project_name = your_project\ndns_selectel_api_v2_username = your_username\ndns_selectel_api_v2_password = your_password"
},
{
"id": "timeweb",
"name": "Timeweb Cloud",
"credentials": "dns_timeweb_api_key = XXXXXXXXXXXXXXXXXXX"
},
{
"id": "transip",
"name": "TransIP",
"credentials": "dns_transip_username = my_username\ndns_transip_key_file = /etc/letsencrypt/transip-rsa.key"
},
{
"id": "tencentcloud",
"name": "Tencent Cloud",
"credentials": "dns_tencentcloud_secret_id = TENCENT_CLOUD_SECRET_ID\ndns_tencentcloud_secret_key = TENCENT_CLOUD_SECRET_KEY"
},
{
"id": "vultr",
"name": "Vultr",
"credentials": "dns_vultr_key = YOUR_VULTR_API_KEY"
},
{
"id": "websupport",
"name": "Websupport.sk",
"credentials": "dns_websupport_identifier = <api_key>\ndns_websupport_secret_key = <secret>"
},
{
"id": "wedos",
"name": "Wedos",
"credentials": "dns_wedos_user = <wedos_registration>\ndns_wedos_auth = <wapi_password>"
},
{
"id": "edgedns",
"name": "Akamai Edge DNS",
"credentials": "edgedns_client_secret = as3d1asd5d1a32sdfsdfs2d1asd5=\nedgedns_host = sdflskjdf-dfsdfsdf-sdfsdfsdf.luna.akamaiapis.net\nedgedns_access_token = kjdsi3-34rfsdfsdf-234234fsdfsdf\nedgedns_client_token = dkfjdf-342fsdfsd-23fsdfsdfsdf"
},
{
"id": "zoneedit",
"name": "ZoneEdit",
"credentials": "dns_zoneedit_user = <login-user-id>\ndns_zoneedit_token = <dyn-authentication-token>"
}
]
}

175
dns_challenge.py Normal file
View File

@@ -0,0 +1,175 @@
"""Background DNS-01 issuance in the home NPM. Renewal belongs to NPM's scheduler."""
from pathlib import Path
import re
import secrets
import threading
import time
import homegate as h
ISSUE_TIMEOUT = 900
RESERVED = {"home", "lan", "local", "localhost", "internal", "invalid", "test", "example", "onion", "arpa"}
def providers(npm):
try:
rows = npm.call("GET", "/nginx/certificates/dns-providers")
legacy = False
except h.APIError as exc:
# In old NPM this path matches /:certificate_id and can return 400.
if exc.status not in (400, 404):
raise
rows = h.read_json(Path(__file__).with_name("dns-providers-legacy.json"))["providers"]
legacy = True
h.require(isinstance(rows, list) and 0 < len(rows) <= 256, "NPM вернул некорректный список DNS-провайдеров")
clean = []
for row in rows:
h.require(isinstance(row, dict) and isinstance(row.get("id"), str) and
re.fullmatch(r"[a-z0-9_-]{1,100}", row["id"]), "Некорректный DNS-провайдер NPM")
clean.append({"id": row["id"], "name": str(row.get("name", row["id"]))[:200],
"template": str(row.get("credentials", ""))[:16384]})
return {"providers": sorted(clean, key=lambda p: p["name"].lower()), "email_required": legacy}
def validate_request(value):
h.require(isinstance(value, dict) and not set(value) -
{"domains", "provider", "credentials", "email", "propagation_seconds", "agree"},
"Некорректные параметры DNS challenge")
domains = value.get("domains")
h.require(isinstance(domains, list) and 1 <= len(domains) <= 100, "Укажите от 1 до 100 доменов")
names = []
for name in domains:
h.require(isinstance(name, str), "Домены должны быть строками")
name = name.strip().lower().rstrip(".")
base = name.removeprefix("*.")
h.require(h.DOMAIN.fullmatch(base) and not base.split(".")[-1].isdigit() and
base.split(".")[-1] not in RESERVED,
"Для Let's Encrypt нужен публичный домен; .home, .local и другие локальные зоны не подходят")
h.require(name not in names, "Домен указан повторно")
names.append(name)
provider = value.get("provider")
h.require(isinstance(provider, str) and re.fullmatch(r"[a-z0-9_-]{1,100}", provider), "Выберите DNS-провайдера")
credentials = value.get("credentials")
h.require(isinstance(credentials, str) and 0 < len(credentials.strip()) <= 16384 and "\x00" not in credentials,
"Введите API-доступ DNS-провайдера в формате шаблона")
email = value.get("email", "")
h.require(isinstance(email, str), "Некорректный email")
email = email.strip()
h.require(not email or re.fullmatch(r"[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,63}", email), "Некорректный email")
propagation = value.get("propagation_seconds")
if propagation is not None:
h.number(propagation, 0, 600, "propagation_seconds")
h.require(value.get("agree") is True, "Подтвердите согласие с условиями Let's Encrypt")
return {"domains": names, "provider": provider, "credentials": credentials, "email": email,
"propagation_seconds": propagation, "agree": True}
class DNSChallenge:
def __init__(self, control, connect):
self.path = Path(control) / "dns-challenge.json"
self.connect = connect
self.lock = threading.RLock()
self.thread = None
self.job = h.read_json(self.path, {"status": "idle"})
if self.job["status"] == "running":
self.update(status="unknown", message="Homegate был перезапущен. Проверьте результат в домашнем NPM перед повторным выпуском.")
def update(self, **fields):
with self.lock:
self.job.update(fields)
h.save_json(self.path, self.job)
return self.status()
def status(self):
with self.lock:
# Never publish the full request or an NPM response.
return {k: v for k, v in self.job.items() if k in
{"id", "status", "domains", "provider", "message", "certificate", "started_at"}}
def start(self, value):
request = validate_request(value)
with self.lock:
h.require(self.job["status"] != "running", "Выпуск уже выполняется. Дождитесь результата.")
h.require(self.job["status"] != "unknown" or time.time() - self.job.get("issued_at", self.job.get("started_at", 0)) >= ISSUE_TIMEOUT,
"Результат предыдущего выпуска пока неизвестен. Нажмите «Проверить результат»; повторный выпуск доступен через 15 минут.")
self.job = {"id": secrets.token_hex(16), "status": "running", "domains": request["domains"],
"provider": request["provider"], "started_at": time.time(), "message": "Проверяем домашний NPM…"}
self.update()
self.thread = threading.Thread(target=self.run, args=(request,), daemon=True)
self.thread.start()
return self.status()
def check(self):
with self.lock:
if self.job["status"] in ("idle", "success", "running"):
return self.status()
self.update(status="running", message="Проверяем, завершился ли выпуск в домашнем NPM…")
self.thread = threading.Thread(target=self.run, args=(None,), daemon=True)
self.thread.start()
return self.status()
def matching(self, rows):
matches = []
for row in rows:
if (row.get("provider") == "letsencrypt" and row.get("meta", {}).get("dns_challenge") is True
and row.get("meta", {}).get("dns_provider") == self.job["provider"]
and set(row.get("domain_names", [])) == set(self.job["domains"])):
info = h.certificate_info(row)
try:
h.check_certificate(info, self.job["domains"])
except h.Error:
continue
matches.append(info)
# Reuse a valid certificate instead of submitting a duplicate ACME order.
return sorted(matches, key=lambda c: c["id"], reverse=True)
def run(self, request):
npm, submitted = None, False
try:
npm = self.connect()
if request is None:
h.require(not self.job.get("npm_base") or npm.base == self.job["npm_base"],
"Подключение к домашнему NPM изменилось; проверьте сертификаты в прежнем NPM")
self.update(npm_base=npm.base)
rows = npm.call("GET", "/nginx/certificates")
matches = self.matching(rows)
if matches:
self.update(status="success", certificate=matches[0], message="Сертификат готов. Автопродление выполняет домашний NPM.")
return
if request is None:
self.update(status="unknown", message="Готовый сертификат пока не найден. Выпуск может продолжаться в NPM. Повторный запрос автоматически не отправляется.")
return
catalog = providers(npm)
h.require(any(p["id"] == request["provider"] for p in catalog["providers"]),
"Этот DNS-провайдер не поддерживается домашним NPM")
meta = {"dns_challenge": True, "dns_provider": request["provider"],
"dns_provider_credentials": request["credentials"]}
if catalog["email_required"]:
h.require(bool(request["email"]), "Для этой версии NPM укажите email Let's Encrypt")
meta.update(letsencrypt_email=request["email"], letsencrypt_agree=True)
if request["propagation_seconds"] is not None:
meta["propagation_seconds"] = request["propagation_seconds"]
self.update(issued_at=time.time(), message="Домашний NPM выпускает сертификат через DNS challenge. Это может занять несколько минут.")
submitted = True
result = npm.call("POST", "/nginx/certificates", json={"provider": "letsencrypt",
"domain_names": request["domains"], "meta": meta}, timeout=(5, ISSUE_TIMEOUT))
info = h.certificate_info(result)
h.require(info["provider"] == "letsencrypt" and info["dns_challenge"], "NPM вернул неожиданный тип сертификата")
h.check_certificate(info, request["domains"])
self.update(status="success", certificate=info, message="Сертификат выпущен. Автопродление выполняет домашний NPM.")
except h.APIError as exc:
uncertain = submitted and exc.status in (None, 408, 502, 503, 504)
self.update(status="unknown" if uncertain or request is None else "error", message=(
"NPM не подтвердил результат. Нажмите «Проверить результат»; Homegate не повторяет выпуск автоматически."
if uncertain else "Не удалось выполнить запрос к домашнему NPM. Проверьте подключение, DNS-доступ и журнал NPM. " + str(exc)))
except h.Error as exc:
self.update(status="unknown" if submitted or request is None else "error", message=str(exc))
except Exception:
# Exception representations from parsers/third-party code may contain credentials.
self.update(status="unknown" if submitted or request is None else "error",
message="Не удалось обработать ответ NPM. Проверьте результат в его разделе сертификатов.")
finally:
if request is not None:
request.clear()
if npm:
npm.close()

View File

@@ -47,6 +47,12 @@ class Error(RuntimeError):
pass pass
class APIError(Error):
def __init__(self, message, status=None):
super().__init__(message)
self.status = status
def require(ok, message): def require(ok, message):
if not ok: if not ok:
raise Error(message) raise Error(message)
@@ -404,19 +410,20 @@ class API:
def call(self, method, path, **kwargs): def call(self, method, path, **kwargs):
try: try:
response = self.session.request(method, self.base + path, timeout=(5, 30), response = self.session.request(method, self.base + path, timeout=kwargs.pop("timeout", (5, 30)),
allow_redirects=False, **kwargs) allow_redirects=False, **kwargs)
except requests.RequestException: except requests.RequestException:
raise Error(f"{self.label}: connection or TLS error at {path}") from None raise APIError(f"{self.label}: connection or TLS error at {path}") from None
require(200 <= response.status_code < 300, if not 200 <= response.status_code < 300:
f"{self.label}: HTTP {response.status_code} at {path}; check credentials, version and permissions") raise APIError(f"{self.label}: HTTP {response.status_code} at {path}; check credentials, version and permissions",
response.status_code)
# Do not log response bodies: NPM upload responses contain the private key. # Do not log response bodies: NPM upload responses contain the private key.
if not response.content: if not response.content:
return None return None
try: try:
return response.json() return response.json()
except ValueError: except ValueError:
raise Error(f"{self.label}: non-JSON response at {path}; check management URL") from None raise APIError(f"{self.label}: non-JSON response at {path}; check management URL") from None
def close(self): def close(self):
self.session.close() self.session.close()
@@ -517,7 +524,8 @@ def certificate_info(cert):
raise Error("NPM certificate has invalid PEM or missing DNS subject alternative names") from None raise Error("NPM certificate has invalid PEM or missing DNS subject alternative names") from None
return {"id": cert["id"], "name": cert.get("nice_name", ""), "provider": cert.get("provider"), return {"id": cert["id"], "name": cert.get("nice_name", ""), "provider": cert.get("provider"),
"domains": domains, "expires": expires, "fingerprint": fingerprint, "domains": domains, "expires": expires, "fingerprint": fingerprint,
"modified": cert.get("modified_on")} "modified": cert.get("modified_on"), "dns_challenge": cert.get("meta", {}).get("dns_challenge") is True,
"dns_provider": cert.get("meta", {}).get("dns_provider")}
def covers_domain(pattern, hostname): def covers_domain(pattern, hostname):

View File

@@ -18,6 +18,7 @@ from urllib.parse import urlsplit
import yaml import yaml
import homegate as h import homegate as h
from dns_challenge import DNSChallenge, providers as dns_providers
LOG = logging.getLogger("homegate.ui") LOG = logging.getLogger("homegate.ui")
BASE = Path(__file__).resolve().parent BASE = Path(__file__).resolve().parent
@@ -52,6 +53,7 @@ class Panel:
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")
if self.config.exists() or not self.connections_file: if self.config.exists() or not self.connections_file:
h.load_config(self.config) h.load_config(self.config)
self.dns_challenge = DNSChallenge(self.control, self.connect_npm)
def config_data(self): def config_data(self):
if self.connections_file and not self.config.exists(): if self.connections_file and not self.config.exists():
@@ -178,7 +180,7 @@ class Panel:
self.request_sync() self.request_sync()
return result return result
def certificates(self, remote=False): def connect_npm(self, remote=False):
h.require(self.connections_file is not None, "Сначала настройте подключения через UI") h.require(self.connections_file is not None, "Сначала настройте подключения через UI")
values = h.read_json(self.connections_file, {}) values = h.read_json(self.connections_file, {})
prefix = "remote_npm" if remote else "npm" prefix = "remote_npm" if remote else "npm"
@@ -191,12 +193,27 @@ class Panel:
client = (h.RemoteNPM if remote else h.NPM)(values[prefix + "_url"], "Remote NPM" if remote else "NPM", verify) client = (h.RemoteNPM if remote else h.NPM)(values[prefix + "_url"], "Remote NPM" if remote else "NPM", verify)
try: try:
client.login(values[prefix + "_identity"], values[prefix + "_password"]) client.login(values[prefix + "_identity"], values[prefix + "_password"])
return client
except Exception:
client.close()
raise
def certificates(self, remote=False):
client = self.connect_npm(remote)
try:
certs = client.call("GET", "/nginx/certificates") certs = client.call("GET", "/nginx/certificates")
return {"certificates": [h.certificate_info(c) for c in certs return {"certificates": [h.certificate_info(c) for c in certs
if not remote or c.get("provider") == "letsencrypt"]} if not remote or c.get("provider") == "letsencrypt"]}
finally: finally:
client.close() client.close()
def dns_providers(self):
client = self.connect_npm()
try:
return dns_providers(client)
finally:
client.close()
def save(self, value, revision): def save(self, value, revision):
h.validate_config(value) h.validate_config(value)
data = yaml.safe_dump(value, sort_keys=False, allow_unicode=True).encode() data = yaml.safe_dump(value, sort_keys=False, allow_unicode=True).encode()
@@ -276,10 +293,10 @@ def handler_for(panel):
path = urlsplit(self.path).path path = urlsplit(self.path).path
if self.command == "GET" and path == "/healthz": if self.command == "GET" and path == "/healthz":
return self.respond(200, {"ok": True}) return self.respond(200, {"ok": True})
if self.command == "GET" and path in ("/", "/app.js", "/settings.js", "/certificates.js", "/style.css", "/favicon.svg"): if self.command == "GET" and path in ("/", "/app.js", "/settings.js", "/certificates.js", "/dns-challenge.js", "/style.css", "/favicon.svg"):
name = {"/": "index.html", "/app.js": "app.js", "/settings.js": "settings.js", "/certificates.js": "certificates.js", "/style.css": "style.css", "/favicon.svg": "favicon.svg"}[path] name = {"/": "index.html", "/app.js": "app.js", "/settings.js": "settings.js", "/certificates.js": "certificates.js", "/dns-challenge.js": "dns-challenge.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",
"settings.js": "text/javascript; charset=utf-8", "certificates.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", "certificates.js": "text/javascript; charset=utf-8", "dns-challenge.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":
@@ -313,6 +330,10 @@ def handler_for(panel):
return self.respond(200, panel.status()) return self.respond(200, panel.status())
if path in ("/api/npm-certificates", "/api/remote-certificates"): if path in ("/api/npm-certificates", "/api/remote-certificates"):
return self.respond(200, panel.certificates(remote=path == "/api/remote-certificates")) return self.respond(200, panel.certificates(remote=path == "/api/remote-certificates"))
if path == "/api/dns-providers":
return self.respond(200, panel.dns_providers())
if path == "/api/dns-challenge":
return self.respond(200, panel.dns_challenge.status())
if path == "/api/ssh-config": if path == "/api/ssh-config":
text = h.render_ssh(h.ssh_entries(h.load_config(panel.config))) text = h.render_ssh(h.ssh_entries(h.load_config(panel.config)))
return self.respond(200, text.encode(), "text/plain; charset=utf-8") return self.respond(200, text.encode(), "text/plain; charset=utf-8")
@@ -337,6 +358,10 @@ def handler_for(panel):
return self.respond(200, panel.save_settings(body["config"], body["connections"], body["revision"])) 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/dns-challenge":
return self.respond(202, panel.dns_challenge.start(body))
if path == "/api/dns-challenge/check":
return self.respond(202, panel.dns_challenge.check())
if path == "/api/logout": if path == "/api/logout":
panel.sessions.pop(token, None) panel.sessions.pop(token, None)
return self.respond(200, {"ok": True}, cookie="") return self.respond(200, {"ok": True}, cookie="")

204
tests/test_dns_challenge.py Normal file
View File

@@ -0,0 +1,204 @@
"""DNS-01 issuance is local, asynchronous, secret-free in state, and retry-safe."""
import copy
from datetime import timedelta
import json
import threading
import unittest
from unittest.mock import Mock, patch
import homegate as h
import homegate_ui as ui
import dns_challenge as dc
import test_setup
class DNSChallengeTests(unittest.TestCase):
setUpPanel = test_setup.SetupTests.setUp
request = test_setup.SetupTests.request
connect = test_setup.SetupTests.connect
install = test_setup.SetupTests.install
def setUp(self):
self.setUpPanel()
self.install()
self.rows = []
self.posts = []
self.legacy = False
self.fail_after_create = False
self.block = None
self.entered = threading.Event()
self.client = Mock(base='http://home-npm:81/api')
self.client.call.side_effect = self.call
self.panel.dns_challenge.connect = lambda: self.client
self.input = {'domains':['disk.example.com'], 'provider':'cloudflare',
'credentials':'dns_cloudflare_api_token=DNS_PRIVATE_TOKEN', 'agree':True,
'email':'admin@example.com', 'propagation_seconds':None}
def call(self, method, path, **kwargs):
if method == 'GET' and path == '/nginx/certificates/dns-providers':
if self.legacy:
raise h.APIError('Not found', 404)
return [{'id':'cloudflare','name':'Cloudflare','credentials':'dns_cloudflare_api_token=EXAMPLE'}]
if method == 'GET' and path == '/nginx/certificates':
return copy.deepcopy(self.rows)
if method == 'POST' and path == '/nginx/certificates':
payload = copy.deepcopy(kwargs['json'])
self.posts.append(payload)
self.assertEqual(kwargs['timeout'], (5, dc.ISSUE_TIMEOUT))
self.entered.set()
if self.block:
self.block.wait(3)
row = dict(payload, id=len(self.rows)+1, nice_name=', '.join(payload['domain_names']),
expires_on=(h.now()+timedelta(days=90)).isoformat())
self.rows.append(row)
if self.fail_after_create:
raise h.APIError('NPM: connection or TLS error')
return copy.deepcopy(row)
raise AssertionError((method,path))
def finish(self):
self.panel.dns_challenge.thread.join(4)
self.assertFalse(self.panel.dns_challenge.thread.is_alive())
return self.request('/api/dns-challenge')[1]
def start(self):
code, body, _ = self.request('/api/dns-challenge', copy.deepcopy(self.input))
self.assertEqual(code, 202, body)
return self.finish()
def test_modern_npm_issues_dns_certificate_and_exports_only_public_metadata(self):
self.input['domains'] = ['example.com','*.example.com']
result = self.start()
self.assertEqual(result['status'], 'success')
self.assertEqual(self.posts[0], {'provider':'letsencrypt','domain_names':self.input['domains'],
'meta':{'dns_challenge':True,'dns_provider':'cloudflare',
'dns_provider_credentials':self.input['credentials']}})
self.assertTrue(result['certificate']['dns_challenge'])
for path in self.root.rglob('*'):
if path.is_file():
self.assertNotIn('DNS_PRIVATE_TOKEN', path.read_text())
for path in ['/api/dns-challenge','/api/state','/downloads/services.yaml']:
self.assertNotIn('DNS_PRIVATE_TOKEN', str(self.request(path)[1]))
with patch.object(h.RemoteNPM, 'call', side_effect=AssertionError('No VDS calls')):
self.assertEqual(self.start()['status'], 'success')
self.assertEqual(len(self.posts), 1) # valid certificate is reused
def test_old_npm_receives_email_and_agreement_with_propagation_delay(self):
self.legacy = True
self.input['propagation_seconds'] = 120
self.assertEqual(self.start()['status'], 'success')
meta = self.posts[0]['meta']
self.assertEqual(meta['letsencrypt_email'], 'admin@example.com')
self.assertIs(meta['letsencrypt_agree'], True)
self.assertEqual(meta['propagation_seconds'], 120)
def test_issuance_is_background_and_duplicate_posts_are_blocked(self):
self.block = threading.Event()
self.addCleanup(self.block.set)
code, _, _ = self.request('/api/dns-challenge', self.input)
self.assertEqual(code, 202)
self.assertTrue(self.entered.wait(2))
self.assertEqual(self.request('/api/state')[0], 200)
self.assertEqual(self.request('/api/dns-challenge')[1]['status'], 'running')
self.assertEqual(self.request('/api/dns-challenge', self.input)[0], 400)
self.block.set()
self.assertEqual(self.finish()['status'], 'success')
self.assertEqual(len(self.posts), 1)
def test_timeout_recovers_existing_certificate_without_another_acme_order(self):
self.fail_after_create = True
self.assertEqual(self.start()['status'], 'unknown')
self.assertEqual(self.request('/api/dns-challenge', self.input)[0], 400)
self.assertEqual(self.request('/api/dns-challenge/check', {})[0], 202)
self.assertEqual(self.finish()['status'], 'success')
self.assertEqual(len(self.posts), 1)
def test_restart_does_not_repeat_pending_order(self):
dc.h.save_json(self.panel.dns_challenge.path, {'status':'running','domains':['disk.example.com'],
'provider':'cloudflare','started_at':dc.time.time(),'issued_at':dc.time.time(),'npm_base':self.client.base})
restarted = dc.DNSChallenge(self.control, lambda:self.client)
self.assertEqual(restarted.status()['status'], 'unknown')
with self.assertRaises(h.Error):
restarted.start(self.input)
self.assertEqual(self.posts, [])
def test_clear_api_failure_is_reported_without_retry_or_response_secrets(self):
original = self.client.call.side_effect
self.client.call.side_effect = lambda method,path,**kw: (
(_ for _ in ()).throw(h.APIError('NPM: HTTP 400',400)) if method == 'POST' else original(method,path,**kw))
result = self.start()
self.assertEqual(result['status'], 'error')
self.assertIn('HTTP 400', result['message'])
self.assertEqual(sum(c.args[0]=='POST' for c in self.client.call.call_args_list), 1)
def test_provider_and_email_are_validated_before_submitting(self):
self.input['provider'] = 'unknown_provider'
self.assertEqual(self.start()['status'], 'error')
self.input['provider'] = 'cloudflare'
self.legacy = True
self.input['email'] = ''
self.assertEqual(self.start()['status'], 'error')
self.assertEqual(self.posts, [])
def test_invalid_requests_do_not_start_background_work(self):
for field, value in [('agree',False),('domains',['pve.home']),('domains',['a.local']),
('domains',['192.168.0.1']),('domains',['*.example.com','*.example.com']),
('domains',['a.example.com;rm']),('credentials',''),('email',None),
('propagation_seconds',True),('propagation_seconds',601)]:
with self.subTest(field=field,value=value):
request = dict(self.input, **{field:value})
self.assertEqual(self.request('/api/dns-challenge',request)[0],400)
self.assertIsNone(self.panel.dns_challenge.thread)
def test_dns_endpoints_enforce_session_origin_csrf_and_lan(self):
for headers in [{'X-Homegate-CSRF':''},{'Origin':'https://attacker.example'}]:
self.assertEqual(self.request('/api/dns-challenge',self.input,headers=headers)[0],403)
self.assertEqual(self.request('/api/dns-challenge',self.input,peer='8.8.8.8')[0],403)
self.cookie = ''
for path in ['/api/dns-providers','/api/dns-challenge']:
self.assertEqual(self.request(path)[0],401)
self.assertEqual(self.posts,[])
def test_provider_catalog_uses_only_local_connection_and_safe_fields(self):
with patch.object(self.panel,'connect_npm',return_value=self.client) as connect:
code, body, _ = self.request('/api/dns-providers')
self.assertEqual(code,200)
self.assertFalse(body['email_required'])
self.assertEqual(body['providers'][0]['id'],'cloudflare')
connect.assert_called_once_with()
self.client.call.side_effect = h.APIError('Forbidden',403)
with self.assertRaises(h.APIError):
dc.providers(self.client) # authentication/permission errors must not become legacy fallback
def test_old_api_bad_certificate_id_path_uses_legacy_catalog(self):
self.client.call.side_effect = h.APIError('Invalid certificate id',400)
catalog = dc.providers(self.client)
self.assertTrue(catalog['email_required'])
self.assertTrue(any(p['id']=='cloudflare' for p in catalog['providers']))
def test_result_can_be_selected_without_changing_certificate_or_vds(self):
result = self.start()
state = self.request('/api/state')[1]
config = state['config']
config['domain_zones'].append('example.com')
config['services'] = [{'hostname':'disk.example.com','upstream':'http://192.168.0.20:8080',
'certificate_mode':'npm','npm_certificate_id':result['certificate']['id']}]
self.assertEqual(self.request('/api/config',{'config':config,'revision':state['revision']})[0],200)
self.assertNotIn('DNS_PRIVATE_TOKEN',self.config.read_text())
self.assertEqual(len(self.posts),1)
def test_real_transport_timeout_can_be_extended_only_for_issuance(self):
client = h.NPM('http://home-npm:81','NPM')
self.addCleanup(client.close)
response = Mock(status_code=201, content=b'{}')
response.json.return_value = {}
with patch.object(client.session,'request',return_value=response) as request:
client.call('POST','/nginx/certificates',json={},timeout=(5,900))
self.assertEqual(request.call_args.kwargs['timeout'],(5,900))
client.call('GET','/nginx/certificates')
self.assertEqual(request.call_args.kwargs['timeout'],(5,30))
source = h.RemoteNPM('https://vds.example.com','Remote NPM')
self.addCleanup(source.close)
for method,path in [('GET','/nginx/certificates/dns-providers'),('POST','/nginx/certificates')]:
with self.assertRaisesRegex(h.Error,'read-only'):
source.call(method,path)

6
ui/dist/app.js vendored
View File

@@ -67,9 +67,9 @@ function renderServices(){const c=controller();const first=services().find(r=>r.
<div class="section-heading"><h2>Каталог сервисов <span class="count-label">${services().length}</span></h2><span class="section-kicker">Прокси <span class="mono">${esc(data.config.proxy_ip)}</span></span></div> <div class="section-heading"><h2>Каталог сервисов <span class="count-label">${services().length}</span></h2><span class="section-kicker">Прокси <span class="mono">${esc(data.config.proxy_ip)}</span></span></div>
<section class="panel"><div class="toolbar"><label class="search-box">${icon('search',16)}<input id="service-search" placeholder="Найти сервис, домен или IP…" value="${esc(search)}" aria-label="Поиск сервисов"></label><div class="filters" aria-label="Фильтр сервисов">${[['all','Все сервисы'],['enabled','Включены'],['disabled','Выключены']].map(([v,l])=>`<button class="filter ${filter===v?'active':''}" data-action="filter" data-filter="${v}">${l}</button>`).join('')}</div></div><div class="table-scroll"><table><thead><tr><th>Сервис</th><th>Локальный адрес</th><th>Куда направлять</th><th>Состояние</th><th></th></tr></thead><tbody id="service-rows">${serviceRows()}</tbody></table></div><button class="add-row" data-action="add-service">${icon('plus',14)} Подключить ещё один сервис</button><div class="table-end"><span>Изменения сохраняются в services.yaml</span><span>Обновление каждые ${data.config.interval_seconds||60} сек.</span></div></section> <section class="panel"><div class="toolbar"><label class="search-box">${icon('search',16)}<input id="service-search" placeholder="Найти сервис, домен или IP…" value="${esc(search)}" aria-label="Поиск сервисов"></label><div class="filters" aria-label="Фильтр сервисов">${[['all','Все сервисы'],['enabled','Включены'],['disabled','Выключены']].map(([v,l])=>`<button class="filter ${filter===v?'active':''}" data-action="filter" data-filter="${v}">${l}</button>`).join('')}</div></div><div class="table-scroll"><table><thead><tr><th>Сервис</th><th>Локальный адрес</th><th>Куда направлять</th><th>Состояние</th><th></th></tr></thead><tbody id="service-rows">${serviceRows()}</tbody></table></div><button class="add-row" data-action="add-service">${icon('plus',14)} Подключить ещё один сервис</button><div class="table-end"><span>Изменения сохраняются в services.yaml</span><span>Обновление каждые ${data.config.interval_seconds||60} сек.</span></div></section>
<div class="below-grid"><section class="panel panel-pad"><div class="panel-heading">Как проходит соединение <span class="badge muted">Локальная сеть</span></div><p class="panel-description">${first?`Маршрут для ${esc(first.hostname)}`:'Добавьте сервис, чтобы настроить первый маршрут'}</p><div class="flow"><div class="flow-node"><span class="node-symbol">${icon('monitor',19)}</span><strong>Браузер</strong><small>ваше устройство</small></div><span class="flow-line"></span><div class="flow-node"><span class="node-symbol">${icon('globe',19)}</span><strong>Pi-hole</strong><small>имя → IP</small></div><span class="flow-line"></span><div class="flow-node"><span class="node-symbol">${icon('route',19)}</span><strong>NPM</strong><small>HTTPS · 443</small></div><span class="flow-line"></span><div class="flow-node"><span class="node-symbol">${icon('server',19)}</span><strong>${first?esc(serviceName(first)):'Ваша VM'}</strong><small>${first?esc(new URL(first.upstream).hostname):'IP:порт'}</small></div></div><div class="flow-foot">${icon('shield',12)} Источник HTTPS-сертификата выбирается в настройках сервиса</div></section><section class="panel panel-pad ssh-card"><div class="panel-heading">Серверы на расстоянии команды ${icon('terminal',20)}</div><p class="panel-description">Подключите общий SSH-конфиг на компьютере.<br>IP и порты больше не нужно держать в памяти.</p><div class="command-small"><span><span class="dollar">$</span>ssh ${esc(ssh[0]?.aliases[0]||'имя-сервера')}</span><button class="icon-button" data-action="copy-ssh-command" aria-label="Скопировать SSH-команду">${icon('copy',13)}</button></div><button class="btn" data-action="go-ssh">Настроить SSH-доступ ${icon('arrow',13)}</button></section></div>`;} <div class="below-grid"><section class="panel panel-pad"><div class="panel-heading">Как проходит соединение <span class="badge muted">Локальная сеть</span></div><p class="panel-description">${first?`Маршрут для ${esc(first.hostname)}`:'Добавьте сервис, чтобы настроить первый маршрут'}</p><div class="flow"><div class="flow-node"><span class="node-symbol">${icon('monitor',19)}</span><strong>Браузер</strong><small>ваше устройство</small></div><span class="flow-line"></span><div class="flow-node"><span class="node-symbol">${icon('globe',19)}</span><strong>Pi-hole</strong><small>имя → IP</small></div><span class="flow-line"></span><div class="flow-node"><span class="node-symbol">${icon('route',19)}</span><strong>NPM</strong><small>HTTPS · 443</small></div><span class="flow-line"></span><div class="flow-node"><span class="node-symbol">${icon('server',19)}</span><strong>${first?esc(serviceName(first)):'Ваша VM'}</strong><small>${first?esc(new URL(first.upstream).hostname):'IP:порт'}</small></div></div><div class="flow-foot">${icon('shield',12)} Источник HTTPS-сертификата выбирается в настройках сервиса</div></section><section class="panel panel-pad ssh-card"><div class="panel-heading">Серверы на расстоянии команды ${icon('terminal',20)}</div><p class="panel-description">Подключите общий SSH-конфиг на компьютере.<br>IP и порты больше не нужно держать в памяти.</p><div class="command-small"><span><span class="dollar">$</span>ssh ${esc(ssh[0]?.aliases[0]||'имя-сервера')}</span><button class="icon-button" data-action="copy-ssh-command" aria-label="Скопировать SSH-команду">${icon('copy',13)}</button></div><button class="btn" data-action="go-ssh">Настроить SSH-доступ ${icon('arrow',13)}</button></section></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 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 нужна только в режиме Homegate для зоны вне ограничений текущего корня. Для публичного сертификата NPM, DNS challenge или копии с VDS менять 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('Сертификаты','Локальный CA, сертификаты NPM и обновляемые копии с VDS.',`<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">Для режима Homegate установите корневой CA. Публичный сертификат из NPM или его копия с VDS не требуют установки CA на устройства.</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><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><td>${certificateRenewal(c)}</td></tr>`).join('')||'<tr><td colspan="3"><div class="empty"><p>После первого применения здесь появятся сертификаты.</p></div></td></tr>'}</tbody></table></section>`;} function renderCertificates(){const root=controller().root;const certs=controller().certificates||[];return heading('Сертификаты','Локальный CA, сертификаты NPM и обновляемые копии с VDS.',`<button class="btn primary" data-action="issue-certificate">${icon('shield',14)} Выпустить Let’s Encrypt</button><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">Для режима Homegate установите корневой CA. Публичный сертификат из NPM или его копия с VDS не требуют установки CA на устройства.</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><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><td>${certificateRenewal(c)}</td></tr>`).join('')||'<tr><td colspan="3"><div class="empty"><p>После первого применения здесь появятся сертификаты.</p></div></td></tr>'}</tbody></table></section>`;}
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 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';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);}} 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);}}
@@ -90,7 +90,7 @@ function guide(ca=false){if(!ca&&data.connections){location.hash='settings';retu
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{
if(a==='add-service')serviceModal();else if(a==='edit-service')serviceModal(i);else if(a==='add-zone')zoneModal();else if(a==='add-ssh')sshModal();else if(a==='edit-ssh')sshModal(i);else if(a==='close-modal')$('#modal').close();else if(a==='guide')guide();else if(a==='ca-guide')guide(true);else if(a==='go-ssh')location.hash='ssh'; if(a==='add-service')serviceModal();else if(a==='edit-service')serviceModal(i);else if(a==='add-zone')zoneModal();else if(a==='add-ssh')sshModal();else if(a==='edit-ssh')sshModal(i);else if(a==='close-modal')$('#modal').close();else if(a==='guide')guide();else if(a==='ca-guide')guide(true);else if(a==='issue-certificate')dnsChallengeModal();else if(a==='go-ssh')location.hash='ssh';
else if(a==='filter'){filter=button.dataset.filter;render();} else if(a==='filter'){filter=button.dataset.filter;render();}
else if(a==='sync'){button.disabled=true;const r=await api('/api/sync',{});toast(r.fresh?'Применение запрошено. Дождитесь обновления состояния.':'Запрос сохранён. Контроллер пока не отвечает.');button.disabled=false;} else if(a==='sync'){button.disabled=true;const r=await api('/api/sync',{});toast(r.fresh?'Применение запрошено. Дождитесь обновления состояния.':'Запрос сохранён. Контроллер пока не отвечает.');button.disabled=false;}
else if(a==='toggle-service'){const c=clone(data.config);c.services[i].enabled=c.services[i].enabled===false;await saveConfig(c);} else if(a==='toggle-service'){const c=clone(data.config);c.services[i].enabled=c.services[i].enabled===false;await saveConfig(c);}

View File

@@ -4,6 +4,7 @@ function certificateFields(route) {
<label class="field full">Источник<select name="certificate_mode"> <label class="field full">Источник<select name="certificate_mode">
<option value="homegate" ${mode === 'homegate' ? 'selected' : ''}>Homegate — локальный CA</option> <option value="homegate" ${mode === 'homegate' ? 'selected' : ''}>Homegate — локальный CA</option>
<option value="npm" ${mode === 'npm' ? 'selected' : ''}>Существующий сертификат домашнего NPM</option> <option value="npm" ${mode === 'npm' ? 'selected' : ''}>Существующий сертификат домашнего NPM</option>
<option value="dns_challenge">Let’s Encrypt — DNS challenge</option>
<option value="remote_npm" ${mode === 'remote_npm' ? 'selected' : ''}>Копия из NPM на VDS — автообновление</option> <option value="remote_npm" ${mode === 'remote_npm' ? 'selected' : ''}>Копия из NPM на VDS — автообновление</option>
</select></label> </select></label>
<div class="field full" id="npm-certificate-fields" ${mode === 'homegate' ? 'hidden' : ''}> <div class="field full" id="npm-certificate-fields" ${mode === 'homegate' ? 'hidden' : ''}>
@@ -12,7 +13,7 @@ function certificateFields(route) {
<button type="button" class="btn" id="reload-certificates">${icon('refresh',14)} Обновить список</button> <button type="button" class="btn" id="reload-certificates">${icon('refresh',14)} Обновить список</button>
<small id="certificate-list-status" role="status"></small> <small id="certificate-list-status" role="status"></small>
</div><p class="note field full" id="certificate-help"></p> </div><p class="note field full" id="certificate-help"></p>
</div>`; </div>${dnsChallengeFields(route.hostname || '')}`;
} }
function bindCertificateFields(form, route) { function bindCertificateFields(form, route) {
@@ -20,6 +21,18 @@ function bindCertificateFields(form, route) {
const mode = form.elements.certificate_mode, target = form.elements.npm_certificate_id; const mode = form.elements.certificate_mode, target = form.elements.npm_certificate_id;
const source = form.elements.remote_certificate_id, status = form.querySelector('#certificate-list-status'); const source = form.elements.remote_certificate_id, status = form.querySelector('#certificate-list-status');
let selectedTarget = String(route.npm_certificate_id || ''), selectedSource = String(route.remote_certificate_id || ''); let selectedTarget = String(route.npm_certificate_id || ''), selectedSource = String(route.remote_certificate_id || '');
const dns = bindDNSChallenge(form, cert => {
if(mode.value !== 'dns_challenge') return;
const hostname = form.elements.hostname.value.trim().toLowerCase();
if(hostname && !cert.domains.some(d => d === hostname || (d.startsWith('*.') && hostname.endsWith(d.slice(1)) && hostname.split('.').length === d.split('.').length))) {
form.querySelector('#dns-challenge-status').textContent = `Сертификат #${cert.id} готов, но не покрывает ${hostname}. Укажите соответствующий домен сервиса или выпустите сертификат для него.`;
return;
}
local = [...local.filter(c => c.id !== cert.id), cert];
selectedTarget = String(cert.id); mode.value = 'npm';
update();
status.textContent = 'Сертификат готов. Сохраните сервис — Homegate создаст DNS и прокси. Автопродление уже включено в NPM.';
});
const option = (value, label) => `<option value="${esc(value)}">${esc(label)}</option>`; const option = (value, label) => `<option value="${esc(value)}">${esc(label)}</option>`;
const label = c => `#${c.id} · ${c.name || c.domains.join(', ')} · ${c.domains.join(', ')} · до ${date(c.expires)}${c.provider === 'letsencrypt' ? ' · Let’s Encrypt' : ''}`; const label = c => `#${c.id} · ${c.name || c.domains.join(', ')} · ${c.domains.join(', ')} · до ${date(c.expires)}${c.provider === 'letsencrypt' ? ' · Let’s Encrypt' : ''}`;
function populate(select, certs, selected, placeholder) { function populate(select, certs, selected, placeholder) {
@@ -28,7 +41,10 @@ function bindCertificateFields(form, route) {
select.value = selected; select.value = selected;
} }
function update() { function update() {
const copying = mode.value === 'remote_npm', enabled = mode.value !== 'homegate'; const copying = mode.value === 'remote_npm', issuing = mode.value === 'dns_challenge';
const enabled = ['npm','remote_npm'].includes(mode.value);
if(issuing) dns.load(); else dns.hide();
document.querySelector('button[type="submit"][form="modal-form"]').disabled = issuing;
form.querySelector('#npm-certificate-fields').hidden = !enabled; form.querySelector('#npm-certificate-fields').hidden = !enabled;
form.querySelector('#remote-certificate-field').hidden = !copying; form.querySelector('#remote-certificate-field').hidden = !copying;
target.disabled = !enabled; target.required = mode.value === 'npm'; target.disabled = !enabled; target.required = mode.value === 'npm';
@@ -39,11 +55,12 @@ function bindCertificateFields(form, route) {
form.querySelector('#certificate-help').textContent = { form.querySelector('#certificate-help').textContent = {
homegate: 'Homegate выпускает и продлевает сертификат. На устройствах нужен доверенный корневой CA.', homegate: 'Homegate выпускает и продлевает сертификат. На устройствах нужен доверенный корневой CA.',
npm: 'Homegate привяжет этот сертификат к прокси и создаст локальный DNS. Сертификат не заменяется. Let’s Encrypt автоматически продлевает домашний NPM; Custom нужно обновлять у его издателя.', npm: 'Homegate привяжет этот сертификат к прокси и создаст локальный DNS. Сертификат не заменяется. Let’s Encrypt автоматически продлевает домашний NPM; Custom нужно обновлять у его издателя.',
dns_challenge: 'Сначала выпустите сертификат кнопкой ниже, затем сохраните сервис. Подключение к VDS для этого режима не требуется.',
remote_npm: 'NPM на VDS продлевает сертификат самостоятельно. Homegate проверяет его каждый цикл и копирует обновление домой. На VDS выполняется только чтение. Если интернет недоступен, используется последняя копия до окончания её срока. При выборе существующего Custom обновляется именно он.' remote_npm: 'NPM на VDS продлевает сертификат самостоятельно. Homegate проверяет его каждый цикл и копирует обновление домой. На VDS выполняется только чтение. Если интернет недоступен, используется последняя копия до окончания её срока. При выборе существующего Custom обновляется именно он.'
}[mode.value]; }[mode.value];
} }
async function load() { async function load() {
if(mode.value === 'homegate') return; if(!['npm','remote_npm'].includes(mode.value)) return;
const request = ++generation, copying = mode.value === 'remote_npm'; const request = ++generation, copying = mode.value === 'remote_npm';
status.textContent = 'Загрузка сертификатов…'; status.textContent = 'Загрузка сертификатов…';
const results = await Promise.allSettled([api('/api/npm-certificates'), ...(copying ? [api('/api/remote-certificates')] : [])]); const results = await Promise.allSettled([api('/api/npm-certificates'), ...(copying ? [api('/api/remote-certificates')] : [])]);
@@ -73,6 +90,6 @@ function readCertificateFields(fields, item) {
function certificateRenewal(cert) { function certificateRenewal(cert) {
if(cert.mode === 'remote_npm') return cert.sync_error ? `Ошибка копирования: ${esc(cert.sync_error)}` : `Копия с VDS${cert.synced_at ? ' · проверена ' + esc(new Date(cert.synced_at * 1000).toLocaleString('ru-RU')) : ''}`; if(cert.mode === 'remote_npm') return cert.sync_error ? `Ошибка копирования: ${esc(cert.sync_error)}` : `Копия с VDS${cert.synced_at ? ' · проверена ' + esc(new Date(cert.synced_at * 1000).toLocaleString('ru-RU')) : ''}`;
if(cert.mode === 'npm') return cert.provider === 'letsencrypt' ? 'Автоматически в домашнем NPM' : 'Custom — у издателя сертификата'; if(cert.mode === 'npm') return cert.provider === 'letsencrypt' ? `Автоматически в домашнем NPM${cert.dns_challenge ? ' · DNS challenge' : ''}` : 'Custom — у издателя сертификата';
return 'Автоматически в Homegate'; return 'Автоматически в Homegate';
} }

103
ui/dist/dns-challenge.js vendored Normal file
View File

@@ -0,0 +1,103 @@
function dnsChallengeFields(domains = '') {
return `<fieldset id="dns-challenge-fields" class="dns-challenge-fields" hidden disabled>
<div class="info-box"><p>Домашний NPM выпустит публичный сертификат через временную TXT-запись у DNS-провайдера и будет продлевать его автоматически. Нужен ваш публичный домен. Порты дома открывать в интернет не требуется; NPM на VDS не участвует.</p></div>
<div class="form-grid">
<label class="field full">Домены сертификата<textarea name="dns_domains" rows="2" required placeholder="disk.hyperdog.dev\n*.hyperdog.dev">${esc(domains)}</textarea><small>По одному в строке. Wildcard *.hyperdog.dev покрывает один уровень поддоменов.</small></label>
<label class="field full">DNS-провайдер<select name="dns_provider" required><option value="">Загрузка провайдеров…</option></select></label>
<label class="field full" id="dns-email-field" hidden>Email для Let's Encrypt<input name="dns_email" type="email" disabled placeholder="admin@example.com"></label>
<div class="field full"><details open><summary>Шаблон API-доступа</summary><pre id="dns-credential-template" class="dns-credential-template">Выберите провайдера.</pre></details></div>
<label class="field full">API-доступ DNS-провайдера<textarea name="dns_credentials" rows="4" required autocomplete="off" spellcheck="false" placeholder="Вставьте настройки по шаблону, заменив пример своим токеном"></textarea><small>Токен передаётся только домашнему NPM для выпуска и продления. В настройках Homegate, YAML и логах он не сохраняется. Для Cloudflare нужен API Token с Zone:DNS:Edit для вашей зоны.</small></label>
<label class="field full">Ожидание DNS, секунд<input name="dns_propagation" type="number" min="0" max="600" placeholder="По умолчанию у провайдера"><small>Оставьте пустым, чтобы NPM использовал значение DNS-плагина.</small></label>
<label class="check-line"><input name="dns_agree" type="checkbox" required>Принимаю <a href="https://letsencrypt.org/repository/" target="_blank" rel="noopener noreferrer">условия Let's Encrypt</a></label>
</div>
<p class="note" id="dns-account-note">Для регистрации используется email учётной записи домашнего NPM.</p>
<div class="dns-challenge-actions"><button type="button" class="btn primary" id="start-dns-challenge">${icon('shield',14)} Выпустить сертификат</button><button type="button" class="btn" id="check-dns-challenge" hidden>${icon('refresh',14)} Проверить результат</button></div>
<p class="note" id="dns-challenge-status" role="status" aria-live="polite"></p>
</fieldset>`;
}
function bindDNSChallenge(form, onCertificate) {
const fields = form.querySelector('#dns-challenge-fields');
const button = form.querySelector('#start-dns-challenge'), check = form.querySelector('#check-dns-challenge');
const status = form.querySelector('#dns-challenge-status'), provider = form.elements.dns_provider;
let catalog = null, loading = false, timer = null, watching = false, waiting = false, delivered = null;
const domainNames = () => form.elements.dns_domains.value.split(/[\n,]/).map(s => s.trim().toLowerCase()).filter(Boolean);
function show(job) {
if(!form.isConnected) return;
waiting = job.status === 'running';
button.disabled = waiting || !catalog;
check.hidden = !['unknown','error'].includes(job.status);
status.textContent = job.status === 'idle' ? '' : `${job.domains?.join(', ') || ''}: ${job.message || ''}`;
if(job.status === 'success' && watching && job.id !== delivered) {
delivered = job.id;
onCertificate(job.certificate);
}
if(waiting) { clearTimeout(timer); timer = setTimeout(poll, 1500); }
}
async function poll() {
if(!form.isConnected) return;
try { show(await api('/api/dns-challenge')); }
catch(error) { status.textContent = error.message; check.hidden = false; }
}
function template() {
form.querySelector('#dns-credential-template').textContent = catalog?.providers.find(p => p.id === provider.value)?.template || 'Выберите провайдера.';
}
async function load() {
fields.disabled = false;
fields.hidden = false;
if(!form.elements.dns_domains.value && form.elements.hostname) form.elements.dns_domains.value = form.elements.hostname.value.trim();
if(catalog || loading) return;
loading = true; button.disabled = true;
try {
catalog = await api('/api/dns-providers');
if(!form.isConnected) return;
provider.innerHTML = '<option value="">Выберите провайдера</option>' + catalog.providers.map(p => `<option value="${esc(p.id)}">${esc(p.name)}</option>`).join('');
form.querySelector('#dns-email-field').hidden = !catalog.email_required;
form.elements.dns_email.disabled = !catalog.email_required;
form.elements.dns_email.required = catalog.email_required;
form.querySelector('#dns-account-note').hidden = catalog.email_required;
button.disabled = waiting;
const job = await api('/api/dns-challenge');
const names = domainNames();
watching = job.status === 'running' && (names.length === 0 || names.every(d => job.domains?.includes(d)));
show(job);
} catch(error) { status.textContent = error.message; check.hidden = false; }
finally { loading = false; }
}
provider.addEventListener('change', () => { form.elements.dns_credentials.value = ''; template(); });
button.addEventListener('click', async () => {
if(![...fields.querySelectorAll('input,textarea,select')].every(input => input.reportValidity())) return;
const propagation = form.elements.dns_propagation.value;
const request = {domains:domainNames(), provider:provider.value, credentials:form.elements.dns_credentials.value,
email:form.elements.dns_email.value, propagation_seconds:propagation === '' ? null : Number(propagation), agree:form.elements.dns_agree.checked};
button.disabled = true;
try {
watching = true; delivered = null;
const job = await api('/api/dns-challenge', request);
form.elements.dns_credentials.value = ''; form.elements.dns_agree.checked = false;
show(job);
} catch(error) { status.textContent = error.message; button.disabled = false; check.hidden = false; }
});
check.addEventListener('click', async () => {
check.disabled = true;
try {
if(!catalog) { await load(); return; }
watching = true;
show(await api('/api/dns-challenge/check', {}));
} catch(error) { status.textContent = error.message; }
finally { check.disabled = false; }
});
return {load, hide:() => {fields.hidden = true; fields.disabled = true;}};
}
function dnsChallengeModal() {
showModal('Let’s Encrypt через DNS challenge', 'Выпуск и автопродление в домашнем NPM.',
`<form id="modal-form"><div class="modal-body">${dnsChallengeFields()}<div class="form-error" id="modal-error" hidden></div></div></form>`,
'<div class="form-footer"><button type="button" class="btn" data-action="close-modal">Закрыть</button></div>');
const form = $('#modal-form');
form.addEventListener('submit', e => e.preventDefault());
const dns = bindDNSChallenge(form, cert => {
form.querySelector('#dns-challenge-status').textContent = `Готово: сертификат #${cert.id} для ${cert.domains.join(', ')}. Теперь выберите его в настройках сервиса. Продление выполняется автоматически в домашнем NPM.`;
});
dns.load();
}

3
ui/dist/index.html vendored
View File

@@ -9,6 +9,7 @@
<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="/settings.js" defer></script>
<script src="/dns-challenge.js" defer></script>
<script src="/certificates.js" defer></script> <script src="/certificates.js" defer></script>
<script src="/app.js" defer></script> <script src="/app.js" defer></script>
</head> </head>
@@ -20,7 +21,7 @@
<div class="nav-label">УПРАВЛЕНИЕ</div> <div class="nav-label">УПРАВЛЕНИЕ</div>
<nav id="navigation" aria-label="Разделы"></nav> <nav id="navigation" aria-label="Разделы"></nav>
<div class="sidebar-guide"><span class="guide-orbit">↗</span><strong>Всё остаётся дома</strong><p>Ваши сервисы и настройки — внутри локальной сети.</p><button class="text-link" id="guide-button">Как это работает <span>→</span></button></div> <div class="sidebar-guide"><span class="guide-orbit">↗</span><strong>Всё остаётся дома</strong><p>Ваши сервисы и настройки — внутри локальной сети.</p><button class="text-link" id="guide-button">Как это работает <span>→</span></button></div>
<div class="sidebar-bottom"><span class="online-dot"></span><div><strong>Локальная панель</strong><span>Homegate <span class="version">0.5</span></span></div><button id="logout" class="icon-button" aria-label="Выйти" hidden>↪</button></div> <div class="sidebar-bottom"><span class="online-dot"></span><div><strong>Локальная панель</strong><span>Homegate <span class="version">0.6</span></span></div><button id="logout" class="icon-button" aria-label="Выйти" hidden>↪</button></div>
</aside> </aside>
<div class="sidebar-shade" id="sidebar-shade"></div> <div class="sidebar-shade" id="sidebar-shade"></div>
<div class="workspace-main"> <div class="workspace-main">

2
ui/dist/style.css vendored

File diff suppressed because one or more lines are too long