Packages на MikroTik — управление пакетами RouterOS

Управление пакетами RouterOS — установка, обновление, удаление

RouterOS — модульная операционная система. Её функциональность разделена на пакеты: базовый routeros есть всегда, а дополнительные пакеты (wifi-qcom, container, iot, zerotier и другие) устанавливаются по необходимости. Это позволяет экономить ресурсы на устройствах с ограниченной памятью и уменьшает поверхность атаки — установлено только то, что реально используется.

В этом руководстве разберём полный жизненный цикл пакетов: просмотр установленных, определение архитектуры устройства, установку дополнительных пакетов, обновление, даунгрейд и удаление. Все команды для RouterOS 7.20+.

Описание

Что такое пакет RouterOS

Пакет (.npk файл) — это модуль RouterOS, содержащий определённую функциональность. Каждый пакет собран под конкретную аппаратную архитектуру (arm, arm64, mipsbe, x86 и др.) и версию RouterOS. Нельзя установить пакет от другой версии или архитектуры — система откажет при загрузке.

Основной пакет

Пакет routeros — ядро системы. Он всегда установлен и содержит: маршрутизацию, firewall, NAT, DHCP, DNS, bridge, VLAN, WireGuard, PPP/PPPoE, очереди (QoS), scripting, SNMP, Netwatch и большинство функций, необходимых для типовой настройки. Удалить его нельзя.

Дополнительные пакеты

Архитектуры устройств

Каждое устройство MikroTik работает на определённой процессорной архитектуре. Пакеты строго привязаны к архитектуре — нельзя установить arm-пакет на mipsbe-устройство.

Важно: модели на mipsbe и mmips — устаревающие платформы. MikroTik активно развивает arm64-устройства. При покупке нового оборудования выбирайте arm64, если нет специфических требований.

Настройка

Просмотр установленных пакетов

[admin@MikroTik] >
Копировать
/system/package/print

Пример вывода:

code
Копировать
Columns: NAME, VERSION, BUILD-TIME, SCHEDULED
#  NAME        VERSION    BUILD-TIME           SCHEDULED
0  routeros    7.20       2025-01-15 08:30:00
1  wifi-qcom   7.20       2025-01-15 08:30:00

Здесь видно, что установлены два пакета: базовый routeros и драйвер Wi-Fi wifi-qcom. Версия обоих — 7.20. Столбец SCHEDULED показывает запланированные действия (установка, удаление, даунгрейд), которые выполнятся после перезагрузки.

Определение архитектуры устройства

Прежде чем скачивать дополнительные пакеты, определите архитектуру:

[admin@MikroTik] >
Копировать
/system/resource/print

В выводе найдите строку architecture-name — это и есть нужная архитектура. Например: architecture-name: arm64.

Также полезно:

[admin@MikroTik] >
Копировать
# Модель устройства
/system/routerboard/print

# Текущая версия RouterOS
/system/package/update/print

Скачивание пакетов

Пакеты скачиваются с официального сайта MikroTik: mikrotik.com/download. Выберите версию RouterOS, соответствующую установленной, и нужную архитектуру. Пакеты доступны в двух вариантах:

• Extra packages — ZIP-архив со всеми дополнительными пакетами для данной архитектуры.
• Отдельные .npk файлы — можно скачать конкретный пакет.

Внимание: версия пакета должна точно совпадать с версией установленного routeros. Если у вас RouterOS 7.20, скачивайте пакеты именно версии 7.20.

Установка дополнительного пакета

Процесс установки пакета состоит из трёх шагов: загрузка файла на роутер, проверка и перезагрузка.

Способ 1: Через WinBox (drag & drop)

1. Скачайте нужный .npk файл на компьютер.
2. Откройте WinBox, перейдите в Files.
3. Перетащите .npk файл из проводника в окно Files.
4. Перезагрузите роутер — пакет установится автоматически.

Способ 2: Через FTP/SFTP

[admin@MikroTik] >
Копировать
# С компьютера (Linux/macOS):
# sftp admin@192.168.88.1
# put container-7.20-arm64.npk
# exit

