技能 routeros-netinstall
📦

routeros-netinstall

安全

使用 netinstall 安裝和管理 RouterOS 裝置

MikroTik RouterOS 裝置刷寫需要了解 BOOTP、TFTP、套件管理和腳本編寫。本技能提供完整的 netinstall-cli 參考文件,包含單一裝置和多裝置安裝的自動化模式。

支援: Claude Codex Code(CC)
🥉 72 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「routeros-netinstall」。 Install RouterOS 7.22 with container and WiFi packages on an ARM64 device via 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」。 How do I enter etherboot mode using the RouterOS CLI?

預期結果:

  • 在 RouterOS CLI 中執行此命令:/system/routerboard/settings/set boot-device=try-ethernet-once-then-nand
  • 然後重新啟動裝置。它會嘗試乙太網路啟動一次後回退到 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
審計總數
未發現安全問題
審計者: claude 查看審計歷史 →

品質評分

38
架構
100
可維護性
87
內容
32
社群
100
安全
100
規範符合性

你能建構什麼

大規模部署 RouterOS 的網路管理員

使用 netinstall 自動化模式可在實驗室或生產環境中同時刷寫多個 RouterOS 裝置。參考使用 -m -o 旗標的多裝置安裝服務循環,以進行高效的批量佈建。

建構 RouterOS CI/CD 管道的 DevOps 工程師

將 netinstall-cli 整合到容器化建構管道中以進行自動化 RouterOS 測試。參考使用 VETH 網路和環境變數設定的容器化 netinstall 模式。

救援變磚的 RouterOS 裝置的技術人員

遵循 etherboot 進入程序和單一裝置安裝步驟,以復原韌體更新失敗或設定損壞的裝置。使用 configure 指令稿模式來自訂預設值。

試試這些提示

基本 netinstall 命令建構
我需要在 ARM64 MikroTik 裝置上安裝 RouterOS 7.22。使用預設值重新安裝並在 eth0 介面上放棄 branding 套件來建構 netinstall-cli 命令。
Modescript 用於裝置模式設定
撰寫一個 modescript,啟用 container 和 zerotier 支援的高級模式,然後顯示套用於首次啟動的 netinstall-cli 命令。
在 ARM 主機上跨平台執行 netinstall
我有一台 ARM64 Linux 伺服器,需要執行 netinstall-cli。說明 QEMU user-mode 設定,並展示如何自動偵測正確的 QEMU 二進位檔以進行透明執行。
RouterOS 上的容器化 netinstall 服務
將 netinstall-cli 設定為 RouterOS 容器,自動為連接到 LAN 的裝置安裝 RouterOS。使用 VETH 網路、arm64 架構、stable 管道和 container 加上 wifi 套件來設定容器。

最佳實務

  • 務必將系統套件 (routeros-VER-ARCH.npk) 放在 netinstall-cli 套件清單的第一位,以確保正確的安裝順序。
  • 使用專用網路介面或沒有其他 DHCP 來源的交換器,以避免 etherboot 裝置探索期間的 BOOTP 衝突。
  • 在容器啟動時執行 DNS 重試邏輯(5 次嘗試,每次間隔 2 秒),因為 DNS 可能無法立即使用。

避免

  • 不要同時使用 -r(使用預設值重新安裝)和 -e(使用空白設定重新安裝)旗標。它們互斥,會產生未定義的行為。
  • 避免直接使用 USB 乙太網路介面卡連接主機和裝置。USB 介面卡的連結波動可能會阻止裝置偵測。使用交換器作為中介。
  • 不要在有作用中 DHCP 伺服器的網路上執行 netinstall-cli,除非已隔離。BOOTP 使用與 DHCP 相同的連接埠,會導致位址衝突。

常見問題

netinstall 和 netinstall-cli 有什麼區別?
Netinstall 是 Windows GUI 應用程式。Netinstall-cli 是 Linux 命令列工具,作為 x86 ELF 二進位檔案散發。兩者都使用 BOOTP 和 TFTP 協定透過乙太網路執行相同的 RouterOS 安裝功能。
為什麼 netinstall-cli 需要根權限或 sudo 權限?
Netinstall-cli 在連接埠 67/68 上使用 BOOTP,在連接埠 69 上使用 TFTP。這些是需要 Linux 系統上根權限的低於 1024 的特權連接埠。該工具也執行裝置探索的低層級網路操作。
我可以在 Mac 或 ARM Linux 機器上執行 netinstall-cli 嗎?
在 x86_64 Linux 上,netinstall-cli 原生執行。在 ARM/ARM64 Linux 上,使用 QEMU user-mode 模擬搭配 qemu-i386-static 或 qemu-i386。在 macOS 上,需要具有橋接網路的完整 QEMU 虛擬機器,因為 QEMU user-mode 模擬僅限 Linux。
configure 指令稿和 mode 指令稿有什麼區別?
Configure 指令稿(-s 旗標)在套用預設設定後執行,並在升級時保留,直到重新 netinstall。Mode 指令稿(-sm 旗標,RouterOS 7.22+)在其他指令稿之前執行一次,之後自動刪除。Mode 指令稿是初始裝置模式設定的理想選擇。
如何在 MikroTik 裝置上進入 etherboot 模式?
有四種方法:啟動時按住重置按鈕直到裝置出現在 netinstall 中;透過序列主控台在啟動時按 Ctrl+E;透過 RouterOS CLI 將 boot-device 設定為 try-ethernet-once-then-nand 並重新啟動;或者如果之前已設定,則使用受保護的開機載入程式方法。
我可以在哪裡下載 RouterOS 套件檔案 (.npk)?
使用模式從 download.mikrotik.com 下載套件:https://download.mikrotik.com/routeros/VERSION/routeros-VERSION-ARCH.npk。您也可以從 all_packages-ARCH-VERSION.zip 封存檔案為您的架構解壓縮個別套件。

開發者詳情

檔案結構

📄 SKILL.md