Radxa ROCK 5B 刷机教程：SD 卡、eMMC、NVMe 安装 Radxa OS

先确认是 ROCK 5B，不是 ROCK 5B+

两块板子长得很像，但系统镜像不能混用。

是 ROCK 5B+ 的话，请到 Radxa ROCK 5B+ 系统镜像页 下载对应镜像。ROCK 5B 有 V1.42、V1.45、V1.46 等硬件版本，Radxa 只发布一个 ROCK 5B 镜像，不按硬件版本区分。

准备

• 电源：USB-C PD 电源（支持 9V、12V、15V 或 20V，2A），或 30W 以上的 USB-C 固定电压电源。Radxa 推荐官方 PD 30W 电源。
• 存储：microSD 卡（16 GB 以上）、eMMC 模块或 M.2 NVMe 固态硬盘（2280，只支持 NVMe，不支持 M.2 SATA）任选一种。
• 一台电脑和读卡器；刷 eMMC 时还要一根 USB-A 转 USB-C 数据线。
• 散热：板子不带散热片和风扇，长时间满载建议加装（风扇接口是 5V 两针）。

下载哪个文件

打开 Radxa ROCK 5B 系统镜像页，有两个版本：

两个都是 Debian 12 KDE 桌面版、512 字节扇区的整盘镜像，可以直接写入 SD 卡、eMMC 或 NVMe。下载后核对页面上的 SHA-256，方法见 如何核对下载文件的 SHA-256。

方法一：装到 microSD 卡（最简单）

1. 用 7-Zip 把 .img.xz 解压成 .img。Radxa 的教程要求用 balenaEtcher 写入前先解压；用 Raspberry Pi Imager 可以直接选 .img.xz。
2. 打开 balenaEtcher，点“从文件烧录”选镜像，点“选择目标”选你的 microSD 卡，再点“现在烧录”，等到显示完成。
3. 把卡插进板子背面的卡槽，接上电源。

应看到：电源指示灯亮绿色，随后开始闪烁，表示系统正在正常启动；接了显示器的话，大约 40 秒后出现桌面。

警告写入会清空整张卡。选目标时看清容量，别选成电脑上的硬盘。

方法二：装到 eMMC 模块

用 eMMC 读卡器（推荐）

1. 把 eMMC 模块装进 Radxa eMMC 读卡器，插到电脑 USB 口。
2. 按方法一的步骤，用 balenaEtcher 把镜像写入 eMMC 模块。
3. 把模块装回板子底面的 eMMC 插座，拔掉 microSD 卡后上电。

没有读卡器：用 USB 线刷（MaskROM 模式）

RKDevTool 界面有中文和英文两种，下面按钮名两种都写上。需要 Windows 电脑、本站的 RKDevTool 和驱动助手，以及 Radxa 下载页上的 Loader 文件 rk3588_spl_loader_v1.15.113.bin（本站暂未收录，从文末“官方资料”进入 Radxa 页面获取）。

1. 运行驱动助手里的 DriverInstall.exe（右键以管理员身份运行），点“驱动安装”。装过旧版就先点“驱动卸载”。
2. 断开电源，拔掉 microSD 卡，确认 eMMC 模块已经装在板上。
3. 按住板子左侧边缘、风扇接口旁边的 **Maskrom** 小按键不放。
4. 用 USB-A 转 USB-C 线，把电脑的 USB 口接到板子**唯一的 USB-C 口**（就是平时的供电口，此时由电脑供电），然后松开按键。

应看到：RKDevTool 窗口底部显示“发现一个 MASKROM 设备”（英文界面为 Found One MASKROM Device）。

1. 在“下载镜像（Download Image）”页：Loader 一栏选 rk3588_spl_loader_v1.15.113.bin，镜像一栏选**解压后**的 .img；存储选 **EMMC**；勾选“强制按地址写（Write by Address）”；点“执行（Run）”，等进度完成。
2. 拔掉 USB 线，换回电源上电，板子从 eMMC 启动。

注意第 3 步如果没按住 Maskrom 键，镜像可能被写进 SPI 闪存，之后板子就会卡住不启动。处理方法见下面“刷坏了怎么救”。

