Tutorial do Debian 13 / Investigar falhas de inicialização com GRUB, initramfs e modo de recuperação
Diagnostique uma falha de inicialização do Debian 13 identificando a última etapa funcional: firmware, carregador de inicialização, kernel, sistema de arquivos inicial ou systemd. Não conclua que houve uma falha de inicialização apenas porque a conexão SSH falha; você precisa verificar o console, as partições reais de root e de boot, e o kernel instalado. Esta aula explica como criar e inspecionar um initramfs separado em um sistema normal, e o escopo das alterações e alvos para os procedimentos de resgate aplicáveis durante uma falha real.
Identificar a etapa de inicialização e separar falhas de SSH
A Interface de Firmware Extensível Unificada (UEFI, Unified Extensible Firmware Interface) é um firmware que inicializa o hardware e encontra o programa de inicialização. O GNU GRand Unified Bootloader (GRUB) é um carregador de inicialização que lê e executa o kernel e o sistema de arquivos RAM inicial, initramfs. O espaço inicial do usuário do initramfs ajuda a encontrar o dispositivo root e passar para o root real. Depois disso, o systemd configura serviços e o ambiente de login.
| Estado visível no console | Investigações iniciais | Tarefas a não serem feitas imediatamente |
|---|---|---|
| Não é possível encontrar o dispositivo de inicialização | Conexões de disco, ordem de inicialização do firmware, partição do sistema EFI | Não reinicialize o sistema de arquivos root. |
| Menu do GRUB ou linha de comando | Caminhos de arquivos de inicialização, configuração e identidade do dispositivo | Não aplique comandos do BIOS incondicionalmente ao UEFI. |
| Mensagens do kernel ou shell initramfs | Kernel selecionado, UUID da raiz, módulos de armazenamento e criptografia/LVM | Não assuma o kernel do ambiente em execução como a versão alvo de recuperação. |
| Modo de emergência ou falha de serviço | fstab, pontos de montagem, unidade afetada e journal | Não trate a reinstalação do GRUB como um reparo universal. |
| Há uma tela de login, mas o SSH falha. | Endereço, caminho, firewall, sshd, autenticação | Não inferir falha de inicialização do kernel a partir de falha no SSH. |
Registre o texto na tela de erro, o kernel selecionado e as ações e horários imediatamente antes da mudança. Para VMs como o VirtualBox, verifique se é possível acessar diretamente o console da VM. Nesta VM de teste, o prompt de login do console e o SSH normal foram confirmados, portanto, as operações não foram realizadas em um estado que tornasse o sistema inoperante.
Verificar o kernel ativo e os pontos de montagem de boot
Enquanto o sistema inicia normalmente, guarde separadamente as informações a seguir. uname -r é o kernel atualmente em execução, não uma lista de todos os kernels instalados. O ii na saída do dpkg-query indica um estado instalado, e entradas como un não são contadas 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
Em uma inicialização BIOS, o teste do diretório EFI pode retornar diferente de zero e um ponto de montagem EFI dedicado pode não existir. Interprete isso como observações de layout, não como prova de falha de inicialização. Um UUID (Universally Unique Identifier) identifica aqui um sistema de arquivos independentemente do nome do dispositivo. Verifique-o nos dispositivos reais e confira valores duplicados ou alterados após clonagem ou recriação, em vez de copiar nomes deste laboratório.
A VM de teste era UEFI, GRUB 2.12, kernel 6.12.107+deb13-amd64, initramfs-tools 0.148.4. /boot estava incluído na raiz ext4, não em uma partição separada, e apenas /boot/efi era uma vfat separada. Mesmo que /boot seja o mesmo, servidores podem ter diferentes partições separadas, LVM ou criptografia, portanto nomes de dispositivos não são copiados para uso.
O menu GRUB permite verificação de sintaxe e verificação de itens em um sistema normal da seguinte forma. O sucesso na sintaxe não garante o boot pelo firmware, a leitura do disco ou a execução do kernel.
sudo grub-script-check /boot/grub/grub.cfg
sudo grep -E "^(menuentry|submenu)|^[[:space:]]+menuentry " /boot/grub/grub.cfg
O manual grub-script-check descreve a verificação da sintaxe da configuração. grub.cfg é um arquivo gerado; para alterações permanentes, inspecione a configuração de origem e o processo de geração em vez de editar diretamente esse arquivo.
Preparar o acesso ao console e verificar um kernel anterior
Se ocorrer um problema após o novo kernel e o kernel anterior estiver realmente instalado, você pode verificar como inicializar na versão anterior abrindo 'Advanced options for Debian GNU/Linux' (opções avançadas para Debian GNU/Linux) no console do GRUB. Dependendo do firmware da VM e das configurações, a tecla de entrada do menu e o tempo de exibição podem variar, portanto, verifique o método de acesso em um estado normal.
A VM de verificação tinha apenas um kernel realmente instalado, e tanto os itens padrão quanto os de recuperação no GRUB eram da mesma versão 6.12.107. A entrada do modo de recuperação não é o kernel anterior. Se não houver outra versão, isso não indica que selecionar o kernel anterior resolverá o problema.
Se você iniciou no kernel anterior, verifique uname -r, serviços, rede e dados, e preserve o kernel problemático e os logs. Não remova primeiro o kernel cujo funcionamento está comprovado. Se for impossível inicializar em qualquer kernel, prepare o acesso via console e o resgate a partir do ISO de instalação e faça backups. Aqui, prosseguimos com a seguinte prática de imagem separada sem substituir quaisquer arquivos de inicialização normais.
Preservar os arquivos de boot e criar um initramfs separado
mkinitramfs cria uma imagem inicial do sistema de arquivos para o kernel especificado. Este exercício salva os resultados em um caminho de backup acessível apenas pelo root, sem sobrescrever /boot. /var/tmp pode ser usado como o espaço de trabalho temporário padrão, portanto, verifique a disponibilidade de espaço e a permissão para executar. As condições para caminhos temporários das ferramentas reais podem ser encontradas na documentação do mkinitramfs.
O bloco completo a seguir é executado a partir de um terminal de um sistema Debian normal com privilégios de sudo. A execução é interrompida se existir um caminho com o mesmo nome, e os registros existentes não são sobrescritos.
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
Os resultados da execução confirmaram a entrada init e o caminho correspondente do módulo do kernel, e o tamanho da imagem separada foi de 38.975.420 bytes. O tamanho pode variar dependendo das condições de criação e dos pacotes. Os hashes originais de vmlinuz, initrd.img e grub.cfg estavam todos OK. Criar uma imagem separada e verificar a lista é diferente de realmente iniciar com essa imagem.
As funções e o escopo suportado da ferramenta de listagem estão detalhados na documentação lsinitramfs. Verificações adicionais são necessárias na configuração real do sistema para garantir que o driver do dispositivo de armazenamento desejado, o UUID root e as configurações de LVM/criptografia estejam corretos. Simplesmente ter um grande número de arquivos não determina se a imagem é recuperável.
Verificar o ambiente de recuperação e a raiz de destino
Esta seção é um procedimento de recuperação que determina as condições aplicáveis quando uma falha real de inicialização é confirmada. Na VM acima, os arquivos normais de inicialização não foram alterados, nem a substituição real de arquivos foi realizada no resgate. Como descrito na seção de recuperação do manual de instalação Debian, selecione rescue no menu da mídia de instalação ou use rescue/enable=true para selecionar a raiz a ser recuperada.
- Garanta o console do servidor e os meios de backup/restauração, e inicialize com a mídia de instalação que corresponda ao disco existente e ao método de inicialização EFI.
- Selecione o modo de resgate, passe pelas verificações de idioma e hardware e selecione o sistema de arquivos raiz realmente instalado. Não prossiga para a etapa de inicialização de partição de uma nova instalação.
- Verifique se é um shell dentro da raiz selecionada ou o próprio shell do instalador. Se for um shell dentro da raiz selecionada, você já está trabalhando nesse ambiente, então não faça chroot para /target novamente.
- No shell do instalador, a raiz selecionada pode estar montada em /target. Compare o sistema operacional e o fstab nesse diretório com os dispositivos reais e, se houver um /boot ou EFI separado, conecte-os corretamente, então trabalhe no ambiente de destino.
Os seguintes comandos são executados no shell root do ambiente do instalador para verificar o destino. Como é o shell root, não use o prefixo sudo. Isso só faz sentido quando /target é a raiz realmente selecionada.
lsblk -f
findmnt -R /target
cat /target/etc/os-release
cat /target/etc/fstab
ls /target/usr/lib/modules
ls -l /target/boot
Criptografia, RAID e LVM devem primeiro ser capazes de usar as camadas de armazenamento correspondentes. Não aplique este exemplo simples de ext4 e UEFI sem alterações a esses layouts de armazenamento. Se a própria raiz não puder ser lida devido à corrupção, primeiro determine as condições para verificação do sistema de arquivos e restauração do backup, e não aplique e2fsck a uma raiz montada.
Se um chroot manual for necessário no shell do instalador, /target deve ser o root correto e capaz de executar o shell do destino. Se houver uma /boot separada, primeiro monte-a no /target/boot, e a partição do sistema EFI deve ser montada em /target/boot/efi usando o UUID real. Não duplique itens já conectados e verifique usando os resultados do findmnt.
O seguinte bloco vincula os sistemas de arquivos em tempo de execução após você ter identificado e montado as partições de inicialização corretas. Pare em qualquer comando de montagem que falhar e inspecione findmnt -R /target antes de continuar. A propagação recursiva de slave impede que operações de desmontagem no alvo se propaguem de volta para o ambiente de resgate. Um chroot altera a raiz do sistema de arquivos aparente; ele não inicializa o kernel instalado nem estabelece uma fronteira de segurança.
Abaixo está um exemplo de como conectar montagens em tempo de execução e entrar no ambiente de destino. Este comando não substitui a identificação de disco. Se montagens como /target/dev já estiverem preparadas, é recomendável primeiro usar o shell de destino fornecido pelo instalador.
for p in dev proc sys run; do
mount --rbind "/$p" "/target/$p"
mount --make-rslave "/target/$p"
done
chroot /target /bin/bash
Especificar o kernel instalado antes do reparo
Mesmo dentro do chroot, uname -r mostra o kernel em execução a partir da mídia de recuperação. Compare a lista de kernels instalados no destino, o diretório de módulos e o arquivo vmlinuz para especificar a versão. O seguinte é uma verificação executada a partir do shell root do 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"
Verifique também as ferramentas de geração instaladas. O próximo procedimento para um ambiente como esta VM usando initramfs-tools não é aplicado da mesma forma em um ambiente dracut. Antes da recuperação, armazene os alvos necessários, como arquivos de inicialização, configuração e conteúdos EFI, em um local separado e com acesso restrito. Atribua um novo nome ao backup e não sobrescreva a cópia boa existente.
Atualize o initramfs real somente após corrigir as causas acima e confirmar o espaço de armazenamento, as montagens root/boot, a versão de destino e os backups. No bloco de shell root a seguir, selecione -u se houver uma imagem existente para o kernel alvo, ou -c se não houver. Esta operação realmente modifica /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
O manual de update-initramfs distingue a atualização de uma imagem existente da criação de uma nova. O manual de update-grub descreve a geração da configuração do GRUB, uma operação diferente de reinstalar o carregador de inicialização ou reparar entradas de inicialização do firmware.
Se o problema for com os arquivos EFI ou com o registro do firmware em si, um processo de recuperação separado é necessário para verificar a arquitetura de destino, UEFI/BIOS, Secure Boot, montagem EFI e pacotes grub/shim instalados. Não adicione automaticamente a reinstalação do carregador de inicialização quando o GRUB puder ler o kernel, e não copie comandos de disco de exemplo do BIOS para UEFI.
Verificar a recuperação e conservar a imagem separada do laboratório
Na recuperação real, saia do chroot, desmonte os pontos de montagem subordinados que você conectou na ordem inversa, desconecte a mídia de instalação e então inicialize a partir do disco. Ao desmontar, não use comandos amplos que incluam outros pontos de montagem do sistema; verifique a hierarquia real com findmnt -R /target. Em caso de falha na inicialização, preserve as mensagens do console, versões selecionadas e histórico de alterações, e responda usando os procedimentos de backup e restauração preparados.
Se o sistema inicializar, verifique uname -r, montagens root e boot, systemctl --failed juntamente com os serviços necessários, novas conexões SSH, respostas reais e dados. Distinga entre o fato de a tela de login ter aparecido e o fato de que as funções originalmente fornecidas foram 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
Exercícios de imagem separados realizados em um estado normal não alteraram o /boot original, portanto, restaurar os arquivos de inicialização não é necessário. Imagens separadas e cópias de listas, hashes e configurações foram preservadas em /var/backups/lf-debian13-32. Ao excluir apenas imagens de exercícios desnecessárias, certifique-se de não confundir o /boot/initrd.img original e seu caminho, e primeiro decida se deseja reter os registros de recuperação.