# Проверяем, что файл загружен
/file/print where name~"npk"

Способ 3: Скачивание прямо на роутер (fetch)

Если роутер имеет доступ в интернет, можно скачать пакет напрямую:

[admin@MikroTik] >
Копировать
/tool/fetch url="https://download.mikrotik.com/routeros/7.20/container-7.20-arm64.npk" \
  dst-path=container-7.20-arm64.npk

После загрузки файла — перезагрузка:

[admin@MikroTik] >
Копировать
/system/reboot

После перезагрузки проверьте, что пакет появился в списке:

[admin@MikroTik] >
Копировать
/system/package/print

Если файл .npk был некорректным (не та версия, не та архитектура, повреждён), роутер проигнорирует его при загрузке, и пакет не появится. Проверьте логи:

[admin@MikroTik] >
Копировать
/log/print where topics~"system"

Обновление RouterOS

RouterOS поддерживает обновление «по воздуху» — проверка новых версий и загрузка прямо с серверов MikroTik.

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

Выбор канала и проверка обновлений

[admin@MikroTik] >
Копировать
# Установить канал обновления
/system/package/update/set channel=long-term

# Проверить наличие обновлений
/system/package/update/check-for-updates

Вывод покажет текущую и доступную версии:

code
Копировать
channel: long-term
installed-version: 7.20
latest-version: 7.21
status: New version is available

Установка обновления

[admin@MikroTik] >
Копировать
/system/package/update/install

Роутер скачает обновление и автоматически перезагрузится. Процесс занимает 1-5 минут в зависимости от устройства и скорости интернета.

Внимание: во время обновления не отключайте питание! Это может привести к повреждению RouterOS и необходимости восстановления через Netinstall.

Обновление firmware (routerboard)

После обновления RouterOS проверьте версию firmware:

[admin@MikroTik] >
Копировать
/system/routerboard/print

Если current-firmware отличается от upgrade-firmware, обновите загрузчик:

[admin@MikroTik] >
Копировать
/system/routerboard/upgrade
/system/reboot

Автоматическое обновление по расписанию

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

[admin@MikroTik] >
Копировать
/system/scheduler/add name=auto-update interval=1d on-event={
  /system/package/update/check-for-updates once
  :delay 30s
  :if ([/system/package/update/get status] = "New version is available") do={
    :local current [/system/package/update/get installed-version]
    :local latest [/system/package/update/get latest-version]
    :log warning "RouterOS update available: $current -> $latest, installing..."
    /system/package/update/install
  }
}

Осторожно: автоматические обновления подходят не для всех сценариев. В production-сетях рекомендуется сначала тестировать обновление на одном устройстве, а затем раскатывать на остальные.

Даунгрейд (откат на предыдущую версию)

Иногда новая версия RouterOS содержит регрессии или несовместимости. В таком случае можно откатиться на предыдущую версию.

Процедура даунгрейда

1. Скачайте .npk файл нужной (более старой) версии RouterOS с mikrotik.com/download/archive.
2. Загрузите файл на роутер (через WinBox Files, SFTP или fetch).
3. Перезагрузите роутер.

[admin@MikroTik] >
Копировать
# Скачать старую версию напрямую на роутер
/tool/fetch url="https://download.mikrotik.com/routeros/7.18/routeros-7.18-arm64.npk" \
  dst-path=routeros-7.18-arm64.npk

# Перезагрузить для применения
/system/reboot

Важно: при даунгрейде конфигурация может содержать параметры, отсутствующие в старой версии. RouterOS попытается загрузить конфигурацию, но некоторые настройки могут быть потеряны. Всегда делайте бэкап перед даунгрейдом.

Даунгрейд через пакетный менеджер (альтернативный способ)

[admin@MikroTik] >
Копировать
/system/package/downgrade

Эта команда откатит RouterOS до версии ранее загруженного .npk файла. Роутер перезагрузится автоматически.

Не забудьте после даунгрейда обновить firmware:

[admin@MikroTik] >
Копировать
/system/routerboard/upgrade
/system/reboot

Удаление (деинсталляция) пакета

