Files
buryan-infra/docs/HOME-SERVICES-INTEGRATION.md
T
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

69 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Интеграция домашних сервисов: 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 — следующий шаг.