瑞莎 Radxa ROCK 5 ITX / ITX+ 刷机教程:SD 卡、eMMC、NVMe 安装 Radxa OS
ROCK 5 ITX 和 ITX+ 装系统:电源怎么接,写 microSD 卡,开启 SDHCI 后把系统写进板载 eMMC,Maskrom 线刷,写 SPI 引导装 NVMe,附救砖方法。约 25 分钟。
适用于Radxa ROCK 5 ITX / ROCK 5 ITX+ 官方系统镜像
先确认型号
ROCK 5 ITX 是 170 × 170 mm 的 Mini-ITX 标准主板,RK3588 芯片,能装进普通电脑机箱。ROCK 5 ITX+ 是它的另一个版本,Radxa 两款共用同一个系统镜像:
| 看哪里 | ROCK 5 ITX | ROCK 5 ITX+ |
|---|---|---|
| 丝印 | V1.11 / V1.12 等 | ROCK 5 ITX+ V1.2 |
| 系统镜像 | rock-5-itx_… | 同一个 rock-5-itx_… |
两款板上都有 eMMC、SPI 闪存、microSD 卡槽、两个 2.5G 网口和一个全功能 USB-C 口。
准备
- 电源(三选一,不能同时接两种):12V DC 适配器(外径 5.5 mm、内径 2.5 mm、中心正极,超过 12V 可能损坏主板)、机箱 ATX 24 针电源,或装 Radxa 25W PoE+ 模组后用交换机供电。接上电源后主板会自动开机。
- 适配器功率按外设算:主板满载约 25W,再加上由主板供电的硬盘。Radxa 的 NVMe 教程用的是 12V/8A。
- 存储:microSD 卡、板载 eMMC 或 M.2 NVMe 固态硬盘。
- USB 线刷时要一根 USB-A 转 USB-C 数据线。
下载哪个文件
| 版本 | 文件 | 说明 |
|---|---|---|
| rsdk-b3 | rock-5-itx_bookworm_kde_b3.output.img.xz | Debian 12 KDE 桌面,Radxa 标为正式版,官方下载页列出的就是它,建议选这个 |
| rsdk-r4 | rock-5-itx_bookworm_kde_r4.output_512.img.xz | 更新的版本,但 Radxa 在 GitHub 上标为预发布,Radxa 说明不对预发布版提供支持 |
两个都是 512 字节扇区的整盘镜像。Radxa 下载页上的 Android 镜像本站暂未收录。下载后核对 SHA-256,方法见 如何核对下载文件的 SHA-256。
方法一:装到 microSD 卡
- 用 7-Zip 把
.img.xz解压成.img(Radxa 要求用 balenaEtcher 前先解压)。 - 打开 balenaEtcher,点“从文件烧录”选镜像,点“选择目标”选 microSD 卡,再点“现在烧录”,等到显示完成。
- 把卡插进主板的 microSD 卡槽,接上 12V 电源。
应看到:主板自动开机,接了显示器的话大约 53 秒后出现桌面。
警告写入会清空整张卡。选目标时看清容量,别选成电脑上的硬盘。
方法二:装到板载 eMMC(从 SD 卡开机后写入)
ROCK 5 ITX 的 eMMC 默认是关闭的,要先在系统里打开:
- 按方法一用 SD 卡开机,用
radxa/radxa登录。 - 运行
rsetup,进入 Overlays,选中[] Enable SDHCI,显示[*] Enable SDHCI后退出并重启。 - 运行
lsblk,Radxa 说明 eMMC 默认是mmcblk0。 - 把镜像拷到板子上,写入 eMMC:
sudo xzcat rock-5-itx_bookworm_kde_b3.output.img.xz | sudo dd of=/dev/mmcblk0 bs=1M status=progress- 关机断电,拔掉 microSD 卡,再上电,系统从 eMMC 启动。
警告dd 会覆盖目标盘。先用 lsblk 看清楚哪个是 SD 卡(正在运行的系统)、哪个是 eMMC。
也可以用 USB 线刷(MaskROM 模式)
需要 Windows 电脑、本站的 RKDevTool 和驱动助手,以及 Radxa 下载页上的 Loader 文件 rk3588_spl_loader_v1.15.113.bin(本站暂未收录,从文末“官方资料”进入 Radxa 页面获取)。
- 运行驱动助手里的
DriverInstall.exe,点“驱动安装(Install Driver)”。 - 拔掉 microSD 卡和电源。
- 按住 Maskrom 按键不放。按键在主板右侧边缘、microSD 卡槽旁边(Radxa 硬件接口图里的 24 号)。
- 按住不放,用 USB-A 转 USB-C 线把电脑接到主板的 USB-C 口(ROCK 5 ITX 的 OTG 口就是这个 USB-C)。
- 继续按住,接上 12V DC 电源,然后松开按键。Radxa 规格表写明这个 USB-C 口不能给主板供电,所以必须另接 12V 电源。
应看到:RKDevTool 窗口底部显示“发现一个 MASKROM 设备”(英文界面为 Found One MASKROM Device)。
- 在“下载镜像(Download Image)”页:Loader 选
rk3588_spl_loader_v1.15.113.bin,镜像选解压后的.img;存储选 EMMC;勾选“强制按地址写(Write by Address)”;点“执行(Run)”。 - 拔掉 USB 线,重新插拔电源,主板从 eMMC 启动。
注意Radxa 的线刷页只写了“按住 Maskrom 按钮、接 USB 线”。第 5 步先接线、再接 12V 电源的顺序,是本站根据“USB-C 不能供电”这条说明整理的,和 Radxa 给 ROCK 5T 写的顺序一致。
方法三:装到 NVMe 固态硬盘
- 用 SD 卡开机,运行
sudo apt-get update && sudo apt-get full-upgrade。 - 运行
rsetup,进入 System Maintenance → Update SPI Bootloader,选中对应项,等待写入成功。 - 把 NVMe 装进 M.2 M-Key 插槽,
lsblk确认看到nvme0n1,写入:
sudo xzcat rock-5-itx_bookworm_kde_b3.output.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress- 关机,拔掉 SD 卡,再上电。
提示同时有多个系统盘时,从哪个启动取决于 SPI 里的引导程序,Radxa 没有公布固定顺序。装好后只保留一个系统盘最省事。
第一次开机
- 默认账号:
radxa,密码radxa。登录后请先改密码。 - SSH:第一次开机时没有接显示器,系统会自动开启 SSH;接了显示器的话,运行
sudo systemctl enable --now ssh手动开启。 - 找 IP:到路由器后台看新出现的设备,然后运行
ssh radxa@板子的IP。 - 更多见 开发板第一次开机与登录。
刷坏了怎么救
- eMMC 系统起不来:插 SD 卡开机(必要时拔掉 NVMe),按方法二重新写入 eMMC,或进 MaskROM 线刷。
- 装了 NVMe 不启动:用 SD 卡开机,在
rsetup里重新执行 Update SPI Bootloader。 - 想取消 SPI 引导:能开机就在
rsetup里选 System Maintenance → Erase SPI Bootloader;开不了机就进 MaskROM,在 RKDevTool 里载入 Loader 后点“下载(Download)”,存储选 SPINOR,点“切换存储(Switch Storage)”,再点“擦除所有(Erase ALL)”。 - 主板不开机:确认只接了一种电源;DC 适配器必须是 12V。
- 其他排查思路见 开发板刷坏了怎么救。
资料来源
按 Radxa 官方文档(ROCK 5 ITX 产品介绍、电源选择、制作 microSD 启动盘、通过 microSD 启动盘安装系统到 eMMC、安装系统到 NVMe、通过 USB 刷机、硬件接口、资源下载汇总,2026-10-22 查阅)和 Radxa 在 GitHub 发布的 rsdk-b3、rsdk-r4 版本信息整理。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键位置和文件名以你的板子和 Radxa 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证