【产出】 > 不接显示器和键盘,用 Raspberry Pi Imager 写好系统、预先配置 Wi-Fi 和 SSH,开机后从电脑直接远程登录树莓派。
【版本】 > 按新版 Raspberry Pi Imager(设备 / 系统 / 存储 / 自定义分步界面)与 Raspberry Pi OS(Bookworm 及之后版本)编写,适用于树莓派 5 / 4B / 3B+ / Zero 2 W。
一、准备
| 项目 | 要求 |
|---|---|
| microSD 卡 | 带桌面的 Raspberry Pi OS 至少 32 GB;Lite 版至少 8 GB;容量必须小于 2 TB |
| 电源 | 见下表,务必用足功率的电源 |
| 读卡器 | 电脑能识别 microSD 卡即可 |
| 网络 | 树莓派和电脑在同一个局域网(同一个 Wi-Fi 或同一台路由器) |
电源要求(按官方文档):
| 型号 | 电压 / 电流 | 官方电源 |
|---|---|---|
| 树莓派 5、500 | 5 V / 5 A | 27 W USB-C |
| 树莓派 4B、400 | 5 V / 3 A | 15 W USB-C |
| 树莓派 3、2、1、Zero | 5 V / 2.5 A | 12.5 W Micro USB |
【注意】 > 树莓派 5 如果用 5 V / 3 A 的普通充电头供电,官方说明 USB 外设总电流会被限制在 600 mA,接移动硬盘、摄像头等设备时容易掉线。电压要求是指到达树莓派接口处的电压,细长的劣质线压降很大,同样会导致欠压。
二、用 Imager 写入系统
- 安装 Raspberry Pi Imager:Windows、macOS 从树莓派官网下载安装包;Ubuntu 等 Linux 可以用 AppImage。
- 打开 Imager,依次选择:
- 设备(Device):你的树莓派型号。
- 操作系统(OS):列表第一个就是该型号的推荐系统。无头使用、不需要桌面时,官方推荐选 Raspberry Pi OS Lite,占用更小、启动更快。
- 存储(Storage):选中你的 microSD 卡。保持勾选"排除系统盘(Exclude system drives)",防止误选电脑自己的硬盘。
- 下一步会进入 自定义(Customisation) 页面。无头使用时这一步必须填,见下一节。
三、自定义设置(无头登录的关键)
| 设置项 | 填写说明 |
|---|---|
| 主机名(Hostname) | 只能用字母、数字和连字符,例如 pi-lab。之后可以用 pi-lab.local 访问 |
| 本地化(Localisation) | 选择首都城市会自动填好时区和键盘布局,同时设置 Wi-Fi 国家代码。国内选 Beijing |
| 用户(User) | 用户名只能用小写字母、数字、下划线和连字符;这个密码也是之后 sudo 的密码 |
| Wi-Fi | 填写 Wi-Fi 名称和密码;隐藏网络要打开对应开关 |
| 远程访问(Remote Access) | 打开 SSH,选择密码登录或公钥登录 |
【注意】 > 无头模式下,第一次开机只能通过 SSH 或 Raspberry Pi Connect 远程访问,两者至少要开一个,否则只能接显示器。从 Bookworm 版本开始,往 boot 分区放
wpa_supplicant.conf配置 Wi-Fi 的老方法已经失效,网上很多旧教程还在用这个方法。
点击写入,等待写入和校验完成后,弹出 microSD 卡。
四、首次开机并登录
- 把卡插进树莓派,接通电源。首次开机会自动扩展分区并连接 Wi-Fi,等 1–3 分钟再连。
- 在电脑上打开终端(Windows 用 PowerShell 或 Windows Terminal),输入:
ssh 你的用户名@pi-lab.local
- 第一次连接会提示确认主机指纹,输入
yes,再输入密码即可登录。
.local 连不上怎么办:
- 部分 Windows 系统或路由器不支持 mDNS,可以改用 IP 地址。登录路由器管理页面,在已连接设备列表里找到主机名为
pi-lab的设备,记下 IP 后执行ssh 用户名@192.168.x.x。 - 也可以试试
ssh 用户名@pi-lab.lan,有些路由器会用.lan后缀登记设备。 - 一直找不到设备,说明 Wi-Fi 没连上。最常见的原因是 Wi-Fi 密码填错,或者用的是 5 GHz 频段但国家代码不对。先改用网线直连路由器排查。
五、登录后先做的几件事
# 更新软件包
sudo apt update && sudo apt full-upgrade -y
# 查看 IP、温度和电压状态
hostname -I
vcgencmd measure_temp
vcgencmd get_throttled
vcgencmd get_throttled 返回 throttled=0x0 表示一切正常。返回非零值说明出现过欠压或过热降频,优先检查电源和散热。
六、不用 Imager 时的手动方式
如果系统镜像是用其他工具写入的,也可以在 bootfs 分区手动开启 SSH:
- 在
bootfs分区根目录新建一个名为ssh的空文件(没有扩展名)。 - 新建
userconf.txt,内容为一行用户名:加密后的密码。加密后的密码用下面的命令生成:
openssl passwd -6
【提示】 > macOS 自带的 openssl 实际是 LibreSSL,不支持
-6参数。先执行openssl version检查,必要时用 Homebrew 安装 OpenSSL。手动方式不能配置 Wi-Fi,需要接网线开机。
评价 (0)