Add UI DNS challenge issuance and automatic home NPM renewal
This commit is contained in:
@@ -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/**
|
||||||
|
|||||||
@@ -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:
|
||||||
|
|||||||
@@ -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 при разработке не выполнялись.
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
11
README.md
11
README.md
@@ -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
|
||||||
не подходит. Установка корневого сертификата на сервер не устанавливает доверие на
|
не подходит. Установка корневого сертификата на сервер не устанавливает доверие на
|
||||||
|
|||||||
18
REGISTRY.md
18
REGISTRY.md
@@ -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
|
||||||
```
|
```
|
||||||
|
|||||||
11
SIMPLE.md
11
SIMPLE.md
@@ -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
26
THIRD_PARTY_NOTICES.md
Normal 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.
|
||||||
@@ -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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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
380
dns-providers-legacy.json
Normal 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
175
dns_challenge.py
Normal 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()
|
||||||
20
homegate.py
20
homegate.py
@@ -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):
|
||||||
|
|||||||
@@ -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
204
tests/test_dns_challenge.py
Normal 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
6
ui/dist/app.js
vendored
@@ -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);}
|
||||||
|
|||||||
25
ui/dist/certificates.js
vendored
25
ui/dist/certificates.js
vendored
@@ -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
103
ui/dist/dns-challenge.js
vendored
Normal 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
3
ui/dist/index.html
vendored
@@ -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
2
ui/dist/style.css
vendored
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user