Удалить можно только дополнительные пакеты. Базовый пакет routeros удалить нельзя.

[admin@MikroTik] >
Копировать
# Пометить пакет для удаления
/system/package/uninstall [find name=zerotier]

# Проверить — в столбце SCHEDULED должно быть "scheduled for removal"
/system/package/print

# Применить — перезагрузить роутер
/system/reboot

После перезагрузки пакет исчезнет из списка, а связанные с ним меню и команды станут недоступны.

Если вы передумали до перезагрузки, отмените запланированное удаление:

[admin@MikroTik] >
Копировать
/system/package/unschedule [find name=zerotier]

Отключение пакета без удаления

Если нужно временно отключить функциональность пакета, не удаляя его:

[admin@MikroTik] >
Копировать
# Отключить пакет
/system/package/disable [find name=wireless]

# Включить обратно
/system/package/enable [find name=wireless]

# В обоих случаях — перезагрузка для применения
/system/reboot

Отключённый пакет остаётся на устройстве, но его функции недоступны. Это полезно для диагностики — определить, какой именно пакет вызывает проблему.

Установка нескольких пакетов одновременно

Если нужно установить сразу несколько дополнительных пакетов, загрузите все .npk файлы на роутер перед перезагрузкой. RouterOS обработает их все за одну перезагрузку:

[admin@MikroTik] >
Копировать
# Скачать несколько пакетов
/tool/fetch url="https://download.mikrotik.com/routeros/7.20/container-7.20-arm64.npk" \
  dst-path=container-7.20-arm64.npk
/tool/fetch url="https://download.mikrotik.com/routeros/7.20/iot-7.20-arm64.npk" \
  dst-path=iot-7.20-arm64.npk
/tool/fetch url="https://download.mikrotik.com/routeros/7.20/zerotier-7.20-arm64.npk" \
  dst-path=zerotier-7.20-arm64.npk

# Проверить, что все файлы загружены
/file/print where name~"npk"

# Одна перезагрузка установит все пакеты
/system/reboot

Рекомендации по выбору пакетов для типовых сценариев

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

Домашний роутер / SOHO: Обычно достаточно базового routeros и Wi-Fi пакета, который уже установлен из коробки. Дополнительные пакеты не нужны.

Офисный шлюз без Wi-Fi (RB5009, CCR): Только routeros. Если используется UPS для мониторинга питания — добавьте ups. Для внешнего хранилища — rose-storage.

IoT-шлюз (KNOT, LtAP): Базовый routeros, пакет iot (BLE, MQTT, GPIO), при необходимости gps для определения местоположения.

VPN-концентратор с контейнерами: Пакет routeros + container. Контейнеры требуют ARM или ARM64 устройство с достаточным объёмом RAM (минимум 256 МБ, рекомендуется 1 ГБ) и внешнее хранилище (USB или SATA) для образов.

Оператор связи / ISP: Пакет routeros + user-manager (RADIUS для PPPoE/Hotspot) + tr069-client (удалённое управление CPE).

Проверка

Проверка установленных пакетов

[admin@MikroTik] >
Копировать
/system/package/print

Убедитесь, что:

• Все нужные пакеты в статусе без пометок в столбце SCHEDULED.
• Версии всех пакетов совпадают — нельзя, чтобы routeros был 7.20, а wifi-qcom — 7.18.
• Нет лишних пакетов, которые вы не используете.

Проверка версии и канала

[admin@MikroTik] >
Копировать
/system/package/update/print

Убедитесь, что channel соответствует вашей политике обновлений.

Проверка firmware

[admin@MikroTik] >
Копировать
/system/routerboard/print

Поля current-firmware и upgrade-firmware должны совпадать. Если нет — выполните /system/routerboard/upgrade и перезагрузитесь.

Проверка свободного места

Перед установкой пакетов убедитесь, что на устройстве достаточно места:

[admin@MikroTik] >
Копировать
/system/resource/print

Обратите внимание на free-hdd-space. Для большинства пакетов достаточно 2-5 МБ, но container может потребовать значительно больше места.

