树莓派 5 刷机教程：Raspberry Pi OS 写卡、装到 NVMe 与刷 OpenWrt

先确认型号：树莓派 5、500 还是 CM5

本页写的是树莓派 5 这一代，三种外形用同一套系统文件：

和树莓派 4B 的区别：树莓派 5 板边有电源按键，还有 PCIe 排线座、RTC 电池座（标 BAT）和两个 CAM/DISP 排线口，4B 都没有。是 4B、400 或 CM4 的话，请看 树莓派 4B 刷机教程。

已经能开机的话，在终端运行下面的命令确认：

cat /proc/device-tree/compatible | tr '\0' '\n'

应看到：第一行是 raspberrypi,5-model-b（树莓派 5）、raspberrypi,500（500 / 500+）或 raspberrypi,5-compute-module（CM5）。

准备

• 电源：树莓派官方推荐 27W USB-C 电源（5V 5A）。用 5V 3A 电源也能开机，但 USB 口对外供电会被限制在 600 mA。
• microSD 卡：装桌面版建议 32 GB 以上，装精简版 8 GB 以上，容量不要超过 2 TB。
• 一台电脑和读卡器；本站的 Raspberry Pi Imager。
• 接显示器要用 micro-HDMI 转 HDMI 线。
• 想装到 NVMe 固态硬盘：还要树莓派 M.2 HAT+（或 M.2 HAT+ Compact）和一块 M.2 NVMe 硬盘。

下载哪个文件

树莓派官方系统 Raspberry Pi OS

打开 Raspberry Pi OS 下载页，文件名格式是 日期-raspios-版本-架构(-类型).img.xz。树莓派 5 选带 arm64 的 64 位文件：

trixie 是当前版本（Debian 13）。下载后核对页面上的 SHA-256，方法见 如何核对下载文件的 SHA-256。

OpenWrt 官方原版（做软路由）

在 树莓派 5 OpenWrt 页 下载。文件名里的 rpi-5 表示适用树莓派 5、500 和 CM5，不能刷到树莓派 4 上：

方法一：用 Raspberry Pi Imager 写 microSD 卡

Imager 有中文界面，下面括号里是英文界面的名称。

1. 把 microSD 卡插进电脑，打开 Raspberry Pi Imager。
2. 在“设备（Device）”页选 Raspberry Pi 5（500 或 CM5 选对应型号），点“下一步（Next）”。
3. 在“操作系统（OS）”页拉到最下面，选“使用自定义镜像（Use custom）”，选中下载好的 .img.xz，不用解压。
4. 在“储存设备（Storage）”页选你的 microSD 卡。保持勾选“排除系统驱动器（Exclude system drives）”，按容量认准是哪张卡。
5. 点“写入（Write）”，再点“我理解，擦除并写入（I understand, erase and write）”。写完后 Imager 会自动校验，等它显示完成，点“结束（Finish）”。
6. 把卡插进树莓派背面的卡槽，接上电源。

注意用“使用自定义镜像”写入本站下载的文件时，当前版本的 Imager（2.0）不会出现“自定义设置（Customisation）”页，不能提前设置用户名、Wi-Fi 和 SSH。需要提前设置的话，在 Imager 的系统列表里直接选 Raspberry Pi OS，由 Imager 从树莓派官网下载，就能进入自定义设置页。

警告写入会清空整张卡。

方法二：装到 NVMe 固态硬盘

树莓派官方的做法是先用 microSD 卡开机，再在树莓派上把系统写进 NVMe：

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

sudo apt update && sudo apt full-upgrade

1. 运行 sudo rpi-eeprom-update 查看启动程序日期。早于 2023 年 12 月 6 日的话，运行 sudo raspi-config，在 Advanced Options → Bootloader Version 里选 Latest 并退出，再运行 sudo rpi-eeprom-update -a，最后 sudo reboot 重启。
2. 断电，按官方说明装好 M.2 HAT+ 和 NVMe 硬盘，再开机。运行下面的命令：

ls -l /dev/nvme*

应看到：/dev/nvme0 和 /dev/nvme0n1。

1. 在树莓派上打开 Raspberry Pi Imager（没有的话运行 sudo apt install rpi-imager 安装），选 Raspberry Pi OS，存储设备选 NVMe 硬盘，写入。
2. 关机，拔掉 microSD 卡，再开机。不插卡时树莓派 5 会自动从 NVMe 启动。

想同时插着 microSD 卡又优先从 NVMe 启动：运行 sudo raspi-config，进入 6 Advanced Options → A4 Boot Order，选 B2 NVMe/USB Boot，退出后重启。

提示树莓派 5 也支持从 USB 硬盘或 U 盘启动。把系统写进 U 盘或 USB 硬盘、拔掉 microSD 卡即可；启动顺序同样在 A4 Boot Order 里改。

方法三：刷 OpenWrt 官方原版（做软路由）

