267 lines
14 KiB
Markdown
267 lines
14 KiB
Markdown
# ПЛАН РАЗВИТИЯ 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 |
|