577 lines
31 KiB
Markdown
577 lines
31 KiB
Markdown
# ЕДИНЫЙ СТАНДАРТ СЕРВИСА 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
|
||
- расширение дайджеста на новые источники (проекты, камеры)
|