MODROB Агент: печать этикеток и камера без белого IP — установка, настройка и решение проблем

Зачем нужен MODROB Агент

Это третья статья из серии о работе в MODROB. В первой мы показали, как проходит сборка заказа от поступления до видео в архиве, во второй — как клонировать код «Честного знака». Сегодня поговорим про невидимого героя, который делает возможным и то, и другое на обычном домашнем интернете, — MODROB Агент.

MODROB — облачная система: она работает в браузере, и у большинства функций нет «установки на компьютер». Но термопринтер и IP-камера — физические устройства, которые стоят у вас на складе, в вашей локальной сети. Чтобы кабинет MODROB мог отправить этикетку именно на ваш принтер и забрать кадр именно с вашей камеры, нужен «мост» между облаком и вашими устройствами. Этот мост и есть агент: маленькая бесплатная программа, которая ставится один раз и дальше работает сама.

На скриншотах — реальный интерфейс MODROB на демо-аккаунте.

Что такое «серый IP» и почему без агента не обойтись

Провайдеры выдают большинству домашних и офисных сетей серый IP — адрес, который недоступен из интернета. Тот же эффект даёт любой Wi-Fi-роутер из коробки: он прячет устройства за NAT. Для вас всё работает — вы открываете сайты, выходите в мессенджеры. Но извне «достучаться» до вашего принтера невозможно: соединение «снаружи — внутрь» просто не пройдёт.

Классическое решение — купить у провайдера белый (публичный) IP и настроить на роутере проброс портов. Это деньги, поход в личный кабинет провайдера и возня с роутером. MODROB Агент избавляет от всего этого: белый IP, проброс портов и настройка роутера не нужны вообще.

Как устроен агент: почему он работает за любым NAT

Ключевая идея агента — он не ждёт входящих подключений, а сам выходит наружу:

• агент устанавливается на любой компьютер в той же локальной сети, что принтер и камера (Windows, macOS или Linux);
• сам подключается к серверу MODROB по защищённому каналу WSS — это тот же уровень шифрования, что у интернет-банков. Соединение исходящее, к modrob.ru:443, поэтому его пропускает любой NAT и почти любой файрвол;
• держит канал постоянно: проверка связи каждые 25 секунд, а если сервер перестал отвечать — агент сам рвёт «подвисшее» соединение и переподключается;
• когда вы нажимаете «Печать» в кабинете, команда мгновенно уходит по уже готовому каналу, и агент выполняет её локально: отправляет данные на термопринтер по сети (порт 9100) или забирает снимок с камеры по протоколу ISAPI;
• если интернет пропал — агент сам восстанавливает связь: первые попытки идут каждые 5–10 секунд, дальше пауза плавно растёт до минуты. Как только сеть вернулась, канал восстанавливается за секунды.

По ресурсам агент почти невидим: файл размером около 20 КБ, потребляет ~40 МБ памяти и меньше 1% процессора — его можно держать на любом, даже самом слабом компьютере или мини-ПК.

Что умеет агент: печать этикеток на термопринтер напрямую из кабинета, снимки и проверка IP-камер Hikvision/HiWatch (ISAPI), проверка доступности принтера и камеры в один клик. И ничего больше — это безопасно, о чём расскажем в конце.

Шаг 1. Установите Bun на компьютер с принтером

Bun — это среда запуска программ: как плеер нужен, чтобы посмотреть видео, так Bun нужен, чтобы запустить файл агента. Скачайте установщик с официального сайта bun.sh:

• Windows — кнопка Download, файл bun-windows-x64.exe; установка в пару кликов;
• macOS и Linux — одна команда в терминале: curl -fsSL https://bun.sh/install | bash.

После установки откройте новый терминал (это важно: терминал, открытый до установки, ещё не знает про Bun) и выполните bun --version — если увидели номер версии, всё готово.

Шаг 2. Включите агента в кабинете MODROB

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

Зачем нужен этот переключатель: MODROB умеет работать с устройствами и напрямую — но для этого нужен белый IP и доступность принтера из интернета. Если у вас серый IP, домашний интернет или Wi-Fi — включайте агента, и все проверки и печать пойдут через него.

Шаг 3. Скопируйте две команды установки

Сразу после включения в настройках появятся две готовые команды и ваш личный токен.

• Первая команда скачивает агента с нашего сайта: curl -fsSL https://modrob.ru/agent.js -o agent.js — файл agent.js появится в текущей папке;
• Вторая команда запускает агента с вашим личным токеном: bun agent.js --token ВАШ_ТОКЕН;
• кнопка со значком копирования копирует обе команды сразу — просто вставьте их в терминал;
• в Windows команды выполняются в PowerShell: меню «Пуск» → введите «PowerShell» → Enter. Утилита curl уже входит в состав Windows 10+, ничего дополнительно ставить не нужно.

Токен — главный ключ, берегите его

• токен действует 1 год — целый год можно не вспоминать про настройку;
• это ключ к вашему принтеру и камере: не передавайте его никому;
• если токен попал в чужие руки — нажмите «Перевыпустить»: старый перестанет работать мгновенно;
• после перевыпуска запустите агента заново с новым токеном.

Шаг 4. Запустите агента и проверьте подключение

Вставьте обе команды в терминал и нажмите Enter. Через 10–20 секунд в кабинете появится зелёная плашка «Агент подключён» с версией и временем подключения. А в окне терминала вы увидите живой лог работы:

На скриншоте — типичная рабочая сессия: агент авторизовался и ждёт команд, проверил доступность принтера, напечатал тестовую этикетку и проверил камеру. Каждое действие в кабинете отражается в этом окне — по логу всегда понятно, что происходит.

Статус в кабинете обновляется каждые 30 секунд, а также при открытии страницы настроек:

Шаг 5. Проверьте принтер и камеру

В разделах «Принтер» и «Камера» нажмите «Проверить». Когда включён агент, проверка идёт именно через него: сервер отправляет команду, агент «стучится» в устройство из вашей локальной сети. Это точный тест реального пути печати — тот же, по которому полетит этикетка.

Если принтер показал «Подключен» — можно печатать: попробуйте тестовую этикетку через клон ЧЗМ или напечатайте ШК в карточке заказа, ожидающего отправки.

Шаг 6. Настройте автозапуск — один раз и навсегда

Агент работает, пока запущен. Закрыли окно терминала — агент остановился, печать встала. Поэтому второй по важности шаг после установки — автозапуск при включении компьютера. Полные инструкции для всех ОС есть на странице modrob.ru/setup#agent, вот короткие варианты:

• Windows — создайте файл modrob-agent.bat со строкой запуска и добавьте его в «Планировщик заданий» (Win+R → taskschd.msc): триггер «При входе в систему», действие «Запуск программы», и включите «Перезапускать задание при сбое»;
• Linux и macOS — строка в cron через crontab -e: @reboot cd ~ && nohup bun agent.js --token ВАШ_ТОКЕН >> agent.log 2>&1 & — агент будет стартовать при каждой загрузке и писать лог в agent.log;
• для продвинутых — pm2: pm2 start agent.js --name modrob-agent -- --token ВАШ_ТОКЕН, затем pm2 save && pm2 startup. pm2 следит за процессом и перезапускает его при сбоях.

Как правильно настроить сеть — чтобы не было сюрпризов

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

Правило 1. Агент и устройства — в одной локальной сети

Компьютер с агентом должен видеть принтер и камеру напрямую. Если офис разделён на сегменты (гостевой Wi-Fi отдельно, рабочая сеть отдельно) или устройства сидят в разных VLAN — агент не достучится до принтера. Подключайте всё в одну рабочую сеть.

Правило 2. Закрепите статические IP за принтером и камерой

