RRouterOS 中文手册
快速上手/Netinstall package

Netinstall package

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

本页介绍 RouterOS 的 Netinstall 软件包：从 RouterOS 7.24beta1 起，可以从另一台运行 RouterOS 的设备远程重装 MikroTik 设备。内容涵盖前提条件、/tool/netinstall 菜单与参数、缓存机制，以及 Preboot Etherboot 恢复用例。

Netinstall package（Netinstall 软件包）

Netinstall package 是一个附加软件包，从 RouterOS 7.24beta1 起可用于所有运行 RouterOS 的设备，适用于除 SMIPS 之外的所有架构。

该软件包允许从另一台运行 RouterOS 的 MikroTik 设备远程重装 RouterOS。

前提条件

  • RouterOS 7.24beta1 及更高版本。
  • 已启用 Netinstall 软件包。
  • 目标 MikroTik 硬件路由器与被重装设备连接到同一个二层（L2）网段。

警告

默认情况下，Netinstall package 会在根目录下创建 NetinstallCache 目录。在带有 flash 目录的设备上，Netinstall 相关文件存储在 RAM 中；在没有 flash 目录的设备上，这些文件存储在设备的持久化存储中。

请确保 Netinstall 服务器设备有足够的可用存储空间或 RAM。

你也可以在 Netinstall → Settings 中把外部存储设备配置为 NetinstallCache/ 目录。 从 Files 菜单中物理删除的文件，如果当前处于缓存状态，会被自动重新下载。要删除缓存文件，请到 Netinstall Cache 菜单中删除。 如果文件是在设备重启前下载的，则会被删除。

安装流程

  1. 安装并启用 Netinstall 软件包。Netinstall package 在 WinBox、WebFig GUI 和 CLI 中均可用，位于 Tools 菜单下，CLI 中为 /tools/netinstall。

  2. 配置 Netinstall 接口。新增一个 Netinstall 接口，设置必要参数，并让连接到该接口的设备以 BOOTP 模式运行。

  3. 下载或选择所需的 RouterOS 软件包。Netinstall package 会自动为目标设备架构安装合适的 System 包。

  4. 让目标设备进入 Etherboot 模式。

  5. 安装 RouterOS。

提示

如果未设置 Version 参数，Netinstall package 会安装 Netinstall 服务器当前所选 Check for Updates 通道中提供的最新 RouterOS 版本。 其他软件包必须显式选择。

通用配置选项

参数说明
Settings用于设置 NetinstallCache/ 路径目录。参见前提条件中的警告信息。示例：/tool/netinstall/settings/set cache-directory=...

Netinstall 参数

参数说明
allow-etherboot (yes / no ; 默认: yes)允许所选接口上的 BOOTP 请求。设为 no 时会忽略设备。
allow-flashfig (yes / no ; 默认: yes)启用 FlashFig 功能
apply-default-configuration (yes / no ; 默认: no)如果启用，设备会在安装并重启后应用默认配置脚本。参见 /system/default-configuration/script/print。
auto-reboot (none / reboot / shutdown ; 默认: reboot)定义设备成功安装完成后执行的动作。
etherboot-image用于选择之前已缓存的、要安装的软件包。
etherboot-image-arch指定 etherboot 镜像所需的 CPU 架构。所有其他架构的请求都会被忽略。如果未指定，则使用检测到的架构。
extra-packages用于在 system 包之外添加要安装的额外软件包。默认会安装 routeros 包。
install-once (yes / no ; 默认: yes)限制每次 Netinstall 运行只安装一次。该工具会记录已成功安装设备的 MAC 地址，并在当前会话中忽略来自同一 MAC 地址的后续 BOOTP 请求。
interface指定 Netinstall 服务器的网络接口。
ip-range自定义 netinstall 过程使用的 BOOTP IP 地址范围。
keep-old-configuration (yes / no ; 默认: yes)指示 Netinstall 在安装后读取并恢复设备核心配置（/export；/users）。该选项不会保留用户文件、容器或类似数据。
mac-address指定允许安装的 MAC 地址。指定后，所有其他 BOOTP 请求都会被忽略。
mode-file与 Mode script 类似。指定一个一次性自定义脚本，在设备安装后首次启动时运行。可用该脚本在设备部署期间配置 device-mode、protected-routerboot 等设置。mode 脚本会在任何自定义或默认配置脚本之前执行。执行完成后，脚本会自动从设备上移除。如果脚本修改了 device-mode，设备会在执行后立即重启。该功能需要 RouterOS 和 Netinstall 7.22 或更新版本。
place-before把规则插入到已有规则之前
remove-branding (yes / no ; 默认: no)丢弃设备上当前已安装的 branding 包。如果未指定，则保留 branding 包。出厂预装的 branding 包无法丢弃，并且始终保留。
script-file允许在安装期间向设备安装自定义默认配置脚本。它会替换 RouterOS 自带的默认配置脚本。参见 /system/default-configuration/custom-script/print。该脚本在 RouterOS 更新期间会保留，并在之后每次配置重置后使用，直到设备被重新安装并写入新脚本，或该脚本被移除。
version指定要安装的 RouterOS 版本。如果未设置 Version 参数，Netinstall 会安装 Netinstall 服务器当前所选 Check for Updates 通道中提供的最新 RouterOS 版本。
wait (yes / no ; 默认: no)让设备保持 etherboot 状态，等待用户命令后才开始安装。