Проверка логов после обновления

[admin@MikroTik] >
Копировать
/log/print where topics~"system" or topics~"critical"

Ищите сообщения об ошибках загрузки пакетов, несовместимости или повреждении файлов.

Проверка целостности загруженных файлов

Перед перезагрузкой убедитесь, что загруженные .npk файлы не повреждены:

[admin@MikroTik] >
Копировать
/file/print where name~"npk"

Обратите внимание на размер файлов — если файл подозрительно мал (менее 100 КБ), он скорее всего повреждён или скачался не полностью. Удалите его и скачайте заново:

[admin@MikroTik] >
Копировать
/file/remove [find name~"npk" and size<100000]

Сравнение версий после обновления

После обновления убедитесь, что все компоненты обновлены до одной версии:

[admin@MikroTik] >
Копировать
# Версия RouterOS
/system/package/print

# Версия firmware
/system/routerboard/print

# Версия ядра системы
/system/resource/print

Все три значения (package version, current-firmware, version в resource) должны совпадать. Если firmware отстаёт — выполните /system/routerboard/upgrade и перезагрузитесь.

Типичные ошибки

1. Несовпадение версий пакета и RouterOS

Проблема: загрузили пакет container-7.18-arm64.npk на роутер с RouterOS 7.20. После перезагрузки пакет не установился.

Решение: всегда скачивайте пакеты той же версии, что и установленный routeros. Проверьте текущую версию:

[admin@MikroTik] >
Копировать
/system/package/print
# Запомните VERSION и скачайте пакет именно этой версии

2. Неправильная архитектура пакета

Проблема: скачали пакет для arm, а устройство arm64 (или наоборот). Пакет не устанавливается после перезагрузки.

Решение: определите архитектуру устройства перед скачиванием:

[admin@MikroTik] >
Копировать
/system/resource/print
# architecture-name: arm64  <- эту архитектуру использовать для скачивания

3. Обновление прерывается из-за нехватки места

Проблема: устройства с 16 МБ flash (hAP lite, hAP mini) могут не иметь достаточно места для скачивания обновления.

Решение: удалите ненужные файлы, бэкапы и логи:

[admin@MikroTik] >
Копировать
# Просмотр файлов
/file/print

# Удаление ненужных файлов
/file/remove [find name~"backup"]
/file/remove [find name~"supout"]

Если места по-прежнему мало — обновите через Netinstall (минуя файловую систему).

4. Потеря связи во время обновления

Проблема: отключилось питание или пропал интернет во время скачивания/установки обновления. Роутер не загружается.

Решение: восстановите устройство через Netinstall:

1. Скачайте Netinstall с mikrotik.com/download.
2. Подключите роутер кабелем к компьютеру.
3. Загрузите роутер в режим восстановления (зажать кнопку Reset при включении).
4. Netinstall обнаружит устройство и позволит переустановить RouterOS.

5. Автообновление сломало production-сеть

Проблема: настроили автоматическое обновление, новая версия содержит баг, все роутеры обновились одновременно.

Решение: никогда не включайте автообновление на всех устройствах сразу. Используйте стратегию поэтапного обновления (canary deployment):

1. Обновите один тестовый роутер вручную.
2. Подождите 3-7 дней, убедитесь в стабильности.
3. Обновите 10-20% устройств.
4. После подтверждения — обновите остальные.

Для канала обновления в production используйте long-term, а не stable.

6. Не обновили firmware после обновления RouterOS

Проблема: RouterOS обновлена до 7.20, но firmware осталась от 7.16. Это может вызывать нестабильную работу, особенно Wi-Fi и Ethernet.

Решение: после каждого обновления RouterOS проверяйте и обновляйте firmware:

[admin@MikroTik] >
Копировать
/system/routerboard/print
# current-firmware: 7.16
# upgrade-firmware: 7.20  <- версии отличаются, нужно обновить

/system/routerboard/upgrade
/system/reboot

7. Путаница между wifi-qcom, wifi-qcom-ac и wireless

Проблема: не понимаю, какой Wi-Fi пакет нужен для моего устройства.