По умолчанию роутер раздаёт адреса по DHCP — и после перезагрузки роутера принтер может получить другой адрес. Классическая история: «всё работало месяц, а вчера печать пропала». Лечится DHCP-резервированием в настройках роутера (привяжите MAC принтера к адресу, например 192.168.1.200) или статическим IP в настройках самого устройства. Сделайте это один раз — и проблема исчезнет навсегда.

Правило 3. Не дайте компьютеру уснуть

Агент живёт в памяти компьютера. Когда Windows или macOS уходят в спящий режим, все программы останавливаются — включая агента. В настройках электропитания запретите переход в сон при питании от сети. Гаснуть может монитор — это не мешает, важно только не «засыпание» системы.

Правило 4. Кабель надёжнее Wi-Fi

Wi-Fi периодически теряет связь на секунды — агент переподключается сам, но если обрыв случится в момент печати, этикетка не уйдёт. Для компьютера с агентом идеально проводное подключение Ethernet.

Правило 5. Принтер должен быть сетевым

MODROB печатает по сети на порт 9100 — это умеют все сетевые термопринтеры (Xprinter, Godex, TSC, Zebra и другие). Подключите принтер кабелем к роутеру и укажите его IP в разделе «Принтер». Например, Xprinter XP-365B, который мы рекомендуем, имеет и USB, и LAN — для MODROB используйте LAN.

Решение проблем: разбираем все типичные ситуации

На странице инструкции есть таблица быстрых решений, а здесь разберём каждую проблему подробнее — с причинами и лечением.

Проблема 1. Жёлтая плашка «Агент не подключён»

Кабинет не видит агента. Проверяйте по порядку:

• агент вообще запущен? Выполните обе команды установки на компьютере рядом с принтером;
• не закрыли ли окно терминала? При закрытии окна агент останавливается;
• есть ли интернет на этом компьютере?
• корпоративная сеть? Разрешите исходящие подключения к modrob.ru:443 — спросите у вашего ИТ-специалиста;
• установлен ли Bun? Без него файл агента не запустится;
• только что включили переключатель? Подождите до минуты — статус обновляется раз в 30 секунд.

Проблема 2. «Ошибка авторизации» или «Токен недействителен» в окне агента

• токен скопирован не полностью — скопируйте заново кнопкой «Копировать»;
• токен перевыпускался, а агент запущен со старым — запустите с новым;
• при вставке попали лишние пробелы или перенос строки.

Хорошая новость: агент в этой ситуации не «умирает» — он повторяет попытки авторизации раз в 5 минут. Перезапустите его с корректным токеном, и всё заработает.

Проблема 3. «bun: command not found» (или «не является внутренней или внешней командой»)

• Bun не установлен — установите с bun.sh;
• Bun установлен, но терминал был открыт ещё до установки — откройте новый терминал;
• в Windows после установки может понадобиться перезапуск PowerShell.

Проблема 4. Агент подключён, но принтер оффлайн или печать не доходит

• агент и принтер в разных сетях (см. правило 1 выше);
• IP принтера сменился после перезагрузки роутера (см. правило 2) — проверьте адрес в разделе «Принтер»;
• принтер выключен, отошёл USB/LAN-кабель или «заснул» — включите и проверьте индикаторы;
• файрвол на компьютере с агентом блокирует локальные подключения к порту 9100;
• нажмите «Проверить подключение» в разделе «Принтер» — проверка через агента покажет актуальный статус.

Проблема 5. «Таймаут ответа от агента» при печати

• компьютер с агентом уснул в момент команды (см. правило 3);
• сеть мигнула в момент отправки — просто повторите печать;
• агент как раз переподключался после обрыва (пауза может доходить до 60 секунд) — через минуту всё восстановится само.

Проблема 6. Агент подключается и тут же «отваливается»

