Поддерживаемое оборудование

Qarvix подключает устройства двумя способами, в зависимости от прошивки роутера. Для устройств на OpenWrt (сегодня это все линейки Teltonika) ставится собственный агент - небольшая программа, которая поднимает WireGuard-туннель и держит постоянный канал управления с контроллером. Для устройств на RouterOS (MikroTik) агента в привычном смысле нет: вместо него на роутер устанавливается скрипт RouterOS, который сам опрашивает контроллер и применяет конфигурацию. Итог для пользователя одинаковый - управляемый WireGuard-контур и доступ из панели, - но механизм и набор возможностей у двух вариантов немного отличаются.

Устройства

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

Teltonika сгруппирована по линейкам, а не по конкретным моделям: устройства одной линейки используют один и тот же SDK производителя, поэтому одна сборка агента подходит сразу всем моделям линейки. Если вашей конкретной модели нет в примере, но она относится к одной из этих линеек - агент для нее уже есть. Для MikroTik список пока короче - сегодня официально подтверждено одно устройство, подробнее об этом ниже.

Для всех перечисленных устройств уже доступно:

• подключение одним токеном через быстрое подключение устройств;
• управляемый WireGuard-туннель и маршрут к LAN-подсети за роутером;
• диагностика и журнал устройства в панели Qarvix.

Дальше набор возможностей отличается по вендору:

• Teltonika (OpenWrt) - постоянный канал управления, обновление агента по воздуху (OTA) без выезда на объект, удаленный доступ к веб-интерфейсу и SSH роутера через туннель.
• MikroTik (RouterOS) - вместо постоянного канала скрипт опрашивает контроллер каждые 30 секунд и сам обновляется по сверке версии; удаленный доступ пока только по SSH, веб-интерфейс (WebUI) через туннель еще не поддерживается.

Легковесный агент для OpenWrt

Агент Qarvix для линеек на OpenWrt линкуется только с библиотеками, которые уже есть в прошивке RutOS - libc, libuci, libubox, libopenssl3 и ca-bundle - и не приносит с собой ничего своего. Собранный пакет весит около 39-40 КБ на линейках с процессором MIPS (RUT2M, RUT9M, RUTM, TRB2M) и около 51 КБ на линейках с ARM (RUTX, TRB1) - это вес всего пакета целиком: бинарник, init-скрипт и конфиг, а не только исполняемый файл.

Это особенно важно для RUT2M, RUT9M и TRB2M: у этих линеек всего 16 МБ Flash-накопителя на всю прошивку, включая саму ОС и веб-интерфейс роутера. Агенты, построенные на более тяжелых рантаймах и приносящие с собой собственные зависимости, обычно весят десятки мегабайт - на устройстве с 16 МБ Flash для них попросту нет места.

Как MikroTik получает конфигурацию

RouterOS не дает собственному языку скриптов держать постоянное исходящее WebSocket-соединение, поэтому классический C-агент здесь не подходит. Вместо него на роутер устанавливается скрипт RouterOS: раз в 30 секунд он опрашивает контроллер и сам применяет WireGuard, маршруты и правила NAT через /interface wireguard, /ip route и /ip firewall nat. Отдельный скрипт-обновитель сверяет версию каждые 5 минут и подтягивает исправления автоматически, без переустановки и выезда на объект.

Поскольку это скрипт, а не скомпилированный под архитектуру процессора бинарник, механизм в принципе не привязан к одной модели так же жестко, как OpenWrt-агент. На реальном оборудовании сегодня подтвержден RB2011 - если у вас другое устройство на RouterOS, напишите нам, поможем проверить.

Другие устройства на OpenWrt

Агент Qarvix написан на C и создан для OpenWrt - это не привязка исключительно к Teltonika, а платформа, на которой уже работают все шесть линеек выше. Благодаря этому агент быстро собирается под новую архитектуру процессора, а поддержка нужного производителя добавляется в систему - без разработки нового протокола управления или переделки панели.

Если оборудование клиента работает на OpenWrt, но это не одна из уже поддерживаемых линеек - напишите нам и укажите модель и производителя. Мы соберем и проверим агент под ваше устройство и добавим его производителя в систему - после этого оно становится полноценно поддерживаемым, наравне с перечисленными выше линейками Teltonika. Если оборудование работает на RouterOS - смотрите вкладку MikroTik выше, там другой механизм. Список поддерживаемого оборудования будет расширяться.

Как проверить, что модель подходит

Если модель относится к одной из шести линеек Teltonika выше или это MikroTik RB2011 - можно сразу переходить к быстрому подключению устройств. Установочный скрипт сам определяет модель и не требует ручного выбора сборки.

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

Связанные разделы

• Быстрое подключение устройств - как поставить агент на поддерживаемую модель.
• Устройства и VPN-адреса - чем управляемое устройство отличается от статического клиента.
• Диагностика и типовые проблемы - что проверять, если устройство не подключается.