Files
buryan-infra/ops/audit/AUDIT.md
buryan-agent 9d0f51f9b2 Portainer, Linkding, аудит спринта и стратегия автоматизации
Portainer запущен (порт 9443 был занят SSH-туннелем GitHub — оставлен только
9000), API-ключ создан через /api/users/1/tokens, интеграция подключена.
Linkding: DRF-токен не работает при auth-proxy, но API отвечает на заголовок
X-Forwarded-User — добавлен сенсор закладок.

Итог дня: 37 интеграций, 255 сущностей, 104 трекера устройств.

Добавлены два документа: полный аудит спринта (что сделано, что нет и почему,
8 технических открытий) и стратегия автоматизации — 5 принципов, три слоя
архитектуры, 8 фаз, метрики и риски.
2026-10-20 20:18:27 +03:00

113 lines
7.0 KiB
Markdown
Raw Permalink 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.
# Аудит: что сделано за спринт (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