Hub stage 4: config history, rollback, drift check, baseline export and import

Every saved config, and every earlier baseline, is listed per app. You
can view it, diff it against a server's current config, and roll it back
through preview and apply. Earlier baselines can be restored.

A drift check (HUB_DRIFT_MINUTES, default 15) compares each server with
its effective config. Drift shows in the header and the matrix, with
Accept as baseline and Revert to baseline. All baselines export to one
file. Importing that file shows a dry run before it writes.

Rolling back preselects, and diffs against, the server the version came
from. The line-diff op "del" is renamed to "remove" for the language lint.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

docs/compose.hub.example.yaml

@@ -40,6 +40,8 @@ services:
       - HUB_DATA=/data
       # За Traefik: брать адрес клиента из X-Forwarded-For (для ограничения попыток входа и журнала)
       - HUB_TRUST_PROXY=1
+      # Как часто проверять, что конфиги серверов не разошлись с эталоном (минуты, 0 выключает)
+      # - HUB_DRIFT_MINUTES=15
       - HUB_DOMAIN=dnss.shnt.top
       - TZ=Asia/Novosibirsk
     labels:

docs/compose.shnt.example.yaml

@@ -198,6 +198,8 @@ services:
       - HUB_DATA=/data
       # За Traefik: брать адрес клиента из X-Forwarded-For (для ограничения попыток входа и журнала)
       - HUB_TRUST_PROXY=1
+      # Как часто проверять, что конфиги серверов не разошлись с эталоном (минуты, 0 выключает)
+      # - HUB_DRIFT_MINUTES=15
       - HUB_DOMAIN=dnss.shnt.top
       - TZ=Asia/Novosibirsk
     labels:

docs/hub-deploy.md

@@ -327,6 +327,12 @@ docker compose rm -f technitium-hub     # удалить контейнер
 
 Файлы эталона и локальных полей лежат в `/data/apps/<имя>/` (`baseline.json`, `overrides.json`). Они содержат конфиги, поэтому том `/data` нужно беречь так же, как `users.json`.
 
+## История, откат, контроль расхождений, перенос эталонов
+
+- **История.** Вкладка History в окне Config: все прежние версии, которые хаб сохранил (конфиг сервера перед применением или сохранением, прежний эталон). Выберите версию, чтобы прочитать её и увидеть отличие от текущего конфига сервера. Роли `apps-admin` и `admin`: **Roll back…** (выбор серверов, предпросмотр, итог по каждому) и **Restore as baseline** для прежнего эталона. Хранится по 50 версий на приложение.
+- **Контроль расхождений.** Раз в 15 минут хаб читает конфиги и сравнивает их с тем, что должно быть (эталон плюс локальные поля сервера). Если конфиг поменяли прямо в консоли сервера, в шапке появляется «N config drift». В списке у каждого расхождения есть **Open config**, а для `apps-admin` и `admin` ещё **Accept as baseline** (конфиг этого сервера становится эталоном; локальные поля остаются локальными) и **Revert to baseline** (через предпросмотр). Период меняется переменной `HUB_DRIFT_MINUTES`, `0` отключает проверку. Сервер, который не ответил, показывается как «Cannot read» и в счётчик не входит. Последний результат лежит в `/data/drift.json`.
+- **Перенос эталонов.** Apps › All servers: **Export baselines** скачивает один файл со всеми эталонами и локальными полями, **Import baselines** загружает его в другой хаб: сначала проверка и сводка (New, Changed, Same), запись только после **Import**. На серверы импорт ничего не отправляет. Файл содержит конфиги, храните его как секрет.
+
 ## Приложения: установка, обновление, удаление
 
 Роль `apps-admin` (или `admin`) видит в разделе Apps при «All servers» меню действий в каждой строке и кнопки **App Store** и **Install from file**: