Ретранслятор MS-Gate
MS-GATE - программное решение для ретрансляции потоков с камер видеонаблюдения из сетей без статического IP-адреса. Устанавливается на одноплатные мини-ПК с процессором на ARM-архитектуре (например, RaspberryPI 3 & Pi 4 или OrangePI ZERO PLUS и старше).
Подключение камер через MS-Gate можно реализовать при любом варианте работы с сервисом: как при использовании собственного сервера, так и при хранении видеоархива на серверах ЕС «Мой Двор».
Схема работы
Принципиальная схема подключения ретранслятора выглядит так:
Системные требования к аппаратной части
Одноплатный ПК на архитектуре arm64.
Модели, на которых проходили тесты:
- Raspberry Pi 3
- Raspberry Pi 4
- Orange Pi 3 LTS
- Orange Pi Zero2
- Orange Pi Plus
Но также можно использовать и другие модели одноплатников Orange Pi, Banana Pi и прочее. В этом случае установка ПО может немного отличаться.
Системные требования к ОС:
Предустановленные серверные ОС на основе Ubuntu или Debian последних версий для платформы arm64.
Для Raspberry 3 и 4 рекомендуется Ubuntu Server 20.04 LTS.
Для Orange Pi рекомендуется ОС на основе серверной Ubuntu 20.04 LTS или Debian. Можно воспользоваться официальным сайтом.
Приводим ниже прямые ссылки на образы ОС для некоторых одноплатных ПК:
Подготовка носителя с ОС
Для установки потребуется обычный ноутбук или ПК с кардридером и MicroSD-карта (Class 10 и выше) объемом не менее 8Gb.
- Скачайте программу для записи образов на карты памяти balenaEtcher и установите её
- Скачайте образ ОС для вашего одноплатного ПК и распакуйте его, если он заархивирован. Ссылки выше.
- Запустите программу balenaEtcher:
- выберите в проводнике образ ОС, нажав кнопку “flash from file”,
- выберите устройство для записи, нажав кнопку “select target”,
- запустите запись на карту памяти, нажав кнопку “flash!”.
- Установите карту памяти в одноплатный ПК, подключите его к своей локальной сети с DHCP и питанию. Одноплатник автоматически запустится.
Установка соединения с одноплатным ПК и первоначальная настройка ОС
Войти на одноплатный ПК можно несколькими способами:
- COM порт
- Подключите питание к устройству посредством USB от ПК с Windows. Устройство загрузится в течении одной минуты и ОС присвоит ему COM-порт. Узнать его номер можно в диспетчере устройств.
- Откройте Putty, выберите тип соединения “serial” и укажите COM-порт вашего устройства в поле “serial line”. Нажмите кнопку “Open”. Если COM-порт верный, то установится соединение и откроется терминал.
- SSH (рекомендуется)
- После включения устройства узнайте его IP адрес, например, с помощью сканеров локальной сети или из списка клиентов DHCP вашего маршрутизатора.
- Далее откройте Putty, впишите IP-адрес вашего устройства в поле “hostname” и нажмите кнопку “Open”. Если IP-адрес верный, то начнёт устанавливаться соединение. Согласитесь на кэширование публичного ключа хоста и соединение установится.
- Монитор и клавиатура
- Если на одноплатном ПК есть порт USB и HDMI, то можно выполнить подключение классическим способом. Подключите питание, сеть с DHCP, клавиатуру и монитор.
После первого запуска устройства операционная система предложит выполнить первоначальную настройку: установить логин и пароль, указать имя ПК, настроить локализацию и прочее. Может отличаться от версии ОС.
Установка MS-Gate и сопутствующего ПО
Выполните вход в ОС, используя логин и пароль, созданный при первоначальной настройке.
Получите права суперпользователя:
sudo -i
Обновите список пакетов:
apt update
Установите Netplan (для Ubuntu для Raspberry не нужно, уже установлен):
apt install netplan.io
Сгенерируйте необходимые файлы Netplan’a (для Ubuntu для Raspberry не нужно, уже установлен):
netplan generate
Откройте файл:
nano /etc/netplan/netplan.yaml
и пропишите статический IP адрес, один или несколько (на усмотрение) а также шлюз.
Пример netplan.yaml для типичной локальной сети с несколькими статическими IP адресами в разных подсетях:
Замените значения на ваши: название сетевого интерфейса, IP адреса вашего сетевого интерфейса, IP адрес вашего шлюза.
На Ubuntu для Raspberry нужно вместо “NetworkManager” в поле “renderer” прописать “networkd”
Сохраните изменения в netplan.yaml, нажав сочетание “ctrl+x”, затем клавишу “y”.
Примените новые сетевые настройки:
netplan apply
После применения настроек и смены IP адреса потребуется переподключение, если вы используете сетевое соединение. Далее снова подключитесь к мини-ПК с новым IP адресом, используя Putty.
Выполните вход и авторизуйтесь под суперпользователем:
sudo -i
Установите ifstat:
apt install ifstat
Установите необходимые библиотеки:
apt install libx264-dev
wget http://ftp.ru.debian.org/debian/pool/main/x/x264/libx264-155_0.155.2917+git0a84d98-2_arm64.deb
dpkg -i libx264-155_0.155.2917+git0a84d98-2_arm64.deb
rm libx264-155_0.155.2917+git0a84d98-2_arm64.deb
wget http://ftp.ru.debian.org/debian/pool/main/x/x264/libx264-dev_0.155.2917+git0a84d98-2_arm64.deb
dpkg -i libx264-dev_0.155.2917+git0a84d98-2_arm64.deb
rm libx264-dev_0.155.2917+git0a84d98-2_arm64.deb
wget http://ftp.ru.debian.org/debian/pool/main/y/yaml-cpp/libyaml-cpp0.6_0.6.3-9_arm64.deb
dpkg -i libyaml-cpp0.6_0.6.3-9_arm64.deb
rm libyaml-cpp0.6_0.6.3-9_arm64.deb
wget http://ftp.ru.debian.org/debian/pool/main/y/yaml-cpp/libyaml-cpp-dev_0.6.3-9_arm64.deb
dpkg -i libyaml-cpp-dev_0.6.3-9_arm64.deb
rm libyaml-cpp-dev_0.6.3-9_arm64.deb
Скачайте MS-Gate:
wget http://get.dvor24.com/ms-gate/download/ms-gate_2.1.0_all.deb
Установите ms-gate:
dpkg -i ms-gate_2.1.0_all.deb
Запустите ms-gate:
service ms-gate start
Настройка на стороне принимающего сервера, на который будут подключаться камеры через ретранслятор
Чтобы MainStreamer получал потоки от камер через ретранслятор MS-Gate
- Включите RTSP сервер в MainStreamer'е.
Откройте файл конфигурации стримераsudo nano /opt/main-streamer/ms.conf
Измените параметр "rtsp_output" на значение "true". Сохраните изменение, нажав "ctrl+x", затем "y".ms.conf"rtsp_output": { "enabled": "true", ...}
Перезапустите службу MainStreamer'a, чтобы изменения вступили в силу:sudo service main-streamer restart
Также это можно сделать в web-панели MainStreamer'a, включив RTSP сервер. - Выполните проброс порта 8554 на роутере для сервера с MainStreamer
- Убедитесь, что в Личном Кабинете в карточке сервера указан RTSP порт 8554
Если возникла необходимость смены RTSP порта 8554, то:
- Отредактируйте файл конфигурации RTSP сервера:
sudo nano /opt/main-streamer/programms/rtsp-simple-server/rtsp-simple-server.yml
Измените порт в поле "rtspAddress"
Сохраните изменение, нажав "ctrl+x", затем "y".
Перезапустите RTSP сервер командой:sudo service rtsp-simple-server restart - Измените порт в параметре "rtsp_output" в конфигурационном файле MainStreamer'a:
sudo nano /opt/main-streamer/ms.conf
Перезапустите службу MainStreamer'а:sudo service mainstreamer restart
Также это можно сделать в web-панели MainStreamer'a, изменив порт RTSP сервера - Измените проброс порта на роутере для сервера с MainStreamer
- Измените RTSP порт в личном кабинете в карточке сервера
Настройка ретранслятора MS-Gate
Для работы ретранслятора необходимы розетка 220В и точка подключения сети интернет (RJ-45), например роутер или коммутатор. По возможности рекомендуется закрепить ретранслятор к плоской поверхности крепежом.
Для настройки ретранслятора понадобится компьютер или ноутбук в месте установки для доступа в веб интерфейс и личный кабинет сервиса.
Порядок подключения:
- Соедините при помощи патч-корда ретранслятор и ваш роутер/коммутатор, на который приходит интернет-соединение
- Подключите блок питания к ретранслятору и включите в розетку
- В браузере перейдите по адресу веб-интерфейса ретранслятора: 192.168.1.100:80, по умолчанию
- В форме авторизации укажите логин: admin и пароль: 0000, по умолчаниюПосле окончания настройки рекомендуется изменить логин и пароль в меню «Учетная запись» для исключения посторонних подключений к устройству.
- Перейдите в меню «Настройки сети» и укажите данные для подключения, исходя из настроек вашего интернет-соединения. Если настройки выполнены корректно, сетевой статус изменится на «Not Registered».
- Перейдите в меню «Регистрация в ЛК» и укажите название ретранслятора и ваши логин и пароль от личного кабинета сервиса.
Важно. Для регистрации используются логин и пароль от личного кабинета партнера, например, MOS_1, VLA_3 и т.д. (логин, выдающийся при регистрации партнера в сервисе). Учетные данные сотрудников или абонентов не подходят для регистрации ретранслятора.
Если все указано верно, сетевой статус изменится на «Online», а ретранслятор будет добавлен в список меню «Ретрансляторы» в Личном Кабинете партнера.
Добавление камер для ретрансляции
Чтобы добавить камеру для ретрансляции она должна находиться в одной локальной сети с ретранслятором. При добавлении камеры в Личном Кабинете нужно отметить «Подключение через ретранслятор MS-Gate» и выбрать ретранслятор из списка.
В поле для RTSP-ссылки указывается локальная RTSP-ссылка на видеопоток.
В течение 1-2 минут камера будет инициализирована и пойдет трансляция.
- Во избежание проблем с трансляцией, рекомендуется забирать поток с камеры не более двух раз. Например, ссылка на поток может быть добавлена в сервис и на регистратор. В случае, если запись потока ведется на большее количество устройств, то могут проявляться проблемы (фризы, артефакты изображения), к которым сервис отношения не имеет.