树莓派 4B 刷机教程：Raspberry Pi OS 写卡、USB 启动与刷 OpenWrt

先确认型号：树莓派 4B、400 还是 CM4

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

和树莓派 5 的区别：树莓派 4B 没有板载电源按键，也没有 PCIe 排线座和 RTC 电池座。是树莓派 5、500 或 CM5 的话，请看 树莓派 5 刷机教程。

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

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

应看到：第一行是 raspberrypi,4-model-b（4B）、raspberrypi,400（400）或 raspberrypi,4-compute-module（CM4）。

准备

• 电源：树莓派官方推荐 15W USB-C 电源（5V 3A）。
• microSD 卡：装桌面版建议 32 GB 以上，装精简版 8 GB 以上，容量不要超过 2 TB。
• 一台电脑和读卡器；本站的 Raspberry Pi Imager。
• 接显示器要用 micro-HDMI 转 HDMI 线。

下载哪个文件

树莓派官方系统 Raspberry Pi OS

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

带 armhf 的 32 位文件也能在树莓派 4 上运行，但只有老软件要求 32 位时才需要选。下载后核对页面上的 SHA-256，方法见 如何核对下载文件的 SHA-256。

OpenWrt 官方原版（做软路由）

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

方法一：用 Raspberry Pi Imager 写 microSD 卡

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

1. 把 microSD 卡插进电脑，打开 Raspberry Pi Imager。
2. 在“设备（Device）”页选 Raspberry Pi 4（400 或 CM4 选对应型号），点“下一步（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 从树莓派官网下载，就能进入自定义设置页。

警告写入会清空整张卡。

方法二：装到 USB 硬盘或 U 盘

树莓派官方说明树莓派 4B 支持从 USB 存储启动，启动程序默认先找 microSD 卡，再找 USB。

1. 用方法一的步骤，存储设备选你的 USB 硬盘或 U 盘，写入系统。
2. 拔掉树莓派上的 microSD 卡，插上 USB 硬盘，接电源开机。
3. 起不来的话，先用 microSD 卡开机，运行 sudo apt update && sudo apt full-upgrade 更新系统（早期的树莓派 4 可能要先更新启动程序才支持 USB 启动），再运行 sudo raspi-config，进入 6 Advanced Options → A4 Boot Order，确认启动顺序里包含 USB，重启后再试。

提示USB 硬盘耗电较大，同时接多块硬盘时，官方建议用带独立供电的硬盘盒或 USB 集线器。官方的 NVMe 启动方式不适用于树莓派 4B（只支持 CM4、树莓派 5 等型号）。

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

1. 用 7-Zip 把 openwrt-25.12.6-bcm27xx-bcm2711-rpi-4-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 的网页默认是英文界面。
• 树莓派 4B 只有一个网口，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-4-squashfs-sysupgrade.img.gz，在 LuCI 的 System → Backup / Flash Firmware 里刷入。详细步骤见 OpenWrt 升级固件。

刷坏了怎么救

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

资料来源

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

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