# ПЛАН РАЗВИТИЯ BURYAN-HUB Единый документ: что делаем, в каком порядке, зачем. Составлен 15.10.2026 по итогам ночного спринта. --- ## ПОРЯДОК РАБОТ ``` 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ 4 службы ← мы здесь 2. СЕТЬ И ДОСТУП вход, DNS, VPS 3. ЗВОНКИ И МЕДИА Element Call 4. СКВОЗНАЯ СВЯЗНОСТЬ единый вход, уведомления, мониторинг 5. УЛУЧШЕНИЕ СЛУЖБ по каждой отдельно ``` **Почему такой порядок:** обновления меняют службы, сеть меняет двери, звонки требуют и того и другого. Делать в другом порядке — переделывать. --- # 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ **Осталось 4 службы.** Причина прошлых неудач устранена (профиль безопасности запрещал создание сокетов Unix). | Задача | Служба | Что нужно | |---|---|---| | 1.1 | `paperless` | применить профиль, обновить | | 1.2 | `gitea` | то же — **хранилище кода, всё наше** | | 1.3 | `authentik` | то же — **вход во все службы** | | 1.4 | `postgres-rbac` | то же — **общая база** | **Правила:** * по одному контейнеру за раз, без массовых перезапусков; * проверка на **настоящем** образе службы, не на случайном; * профиль полный, с правилом `capability`; * перед каждым — проверка, что служба отвечает. **Отдельно: вынести профиль безопасности в общее управление.** Сейчас у каждого контейнера своя копия. Нужен один источник правды, чтобы правка делалась в одном месте. --- # 2. СЕТЬ И ДОСТУП **Найденная проблема:** страница входа Authentik грузится **7,86 с** вместо 0,02 с. Каждый файл идёт дом → VPS за границей → обратно. Приложение не дожидается и выдаёт «не удалось войти». **Измерено:** ``` через VPS: главная 1.06 с, скрипты 0.92–2.69 с → всего 7,86 с напрямую: 0.019 с → в 400 раз быстрее ``` | Задача | Что делаем | Что получим | |---|---|---| | 2.1 | **Кэш на VPS** для файлов входа | помощ всем сразу, правится за минуты | | 2.2 | **Локальный NGINX вместо NPM** | дома вход за 0,02 с, VPS не участвует | | 2.3 | **AdGuard как DNS** | домашние устройства идут напрямую | | 2.4 | **Все 44 домена** | настроить то, что сейчас не работает | | 2.5 | **Разобраться с VPS** | кэш, резерв, или новая роль | | 2.6 | **Один сертификат** `*.buryans.ru` | вместо 44 отдельных | **Что важно понимать:** * 44 домена в DNS, из них настроено **12**. Остальные указывают на VPS и попадают в заглушку; * **одна дверь на всё** — VPS. Откажет он, откажет всё; * у дома **уже есть всё нужное**: NPM (не используется), AdGuard (не отдаёт DNS), NGINX 1.26.3 установлен. --- # 3. ЗВОНКИ И МЕДИА **Задача 3.1 — Element Call (отдельная задача, как решено).** Ошибка при звонке: ``` MISSING_MATRIX_RTC_TRANSPORT Сервер не настроен для работы с Element Call ``` **Что уже есть:** * контейнер `livekit` — служба пересылки медиа; * контейнер `matrix-coturn` — обход блокировок. **Чего не хватает:** 1. в настройках Synapse нет указания на LiveKit — **отсюда ошибка**; 2. `.well-known/matrix/client` не объявляет транспорт звонков; 3. ключи связки Synapse и LiveKit не заданы. **Задача 3.2 — медиаслужбы:** Plex, Jellyfin, Audiobookshelf, Navidrome, Immich, Photoprism — свести к единому входу и правам. --- # 4. СКВОЗНАЯ СВЯЗНОСТЬ Смысл раздела: чтобы службы **работали как одно целое**, а не каждая сама по себе. ## 4.1 Единый вход (SSO) | Задача | Что делаем | |---|---| | 4.1.1 | Все 44 домена — под единый вход Authentik | | 4.1.2 | Проверить, где вход есть, а где нет | | 4.1.3 | Права по группам: одни службы — всем, другие — избранным | **Сейчас:** приложений в Authentik — **22**, доменов — **44**. Значит половина служб входа не имеет. ## 4.2 Единые уведомления | Задача | Что делаем | |---|---| | 4.2.1 | Все службы шлют через общий слой (**сделано** для 5 процессов) | | 4.2.2 | Подключить остальные: обновления, тревоги, доступ | | 4.2.3 | Разделение по ботам: ALERT, ADM, WORK, AUTH, MEDIA (**сделано**) | ## 4.3 Мониторинг | Задача | Что делаем | |---|---| | 4.3.1 | **Все 28 служб** в наблюдение — сейчас часть | | 4.3.2 | Проверять не «отвечает», а «работает»: жив процесс, порт, отклик | | 4.3.3 | Отдельная проверка: **вход работает**, а не только служба | | 4.3.4 | Оповещение в Matrix по каждому виду сбоя | ## 4.4 Резервное копирование | Задача | Что делаем | |---|---| | 4.4.1 | Снимки **перед каждым** изменением — уже делается | | 4.4.2 | **Проверка восстановления** — не только создание копии | | 4.4.3 | Копии наружу (вне дома) | | 4.4.4 | Разобрать 13 копий баз `_pre_utf8_*` (258 МБ) | ## 4.5 Обновления | Задача | Что делаем | |---|---| | 4.5.1 | Профиль безопасности — **единый** для всех контейнеров | | 4.5.2 | Различать «обновлено» и «уже актуально» в отчёте | | 4.5.3 | Убирать контейнеры-остатки **автоматически** | | 4.5.4 | Проверка «образ запускается» **до** обновления службы | ## 4.6 Карта и документация | Задача | Что делаем | |---|---| | 4.6.1 | **Карта хозяйства**: служба → контейнер → домен → вход → копия | | 4.6.2 | Список всех доменов с назначением | | 4.6.3 | Живой справочник: обновляется сам из настроек | --- # 5. УЛУЧШЕНИЕ СЛУЖБ ## 5.1 Что уже сделано | Направление | Состояние | |---|---| | Базы сведены в общий PostgreSQL | **сделано**, 15 из 17 | | Счётчики номеров выровнены | **сделано**, 10 баз | | Службы обновлены | **24 из 28** | | Боты в Matrix | **сделано**, 5 ботов | | Уведомления через общий слой | **сделано** | | Справочник команд | **сделано**, 13 команд | | Механизм обновления с откатом | **сделано и проверено** | ## 5.2 По каждой службе — что улучшить ### Инфраструктурные | Служба | Что улучшить | |---|---| | `gitea` | вход через единый вход; проверка, что задачи создаются; зеркала репозиториев | | `authentik` | скорость; **разобраться с медленной загрузкой**; группы и права | | `vaultwarden` | вход через единый вход; проверка восстановления из копии | | `postgres-rbac` | наблюдение за нагрузкой; пределы соединений; план обслуживания | | `n8n` | все процессы на общий слой уведомлений; копии процессов в Git | | `npm` | решить судьбу — заменяется на NGINX | | `headscale` | **разобраться, зачем он дома** — координацию держит VPS | | `matrix` | звонки (задача 3.1); вход для новых; наблюдаемость | | `uptime-kuma` | перевести на PostgreSQL или заменить | | `prometheus` | сроки хранения; правила тревог на все службы | | `grafana` | панели по всем службам; вход через единый вход | ### Медиа и данные | Служба | Что улучшить | |---|---| | `plex`, `jellyfin` | единый вход; общие права; убрать дублирование | | `sonarr`, `radarr`, `prowlarr`, `bazarr` | **проверить запись в базы** (счётчики выровнены, но запись не проверена) | | `overseerr`, `tautulli` | единый вход | | `paperless` | **двойной экземпляр** (CT 105 и CT 110) — выбрать один; ускорить запуск | | `immich` | база вне общего PostgreSQL — свести | | `mealie`, `freshrss`, `linkding`, `navidrome`, `calibre` | единый вход; проверка копий | | `syncthing` | права и наблюдение | | `dashy` | сделать стартовой страницей со ссылками на всё | ### Прочее | Служба | Что улучшить | |---|---| | `openclaw` | определить назначение, вписать в общую схему | --- # 6. НАЙДЕННЫЕ ПРОБЛЕМЫ (реестр) | № | Проблема | Состояние | |---|---|---| | 1 | Профиль безопасности запрещал создание сокетов | **причина найдена**, Matrix исправлен | | 2 | Профиль нужен в каждом контейнере отдельно | **не сделано** | | 3 | 13 контейнеров-остатков держали порты | **остановлены**, убрать автоматически | | 4 | Счётчики номеров не были выровнены | **исправлено** в 10 базах | | 5 | Gitea не могла создавать задачи | **исправлено** | | 6 | Домашний headscale падал 2,7 суток | **исправлено** | | 7 | Уведомления об обновлениях шли в AUTH | **исправлено** | | 8 | Версия не попадала в уведомление | **исправлено** | | 9 | Страница входа грузится 7,86 с | **причина найдена**, не исправлено | | 10 | 44 домена, настроено 12 | **не сделано** | | 11 | Element Call не работает | **отдельная задача** | | 12 | Одна дверь (VPS) на всё | **не сделано** | | 13 | `paperless` — два экземпляра | **не сделано** | | 14 | Immich вне общего PostgreSQL | **не сделано** | --- # 7. ПРАВИЛА РАБОТЫ Выведены по ходу спринта, часть — на своих ошибках: 1. **Проверяй записью, а не чтением.** Чтение работало, а вставка падала неделями. 2. **Состояние службы — по живому процессу, порту и отклику**, а не по состоянию службы в системе (оно мигает). 3. **Пустой список — это неудача**, а не успех. 4. **Проверяй на настоящих данных**, не на случайных образах. 5. **Никогда не перезапускай Docker массово** — по одному контейнеру. 6. **Сравнивай в одном регистре**, иначе ложные расхождения. 7. **На расхождение — сначала проверь саму проверку.** 8. **Сбой шага — верни состояние и иди дальше.** 9. **Не удаляй без проверенной копии.** 10. **После каждого шага — запись в журнал и фиксация в Git.** --- # 8. СОСТОЯНИЕ НА 15.10.2026 | Показатель | Значение | |---|---| | Служб в реестре | 28 | | Обновлено | **24** | | Контейнеров | 29 + 1 виртуальная машина | | Баз на общем PostgreSQL | 15 | | Доменов | 44 | | Ботов в Matrix | 5 | | Коммитов | 220+ | | Известных проблем | 14, из них решено 8 |