Radxa Cubie A7A / A7S / A7Z 刷机教程：SD 卡、eMMC、UFS 安装 Radxa OS

先确认是哪一款 Cubie A7

Cubie A7A、A7S、A7Z 都用全志 A733 芯片，Radxa 给三款发布同一套 A733 通用镜像，但能用的存储和装系统的方法不一样。先按下表认出你的板子：

Cubie A5E 用的是 A527/T527 芯片，镜像不通用，请看 Cubie A5E 刷机教程。

准备

• 电源：5V USB-C 电源，支持 PD，电流 3A 以上。Radxa 推荐官方 PD 30W 电源。
• 存储：microSD 卡。装到 eMMC、UFS 或 NVMe，没有专用读卡器时也要先用 SD 卡开机。
• 一台电脑和读卡器；A7A 用模块的话，Radxa 有 eMMC/UFS 二合一模块读卡器可选。
• 散热：Radxa 提醒板子散热能力有限，长时间高负载建议加装散热片。

下载哪个文件

A733 通用镜像（三款都能用）

打开 Radxa Cubie A7A / A7S / A7Z 系统镜像页，当前版本是 rsdk-r6（Debian 11），每种系统有两种扇区格式：

文件名里的 512 和 4096 是镜像的扇区大小。UFS 用 4096 字节扇区，必须写 output_4096 版；SD 卡、eMMC、NVMe 写 output_512 版。Radxa 说明 UFS 启动需要 4096 版。

注意Radxa 下载页把 r6 标为“最新”并推荐使用，但 Radxa 在 GitHub 上把所有 A733 镜像（包括 r6）都标成了预发布，版本说明写着不对预发布和测试版提供支持。GitHub 上还有 t 开头的 Debian 13 测试版，Radxa 下载页没有列出，本站也没有收录。

Cubie A7S 专用：内置 OpenClaw 的测试镜像

Radxa Cubie A7S 系统镜像页 收录了 radxa_cubie_a733_trixie_cli_beta_v2.gpt.zip。这是 Radxa 在 A7S 下载页单独发布的 Debian 13 命令行测试版（beta），预装了 OpenClaw AI 助手环境，Radxa 说明它支持 microSD 卡和板载 eMMC 启动，只写了适用于 A7S。

• 文件名里的 gpt 表示它是带 GPT 分区表的整盘镜像，写法和上面的镜像一样。
• 压缩包里只有一个文件 radxa_cubie_a733_trixie_cli_beta_v2.gpt.img，先用 7-Zip 解压出来再写入。
• Radxa 没有为这个文件公布校验值，页面上的 SHA-256 是本站从 Radxa 官方下载地址获取时计算的。
• 不需要 OpenClaw 的话，选上面的 A733 通用镜像。

下载后核对页面上的 SHA-256，方法见 如何核对下载文件的 SHA-256。

方法一：装到 microSD 卡（三款都适用）

1. 用 7-Zip 把 .img.xz（或 .zip）解压成 .img。Radxa 要求用 balenaEtcher 写入前先解压；用 Raspberry Pi Imager 可以直接选 .img.xz。
2. 打开 balenaEtcher，点“从文件烧录”（Flash from file）选 output_512 镜像（A7S OpenClaw 镜像选解压出的 .gpt.img），点“选择目标”（Select target）选你的 microSD 卡，再点“现在烧录”（Flash!），等写入和校验都完成。
3. 把卡插进板子的 microSD 卡槽，接好显示器（A7S 用 USB-C 转 HDMI 或 DP 线），最后插上 USB-C 电源。

应看到：电源指示灯亮绿色；系统正常启动后，状态指示灯蓝色闪烁。KDE 版显示器出现桌面，命令行版出现登录提示。

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

方法二：在板子上用 dd 写入 eMMC 或 UFS

适用于 A7S 的板载 eMMC、A7Z 的板载 UFS，以及没有读卡器时 A7A 的 eMMC/UFS 模块。要先按方法一用 SD 卡开机。

1. A7A：断电后把 eMMC 或 UFS 模块按缺角方向对准二合一插座，先按下一端听到“咔哒”声，再按另一端；然后用 SD 卡开机。
2. 把镜像拷到板子上并解压。eMMC 用 output_512，UFS 用 output_4096：

sudo apt install xz-utils -y
unxz radxa-a733_bullseye_kde_r6.output_512.img.xz

1. 运行 lsblk，按容量找到目标盘：eMMC 一般显示为 /dev/mmcblk 开头（正在运行的 SD 卡也是 mmcblk 开头，别选错），UFS 一般显示为 /dev/sda。
2. 写入（把镜像名和设备名换成你自己的）：

sudo dd if=radxa-a733_bullseye_kde_r6.output_512.img of=/dev/mmcblk1 bs=4M status=progress

写 UFS 的示例：sudo dd if=radxa-a733_bullseye_kde_r6.output_4096.img of=/dev/sda bs=4M status=progress。

1. 写完运行 lsblk，应看到目标盘下出现 3 个新分区；UFS 也可以用 sudo fdisk -l /dev/sda 查看，扇区大小应显示 4096 字节。
2. 关机、断电，取下 microSD 卡，再插电源。

