Cluebase VMS

1. Назначение VMS

Cluebase VMS (video management system - система управления видеонаблюдением) – это программный продукт, позволяющий подключать камеры видеонаблюдения к серверу для записи, просмотра живого видео, а так же множества дополнительных функций.

Cluebase VMS распространяется в качестве коммерческого программного продукта с открытой платформой.

2. Описание системы

Cluebase VMS состоит из следующих частей:

2.1. Front-end (Web/Lunix/MacOs/Windows)

2.2. Back-end: серверное приложение работающее в фоновом режиме.

2.3. Архитектура системы

Cluebase VMS разработана как модульная платформа, работающая в среде оркестрации Docker Compose. Архитектура разделяет основные функции системы на отдельные контейнеры, обеспечивая стабильность и независимость компонентов:

Backend Container — обрабатывает логику API, аутентификацию и системную логику. Взаимодействует с базой данных, фронтендом и клиентскими приложениями.

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

Frontend Container — предоставляет веб-интерфейс пользователя.

AI Processing Container — запускает задачи видеоаналитики, такие как обнаружение объектов, классификация и поведенческая аналитика. Использует ускорение GPU при наличии.

RTSP Server Container — действует как исходный RTSP-сервер для ретранслируемых камер.

Live Stream Server — обрабатывает потоки (WS, WebRTC, HLS) для предварительного просмотра в реальном времени, многопользовательского просмотра и совместимости с мобильными устройствами.

Камеры подключаются к Cluebase VMS посредством протоколов ONVIF и RTSP. Пользователь может самостоятельно подключить к системе любое количество камер и вести запись видео со всех либо с отдельных камер.

3. Требования к аппаратному обеспечению

Минимальные требования: Dual-core ARM или Intel/AMD (32 или 64 бит), 2ГБ ОЗУ, 2ГБ HDD/SSD.

Клиентское приложение требует PC или Mac компьютер с процессорами Intel/AMD (32 или 64 бит), Apple Silicon или другой процессор ARM с двумя ядрами частотой не менее 1.5ГГц на каждое ядро.

Поддерживаемые браузеры для веб-приложения: Google Chrome v.92+, Mozilla Firefox v.90+, Safari v.14+

4. Совместимость

Видео кодеки: Cluebase VMS работает с любыми потоками формата h.264, однако h.265 поддерживается в ограниченном режиме.

Cluebase VMS совместима с любыми цифровыми камерами видеонаблюдения и видеорегистраторами.

5. Автоматическая установка

Для автоматической установки на ОС Linux необходимо запустить скрипт install.sh

Для запуска скрипта перейдите в папку, содержащую скрипт и выполните команду:

sudo sh install.sh

6. Ручная установка

6.1. Установка Docker

Для запуска и работы VMS необходимо установить и запустить на сервере Docker и docker-compose.

6.1.1. Установка Docker на ОС Linux

Официальная документация по установке Docker из репозитория производителя: https://docs.docker.com/engine/install/ubuntu/

6.1.2. Установка docker-compose на ОС Linux

Выполните команду:

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Дайте права на исполнение двоичному файлу выполнив команду:

sudo chmod +x /usr/local/bin/docker-compose

6.2. Подготовка к установке VMS

Скачайте архив с программой CluebaseVMS.zip и разархивируйте его содержимое в любую доступную директорию на системном диске.

6.3. Установка и запуск сервера VMS

Войдите в папку VMS из командной строки и выполните команду:

sudo docker-compose up -d

После выполнения этой команды VMS будет автоматически установлен в папку VMS, а также будет автоматически запущен.

7. Остановка сервера VMS

Для остановки сервера выполните команду из командной строки, находясь в папке VMS:

sudo docker-compose down

8. Обновление VMS

Для того чтобы обновить VMS до последней версии остановите сервер выполните команду из командной строки, находясь в папке VMS:

sudo docker-compose pull

Запустите сервер командой:

sudo docker-compose up -d

9. Установка клиентского приложения