• запущено два агента с одним токеном (например, на двух компьютерах) — сервер оставляет только самое новое подключение, старое выталкивается. Один токен = один работающий агент;
• нестабильный Wi-Fi — переключитесь на кабель или убедитесь в уровне сигнала;
• если проблема повторяется регулярно, пришлите нам текст из окна агента — разберёмся.

Проблема 7. Камера оффлайн или «не определяется»

• неверный логин/пароль камеры — камера отвечает отказом доступа. Проверьте учётные данные в веб-интерфейсе самой камеры;
• камера не поддерживает ISAPI — MODROB работает с камерами Hikvision и HiWatch (протокол ISAPI); большинство бюджетных Noname-камер говорит только ONVIF и не подойдёт;
• камера в другой сети, чем компьютер с агентом (см. правило 1);
• камера доступна, но снимки не приходят — проверьте, что в кабинете указан её IP, а логин и пароль совпадают.

Проблема 8. Статус агента пропадает после закрытия окна

Так и должно быть: агент — обычная программа, работает пока запущена. Настройте автозапуск (шаг 6) — и вопрос закроется навсегда.

Чек-лист стабильной работы

• Bun установлен, bun --version отвечает номером версии;
• агент запущен, в кабинете зелёная плашка с версией;
• настроен автозапуск при включении компьютера;
• компьютер с агентом не уходит в спящий режим;
• принтер и камера закреплены за статическими IP (DHCP-резервирование в роутере);
• принтер и камера в одной локальной сети с компьютером агента;
• проверка «Принтер» и «Камера» показывает «Подключен» / «Онлайн»;
• токен никому не передавался.

Это безопасно?

• канал зашифрован (WSS/TLS) — никто в пути не видит ваши данные;
• агент принимает команды только по вашему личному токену — он есть только у вас;
• нет ни одного входящего подключения к вашей сети: агент сам выходит наружу, роутер трогать не нужно;
• агент умеет ровно четыре действия: печать на принтер, снимок с камеры и две проверки доступности. Никакого доступа к файлам и другим программам у него нет;
• токен перевыпускается в один клик — старый перестаёт работать мгновенно.

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

Можно ли поставить агента на два компьютера?

С одним токеном — нет: каждое новое подключение вытесняет предыдущее, и агенты начнут «выталкивать» друг друга. Один токен = один агент. Если нужно подключить оборудование из двух разных сетей, самый простой путь — отдельный аккаунт MODROB для второй точки.

Что произойдёт, если на складе пропадёт интернет?

Агент начнёт попытки восстановления: сначала каждые 5–10 секунд, потом пауза вырастет до минуты. Как только связь вернётся, канал восстановится сам, без вашего участия. Печать, отправленная в момент обрыва, вернётся ошибкой — повторите её после восстановления.

Нужен ли белый IP от провайдера?

Нет, с агентом не нужен. Белый IP и проброс портов требуются только для прямого подключения без агента.

На каких системах работает агент?

Windows, macOS и Linux — везде, где работает Bun. Подойдёт любой, даже старый ПК или недорогой мини-ПК: агенту нужны ~40 МБ памяти и меньше 1% процессора.

Куда писать, если не получилось?

Напишите нам на modrob@modrob.ru или в Telegram @modrob_ru — поможем настроить дистанционно, обычно за 10–15 минут.

Подведём итог

MODROB Агент — это два действия и год спокойной работы:

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

Дальше агент живёт своей жизнью: сам держит канал, сам переподключается после обрывов, сам показывает статус в кабинете. Ваша задача — раз настроить сеть по чек-листу выше (одна локальная сеть, статические IP, безо сна) и просто работать: этикетки печатаются, камера снимает, заказы собираются.

Читайте также: как проходит сборка заказа в MODROB и клон Честного знака — печать дубликата кода маркировки за 1 секунду. А справочник по оборудованию — на странице Устройства.

MODROB не требует установки: зарегистрируйтесь и собирайте первый заказ уже сегодня.