Linux 和 macOS 可以用 Radxa 推荐的 rkdeveloptool 完成同样的写入：

sudo rkdeveloptool db rk3588_spl_loader_v1.15.113.bin
sudo rkdeveloptool wl 0 rock-5b_bookworm_kde_b5.output.img
sudo rkdeveloptool rd

方法三：装到 NVMe 固态硬盘

ROCK 5B 不能直接从 NVMe 启动，要先往板载 SPI 闪存里写入引导程序。Radxa 的做法是先用 SD 卡开机：

1. 按方法一做好 SD 卡并开机，连上网络。
2. 打开终端，更新系统：

sudo apt-get update && sudo apt-get full-upgrade

1. 运行 rsetup，进入 System Maintenance → Update SPI Bootloader，选中后等待写入成功。
2. 把 NVMe 装进板子底面的 M.2 M-Key 插槽，运行 lsblk，确认能看到 nvme0n1。
3. 把镜像文件拷到板子上（U 盘、浏览器下载或 scp 都可以），写入 NVMe：

sudo xzcat rock-5b_bookworm_kde_b5.output.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress

1. 关机，拔掉 SD 卡，再上电。

应看到：大约 50 秒后出现桌面，系统已从 NVMe 启动。

警告dd 会覆盖目标盘的全部数据。执行前用 lsblk 再确认一次设备名是 nvme0n1。

提示同时插着 SD 卡、eMMC 和 NVMe 时，从哪个启动取决于 SPI 里的引导程序，Radxa 没有公布固定顺序。装好后只保留一个系统盘最省事。

第一次开机

• 默认账号：radxa，密码 radxa（较旧的镜像也可能是 rock / rock）。登录后请先改密码。
• 主机名：rock-5b。
• SSH：第一次开机时**没有接显示器**，系统会自动开启 SSH。接了显示器的话，在终端运行 sudo systemctl enable --now ssh 手动开启。
• 找 IP：登录路由器后台看名为 rock-5b 的设备，然后在电脑上运行 ssh radxa@板子的IP。
• ROCK 5B 没有板载 Wi-Fi，需要网线，或者在 M.2 E-Key 插槽装无线网卡（Radxa 推荐 RTL8852BE）。

刷坏了怎么救

• **上电后反复重启**：多半是电源问题。PD 协商要等系统内核启动后才完成，部分 PD 电源会提前断电。换官方 PD 30W 或 12V 固定电压的 USB-C 电源。
• **刷完 eMMC 后灯不闪、没画面**：多半是镜像写进了 SPI。按上面的方法进 MaskROM 模式，在 RKDevTool 里载入 Loader 后点“下载（Download）”，存储选 **SPINOR**，点“切换存储（Switch Storage）”，再点“擦除所有（Erase ALL）”；然后重新刷 eMMC。
• **装了 NVMe 不启动**：用 SD 卡开机，在 rsetup 里重新执行 Update SPI Bootloader。
• **想取消 NVMe 引导**：在 rsetup 里选 System Maintenance → Erase SPI Bootloader，型号选 rock-5b。
• **判断板子本身是否正常**：断电，拔掉所有存储，按住 Maskrom 键接电脑 USB，绿灯亮起、电脑出现新的 USB 设备，说明板子能进入刷机模式。
• **连接显示器没画面**：在 /boot/extlinux/extlinux.conf 的 append 行末尾加上 video=1920x1080@60（按显示器分辨率调整）。
• 想看启动日志：用 USB 转 TTL 串口，波特率 1500000，接 GPIO 6（GND）、8（TX）、10（RX），红色电源线不要接。详见 用 USB 转 TTL 串口调试开发板。

资料来源

按 Radxa 官方文档（ROCK 5B 快速上手、系统安装、低级开发与常见问题，2026-10-22 查阅）和 Radxa 在 GitHub 发布的 rsdk-b5、rsdk-r6 版本说明整理。

提示本页按厂商官方文档整理，本站没有在实机上测试。按键位置和文件名以你的板子和 Radxa 官方说明为准。