Debian 13 강좌 / 부팅 장애 점검과 initramfs·rescue 복구

Debian 13의 부팅 장애는 UEFI·GRUB·커널·initramfs·systemd 중 어디까지 진행됐는지 먼저 나누어 진단합니다. SSH 접속 실패만으로 부팅 실패를 단정하지 말고 콘솔, 실제 루트·부팅 파티션과 설치된 커널을 확인해야 합니다. 이 강좌는 정상 시스템에서 별도 initramfs를 생성·검사하고, 실제 장애 때 적용할 rescue 절차의 대상 확인과 변경 범위를 설명합니다.

부팅이 멈춘 단계와 원격 접속 실패 구분

UEFI는 하드웨어를 초기화하고 부팅 프로그램을 찾는 펌웨어입니다. GRUB는 커널과 초기 RAM 파일 시스템인 initramfs를 읽어 실행하는 부트로더입니다. initramfs의 초기 사용자 공간은 루트 장치를 찾고 실제 루트로 전환하는 작업을 돕습니다. 이후 systemd가 서비스와 로그인 환경을 구성합니다.

콘솔에서 보이는 상태 우선 조사 바로 하지 않을 작업
부팅 장치를 찾지 못함 디스크 연결·펌웨어 부팅 순서·EFI 시스템 파티션 루트 파일 시스템을 곧바로 초기화하지 않습니다.
GRUB 메뉴·명령줄 단계 부팅 파일 경로·설정·장치 식별 BIOS용 명령을 UEFI에 무조건 적용하지 않습니다.
커널 메시지·initramfs 셸 선택 커널·루트 UUID·저장 장치 모듈·암호화/LVM 실행 환경의 커널을 복구 대상 버전으로 단정하지 않습니다.
emergency mode·서비스 실패 fstab·마운트·해당 unit·journal 모든 문제를 GRUB 재설치로 해결하려 하지 않습니다.
로그인 화면은 있지만 SSH 실패 주소·경로·방화벽·sshd·인증 커널이 부팅하지 못한 것으로 취급하지 않습니다.

장애 화면의 문구·선택한 커널·변경 직전 작업과 시각을 기록합니다. VirtualBox 같은 VM에서는 해당 VM의 콘솔에 직접 접근할 수 있는지 확인합니다. 이 검증 VM에서는 콘솔 로그인 프롬프트와 정상 SSH가 확인됐으므로 부팅 불능을 만든 상태에서 작업한 것은 아닙니다.

현재 커널과 실제 /boot·EFI 구조 확인

정상 부팅 가능한 동안 다음 정보를 별도 기록으로 남깁니다. 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 '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

검증 VM은 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를 열어 해당 이전 버전으로 부팅하는 방법을 검토할 수 있습니다. VM 펌웨어·설정에 따라 메뉴 진입 키와 표시 시간이 달라질 수 있으므로 정상 상태에서 접근 방법을 확인합니다.

검증 VM에는 실제 설치된 커널이 하나였으며 GRUB의 일반·recovery 항목도 같은 6.12.107 버전이었습니다. recovery mode 항목은 이전 커널이 아닙니다. 다른 버전이 없는데 이전 커널 선택으로 해결할 수 있다고 안내하지 않습니다.

이전 커널로 부팅했다면 uname -r과 서비스·네트워크·데이터를 확인하고, 문제가 난 커널과 로그를 보존합니다. 정상 커널을 먼저 제거하지 않습니다. 어느 커널로도 부팅하지 못할 때는 설치 ISO의 rescue와 콘솔 접근, 백업을 준비합니다. 여기서는 정상 부팅 파일 교체 없이 다음 별도 이미지 실습부터 수행합니다.

부팅 파일을 보존하고 별도 initramfs 생성

mkinitramfs는 지정한 커널용 초기 파일 시스템 이미지를 만듭니다. 이 실습은 /boot를 덮어쓰지 않고 root 전용 백업 경로에 결과를 저장합니다. /var/tmp는 기본 임시 작업 공간에 사용될 수 있으므로 여유와 실행 허용 여부를 확인합니다. 실제 도구의 임시 경로 조건은 mkinitramfs 설명서를 참고할 수 있습니다.

다음 전체 블록은 정상 Debian 시스템의 sudo 가능한 일반 사용자 터미널에서 실행합니다. 같은 이름의 경로가 있으면 중단하며 기존 기록을 덮어쓰지 않습니다.

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-debian13-32
if test -e "$dest"; then echo "이미 존재하는 경로입니다." >&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 해시는 모두 OK였습니다. 별도 이미지 생성·목록 확인은 실제로 그 이미지로 부팅한 시험과는 구분합니다.

