Add UI DNS challenge issuance and automatic home NPM renewal
This commit is contained in:
@@ -5,6 +5,57 @@
|
||||
а домашний NPM направляет запрос в локальный Nextcloud и предъявляет публичный сертификат.
|
||||
Установка корневого 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
|
||||
|
||||
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).
|
||||
Тесты используют изолированные HTTP-заглушки и настоящие X.509 сертификаты.
|
||||
Реальные 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 при разработке не выполнялись.
|
||||
|
||||
Reference in New Issue
Block a user