Причина отказа найдена в коде HA: он запрещает вход по доверенной сети с адреса, внесённого в http.trusted_proxies, а если адрес не внесён и приходит X-Forwarded-For — отвечает 400. Решение: trusted_networks для сети Docker с trusted_users (пользователь Roman), trusted_proxies без сети прокси, и nginx-прослойка ha-strip между прокси и HA, которая вычищает X-Forwarded-For и X-Real-IP. Проверено: способы входа содержат Trusted Networks, авто-вход отдаёт create_entry, круг через домен — 200 Home Assistant, в журнале HA новых ошибок нет, прямой заход из локальной сети по-прежнему требует пароль.
4.3 KiB
4.3 KiB
Home Assistant: вход через Authentik — сделано
Замена прошлой записи HOME-ASSISTANT-SSO-STATUS.md (там был откат).
Причина отказа найдена в коде HA, обход — рабочий.
1. Почему не работало
В Home Assistant два разных запрета, и мы попадали то в один, то в другой:
# homeassistant/auth/providers/trusted_networks.py
if any(ip_addr in trusted_proxy for trusted_proxy in self.trusted_proxies):
raise InvalidAuthError("Can't allow access from a proxy server")
- Если адрес прокси внесён в
http.trusted_proxies— HA запрещает вход по доверенной сети с этого адреса. Это и давалоnot_allowedпри любых сетях, вплоть до0.0.0.0/0. - Если адрес прокси не внесён в
trusted_proxies, но прокси присылаетX-Forwarded-For— HA отвечает 400 и пишет в журнал:Received X-Forwarded-For header from an untrusted proxy 172.17.0.2.
А oauth2-proxy не умеет не передавать X-Forwarded-For (в --help такого
ключа нет).
2. Решение
| Шаг | Что сделано |
|---|---|
| 1 | homeassistant.auth_providers: trusted_networks c сетью Docker 172.16.0.0/12, trusted_users → пользователь Roman, allow_bypass_login: true |
| 2 | http.trusted_proxies: оставлен только 127.0.0.1 — прокси там быть не должно |
| 3 | Между oauth2-proxy и HA поставлена прослойка ha-strip (nginx в сети ha-sso), которая вычищает X-Forwarded-For и X-Real-IP |
| 4 | Домен home.buryans.ru → oauth2-proxy-home (9130) → ha-strip → HA :8123 |
Схема:
браузер → nginx (VPS и дом) → oauth2-proxy-home :9130
→ ha-strip (снимает X-Forwarded-For)
→ Home Assistant :8123
HA видит адрес ha-strip (сеть Docker) — он в доверенной сети, а признаков
прокси в запросе нет. Поэтому вход выполняется автоматически пользователем
Roman, без формы.
3. Что проверено
| Проверка | Результат |
|---|---|
check_config HA |
чистый |
| Способы входа от прокси | trusted_networks + homeassistant |
| Начало входа от прокси | create_entry — HA сразу выдаёт вход, формы нет |
| Весь круг через домен | Authentik → HA, `итог 200 |
| Журнал HA | новых untrusted proxy и 400 нет |
Прямой заход на 192.168.1.106:8123 из локальной сети |
200, своя форма — то есть доступ из дома без пароля не открылся |
4. Что важно помнить
- Доверенная сеть — это сеть Docker. Любой контейнер в CT 106, попавший в
172.16.0.0/12, войдёт в HA как Roman. Сеть маленькая и локальная, но это осознанный компромисс, а не недосмотр. - Прослойка обязательна. Если её убрать, вернётся 400 от HA. Скрипт
пересоздания прокси должен указывать upstream
http://ha-strip:80, а не192.168.1.106:8123. trusted_proxiesне должен содержать сеть прокси — иначе HA снова откажет по своей защите от входа «с прокси-адреса».- Копия конфига HA до правок:
/opt/smart-lxc/homeassistant/config.bak-sso-20261019_140039.
5. Файлы
| Что | Где |
|---|---|
| Конфиг прослойки | /opt/ha-strip/nginx.conf (CT 106) |
| Сеть Docker | ha-sso |
| Контейнеры | ha-strip, oauth2-proxy-home (оба restart unless-stopped) |
| Скрипты настройки | ops/sso/2026-10-19-ha-sso/ |