树莓派忘记密码？三步进入单用户模式重置密码
1. 问题场景与核心思路
树莓派玩久了，密码忘了，这事儿太常见了。不管是自己设的复杂密码时间一长忘了，还是接手了别人的二手板子，又或者是在某个项目里临时改了密码没记录，结果重启后直接傻眼，进不去系统。看着登录提示符，输入啥都提示“Authentication failure”，那种感觉确实挺让人上火的。尤其是当你的树莓派正跑着一个重要的服务，或者里面存了没备份的数据时，这种焦虑感会加倍。
别慌，这个问题有标准解法，而且几乎对所有基于Linux的树莓派系统（Raspberry Pi OS， 包括旧版的Raspbian， 以及Ubuntu for Raspberry Pi等）都有效。核心思路其实很简单：绕过正常的系统启动流程，直接以单用户模式（Single User Mode）或恢复模式（Recovery Mode）进入一个拥有root权限的Shell。在这个Shell里，系统不会要求你输入任何用户密码，你可以直接修改任意用户的密码，包括默认的pi用户和root用户。听起来是不是有点像拿到了“万能钥匙”？原理上确实如此。
这个方法之所以“亲测有效”，是因为它利用了Linux内核的启动参数机制。我们通过修改SD卡上引导分区里的一个关键配置文件，告诉内核：“这次启动别进正常的图形界面或多用户模式了，直接给我开个root shell。” 这个操作不需要你懂高深的Linux内核知识，只需要你能把树莓派的SD卡拔出来，插到另一台电脑（Windows、macOS或Linux都行）上，进行简单的文件编辑即可。整个过程不涉及重装系统，不会丢失你SD卡里已有的任何数据，属于一种“外科手术式”的精准修复。
2. 准备工作与工具选择
在动手之前，我们需要做好两件事：找到正确的SD卡和准备一台可以读写它的电脑。
2.1 识别与取出SD卡
首先，确保你的树莓派已经完全断电。然后找到SD卡插槽，轻轻按下SD卡使其弹出，或者直接拔出（视树莓派型号而定）。树莓派Zero/1/2/3/4/5的SD卡槽位置略有不同，但操作大同小异。取出的这张小小的存储卡，就是承载整个树莓派系统的“硬盘”。
2.2 选择读卡器与电脑
你需要一个匹配你SD卡规格的读卡器。现在常见的树莓派SD卡多是MicroSD卡，所以需要一个MicroSD to USB的读卡器。如果你的笔记本电脑自带SD卡插槽，也可以直接插入。确保你使用的电脑（我们称之为“宿主机”）系统是Windows、macOS或Linux之一，因为后续操作在这三个平台上略有差异，但核心步骤一致。
这里有个关键点：宿主机系统需要能识别并挂载FAT32文件系统。因为树莓派的引导分区（boot partition）格式化为FAT32，这是为了保证最大兼容性，让树莓派的固件能够读取。Windows和macOS原生支持FAT32的读写，所以通常插上就能在“文件资源管理器”或“访达”里看到一个新的盘符或设备。对于Linux，它也会自动挂载，通常出现在/media/或/run/media/目录下。
2.3 为什么是FAT32和cmdline.txt？
这里稍微展开一下原理。树莓派上电后，GPU（图形处理器）中的第一阶段引导加载程序（bootloader）会先运行，它从SD卡的第一个分区（必须是FAT32格式）中加载后续的固件和内核。这个分区我们通常称为“引导分区”或“boot分区”。在这个分区里，有几个关键文件：
kernel.img或kernel8.img等：Linux内核镜像文件。config.txt：硬件配置参数文件。cmdline.txt：内核启动参数文件。这就是我们本次操作的核心目标。
cmdline.txt文件里是一行长长的文本，里面包含了传递给Linux内核的各种参数，比如根文件系统（root filesystem）的位置、控制台设备等。我们要做的，就是在这行参数的末尾，添加一个特殊的参数，来改变系统的启动行为。
3. 分步操作指南（Windows/macOS/Linux）
现在，我们进入实操环节。请根据你的宿主机操作系统，选择对应的步骤。
3.1 在宿主机上访问引导分区
- Windows：将SD卡通过读卡器插入电脑。稍等片刻，打开“此电脑”，你会看到多出一个可移动磁盘，盘符可能是D:、E:、F:等。双击打开它。你应该能看到
kernel.img、config.txt、cmdline.txt等文件。如果看不到，可能是磁盘管理里没有分配盘符，或者SD卡损坏。如果只看到一个要求格式化的提示，千万不要格式化，这很可能意味着你找错了分区（看到了后面的EXT4 Linux数据分区，Windows无法直接识别）。此时你需要使用磁盘管理工具确认哪个是FAT32分区。 - macOS：插入SD卡后，桌面通常会显示一个名为“boot”的磁盘图标。双击打开即可。如果没有显示，可以打开“访达”，在“位置”侧边栏里应该能找到它。同样，里面应包含上述关键文件。
- Linux：插入SD卡后，系统通常会将其自动挂载。你可以打开文件管理器，在侧边栏的“设备”下找到它，名称可能也是“boot”。或者，你可以在终端里输入
lsblk或sudo fdisk -l命令来查看新增的磁盘设备（如/dev/sdb1），然后使用mount命令查看其挂载点，通常会在/media/[你的用户名]/boot或/run/media/[你的用户名]/boot路径下。
注意：在macOS和某些Linux发行版上，这个分区可能被挂载为只读。如果出现无法保存文件的情况，你可能需要先卸载再以读写方式重新挂载，或者使用
sudo权限来编辑文件。
3.2 定位并备份cmdline.txt
在引导分区根目录下，找到cmdline.txt文件。在编辑它之前，强烈建议先做一个备份。这是一个好习惯，万一操作失误，我们可以轻松恢复。备份方法很简单：将其复制一份，重命名为cmdline.txt.backup或cmdline.txt.bak。
3.3 编辑cmdline.txt文件
用任何纯文本编辑器打开cmdline.txt，例如Windows的记事本（Notepad）、macOS的文本编辑（TextEdit，需设置为纯文本模式），或者Linux的gedit、nano、vim等。不要使用Word、Pages这类富文本编辑器，它们可能会引入隐藏的格式字符导致系统无法启动。
打开后，你会看到一行内容，可能类似这样（具体内容因系统版本和配置而异）：
console=serial0,115200 console=tty1 root=PARTUUID=xxxxxx-02 rootfstype=ext4 fsck.repair=yes rootwait quiet init=/usr/lib/raspi-config/init_resize.sh或者更简洁的：
console=serial0,115200 console=tty1 root=/dev/mmcblk0p2 rootfstype=ext4 fsck.repair=yes rootwait我们的任务是在这行内容的最后，先添加一个空格，然后加上以下参数之一：
方案A：添加init=/bin/sh这是最经典的方法。将内核的初始化进程（init）直接替换为/bin/sh这个Shell。系统启动后，会跳过所有正常的服务启动、登录管理，直接给你一个root权限的Shell。
... rootwait quiet init=/usr/lib/raspi-config/init_resize.sh **init=/bin/sh**（注意：如果原行末尾已有init=...，比如上面的init_resize.sh，你可以直接覆盖它，或者在其后添加。为了保险起见，我通常选择覆盖，即删除原有的init=...部分，替换为init=/bin/sh。）
方案B：添加systemd.unit=rescue.target（适用于使用systemd的系统，如新版Raspberry Pi OS）这个方法更“优雅”一些，它告诉systemd（系统和服务管理器）进入救援模式（rescue target）。救援模式也会提供一个root shell，并且会尝试挂载所有文件系统，比单纯的init=/bin/sh环境更完整一些。
... rootwait **systemd.unit=rescue.target**方案C：添加single或1这是传统的Unix/Linux进入单用户模式的方式。在某些系统上可能有效，但在树莓派上，尤其是使用systemd的系统中，不如前两种方法可靠。
... rootwait **single**我个人最推荐方案Ainit=/bin/sh，因为它最直接、兼容性最广，几乎在所有情况下都有效。编辑完成后，保存文件。
3.4 一个重要的细节：文件末尾换行符这是一个极易被忽略但可能导致失败的坑。确保你编辑保存后的cmdline.txt文件，最后一行末尾没有多余的换行符（空行）。也就是说，你的光标应该紧跟在添加的参数（如init=/bin/sh）之后，不要在后面按回车键。在Linux下可以用cat -A cmdline.txt检查，行尾应该只有$（代表换行），如果后面还有^M$之类的就是多了空行。在Windows记事本里编辑尤其容易产生这个问题。稳妥的做法是使用像Notepad++、VS Code、Sublime Text这类能显示行尾符的编辑器，并确保保存为Unix（LF）格式，或者直接用echo命令追加（Linux/macOS下）。
3.5 安全弹出SD卡并启动树莓派
编辑并保存好cmdline.txt后，在宿主机上安全地弹出或卸载SD卡。在Windows上，点击任务栏的“安全删除硬件”图标；在macOS上，将“boot”磁盘拖入废纸篓（此时废纸篓图标会变成弹出图标）；在Linux上，使用umount命令。
将SD卡插回树莓派，连接电源和显示器（如果需要观察启动过程），上电启动。
4. 进入恢复Shell与修改密码
如果一切顺利，树莓派将不会进入正常的图形登录界面或命令行登录提示。屏幕可能会显示一系列内核启动信息，最后停在一个命令提示符，可能类似#或root@(none):/#，也可能没有任何提示符，只有一个闪烁的光标。这说明你已经进入了拥有root权限的Shell环境。
4.1 挂载根文件系统为可读写
当我们使用init=/bin/sh启动时，根文件系统（/）通常是以只读（read-only）方式挂载的。这是Linux的一种安全机制。而修改密码需要向/etc/shadow文件写入数据，因此我们必须先将其重新挂载为可读写模式。
在Shell提示符下，输入以下命令并回车：
mount -o remount,rw /mount是挂载命令，-o指定选项，remount表示重新挂载，rw表示读写（read-write），/表示根目录。执行成功后不会有太多提示，但接下来你就可以修改系统文件了。
4.2 修改用户密码
现在可以使用passwd命令来修改密码了。
修改默认用户
pi的密码：passwd pi系统会提示你输入新的密码，然后再次确认输入。为了安全，密码在输入时是不显示任何字符（星号也没有）的，这是正常现象，放心输入即可。
Enter new UNIX password: Retype new UNIX password: passwd: password updated successfully看到
successfully就表示成功了。修改
root用户密码（可选）： 如果你也想设置或修改root用户的密码，可以执行：passwd root同样按照提示输入两次新密码。
4.3 为什么是passwd命令？
passwd是Linux下标准的修改用户密码的命令。它会做几件事：1) 提示用户输入新密码；2) 对密码进行哈希加密（现代系统通常使用SHA-512等强哈希算法）；3) 将加密后的哈希值写入/etc/shadow文件。/etc/shadow文件存储了所有用户的密码哈希，普通用户无法读取，只有root有权修改，这就是为什么我们必须获得root shell才能操作。
4.4 同步数据并重启
密码修改完成后，建议执行一次sync命令，它将所有缓存中的数据写入磁盘，确保修改被持久化保存。
sync现在，我们可以重启树莓派了。由于当前Shell是唯一的进程，直接断电重启可能不太优雅。我们可以使用exec命令来执行重启：
exec /sbin/reboot或者，如果reboot命令不可用，也可以使用：
exec /sbin/shutdown -r now如果上述命令都报错，最直接的方法就是物理断电再上电。因为密码已经写入磁盘，所以不用担心数据丢失。
5. 验证与恢复原配置
树莓派重启后，会使用正常的启动参数启动。此时，你应该可以使用新设置的密码登录pi用户了。
5.1 一个重要的事后步骤：恢复cmdline.txt
成功登录后，切记要恢复之前修改的cmdline.txt文件。如果不恢复，下次启动树莓派又会直接进入单用户模式，这等于在系统门口留了一把万能钥匙，存在严重的安全风险。
恢复方法有两种：
在树莓派系统内恢复：登录系统后，打开终端，因为
cmdline.txt在引导分区，而引导分区默认可能没有挂载。我们可以手动挂载或直接编辑。最简单的方法是：sudo nano /boot/cmdline.txt删除你之前添加的
init=/bin/sh或systemd.unit=rescue.target等参数，确保其恢复原样。然后按Ctrl+X，再按Y，最后回车保存退出。再次通过宿主机恢复：如果觉得麻烦，也可以像步骤3那样，再次将SD卡插到宿主机上，用备份文件
cmdline.txt.backup覆盖cmdline.txt，或者手动编辑删除添加的参数。
5.2 验证登录
使用新密码通过SSH或直接接显示器键盘登录，确认一切功能正常。如果修改的是pi用户密码，图形界面（如果安装了）的登录也应该使用新密码。
6. 可能遇到的问题与深度排查
虽然上述方法在绝大多数情况下有效，但实践中可能会遇到一些“意外”。下面我们来拆解几个常见问题及其背后的原因。
6.1 启动后依然卡在登录界面，密码错误
- 可能性1：
cmdline.txt修改未生效。检查你是否编辑了正确的cmdline.txt文件（确保在boot分区），并且保存无误。特别检查文件末尾是否有多余空行。可以重新用宿主机查看文件内容确认。 - 可能性2：键盘布局问题。如果你在恢复Shell里设置密码时，键盘布局是默认的US（美式），但平时登录时系统使用的是其他布局（如中文输入法状态），那么你实际输入的字符可能和你想的不一样。例如，在US布局下按某些键，在其他布局下可能对应不同符号。建议在恢复Shell设置密码时，使用简单的数字和字母组合，并暂时关闭宿主机的输入法。
- 可能性3：文件系统挂载失败。如果根文件系统损坏，即使你修改了密码，系统在正常启动时也无法读取
/etc/shadow文件。启动时观察内核信息，看是否有fsck（文件系统检查）的错误，或者mount根文件系统失败的提示。这种情况可能需要更深入的磁盘修复。
6.2 启动后黑屏或无法进入恢复Shell
- 可能性1：内核参数错误导致内核恐慌（Kernel Panic）。仔细检查
cmdline.txt的语法，参数之间必须以空格分隔，且不能有语法错误。错误的参数可能导致内核无法启动。恢复备份文件重试。 - 可能性2：SD卡或读卡器接触不良/损坏。尝试换一个读卡器或电脑USB口。极端情况下，SD卡本身寿命已到，会出现读写错误。
- 可能性3：针对树莓派4/5及更新机型的注意事项。这些机型支持USB启动、网络启动等，其引导流程更复杂。确保你的SD卡里安装的是兼容的系统。如果之前玩过USB启动，记得切换回SD卡启动。
6.3 在恢复Shell中找不到passwd命令或提示只读文件系统
passwd命令找不到：这通常是因为/usr/bin等路径没有设置，或者环境非常精简。可以尝试使用绝对路径：/usr/bin/passwd pi。如果还是不行，可以尝试chroot到真正的根环境，但这比较复杂。更简单的方法是直接手动编辑/etc/shadow文件（不推荐新手操作，风险高）。- 只读文件系统：如果你忘记了执行
mount -o remount,rw /，或者执行失败了，就会遇到“Read-only file system”错误。务必先执行这个命令。如果执行后依然报错，可能是文件系统有错误，内核自动以只读方式挂载以防止进一步损坏。可以尝试运行fsck -y /dev/mmcblk0p2（假设根分区是mmcblk0p2，请根据实际情况调整）来修复文件系统，然后再重新挂载。
7. 安全强化与预防措施
通过这次“忘记密码”的修复，我们实际上暴露了树莓派（以及许多Linux设备）的一个潜在安全风险：物理接触意味着几乎完全的控制权。因此，除了解决问题，我们更应该思考如何预防和加强安全。
7.1 预防密码遗忘
- 使用密码管理器：将树莓派等重要设备的密码保存在Bitwarden、KeePass等密码管理器中。
- 设置强密码并记录在安全的地方：避免使用简单密码，并将密码记录在只有自己能访问的物理笔记本或加密文件里。
- 启用SSH密钥认证，禁用密码登录：这是最佳实践。在树莓派上生成SSH密钥对，将公钥添加到
~/.ssh/authorized_keys文件中，然后在SSH服务配置（/etc/ssh/sshd_config）中设置PasswordAuthentication no。这样，只能通过私钥登录，根本不需要记忆密码。 - 为
pi用户设置易记但复杂的密码：如果必须用密码，可以设计一个对自己有特殊意义但别人难以猜测的短语。
7.2 缓解单用户模式风险
既然攻击者（或捡到你设备的人）可以通过修改cmdline.txt进入单用户模式，我们能否防御呢？
- 给SD卡加锁？理论上可以给SD卡设置写保护，但树莓派系统运行时也需要写入（日志、临时文件等），所以不现实。
- 全盘加密（LUKS）：这是最安全的方法。将根文件系统加密，启动时需要输入解密密码。这样，即使别人拔出SD卡，也无法读取其中的数据，更别提修改
cmdline.txt了（因为/boot分区仍需保持未加密以供引导）。但配置相对复杂，且如果忘记解密密码，数据将永久丢失。 - 设置GRUB密码：对于使用GRUB引导的高级用户，可以给GRUB菜单设置密码，防止他人修改启动参数。但树莓派默认不使用GRUB，而是使用自己的引导流程，此方法不适用。
- 物理安全是根本：将树莓派放置在安全的物理环境中，是最有效且最简单的安全措施。
7.3 定期备份与镜像
养成定期备份重要数据的习惯。对于树莓派，可以使用dd命令或Win32 Disk Imager等工具对整个SD卡进行全量镜像备份。这样，即使SD卡损坏或系统完全崩溃，也可以快速从备份恢复。
忘记树莓派密码是一个典型的“小问题，大麻烦”。通过修改cmdline.txt进入单用户模式的方法，我们巧妙地利用了Linux系统的灵活性解决了这个问题。整个过程的核心在于理解Linux的启动流程和内核参数的作用。操作本身并不复杂，但细节决定成败：正确的分区访问、准确的参数编辑、文件系统的重新挂载，每一步都需要细心。
从我个人的经验来看，成功操作几次后，你会发现这几乎成了树莓派玩家的必备技能。不过，在享受这种“后门”便利的同时，一定要意识到它对应的安全风险。操作完成后，务必记得恢复cmdline.txt文件。对于部署在外的树莓派，强烈建议采用SSH密钥认证，并尽可能保证其物理安全。技术是把双刃剑，既能救急，也可能成为漏洞，关键在于我们如何使用它。