Tutorial de Debian 13 / Diagnosticar el arranque y preparar la recuperación con GRUB e initramfs
Diagnostique una falla de arranque en Debian 13 identificando la última etapa que funcionó: firmware, cargador de arranque, kernel, sistema de archivos inicial o systemd. No concluya que hay una falla de arranque únicamente porque la conexión SSH falle; necesita revisar la consola, las particiones reales de root y boot, y el kernel instalado. Esta lección explica cómo crear e inspeccionar un initramfs separado en un sistema normal, y el alcance de los cambios y objetivos que deben aplicarse durante los procedimientos de rescate en caso de una falla real.
Identifique la etapa del arranque y separe los fallos de SSH
La Interfaz de Firmware Extensible Unificada (UEFI, Unified Extensible Firmware Interface) es un firmware que inicializa el hardware y encuentra el programa de arranque. El Cargador de Arranque Unificado de GNU (GRUB, GNU GRand Unified Bootloader) es un cargador de arranque que lee y ejecuta el núcleo y el sistema de archivos RAM inicial, initramfs. El espacio de usuario inicial de initramfs ayuda a encontrar el dispositivo raíz y cambiar al raíz real. Después de eso, systemd configura los servicios y el entorno de inicio de sesión.
| Estado visible en la consola | Investigaciones iniciales | Tareas que no se deben hacer inmediatamente |
|---|---|---|
| No se puede encontrar el dispositivo de arranque | Conexiones de disco, orden de arranque del firmware, partición del sistema EFI | No volver a inicializar el sistema de archivos raíz. |
| Menú GRUB o línea de comandos | Rutas de archivos de arranque, configuración e identidad del dispositivo | No aplique comandos de BIOS incondicionalmente a UEFI. |
| Mensajes del kernel o shell de initramfs | Kernel seleccionado, UUID de la raíz, módulos de almacenamiento y cifrado/LVM | No asuma que el kernel del entorno en ejecución es la versión objetivo de recuperación. |
| Modo de emergencia o fallo de servicio | fstab, montajes, unidad afectada y journal | No trate de reinstalar GRUB como una reparación universal. |
| Hay una pantalla de inicio de sesión, pero SSH falla. | Dirección, ruta, cortafuegos, sshd, autenticación | No infiera fallo de arranque del kernel a partir de un fallo de SSH. |
Registre el texto en la pantalla de error, el kernel seleccionado y las acciones y tiempos justo antes del cambio. Para VMs como VirtualBox, verifique si puede acceder directamente a la consola de la VM. En esta VM de prueba, se confirmó el aviso de inicio de sesión de la consola y el SSH normal, por lo que no se realizaron operaciones en un estado que causara que el sistema no pudiera arrancar.
Verifique el kernel en ejecución y los puntos de montaje de arranque reales
Mientras el sistema arranca normalmente, guarde por separado la información siguiente. uname -r es el kernel que se está ejecutando actualmente, no una lista de todos los kernels instalados. El ii en la salida de dpkg-query indica un estado instalado, y entradas como un no se cuentan como kernels instalados.
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
En un arranque con BIOS, la prueba del directorio EFI puede devolver un valor distinto de cero y puede que no exista un montaje EFI dedicado. Interprete esto como observaciones del diseño, no como prueba de fallo de arranque. Un UUID (Universally Unique Identifier) identifica aquí un sistema de archivos independientemente del nombre del dispositivo. Compruebe los dispositivos reales y los valores duplicados o cambiados tras clonar o recrear el sistema de archivos; no copie los identificadores de este laboratorio.
La VM de prueba era UEFI, GRUB 2.12, kernel 6.12.107+deb13-amd64, initramfs-tools 0.148.4. /boot estaba incluido en la raíz ext4, no en una partición separada, y solo /boot/efi era un vfat separado. Incluso si /boot es el mismo, los servidores pueden tener particiones separadas diferentes, LVM o cifrado, por lo que los nombres de dispositivo no se copian para su uso.
El menú de GRUB permite la verificación de sintaxis y la comprobación de elementos en un sistema normal como sigue. El éxito en la sintaxis no garantiza el arranque del firmware, la lectura del disco o la ejecución del kernel.
sudo grub-script-check /boot/grub/grub.cfg
sudo grep -E "^(menuentry|submenu)|^[[:space:]]+menuentry " /boot/grub/grub.cfg
El manual grub-script-check describe la comprobación de la sintaxis de la configuración. grub.cfg es un resultado generado; para cambios permanentes, inspeccione la configuración fuente y el proceso de generación en lugar de editar ese resultado directamente.
Prepare el acceso a la consola y compruebe si hay un kernel anterior
Si ocurre un problema después del nuevo kernel y el kernel anterior está realmente instalado, puede revisar cómo arrancar en la versión anterior abriendo 'Advanced options for Debian GNU/Linux' (opciones avanzadas para Debian GNU/Linux) en la consola de GRUB. Dependiendo del firmware de la VM y la configuración, la tecla de entrada al menú y el tiempo de visualización pueden diferir, así que verifique el método de acceso en un estado normal.
La VM de verificación tenía solo un kernel realmente instalado, y tanto los elementos estándar como de recuperación en GRUB eran de la misma versión 6.12.107. La entrada en modo de recuperación no es el kernel anterior. Si no hay otra versión, no indica que seleccionar el kernel anterior resolverá el problema.
Si arrancó con el kernel anterior, verifique uname -r, servicios, red y datos, y conserva el kernel problemático y los registros. No elimine primero el kernel cuyo funcionamiento ya está comprobado. Si es imposible iniciar con cualquier kernel, prepárese para acceder a la consola y rescatar desde el ISO de instalación y realizar copias de seguridad. Aquí, procedemos con la siguiente práctica de imagen separada sin reemplazar ningún archivo de arranque normal.
Conserve los archivos de arranque y cree un initramfs separado
mkinitramfs crea una imagen de sistema de archivos inicial para el kernel especificado. Este ejercicio guarda los resultados en una ruta de respaldo de solo root sin sobrescribir /boot. /var/tmp se puede usar como el espacio de trabajo temporal predeterminado, así que verifique el espacio disponible y el permiso para ejecutar. Las condiciones para rutas temporales de herramientas reales se pueden encontrar en la documentación de mkinitramfs.
El siguiente bloque completo se ejecuta desde un terminal de un sistema Debian normal con privilegios de sudo. La ejecución se detiene si existe una ruta con el mismo nombre y los registros existentes no se sobrescriben.
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
Los resultados de la ejecución confirmaron la entrada init y la ruta del módulo del kernel correspondiente, y el tamaño de la imagen separada era de 38.975.420 bytes. El tamaño puede variar dependiendo de las condiciones de creación y de los paquetes. Los hashes originales de vmlinuz, initrd.img y grub.cfg estaban todos correctos. Crear una imagen separada y verificar la lista se distingue de arrancar realmente con esa imagen.
Los roles y el alcance soportado de la herramienta de listado se detallan en la documentación lsinitramfs. Se requiere verificación adicional en la configuración real del sistema para asegurar que el controlador del dispositivo de almacenamiento deseado, el UUID raíz y los ajustes de LVM/cifrado sean correctos. Simplemente tener un gran número de archivos no determina si la imagen es recuperable.
Verifique el entorno de rescate y la raíz del objetivo durante una falla real
Esta sección es un procedimiento de recuperación que determina las condiciones aplicables cuando se confirma una falla real de arranque. En la VM mencionada, los archivos de arranque normales no fueron cambiados, ni se realizó el reemplazo de archivos reales en el rescate. Como se describe en la sección de rescate del manual de instalación de Debian, ingrese al elemento de rescate del medio de instalación o use rescue/enable=true para seleccionar la raíz a recuperar.
- Asegure la consola del servidor y los medios de respaldo/restauración, y arranque con medios de instalación que coincidan con el disco existente y el método de arranque EFI.
- Seleccione el modo de rescate, pase por las comprobaciones de idioma y hardware, y seleccione el sistema de archivos raíz realmente instalado. No continúe con la etapa de inicialización de particiones de una nueva instalación.
- Compruebe si es un shell dentro de la raíz seleccionada o el propio shell del instalador. Si es un shell dentro de la raíz seleccionada, ya está trabajando en ese entorno, por lo que no debe hacer chroot a /target de nuevo.
- En el shell del instalador, la raíz seleccionada puede estar montada en /target. Compare el sistema operativo y el fstab en ese directorio con los dispositivos reales, y si hay un /boot o EFI separado, conéctelos correctamente, luego trabaje en el entorno de destino.
Los siguientes comandos se ejecutan en la shell raíz del entorno del instalador para verificar el objetivo. Dado que es la shell raíz, no use el prefijo sudo. Esto solo tiene sentido cuando /target es la raíz seleccionada real.
lsblk -f
findmnt -R /target
cat /target/etc/os-release
cat /target/etc/fstab
ls /target/usr/lib/modules
ls -l /target/boot
La encriptación, RAID y LVM deben poder usar primero las capas de almacenamiento correspondientes. No aplique este simple ejemplo de ext4 y UEFI sin cambios a esas configuraciones de almacenamiento. Si la raíz en sí no puede ser leída debido a corrupción, primero determine las condiciones para la verificación del sistema de archivos y la restauración de la copia de seguridad, y no aplique e2fsck a una raíz montada.
Si se requiere un chroot manual en el shell del instalador, /target debe ser la raíz correcta y capaz de ejecutar el shell del destino. Si hay un /boot separado, primero móntelo en /target/boot, y la partición del sistema EFI debe montarse en /target/boot/efi usando el UUID real. No duplique elementos ya conectados y verifique usando los resultados de findmnt.
El siguiente bloque enlaza los sistemas de archivos en tiempo de ejecución después de que haya identificado y montado las particiones de arranque correctas. Deténgase en cualquier comando de montaje fallido e inspeccione findmnt -R /target antes de continuar. La propagación recursiva de esclavos evita que las operaciones de desmontaje bajo el destino se propaguen de vuelta al entorno de rescate. Un chroot cambia la raíz aparente del sistema de archivos; no arranca el kernel instalado ni establece un límite de seguridad.
A continuación se muestra un ejemplo de cómo conectar montajes en tiempo de ejecución y entrar en el entorno de destino. Este comando no reemplaza la identificación del disco. Si ya se han preparado montajes como /target/dev, se recomienda primero usar el shell de destino proporcionado por el instalador.
for p in dev proc sys run; do
mount --rbind "/$p" "/target/$p"
mount --make-rslave "/target/$p"
done
chroot /target /bin/bash
Especifique el kernel instalado en el destino antes de reparar
Incluso dentro de chroot, uname -r muestra el kernel que se está ejecutando desde el medio de rescate. Compare la lista de kernels instalados en el destino, el directorio de módulos y el archivo vmlinuz para especificar la versión. Lo siguiente es una verificación ejecutada desde el shell de root del sistema de destino.
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"
También revise las herramientas de generación instaladas. El siguiente procedimiento para un entorno como esta VM usando initramfs-tools no se aplica tal cual a un entorno dracut. Antes de la recuperación, guarde los objetivos necesarios, como archivos de arranque, configuración y contenidos EFI en un lugar separado y con acceso restringido. Asigne un nuevo nombre a la copia de seguridad y no sobrescriba la copia buena existente.
Solo actualice el initramfs actual después de corregir las causas anteriores y confirmar el espacio de almacenamiento, los montajes de raíz/arranque, la versión del objetivo y las copias de seguridad. En el siguiente bloque de shell de raíz, seleccione -u si existe una imagen para el kernel objetivo, o -c si no existe. Esta operación modifica realmente /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
El manual update-initramfs distingue entre actualizar una imagen existente y crear una nueva. El manual update-grub describe la generación de la configuración de GRUB, una operación diferente de reinstalar el cargador de arranque o reparar entradas de arranque del firmware.
Si el problema está en los archivos EFI o en el registro del firmware, se necesita un proceso de recuperación separado para verificar la arquitectura de destino, UEFI/BIOS, Secure Boot, el montaje EFI y los paquetes grub/shim instalados. No agregue automáticamente la reinstalación del cargador de arranque cuando GRUB pueda leer el kernel, y no copie los comandos de ejemplo del BIOS a UEFI.
Verifique la recuperación y conserve la imagen separada del laboratorio
En la recuperación real, salga del chroot, desmonte los puntos de montaje subordinados que conectó en orden inverso, desconecte los medios de instalación y luego arranque desde el disco. Al desmontar, no use comandos generales que incluyan otros montajes del sistema operativo; verifique la jerarquía real con findmnt -R /target. En caso de fallo de arranque, conserve los mensajes de la consola, las versiones seleccionadas y el historial de cambios, y responda utilizando los procedimientos de copia de seguridad y restauración preparados.
Si el sistema arranca, verifique uname -r, los montajes de root y boot, systemctl --failed junto con los servicios necesarios, nuevas conexiones SSH, respuestas reales y datos. Distinga entre el hecho de que apareció la pantalla de inicio de sesión y el hecho de que las funciones proporcionadas originalmente han sido restauradas.
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
Los ejercicios de imagen separados realizados en un estado normal no cambiaron el /boot original, por lo que no es necesario restaurar los archivos de arranque. Las imágenes separadas y las copias de listas, hashes y configuraciones se han conservado en /var/backups/lf-debian13-32. Al eliminar solo las imágenes de ejercicios innecesarias, asegúrese de no confundir el /boot/initrd.img original y su ruta, y primero decida si desea conservar los registros de recuperación.




