Техническая страница

Подробная инструкция по настройке оборудования, подключению к MODROB и устранению проблем

Необходимое оборудование

Термопринтер для этикеток

Термопринтер — необходим для автоматической печати транспортных этикеток OZON. Обычный офисный принтер не подойдёт.

Обязательная поддержка печати по сети TCP/IP (порт 9100)
Ширина этикетки: 58мм или 80мм
Рекомендуемые модели: Xprinter XP-350B (~3000 ₽), Xprinter XP-350II, Godex G500 (~5000 ₽), TSC TE210
Принтер должен быть в одной локальной сети с вашим компьютером (или с компьютером, где установлен MODROB агент)
Узнайте IP-адрес принтера: обычно в меню принтера (кнопка «Feed» на 3 секунды) или через утилиту производителя

Как подключить принтер в MODROB:

Настройки (шестерёнка в шапке) → вкладка «Принтер»
Нажмите «Добавить принтер»
Укажите: название (любое), IP-адрес принтера, порт (по умолчанию 9100)
Нажмите «Сохранить» — принтер появится в списке
Нажмите «По умолчанию» рядом с нужным принтером (если их несколько)

IP-камера (видеонаблюдение)

IP-камера устанавливается над рабочим местом сборки и записывает весь процесс сверху вниз.

Обязательная поддержка RTSP видеопотока
Рекомендуемые модели: Hikvision DS-2CD2143G2-I (~4000 ₽), Dahua IPC-HDW2431T (~3500 ₽), бюджетные варианты от ~2000 ₽
Камера должна быть направлена вниз на рабочее место (рекомендуемый угол: сверху, видна вся область сборки)
Формат RTSP-ссылки обычно: rtsp://логин:пароль@IP_камеры:554/Streaming/Channels/101 (Hikvision) или rtsp://логин:пароль@IP_камеры:554/cam/realmonitor?channel=1&subtype=0 (Dahua)
Проверьте RTSP-ссылку: откройте её в VLC Player — если видео воспроизводится, ссылка правильная

Как подключить камеру в MODROB:

Настройки → вкладка «Камера»
Нажмите «Добавить камеру»
Укажите: название (любое), RTSP-ссылку камеры (полный URL с логином и паролем)
Нажмите «Сохранить»
Нажмите «По умолчанию» рядом с нужной камерой

Компьютер

Современный браузер: Chrome, Firefox, Edge (рекомендуем Chrome)
Стабильное интернет-соединение (минимум 2 Мбит/с для видеопотока)
Для прямого подключения — статический (белый) IP адрес
Для серого IP — MODROB агент (устанавливается на этот же компьютер или любой ПК в локальной сети)

Статический (белый) IP адрес

Статический (белый) IP — это внешний IP адрес, который назначается провайдером и позволяет напрямую обращаться к устройствам в вашей локальной сети из интернета. С ним MODROB может напрямую подключиться к вашему принтеру и камере без дополнительного ПО.

Как узнать свой тип IP:

Зайдите на 2ip.ru — запомните отображаемый IP
Откройте командную строку (Win+R → cmd)
Введите ipconfig
Если IP в cmd совпадает с 2ip.ru — скорее всего белый IP
Точный ответ: позвоните провайдеру

Как получить статический IP:

Позвоните в техподдержку провайдера
Закажите услугу «статический IP адрес»
Стоимость: 50–300 ₽/мес (зависит от провайдера)
Некоторые провайдеры выдают бесплатно по запросу
Настройка занимает 5–30 минут

Серый IP? Используйте MODROB Агент

Если у вас серый (динамический) IP — провайдер не даёт прямой доступ к устройствам в вашей сети из интернета. MODROB сервер не сможет подключиться к принтеру и камере напрямую. Это не проблема — MODROB Агент решает её.

Агент — это небольшая программа, которая устанавливается на ваш рабочий компьютер (или любой ПК в той же локальной сети, что принтер и камера). Агент сам подключается к серверу MODROB по зашифрованному WebSocket-каналу. После подключения сервер отправляет команды на принтер и запрашивает видео через агента.

Преимущества:

Работает с ЛЮБЫМ типом IP адреса
Бесплатный, открытый исходный код
Настройка роутера НЕ требуется
Автоматическое переподключение при обрыве связи
Минимальное потребление ресурсов (~30 МБ RAM, <1% CPU)

Установка MODROB Агента (пошагово):

Установите Bun runtime

Скачайте с bun.sh — это среда выполнения JavaScript (аналог Node.js, но быстрее). Для Windows: скачайте установщик .exe и запустите.

Включите режим «MODROB Агент» в личном кабинете

Настройки (шестерёнка) → вкладка «Агент» → переключите «Использовать MODROB агент».

Скопируйте JWT токен

На вкладке «Агент» нажмите «Копировать токен». Этот токен идентифицирует вашу учётную запись.

Скачайте и запустите агента

Скачайте файл агента из личного кабинета (или запросите у техподдержки). Запустите в командной строке:

