RTSP и ONVIF для IP-камер: как найти URL и подключить камеру к Frigate
IP-камеры · RTSP · ONVIF · Frigate

Как найти RTSP-поток и ONVIF у IP-камеры для Frigate, Home Assistant и NVR

Практический алгоритм для Hikvision, HiWatch, Dahua, Reolink, Axis и других камер: сначала пробуем автоматическое обнаружение, затем проверяем ONVIF и только после этого подбираем RTSP URL вручную.

Важно для новых версий Frigate

В актуальной ветке Frigate появился мастер Add Camera. Он умеет опрашивать камеру по ONVIF, получать профили и RTSP-адреса, тестировать потоки и формировать конфигурацию. Поэтому начинать с ручного написания большого YAML уже не всегда нужно.

RTSP и ONVIF: это не одно и то же

RTSP

Получение видеопотока

RTSP обычно используется для передачи основного и дополнительного видеопотоков камеры в NVR, Frigate, go2rtc, VLC или другую систему.

ONVIF

Обнаружение и управление

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

Наличие ONVIF не означает, что видеозапись идёт «через ONVIF». На практике ONVIF часто помогает системе узнать RTSP URI нужного профиля, после чего видео забирается непосредственно по RTSP.

Самый правильный порядок поиска потока

  1. Узнайте точную модель камеры. Одного бренда недостаточно: пути, кодеки и возможности отличаются даже внутри одной серии.
  2. Проверьте настройки камеры. RTSP или ONVIF на некоторых устройствах нужно включить отдельно. Иногда для ONVIF создаётся отдельный пользователь.
  3. Попробуйте ONVIF discovery. Современный Frigate может сам получить профили и предложить найденные RTSP-потоки.
  4. Если обнаружение не сработало, ищите официальный RTSP URL. В первую очередь в документации производителя для конкретной модели.
  5. Проверьте поток отдельно. До настройки аналитики убедитесь, что видео стабильно открывается.
  6. Только после этого назначайте роли. Основной поток обычно используют для записи, дополнительный — для детекции.

Типовые RTSP URL популярных камер

БрендТиповой основной потокДополнительный поток
Hikvision / HiWatch/Streaming/Channels/101/Streaming/Channels/102
Dahua/cam/realmonitor?channel=1&subtype=0/cam/realmonitor?channel=1&subtype=1
Reolink/h264Preview_01_main/h264Preview_01_sub
Это шаблоны, а не универсальная гарантия. Конкретная модель, прошивка, номер канала и выбранный кодек могут менять адрес или поведение потока. Всегда сверяйте документацию камеры.

Из чего состоит RTSP-адрес

rtsp://USER:PASSWORD@CAMERA_IP:554/STREAM_PATH
  • USER — пользователь камеры;
  • PASSWORD — пароль;
  • CAMERA_IP — локальный IP-адрес;
  • 554 — типовой порт RTSP, если производитель не изменил его;
  • STREAM_PATH — путь конкретного основного или дополнительного потока.

Не публикуйте рабочий URL с реальным паролем в форумах, скриншотах, GitHub и публичных конфигурациях.

Как подключать камеру в новом Frigate

В актуальной документации Frigate рекомендует мастер Add Camera. В режиме Probe Camera он обращается к устройству по ONVIF, получает производителя, модель, прошивку, профили и найденные RTSP URL. Также мастер может показать поддержку PTZ, presets и autotracking.

Если ONVIF не отдаёт нужный поток, можно выбрать ручной режим. В Frigate предусмотрены шаблоны для ряда популярных семейств, включая Dahua/Amcrest/EmpireTech, Hikvision/Uniview/Annke, Ubiquiti, Reolink, Axis, TP-Link и Foscam.

Зачем два потока

MAINВысокое разрешение

Запись архива

SUBМеньшее разрешение

Детекция объектов

Обрабатывать для детекции постоянный 4K-поток часто бессмысленно. Более лёгкий substream снижает нагрузку на декодирование, а основной поток можно сохранять с максимальным полезным качеством.

Когда нужен go2rtc

go2rtc полезен для restream, live view и уменьшения количества прямых подключений к камере. Вместо того чтобы несколько компонентов независимо открывали один и тот же RTSP-поток камеры, его можно один раз получить через go2rtc и использовать локальный restream.

Это особенно полезно для камер, у которых ограничено число одновременных RTSP-сессий, а также при настройке WebRTC и двустороннего звука.

ONVIF найден, но Frigate не показывает видео

Неверные учётные данные

Проверьте, не требуется ли отдельная ONVIF-учётная запись.

Неверный ONVIF-порт

Он не обязан совпадать с RTSP 554. У разных камер используются разные HTTP/service ports.

Неподдерживаемый кодек

Проверьте параметры main/sub stream и совместимость клиента с H.264/H.265 и аудиокодеком.

Проблема транспорта

Некоторые камеры ведут себя по-разному при RTSP over TCP и UDP.

Слишком много подключений

Попробуйте restream через go2rtc.

ONVIF реализован частично

Надпись ONVIF в характеристиках ещё не гарантирует корректную реализацию всех функций.

Как проверить ONVIF до покупки камеры

Для серьёзной системы видеонаблюдения лучше проверять не только рекламную надпись «ONVIF», а наличие модели в базе conformant products ONVIF и заявленные профили/функции. Особенно это важно для PTZ, двустороннего аудио и более сложных сценариев.

Для Frigate двусторонний звук требует дополнительных условий. В частности, используется go2rtc/WebRTC, а фактическая совместимость audio backchannel зависит от реализации камеры.

Безопасность: RTSP не нужно выставлять в интернет

Для локальной системы видеонаблюдения камерам обычно не требуется входящий доступ из интернета. RTSP, ONVIF и веб-интерфейс лучше оставлять внутри локальной сети или отдельного VLAN, а удалённый доступ организовывать через VPN либо защищённый сервис верхнего уровня.

  • не используйте заводские и одинаковые пароли;
  • не пробрасывайте наружу 554 только ради просмотра камеры;
  • ограничьте доступ камер к другим сегментам сети;
  • обновляйте прошивки;
  • отключайте ненужные облачные/P2P-функции, если система построена полностью локально;
  • для NVR/Frigate создавайте отдельную учётную запись с необходимыми правами, если камера это позволяет.

А что с открытыми базами RTSP-конфигураций

Существуют общественные базы совместимости камер, где пользователи собирают RTSP-пути, сведения об ONVIF и примеры конфигураций Frigate. Они полезны как подсказка для редких или плохо документированных моделей.

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

Частые вопросы

Какой порт у RTSP?

Типовое значение — TCP/UDP 554, но производитель или пользователь может назначить другой порт.

Какой порт у ONVIF?

Единого универсального порта для всех камер нет. Frigate отмечает, что часто встречаются 80 и 8080, но точное значение нужно смотреть для конкретной модели и прошивки.

Что лучше для Frigate: H.264 или H.265?

Зависит от оборудования и сценария. H.265 экономит битрейт, но H.264 обычно проще с точки зрения совместимости клиентов и live view. Для конкретной системы нужно учитывать аппаратное декодирование.

Нужен ли ONVIF, если RTSP уже работает?

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

Можно ли использовать основной поток и для записи, и для детекции?

Можно, но это может создавать лишнюю вычислительную нагрузку. Обычно выгоднее использовать main stream для записи, а подходящий substream для детекции.