7.6 KiB
Один домен дома и в интернете
Пример: мобильное приложение использует https://disk.hyperdog.dev.
Снаружи публичный DNS ведёт на VDS. Дома Pi-hole возвращает LAN-IP домашнего NPM,
а домашний NPM направляет запрос в локальный Nextcloud и предъявляет публичный сертификат.
Установка корневого CA на телефон для такого сертификата не требуется.
Уже есть подходящий сертификат в домашнем NPM
- В Настройки → Доменные зоны добавьте
hyperdog.dev. - Добавьте или отредактируйте сервис: домен
disk.hyperdog.dev, адрес локального Nextcloud, напримерhttp://192.168.0.20:8080. - В HTTPS-сертификат → Источник выберите Существующий сертификат домашнего NPM.
- Выберите сертификат из списка и сохраните. Homegate проверит срок и соответствие домену, создаст локальную DNS-запись и прокси с выбранным ID сертификата.
В этом режиме Homegate не выпускает и не загружает сертификат вместо выбранного. Let’s Encrypt автоматически продлевает домашний NPM по своей текущей конфигурации. Для Custom сертификата обновлением занимается его издатель; для автоматического копирования с VDS используйте следующий режим. Смена CA Homegate для новой зоны не нужна.
Автоматическая копия сертификата с NPM на VDS
- В Настройки → Сертификаты с NPM на VDS укажите HTTPS URL панели NPM на VDS
без
/api, логин и пароль существующей учётной записи с доступом к чтению и скачиванию нужного сертификата. Сохраните настройки. Пароль остаётся на сервере и не возвращается в UI. - В карточке сервиса выберите Копия из NPM на VDS — автообновление.
- В списке Сертификат на VDS выберите существующий сертификат Let’s Encrypt.
- В поле Сертификат домашнего NPM оставьте Создать новую копию в домашнем NPM либо выберите существующий Custom, содержимое которого нужно обновлять этой копией.
- Сохраните. После успешной синхронизации в разделе Сертификаты появятся срок действия, источник и время проверки копии.
Оба NPM должны быть разными серверами. При первом успешном копировании Homegate скачивает сертификат, цепочку и ключ с VDS и загружает их только в домашний NPM. Ключ обрабатывается в памяти; он не появляется в логах, публичном API, YAML, SSH-конфиге или registry.json. Сам домашний NPM сохраняет ключ для TLS, как при обычном импорте Custom сертификата.
Production NPM на VDS: только чтение
Код отдельного клиента VDS разрешает только:
POST /api/tokens— обычная авторизация;GET /api/nginx/certificates— список сертификатов;GET /api/nginx/certificates/<id>/download— скачивание выбранного сертификата.
Homegate не создаёт, не редактирует и не удаляет прокси, сертификаты или настройки на VDS и не вызывает там renew. Выпуск и продление продолжаются по уже существующей конфигурации NPM на VDS. Это ограничение проверяется автоматическими тестами. Настраивать Actions, cron, SSH-доступ или скрипт на VDS для копирования не нужно.
Как обновляется домашняя копия
Каждый цикл контроллер читает метаданные источника. При изменении сертификата он скачивает новую версию; дополнительно содержимое проверяется скачиванием раз в сутки. До загрузки проверяются домены всех локальных прокси, использующих копию, срок действия, цепочка и соответствие приватного ключа. Обновление применяется к тому же Custom ID, после чего домашний nginx перезагружается через API NPM. Неудачная перезагрузка повторяется.
Если интернет или API VDS недоступны, последняя копия остаётся в домашнем NPM. Локальные DNS и прокси продолжают обслуживаться; ошибка копирования видна в UI. HTTPS работает до истечения сохранённого сертификата. Для получения новой версии с VDS нужен доступ к его API. Homegate не переходит на свой локальный CA при ошибке.
Штатный экспорт NPM поддерживает скачивание сертификатов Let’s Encrypt; Custom сертификаты VDS в списке источников не показываются. Нельзя синхронизировать копию поверх Let’s Encrypt сертификата домашнего NPM: для неё нужен отдельный Custom.
DNS и Nextcloud
Телефон дома должен использовать Pi-hole как DNS. VPN, Private DNS/DoH и публичный
резервный DNS могут обходить локальную запись. Публичную DNS-запись на VDS менять не нужно.
Сам Nextcloud и его данные должны быть доступны дома без VDS; его trusted_domains
должен содержать выбранное имя, а настройки trusted proxies должны учитывать домашний NPM.
Проверка реализации
Контракты списка, ZIP-экспорта и multipart-загрузки сверены с исходниками NPM 2.12.6. Тесты используют изолированные HTTP-заглушки и настоящие X.509 сертификаты. Реальные credentials и сертификаты production VDS для разработки не использовались.