Обратите внимание на то, что Cluebase VMS имеет возможность полного доступа через веб-приложение, для доступа к которому необходимо ввести в строке браузера адрес сервера. Так же на официальном сайте доступны десктопные клиентские приложения для операционных систем: Windows, Linux и MacOS (https://vcloudai.ru/downloads)

9.1. Установка клиентского приложения на ОС Linux

После скачивания установочного файла Cluebase_VMS_Linux_x_x.deb установка может быть осуществлена из графического интерфейса ОС Linux путем двойного клика на установочном файле, либо при помощи команды в окне терминала:

sudo apt install Cluebase_ VMS_Linux_x_x.deb

9.2. Установка клиентского приложения на ОС Windows

После скачивания установочного файла Cluebase_VMS_WIN_x_x.exe установка может быть осуществлена из графического интерфейса ОС Linux путем двойного клика на установочном файле.

9.3. Установка клиентского приложения на ОС MacOS

После скачивания установочного файла Cluebase_VMS_MacOS_x_x.dmg установка может быть осуществлена из графического интерфейса ОС Linux путем двойного клика на установочном файле.

10. Вход в систему

После первого запуска клиентского приложения отображается экран входа.

Для входа в систему необходимо ввести имя пользователя и пароль, а затем нажать кнопку Войти. После первичной установки логин/пароль по умолчанию установлен: admin/admin.

11. Активация лицензии

Для начала работы с системой необходимо активировать лицензию на программный продукт. Для этого перейдите в меню Настройки -> Лицензия -> Запрос на лицензию VMS, заполните необходимые поля, укажите необходимое количество лицензий, их тип и нажмите Отправить запрос. Ваш запрос поступит в отдел продаж компании vCloud.ai и сотрудники пришлют файл лицензии для последующей активации.

После получения файла лицензии, его необходимо загрузить в поле Загрузить существующий файл лицензии и нажать Активировать.

После активации лицензии на экране должна отобразиться информация о лицензии:

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

12.1. Утилита поиска и добавления камер

Утилита поиска создана для облегчения процесса поиска и добавления камер в систему.

Перейдите в меню:

Система автоматически произведет поиск в указанной подсети и выведет список в таблице. Поиск обычно занимает не более 5-10 секунд.

После ввода имени, логина и пароля для камер их можно добавить в систему индивидуально путем нажатия кнопки ‘+’ в крайнем левом столбце таблицы

или нажатием кнопки Выбрать все устройства (добавление всех камер).

Для обновления результатов поиска или повторного поиска нажмите Обновление поиска.

Вы можете уточнить диапазон поиска с помощью соответствующих полей:

По умолчанию поиск осуществляется с текущей подсети сервера.

12.2. Добавление камер вручную

В открывшемся окне введите имя камеры (произвольное), выберите тип камеры (ONVIF или RTSP), введите адрес камеры, логин, пароль, часовой пояс и нажмите Добавить.

Камера появится в списке.

13. Настройка архива

Обратите внимание на то что система автоматически подключает все смонтированные на сервере носители.

Перейдите в меню:

Для активации носителя для записи архива необходимо выбрать режим ВКЛ.

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

13.1. Настройка NAS и iSCSI

Для использования сетевого хранилища (NAS) в Cluebase VMS необходимо предварительно смонтировать диск NAS в операционной системе. В течение 2 минут система автоматически обнаружит и подключит смонтированный диск.

Важные примечания:

Система не предоставляет интерфейса для первичного подключения iSCSI-хранилища к серверу, это необходимо сделать вручную средствами ОС (например, утилитой open-iscsi).

Сервер периодически (каждые 4 минуты) проверяет доступные хранилища. Когда он обнаруживает новый NAS, который еще не используется, он автоматически монтирует его и добавляет в систему.

Во время проверки сервер также контролирует статус подключения и доступность файловой системы (чтение/запись).

14. Управление правами пользователей

14.1. Управление ролями

Перейдите в меню:

Заполните все необходимые поля и нажмите Сохранить.

14.2. Управление пользователями

Укажите имя и пароль нового пользователя, выберите Роль. Права доступа, предоставленные, выбранной роли будут отображены на экране, однако они могут быть изменены только при редактировании Роли. Для перехода у редактированию Роли нажмите на «карандаш» справа от наименования роли:

15. Настройка карт

Для удобства определения положения камеры на местности, система позволяет внести координаты камеры на карте либо перетащить мышью иконку камеры на карте.

В левом верхнем углу поле для поиска локации:

Нажатием правой кнопки мыши в необходимой локации добавляется устройство(камера, турникет и др.)

16. Настройка раскладок

Нажмите Создать раскладку в Главном меню:

На экране появится страница редактирования раскладки:

Введите имя новой раскладки, выберите Шаблон из предложенных вариантов, перетащите камеры или группы в шаблон:

Нажмите кнопку

Для редактирования существующих раскладок наведитесь на раскладку и нажмите «карандаш» справа от названия раскладки в верхней части экрана:

17. Группы камер

Для изменения названия либо удаления группы нажмите на «карандаш» справа от названия группы.

Для добавления камеры к определенную группу необходимо перейти в настройки камеры и выбрать необходимую группу в списке:

18. Осуществление видеонаблюдения

Видеонаблюдение осуществляется следующими способами:

• просмотр живого на экране
• работа с видеоархивом
• экспорт видеоархива
• управление PTZ камерой
• определение местоположения камеры на карте

18.1. Просмотр живого видео на экране

Для начала просмотра живого видео на экране выберете одну из созданных раскладок

После нажатия на раскладку откроется выбранная раскладка как указано в примере:

Цифровое увеличение содержимого видеоокна осуществляется колесом мыши.

Масштабирование видеоокна осуществляется кликом по нему либо элементами масштабирования в правом нижнем углу видеоокна.

Для включения звука с микрофона камеры необходимо нажать соответствующую кнопку в статусной строке видеоокна и установить необходимую громкость:

18.2. Работа с видеоархивом

Для перехода в архив необходимо переключить тумблер Live/Archive как указано ниже:

После перехода в режим архива в нижней части видеоокна появится временная шкала. При наведении мыши на временную шкалу отображается время позиции курсора мыши. Навигация по архиву осуществляется путем клика по временной шкале. Перемещение временной шкалы осуществляется путем перетаскивания ее мышью. Масштабирование временной шкалы осуществляется колесом мыши.

Переход на определенное заданное время в видеоархиве осуществляемся путем нажатия на текущее время и выбор времени и даты перехода в появившемся окне:

Для удобства поиска событий в видеоархиве предусмотрено ускоренное проигрывание видеозаписей. Для установки скорости просмотра архива войдите в настройки и выберите необходимую скорость проигрывания:

18.3. Экспорт видеоархива

Для экспорта фрагмента видеоархива необходимо перейти в режим архива, активировать выделение двойным кликом на шкале времени и выбрать фрагмент архива путем перетаскивания краев выделенной зоны:

Затем необходимо нажать на кнопку экспорта, при необходимости уточнить параметры экспорта и нажать кнопку «Экспорт»:

Экспорт фрагмента может занять некоторое время. Не закрывайте окно экспорта пока не исчезнет индикатор ожидания:

После этого нажмите повторно кнопку Экспорт для того чтобы скачать файл:

18.4. Управление PTZ камерой

Для вызова элементов управления PTZ камерой нажмите соответствующую кнопку в статусной строке видеоокна:

Для управления камерой используйте кнопки «стрелки» и «+/-»

18.5. Определение местоположения камеры на карте

Для использования функции определения местоположения камеры на карте нажмите соответствующую кнопку в статусной строке видеоокна:

Для масштабирования и навигации по карте используйте левую кнопку и колесо мыши.

19. Модуль интеграции СКУД

19.1. Авторизация

Для подключения СКУД к VMS необходимо перейти на страницу меню:

На открывшейся странице необходимо выбрать производителя СКУД из выпадающего списка интегрированных систем и заполнить поля: Название контроллера, IP адрес, сетевой порт, имя пользователя и пароль. После заполнения необходимо нажать кнопку Добавить.

19.2. Добавление, изменение, удаление пользователей СКУД

Для внесения изменений в список пользователей СКУД необходимо перейти на страницу меню:

Для добавления отдела нажмите +Добавить отдел, введите название отдела и сохраните изменения.

Для добавления посетителя нажмите +Добавить посетителя и выполните следующие действия:

• введите имя пользователя,
• выберите отдел и должность,
• введите личный номер посетителя,
• установите курсор мыши на поле Номер карты-ключа и приложите карту доступа к считывателю карт, подключенный к порту USB (например считыватель карт Smartec ST-CE011),
• введите дополнительную информацию о посетителе в поле Детали,
• выберите уровень доступа,
• при необходимости установите срок действия пропуска,
• нажмите Сохранить изменения.

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

19.3. Управление проходами

Для удобства управлением проходами можно расположить их на планах помещений и привязать к ним камеры видеонаблюдения. Для этого перейдите в режим редактирования карт, нажмите правую клавишу мыши и выберите Расположить дверь.

19.4. Управление уровнями доступа

Для создания уровней доступа перейдите в меню Уровни доступа, введите имя уровня доступа и выберите проходы, доступ к которым разрешен для текущего уровня доступа.

20. Мультисерверный функционал

Cluebase VMS позволяет создавать мультисерверные системы для объединения ресурсов. Это позволяет управлять всеми серверами и камерами с одного клиента, создавать единые раскладки с камерами от разных серверов и получать тревоги в единый центр.

Перейдите в меню:

Заполните поля доступа к удаленному серверу (IP-адрес, порт, логин, пароль) и нажмите Привязать.

21. Настройки времени

Точное время сервера критически важно для надежного ведения логов, временных меток архива и синхронизации.

Перейдите в меню:

Установка времени вручную

Используйте поля ввода часов, минут и секунд для ручной корректировки системных часов. Этот метод полезен, если NTP недоступен.

Выбор часового пояса

Выберите ваш регион и город из выпадающего списка.

Синхронизация NTP

Вкл / Выкл — включите эту опцию для автоматической синхронизации времени с NTP-сервером.

NTP Server URL — укажите адрес сервера (по умолчанию ntp.ubuntu.com). Можно изменить на любой другой (например, pool.ntp.org или локальный сервер).

22. Настройки видеопотока

Система позволяет управлять параметрами обработки видео для баланса между производительностью и качеством.

Перейдите в меню:

Размер фрагмента прямой трансляции (Livestream chunk size):

Определяет длительность фрагмента (в секундах) для стриминга через WebSocket. Меньшие значения снижают задержку, но увеличивают нагрузку на сеть и процессор.

Размер фрагмента архива (Archive chunk size):

Устанавливает длительность записываемых файлов архива. Более длинные фрагменты уменьшают количество файлов, но могут замедлить доступ при просмотре.

Одновременное получение SD и HD потоков:

Если включено, система забирает оба потока одновременно. Это ускоряет переключение между качеством в интерфейсе, но значительно увеличивает нагрузку на ЦП. По умолчанию: Выкл.

Проверка потока при добавлении:

Автоматически проверяет доступность видео при добавлении новой камеры. По умолчанию: Вкл.

23. Видеоаналитика

Cluebase VMS поддерживает широкий спектр аналитики. Настройка производится индивидуально для каждой камеры.

Нажмите кнопку AI в нижней части видеоокна камеры для открытия меню настроек.

23.1. Встроенная видеоаналитика

Включает стандартные детекторы:

• Обнаружение движения
• Саботаж камеры
• Обнаружение объектов (Люди, Транспорт)
• Face ID Lite

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

23.2. Дополнительные модули ИИ

Включают специализированные детекторы: Обнаружение дыма и огня, Детекция СИЗ (каски, жилеты), Аналитика трафика.

23.3. Пользовательская модель ИИ (YOLO)

Позволяет загружать собственные модели в формате .pt (PyTorch), обученные на специфические объекты (например, дроны, дефекты производства).

Перейдите в меню:

Выберите «Новая модель», введите имя, загрузите файл .pt и нажмите Добавить. Модель появится в общем списке детекторов в меню AI.

23.4. Визуальный помощник (Visual Assistant)

Позволяет создавать правила детекции, используя описание на естественном языке (требуется GPU с CUDA).

Перейдите в меню:

1. Нажмите Установить.
2. Создайте новое правило, введя текстовый запрос (Подсказка), например: "Говори только ‘да’ если видишь драку".
3. Настройте логику (Тревожный сигнал, если ответ 'да') и сохраните.

23.5. Списки распознавания

Для управления базами данных лиц и автомобильных номеров (LPR) используйте соответствующие разделы в меню:

24. Панель тревог

Панель тревог предоставляет централизованный список всех событий системы. Для открытия нажмите кнопку «Колокольчик» в правом верхнем углу.

Функции панели:

• Фильтры: По типу события (Движение, Человек, Авто), по камере, по дате и

времени.

• Просмотр: Каждая запись содержит миниатюру (снэпшот), тип объекта, уровень достоверности и время.
• Действия: Скачивание изображения или видеоклипа события, добавление текстовых комментариев оператора.
• Отчеты: Кнопка Выгрузить отчет позволяет выгрузить отфильтрованный список событий в PDF-файл.

25. Экспорт и импорт конфигурации

Раздел позволяет создавать резервные копии настроек системы.

Перейдите в меню:

• Сохранить: Экспортирует текущие настройки в файл.
• Загрузить: Восстанавливает настройки из выбранного файла.
• Сброс: Возвращает систему к заводским настройкам (удаляет все данные).
• Отправка в Telegram: Позволяет настроить автоматическую отправку файла конфигурации боту в Telegram с заданным интервалом. Требуется токен бота и ID чата.

26. Уведомления и автоматизация

Настройка реакции системы на события (тревоги аналитики, потеря связи и т.д.).

Перейдите в меню:

Отправка на Email

Добавьте адреса электронной почты для получения уведомлений.

Отправка в Telegram

Включите опцию, введите токен бота и ID чата (личного или группового).

Автоматизация (Сценарии)

Позволяет отправлять HTTP-запросы во внешние системы.

• Метод: GET или POST.
• URL: Адрес внешней системы (webhook).
• Камеры и События: Выберите триггеры, которые запустят сценарий.
• Данные: Можно включить передачу информации о событии в формате JSON.

Расписание

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

27. Отчеты

Модуль для создания графических отчетов на основе данных видеоаналитики (например, подсчет посетителей, статистика проездов).

Перейдите в меню:

28. Облачные функции

Перейдите в меню:

• Облачный режим: Оптимизирует VMS для работы в облаке, минимизируя паразитный трафик.
• Качество потока: Включает перекодирование потока на стороне сервера в заданный битрейт. Внимание: требует значительных ресурсов процессора.
• Туннель: Создает защищенный туннель к сервису vCloud.ai CloudLink, обеспечивая доступ к серверу из интернета без статического IP-адреса.

29. Брендинг

Позволяет адаптировать интерфейс под фирменный стиль заказчика.

Перейдите в меню:

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

30. Логи (Журналы событий)

Инструмент для аудита действий пользователей и системных процессов.

Перейдите в меню:

Фильтры:

• Пользователь: Выбор конкретного сотрудника или всех.
• Дата: Диапазон времени.
• Типы событий: Вход/выход, Экспорт архива, Изменение настроек, Управление PTZ, Отключение камер и другие.

Нажмите Показать отчет для просмотра или Скачать для выгрузки текстового файла.

31. Отказоустойчивость (Failover)

Функция позволяет настроить резервные серверы, которые автоматически перехватят управление камерами при отказе основного сервера.

Перейдите в меню:

Настройка:

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

32. Обслуживание сервера

Управление состоянием сервера и обновлениями.

Перейдите в меню:

Обновление системы:

Используйте кнопку Обновить для установки последней версии сервера и интерфейса.

Перезагрузка:

Используйте кнопку Перезагрузить для ручного перезапуска службы сервера.

Автоматическая перезагрузка:

В меню Настройки администратора можно включить расписание для профилактической перезагрузки сервера (например, раз в неделю).

Загрузка конфигурации/Сброс настроек:

В меню Конфигурация доступна кнопка Вернуть по умолчанию. Это действие необратимо удаляет все пользовательские данные.

33. Техническая поддержка

Техническая поддержка доступна по электронной почте, среднее время ответа составляет 3 часа.

Запросить техническую поддержку можно по электронной почте: support@vcloud.ai