Files
buryan-infra/docs/HOME-SERVICES-INTEGRATION.md
root ee17c9c9b3 Интеграция домашних сервисов: Nextcloud на files, Home Assistant на home
ОБНАРУЖЕНО: у Nextcloud и Home Assistant вообще не было доменов — только
IP внутри сети, и у каждого свой пароль.

СДЕЛАНО:
1. NECTCLOUD -> files.buryans.ru (раньше домен вёл на Paperless).
   Вход через Authentik средствами самого Nextcloud (приложение
   user_oidc), а не прокси — потому что мобильный клиент и синхронизация
   ходят в API напрямую, прокси их сломал бы. Добавлены доверенные домены
   files/cloud, поправлен overwrite.cli.url для ссылок в письмах.
   Paperless остался на docs.buryans.ru.
2. HOME ASSISTANT -> home.buryans.ru (раньше заглушка). Вход через
   oauth2-proxy-ha на 9111. API (/api, /local, /auth, /static) намеренно
   НЕ закрыт единым входом — иначе перестанет работать мобильное
   приложение; при этом API защищён токенами HA (отвечает 401).
3. ПОПУТНО в HA исправлено: internal_url и external_url стояли на верхнем
   уровне конфига, HA ругался "Integration 'internal_url' not found" —
   перенесены внутрь homeassistant.

ПРОВЕРЕНО: files 302 -> /login со входом через Authentik; home 302 ->
Authentik; API HA без токена 401; docs 302 (Paperless на месте);
Zigbee2MQTT 200; наблюдение 58 проверок без провалов; все контейнеры
работают.

ОСТАЛОСЬ: тревога "Высокая нагрузка" (следствие моих сборок, уйдёт сама),
уведомления HA в Matrix, календарь Nextcloud в HA, обновить Dashy.
2026-10-18 22:51:06 +03:00

3.5 KiB
Raw Permalink Blame History

Интеграция домашних сервисов: Nextcloud и Home Assistant (18.10.2026)

Что было

Сервис Адрес Вход
Nextcloud 33 только 192.168.1.109:8080 свой пароль
Home Assistant только 192.168.1.106:8123 свой пароль

Ни у одного не было домена. Снаружи недоступны, единого входа нет.

Что сделано

Nextcloud → files.buryans.ru

Что Как
Домен files.buryans.ru (раньше вёл на Paperless)
Вход через Authentik — приложение user_oidc
Доверенные домены добавлены files.buryans.ru и cloud.buryans.ru
Ссылки в письмах overwrite.cli.url = https://files.buryans.ru

Вход сделан внутри Nextcloud, а не прокси. Это важно: мобильный клиент и синхронизация ходят в API напрямую, прокси их бы сломал.

Paperless остался на docs.buryans.ru — ничего не потерялось.

Home Assistant → home.buryans.ru

Что Как
Домен home.buryans.ru (раньше была заглушка)
Вход прокси oauth2-proxy-ha на 9111
API не закрыт входом — /api, /local, /auth, /static пропускаются
Доверие прокси use_x_forwarded_for + trusted_proxies

Почему API открыт: мобильное приложение Home Assistant ходит в API со своим долгоживущим токеном. Если закрыть его единым входом — приложение перестанет работать. При этом API не открыт без пароля: HA требует свой токен (проверено — отвечает 401).

Попутно исправлено в Home Assistant

В конфиге internal_url и external_url стояли на верхнем уровне — это ошибка, HA ругался Integration 'internal_url' not found. Перенёс внутрь homeassistant:.

Проверено

Проверка Результат
files.buryans.ru 302 → /login, на странице есть вход через Authentik
home.buryans.ru 302 → Authentik
API Home Assistant без токена 401 — защищён своим токеном
API Home Assistant напрямую 401 — так же
docs.buryans.ru 302 → Authentik (Paperless на месте)
Zigbee2MQTT 200
Наблюдение 58 проверок, провалов нет
Все контейнеры nextcloud, homeassistant, zigbee2mqtt, mosquitto, oauth2-proxy-ha — работают

Что осталось

  • Тревога «Высокая нагрузка» — следствие моих сборок образов, не работы служб. Нагрузка 3.6 при пороге 2. Уйдёт сама.
  • Бэкап Home Assistant — стоит проверить, что папка config попадает в копии (сейчас CT 106 копируется целиком по расписанию).
  • Интеграции между сервисами: уведомления HA в Matrix, календарь Nextcloud в HA — следующий шаг.