Как добавить камеру в Home Assistant: ONVIF, RTSP и Frigate

Видеонаблюдение — одна из самых востребованных задач умного дома. Хочется видеть, что происходит у входа, получать снимок на телефон, когда во дворе кто-то появился, и хранить записи без облачных подписок. Как добавить камеру в Home Assistant, зависит от её типа: часть моделей подключается за пару минут через стандартную интеграцию, а для распознавания людей и машин используют отдельный проект Frigate. В статье разберём оба пути: интеграцию IP-камеры через ONVIF и RTSP, затем установку и настройку Frigate, и в конце автоматизации с уведомлениями. Про требования к железу сказано прямо.

1Кратко

• Если камера поддерживает ONVIF, добавляйте её через интеграцию ONVIF: она даёт видео и, как правило, управление поворотом и события. Нет ONVIF — используйте Generic Camera с адресом RTSP.
• Прежде чем добавлять, проверьте RTSP-адрес в видеоплеере: если картинка идёт там, пойдёт и в Home Assistant. Лучше иметь два потока, основной и дополнительный.
• Сам Home Assistant не ведёт полноценный архив записей. Для архива и распознавания людей нужен Frigate или отдельный видеорегистратор.
• Frigate работает на процессоре, но гораздо лучше с аппаратным ускорителем, а для записей нужен SSD или жёсткий диск, не SD-карта.
• Не открывайте камеры и порт RTSP в интернет: для просмотра извне используйте защищённый доступ к Home Assistant или VPN.

2Способы подключения IP-камеры: сравнение

Способ	Что получаете	Управление поворотом и события	Когда выбирать
ONVIF	Видеопоток и снимок, автоматическое обнаружение	Поворот у моделей с PTZ; события движения, если камера их отдаёт	Камера для видеонаблюдения с поддержкой стандарта
Универсальная камера (Generic Camera)	Только видео по адресу потока или снимка	Нет	ONVIF недоступен или не заработал
Фирменная интеграция бренда	Зависит от производителя: иногда события, облачные функции	Зависит от производителя	Если бренд есть в списке интеграций и вы готовы к его особенностям
Frigate	Запись по событиям, распознавание людей и автомобилей, зоны	События объектов и датчики присутствия	Нужна «умная» тревога и архив

Frigate подключается дополнительно, поверх потоков камер, и не заменяет выбор способа добавления для просмотра.

3На что смотреть при выборе камеры

• Локальный доступ. Камера должна отдавать поток RTSP и (лучше) поддерживать ONVIF без обязательной привязки к облаку. Модели, работающие только через приложение производителя, к локальной системе не подключить.
• Два потока. Основной с высоким разрешением для записи и дополнительный с низким для распознавания и плиток на панели.
• Видеокодек. H.264 максимально совместим с браузерами и мобильным приложением. H.265 экономит место, но воспроизведение в интерфейсе зависит от устройства.
• Питание и сеть. Камера, подключённая по Ethernet с питанием PoE, стабильнее Wi-Fi: нет обрывов потока и лишней нагрузки на беспроводную сеть.
• События. Если нужны сообщения о движении средствами самой камеры, убедитесь, что она передаёт их по ONVIF. Если планируете Frigate, достаточно хорошего потока.
• Безопасность. Возможность сменить заводской пароль, создать отдельного пользователя и отключить облако.

4Что понадобится

• IP-камера с поддержкой RTSP. Облачные камеры без локального потока не подключить или можно только через сторонние обходные решения.
• Камера и Home Assistant в одной сети. Для стабильности подключите камеру проводом и закрепите за ней постоянный IP-адрес в настройках роутера.
• Логин и пароль, заданные в самой камере. Заводские учётные данные смените: открытые камеры с паролем по умолчанию — типичная причина взломов.
• Для Frigate — отдельный компьютер или достаточно мощная установка Home Assistant, выделенный накопитель для записей и по желанию ускоритель.

5Как найти адрес RTSP-потока камеры