1. 用 7-Zip 把 openwrt-25.12.6-bcm27xx-bcm2712-rpi-5-squashfs-factory.img.gz 解压成 .img（用 Raspberry Pi Imager 写入也可以直接选 .img.gz）。
2. 用 Imager 的“使用自定义镜像”或 balenaEtcher 把镜像写入 microSD 卡，插卡上电。
3. 用网线把电脑直接接到树莓派的网口，电脑网卡设为自动获取地址。

写好的卡里只有 64 MB 引导分区和 104 MB 系统分区，卡上其余空间默认不使用，这是 OpenWrt 官方镜像的正常分区方式。

第一次开机：怎么登录

Raspberry Pi OS

树莓派从 2022 年 4 月起取消了默认的 pi / raspberry 账号，现在没有通用的默认密码：

• 桌面版：接显示器和键盘，第一次开机会进入设置向导，依次设置国家和语言、创建用户名和密码、连接 Wi-Fi、选默认浏览器、更新软件。
• 精简版：没有向导，接显示器后在命令行按提示创建用户名和密码。
• 不接显示器（无头）用：写完卡后，在电脑上打开卡里的 bootfs 分区，新建一个名为 ssh 的空文件，再新建 userconf.txt，里面只写一行 用户名:加密后的密码。加密后的密码在电脑终端运行 openssl passwd -6 生成（macOS 自带的 LibreSSL 不支持 -6，要另装 OpenSSL）。这种方法只能用网线联网，从 Bookworm 版起放 wpa_supplicant.conf 配置 Wi-Fi 的老办法已经不能用了。
• 找到树莓派：默认主机名是 raspberrypi，在电脑上运行 ssh 用户名@raspberrypi.local；或者登录路由器后台查看它的 IP。更多方法见 开发板第一次登录。

OpenWrt

• 浏览器打开 外部资料（请使用来源按钮访问） root`，初始没有密码，登录后马上在 System → Administration 里设置密码。原版 OpenWrt 的网页默认是英文界面。
• 树莓派 5 只有一个网口，OpenWrt 默认把它设为 LAN 口，没有 WAN 口。要做路由器上网，需要再加一个网口（例如 USB 网卡，官方镜像已带 Realtek RTL8152 系列 USB 网卡驱动），在 Network → Interfaces 里设置 WAN。
• 不要把刚刷好的树莓派直接插到家里的路由器上：它会以 192.168.1.1 提供地址，可能和你家路由器冲突。
• 无线默认关闭。在 Network → Wireless 里先设置国家、加密方式和密码，再启用。

以后升级

• Raspberry Pi OS：在终端运行 sudo apt update && sudo apt full-upgrade，不用重新写卡。
• OpenWrt：下载新版的 rpi-5-squashfs-sysupgrade.img.gz，在 LuCI 的 System → Backup / Flash Firmware 里刷入。详细步骤见 OpenWrt 升级固件。

刷坏了怎么救

• 系统起不来：系统都装在卡或硬盘里，重新按方法一写一张卡就能恢复。看绿色指示灯的闪烁次数可以初步判断原因：短闪 4 次表示找不到启动文件，短闪 7 次表示找不到内核，短闪 8 次表示内存故障。
• 换了卡也不启动、或者改坏了启动设置：重置树莓派 5 板载的启动程序（bootloader）。用电脑上的 Imager，在“设备”页选 Raspberry Pi 5，“操作系统”页拉到最下面选 Misc utility images → Bootloader → SD Card Boot，写入一张空闲的 microSD 卡；插卡上电，等绿灯规律闪烁，并且显示器（如果接了）变成绿屏后断电，取出这张卡。这会清除之前改过的启动顺序等设置。
• CM5 的 eMMC 写坏了：按 树莓派计算模块 eMMC 刷机 用 rpiboot 重新写入。
• OpenWrt 设置乱了：重新写一张 factory 卡最省事；能登录时也可以在 System → Backup / Flash Firmware 里执行恢复出厂（Perform reset）。
• 想看启动日志：树莓派 5 用两个 micro-HDMI 口中间的 3 针串口座，波特率 115200，见 用 USB 转 TTL 串口调试开发板。

资料来源

按树莓派官方文档（安装系统、设置向导、无头设置、电源要求、启动顺序、NVMe 启动、M.2 HAT+、启动程序重置、指示灯代码）、树莓派官方博客 2022 年 4 月关于取消默认用户的说明、Raspberry Pi Imager 2.0 源码，以及 OpenWrt 官方源码中树莓派 5 的镜像定义与默认网络配置整理（2026-10-22 查阅）。本站 Raspberry Pi OS 为 2026-10-06 版，OpenWrt 为 25.12.6 官方原版。

提示本页按厂商官方文档整理，本站没有在实机上测试。接口位置和启动顺序以你的设备和树莓派官方说明为准。