Skip to content
FydeOS 帮助中心

在 Radxa ROCK 5 系列上安装 FydeOS

最近更新：2025-11-20

请注意

由于 Radxa 在某次固件更新中改变了 SPI-Flash 的启动脚本读取逻辑，可能导致旧版固件无法正确引导 v21 及后续版本的 FydeOS。如果你在全新安装后遇到设备无法正常启动的情况，建议优先按照 Radxa 官方文档（ROCK 5B / ROCK 5B+ / ROCK 5T）更新 SPI-Flash 固件，这通常能解决兼容性问题。

此指南将引导你完成在 ROCK 5 系列卡式电脑（包括 ROCK 5B、ROCK 5B+、ROCK 5T）上启动 FydeOS / openFyde 的过程。只需按照针对你的操作系统的说明，你很快就可以使用 FydeOS / openFyde 了。

鉴于 ROCK 5 系列的极客特性，建议你首先详尽阅读官方文档中的内容，熟悉使用/操作/折腾像 ROCK 5 系列这样的卡式电脑所需的基本知识。

1. 获取安装文件

  • 如果你想使用 FydeOS，请首先访问 FydeOS for SBC 下载页面，获取 ROCK 5 系列的镜像文件。

  • 对于 openFyde，请从 发行页面 获取最新的镜像。

2. 获取 .img 镜像文件

  1. 准备执行 .run 文件

    对于 FydeOS v21.0-SP1 (openFyde r138) 及后续版本，安装文件下载完成后，你将得到一个 .run 格式的文件。如名称所示，我们首先需要「运行」这个文件。

    对于 macOS, Linux 和 BSD 用户，你可以使用终端来运行 .run 文件。请先打开终端，并将命令提示符的工作目录切换到到包含 .run 文件的文件夹。

  2. 使 .run 文件可执行

    接下来，在终端中执行以下命令。用你下载的 .run 文件的名称替换 FydeOS_for_SBC_Rock5B_v21.0-SP1-com.run：

    Terminal window
    chmod +x FydeOS_for_SBC_Rock5B_v21.0-SP1-com.run

  3. 运行 .run 文件

    现在，你可以通过执行以下命令来运行 .run 文件：

    Terminal window
    ./FydeOS_for_SBC_Rock5B_v21.0-SP1-com.run

    执行这些命令后，终端将显示一个交互式菜单，如下：

    *****************************
    * Supported boards *
    *****************************
    [1] Rock 5B
    [2] Rock 5B Plus
    [3] Rock 5T
    [4] Quit
    -----------------------------
    Enter your choice:

    现在你需要按照屏幕提示输入你的选择（数字 1 - 4）。交互式提示将要求你从 ROCK 5 系列中选择你的开发板，以及启动介质（eMMC、NVMe 或 SATA，取决于特定型号的支持）。选择完成后，脚本将开始为你生成一个可引导的镜像文件，并显示类似以下内容：

    *****************************
    * board: rock5b, supported install storage: nvme *
    *****************************

    生成过程可能需要几分钟甚至更长的时间，请耐心等待。完成后，脚本会输出类似于下方的提示，显示生成的 .img 文件的路径：

    board: rock5b storage: NVME
    Generated image: /some/path/Downloads/FydeOS_for_SBC_Rock5B_v21.0-SP1-com.img
    Installing uboot firmware on ./FydeOS_for_SBC_Rock5B_v21.0-SP1-com.img
    Installed bootloader to ./FydeOS_for_SBC_Rock5B_v21.0-SP1-com.img

    至此，你已经根据你的选择获得了可引导的 .img 文件。如有需要，可以随时重新运行 .run 文件以重试该过程。

3. 将镜像刷写到目标存储驱动器

从 FydeOS v17（openFyde r114）开始，你可以直接将生成的可引导镜像刷写到你将用来启动 FydeOS 的存储设备，并享受完整的功能，包括 OTA 更新（以前需要首先将镜像刷写到 TF 卡，然后再将其「安装」到最终目标存储驱动器上）。

要将文件写入 M.2 NVMe/Sata 存储驱动器或 eMMC 芯片，可能需要额外的硬件来让你的电脑读写这些储存设备。我们建议使用 USB M.2 NVMe/Sata 硬盘盒或 USB - eMMC 读卡器来执行此操作。

我们推荐使用 balenaEtcher 将镜像刻录到 SD 卡或 USB 设备。balenaEtcher 是一款兼容 Windows、macOS 和主流 Linux 版本的工具软件，能帮助用户快速将镜像文件烧写到 USB 设备或闪存卡。该软件界面友好，设计精美，你只需简单的三步操作：

img

你可以从 balenaEtcher 官网 下载适用于 Windows、macOS 或 Linux 的安装包。

4. 给你的 ROCK 5 设备接上电源

成功将镜像写入目标存储设备后，将其安全插入到你的 ROCK 5 系列设备上的对应插槽里，接上键盘鼠标和显示器，可以通电了！享受探索你的新操作系统吧 - 这就完成了 FydeOS / openFyde 的全部安装过程。

遇到黑屏或者不启动怎么办？

鉴于 ARM 芯片驱动的卡式电脑的特殊性，系统引导启动的流程和传统 x86 设备有较大区别。针对 ROCK 5 系列设备，你需要确保设备的 SPI 固件允许设备从你安装的储存设备引导启动，通常情况下是 M.2 插槽的 NVMe 或 Sata 固态硬盘。如果遇到无法从 M.2 插槽内的固态硬盘启动的状况，还请确保你的 SPI 固件未被修改或损坏，若不确定，可以参照官方提供的文档进行修复（ROCK 5B / ROCK 5B+ / ROCK 5T）。