Как добавить и управлять Wi‑Fi камерами в Home Assistant локально

Важно: этот подход хранит и обрабатывает видео локально — без облачных сервисов производителя.

Что это даёт и для кого

Home Assistant — это бесплатная платформа автоматизации для локального управления умным домом. Коротко: это контролёр, который объединяет устройства разных вендоров в один интерфейс и позволяет строить автоматизации, уведомления и локальную запись камер.

Кому полезно:

• Домовладельцам и малому бизнесу, кто хочет приватную систему наблюдения.
• Тем, кто не доверяет облачным сервисам вендоров.
• Любому, кто хочет гибко настраивать события и интеграции (уведомления, трансляции на Echo Show/Fire TV, автоматические сценарии).

Основные сценарии использования

• Локальная запись по движению (экономия места).
• Непрерывная запись 24/7 (требует больше хранилища).
• Оповещения со снимком на смартфон.
• Трансляция живого видео на смарт‑дисплеи и медиаплееры.

H2: Подготовка — что нужно проверить перед началом

• Камера должна поддерживать RTSP или HTTP MJPEG поток (проверьте в документации).
• Устройство с Home Assistant (Raspberry Pi, NUC, сервер) с достаточным хранилищем.
• Доступ к роутеру или сканер сети (Fing) для определения IP‑адресов.
• VLC или другой медиаплеер для проверки потоков.

Прим.: по умолчанию RTSP использует порт 554 — не забудьте проверить настройки брандмауэра роутера.

H2: Шаг 1 — найти RTSP / HTTP поток камеры

Коротко: каждая IP/Wi‑Fi камера обычно имеет URL потока. Для H.264 обычно RTSP; для MJPEG — HTTP.

Где искать URL:

• В приложении производителя: часто в разделе «Сведения о камере», «Подключение» или «RTSP».
• В руководстве пользователя или на сайте производителя.
• Через поиск по модели в интернете (в одном из сообществ умного дома).

Таблица распространённых URL (замените на адрес вашей камеры):

Примечание: у некоторых камер RTSP выключён по умолчанию и требует включения в приложении, обновления прошивки или даже специальной прошивки/файла на SD‑карте.

Как узнать IP‑адрес камеры:

• Посмотрите таблицу DHCP в интерфейсе вашего роутера.
• Используйте приложение Fing (Android/iOS) — оно показывает устройства в вашей сети.

Проверка потока в VLC:

1. Откройте VLC.
2. Файл → Открыть сетевой поток (Media > Open Network Stream).
3. Вставьте RTSP/HTTP URL и нажмите “Play”.

Если поток воспроизводится — вы готовы к интеграции в Home Assistant.

H2: Шаг 2 — установить Frigate NVR в Home Assistant

Коротко: Frigate — локальный NVR с поддержкой детекции объектов (AI) и записью событий. Он обрабатывает кадры локально и может делать снимки/видео при срабатывании.

Порядок установки (Home Assistant OS / Supervised):

1. В HA откройте «Настройки» → «Дополнения» (Settings > Add‑Ons).
2. Нажмите «Магазин дополнений» (Add‑On Store).
3. В правом верхнем меню выберите «Репозитории».
4. Вставьте https://github.com/blakeblackshear/frigate-hass-addons и нажмите «Добавить».
5. В списке дополнений выберите Frigate NVR и установите (Install).

После установки:

• Включите «Запуск при загрузке» (Start on boot) и «Показать в боковой панели» (Show in the sidebar).
• Откройте встроенный Редактор файлов (File Editor) и создайте файл frigate.yaml.

Пример базовой конфигурации Frigate (обновите значения):

mqtt:
  host: 192.168.1.100 # адрес вашего MQTT брокера
  user: 
  password: 

cameras:
  TerraceCam:
    # имя камеры — используйте буквы, цифры и подчеркивания
    ffmpeg:
      inputs:
        - path: rtsp://YourRTSPStreamURL  # <-- замените на ваш RTSP URL
          roles:
            - detect
            - rtmp
    rtmp:
      enabled: False # Отключите если стрим не в H.264
    detect:
      width: 1280   # обновите под разрешение вашей камеры
      height: 720
      fps: 24
    record:
      enabled: True
    motion:
      mask:
        - 0,461,3,0,1919,0,1919,843,1699,492,1344,458,1346,336,973,317,869,375,866,432

Сохраните файл и перезапустите дополнение Frigate.

Откройте Frigate через боковую панель — вы увидите live‑вид и события:

Когда Frigate обнаруживает движение или объект, он создает событие с видеоклипом и/или снимком (с отметкой времени).

H2: Шаг 3 — отредактировать маску движения

Зачем: маска исключает области, где движение не должно учитываться (например, улица с деревьями, дорога, где постоянно проезжают машины).

Как создать маску:

1. Откройте Frigate Web UI и выберите нужную камеру.
2. Нажмите “Debug” → “Show Options”.
3. Выберите “Mask and Zone Creator”.
4. Перемещайте точки, чтобы вырезать области, затем скопируйте значения Motion Masks.

5. Вставьте скопированные значения в параметр motion: mask: в frigate.yaml и сохраните.

Перезапустите Frigate, чтобы изменения вступили в силу.

Примечание: если вы хотите непрерывную запись — удалите секцию motion или выключите обнаружение и включите запись 24/7.

H2: Хранение и аппаратные требования

Кратко:

• Запись событий требует дискового пространства — для 24/7 записи рекомендован NAS или локальный SSD.
• Raspberry Pi с microSD хорошо подходит для небольших проектов, но SD‑карта быстро изнашивается при постоянной записи — используйте SSD через USB3 или сетевое хранилище.

