3.4 KiB
3.4 KiB
Стандарт для новых сервисов Buryans Hub (зафиксировано 30.10.2026)
Владелец: «всё делаем в нашем стиле — сразу SSO и база на 151». Это правило для любого нового сервиса, в том числе для 3D-панели дома.
1. Доступ — только через единый вход (Authentik)
- В Authentik создаётся Application + Provider (proxy).
- Перед сервисом ставится oauth2-proxy (как у остальных сервисов):
контейнер в том же CT, конфиг — в
deploy/ctNNN/docker-compose.yml. - nginx (локальный хост + VPS) добавляет
auth_request /oauth2/authиerror_page 401 = /oauth2/sign_in. - Сертификат — из Let's Encrypt на VPS, синхронизируется
sync_certs.py(Tailscale), локальный nginx работает с валидным сертом.
Исключения (осознанные): API-эндпоинты, которые не могут пройти SSO (Matrix client API, HA API с токеном) — для них SSO отключён точечно.
2. Данные — только на основном PostgreSQL 192.168.1.151
- Отдельная база и роль под сервис (никакого общего superuser).
- Пароль — в
/root/.<service>-db.env(права 600), в репозиторий не попадает. - Локальный SQLite — только как временное исключение (HA recorder — см. п. 4).
- Дампы — через существующий
db_dumps.py, хранение в/mnt/archive/backups/db.
Уже заведено для 3D-панели:
| Параметр | Значение |
|---|---|
| База | house3d |
| Роль | house3d |
| Хост | 192.168.1.151:5432 |
| Креды | /root/.house3d-db.env (600) |
3. Эксплуатация (как у всех)
- compose в
deploy/ctNNN/docker-compose.yml, образ с пином; - сервис в
ops/update-manager/services.yaml; - мониторинг: цель в Prometheus + монитор в Uptime Kuma;
- бэкап: дампы БД + конфиги в общий контур;
- документация в
ops/<тема>/и коммит с ID.
4. Открытый вопрос по HA
Сейчас история HA пишется в локальный SQLite (recorder). По новому правилу
её место — Postgres на 151 (отдельная база homeassistant). Переезд
возможен, но требует аккуратной миграции и остановки записи; решение за
владельцем.
5. 3D-панель дома — предварительный план
| Компонент | Где |
|---|---|
| Рендер/сцена | Blender на хосте (артефакты — PNG/SVG в репозитории) |
| Веб-панель (three.js) | контейнер в CT110 (office-lxc) или новый CT |
| Данные (комнаты, устройства, сцены) | Postgres house3d на 151 |
| Доступ | Authentik + oauth2-proxy, домен (предложить 3d.buryans.ru) |
| Мониторинг | Prometheus + Kuma |