bun agent.js --token ВАШ_СКОПИРОВАННЫЙ_ТОКЕН

Проверьте статус

В личном кабинете на вкладке «Агент» должен появиться статус «Подключён». Если статус «Offline» — проверьте токен и интернет-соединение.

# Пример запуска агента

$ bun agent.js --token eyJhbGciOiJIUzI1NiIs...

{ "status": "connected" }

{ "printer": "192.168.1.100:9100", "camera": "rtsp://..." }

✓ MODROB Agent запущен и готов к работе

Важно: компьютер с агентом должен быть включён

Агент работает на вашем компьютере. Пока компьютер выключен или агент не запущен — печать и видеозапись через агента недоступны. Рекомендуем настроить автозапуск агента при загрузке ОС.

Проброс портов (для статического IP)

Если у вас статический IP и вы НЕ используете MODROB агент — необходимо настроить проброс портов на роутере. Это позволяет MODROB серверу из интернета обращаться к принтеру и камере в вашей локальной сети.

Устройство	Внешний порт	Внутренний IP	Внутренний порт	Протокол
Термопринтер	9100	192.168.1.100	9100	TCP
IP-камера (RTSP)	554	192.168.1.101	554	TCP/UDP

Замените 192.168.1.100 и 192.168.1.101 на реальные локальные IP-адреса вашего принтера и камеры.

Где найти проброс портов на популярных роутерах:

Keenetic

Домашняя сеть → Интерфейсы → Ваш интерфейс → Проброс портов

TP-Link

Forwarding → Virtual Servers → Add New

ASUS

Внешняя сеть (WAN) → NAT → Port Forwarding

Xiaomi

Дополнительные настройки → Port Forwarding

D-Link

Setup → Networking → NAT → Port Forwarding

Ростелеком

Настройки → Безопасность → Переадресация портов

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

Проброс портов открывает доступ к устройствам из интернета. Рекомендуем установить сложные пароли на принтер и камеру. Используйте MODROB агент, если хотите избежать проброса портов — он безопаснее.

Схемы подключения

Вариант 1: Статический IP (прямое подключение)

Сервер MODROB (облако)

↕ TCP :9100 (печать) ↕

↕ RTSP :554 (видео) ↕

Ваш роутер (статический IP)

↕ проброс портов ↕

Локальная сеть

↕ ↕

Принтер :9100Камера :554

Требуется: статический IP + проброс портов на роутере

Вариант 2: MODROB Агент (рекомендуемый)

Сервер MODROB (облако)

↕ WebSocket (зашифрованный) ↕

MODROB Агент (ваш ПК)

↕ локальная сеть ↕

Принтер :9100Камера :554

Рекомендуемый вариант: работает с любым IP, без настройки роутера

Частые технические вопросы

Оплата подписки через CDEK PAY

Для оплаты подписки на MODROB используется CDEK PAY — платёжная система от компании СДЭК. CDEK PAY обеспечивает безопасную обработку банковских карт (Visa, Mastercard, МИР) с соответствием стандарту PCI DSS.

Что такое CDEK PAY?

Интернет-эквайринг от компании СДЭК
Принимает Visa, Mastercard, МИР
Соответствие стандарту PCI DSS (безопасность данных карт)
API документация: apidoc.cdek.ru

Как происходит оплата:

После окончания пробного периода в личном кабинете появится кнопка «Оплатить»
Выберите подходящий тариф (Мини, Средний, Крупный)
Нажмите «Оплатить» — откроется платёжная форма CDEK PAY
Введите данные банковской карты
После успешной оплаты подписка активируется автоматически

Интеграция CDEK PAY

Подключение CDEK PAY для приёма платежей находится в процессе настройки. Если вы хотите оплатить подписку до завершения интеграции — напишите на modrob@modrob.ru, и мы отправим реквизиты для оплаты.

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

Принтер не печатает

1. Проверьте, что принтер включён и бумага загружена
2. Проверьте IP-адрес принтера в настройках MODROB (должен совпадать с реальным)
3. Проверьте, что принтер пингуется: ping 192.168.1.100
4. При использовании статического IP — проверьте проброс порта 9100 на роутере
5. При использовании агента — проверьте, что агент запущен и показывает принтер «online»

Камера не подключается

1. Проверьте RTSP-ссылку: откройте её в VLC Player
2. Убедитесь, что логин и пароль в RTSP-ссылке указаны верно
3. Проверьте, что камера доступна по локальной сети: ping 192.168.1.101
4. При использовании статического IP — проверьте проброс порта 554
5. Некоторые камеры требуют включения RTSP в настройках (через веб-интерфейс камеры)

MODROB агент не подключается

1. Проверьте, что токен скопирован полностью и без пробелов
2. Проверьте интернет-соединение
3. Убедитесь, что в личном кабинете включён режим «MODROB агент»
4. Попробуйте перезапустить агента
5. Если проблема сохраняется — напишите на modrob@modrob.ru