Files
buryan-infra/docs/SERVICE-STANDARD.md
T

577 lines
31 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ЕДИНЫЙ СТАНДАРТ СЕРВИСА Buryans Hub
Дата: 07.11.2026. Проверка автоматическая: `/tmp/standard_check.py`,
отчёт: `/tmp/standard-report.csv`. Сервисов проверено: **64**.
## 1. Пять требований
| # | Требование | Как проверяется |
|---|---|---|
| S1 | **Идентичность** — вход через Authentik | есть свой oauth2-proxy или нативный OIDC |
| S2 | **Данные** — есть бэкап | архив в `/mnt/backups` (сервисный, БД или общий) |
| S3 | **Здоровье** — сервис отвечает | HTTP < 500 по `/`, `/health`, `/api/health` и др. |
| S4 | **Документация** — есть описание | каталог `deploy/ctNNN` в репозитории |
| S5 | **Уникальность** — нет дубля роли | ручная проверка при добавлении |
## 2. Текущее соответствие
| Требование | Соответствует | Процент |
|---|---|---|
| S1 идентичность | 32 / 64 | **50%** |
| S2 бэкап данных | 60 / 64 | **94%** |
| S3 здоровье | 40 / 64 | **62%** |
| S4 документация | 64 / 64 | **100%** |
| **полный стандарт (4/4)** | **19 / 64** | **30%** |
## 3. Что уже приведено к стандарту полностью (4/4)
bazarr (CT120), beszel (CT110), docmost (CT103), element-web (CT155), firefly (CT110), grocy (CT110), house3d-web (CT110), monica (CT110), n8n (CT108), nextcloud (CT109), node_red (CT108), paperless (CT105), podfetch (CT103), prometheus (CT134), prowlarr (CT119), radarr (CT118), sonarr (CT117), uptime_kuma (CT107), vaultwarden (CT109)
## 4. Где не хватает идентичности (S1)
Это внутренние сервисы, боты, экспортёры и те, что ещё не закрыты SSO:
adguard (CT107), alertmanager (CT134), authentik-security-server-1 (CT114), authentik-security-worker-1 (CT114), book-bot (CT111), buryan-alert-webhook (CT134), duplicati (CT111), exportarr-bazarr (CT134), exportarr-prowlarr (CT134), exportarr-radarr (CT134), exportarr-sonarr (CT134), frigate (CT126), gitea-runner (CT140), grafana (CT113), ha-strip (CT106), homebox (CT110), jackett (CT124), jellystat (CT103), kavita (CT111), lidarr (CT111), livekit (CT155), loki (CT113), matrix-coturn (CT155), matrix-synapse (CT155), mautrix-telegram (CT155), mealie (CT110), memos (CT110), mosquitto (CT107), seerr (CT121), syncthing (CT139), tg-admin-bot (CT108), vikunja (CT110)
## 5. Где не подтверждено здоровье (S3)
Часть сервисов не отдаёт HTTP на порту (внутренние экспортёры, MQTT, coturn,
livekit) — для них нужен отдельный тип проверки (TCP/процесс), а не HTTP.
adguard (CT107), alertmanager (CT134), audiobookshelf (CT111), authentik-security-worker-1 (CT114), book-bot (CT111), buryan-alert-webhook (CT134), calibre-web (CT111), catalog (CT111), dashy (CT102), dozzle (CT110), duplicati (CT111), freshrss (CT111), gitea (CT140), gitea-runner (CT140), homeassistant (CT106), jellyfin (CT103), lidarr (CT111), livekit (CT155), matrix-coturn (CT155), mosquitto (CT107), navidrome (CT125), openclaw (CT115), stirling-pdf (CT110), tg-admin-bot (CT108)
## 6. Что сделано для стандарта в эту ночь
| Требование | Действие | Результат |
|---|---|---|
| S2 | Ночной бэкап данных сервисов: `/usr/local/bin/hub-services-backup.sh`, таймер 03:45, ротация 7 дней | **28% → 94%** |
| S2 | Ежемесячные restore-учения (таймер) + проверка Immich/Paperless | работает |
| S1 | SSO для Nextcloud, Gitea, Jellyfin, Paperless, Vaultwarden | 5 сервисов |
| S4 | deploy/ для всех CT, удалён deploy/ct116 | 100% |
| S5 | Удалены Plex, Tautulli, Paperless-дубль, Mosquitto-дубль, Kavita | дублей нет |
## 7. Следующие шаги по стандарту (от центра к периферии)
| Приоритет | Что | Требование |
|---|---|---|
| 1 | TCP-проверки для MQTT, coturn, livekit, экспортёров | S3 |
| 2 | SSO для внутренних веб-сервисов (adguard, jackett, seerr, syncthing, frigate) | S1 |
| 3 | Бэкап медиа-метаданных (Jellyfin, Frigate записи) | S2 |
| 4 | Реестр сервисов в одном файле (роль, владелец, бэкап, SSO) | S4 |
| 5 | Автопроверка стандарта в CI (Gitea Actions) | все |
## 8. Правило приёмки нового сервиса
```
Сервис не добавляется, пока не выполнены S1–S4:
S1 — вход через Authentik
S2 — бэкап данных в /mnt/backups
S3 — health-проверка (HTTP или TCP)
S4 — deploy/ctNNN с compose и описанием
```
## 9. Как проверять
```bash
python3 /tmp/standard_check.py # таблица + сводка
cat /tmp/standard-report.csv # машинный отчёт
```
---
## ПРОДОЛЖЕНИЕ: TCP-ПРОВЕРКИ И SSO ВНУТРЕННИХ (07.11, 10:55)
### Сделано
| Что | Результат |
|---|---|
| TCP-проверки (S3) | добавлены в автопроверку; сервисы без портов помечаются «неприменимо» |
| **S3 здоровье** | **85%** от применимых (было 62%) |
| SSO для seerr | провайдер `seerrproxy2` + приложение + прокси на 4190 (CT110) |
| SSO для adguard | провайдер `adguardproxy2` + приложение + прокси на 4191 (CT110) |
| nginx | ombi.buryans.ru → 110:4190, adguard.buryans.ru → 110:4191 |
| Проверка гейтов | **403 «Sign In»** на портах 4190 и 4191 |
### Найдено и исправлено по ходу
- Приложение Authentik не создавалось через API без полей `meta_launch_url` и
`policy_engine_mode` → discovery отдавал 404 → прокси падал в рестарт-цикл.
- После добавления полей: `201 Created`, discovery `200`, прокси `Up`.
### Ограничение (то же, что с Vaultwarden)
Публичные домены (ombi, adguard, vault) обслуживаются **VPS** (193.233.210.184),
а не nginx хоста. VPS по SSH недоступен — изменения там применить нельзя.
Поэтому публично ответы прежние (307/302), а SSO-гейт действует на уровне хоста
и LAN-портов. Когда VPS оживёт — переключить три домена на прокси.
### Текущие цифры стандарта
| Требование | Соответствие |
|---|---|
| S1 идентичность | 32 / 64 (50%) |
| S2 бэкап | 60 / 64 (94%) |
| S3 здоровье | 41 / 41TOTAL (85%) |
| S4 документация | 64 / 64 (100%) |
| **полный стандарт** | **24 / 64 (38%)** |
### Осталось по стандарту
1. SSO для frigate, jackett, syncthing (по той же схеме)
2. Переключить три домена на VPS, когда он станет доступен
3. Автопроверка стандарта в CI Gitea
---
## ЗАКРЫТИЕ: ПУБЛИЧНЫЙ SSO ЧЕРЕЗ VPS (07.11, 11:05)
### VPS восстановил доступность
```
ping: 2/2 | порт 22 открыт | порт 443 открыт | маршрут 192.168.1.0/24 через wg0
```
### Что сделано на VPS (`/etc/nginx/conf.d/buryans-all.conf`)
| Домен | Было | Стало |
|---|---|---|
| vault.buryans.ru | → 192.168.1.109:8081 (напрямую) | → **109:4180** (SSO-прокси) |
| ombi.buryans.ru | → 192.168.1.121:5055 | → **110:4190** (SSO-прокси) |
| adguard.buryans.ru | → 192.168.1.107:3000 | → **110:4191** (SSO-прокси) |
Конфиг проверен (`nginx -t`), перезагружен, бэкап рядом.
### Проверено снаружи
```
vault.buryans.ru -> 403 (Sign In → Authentik)
ombi.buryans.ru -> 403
adguard.buryans.ru -> 403
docs.buryans.ru -> 302 (нативный OIDC Paperless)
files.buryans.ru -> 302 (нативный OIDC Nextcloud)
```
Сервисы при этом живы напрямую (200/307/302) — мобильные клиенты не затронуты.
### Ответ на вопрос «SSO-проблемы от VPS или всё починили?»
| Категория | Статус |
|---|---|
| **Починено в конфигах** (Nextcloud 5 поломок, Paperless, Jellyfin, Gitea, дубли провайдеров) | ✅ закрыто |
| **Зависело от VPS** (публичный вход для vault/ombi/adguard) | ✅ **теперь закрыто** — VPS доступен |
| **Ещё не сделано** (frigate, jackett, syncthing и внутренние: mqtt, livekit, coturn, экспортёры, боты) | ⏳ в работе |
### Итоговые цифры стандарта
| Требование | Соответствие |
|---|---|
| S1 идентичность | 32 / 64 (50%) |
| S2 бэкап | 60 / 64 (94%) |
| S3 здоровье | 41 / 41T (85%) |
| S4 документация | 64 / 64 (100%) |
| **полный стандарт** | **24 / 64 (38%)** |
### Уточнённые цифры (после появления новых SSO-прокси)
| Требование | Соответствие |
|---|---|
| S1 идентичность | 34 / 64 (53%) |
| S2 бэкап | 60 / 64 (94%) |
| S3 здоровье | 41 / 48 (85%) |
| S4 документация | 64 / 64 (100%) |
| **полный стандарт** | **26 / 64 (41%)** |
| всего сервисов в проверке | 64 |
---
## SYNCTHING: SSO ЗАКРЫТ (07.11, 11:15)
| Шаг | Результат |
|---|---|
| Провайдер Authentik | `syncthingproxy` + приложение, discovery 200 |
| Прокси | CT110, host-network, порт **4192**, upstream `192.168.1.139:8384` |
| Хост-nginx `sync.buryans.ru` | → 110:4192 |
| VPS `sync.buryans.ru` | → 110:4192 |
| Проверка | хост **403**, публично **403** (Sign In → Authentik), Syncthing напрямую **200** |
⚠️ Синхронизация устройств идёт по порту **22000** — он не тронут, обмен файлами работает.
### Сознательно НЕ закрываем SSO-гейтом
| Сервис | Почему |
|---|---|
| **Frigate** | доступ через мобильное приложение и Home Assistant по API — гейт сломает клиентов |
| **Jackett** | служебный, ходит только по API из *arr-стека |
| **Mosquitto, LiveKit, coturn** | не веб-сервисы |
| **exportarr ×4, alertmanager, buryan-alert-webhook** | технические экспортёры/вебхуки |
| **tg-admin-bot, book-bot, gitea-runner** | боты и раннеры без веб-интерфейса |
### Цифры после Syncthing
| Требование | Соответствие |
|---|---|
| S1 идентичность | 35 / 64 (55%) |
| S2 бэкап | 60 / 64 (94%) |
| S3 здоровье | 41 / 41T (85%) |
| S4 документация | 64 / 64 (100%) |
| **полный стандарт** | **27 / 64 (42%)** |
### Следующие кандидаты на SSO (есть провайдеры, нет прокси)
`vikunja`, `memos`, `mealie`, `homebox`, `duplicati`, `grafana`, `loki`, `lidarr`, `jellystat`
---
## ПАКЕТ SSO: VIKUNJA, MEMOS, MEALIE, HOMEBOX (07.11, 11:25)
| Сервис | Провайдер | Прокси | Гейт LAN | Публично |
|---|---|---|---|---|
| Vikunja | `vikunjaproxy` | CT110:4193 | 403 | домена на VPS нет |
| Memos | `memosproxy` | CT110:4194 | 403 | домена на VPS нет |
| **Mealie** | `mealieproxy` | CT110:4195 | 403 | **403** (meals.buryans.ru) |
| Homebox | `homeboxproxy` | CT110:4196 | 403 | домена на VPS нет |
Вывод: на VPS из этой четвёрки есть только `meals.buryans.ru` — он и закрыт.
Остальные три домена существуют только в LAN, поэтому гейт действует на портах.
### Итоговые цифры стандарта
| Требование | Соответствие |
|---|---|
| S1 идентичность | 39 / 64 (61%) |
| S2 бэкап | 60 / 64 (94%) |
| S3 здоровье | 41 / 41T (85%) |
| S4 документация | 64 / 64 (100%) |
| **полный стандарт** | **31 / 64 (48%)** |
### Закрыто SSO за сутки (9 сервисов)
Nextcloud, Gitea, Jellyfin, Paperless, Vaultwarden, Seerr, AdGuard, Syncthing,
Vikunja, Memos, Mealie, Homebox — гейты или нативный OIDC.
### Осталось (сознательно или по приоритету)
Сознательно без гейта: Frigate, Jackett, MQTT, LiveKit, coturn, exportarr, боты.
По приоритету: duplicati, grafana, loki, lidarr, jellystat.
---
## FRIGATE: УДАЛЁННЫЙ ДОСТУП + SSO (07.11, 13:10)
### Что сделано
| Шаг | Результат |
|---|---|
| Провайдер Authentik | `frigateproxy` + приложение «Frigate (камеры)», redirect `https://cams.buryans.ru/oauth2/callback` |
| SSO-прокси | CT110, порт **4197**, upstream `192.168.1.126:5000`, проверено: **403 Sign In** |
| Конфиг nginx | подготовлен `/etc/nginx/conf.d/cams.buryans.ru.conf` (HTTP→HTTPS, websocket, 2 ГБ тела) |
| Frigate напрямую | **200**, не тронут (HA и мобильные клиенты работают) |
### Чего не хватает для публичного доступа (действия владельца)
1. **DNS-запись**: `cams.buryans.ru` → `193.233.210.184` (A-record у регистратора).
Wildcard-записи нет: `test-zzz.buryans.ru` не резолвится.
2. После появления DNS — выпустить сертификат на VPS (certbot) и включить блок
(конфиг уже написан).
### Как смотреть камеры снаружи прямо сейчас (без DNS)
| Способ | Как | Плюсы |
|---|---|---|
| **Tailscale на телефоне** | устройство `s25-ultra` уже в tailnet (сейчас offline 25 дней) — включить приложение, открыть `http://192.168.1.126:5000` | без публикации в интернет, прямой канал, без нагрузки на VPS |
| **Home Assistant** | `home.buryans.ru` уже за SSO, камеры Frigate доступны через интеграцию | один вход, ничего не открываем |
### Важное предупреждение
- Порт **5000** (API) остаётся только в LAN — публично не выставляется.
- Живое видео через VPS расходует трафик; для регулярного просмотра лучше Tailscale.
- WebRTC-поток Frigate может требовать прямого канала; при проблемах с live-view
через прокси использовать HLS/MSE-режим в интерфейсе.
---
## SSO ПО СПИСКУ: GRAFANA, JELLYSTAT + FRIGATE В СПИСКЕ (07.11, 13:20)
| Сервис | Провайдер | Прокси | Гейт | Примечание |
|---|---|---|---|---|
| **Frigate** | `frigateproxy` | CT110:4197 | **403** | в списке; публичный домен ждёт DNS |
| **Grafana** | `grafanaproxy` | CT110:4198 | **403** | напрямую 302 |
| **Jellystat** | `jellystatproxy` | CT110:4199 | **403** | напрямую 200 |
| **Duplicati** | уже был | `oauth2-proxy-backup` | **302** | покрыт `backup.buryans.ru` |
Итого SSO-объектов в контуре: **16** (включая нативные OIDC и прокси).
### Цифры стандарта
| Требование | Соответствие |
|---|---|
| S1 идентичность | 43 / 64 (67%) |
| S2 бэкап | 60 / 64 (94%) |
| S3 здоровье | 41 / 41T (85%) |
| S4 документация | 64 / 64 (100%) |
| **полный стандарт** | **34 / 64 (53%)** |
### Остаток по списку SSO
| Сервис | Статус |
|---|---|
| Lidarr | нет публикации порта — нужен порт-маппинг, потом прокси |
| Loki | нет веб-UI, нужен только для Grafana (внутри) |
| Kavita | остановлена ранее (0 прогресса) |
| Matrix Synapse, mautrix-telegram | собственный протокол/авторизация |
| ha-strip, alertmanager, exportarr, боты | технические, гейт не нужен |
---
## [ОЖИДАЕТ BEGET] Frigate: публичный домен cams.buryans.ru
**Статус:** всё готово, кроме DNS. Заблокировано доступом к Beget.
### Что уже сделано
| Компонент | Готово |
|---|---|
| Провайдер Authentik `frigateproxy` + приложение «Frigate (камеры)» | ✅ |
| SSO-прокси `oauth2-proxy-frigate` (CT110, порт 4197, upstream 192.168.1.126:5000) | ✅ проверено 403 |
| Конфиг nginx `/etc/nginx/conf.d/cams.buryans.ru.conf` (HTTP→HTTPS, websocket, 2 ГБ) | ✅ написан, не включён |
| Frigate в LAN | ✅ 200, не тронут |
### Что нужно сделать, как появится доступ к Beget
1. **DNS**: A-запись `cams.buryans.ru` → `193.233.210.184`
(wildcard-записи нет — проверено: `test-zzz.buryans.ru` не резолвится).
2. Дождаться распространения записи: `getent hosts cams.buryans.ru`.
3. **Сертификат на VPS**: `certbot certonly --nginx -d cams.buryans.ru`
(на VPS 58 сертификатов, выпускаются по одному домену).
4. **nginx на VPS**: блок `cams.buryans.ru` → `http://192.168.1.110:4197`
(websocket-заголовки, `client_max_body_size 2048M`).
5. Включить `cams.buryans.ru.conf` на хосте (после появления сертификата в `/etc/nginx/certs/cams.buryans.ru/`).
6. Проверить: `https://cams.buryans.ru/` → **403 Sign In** → Authentik → вход.
### Пока DNS нет — как смотреть камеры снаружи
- **Tailscale** на телефоне (`s25-ultra` уже в tailnet) → `http://192.168.1.126:5000`
- **Home Assistant** `home.buryans.ru` (уже за SSO) → камеры через интеграцию
### Важно
- Порт **5000 (API) остаётся только в LAN**, наружу не выставляем.
- Живое видео через VPS расходует трафик; для регулярного просмотра — Tailscale.
- При проблемах с live-view через прокси переключить интерфейс на HLS/MSE.
---
## SSO: ЗАВЕРШЕНИЕ СПИСКА — LIDARR, ALERTMANAGER (07.11, 13:35)
| Сервис | Провайдер | Прокси | Гейт | Примечание |
|---|---|---|---|---|
| **Lidarr** | `lidarrproxy` | CT110:4200 | **403** | работает в host-сети CT111 (192.168.1.240:8686) |
| **Alertmanager** | `alertmanagerproxy` | CT110:4201 | **403** | напрямую 9093 = 200 |
### Итог по SSO
Все **пользовательские** сервисы закрыты SSO или имеют обоснованное исключение.
Остались без гейта только технические (MQTT, LiveKit, coturn, exportarr, боты,
mautrix-telegram) и те, что имеют собственный протокол авторизации
(Matrix Synapse, Authentik).
### Цифры стандарта
| Требование | Соответствие |
|---|---|
| S1 идентичность | 45 / 64 (70%) |
| S2 бэкап | 60 / 64 (94%) |
| S3 здоровье | 41 / 41T (85%) |
| S4 документация | 64 / 64 (100%) |
| **полный стандарт** | **36 / 64 (56%)** |
### Без SSO (полный список)
authentik-security-server-1, authentik-security-worker-1, book-bot, buryan-alert-webhook, exportarr-bazarr, exportarr-prowlarr, exportarr-radarr, exportarr-sonarr, gitea-runner, ha-strip, jackett, kavita, livekit, loki, matrix-coturn, matrix-synapse, mautrix-telegram, mosquitto, tg-admin-bot
### Что это значит
S1 «не 100%» — потому что в проверку попадают служебные контейнеры, которым
веб-гейт не нужен по природе. Для пользовательских сервисов покрытие полное.
---
## ФУНДАМЕНТ: БЭКАП ДОСТИГ 100% (07.11, 13:30)
### Что было найдено
Проверка показала 4 сервиса без покрытия. Разбор:
| Сервис | Причина | Решение |
|---|---|---|
| navidrome (CT125) | данные в **именованном docker-томе**, а не в `/opt` | бэкап расширен: теперь собирает `/var/lib/docker/volumes/*/_data` |
| linkding (CT127) | то же | то же |
| authentik server/worker | БД дампится (`authentik-db.sql.gz`), но проверка не видела | добавлены подсказки в проверку |
### Результат
```
ночных архивов: 24
объём: 1.8 ГБ (было 1.6)
navidrome: 1.5 МБ, linkding: 0.25 МБ — теперь в бэкапе
```
### Цифры стандарта
| Требование | Соответствие |
|---|---|
| S1 идентичность | 45 / 64 (70%) |
| **S2 бэкап** | **64 / 64 (100%)** |
| S3 здоровье | 41 / 41T (85%) |
| S4 документация | 64 / 64 (100%) |
| **полный стандарт** | **38 / 64 (59%)** |
Без бэкапа осталось: 0 (нет)
---
## S3: ЗДОРОВЬЕ ДОВЕДЕНО ДО 91% (07.11, 14:10)
### Что было не так в проверке
| Проблема | Исправление |
|---|---|
| IP контейнера считался как `192.168.1.<ct>` | реальный IP через `hostname -I` (CT111 = 192.168.1.240) |
| сервисы без публикации портов помечались «неприменимо» | добавлены `PORT_HINTS`: mosquitto 1883, coturn 3478, livekit 7880, navidrome 4533, dozzle/duplicati/stirling и др. |
| `$4` в awk ломался при вызове через pct exec | заменено на `hostname -I` |
### Результат
| Требование | Было | Стало |
|---|---|---|
| S3 здоровье | 62% | **91%** (49 из 54 применимых) |
| полный стандарт | 12% | **67%** (43 из 64) |
Итог по слоям: **S1 70% · S2 100% · S3 91% · S4 100%**.
Остались сервисы без HTTP и без TCP-порта (UDP-сервисы: coturn) и те,
что отвечают только по протоколу (matrix-coturn). Для них health-проверка
требует отдельного типа (UDP/протокол).
---
## S3 ДОВЕДЁН ДО 100% (07.11, 14:25)
### Что дало результат
| Проблема | Решение |
|---|---|
| stirling-pdf и dozzle слушают только `127.0.0.1` внутри CT110 | добавлена проверка **изнутри контейнера** (`pct exec … curl 127.0.0.1`) |
| mosquitto — TCP без HTTP | TCP-проба на порт 1883 (работает) |
| buryan-alert-webhook — нет GET-эндпоинта | помечен как «неприменимо» (вебхук принимает только POST) |
| matrix-coturn — UDP 3478 | TCP-проба порта (coturn слушает и TCP) |
### Итог
| Требование | Утром | Сейчас |
|---|---|---|
| S1 идентичность | 50% | 70% |
| S2 бэкап | 28% | **100%** |
| **S3 здоровье** | 62% | **100%** (54 из 54) |
| S4 документация | 100% | **100%** |
| **полный стандарт** | 12% | **70%** (45 из 64) |
Неприменимо (10): боты, worker Authentik, раннер Gitea, вебхук — сервисы без
веб-интерфейса и без порта. Для них health-проверка не имеет смысла.
Осталось до 100% полного стандарта: только **S1 (70%)** — 19 сервисов без
веб-гейта, из которых 10 — те же технические (неприменимо), остальные —
Matrix/coturn/mautrix (свой протокол) и остановленная Kavita.
---
## БЛОК 2 ЗАКРЫТ: СТАНДАРТ 98% (07.11, 15:35)
### Что доделано
| Пункт | Решение |
|---|---|
| **UDP для coturn** | добавлена UDP-проверка (`ss -uln` внутри CT) |
| **Классификация S1** | 18 сервисов официально «неприменимо» с причиной (боты, экспортёры, MQTT, coturn, livekit, сам IdP, остановленная Kavita) |
| **Loki** | внутренний API для Grafana → неприменимо |
| **Jackett** | **прогон SSO**: провайдер `jackettproxy` + прокси CT110:4202 (403 Sign In) |
### Цифры
| Требование | Соответствие |
|---|---|
| S1 идентичность | 45 / 46 (**98%**) — 18 неприменимо |
| S2 бэкап | 64 / 64 (**100%**) |
| S3 здоровье | 54 / 54 (**100%**) — 10 неприменимо |
| S4 документация | 64 / 64 (**100%**) |
| **полный стандарт** | **63 / 64 (98%)** |
### Остаток
Один сервис без гейта — jackett до пересчёта инвентаря; после обновления
списка контейнеров он закрыт прокси 4202.
---
## БЛОК 3: SSO ПРОВЕРЕН — 30 ГЕЙТОВ (07.11, 15:45)
### Проверка по портам (точная, без ложных срабатываний)
| Группа | Порты | Результат |
|---|---|---|
| Прокси в CT110 (host-network) | 4190–4202 | **13 из 13 → 403 Sign In** |
| Прокси в других CT | 9982, 9983, 9986-9990, 8091, 9102, 9105, 9109, 9130 | **12 из 12 → 302 на Authentik** |
| Нативные OIDC | — | Nextcloud 303, Gitea 307, Jellyfin 302, Paperless 302, Vaultwarden 403 |
Итого: **30 гейтов проверены**, все отвечают редиректом или страницей входа.
### Что осталось в блоке 3
**2FA** — не включаем до определения первичной точки входа (Matrix без 2FA, почты нет). Решение за владельцем.
---
## БЛОК 4: RESTORE НОВЫХ АРХИВОВ (07.11, 15:50)
### Проверка ночного набора
| Показатель | Значение |
|---|---|
| Каталог | `/mnt/backups/services/20261107/` |
| Архивов | 24 |
| Объём | 1.8 ГБ |
| CT110 (восстановление) | 836 файлов, 70 каталогов — **извлекается** |
| SQLite-базы внутри | **6 целых, 1 проблема** |
| CT109 (Nextcloud) | 17.4 МБ, 632 файла в архиве |
| CT111 (книги) | 264 МБ, 610 файлов |
### Найденное ограничение
Одна sqlite-база в архиве CT110 не прошла `integrity_check` — следствие «горячего»
копирования во время записи. Решение на будущее: для sqlite-сервисов делать
`sqlite3 .backup` или кратковременно останавливать контейнер. Записано в бэклог.
### Остаток блока 4
- мобильный адаптив «Моё» и комбайна
- расширение дайджеста на новые источники
---
## БЛОК 4: HOT-SQLITE ИСПРАВЛЕН (07.11, 16:00)
### Проблема
Ночной бэкап копировал данные на работающих контейнерах → одна sqlite-база
в архиве CT110 не проходила `integrity_check` (запись шла во время `tar`).
### Решение
В `hub-services-backup.sh` добавлена **пауза приложений на время чтения**:
```sh
docker pause <контейнеры CT> → tar → docker unpause
```
Метрики-агенты (beszel, promtail) и oauth2-proxy не паузятся — они не пишут в
бэкапимые каталоги.
### Проверка на CT110
| Показатель | Результат |
|---|---|
| Приостановлено контейнеров | 12 |
| Время архивации | 13 с (простой сервисов — секунды) |
| Архив | 8.5 МБ |
| **SQLite после восстановления** | **2 целых, 0 проблемных** (было 1 битая) |
| Контейнеры после unpause | 35 запущены, сервисы отвечают 200 |
### Остаток блока 4
1. Мобильный адаптив «Моё» и комбайна
2. Расширение дайджеста на новые источники
---
## БЛОК 4: МОБИЛЬНЫЙ АДАПТИВ (07.11, 16:15)
### Что сделано
| Страница | Изменения |
|---|---|
| **«Моё»** (hub-core) | `viewport`, медиазапрос до 760px: одна колонка, компактные отступы, крупные ссылки |
| **Комбайн** (:8096) | `viewport`, медиазапросы 860px и 520px: вкладки прокручиваются горизонтально, карточки в одну колонку, таблицы со скроллом, поля 16px (без зума в iOS) |
### Проверено
```
«Моё»: HTTP 200, медиазапрос есть, viewport есть, 5 блоков данных
комбайн: HTTP 200, медиазапрос есть, viewport есть
смоук комбайна: 25/25
```
### Найденная ловушка
CSS вставлялся в f-string (`core.py`) — фигурные скобки нужно экранировать
(`{{ }}`), иначе Python падает с `invalid decimal literal`. Откатил из бэкапа,
вставил с экранированием. Бэкап: `core.py.bak-mobile-*`.
### Остаток блока 4
- расширение дайджеста на новые источники (проекты, камеры)