Добавление камер

Вручную, через ONVIF, поиском в сети, из шаблона и массовым импортом.

Камера в SirinVideo CCTV — это запись в Plane, а не строка в конфигурации сервера. Plane хранит источник, профили потоков, политику архива и назначает камеру на медиаузел (ноду); нода забирает поток и раздаёт его зрителям. Поэтому камеру всегда заводят в консоли администратора или через API, и никогда — правкой node.conf вручную.

Все описанные ниже способы открывают одну и ту же форму — «Новая камера» на странице /admin/cameras. Форма состоит из трёх шагов-вкладок: «Источник и идентификация», «Профили потоков», «Запись и размещение». Внизу закреплены кнопки «Отмена», «Назад», «Далее» и на последнем шаге — «Сохранить». Если при сохранении есть ошибка, форма сама переключается на тот шаг, где она возникла.

Что подготовить заранее#

1. Нода в состоянии «Активен» и лицензирована. Без лицензии нода видна в консоли, но не отдаёт ни одного кадра — см. Установка Node и Лицензирование.

2. Хранилище инициализировано, если камера будет писать архив. Новый диск сначала имеет статус «Требуется инициализация» и не принимает DVR-камеры — см. Хранилища DVR.

3. Камера доступна с ноды по сети. Проверьте прямо с сервера ноды:

   Копировать

   nc -vz <IP-камеры> 554     # RTSP
   nc -vz <IP-камеры> 80      # ONVIF (порт зависит от модели)
   

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

5. Теги созданы, если камера сразу должна попасть в чью-то область доступа: права оператора выдаются на теги — см. Пользователи и права доступа.

Тип источника: выбирается один раз#

Первый блок формы — «Как подключается эта камера». Выбор определяет, какие поля вы увидите дальше:

Способ 1. Вручную по RTSP-ссылке#

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

1. Откройте /admin/cameras и нажмите «Новая камера».
2. В блоке «Как подключается эта камера» выберите «Прямой RTSP». Появится карточка «Подключение задаётся RTSP-ссылкой» с пояснением: «Логин и пароль камеры указываются в самой RTSP-ссылке: rtsp://логин:пароль@адрес/путь. На следующем этапе укажите основной RTSP URL и при необходимости дополнительный поток; разрешение, кодек и частота кадров определяются вживую из потока. Поля ONVIF, событий и PTZ намеренно не показываются.»
3. Заполните секцию «Идентификация»: «Название камеры» (обязательное), при мультиорганизационной установке — «Организация», флажок «Включена» (снятый флажок: «Отключённая камера не транслируется ни одним узлом.»).
4. Если поток требует авторизации, укажите логин и пароль прямо в RTSP-ссылке — rtsp://логин:пароль@адрес:554/путь. Отдельных полей учётных данных у типа «Прямой RTSP» нет: нода подключается по ссылке как есть, ничего в неё не подставляя.
5. Нажмите «Далее». На шаге «Профили потоков» в карточке основного профиля заполните «RTSP URL» — схема только rtsp:// или rtsps://, иначе форма покажет ошибку. Разрешение, кодек и частота кадров не запрашиваются: они определяются вживую из потока.
6. При необходимости нажмите «Добавить доп. профиль» и укажите ссылку на второй, низкобитрейтный поток. Дополнительный профиль принимается «по запросу»: нода подключается к нему только когда поток кто-то смотрит.
7. Нажмите «Далее», на шаге «Запись и размещение» выберите теги, политику DVR и узел (см. Разбор формы), затем — «Сохранить».

Способ 2. Через ONVIF (адрес + учётные данные)#

Основной способ для IP-камер: система сама читает у камеры список медиапрофилей и их RTSP-адреса, поэтому ссылки вручную вводить не нужно.