Прежде чем добавлять камеру, нужно узнать адрес RTSP-потока. Формат зависит от производителя, универсальной строки не существует, поэтому ищите точный адрес в инструкции к вашей модели или в её веб-интерфейсе. Общий вид:

rtsp://логин:пароль@192.168.1.50:554/путь_потока

Порт 554 — стандартный для RTSP, а «путь_потока» у разных производителей разный. Многие камеры выдают два потока: основной (высокое разрешение) и дополнительный (низкое). Запомните оба адреса: дополнительный пригодится для распознавания в Frigate и для плиток на панели. Проверить адрес можно в любом видеоплеере, поддерживающем сетевые потоки: если картинка идёт там, пойдёт и в Home Assistant.

Если в пароле есть специальные символы (@, :, /, #), в адресе их нужно кодировать в процентной форме, иначе строка будет разобрана неверно. Проще всего сменить пароль на состоящий из букв и цифр достаточной длины.

6Интеграция камеры через ONVIF

1. Откройте «Настройки > Устройства и службы» и нажмите «Добавить интеграцию».
2. Найдите «ONVIF» и выберите её. Система может автоматически обнаружить камеры в сети — тогда они появятся в разделе обнаруженных устройств.
3. Введите адрес камеры, порт (на разных моделях встречаются разные значения, часто 80 или 8080, а на некоторых 2020), логин и пароль.
4. После подключения выберите профиль или поток, если интеграция предложит. Сущность камеры появится в списке.

Если ONVIF не подключается, проверьте, включён ли он в настройках самой камеры, не мешает ли ему пароль, и совпадает ли время на камере и на сервере: расхождение иногда ломает авторизацию. На некоторых камерах отдельно создаётся пользователь именно для ONVIF.

7Универсальная камера (Generic Camera) по RTSP

Если ONVIF не получился, используйте универсальную камеру:

1. «Настройки > Устройства и службы > Добавить интеграцию», найдите «Generic Camera» (в русском интерфейсе название может быть переведено как «Универсальная камера»).
2. В поле адреса потока укажите RTSP-адрес из первого шага. Адрес снимка можно оставить пустым: изображение будет формироваться из потока.
3. Выберите транспорт RTSP (обычно по умолчанию подходит TCP, более надёжный в нестабильных сетях) и введите логин и пароль, если они не вошли в адрес.
4. Подтвердите настройки: интеграция покажет предварительный снимок.

В старых инструкциях встречается подключение камеры строкой в configuration.yaml через компонент ffmpeg. Такой способ ещё работает, но Generic Camera проще: её можно настроить и изменить из интерфейса, не перезапуская систему. Для работы потокового видео в интерфейсе должен быть включён компонент stream. В стандартной установке он подключается через default_config, поэтому дополнительных действий обычно не требуется. Если вы убрали default_config из конфигурации, добавьте stream: вручную.

8Как вывести камеру на дашборд

Простейший вариант — карточка «Картинка-сущность» или «Камера» на дашборде:

type: picture-entity
entity: camera.front_door
camera_view: live
show_state: false
show_name: true

Параметр camera_view: live включает живое видео вместо периодически обновляемой картинки. Живой поток нагружает сеть и устройство, поэтому на одном экране не стоит показывать десяток таких карточек сразу.

9Снимок с камеры в уведомлении без Frigate

Для простых сценариев (дверь открылась, пришёл человек) распознавание не нужно: достаточно сделать снимок и отправить его на телефон. Действие camera.snapshot сохраняет кадр в файл. Каталог для файлов нужно разрешить в конфигурации, иначе Home Assistant откажется писать за пределы своей папки:

homeassistant:
  allowlist_external_dirs:
    - /config/www

После изменения конфигурации перезапустите Home Assistant. Файлы из подпапки www доступны по адресу, начинающемуся с /local/. Пример автоматизации:

alias: "Дверь: снимок при открытии"
mode: single
triggers:
  - trigger: state
    entity_id: binary_sensor.front_door
    to: "on"
actions:
  - action: camera.snapshot
    target:
      entity_id: camera.front_door
    data:
      filename: /config/www/front_door.jpg
  - delay: "00:00:02"
  - action: notify.mobile_app_ivan_phone
    data:
      title: "Входная дверь открыта"
      message: "Снимок с камеры у входа"
      data:
        image: "/local/front_door.jpg"

Короткая пауза даёт файлу записаться до отправки. Если вам нужно сохранять каждый снимок, добавьте в имя файла дату с помощью шаблона. Для уведомлений действует тот же принцип, что и в статье про мобильное приложение: путь должен быть доступен телефону. Кроме снимков, у интеграции есть действие записи короткого клипа camera.record, но для регулярного архива оно не предназначено.

10Записи и архив: что умеет Home Assistant, а что нет

Home Assistant показывает камеры и реагирует на события, но не ведёт непрерывный архив с удобной перемоткой. Если нужна запись, у вас четыре пути: карта памяти в самой камере, сетевой видеорегистратор (NVR), Frigate с записью по событиям либо периодические снимки и клипы средствами самой системы. Выбирайте исходя из задач: для просмотра «что было вчера» подойдёт регистратор или Frigate, для картинки в уведомлении хватит снимка. Не записывайте постоянно на SD-карту, на которой установлена система.

11Frigate для Home Assistant: что это и нужно ли оно вам

Frigate — свободный сетевой видеорегистратор, который анализирует поток и определяет объекты: человек, автомобиль, животное, посылка. В Home Assistant это даёт важное преимущество: вместо тревоги «в кадре что-то изменилось» (из-за теней, дождя, насекомых) вы получаете уведомление «у калитки человек». Кроме того, Frigate записывает видео по событиям и хранит их с удобным просмотром.

Но проект не универсальное решение для любой конфигурации, поэтому о железе скажем прямо.

Требования к оборудованию

• Процессор. Frigate может распознавать объекты и на обычном процессоре, но это создаёт заметную нагрузку, особенно при нескольких камерах. Разработчики сами рекомендуют использовать аппаратный ускоритель для детектора. Для одной-двух камер с низким разрешением для распознавания вариант с центральным процессором допустим, как пробный.
• Ускорители (необязательно, но рекомендуется). Поддерживаются USB- и M.2-ускорители Google Coral, видеокарты NVIDIA через TensorRT, встроенная графика Intel через OpenVINO и ряд других вариантов. Какие именно подходят и в каких версиях, всегда уточняйте в актуальной документации Frigate: список расширяется и меняется. Наличие и цены ускорителей на рынке мы не обсуждаем.
• Декодирование видео. Аппаратное декодирование (VAAPI на Intel, NVDEC на NVIDIA) заметно разгружает процессор. Оно включается отдельными параметрами в конфигурации камеры.
• Накопитель. Для записей нужен достаточно вместительный и надёжный диск. Постоянная запись на SD-карту быстро её убьёт, а потому SSD или жёсткий диск подходят значительно лучше.
• Платформа. Установка в виде дополнения (add-on) доступна в Home Assistant OS и Supervised. При установке Home Assistant в Docker (Container) Frigate запускается отдельным контейнером. Одноплатные компьютеры слабой мощности для Frigate подходят ограниченно: сначала оцените нагрузку на тестовой камере.

Если же вам нужны просто просмотр камер и запись, а умное распознавание не нужно, ограничьтесь стандартными интеграциями и Frigate не ставьте.

Установка дополнения Frigate

Frigate не входит в стандартный магазин дополнений: сначала нужно добавить репозиторий, указанный в документации проекта.

1. Откройте «Настройки > Дополнения > Магазин дополнений». Раздел может называться иначе в зависимости от версии.
2. В меню с тремя точками выберите «Репозитории» и добавьте адрес репозитория дополнений Frigate. Актуальный адрес берите из официальной документации проекта.
3. Обновите страницу, найдите в магазине Frigate и установите его. Обычно есть несколько вариантов (стабильный, с поддержкой отдельного ускорителя, бета). Выбирайте стабильный и не переходите на бета-сборку без причины.
4. Перед запуском в настройках дополнения проверьте, что отключён режим защиты, если этого требует инструкция к вашему варианту (для доступа к USB-ускорителю это может потребоваться).

MQTT

Frigate передаёт события в Home Assistant через MQTT, поэтому понадобится брокер. Самый простой путь — дополнение Mosquitto broker с последующим добавлением интеграции MQTT («Настройки > Устройства и службы»). Создайте отдельного пользователя для Frigate и впишите его данные в конфигурацию Frigate.

Базовая конфигурация

Frigate настраивается файлом config.yml. В дополнении он редактируется из интерфейса Frigate или в каталоге конфигурации дополнения; расположение зависит от варианта установки. Простой пример для одной камеры:

mqtt:
  host: core-mosquitto
  user: frigate
  password: ваш_пароль

detectors:
  cpu1:
    type: cpu

cameras:
  front_door:
    ffmpeg:
      inputs:
        - path: rtsp://логин:пароль@192.168.1.50:554/substream_path
          roles:
            - detect
        - path: rtsp://логин:пароль@192.168.1.50:554/mainstream_path
          roles:
            - record
    detect:
      width: 1280
      height: 720
      fps: 5

objects:
  track:
    - person
    - car

Здесь core-mosquitto — внутреннее имя брокера-дополнения; если у вас внешний брокер, укажите его адрес. Дополнительный поток с низким разрешением используется для распознавания (роль detect), основной — для записи (роль record). Значения ширины и высоты должны соответствовать реальному разрешению дополнительного потока. Сниженная частота кадров для распознавания (5 кадров в секунду) заметно снижает нагрузку.

Важное замечание: структура конфигурации Frigate менялась между версиями, особенно блоки записи и хранения. Всегда сверяйтесь с документацией той версии, которую вы поставили. Мы намеренно не приводим параметры хранения: они зависят от версии. При использовании ускорителя в блоке detectors вместо cpu указывается его тип (например, edgetpu для Coral или openvino для Intel) с соответствующим параметром устройства; точные значения берите из документации.

После сохранения перезапустите дополнение, откройте веб-интерфейс Frigate и убедитесь, что камера показывает изображение, а в разделе статистики не видно чрезмерной нагрузки.

12Интеграция Frigate в Home Assistant через HACS

Чтобы камеры и события появились в Home Assistant, нужна пользовательская интеграция Frigate. Она устанавливается через HACS:

1. Убедитесь, что HACS установлен и подключён к вашей учётной записи.
2. В HACS найдите интеграцию Frigate и скачайте её. Версия интеграции должна соответствовать версии Frigate: ориентируйтесь на таблицу совместимости в документации.
3. Перезапустите Home Assistant.
4. Откройте «Настройки > Устройства и службы > Добавить интеграцию», выберите Frigate и укажите адрес сервера Frigate (для дополнения подходит адрес, указанный в его описании, а при отдельном сервере — его IP-адрес и порт).

После этого появятся сущности камер, датчики присутствия объектов (например, «человек во дворе») и переключатели детекции и записи. Конкретный набор зависит от настроенных объектов и зон.

13Уведомление со снимком, когда Frigate увидел человека

Самый востребованный сценарий — получить фото на телефон. Frigate публикует события в MQTT-топик frigate/events, а интеграция предоставляет адрес для получения снимков события.

alias: "Frigate: человек у входа"
mode: single
triggers:
  - trigger: mqtt
    topic: frigate/events
conditions:
  - condition: template
    value_template: >
      {{ trigger.payload_json['type'] == 'new'
         and trigger.payload_json['after']['camera'] == 'front_door'
         and trigger.payload_json['after']['label'] == 'person' }}
actions:
  - action: notify.mobile_app_ivan_phone
    data:
      title: "У входа человек"
      message: "Frigate обнаружил человека на камере у двери"
      data:
        image: "/api/frigate/notifications/{{ trigger.payload_json['after']['id'] }}/thumbnail.jpg"
        tag: "frigate_front_door"

Если вы ещё не настроили уведомления, прочтите соответствующий раздел о мобильном приложении. Путь к миниатюре предоставляет интеграция Frigate, поэтому он работает только при её установке. Схему payload (поля type, after, label) проверяйте в документации вашей версии: формат сообщений может дополняться. Для дополнительной надёжности в проекте есть готовый шаблон автоматизации (blueprint) для уведомлений, который можно импортировать и настроить мышью.

Чтобы не получать десятки сообщений за минуту, добавьте в Frigate зоны (например, только территорию двора без дороги), а в автоматизацию — условие по времени суток или паузу между срабатываниями.

14Идеи автоматизаций с камерами

• Уведомление со снимком или миниатюрой события, когда у входа человек, а вы не дома.
• Включение уличного света, когда на камере человек и на улице темно.
• Показ живого видео с входной камеры на настенной панели при звонке или движении у двери.
• Сообщение, если камера пропала из сети: следите за состоянием её сущности.
• Отключение детекции или уведомлений, пока вы дома, чтобы не получать сообщения о себе.

Условия, ожидания и повторяющиеся действия для этих сценариев описаны в статье про автоматизации.

15Типичные ошибки и решения

Проблема	Причина	Решение
Камера не добавляется через ONVIF	ONVIF отключён в камере, неверный порт или расхождение времени	Включите ONVIF, проверьте порт, синхронизируйте время; при неудаче используйте универсальную камеру
Нет картинки или чёрный экран	Неверный RTSP-адрес или кодек потока не поддерживается браузером	Проверьте адрес в видеоплеере; если возможно, выберите H.264 в настройках камеры
Задержка в несколько секунд в интерфейсе	Особенность потоковой передачи через компонент stream	Для живого просмотра используйте возможности Frigate или специальные карточки, а для мониторинга задержка не критична
Frigate сильно грузит процессор	Распознавание на ЦП, высокое разрешение потока для detect	Используйте дополнительный поток с низким разрешением, уменьшите fps, подключите ускоритель
Frigate не подключается к MQTT	Неверный адрес брокера или данные пользователя	Проверьте хост, имя пользователя и пароль, журнал брокера
Интеграция Frigate выдаёт ошибку	Несовместимые версии Frigate и интеграции	Приведите версии в соответствие с таблицей совместимости в документации
Много ложных срабатываний	Нет зон и масок, низкий порог уверенности	Настройте зоны, маски движения, список отслеживаемых объектов
Камера работает в приложении производителя, но не в Home Assistant	Облачная модель без локального RTSP или доступ закрыт для других устройств	Включите локальный поток и ONVIF, создайте отдельного пользователя в камере, проверьте адрес в плеере
Видео есть, событий движения нет	ONVIF-события на камере не включены или она их не отдаёт	Проверьте настройки обнаружения движения в камере; либо используйте Frigate
Поток рвётся и подтормаживает	Слабый Wi-Fi, слишком высокий битрейт, много потоков одновременно	Подключите камеру по кабелю, снизьте битрейт, используйте дополнительный поток для плиток

16Безопасность

• Не открывайте камеры и порт RTSP в интернет. Для просмотра извне используйте защищённый удалённый доступ к самому Home Assistant или VPN.
• Ограничьте выход камер в интернет на роутере, если им не нужны облачные функции: локальная система этого не требует.
• Используйте уникальные пароли для каждой камеры и отдельного пользователя для Frigate и MQTT.
• Помните о законодательных ограничениях на съёмку: камера не должна снимать чужую территорию и людей без их ведома там, где это недопустимо.

17Итог

Для простого просмотра достаточно добавить камеру через ONVIF или универсальную камеру с адресом RTSP и вывести её на панель. Если нужно распознавание людей и автомобилей, к работе подключается Frigate: он ставится как дополнение, связывается с Home Assistant через MQTT и интеграцию из HACS, а нагрузку лучше переложить на ускоритель. Начните с одной камеры, проверьте нагрузку на оборудование и качество срабатываний, а затем масштабируйте систему и добавляйте уведомления со снимками.