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

172 lines
10 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 |