Cache（缓存）

可用操作：GUI 和 CLI 均为 Add。

参数说明
arch必填参数。指定需要下载的文件的 CPU 架构。
packages用于把额外软件包列表添加并下载到 NetinstallCache/ 目录。
version指定要下载的 RouterOS 版本软件包。如果未设置 Version 参数，Netinstall 会下载 Netinstall 服务器当前所选 Check for Updates 通道中提供的最新 RouterOS 版本。

Devices（设备）

Netinstall Devices 菜单显示已 netinstall 的设备列表及其状态。

可用操作：

  • Clear 清空列表。
  • Install 菜单。如果在 Install 菜单中选择了额外参数，所有之前设置的设置都会被覆盖。

可用的 install 参数：auto-reboot、extra-packages、numbers、version。

/tool/netinstall/devices> install auto-reboot=reboot extra-packages=user-manager version=7.24beta1
参数说明
auto-reboot (none / reboot / shutdown ; 默认: reboot)定义设备成功安装完成后执行的动作。
extra-packages用于在 system 包之外添加要安装的额外软件包。默认会安装 routeros 包。
numbers用于从列表中选择要重装 RouterOS 的设备。
version指定要下载的 RouterOS 版本软件包。如果未设置 Version 参数，Netinstall 会安装为接口主设置所选的 version；如果也未指定，则下载 Netinstall 服务器当前所选 Check for Updates 通道中提供的最新 RouterOS 版本。

用例

Netinstall package 可用于 Preboot Etherboot 场景：把一台装有 Netinstall 包的 MikroTik 路由器专门用于远程恢复。 把 Netinstall 服务器的 preboot-etherboot-server=ip_address 设置好，在目标设备出现问题时即可远程重装 RouterOS。 使用 preboot-etherboot-server 时，请在 Netinstall 服务器上配置合适的 IP range 以处理 Etherboot 请求。

危险

请记得禁用或严格过滤所创建的规则，以免每次重启时都意外重装系统。

Netinstall package 示例

[admin@MikroTik] /tool/netinstall/add interface=bridge1 keep-old-configuration=no apply-default-configuration=yes auto-reboot=reboot mac-address=01:23:45:67:89:BB extra-packages=wifi-qcom,container version=7.23.1 ip-range=192.168.88.10-192.168.88.20

查看已缓存的软件包：

[admin@MikroTik] /tool/netinstall/cache/print 
Columns: PATH, URL, STATUS
#  PATH                                               URL                                                                                STATUS    
0  NetinstallCache/container-7.23.1-arm64.npk  https://upgrade.mikrotik.com/routeros/7.23.1/container-7.23.1-arm64.npk  downloaded
1  NetinstallCache/linux.arm64                 https://upgrade.mikrotik.com/routeros/7.23.1/netinstk/linux.arm64        downloaded
2  NetinstallCache/linux.arm64-uefi            https://upgrade.mikrotik.com/routeros/7.23.1/netinstk/linux.arm64-uefi   downloaded
3  NetinstallCache/wifi-qcom-7.23.1-arm64.npk  https://upgrade.mikrotik.com/routeros/7.23.1/wifi-qcom-7.23.1-arm64.npk  downloaded

查看安装后的设备状态：

[admin@MikroTik] /tool/netinstall/devices/print 
Flags: N - NETINSTALL
Columns: MAC-ADDRESS, INTERFACE, STATE, LAST-STATE-UPDATE, EXTRA-PACKAGES, VERSION, ARCH, MODEL, LAST-STATE, AUTO-REBOOT
#   MAC-ADDRESS        INTERFACE  STATE    LAST-STATE-UPDATE  EXTRA-PACKAGES  VERSION    ARCH   MODEL       LAST-STATE        AUTO-REBOOT
0 N 01:23:45:67:89:BB  bridge1    done     58s                container       7.23.1     arm64   L009UiGS   bootp reply sent  reboot     
                                                               wifi-qcom

Netinstall package FlashFig 示例

Netinstall package 包含 FlashFig 功能，使批量配置过程大大简化。 一种常见做法是使用一台端口已桥接的 PoE 交换机。

警告

请把 bridge 设置为 protocol-mode=none 或执行 /interface/bridge/port set 0,1... edge=yes。 物理连接方式：

  • 把 Netinstall 服务器（Router1，ether2）连接到 PoE 交换机的某个端口。
  • 把目标设备连接到同一台 PoE 交换机的另一个端口。
[admin@MikroTik] /tool/netinstall/devices/print 
Flags: F - FLASHFIG
Columns: MAC-ADDRESS, INTERFACE, STATE, LAST-STATE-UPDATE, MODEL, AUTO-REBOOT
#   MAC-ADDRESS        INTERFACE  STATE                  LAST-STATE-UPDATE  MODEL   AUTO-REBOOT
0 F 01:23:45:67:89:BB  ether2     done, won't reinstall  21s                952-hb  reboot

提示

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