Files
buryan-infra/ops/audit/AUDIT.md
T
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

7.0 KiB
Raw Blame History

Аудит: что сделано за спринт (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