应看到：绿灯亮、蓝灯闪烁，系统从 eMMC 或 UFS 启动。

警告dd 会覆盖目标盘的全部数据。设备名写错可能把正在用的 SD 卡或别的盘清空。

A7A 有读卡器时

把 eMMC 或 UFS 模块装进 Radxa eMMC/UFS 二合一模块读卡器，插到电脑上，按方法一用 balenaEtcher 写入（eMMC 选 output_512，UFS 选 output_4096），再把模块装回板子的二合一插座。

方法三：Cubie A7A 装到 NVMe 固态硬盘

A7A 要通过 PCIe FPC 排线接 Radxa 的 PCIe 转 M.2 M Key 扩展板来装 NVMe，并先往板载 SPI 闪存写入引导程序。

1. 按方法一做好 SD 卡并开机，连上网络。
2. 运行 sudo rsetup，进入 System → System Update，按提示更新系统，完成后 sudo reboot。
3. 再次运行 sudo rsetup，进入 System → Bootloader Management → Update SPI Bootloader，用空格键选中 radxa-a733（Radxa 说明用 A733 通用镜像时选这一项），按回车，完成后重启。
4. 运行 lsblk 确认看到 nvme0n1，把 output_512 镜像解压后写入：

sudo dd if=radxa-a733_bullseye_kde_r6.output_512.img of=/dev/nvme0n1 bs=4M status=progress

1. 关机、断电，取下 microSD 卡后上电。

注意Radxa 的 A7A 快速上手页写着 NVMe“目前正常识别，可作为拓展存储空间，无法作为启动介质”，而 NVMe 安装页和下载页又给出了上面的 SPI 引导步骤，两处说法不一致。NVMe 启动不成功时，就先把 NVMe 当数据盘用。A7S、A7Z 的文档没有 NVMe 安装步骤页。

提示几种存储同时插着时，Radxa 公布的 A7A 启动顺序是 microSD 卡 > NVMe > UFS 模块 > eMMC 模块，A7S 是 microSD 卡 > 板载 eMMC。只要插着能启动的 SD 卡，就会先从 SD 卡启动。

第一次开机

• 默认账号：radxa，密码 radxa（Radxa OS 镜像）。登录后请先改密码。A7S 的 OpenClaw 测试镜像 Radxa 没有单独说明账号，先试 radxa / radxa。
• 主机名：A733 通用镜像是 radxa-a733。
• SSH：第一次开机时没有接显示器，系统会自动开启 SSH。接了显示器的话，在终端运行 sudo systemctl enable --now ssh 开启。
• 找 IP：登录路由器后台看名为 radxa-a733 的设备，然后在电脑上运行 ssh radxa@板子的IP。
• A7Z 没有网口：写好 SD 卡后先别拔，打开卡上的 before.txt，加一行 connect_wi-fi 你的WiFi名 你的WiFi密码，保存后再插回板子，开机会自动连 Wi-Fi。用 Wi-Fi 时装上随板附带的天线，否则信号弱、连接不稳。更多方法见 开发板无显示器首次配置。

刷坏了怎么救

• eMMC、UFS 或 NVMe 里的系统起不来：A7A 和 A7S 都是 microSD 卡启动优先，重新做一张 SD 卡插上就能开机，再按方法二或方法三重新写入。A7Z 的启动顺序 Radxa 没有公布，可以同样先试 SD 卡。
• UFS 写完不启动：先确认写的是 output_4096 版；写成 output_512 版的话重新写一次。
• 装了 NVMe 不启动：从 SD 卡开机，在 rsetup 里重新执行 Update SPI Bootloader；想撤销就选 System → Bootloader Management → Erase SPI Bootloader。
• A7A 接 HDMI 后启动报错：串口出现 Unhandled Exception in EL3 时，Radxa 建议换 32 GB 以上的高速 SD 卡、第一次开机先不接 HDMI、换 5V 3A 以上的电源，或换用更新的镜像。
• FEL 刷机模式：按住 UBOOT 键（A7S 为 USB BOOT 键）再用 USB 线接电脑上电，板子会进入全志 FEL 模式。这个模式配合 PhoenixSuit 刷 Radxa 的 Phoenix 格式镜像，本站暂未收录这类镜像和工具，需要时从文末“官方资料”进入 Radxa 页面获取。
• 想看启动日志：用 USB 转 TTL 串口，波特率 115200，GND、UART0_TX、UART0_RX 三根线分别接排针的 6、8、10 号脚，不要接 VCC。A7S 的排针和另外两款不同，接线前先对照 Radxa 的 A7S 串口接线图。详见 用 USB 转 TTL 串口调试开发板。

资料来源

按 Radxa 官方文档（Cubie A7A、A7S、A7Z 的快速上手、安装系统、硬件接口、FEL 模式、常见问题与资源汇总下载，2026-10-22 查阅）和 Radxa 在 GitHub 发布的 radxa-a733 rsdk-r6 版本说明整理。

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