1. /admin/cameras → «Новая камера» → тип источника «ONVIF-камера».
2. Заполните «Название камеры» и, если нужно, «Организация».
3. В секции «Подключение» укажите «Хост / IP» — адрес камеры — и «Порт ONVIF» (обычно 80; допустимо 1…65535, иначе «Укажите порт от 1 до 65535.»).
4. Отметьте физические возможности камеры в карточке «Физические возможности PTZ» — флажки «Поворот / наклон» и «Зум». Подсказка формы не случайна: «Включайте только то управление, которое камера действительно поддерживает. Сам по себе ONVIF не означает наличие PTZ.»
5. Если нужны события от самой камеры (движение, саботаж, аналитика), включите «Получать события ONVIF». При желании задайте «Тайм-аут простоя интервального события (секунды)» — пустое значение означает 10 секунд, минимум 5.
6. В секции «Учётные данные» введите «Имя пользователя» и «Пароль» ONVIF.
7. Нажмите «Далее» и на шаге «Профили потоков» в блоке «Сопоставление профилей ONVIF» нажмите «Загрузить профили ONVIF». Это и есть живая проверка: система обращается к камере по указанному адресу с указанными учётными данными, забирает список профилей и заодно заполняет «Производитель», «Модель», «Серийный номер», «Прошивка».
8. Сопоставьте профили: в карточке основного профиля выберите «Токен профиля ONVIF» (пустое значение = «авто (по разрешению)»), при необходимости добавьте дополнительный профиль и выберите токен для него.
9. Пройдите шаг «Запись и размещение» и нажмите «Сохранить». Сразу после создания Plane автоматически определяет URL потоков у камеры, и в поле «Определённый URL потока» появляется рабочая ссылка.

Позже, если камере сменили профили или прошивку, повторно откройте форму и нажмите «Определить URL потоков» — кнопка доступна только для уже сохранённой камеры. Подсказка описывает правило: «Читает GetProfiles + GetStreamUri с камеры; наибольшее разрешение → main, наименьшее → sub (можно изменить ниже).»

Способ 3. Поиск камер в сети (ONVIF-обнаружение)#

Если адреса камер неизвестны, их можно найти разовым сканированием сети.

1. /admin/cameras → «Новая камера» → тип источника «ONVIF-камера».
2. Нажмите «Найти». Подсказка описывает механику: «Разовое сканирование сети по ONVIF WS-Discovery.» Сканирование выполняет Plane в своей сети — камеры из других подсетей, куда не проходит multicast, так не находятся, их заводят способом 2.
3. В списке «Найденные устройства» выберите нужное и нажмите «Выбрать». Уже заведённые устройства помечены как «уже добавлена», и кнопка у них недоступна.
4. Форма подставит адрес, порт и, если поля ещё пустые, имя и модель. Дальше — как в способе 2: учётные данные → «Загрузить профили ONVIF» → сопоставление → «Сохранить».

Если сеть просканирована, но ничего не найдено, консоль пишет: «ONVIF-устройства в сети не найдены.» Типичные причины — камеры в другом VLAN, отключённый на камере ONVIF или заблокированный multicast. Заведите такие камеры по адресу вручную.

Способ 4. Из шаблона камеры#

Шаблон — это заготовка настроек (профили, DVR, размещение, теги, заметки, параметры отображения), которая заполняет форму одним нажатием. Шаблоны создают и правят в разделе Настройки → «Шаблоны камер» (см. Настройки Plane и токены).

1. /admin/cameras → «Новая камера».
2. В блоке «Шаблон конфигурации» выберите заготовку в списке «Многоразовый шаблон» и нажмите «Применить к форме».
3. Заполните то, что шаблон принципиально не содержит: название, адрес, учётные данные, ссылки на потоки.
4. Пройдите шаги формы и сохраните камеру.

Способ 5. Камера за NAT — через агент#

Кратко: на объекте запускается LAN-агент, он сам выходит наружу к релею, Plane выдаёт камере стабильные публичные адреса ONVIF и RTSP. В форме камеры это выглядит так:

