AppGoBox

教程

树莓派 3B / Zero 2 W / Zero W 刷机教程:选对 32 位或 64 位系统写卡

树莓派 3B、3B+、Zero 2 W、Zero W 等老型号和小板子装 Raspberry Pi OS:按型号选 arm64 或 armhf 文件,用 Raspberry Pi Imager 写 microSD 卡,无头设置 SSH 与 Wi-Fi 的注意事项,附指示灯排错。约 15 分钟。

适用于树莓派官方系统 Raspberry Pi OS

先确认型号:选 64 位还是 32 位

这几款老型号和小板子装系统的步骤一样,都是写 microSD 卡,区别只在选哪个文件:

型号处理器选哪种文件网络
Raspberry Pi Zero 2 W64 位四核arm64(64 位)只有 2.4 GHz Wi-Fi,没有网口
Raspberry Pi 3B64 位四核arm64(64 位)2.4 GHz Wi-Fi + 网口
Raspberry Pi 3B+64 位四核arm64(64 位)2.4/5 GHz Wi-Fi + 网口
Raspberry Pi 3A+64 位四核arm64(64 位)2.4/5 GHz Wi-Fi,没有网口
Raspberry Pi Zero W / WH32 位单核只能用 armhf(32 位)只有 2.4 GHz Wi-Fi,没有网口
Raspberry Pi Zero / Zero H32 位单核只能用 armhf(32 位)没有无线也没有网口
Raspberry Pi 1、232 位用 armhf(32 位)1B、1B+、2B 有网口,没有无线

Zero 2 W 和 Zero W 外形尺寸相同,容易拿错。分不清时可以先用 32 位精简版开机,运行下面的命令:

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

应看到:第一行是 raspberrypi,model-zero-2-w(Zero 2 W)、raspberrypi,model-zero-w(Zero W)、raspberrypi,3-model-b-plus(3B+)或 raspberrypi,3-model-b(3B)等。

树莓派 4B、400、5 和计算模块请看各自的教程:树莓派 4B 刷机教程、树莓派 5 刷机教程。

准备

  • 电源:树莓派官方推荐 5V 2.5A 的 micro USB 电源。Zero 系列有两个 micro USB 口,电源要插标着 PWR IN 的那个。
  • microSD 卡:精简版 8 GB 以上,桌面版 32 GB 以上。Zero、初代树莓派和早期树莓派 2 只能从不超过 256 GB 的启动分区启动,建议直接用 256 GB 以下的卡。
  • 一台电脑和读卡器;本站的 Raspberry Pi Imager。
  • Zero 系列接显示器要用 mini-HDMI 转 HDMI 线,接键盘要用 micro USB OTG 转接头;同时接键盘和鼠标要加带电源的 USB 集线器。

下载哪个文件

打开 Raspberry Pi OS 下载页,文件名格式是 日期-raspios-版本-架构(-类型).img.xz:

文件名用途
…-raspios-trixie-arm64-lite.img.xz / …-armhf-lite.img.xz精简版,没有桌面。官方说明精简版适合初代树莓派、树莓派 2 和 Zero 这类老型号
…-raspios-trixie-arm64.img.xz / …-armhf.img.xz桌面版
…-raspios-trixie-arm64-full.img.xz / …-armhf-full.img.xz完整版,多装 LibreOffice 等软件,占空间大
…-raspios-bookworm-…Legacy 旧版(Debian 12),只在你的软件明确要求旧版时选

arm64 和 armhf 按上面的型号表选。下载后核对页面上的 SHA-256,方法见 如何核对下载文件的 SHA-256。

本站暂未收录这些型号的 OpenWrt 文件,本页只介绍 Raspberry Pi OS。

写入 microSD 卡

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

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

注意用“使用自定义镜像”写入本站下载的文件时,当前版本的 Imager(2.0)不会出现“自定义设置(Customisation)”页,不能提前设置用户名、Wi-Fi 和 SSH。Zero W 和 Zero 2 W 没有网口,不接显示器使用时必须提前设置 Wi-Fi:请在 Imager 的系统列表里直接选 Raspberry Pi OS(由 Imager 从树莓派官网下载),在“自定义设置(Customisation)”里填好用户和 Wi-Fi,并在“远程访问(Remote access)”里打开“开启 SSH(Enable SSH)”。也可以给它接 USB 网卡改用网线,再按下面的 ssh + userconf.txt 方法设置。

提示树莓派 3B+ 和 Zero 2 W 也能直接从 U 盘启动,写法相同,存储设备选 U 盘即可。树莓派 3B、3A+ 要先永久改写芯片里的一次性设置才能从 USB 启动,本页不建议这样做。

第一次开机:怎么登录

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

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

以后升级

在终端运行 sudo apt update && sudo apt full-upgrade,不用重新写卡。

刷坏了怎么救

  • 这些型号没有板载启动程序,启动文件都在 microSD 卡里,重新写一张卡就能恢复。
  • 看绿色指示灯判断原因:短闪 4 次表示找不到启动文件,短闪 7 次表示找不到内核,短闪 8 次表示内存故障。多半是卡没写好、选错了 32/64 位文件,或者卡本身坏了,换卡重写一次。
  • Zero 系列开机后再插 USB 设备,电压下降可能导致重启。先接好 USB 设备再上电,或用带电源的集线器。
  • 想看启动日志:串口在 40 针排针上,GPIO14(8 号针,TX)和 GPIO15(10 号针,RX),波特率 115200;Raspberry Pi OS 里要先在 raspi-config 的 Interface Options → Serial Port 打开。见 用 USB 转 TTL 串口调试开发板。

资料来源

按树莓派官方文档(Zero 系列与各型号规格、联网能力表、电源要求、启动介质、安装系统、设置向导、无头设置、USB 启动、指示灯代码、串口)、树莓派官方博客 2022 年 4 月关于取消默认用户的说明,以及 Raspberry Pi Imager 2.0 源码整理(2026-10-22 查阅)。本站 Raspberry Pi OS 为 2026-10-06 版。

提示本页按厂商官方文档整理,本站没有在实机上测试。接口位置以你的板子和树莓派官方说明为准。

适用的固件与系统镜像(1)

按适用范围匹配到 1 个固件条目。下载前仍需核对具体型号和硬件版本。

整理:AppGoBox · 依据 · 本站未在实机上逐一验证