Radxa ZERO 3W / 3E 刷机教程：SD 卡与 eMMC 安装 Radxa OS

先确认是 ZERO 3W 还是 ZERO 3E

两块板子大小一样、用同一个系统镜像，但存储和网络不同，装系统的方法也不完全一样。

ZERO 3W 有 V1.11、V1.12 等硬件版本，较新的版本换了双频 Wi-Fi 6 模块。Radxa 只发布一个 ZERO 3 镜像，不按 3W/3E 或硬件版本区分。

注意Radxa ZERO（初代，Amlogic S905Y2）和 Radxa ZERO 2 PRO（Amlogic A311D）是不同的板子，镜像不能混用。ZERO 3 的主芯片印着 Rockchip RK3566。

准备

• 电源：只支持 5V，接 USB-C 1 口，至少 5V/2A。Radxa 推荐官方 PD 30W 电源。不要用高于 5V 的固定电压电源。
• microSD 卡（8 GB 以上）和读卡器。
• 显示器（可选）：Micro HDMI 转 HDMI 线，最高 1080p60。
• 刷 ZERO 3W 板载 eMMC 时：一根 USB-A 转 USB-C 数据线和一台电脑。
• 联网：3W 用 Wi-Fi，3E 用网线。

下载哪个文件

打开 Radxa ZERO 3E / 3W 系统镜像页：

Radxa GitHub 上还有 t1、t2、t3 等以 t 开头的测试版（预发布），Radxa 说明不对预发布版提供支持，本站也没有收录。output_512 表示 512 字节扇区的标准镜像，SD 卡和 eMMC 都用它。下载后核对页面上的 SHA-256，方法见 如何核对下载文件的 SHA-256。

方法一：装到 microSD 卡（3W 和 3E 都适用）

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

应看到：电源指示灯常亮，系统开始启动；接了显示器的话会进入桌面。

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

方法二：装到 ZERO 3W 板载 eMMC（USB 线刷）

只适用于带 eMMC 的 ZERO 3W。需要让板子进入 Maskrom 模式，再用电脑把镜像写进 eMMC。RKDevTool 界面有中文和英文两种，下面按钮名两种都写上。

进入 Maskrom 模式

1. 拔掉 microSD 卡和电源线。
2. 按住板子背面的 Maskrom 小按键不放。
3. 用 USB-A 转 USB-C 线，把电脑的 USB 口接到板子的 USB-C 1 口（此时由电脑供电）。

应看到：电源绿灯常亮，表示已进入 Maskrom 模式，这时可以松开按键。

Windows：用 RKDevTool 写入

需要本站的 RKDevTool 和驱动助手，以及 RK3566 用的 Loader 文件。Radxa 的 Loader 列表里给 RK3566/RK3568 列了 rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin 和 rk356x_spl_loader_ddr1056_v1.10.111.bin，没有指定 ZERO 3 用哪一个（本站暂未收录，从文末“官方资料”进入 Radxa 页面获取）。

1. 运行驱动助手里的 DriverInstall.exe，点“驱动安装（Install Driver）”。装过旧版就先点“驱动卸载（Uninstall Driver）”。
2. 用 7-Zip 把镜像解压成 .img。RKDevTool 不会自动解压。
3. 按上面的步骤进入 Maskrom 模式，打开 RKDevTool.exe。

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

1. 在“下载镜像（Download Image）”页：Loader 一栏选 Loader 文件，镜像一栏选解压后的 .img；存储选 EMMC；勾选“强制按地址写（Write by Address）”；点“执行（Run）”。

应看到：进度完成后设备自动重启。

1. 拔掉电脑的 USB 线，把 USB-C 1 接到 5V 电源上电。

应看到：状态灯闪烁，系统从 eMMC 启动。

Linux 和 macOS：用 rkdeveloptool

如果系统软件源里没有 rkdeveloptool，Radxa 的说明是从源码编译安装。镜像同样要先解压：

xz -d radxa-zero3_bookworm_kde_b1.output_512.img.xz
sudo rkdeveloptool ld
sudo rkdeveloptool db rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin
sudo rkdeveloptool wl 0 radxa-zero3_bookworm_kde_b1.output_512.img
sudo rkdeveloptool rd

ld 能列出一台 Maskrom 设备，才说明连接正常。Loader 文件名换成你实际下载的那个。

提示同时插着 SD 卡和 eMMC 时先从哪个启动，Radxa 没有在 ZERO 3 文档里说明。装好后只保留一个系统盘最省事。

第一次开机

• 默认账号：radxa，密码 radxa。登录后请先改密码。
• 主机名：radxa-zero3。
• 联网：ZERO 3W 在终端里连 Wi-Fi：

nmcli device wifi
sudo nmcli device wifi connect 你的WiFi名 password 你的WiFi密码

ZERO 3E 直接插网线。

• SSH：Radxa OS 文档说明，第一次开机时没有接显示器，系统会自动开启 SSH。接了显示器的话，在终端运行 sudo systemctl enable --now ssh 手动开启。
• 找 IP：在板子上运行 ip a，或者登录路由器后台找名为 radxa-zero3 的设备，然后在电脑上运行 ssh radxa@板子的IP。

以后升级

系统装好后用 apt 更新即可，不需要重新刷机：

sudo apt update
sudo apt upgrade

刷坏了怎么救

• SD 卡不启动、灯不亮或闪烁：Radxa 说多半是电源问题。确认用的是 5V 电源，线接在 USB-C 1 口，换一根好的 USB-C 线。
• 换电源后还是不启动：换一张质量好的卡（8 GB 以上），重新下载镜像、核对 SHA-256，用 balenaEtcher 完整写一遍。
• ZERO 3W 刷 eMMC 后不启动：按上面的方法重新进 Maskrom 模式，再写一次 eMMC。能进入 Maskrom（绿灯常亮、电脑认到设备）就说明板子还能救。
• 看启动日志：用 USB 转 TTL 串口，波特率 1500000，接 40 针排针的 6 脚（GND）、8 脚（TX）、10 脚（RX）。这组串口同时是 U-Boot 控制台，不要在 rsetup 里把它改成普通串口，否则串口上的输入会打断启动。详见 用 USB 转 TTL 串口调试开发板。

资料来源

按 Radxa 官方文档（ZERO 3 资源下载汇总、安装操作系统、安装系统到 eMMC、RKDevTool 与 rkdeveloptool、硬件接口说明、常见问题、远程访问与网络设置，2026-10-22 查阅）和 Radxa 在 GitHub 发布的 rsdk-b1 版本说明整理。

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