14 KiB
ПЛАН РАЗВИТИЯ 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— обход блокировок.
Чего не хватает:
- в настройках Synapse нет указания на LiveKit — отсюда ошибка;
.well-known/matrix/clientне объявляет транспорт звонков;- ключи связки 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. ПРАВИЛА РАБОТЫ
Выведены по ходу спринта, часть — на своих ошибках:
- Проверяй записью, а не чтением. Чтение работало, а вставка падала неделями.
- Состояние службы — по живому процессу, порту и отклику, а не по состоянию службы в системе (оно мигает).
- Пустой список — это неудача, а не успех.
- Проверяй на настоящих данных, не на случайных образах.
- Никогда не перезапускай Docker массово — по одному контейнеру.
- Сравнивай в одном регистре, иначе ложные расхождения.
- На расхождение — сначала проверь саму проверку.
- Сбой шага — верни состояние и иди дальше.
- Не удаляй без проверенной копии.
- После каждого шага — запись в журнал и фиксация в Git.
8. СОСТОЯНИЕ НА 15.10.2026
| Показатель | Значение |
|---|---|
| Служб в реестре | 28 |
| Обновлено | 24 |
| Контейнеров | 29 + 1 виртуальная машина |
| Баз на общем PostgreSQL | 15 |
| Доменов | 44 |
| Ботов в Matrix | 5 |
| Коммитов | 220+ |
| Известных проблем | 14, из них решено 8 |