16 KiB
Единый вход: фактическая проверка (21.10.2026)
Проверено не по документации, а запросами к каждому домену: куда ведёт первый редирект, есть ли признаки OIDC.
Итог
| Тип | Сколько | Домены |
|---|---|---|
| SSO через forward-auth | 19 | backup, bazarr, books, docs, element, finance, flow, grocy, home, hub, links, music, news, openclaw, prowlarr, radarr, rss, sonarr, status |
| OIDC внутри сервиса | 3 | vikunja, homebox, meals |
| Свой вход | 10 | adguard, files (Nextcloud), matrix, n8n, ombi, plex, immich, sync (Syncthing), vault (Vaultwarden), headscale |
| Собственный UI Authentik | 1 | admin |
| Редиректы на другие домены | 4 | chat→element, recipes→meals, requests→ombi, turn→call |
Всего под SSO: 22 из 33 доменов с сервисами.
Где я ошибался раньше
Отчёт ops/registry/COVERAGE.md строился по строкам портов в реестре.
У сервисов внутри CT портов нет — и они попали в «без SSO» ошибочно.
Фактически большинство из них уже за oauth2-proxy.
Что действительно без SSO
| Сервис | Почему |
|---|---|
plex |
свой вход, OIDC не поддерживает |
immich |
свой вход (API 401) |
syncthing |
свой вход |
vaultwarden |
свой вход (сознательно: хранилище паролей) |
adguard |
свой вход |
nextcloud (files) |
свой вход, OIDC-плагин не установлен |
n8n |
свой вход + свой hub-login |
ombi |
свой вход |
matrix |
отдельная система, свой вход — так и задумано |
headscale |
служебный |
Gitea
Кнопка Authentik есть, локальный вход работает. Проверено владельцем: вход через SSO работает.
Вывод
Единый вход покрывает основную часть сервисов. Оставшиеся 10 — либо сознательно отдельные (Matrix, Vaultwarden), либо не поддерживают OIDC (Plex, Immich, Syncthing, Ombi).
SSO: Memos и Stirling PDF (итог)
Memos — нативный SSO
Memos умеет OIDC через своего провайдера идентификации.
| Что | Значение |
|---|---|
| Провайдер в Authentik | provider-memos-sso, приложение memos-sso |
| Redirect URI | https://memo.buryans.ru/auth/callback |
| IdP в Memos | idp таблица: uid=authentik, type=OAUTH2 |
| Админ Memos | admin (восстановлен через SQL) |
| Прокси | остановлен, домен идёт напрямую в Memos |
Проверка: https://memo.buryans.ru → 200, на странице есть кнопка SSO.
Stirling PDF — SSO через прокси
| Что | Значение |
|---|---|
| Провайдер | provider-stirling, приложение stirling |
| Прокси | oauth2-proxy-stirling на 8090 |
| Собственный вход | отключён: SECURITY_ENABLELOGIN=false |
Проверка: https://pdf.buryans.ru → 302 на Authentik, после входа — сразу приложение.
Ловушки (все три стоили времени)
- API Memos игнорирует поля IdP. POST
/api/v1/identity-providersсоздаёт запись сtype=TYPE_UNSPECIFIED,title="",config={}. Рабочий способ — прямая вставка в таблицуidp. - SQL-пароль в кавычках.
sqlite3с двойными кавычками падает:no such column: "$2a$12$...". Только одинарные кавычки, через файл. pct exec … < файлне видит хостовый файл. Сначалаpct pushв контейнер, потом читать.
Итог по SSO
| Тип | Кол-во |
|---|---|
| forward-auth (oauth2-proxy) | 20 |
| OIDC внутри сервиса | 4 (vikunja, homebox, meals, memos) |
| свой вход | 9 |
Закрытие прямого доступа (важно)
Пока порт приложения открыт в LAN, SSO можно обойти: http://192.168.1.110:8089
открывался мимо прокси. Исправлено:
| Сервис | Было | Стало |
|---|---|---|
| Stirling | 0.0.0.0:8089 |
127.0.0.1:8089 (только для прокси) |
| oauth2-proxy-stirling | порт 8090 через mapping | network_mode: host, слушает 8090 |
| oauth2-proxy-memos | порт 5231 | остановлен, не нужен (нативный SSO) |
Проверка:
8089 закрыт (в обход SSO не зайти)
8090 открыт (это прокси, отдаёт 302 на Authentik)
pdf.buryans.ru → 302 → Authentik
memo.buryans.ru → 200, кнопка Authentik
Ловушка
Если убрать ports у сервиса, но оставить ключ ports: пустым, compose
падает: services.X.ports must be a array. Удалять нужно саму строку.
Настоящая причина «SSO нет»: порт 80
Домашний nginx отдавал на порту 80 дефолтный сервер
(«Welcome to nginx!»), потому что для новых доменов не было блока listen 80.
Заходишь по http://pdf.buryans.ru — HTTPS, прокси и SSO не участвуют.
Исправлено: добавлены блоки с редиректом.
http://pdf.buryans.ru → 301 https://pdf.buryans.ru/
http://memo.buryans.ru → 301 https://memo.buryans.ru/
https://pdf.buryans.ru → 302 https://authentik.buryans.ru/...
Правило при публикации нового домена
- VPS: блок
listen 80с ACME + 301 на https. - Домашний nginx: тоже блок
listen 80с 301 на https. - Только потом
listen 443с прокси на SSO. - Проверять оба протокола:
http://иhttps://.
Без шага 2 домен открывается по HTTP в обход всего.
Vikunja: ошибка «поставщик OpenID не предоставил email»
Симптом
После входа через Authentik Vikunja показывает:
Поставщик OpenID не предоставил адрес электронной почты.
Причина
В переменных Vikunja стояло:
VIKUNJA_AUTH_OPENID_PROVIDERS_AUTHENTIK_SCOPE=openid
Только openid — без email и profile. Authentik физически не отдавал
адрес почты, потому что его не запрашивали.
Скоуп в провайдере Authentik при этом был правильный
(email, profile, openid) — проблема была на стороне клиента.
Исправление
VIKUNJA_AUTH_OPENID_PROVIDERS_AUTHENTIK_SCOPE=openid profile email
Ловушка
Vikunja запущена через docker run, а не compose. В
/opt/lifestyle-lxc/docker-compose.yml её нет — правка compose ничего
не даёт. Пересоздавать нужно через docker run с теми же томами:
-v /opt/lifestyle-lxc/vikunja/files:/app/vikunja/files
-v /opt/lifestyle-lxc/vikunja/db:/db
-p 9285:3456
Проверка
docker inspect vikunja | grep SCOPE → openid profile email
локально: 200, домен: 200
SSO для Memos и Stirling PDF
Схема
Как у остальных сервисов: oauth2-proxy перед приложением.
интернет → VPS nginx (443) → домашний LAN
→ oauth2-proxy-memos :5231 → memos :5230
→ oauth2-proxy-stirling :8090 → stirling :8089
Что сделано
| Шаг | Результат |
|---|---|
| Провайдеры в Authentik | provider-memos, provider-stirling |
| Приложения | memos, stirling |
| Redirect URI | https://memo.buryans.ru/oauth2/callback, https://pdf.buryans.ru/oauth2/callback |
| Контейнеры прокси | oauth2-proxy-memos (5231), oauth2-proxy-stirling (8090) |
| Домашний nginx | домены → прокси, а не напрямую |
| VPS nginx | проксирует на порты SSO, а не на приложение |
Проверка
memo.buryans.ru → 302 https://authentik.buryans.ru/application/o/authorize/?client_id=KqfJv…
pdf.buryans.ru → 302 https://authentik.buryans.ru/application/o/authorize/?client_id=BWqb2…
Ловушки
- Недостаточно закрыть домашний nginx: VPS проксировал напрямую на порт приложения и обходил SSO. Менять надо оба nginx.
- Провайдер в Authentik требует
authorization_flowиinvalidation_flow, аredirect_uris— список объектов, не строка. - oauth2-proxy в CT110 требует
DOCKER_API_VERSION=1.41.
Инцидент: 500 на /oauth2/callback
Симптом: после входа в Authentik прокси отдавал 500 «Внутренняя ошибка сервера».
В логах:
Error redeeming code during OAuth2 callback:
could not verify id_token: failed to verify signature
Причина: провайдеры, созданные через API, получили
signing_key = None. Authentik не подписывал id_token известным ключом,
и oauth2-proxy не мог проверить подпись.
Исправление:
PATCH /providers/oauth2/{pk}/
{"signing_key": "<pk сертификата authentik Self-signed Certificate>"}
После назначения ключа JWKS отдаёт 1 ключ, подпись проверяется.
Правило: при создании OAuth2-провайдера через API всегда указывать
signing_key, иначе вход падает на проверке подписи.
Семантический поиск по документам (B-11)
Что сделано
| Компонент | Где |
|---|---|
| Эмбеддинги | Ollama nomic-embed-text (768), CT160:11434 |
| Хранилище | PostgreSQL + pgvector, CT151, база rag |
| Таблица | chunks(source, ref, text, embedding vector(768)), HNSW-индекс |
| Индексатор | /opt/hub-core/rag.py (полный), rag_priority.py (быстрый) |
| Ответы | /rag?q=... (генерация) и &mode=find (поиск) |
Как работает
- Документ режется на фрагменты по 2500–3000 символов.
- Каждый фрагмент превращается в вектор через Ollama.
- Вектор кладётся в pgvector с уникальным ключом
(source, ref). - На вопрос: вектор вопроса → ближайшие 5 фрагментов → генерация ответа с указанием источников.
Источники (v1)
ops/**/*.md— документация репозитория;- заметки Memos (SQLite из CT110).
Проверка
cd /opt/hub-core
/opt/music-tools/venv/bin/python rag.py ask "как устроен мониторинг Beszel?"
curl -s 'http://127.0.0.1:9120/rag?q=как+устроен+беczel' | head -c 400
Ловушки
- Эмбеддинг на CPU медленный: ~8–20 с на фрагмент при загруженной машине. Поэтому индексируем крупными кусками (2500–3000 символов), а не по 1000.
- Индексация должна коммитить каждые N фрагментов, иначе при прерывании теряется всё (транзакция откатывается).
psycopg2требуетclient_encoding=utf8— без него русский текст падает сUnicodeEncodeError./askуже занят (агентский ответ по медиа), поэтому RAG живёт на/rag.- Ollama был привязан к
127.0.0.1; открыт в LAN черезOLLAMA_HOST=0.0.0.0(drop-in в CT160).
Что дальше
- Добавить Paperless (тексты документов) и Nextcloud (txt/md).
- Инкрементальная индексация по времени изменения файла.
- Вечерний отчёт: «добавлено N фрагментов».
Режимы работы
| Режим | Запрос | Время | Что делает |
|---|---|---|---|
| Поиск | /rag?q=...&mode=find |
~14 с | находит фрагменты, без генерации |
| Ответ | /rag?q=... |
минуты | поиск + генерация моделью |
Проверено на живом примере: вопрос «как устроен Beszel» →
первый результат ops/ops/BESZEL.md#0 со счётом 0.63.
Ограничение: генерация на CPU
qwen2.5:3b на этой машине генерирует ответ дольше 10 минут при
текущей нагрузке (память в свопе). Поэтому:
- поиск использовать можно — он быстрый и полезный;
- генерацию — только когда освободится память, либо перейти
на
qwen2.5:0.5b/1.5b.
После работы модель выгружается (keep_alive=0), чтобы не держать
1.2 ГБ в памяти.
Обучение агента: подсказки по повторяющимся сбоям (B-21)
Что добавлено
- Дедупликация причин. Раньше в памяти копилось
["docker state: exited", "docker state: exited", ...]— теперь одинаковые подряд не дублируются. - Словарь решений
SOLUTIONS. Для типовых сбоев агент печатает подсказку рядом с проблемой. - Поле
hintв отчёте (/var/lib/hub-agents/journal/<дата>-runner.json).
Таблица подсказок
| Причина | Подсказка |
|---|---|
exited |
перезапустить контейнер; если повторяется — смотреть логи и память CT |
restarting |
чаще всего права на том или конфликт порта |
no space |
docker system prune и ротация логов |
permission denied |
chown тома после пересоздания контейнера |
connection refused |
сервис не слушает порт: проверить процесс и ss -ltn |
не в статусе |
нет /health: проверить nginx-прокси и порт |
cert |
certbot renew и копирование в /etc/nginx/certs |
Пример вывода
✗ freshrss (CT111, сбоев 3): docker state: exited
→ перезапустить контейнер: healthcheck в CT делает это сам;
если повторяется — смотреть docker logs и память CT
Что дальше
- Копить статистику: какая подсказка реально помогла (флаг
resolved_by). - Ограничить автоматические действия классом B (уже сделано в
actions.py).