Рекомендации:

• Для одной‑двух камер: Raspberry Pi 4 + SSD обычно достаточно.
• Для нескольких камер с анализом AI или 24/7 записи: рассмотрите NUC/мини‑ПК или сервер с SSD/NAS.

Важно: резервное копирование и управление удалением старых записей (retention policy) помогут не переполнять диск.

H2: Альтернативы и расширения (варианты подхода)

1. MotionEye NVR (Add‑on) — проще для базовой записи и оповещений, но меньше возможностей по AI‑детекции, чем Frigate.
2. Вендорские облака — простая настройка, но видео передаётся внешним сервисам (меньше приватности).
3. Коммерческие NVR/PoE решения — удобны для крупной установки, но дороже и менее гибки для интеграций с Home Assistant.
4. Использовать локальный RTSP‑рекордер на Raspberry/сервере и подключать фрагменты в HA без Frigate (менее функционально для детекции).

Когда Frigate не подходит:

• Если камера не умеет RTSP или URL скрыт/защитён.
• Если у вас очень ограниченные ресурсы и нужна только простая запись без AI — MotionEye может быть легче.

H2: Безопасность и приватность

Рекомендации по безопасности:

• Смените заводские пароли камеры и Admin/SSH.
• Поместите камеры в отдельную VLAN или гостевую сеть для изоляции.
• Закройте доступ к RTSP извне (порт‑форвардинг только при необходимости и через VPN).
• Обновляйте прошивку камер и Home Assistant.

Приватность:

• Frigate и HA обрабатывают данные локально — файлы не уходят в облако по умолчанию.
• Если вы включаете облачные интеграции (например, зеркалирование в облако), проверьте политику конфиденциальности провайдера.

H2: Критерии приёмки / тесты

Чтобы считать интеграцию завершённой, проверьте:

• RTSP поток воспроизводится в VLC.
• Камера отображается в Frigate Web UI и в Home Assistant.
• При движении Frigate создаёт событие с видеоклипом и/или снимком.
• Записи сохраняются в указанном каталоге и удаляются по политике хранения.
• Оповещения на смартфон приходят (если настроены) с прикреплённым снимком или ссылкой.

H2: Практические чеклисты (роль‑ориентированные)

Владелец дома:

• Проверил RTSP в VLC.
• Поменял пароли камеры.
• Установил Frigate и создал frigate.yaml.
• Настроил хранение и резервирование.

Администратор сети:

• Убедился в доступности камеры по IP.
• Настроил VLAN/файрвол.
• Развернул MQTT/брокер (при необходимости).

Оператор/контролёр безопасности:

• Настроил маски движения и зоны.
• Настроил уведомления и расписания.

H2: Мини‑методология внедрения (шаги на одну страницу)

1. Инвентаризация камер и проверка поддержки RTSP.
2. Поиск IP‑адресов и тест потоков в VLC.
3. Установка Frigate и базовая конфигурация/файл frigate.yaml.
4. Настройка масок и зон детекции.
5. Тестирование событий и конфигурации хранения.
6. Обеспечение безопасности сети и резервное копирование.

H2: Частые проблемы и решения (когда что не работает)

Проблема: поток не открывается в VLC.

• Проверьте IP/порт/учётные данные.
• Убедитесь, что порт 554 не блокируется роутером.
• Попробуйте альтернативный URL из таблицы для вашей модели.

Проблема: Frigate не показывает детекции.

• Проверьте, указан ли ffmpeg input и роли detect у камеры.
• Проверьте CPU/GPU: при недостатке ресурсов детекция может быть медленной.
• Убедитесь, что в detect указаны корректные width/height/fps.

Проблема: быстро заканчивается место на Raspberry Pi.

• Переключитесь на SSD или NAS.
• Настройте retention/удаление старых записей.

H2: Мермайд‑диаграмма принятия решения (когда выбрать Frigate vs MotionEye)

flowchart TD
  A[Нужна AI‑детекция?] -->|Да| B[Frigate]
  A -->|Нет — нужна простая запись| C[MotionEye]
  B --> D{Есть ресурсы 'CPU/SSD'?}
  D -->|Да| E[Включить детекцию и запись]
  D -->|Нет| F[Снизить fps/resolution или перейти на сервер]
  C --> G[Подходит для базовой записи и уведомлений]

H2: Краткое резюме

• Вы можете добавить большинство Wi‑Fi/IP камер в Home Assistant через RTSP.
• Frigate обеспечивает локальную AI‑детекцию и запись событий, сохраняя видео у вас.
• Настройка масок помогает снизить ложные срабатывания.
• Для долговременной записи используйте SSD/NAS и продумайте политику хранения.

Важно: всегда меняйте заводские пароли и минимизируйте внешний доступ к RTSP.

H2: Быстрая галерея крайних случаев и советы

• Камеры без RTSP: чаще всего используются фирменные облачные протоколы — альтернативы: облако вендора или замена камеры на модель с RTSP.
• Ограниченный CPU: уменьшите FPS/разрешение или используйте выделенный сервер для обработки.
• Много камер (10+): переходите на NAS/сервер с достаточным CPU и хранилищем.

H2: 1‑строчный глоссарий

• RTSP: протокол потоковой передачи видео.
• MJPEG: видео как последовательность JPEG‑кадров через HTTP.
• Frigate: локальный NVR с AI‑детекцией для Home Assistant.
• MQTT: лёгкий протокол обмена сообщениями, часто используется для интеграций.

Спасибо за чтение. Если нужно, могу помочь собрать frigate.yaml под конкретную модель камеры или оптимизировать систему под Raspberry Pi/NUC.