6.9 KiB
6.9 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 |
SSO для 3D-панели (30.10.2026)
Создано в Authentik (через API, провайдер по образцу Home Assistant):
| Параметр | Значение |
|---|---|
| Application | 3D Дом, slug 3d |
| Provider | OAuth2/OIDC, pk 61 |
| client_id | 3d-proxy |
| redirect URI | https://3d.buryans.ru/oauth2/callback |
| Issuer | https://authentik.buryans.ru/application/o/3d/ |
| Секреты | /root/.house3d-sso.env (600) |
| База данных | house3d на 192.168.1.151, креды /root/.house3d-db.env (600) |
Что осталось для внешнего доступа
- DNS: A-запись
3d.buryans.ru→193.233.210.184(в Beget). - После DNS — выпуск LE-сертификата на VPS и vhost
3d.buryans.ru(nginx + oauth2-proxy → контейнер в CT110). - Развёртывание стека в CT110: статическая галерея рендеров + oauth2-proxy.
Проверка локально (LAN, без внешнего домена): http://192.168.1.110:8080.
3D-панель развёрнута (31.10.2026)
| Слой | Что сделано | Проверка |
|---|---|---|
| DNS (внешний) | A-запись 3d.buryans.ru → 193.233.210.184 |
dig @8.8.8.8 = 193.233.210.184 |
| DNS (домашний) | AdGuard rewrite 3d.buryans.ru → 192.168.1.10 |
dig @192.168.1.107 = 192.168.1.10 |
| Сертификат | Let's Encrypt на VPS, CN=3d.buryans.ru, до 28.01.2027 | openssl s_client |
| VPS nginx | vhost 3d: SSO auth_request → oauth2-proxy, proxy → 8093 |
локально на VPS: 302 на Authentik |
| Локальный nginx | conf.d/3d-local.conf, серт синхронизируется sync_certs (49 доменов) |
302 на Authentik |
| Приложение | house3d-web (nginx, порт 8093) — галерея рендеров и палитры |
200 |
| SSO | oauth2-proxy-3d (порт 9131), client 3d-proxy, callback https://3d.buryans.ru/oauth2/callback |
302 с правильным client_id |
| Мониторинг | Kuma: «3D Панель (house3d)» 200 OK и «3D Панель (публичный вход)» 302 Found | heartbeat: up |
| Проверки | check-services: web + проверка client_id в редиректе | 58 проверок OK |
| БД | house3d на 192.168.1.151 |
создана |
Ловушки
- Порт 8080 в CT110 занят Firefly — панель перенесена на 8093.
Прямой заход на :8080 даёт ошибку Firefly
HTTP_X_FORWARDED_USER— это защита, а не поломка: заходить надо черезhttps://finance.buryans.ru. oauth2-proxyпо умолчанию строит callback из Host запроса — нуженOAUTH2_PROXY_REDIRECT_URL=https://3d.buryans.ru/oauth2/callback, иначе Authentik отвергнет redirect_uri.- Rewrites в AdGuard лежат в
dns.rewrites(вложенно), а не top-level — top-level блок молча отбрасывается при перезапуске. - Kuma в CT107 резолвил через 1.1.1.1 и из-за этого ходил на VPS (путь нестабилен). Переключили DNS CT107 на AdGuard — 6 «висевших» мониторов сразу стали зелёными.
- Монитор публичного URL надо ставить с
maxredirects=0: иначе Kuma идёт по редиректу в Authentik и получает 403 от его собственного SSO.