1. Тип источника — «Камера через агент».
2. В секции «Подключение» выберите «LAN-агент» и затем «Обнаруженная камера» из инвентаря, который агент передал в Plane. Устройство помечено либо «маршруты готовы», либо «маршруты создадутся при проверке».
3. Введите «Имя пользователя» и «Пароль» камеры и нажмите «Проверить и получить профили». Plane выделит стабильные маршруты и обратится к камере через туннель. Успех: «Камера проверена: получено рабочих профилей — {count}.»
4. Пока проверка не прошла, к следующему шагу перейти нельзя: «Перед продолжением проверьте учётные данные и получите рабочий основной RTSP-профиль.»

Полный сценарий развёртывания релея и агента — Камеры за NAT: туннели.

Способ 6. Массовое добавление через API#

Для объектов с десятками и сотнями камер список удобнее загрузить скриптом: тело запроса то же, что заполняет форма.

export BASE="https://cctv.example.com"
export TOKEN=$(curl -sS "$BASE/api/v1/auth/login" \
  -H 'Content-Type: application/json' \
  -d '{"login":"admin","password":"<пароль>"}' \
  | python3 -c 'import sys, json; print(json.load(sys.stdin)["token"])')

curl -sS -X POST "$BASE/api/v1/cameras" \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{
        "name": "Проходная — въезд",
        "use_onvif": true,
        "host": "192.0.2.10",
        "onvif_port": 80,
        "username": "onvif",
        "password": "<пароль-камеры>",
        "node_auto": true,
        "profiles": [{"kind": "main"}]
      }'

Пакетную загрузку из CSV, повторный запуск без дублей, массовое назначение тегов и разбор ошибок смотрите в API: камеры и Готовые сценарии.

Разбор формы: все три шага#

Форма создания и форма редактирования — одна и та же: у существующей камеры она открывается заполненной, а тип источника на первом шаге зафиксирован.

Шаг 1 — «Источник и идентификация»#

Шаг 2 — «Профили потоков»#

Профиль — это один поток камеры. Основной (main) принимается постоянно и используется для архива; дополнительный (sub) принимается «по запросу» — нода подключается к нему только когда его смотрят.

Секция «Отображение эфира и мозаики» задаёт, что видит зритель:

• «Транспорт по умолчанию» — MSE-WS или HLS.
• «Поток для эфира и мозаик» — «основной» (помечен «Рекомендуется»: постоянный приём, мгновенный предпросмотр) или «дополнительный» (запускается только при обращении).
• «Разрешить переключение main/sub» — можно ли зрителю переключать качество. Подсказка: «Применяется к эфиру и мозаике. DVR всегда использует main.»

Шаг 3 — «Запись и размещение»#

• «Теги» — чипы тегов организации, клик переключает. Теги задают и группировку, и права операторов.
• «DVR (запись)» — «Выкл», «По сроку хранения» (формат периода: s, m, h, d, w — например 12h или 7d) или «По объёму хранилища» (K, M, G, T — например 500M или 10G), плюс «Хранилище записи». Подробно — Архив (DVR).
• «Размещение на узле» — кнопка «Авто (рекомендуется)» подбирает узел по загрузке; суперадмин может выбрать «Узел» вручную, значение по умолчанию — «Авто (разместить при сохранении)».
• «Заметки» — свободный текст для монтажников: где висит камера, чем запитана, кто отвечает.

Типичные ошибки этого шага: «Перед включением DVR выберите ноду.» и «Инициализируйте этот диск в хранилищах ноды перед назначением DVR-камер.» Первая означает, что запись нельзя включить без известного узла; вторая — что диск ещё не инициализирован (Хранилища DVR).

Что дальше#

• Ежедневная работа со списком, массовые операции, PTZ и диагностика — Настройка камер.
• Запись и экспорт фрагментов — Архив (DVR).
• Раздача камер операторам — Пользователи и права доступа.
• Выдача ссылки наружу — Доступ по ссылке.