5.3 KiB
ЕДИНЫЙ СТАНДАРТ СЕРВИСА 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. Как проверять
python3 /tmp/standard_check.py # таблица + сводка
cat /tmp/standard-report.csv # машинный отчёт