Решение:

Если вы не уверены — посмотрите, какой пакет установлен из коробки на вашем устройстве. Именно он и нужен. Не устанавливайте wireless на устройство с wifi-qcom — это разные драйверы для разных чипов.

/system/package/print
Columns: NAME, VERSION, BUILD-TIME, SCHEDULED
#  NAME        VERSION    BUILD-TIME           SCHEDULED
0  routeros    7.20       2025-01-15 08:30:00
1  wifi-qcom   7.20       2025-01-15 08:30:00
/system/resource/print
# Модель устройства
/system/routerboard/print

# Текущая версия RouterOS
/system/package/update/print
# С компьютера (Linux/macOS):
# sftp admin@192.168.88.1
# put container-7.20-arm64.npk
# exit

# Проверяем, что файл загружен
/file/print where name~"npk"
/tool/fetch url="https://download.mikrotik.com/routeros/7.20/container-7.20-arm64.npk" \
  dst-path=container-7.20-arm64.npk
/system/reboot
/system/package/print
/log/print where topics~"system"
# Установить канал обновления
/system/package/update/set channel=long-term

# Проверить наличие обновлений
/system/package/update/check-for-updates
channel: long-term
installed-version: 7.20
latest-version: 7.21
status: New version is available
/system/package/update/install
/system/routerboard/print
/system/routerboard/upgrade
/system/reboot
/system/scheduler/add name=auto-update interval=1d on-event={
  /system/package/update/check-for-updates once
  :delay 30s
  :if ([/system/package/update/get status] = "New version is available") do={
    :local current [/system/package/update/get installed-version]
    :local latest [/system/package/update/get latest-version]
    :log warning "RouterOS update available: $current -> $latest, installing..."
    /system/package/update/install
  }
}
# Скачать старую версию напрямую на роутер
/tool/fetch url="https://download.mikrotik.com/routeros/7.18/routeros-7.18-arm64.npk" \
  dst-path=routeros-7.18-arm64.npk

# Перезагрузить для применения
/system/reboot
/system/package/downgrade
/system/routerboard/upgrade
/system/reboot
# Пометить пакет для удаления
/system/package/uninstall [find name=zerotier]

# Проверить — в столбце SCHEDULED должно быть "scheduled for removal"
/system/package/print

# Применить — перезагрузить роутер
/system/reboot
/system/package/unschedule [find name=zerotier]
# Отключить пакет
/system/package/disable [find name=wireless]

# Включить обратно
/system/package/enable [find name=wireless]

# В обоих случаях — перезагрузка для применения
/system/reboot
# Скачать несколько пакетов
/tool/fetch url="https://download.mikrotik.com/routeros/7.20/container-7.20-arm64.npk" \
  dst-path=container-7.20-arm64.npk
/tool/fetch url="https://download.mikrotik.com/routeros/7.20/iot-7.20-arm64.npk" \
  dst-path=iot-7.20-arm64.npk
/tool/fetch url="https://download.mikrotik.com/routeros/7.20/zerotier-7.20-arm64.npk" \
  dst-path=zerotier-7.20-arm64.npk

# Проверить, что все файлы загружены
/file/print where name~"npk"

# Одна перезагрузка установит все пакеты
/system/reboot
/system/package/print
/system/package/update/print
/system/routerboard/print
/system/resource/print
/log/print where topics~"system" or topics~"critical"
/file/print where name~"npk"
/file/remove [find name~"npk" and size<100000]
# Версия RouterOS
/system/package/print

# Версия firmware
/system/routerboard/print

# Версия ядра системы
/system/resource/print
/system/package/print
# Запомните VERSION и скачайте пакет именно этой версии
/system/resource/print
# architecture-name: arm64  <- эту архитектуру использовать для скачивания
# Просмотр файлов
/file/print

# Удаление ненужных файлов
/file/remove [find name~"backup"]
/file/remove [find name~"supout"]
/system/routerboard/print
# current-firmware: 7.16
# upgrade-firmware: 7.20  <- версии отличаются, нужно обновить

/system/routerboard/upgrade
/system/reboot