Навыки routeros-netinstall
📦

routeros-netinstall

Безопасно

Установка и управление устройствами RouterOS с помощью netinstall

Прошивка устройств MikroTik RouterOS требует понимания BOOTP, TFTP, управления пакетами и скриптования. Этот навык предоставляет полную справочную документацию по netinstall-cli с шаблонами автоматизации для установки на одно и несколько устройств.

Поддерживает: Claude Codex Code(CC)
🥉 72 Бронза
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

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

Использование «routeros-netinstall». Установить RouterOS 7.22 с пакетами container и WiFi на устройство с архитектурой ARM64 через eth0.

Ожидаемый результат:

  • Выполните: sudo netinstall-cli -r -b -i eth0 routeros-7.22-arm64.npk container-7.22-arm64.npk wifi-qcom-7.22-arm64.npk
  • Убедитесь, что устройство находится в режиме etherboot (удерживайте кнопку сброса при включении питания, пока оно не появится в netinstall).
  • Системный пакет (routeros-*.npk) должен быть указан первым в команде.

Использование «routeros-netinstall». Как войти в режим etherboot с помощью CLI RouterOS?

Ожидаемый результат:

  • Выполните эту команду в CLI RouterOS: /system/routerboard/settings/set boot-device=try-ethernet-once-then-nand
  • Затем перезагрузите устройство. Оно попытается загрузиться по Ethernet один раз, прежде чем вернуться к NAND.
  • После завершения netinstall настройка устройства загрузки вернётся к норме.

Аудит безопасности

Безопасно
v2 • 4/16/2026

This skill is a documentation-only SKILL.md file (252 lines) describing MikroTik RouterOS netinstall-cli usage. The static analyzer flagged 124 patterns, but all are false positives from misinterpreting markdown formatting. Backtick-enclosed text (e.g., `netinstall-cli`) is markdown inline code formatting, not Ruby/shell execution. Sudo references, shell command substitution examples, and network URLs appear in documented code examples and reference links. The file contains no executable code, no secrets, and no malicious patterns. Safe for publication.

1
Просканировано файлов
252
Проанализировано строк
0
находки
2
Всего аудитов
Проблем безопасности не найдено

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
32
Сообщество
100
Безопасность
100
Соответствие спецификации

Что вы можете построить

Сетевой администратор, развёртывающий RouterOS в масштабе

Используйте шаблоны автоматизации netinstall для одновременной прошивки нескольких устройств RouterOS в лабораторной или производственной среде. Обратитесь к циклу службы установки для нескольких устройств с флагами -m -o для эффективного массового конфигурирования.

DevOps-инженер, создающий CI/CD конвейеры для RouterOS

Интегрируйте netinstall-cli в контейнеризированные сборочные конвейеры для автоматизированного тестирования RouterOS. Обратитесь к шаблону контейнеризированного netinstall с сетевым подключением VETH и настройкой переменных окружения.

Техник, восстанавливающий «окирпиченные» устройства RouterOS

Следуйте процедурам входа в etherboot и инструкциям по установке на одно устройство для восстановления устройств с неудавшимися обновлениями прошивки или повреждёнными конфигурациями. Используйте шаблон конфигурационного скрипта для пользовательских настроек по умолчанию.

Попробуйте эти промпты

Базовая конструкция команды netinstall
Мне нужно установить RouterOS 7.22 на устройство MikroTik с архитектурой ARM64. Постройте команду netinstall-cli с параметрами переустановки по умолчанию и удаления пакета брендирования на интерфейсе eth0.
Modescript для конфигурации в режиме устройства
Напишите modescript, который включает расширенный режим с поддержкой контейнера и zerotier, затем покажите команду netinstall-cli для его применения при первой загрузке.
Кроссплатформенный netinstall на хосте ARM
У меня есть ARM64 Linux-сервер, и мне нужно запустить netinstall-cli. Объясните настройку QEMU в пользовательском режиме и покажите, как автоматически определить правильный двоичный файл QEMU для прозрачного выполнения.
Контейнеризированная служба netinstall на RouterOS
Настройте netinstall-cli как контейнер RouterOS, который автоматически устанавливает RouterOS на устройства, подключающиеся к локальной сети. Настройте контейнер с сетевым подключением VETH, архитектурой arm64, стабильным каналом и пакетами container и wifi.

