Debian 13 教程 / 排查启动故障并使用救援环境检查initramfs
通过识别最后正常工作的阶段来诊断 Debian 13 的启动失败:固件、引导加载程序、内核、初始文件系统或 systemd。不要仅因为 SSH 连接失败就断定启动失败;您需要检查控制台、实际的根分区和启动分区,以及已安装的内核。本篇说明如何在正常系统上创建和检查独立initramfs,并明确实际故障时救援操作的目标、适用条件与修改范围。
识别启动阶段并区分 SSH 故障
统一可扩展固件接口(UEFI,Unified Extensible Firmware Interface)是初始化硬件并找到启动程序的固件。GNU GRand Unified Bootloader(GRUB)是一个引导程序,它读取并执行内核和初始 RAM 文件系统(initramfs)。initramfs 的初始用户空间帮助查找根设备并切换到实际的根。之后,systemd 配置服务和登录环境。
| 控制台上可见的状态 | 初步调查 | 不应立即执行的任务 |
|---|---|---|
| 找不到启动设备 | 磁盘连接,固件启动顺序,EFI 系统分区 | 不要重新初始化根文件系统。 |
| GRUB 菜单或命令行 | 引导文件路径、配置和设备标识 | 不要无条件将 BIOS 命令应用于 UEFI。 |
| 内核消息或 initramfs shell | 已选择的内核、根 UUID、存储模块和加密/LVM | 不要假定运行环境的内核就是恢复目标版本。 |
| 紧急模式或服务故障 | fstab、挂载点、受影响的单元和日志 | 不要将重新安装 GRUB 视为通用修复方法。 |
| 有登录界面,但 SSH 失败。 | 地址,路径,防火墙,sshd,认证 | 不要从 SSH 失败推断内核启动失败。 |
记录错误屏幕上的文本、所选内核,以及更改之前的操作和时间。对于像 VirtualBox 这样的虚拟机,检查是否可以直接访问虚拟机的控制台。在此测试虚拟机中,已确认控制台登录提示和正常的 SSH,因此没有在导致系统无法启动的状态下进行操作。
检查正在运行的内核和实际启动挂载点
请在系统能够正常启动时,将以下信息另行保存。uname -r 是当前运行的内核,而不是所有已安装内核的列表。dpkg-query 输出中的 ii 表示已安装状态,而像 un 这样的条目不算作已安装内核。
uname -r
dpkg-query -W -f='${binary:Package} ${db:Status-Abbrev} ${Version}\n' 'linux-image*'
ls -l /boot/vmlinuz-* /boot/initrd.img-*
ls /usr/lib/modules
test -d /sys/firmware/efi && echo 'Booted with UEFI'
findmnt --target / -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --mountpoint /boot/efi -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /boot /boot/efi /var/tmp
readlink -f /vmlinuz /initrd.img
在 BIOS 启动时,EFI 目录测试可能返回非零值,并且可能不存在专用的 EFI 挂载。请将这些解释为布局观察,而不是启动失败的证据。UUID(Universally Unique Identifier,通用唯一标识符)用于识别文件系统,不易受设备名变化影响;重建或克隆后仍需核对实际值与重复情况。请根据实际设备进行验证,而不是从本实验中复制名称。
测试虚拟机使用的是 UEFI,GRUB 2.12,内核 6.12.107+deb13-amd64,initramfs-tools 0.148.4。/boot 包含在根 ext4 中,而不是单独的分区,只有 /boot/efi 是单独的 vfat 分区。即使 /boot 相同,服务器可能有不同的单独分区、LVM 或加密,因此设备名称不会被复制使用。
GRUB 菜单允许在普通系统上进行语法检查和项目验证,如下所示。语法成功并不保证固件启动、磁盘读取或内核执行。
sudo grub-script-check /boot/grub/grub.cfg
sudo grep -E "^(menuentry|submenu)|^[[:space:]]+menuentry " /boot/grub/grub.cfg
grub-script-check 手册 描述了配置语法检查。grub.cfg 是生成的输出;对于永久性更改,应检查源配置和生成过程,而不是直接编辑该输出。
准备控制台访问并检查是否有旧内核
如果在安装新内核后出现问题,并且之前的内核实际上已安装,您可以通过在 GRUB 控制台中打开Advanced options for Debian GNU/Linux(Debian GNU/Linux高级选项)来查看如何启动到之前的版本。根据虚拟机固件和设置的不同,菜单项键和显示时间可能会有所不同,因此请在正常状态下验证访问方法。
验证用的虚拟机实际上只安装了一个内核,并且 GRUB 中的标准和恢复项目都是版本 6.12.107。恢复模式条目并不是之前的内核。如果没有其他版本,这并不表明选择之前的内核能够解决问题。
如果您已经启动到之前的内核,请检查 uname -r、服务、网络和数据,并保留有问题的内核和日志。不要先删除已知能正常工作的内核。如果无法启动到任何内核,请准备控制台访问并从安装 ISO 进行救援并执行备份。在这里,我们进行以下单独镜像操作,不替换任何正常启动文件。
保留启动文件并创建单独的 initramfs
mkinitramfs 为指定的内核创建一个初始文件系统映像。此练习将结果保存到仅 root 可访问的备份路径,而不会覆盖 /boot。/var/tmp 可以用作默认的临时工作区,因此请检查可用空间和执行权限。实际工具的临时路径条件可以在 mkinitramfs 文档 中找到。
以下完整代码块是在具有 sudo 权限的普通 Debian 系统的终端中执行的。如果存在同名路径,则执行会停止,并且不会覆盖现有记录。
sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-debian13-32
if test -e "$dest"; then echo "Destination already exists." >&2; exit 1; fi
install -d -m 700 "$dest"
kernel=$(uname -r)
test -f "/boot/vmlinuz-$kernel"
test -f "/boot/initrd.img-$kernel"
test -d "/usr/lib/modules/$kernel"
sha256sum "/boot/vmlinuz-$kernel" "/boot/initrd.img-$kernel" /boot/grub/grub.cfg > "$dest/boot-before.sha256"
cp -a /etc/fstab /etc/default/grub /etc/initramfs-tools/initramfs.conf "$dest/"
mkinitramfs -o "$dest/initrd-lab.img" "$kernel"
lsinitramfs "$dest/initrd-lab.img" > "$dest/initrd-lab-files.txt"
grep -Fx init "$dest/initrd-lab-files.txt"
grep -F "usr/lib/modules/$kernel/" "$dest/initrd-lab-files.txt" > "$dest/kernel-module-files.txt"
test -s "$dest/kernel-module-files.txt"
stat -c 'image bytes=%s' "$dest/initrd-lab.img"
sha256sum -c "$dest/boot-before.sha256"
ROOT
执行结果确认了 init 入口和相应的内核模块路径,独立镜像的大小为 38,975,420 字节。大小可能因创建条件和包而异。原始 vmlinuz、initrd.img 和 grub.cfg 的哈希值均正常。创建独立镜像并验证列表与实际使用该镜像启动是不同的。
列出工具的角色和支持范围在 lsinitramfs 文档 中有详细说明。需要在实际系统配置上进行额外验证,以确保所需的存储设备驱动、根 UUID 以及 LVM/加密设置正确。仅仅拥有大量文件并不能确定镜像是否可恢复。
在实际故障时检查救援环境和目标根目录
本节是一个恢复程序,用于确定在确认实际启动故障时的适用条件。在上述虚拟机上,正常启动文件未被更改,救援中也未进行实际文件替换。如 《Debian 安装手册》的救援部分 所述,选择安装介质的rescue启动项或使用 rescue/enable=true 来选择要恢复的根目录。
- 确保服务器控制台和备份/恢复手段,并使用与现有磁盘和 EFI 启动方式匹配的安装介质启动。
- 选择救援模式,完成语言和硬件检查,然后选择实际安装的根文件系统。不要继续执行新安装的分区初始化阶段。
- 检查这是选定根文件系统内的 shell 还是安装程序自身的 shell。如果是在选定根文件系统内的 shell,那么您已经在该环境中工作,因此不要再 chroot 到 /target。
- 在安装程序的 shell 中,选定的根文件系统可能已挂载在 /target。将该目录下的操作系统和 fstab 与实际设备进行比较,如果有单独的 /boot 或 EFI,请正确连接它们,然后在目标环境中工作。
以下命令在安装程序环境的root shell 中执行以验证目标。由于这是root shell,请不要使用 sudo 前缀。只有当 /target 是实际选择的根时,这才有意义。
lsblk -f
findmnt -R /target
cat /target/etc/os-release
cat /target/etc/fstab
ls /target/usr/lib/modules
ls -l /target/boot
加密、RAID 和 LVM 必须首先能够使用相应的存储层。不要将这个简单的 ext4 和 UEFI 示例直接应用到这些存储布局上。如果根本身由于损坏而无法读取,首先确定文件系统检查和备份恢复的条件,不要将 e2fsck 应用于已挂载的根目录。
如果安装程序 shell 中需要手动 chroot,/target 必须是正确的根目录并且能够执行目标 shell。如果有单独的 /boot,则先将其挂载到目标路径 /target/boot,并且 EFI 系统分区应使用实际的 UUID 挂载到 /target/boot/efi。不要重复已经连接的项,并使用 findmnt 结果进行验证。
在确定并挂载正确的启动分区后,以下块会绑定运行时文件系统。在遇到任何挂载命令失败时停止,并在继续之前检查 findmnt -R /target。递归从属传播可防止目标下的卸载操作向救援环境传播。chroot 会更改表观的文件系统根目录;它不会启动已安装的内核,也不会建立安全边界。
下面是连接运行时挂载并进入目标环境的示例。此命令不能替代磁盘识别。如果像 /target/dev 这样的挂载点已经准备好,推荐先使用安装程序提供的目标 shell。
for p in dev proc sys run; do
mount --rbind "/$p" "/target/$p"
mount --make-rslave "/target/$p"
done
chroot /target /bin/bash
在修复前指定已安装的目标内核
即使在 chroot 内,uname -r 也显示来自救援介质的内核。比较目标已安装的内核列表、模块目录和 vmlinuz 文件以指定版本。以下是在目标根目录的 root shell 中执行的检查。
cat /etc/os-release
ls /usr/lib/modules
dpkg-query -W -f='${binary:Package} ${db:Status-Abbrev} ${Version}\n' 'linux-image*'
findmnt --target /boot
findmnt --target /boot/efi
df -hT /boot /boot/efi /var/tmp
read -r -p "Installed kernel version to repair: " target_kernel
test -d "/usr/lib/modules/$target_kernel"
test -f "/boot/vmlinuz-$target_kernel"
还要检查已安装的生成工具。像这样的虚拟机环境使用 initramfs-tools 的下一步操作程序不能直接应用于 dracut 环境。在恢复之前,将必要的目标文件(如启动文件、配置和 EFI 内容)存储在单独的受访问限制的位置。为备份分配一个新名称,不要覆盖现有的良好副本。
只有在纠正上述原因并确认存储空间、根/启动挂载、目标版本和备份后,才更新实际的 initramfs。在下面的root shell 块中,如果目标内核已有现有映像,请选择 -u;如果没有,请选择 -c。此操作实际上会修改 /boot。
set -e
test -n "$target_kernel"
test -d "/usr/lib/modules/$target_kernel"
test -f "/boot/vmlinuz-$target_kernel"
repair_record=$(mktemp -d /var/backups/lf-boot-repair.XXXXXX)
for path in "/boot/vmlinuz-$target_kernel" "/boot/initrd.img-$target_kernel" /boot/grub/grub.cfg /etc/fstab /etc/default/grub; do
if test -f "$path"; then cp -a -- "$path" "$repair_record/"; fi
done
printf 'backup: %s\n' "$repair_record"
if test -f "/boot/initrd.img-$target_kernel"; then
update-initramfs -u -k "$target_kernel"
else
update-initramfs -c -k "$target_kernel"
fi
listing=$(mktemp /var/tmp/lf-repair-initrd.XXXXXX)
lsinitramfs "/boot/initrd.img-$target_kernel" > "$listing"
grep -Fx init "$listing"
rm -- "$listing"
update-grub
grub-script-check /boot/grub/grub.cfg
update-initramfs 手册 区分了更新现有镜像和创建新镜像。update-grub 手册 描述了生成 GRUB 配置,这与重新安装引导程序或修复固件启动项是不同的操作。
如果问题出在 EFI 文件或固件注册本身,则需要一个单独的恢复过程来检查目标架构、UEFI/BIOS、安全启动、EFI 挂载以及已安装的 grub/shim 包。当 GRUB 可以读取内核时,不要自动添加引导程序重新安装,也不要将 BIOS 示例磁盘命令复制到 UEFI。
验证恢复并保留独立实训镜像
在实际恢复中,退出 chroot,以相反的顺序卸载您所连接的下级挂载,卸下安装介质,然后从磁盘启动。卸载时,不要使用包含其他正在使用的挂载点的广泛命令;使用 findmnt -R /target 检查实际的层次结构。如果启动失败,请保留控制台信息、所选版本和更改历史,并使用准备好的备份和恢复程序进行处理。
如果系统能够启动,检查 uname -r、root 和 boot 挂载点、systemctl --failed 及必要服务、新的 SSH 连接、实际响应和数据。区分登录界面出现的事实与最初提供的功能已经恢复的事实。
uname -r
findmnt --target /
findmnt --target /boot
findmnt --mountpoint /boot/efi
sudo systemctl --failed --no-pager
systemctl is-active ssh
ip -brief address
ip route
在正常状态下执行的单独镜像练习没有更改原始的 /boot,因此不需要恢复启动文件。单独的镜像以及列表、哈希和配置的副本已保存在 /var/backups/lf-debian13-32。仅删除不再需要的实训镜像时,确保不要混淆原始的 /boot/initrd.img 及其路径,并首先决定是否保留恢复记录。




