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 来选择要恢复的根目录。

  1. 确保服务器控制台和备份/恢复手段,并使用与现有磁盘和 EFI 启动方式匹配的安装介质启动。
  2. 选择救援模式,完成语言和硬件检查,然后选择实际安装的根文件系统。不要继续执行新安装的分区初始化阶段。
  3. 检查这是选定根文件系统内的 shell 还是安装程序自身的 shell。如果是在选定根文件系统内的 shell,那么您已经在该环境中工作,因此不要再 chroot 到 /target。
  4. 在安装程序的 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 及其路径,并首先决定是否保留恢复记录。