Лучшие практики

  • Всегда указывайте системный пакет (routeros-VER-ARCH.npk) первым в списке пакетов netinstall-cli, чтобы обеспечить правильный порядок установки.
  • Используйте выделенный сетевой интерфейс или коммутатор без других DHCP-источников, чтобы избежать конфликтов BOOTP во время обнаружения устройств etherboot.
  • Применяйте логику повторных попыток DNS (5 попыток с задержкой 2 секунды) при запуске netinstall в контейнерах во время загрузки, поскольку DNS может быть недоступен сразу.

Избегать

  • Не комбинируйте флаги -r (переустановка с настройками по умолчанию) и -e (переустановка с пустой конфигурацией). Они являются взаимоисключающими и приводят к неопределённому поведению.
  • Избегайте прямого подключения USB-Ethernet адаптеров между хостом и устройством. Прерывания связи с USB-адаптеров могут препятствовать обнаружению устройства. Используйте коммутатор в качестве посредника.
  • Не запускайте netinstall-cli в сетях с активными DHCP-серверами без изоляции. BOOTP использует те же порты, что и DHCP, что вызовет конфликты адресов.

Часто задаваемые вопросы

В чём разница между netinstall и netinstall-cli?
Netinstall — это графическое приложение для Windows. Netinstall-cli — это инструмент командной строки для Linux, распространяемый как x86 ELF двоичный файл. Оба выполняют одну и ту же функцию установки RouterOS по Ethernet с использованием протоколов BOOTP и TFTP.
Почему netinstall-cli требует привилегий root или sudo?
Netinstall-cli использует BOOTP на портах 67/68 и TFTP на порту 69. Это привилегированные порты ниже 1024, которые требуют прав root в системах Linux. Инструмент также выполняет низкоуровневые сетевые операции для обнаружения устройств.
Можно ли запустить netinstall-cli на Mac или ARM Linux?
На x86_64 Linux netinstall-cli работает нативно. На ARM/ARM64 Linux используйте эмуляцию QEMU в пользовательском режиме с qemu-i386-static или qemu-i386. На macOS требуется полная виртуальная машина QEMU с сетевым мостом, поскольку эмуляция QEMU в пользовательском режиме работает только в Linux.
В чём разница между конфигурационным скриптом и mode-скриптом?
Конфигурационный скрипт (флаг -s) выполняется после применения конфигурации по умолчанию и сохраняется при обновлениях до повторной переустановки через netinstall. Mode-скрипт (флаг -sm, RouterOS 7.22+) выполняется один раз при первой загрузке перед другими скриптами и автоматически удаляется после выполнения. Mode-скрипты идеальны для начальной настройки режима устройства.
Как войти в режим etherboot на устройстве MikroTik?
Существует четыре метода: удерживайте кнопку сброса при включении питания, пока устройство не появится в netinstall; нажмите Ctrl+E во время загрузки через последовательную консоль; установите boot-device в try-ethernet-once-then-nand через CLI RouterOS и перезагрузите; или используйте метод защищённого загрузчика, если он был предварительно настроен.
Где скачать файлы пакетов RouterOS (.npk)?
Скачайте пакеты с download.mikrotik.com по шаблону: https://download.mikrotik.com/routeros/VERSION/routeros-VERSION-ARCH.npk. Вы также можете извлечь отдельные пакеты из архива all_packages-ARCH-VERSION.zip для вашей архитектуры.

Сведения для разработчиков

Автор

tikoci

Лицензия

MIT

Ссылка

main

Структура файлов

📄 SKILL.md