목록 도구의 역할과 지원 범위는 lsinitramfs 설명서에 정리돼 있습니다. 원하는 저장 장치 드라이버·루트 UUID·LVM/암호화 설정이 정확한지까지는 실제 시스템 구성에 맞춰 추가 확인해야 합니다. 단순히 파일 수가 많다는 이유로 복구 가능한 이미지라고 판단하지 않습니다.

실제 장애 때 rescue 환경과 대상 루트 확인

이 절은 실제 부팅 장애가 확인됐을 때 적용 조건을 판단하는 복구 절차입니다. 위 VM에서는 정상 부팅 파일을 바꾸거나 rescue에서 실제 파일 교체를 수행하지 않았습니다. Debian 설치 안내서의 rescue 설명처럼 설치 미디어의 rescue 항목이나 rescue/enable=true로 진입해 복구할 루트를 선택합니다.

  1. 서버 콘솔과 백업·복원 수단을 확보하고, 기존 디스크·EFI 부팅 방식과 맞는 설치 미디어로 부팅합니다.
  2. Rescue mode를 선택하고 언어·하드웨어 확인을 거쳐 실제 설치된 루트 파일 시스템을 선택합니다. 새 설치의 파티션 초기화 단계로 진행하지 않습니다.
  3. 선택한 루트 안의 셸인지 설치기 자체 셸인지 확인합니다. 선택 루트 안 셸이라면 이미 그 환경에서 작업하므로 다시 /target으로 chroot하지 않습니다.
  4. 설치기 셸에서는 선택 루트가 /target에 마운트될 수 있습니다. 해당 디렉터리의 OS·fstab과 실제 장치를 대조하고 별도 /boot·EFI가 있으면 올바르게 연결한 뒤 대상 환경에서 작업합니다.

다음은 설치기 환경의 root 셸에서 대상 확인용으로 실행하는 명령입니다. root 셸이므로 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를 적용하지 않습니다.

설치기 셸에서 수동 chroot가 필요한 경우에는 /target이 올바른 루트이며 대상 셸을 실행할 수 있다는 조건이 필요합니다. 별도 /boot가 있으면 먼저 대상 /target/boot에, EFI 시스템 파티션은 /target/boot/efi에 실제 UUID로 마운트합니다. 이미 연결된 항목을 중복 마운트하지 말고 findmnt 결과를 확인합니다.

다음은 필요한 부팅 파티션을 확인·연결한 뒤 대상 환경에 진입하는 예입니다. 이 명령이 디스크 식별을 대신하지는 않습니다. 기존 /target/dev 등의 마운트가 준비돼 있다면 설치기가 제공한 대상 셸을 우선 이용합니다.

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 셸에서 실행하는 확인입니다.

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 "복구할 설치 커널 버전: " target_kernel
test -d "/usr/lib/modules/$target_kernel"
test -f "/boot/vmlinuz-$target_kernel"

설치된 생성 도구도 확인합니다. 이 VM처럼 initramfs-tools인 환경의 다음 절차를 dracut 환경에 그대로 적용하지 않습니다. 복구 전에 해당 부팅 파일과 구성·EFI 내용 등 필요한 대상을 접근 제한된 별도 위치에 보관합니다. 백업 이름은 새로 정하고 기존 정상본을 덮어쓰지 않습니다.

이상 원인을 바로잡고 저장 공간·루트/부팅 마운트·대상 버전·백업을 확인했을 때만 실제 initramfs를 갱신합니다. 다음 root 셸 블록은 해당 대상 커널용 기존 이미지가 있으면 -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 설명서에 따르면 update-grub는 GRUB 설정을 생성하는 명령으로, UEFI 부팅 항목이나 부트로더 자체를 재설치하는 작업과 다릅니다.

EFI 파일·펌웨어 등록 자체의 문제라면 대상 아키텍처·UEFI/BIOS·Secure Boot·EFI 마운트와 설치된 grub/shim 패키지를 확인하는 별도 복구가 필요합니다. GRUB가 커널을 읽는 상황에 부트로더 재설치를 무조건 추가하지 않고, BIOS 예시의 디스크 명령을 UEFI에 복사하지 않습니다.

복구 후 확인과 정상 실습의 정리

실제 복구에서는 chroot를 나와 자신이 연결한 하위 마운트를 역순으로 해제하고 설치 미디어를 분리한 뒤 디스크로 부팅합니다. 마운트를 해제할 때 다른 운영 마운트를 포함하는 광범위한 명령을 쓰지 않고 findmnt -R /target으로 실제 계층을 확인합니다. 부팅 실패 시 콘솔 문구와 선택 버전·변경 기록을 보존하고 준비한 백업·복원 절차로 대응합니다.

부팅이 됐으면 uname -r, 루트·부팅 마운트, 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와 경로를 혼동하지 않고, 복구 기록 보관 여부를 먼저 판단합니다.