RRouterOS 中文手册
快速上手/Netinstall for Linux

Netinstall for Linux

中文英文原文
官方原文约 8 分钟阅读

本页介绍 netinstall-cli——MikroTik Netinstall 工具的 Linux 命令行版本，涵盖单台与多台设备重装的所有命令行选项、脚本与配置标志、网络选项，并给出分步安装示例。

Linux 版 Netinstall

Netinstall 的 Linux 版本 netinstall-cli 是一个命令行工具，提供与 Windows 版本几乎相同的功能。

提示

运行 netinstall 工具前，请确保已在电脑网卡上设置静态 IP 地址。

sudo ip addr add 192.168.88.2/24 dev <interface>
sudo ip link set <interface> up

信息

该工具需要 root 权限。必须以 root 身份运行，或使用 sudo 执行。

netinstall-cli 命令行选项

netinstall-cli 的命令语法为：

netinstall-cli [-r] [-e] [-b] [-m [-o]] [-f] [-c] [-v] [--reboot] [--shutdown] [-k <keyfile>] [-s <userscript>] [-sm <modescript>] [--mac <mac address>] {-i <interface> | -a <client-ip>} [PACKAGE]+

通用选项

参数说明
-r重装设备并应用默认配置脚本。
-e重装设备但不应用默认配置脚本，让设备保留空配置。
-b丢弃设备上当前已安装的 branding 包。如果未指定，则保留 branding 包。出厂预装的 branding 包无法丢弃，并且始终保留。
-f忽略存储空间限制。默认情况下，netinstall-cli 会检查路由器的存储容量。如果所选软件包的总大小超出可用存储，会显示错误："Ignoring XX:XX:XX:XX:XX:XX, not enough space (override with -f)"
-c允许在同一台电脑上同时运行多个 Netinstall 实例。
-v启用详细（verbose）模式，输出更详细的信息。

多设备重装选项

参数说明
-m启用多设备重装。同一台设备会按收到的 BOOTP 请求次数反复重装。
-o限制每次 Netinstall 运行只安装一次。该工具会记录已成功安装设备的 MAC 地址，并在当前会话中忽略来自同一 MAC 地址的后续 BOOTP 请求。

组合行为：

  • 不使用 -m 也不使用 -o：只进行一次成功安装，随后 Netinstall 关闭。
  • 仅 -m：启用多设备重装；同一台设备会反复重装。
  • 仅 -o：与不带标志相同；每次运行安装一次后关闭。
  • 同时使用 -m 和 -o：启用多设备重装，但每台设备在每个会话中只安装一次。

脚本与配置选项

参数说明
--reboot重启处于 Netinstall 模式的所选 MikroTik 设备。
--shutdown关闭处于 Netinstall 模式的所选 MikroTik 设备。
-k <keyfile>向设备提供 .KEY 格式的授权 key 文件（可选）。
-s <userscript>允许在安装期间向设备安装自定义默认配置脚本。它会替换 RouterOS 自带的默认配置脚本。参见 /system/default-configuration/custom-script/print。该脚本在 RouterOS 更新期间会保留，并在之后每次配置重置后使用，直到设备被重新安装并写入新脚本，或该脚本被移除。
-sm <modescript>指定一个一次性自定义脚本，在设备安装后首次启动时运行。可用该脚本在设备部署期间配置 device-mode、protected-routerboot 等设置。mode 脚本会在任何自定义或默认配置脚本之前执行。执行完成后，脚本会自动从设备上移除。如果脚本修改了 device-mode，设备会在执行后立即重启。该功能需要 RouterOS 和 Netinstall 7.22 或更新版本。

网络选项

参数说明
--mac <mac address>指定允许安装的 MAC 地址。指定后，所有其他 BOOTP 请求都会被忽略。
-i <interface>指定用于安装的网络接口（可选，推荐）。
-a <client-ip>指定 Netinstall 服务器分配给设备的特定 IP 地址。除非使用 -i 参数（该参数允许自动分配），否则此参数为必填。

软件包选择

参数说明
PACKAGES指定要安装到设备上的 .NPK 格式 RouterOS 软件包列表。此参数为必填。system 包必须放在第一位。

警告

配置保留行为：

当既未指定 -r 也未指定 -e 时，netinstall-cli 会重装 RouterOS 并保留当前配置。它会从路由器下载现有配置数据库，在重装期间重新格式化磁盘，然后把配置上传回设备。这与 Netinstall GUI 中的 "Keep old configuration" 选项一致。

注意：此过程仅针对配置本身。User Manager 数据库、Dude 数据库等单独存储的文件和数据库不会被保留。

Linux 版 Netinstall 示例

从 MikroTik 下载页面下载工具：

wget https://download.mikrotik.com/routeros/[VERSION]/netinstall-[VERSION].tar.gz

解压压缩包：

tar -xzf netinstall-[VERSION].tar.gz

配置网络接口（把 eth0 替换为你的接口名）：

sudo ip link set eth0 down
sudo ip addr add 192.168.88.2/24 dev eth0
sudo ip link set eth0 up

运行安装。该工具需要 root 权限，请使用 sudo：

sudo ./netinstall-cli [-parameters] [address/interface] routeros-[architecture]-[package VERSION].npk

sudo ./netinstall-cli -i eth0 -v -e  routeros-7.23.1-arm64.npk wifi-qcom-7.23.1-arm64.npk container-7.23.1-arm64.npk 
Version: 7.24beta1(2026-05-26 11:17:51)
Will apply empty config
Waiting for Link-UP on eth0
Using client IP 192.168.88.3
Waiting for RouterBOARD...
Received a BOOTP request from 01:23:45:67:89:AA (arm64)
Assigned 192.168.88.3 to 01:23:45:67:89:AA
blksize 1452
Booting device 01:23:45:67:89:AA into setup mode
Formatting device 01:23:45:67:89:AA
Sending packages to device 01:23:45:67:89:AA
Packages sent to device 01:23:45:67:89:AA
Rebooting device 01:23:45:67:89:AA
Successfully finished installing device 01:23:45:67:89:AA

提示

想了解其他安装方式？请参阅 Windows 或 Netinstall Package 说明。