Add NPM certificate selection and read-only VDS certificate renewal sync
All checks were successful
Test and publish Homegate / checks (push) Successful in 28s
Test and publish Homegate / publish (push) Successful in 12m47s

This commit is contained in:
2026-10-15 05:12:03 +03:00
parent b305cc1ba8
commit eeffcfb616
18 changed files with 838 additions and 49 deletions

View File

@@ -1,4 +1,4 @@
# Homegate 0.4.2
# Homegate 0.5.0
Дополнение к **существующим Pi-hole и Nginx Proxy Manager** для домашней сети:
@@ -11,20 +11,23 @@ https://pve.home → NPM:443 → https://192.168.0.137:8006
Веб-панель Homegate управляет сервисами, доменными зонами, SSH и настройками сети.
SSH-конфиг публикуется без авторизации для устройств домашней подсети.
**Простой запуск 0.4.2: [Compose без env и secrets, вся настройка в UI](SIMPLE.md).**
**Простой запуск 0.5.0: [Compose без env и secrets, вся настройка в UI](SIMPLE.md).**
Откройте `http://IP-СЕРВЕРА:8098` и заполните адреса NPM/Pi-hole в форме. Пароль панели не нужен.
Расширенный вариант с отдельными контейнерами: [Compose и Gitea Actions](REGISTRY.md).
Также доступны: [веб-панель и локальный запуск](WEB.md), [SSH-конфиг и скрипт для ПК](SSH.md), [кастомные доменные зоны и миграция CA](DOMAINS.md).
**Для HTTPS без предупреждений нужно один раз установить `root-ca.crt` на каждое
клиентское устройство.** Для внутренних имён `.home` публичный сертификат Let's Encrypt
**Для публичного домена можно выбрать существующий сертификат NPM или обновляемую
копию с NPM на VDS — без установки CA на телефон.** Настройка целиком через UI:
[сертификаты NPM и синхронизация с VDS](CERTIFICATES.md).
Для режима **Homegate — локальный CA** нужно один раз установить `root-ca.crt` на каждое
клиентское устройство. Для внутренних имён `.home` публичный сертификат Let's Encrypt
не подходит. Установка корневого сертификата на сервер не устанавливает доверие на
телефонах и компьютерах. Доверие к локальному CA описано в
[документации Let's Encrypt](https://letsencrypt.org/docs/certificates-for-localhost/).
Зоны настраиваются списком `domain_zones`: например `home`, `home.arpa`, `lab.internal`,
`lab.example.net`. Поддерживаются несколько зон одновременно и несколько уровней
поддоменов; каждому имени выпускается отдельный сертификат. В примере сохранено `pve.home`.
поддоменов; источник сертификата выбирается для каждого сервиса. В примере сохранено `pve.home`.
Для новой домашней зоны стандарт рекомендует `home.arpa`:
[RFC 8375](https://www.rfc-editor.org/rfc/rfc8375.html).
@@ -47,7 +50,7 @@ DNS указывает на **NPM**, а не на Proxmox. Порт и прот
Сервис `ssh-export` публикует HTTP-порт `8099` на явно заданном LAN-IP и проверяет
клиента по `allowed_networks`. Он не имеет доступа к `state/` и паролям API.
Он может работать на отдельной Linux VM с доступом к API вашего Pi-hole и NPM.
Образ пока не опубликован. `compose.yaml` собирает его из исходников;
`compose.yaml` собирает образ из исходников;
`compose.registry.yaml` скачивает готовый образ после публикации через Gitea Actions.
Для запуска только по одному файлу, без исходников и setup.sh, см. [REGISTRY.md](REGISTRY.md).
@@ -65,7 +68,7 @@ DNS указывает на **NPM**, а не на Proxmox. Порт и прот
- Если Pi-hole и NPM на одном IP, их web-порты должны различаться: например NPM
`80/81/443`, Pi-hole web `8080`, DNS `53`. Homegate этот конфликт автоматически не исправляет.
Проверены Compose-конфигурация, shell-синтаксис и 63 теста: сертификаты, настоящее TLS-рукопожатие
Проверяются Compose-конфигурация, shell-синтаксис и автоматические тесты: сертификаты, настоящее TLS-рукопожатие
в стандартных и кастомных зонах, продление, повторный запуск, конфликты, ошибки API,
смена CA, HTTP-обработчик выгрузки, LAN ACL и отказ опасных SSH-директив.
Подключение дополнительного файла также проверено настоящим `ssh -G` с сохранением личных настроек.