Portainer запущен (порт 9443 был занят SSH-туннелем GitHub — оставлен только 9000), API-ключ создан через /api/users/1/tokens, интеграция подключена. Linkding: DRF-токен не работает при auth-proxy, но API отвечает на заголовок X-Forwarded-User — добавлен сенсор закладок. Итог дня: 37 интеграций, 255 сущностей, 104 трекера устройств. Добавлены два документа: полный аудит спринта (что сделано, что нет и почему, 8 технических открытий) и стратегия автоматизации — 5 принципов, три слоя архитектуры, 8 фаз, метрики и риски.
113 lines
7.0 KiB
Markdown
113 lines
7.0 KiB
Markdown
# Аудит: что сделано за спринт (20.10.2026)
|
||
|
||
## Итоговые цифры
|
||
|
||
| Показатель | Было утром | Стало |
|
||
|---|---|---|
|
||
| Интеграций в HA | 4 | **37** |
|
||
| Сущностей | 11 | **255** |
|
||
| Устройств в трекере | 0 | **104** |
|
||
| Медиаплееров | 0 | **7** |
|
||
| Сенсоров | 6 | **87** |
|
||
| Переключателей | 0 | **24** |
|
||
|
||
## Восстановление после сбоя
|
||
|
||
Хост перезагрузился ночью, половина сервисов не поднялась.
|
||
|
||
| Проблема | Причина | Решение |
|
||
|---|---|---|
|
||
| Docker не стартовал | битый CIDR `192.168.1.115.1/24` | корректный `10.115.0.1/24` |
|
||
| Radarr/Sonarr/Prowlarr молчали | залипший docker-proxy | `docker restart` |
|
||
| Authentik лежал (4 контейнера) | политика `no` | `restart: unless-stopped` + compose |
|
||
| 8 oauth2-proxy падали | не видели Authentik | поднялись сами |
|
||
| Navidrome-дубль на хосте | конфликт порта | остановлен, автозапуск отключён |
|
||
| Tailscale разлогинен | headscale отдавал 500 | починен nginx (Upgrade), узел перерегистрирован |
|
||
|
||
**Защита на будущее:** `docker-daemon-set` применяет конфиг только с откатом
|
||
(`dockerd --validate` не ловит битый CIDR — проверено), ежедневная проверка
|
||
`docker-config-check` в 06:15.
|
||
|
||
## Интеграции: что подключено
|
||
|
||
### Медиа и контент
|
||
| Сервис | Как |
|
||
|---|---|
|
||
| **Radarr** | API-ключ, диск/очередь/здоровье |
|
||
| **Sonarr** | API-ключ, ближайшие эпизоды |
|
||
| **Lidarr** | API-ключ из `config.xml` |
|
||
| **Jellyfin** | новый ключ (старый отдавал 401) |
|
||
| **qBittorrent** | admin + пароль из `/root/.qbit-password` |
|
||
| **Seerr** | `HaSeerr` (HACS-репо, вручную) |
|
||
|
||
### Дом и сеть
|
||
| Сервис | Как |
|
||
|---|---|
|
||
| **Keenetic** | `ha_keenetic` — CPU, WAN, порты, Wi-Fi, WireGuard |
|
||
| **Устройства сети** | своя интеграция `hub_devices` — **104 трекера** с типом и брендом |
|
||
| **AdGuard Home** | пароль сброшен через bcrypt в конфиге |
|
||
| **MQTT** | mosquitto в CT 107, 3 пользователя |
|
||
| **Syncthing** | ключ из `config.xml` |
|
||
| **Portainer** | пересоздан, API-ключ `ptr_…` |
|
||
|
||
### Инфраструктура и сервисы
|
||
| Сервис | Как |
|
||
|---|---|
|
||
| **Proxmox** | токен `monitoring@pve`, роль PVEAuditor, REST-сенсоры CPU/RAM/uptime/диск |
|
||
| **Authentik** | REST-сенсор, 11 пользователей |
|
||
| **Prometheus** | REST-сенсор, 34 цели |
|
||
| **Nextcloud** | пароль сброшен через `occ`, сенсоры OCS v2 |
|
||
| **Paperless** | REST-сенсоры с токеном |
|
||
| **Gitea** | REST-сенсоры (интеграция 2022 г. без config flow) |
|
||
| **Immich** | ключ создан через API после сброса пароля в БД |
|
||
|
||
### Голос и телевизоры
|
||
| Что | Как |
|
||
|---|---|
|
||
| **Алиса (3 колонки)** | YandexStation через HACS, QR-авторизация |
|
||
| **Chromecast-ТВ (2)** | Google Cast, каст и громкость |
|
||
| **Hisense VIDAA** | своё управление `tv_hisense.py` — пульт, громкость, приложения |
|
||
| **Frigate** | интеграция встала (порт 5000), камер пока нет |
|
||
|
||
## Что не получилось и почему
|
||
|
||
| Что | Причина | Обход |
|
||
|---|---|---|
|
||
| **nmap_tracker** | в HA 2026 легаси-платформы удалены, config flow не создаёт сущности | своя `hub_devices` |
|
||
| **proxmoxve (HACS)** | 0 сущностей даже с правами | REST-сенсоры |
|
||
| **Paperless-интеграция** | версия 3.3.2 не понимается | REST-сенсоры |
|
||
| **Nextcloud-интеграция** | NC 33 не принимает ни пароль, ни app-пароль | OCS-сенсоры |
|
||
| **Seerr (ядровая)** | `overseerr` не понимает 3.5.0 | HaSeerr |
|
||
| **Gitea-интеграция** | нет config flow | REST-сенсоры |
|
||
| **Hisense через HA** | PIN-сопряжение, ТВ отдаёт пустой auth-ответ | прямое управление |
|
||
| **hisense_tv (MQTT)** | поток зависает в `progress` | — |
|
||
| **Uptime Kuma** | нет REST, только socket.io | мониторы уже работают (18) |
|
||
| **Linkding токен** | API не принимает DRF-токен при auth-proxy | заголовок `X-Forwarded-User` |
|
||
| **Portainer** | порт 9443 занят туннелем GitHub | опубликован только 9000 |
|
||
|
||
## Ключевые технические открытия
|
||
|
||
1. **`dockerd --validate` не ловит битый CIDR** — говорит «OK» на невалидный
|
||
конфиг, демон потом падает. Защита только откатом.
|
||
2. **HACS и aiohttp игнорируют `HTTP_PROXY`** (`trust_env=False`) — нужен
|
||
прозрачный маршрут (SSH-туннели + DNAT на фиксированные IP).
|
||
3. **`ScannerEntity` в HA выключен по умолчанию** в реестре — надо явно
|
||
включать `entity_registry_enabled_default`.
|
||
4. **Дубликат контейнера HA** перехватывает порт и «прячет» новые интеграции.
|
||
5. **Immich не принимает ключ, вставленный в БД** — только через API после
|
||
логина.
|
||
6. **Jellyfin требует `Authorization: MediaBrowser Token="..."`**, а не
|
||
`X-Emby-Token` и не `?api_key=`.
|
||
7. **Kuma понимает только `$2a$`** в bcrypt-хеше ключа, Python даёт `$2b$`.
|
||
8. **`rest:` нельзя объявлять дважды** — только внутрь существующего блока.
|
||
|
||
## Что готово как фундамент
|
||
|
||
- **Единый вход**: Authentik + 8 oauth2-proxy на всех сервисах
|
||
- **Единая шина**: MQTT (mosquitto) — можно вешать любые устройства
|
||
- **Единый инвентарь**: 104 устройства с типами и брендами
|
||
- **Единый граф контента**: 1791 карточка, 1414 связей в `hub_core`
|
||
- **Единый канал**: Matrix-боты (медиа, инфра, фото, книги, поиск)
|
||
- **Единый мозг**: `hub-core` на :9120 — API, граф, рекомендации, события
|
||
- **Мониторинг**: 18 мониторов Kuma, Prometheus (34 цели), Grafana
|