basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    ОбзорHomelabMikroTik

    RouterOS 7: как устроена система роутера MikroTik

    RouterOS — система на ядре Linux, одна для всех устройств MikroTik. Конфиг в ней — дерево меню, которое меняют команды. /export выводит его целиком одним текстом: это и копия, и способ сравнить, что поменялось. Обновления приходят по каналам stable и long-term, отдельные функции ставятся пакетами, а опасные с RouterOS 7.17 закрыты режимом device-mode: включаются они только нажатием кнопки на самом роутере.

    Что внутри

    RouterOS 7 работает на ядре Linux, но Linux снаружи не виден: оболочки bash нет, файлы системы закрыты, всё делается командами самой RouterOS. Система состоит из главного пакета routeros и дополнительных:

    Пакет Что добавляет
    wifi-qcom драйвер Wi-Fi 6 и новее для чипов Qualcomm: hAP ax², ax³, cAP ax
    wifi-qcom-ac новый драйвер для Wi-Fi 5 на ARM: hAP ac², ac³, cAP ac
    wireless старый драйвер, для моделей Wi-Fi 4 и Wi-Fi 5 на MIPS
    container запуск образов Docker
    iot Bluetooth, LoRa, MQTT
    user-manager свой RADIUS-сервер
    rose-storage диски, RAID, общие папки по SMB и NFS

    Что стоит сейчас — /system package print. Дополнительный пакет с 7.18 ставится из меню: раздел System, Packages: Check For Updates, у нужного пакета Enable, затем Apply Changes — роутер скачает его и перезагрузится. Без интернета на роутере пакет кладём в Files и перезагружаем: версия пакета должна совпадать с версией RouterOS, архитектура — с роутером (/system resource print, строка architecture-name).

    Каналы обновлений

    /system package update print
    #          channel: stable
    #  installed-version: 7.24.5
    #     latest-version: 7.24.5
    #             status: System is already up to date
    Канал Что в нём Версия на 19.10.2026
    stable новые функции и исправления; новая минорная версия — раз в 2–4 месяца 7.24.5 (1 октября)
    long-term только исправления в одной ветке, функции не меняются 7.23.8 (9 октября)
    testing беты и кандидаты следующей версии 7.25rc
    development сборки разработчиков —

    Ветка 6 жива для старых устройств: 6.49.23 вышла 9 октября 2026-го, с теми же исправлениями безопасности.

    Для домашнего роутера, который не хочется трогать, — long-term: обновление в ней только чинит. На stable каждая минорная версия может что-то поменять: в 7.13 Wi-Fi переехал в новый пакет, в 7.17 появился device-mode. Канал меняется одной командой: /system package update set channel=long-term.

    Обновление ставится в два шага: check-for-updates и install, роутер скачивает пакеты и перезагружается. После него отдельно обновляем загрузчик RouterBOOT («Обновление RouterBOOT»).

    device-mode: опасные функции под кнопкой

    С RouterOS 7.17 у роутера есть режим, который выключает функции, полезные взломщику. Режим нельзя сменить удалённо: после команды нужно в течение 5 минут нажать кнопку reset или выключить и включить питание. Чужой с паролем администратора, сидящий в интернете, этого не сделает.

    Режим Где по умолчанию Что выключено
    home домашние роутеры планировщик, fetch, сниффер, bandwidth-test, SOCKS и прокси, хотспот, почта, RoMON, контейнеры и ещё несколько функций
    basic остальные устройства bandwidth-test, контейнеры, хотспот, прокси, SOCKS, генератор трафика
    advanced CCR и RB1100 контейнеры, генератор трафика, разделы, установка любой версии

    Список — по таблице на странице Device-mode документации. Какой режим у конкретной модели с завода — /system/device-mode/print1.

    /system/device-mode/print
    /system/device-mode/update container=yes
    # update: please activate by turning off power or pressing reset or mode button in 5m00s

    mode= в команде заменяет весь набор: update mode=advanced сбросит включённые по одной функции, поэтому нужные дописываем в ту же команду — update mode=advanced container=yes. Попыток три, счётчик сбрасывает перезагрузка по питанию.

    Если при загрузке RouterOS находит в конфиге следы взлома (чужие скрипты, планировщик, пользователей), она выключает подозрительное и ставит flagged=yes. Снять флаг — тоже с кнопкой, но сначала разбираем конфиг и меняем пароли.

    Лицензия

    У роутеров лицензия встроена, уровень зависит от модели: 4 у hAP ax² и hEX, 5 у RB5009 и L009, 6 у hAP ax³ и CCR. Уровни отличаются лимитами, которые дома не встречаются, — например числом пользователей хотспота.

    Отдельно — CHR, RouterOS как виртуальная машина для Proxmox, VMware, VirtualBox или облака. Без лицензии она работает без срока, но со скоростью 1 Мбит/с на интерфейс: для опытов и учёбы хватает. Платные уровни p1, p10 и unlimited снимают ограничение до 1 Гбит/с, 10 Гбит/с и без предела; пробный период — 60 дней.

    Чем подключаться

    Средство Как Что учесть
    Winbox 4 программа для Windows, macOS, Linux; порт 8291 подключается и по MAC-адресу, без IP — так спасают роутер с испорченными адресами
    WebFig браузер, http://192.168.88.1 то же меню, что в Winbox; здесь же Quick Set
    SSH ssh [email protected] вход по ключу — /user ssh-keys import («Ключи SSH»)
    REST API https://192.168.88.1/rest/…, служба www-ssl JSON по HTTP: для своих скриптов и мониторинга
    приложение MikroTik iOS и Android Quick Set и основные настройки с телефона

    Все средства меняют одно и то же: правка в Winbox сразу видна в командной строке и в /export.

    Командная строка

    Меню RouterOS — дерево: /ip firewall filter — правила фаервола, /interface bridge port — порты бриджа. Внутри любой ветки работают одни и те же команды: print, add, set, remove, enable, disable, export.

    /ip address print
    # Columns: ADDRESS, NETWORK, INTERFACE
    # #   ADDRESS            NETWORK       INTERFACE
    # 0   192.168.88.1/24    192.168.88.0  bridge
    
    /ip dhcp-server lease print where status=bound
    /interface print where running
    /ip firewall filter set [find comment="defconf: drop invalid"] log=yes
    • Tab дописывает команду и параметр, двойной Tab показывает варианты, ? — справку по месту.
    • where фильтрует вывод, [find …] находит записи для set и remove по условию, а не по номеру: номера в print меняются после каждого add.
    • /export печатает только то, что отличается от заводских значений; /export verbose — всё, /export show-sensitive — вместе с паролями («Копия конфига MikroTik»).
    • Ctrl+X — Safe Mode («Safe Mode»).

    Скрипты и расписание

    У RouterOS свой язык скриптов: :local, :if, :foreach, :delay. Пример — раз в день проверять обновление и писать в лог, если оно вышло. Сам скрипт ничего не ставит: обновление с перезагрузкой в 4 утра без присмотра — это риск остаться без сети до вечера.

    /system script add name=check-update policy=read,write,test source={
      /system package update check-for-updates once
      :delay 10s
      :if ([/system package update get status] = "New version is available") do={
        :log warning ("RouterOS: new version " . [/system package update get latest-version])
      }
    }
    /system scheduler add name=check-update interval=1d start-time=09:00:00 \
        on-event=check-update policy=read,write,test

    В скриптах, именах и комментариях пишем латиницей: UTF-8 RouterOS поддерживает не полностью, и кириллица в логе и терминале превращается в нечитаемые символы, а в /export — в коды вида \D0\B2.

    По таблице device-mode в режиме home планировщик выключен — там такой скрипт по расписанию не запустится, нужен режим basic или advanced. Уведомление в Telegram или на почту делают через /tool fetch и /tool e-mail — они в home тоже выключены.

    Контейнеры

    На роутерах с ARM, ARM64 и x86 RouterOS запускает образы Docker. Дома так ставят AdGuard Home или Pi-hole прямо на роутер. Что нужно:

    • пакет container и container=yes в device-mode — с нажатием кнопки;
    • место для образов: своих 128 МБ у hAP не хватит, нужна флешка или SSD в USB, у RB5009 — 1 ГБ своей памяти;
    • образ под архитектуру роутера: arm64 для hAP ax и RB5009, arm (v7) для 32-битных моделей;
    • память: у hAP ax³ и RB5009 — 1 ГБ на всё, у hEX — 512 МБ.
    /interface veth add name=veth-adguard address=172.17.0.2/24 gateway=172.17.0.1
    /interface bridge add name=containers
    /ip address add address=172.17.0.1/24 interface=containers
    /interface bridge port add bridge=containers interface=veth-adguard
    /container config set registry-url=https://registry-1.docker.io tmpdir=usb1/tmp
    /container add remote-image=adguard/adguardhome:latest interface=veth-adguard \
        root-dir=usb1/adguard logging=yes
    /container start [find]

    Контейнер получает свой адрес 172.17.0.2 в отдельном бридже. В интернет он выходит через стандартный masquerade, а компьютерам дома в DHCP отдаём DNS 172.17.0.22.

    Если не работает

    /container add отвечает not allowed by device-mode

    Причина
    С RouterOS 7.17 контейнеры выключены в любом режиме device-mode, пока их не включили отдельно.
    Делаем
    /system/device-mode/update container=yes и в течение 5 минут — короткое нажатие reset или выключение питания. Роутер перезагрузится с включённой функцией.

    Положили пакет container в Files, перезагрузили — пакета нет

    Причина
    Версия дополнительного пакета не совпадает с версией RouterOS или архитектура не та: для hAP ax нужен arm64, для hEX refresh — arm.
    Делаем
    /system resource print показывает version и architecture-name; качаем архив Extra packages ровно этой версии и архитектуры.

    Команда из статьи не работает: bad command name wireless или expected end of command

    Причина
    Статья про RouterOS 6. В седьмой Wi-Fi переехал в /interface wifi, маршрутизация переписана целиком: /routing filter стал /routing filter rule, OSPF и BGP — с другими командами.
    Делаем
    Ищем в help.mikrotik.com — там документация по седьмой версии. Если статья без даты, смотрим на команды: /interface wireless и /ip route rule выдают шестую.

    Скрипт по расписанию не запускается, в логе тишина

    Причина
    В режиме device-mode home выключены scheduler и fetch, а с ними container, sniffer, bandwidth-test и ещё десяток функций. Или у скрипта нет прав: в policy планировщика не хватает read, write, test.
    Делаем
    /system/device-mode/print — какой режим и что выключено. Права — /system scheduler set check-update policy=read,write,test.

    Winbox не видит роутер во вкладке Neighbors

    Причина
    Соседей находит протокол MNDP, а он работает только внутри одного сегмента и, по стандартному конфигу, только на интерфейсах из списка LAN.
    Делаем
    Подключаемся по адресу 192.168.88.1. Не видно и по адресу — подключаемся по MAC из той же сети: Winbox по MAC идёт мимо IP.

    Ещё не проверено

    1. какой device-mode у hAP ax² с завода и что из списка в нём выключено на деле ↑
    2. пути usb1/ и образ adguard/adguardhome на hAP ax³ с флешкой ↑