시스템 관리_12 "리눅스 DNS 장애 해결 가이드 'Temporary failure in name resolution' 원인 및 복구 방법"

# 1. 장애 현상 확인: ping 또는 curl 호출 시 오류 발생
$ ping -c 2 google.com
ping: google.com: Temporary failure in name resolution

# 2. IP 직통 통신 여부 확인 (게이트웨이/외부 라우팅 정상 여부 분리)
$ ping -c 2 8.8.8.8
64 bytes from 8.8.8.8: icmp_seq=1 ttl=116 time=12.4 ms
# -> IP 핑이 성공한다면 네트워크 라우팅은 정상이지만 순수 DNS 해석 문제임을 확정

# 3. 현재 등록된 DNS 네임서버 설정 확인
$ cat /etc/resolv.conf
# 만약 파일이 비어있거나 올바른 nameserver IP가 없다면 에러 발생

# 4. systemd-resolved 상태 및 바인딩된 업스트림 DNS 점검
$ resolvectl status
# 또는
$ systemctl status systemd-resolved

# 5. 특정 네임서버를 직접 지정하여 질의 테스트 (53번 포트 통신 가능 여부)
$ dig @8.8.8.8 google.com +time=3

#!/bin/bash
# dns_troubleshoot.sh - Diagnose Linux DNS resolution failures

TARGET_DOMAIN=${1:-"google.com"}
TEST_DNS="8.8.8.8"

echo "=========================================="
echo " [DNS 진단 시작] 대상 도메인: ${TARGET_DOMAIN}"
echo "=========================================="

# 1. 기본 라우팅 및 게이트웨이 확인
echo -e "\n[1] 기본 네트워크 경로 및 IP 라우팅 점검:"
DEFAULT_GW=$(ip route | grep default | awk '{print $3}')
if [ -z "$DEFAULT_GW" ]; then
    echo "  [오류] 기본 게이트웨이(Default Gateway)가 설정되어 있지 않습니다."
    echo "  -> 네트워크 인터페이스 설정을 먼저 확인하십시오."
else
    echo "  [정상] 기본 게이트웨이 감지: ${DEFAULT_GW}"
fi

# 2. 공용 IP 핑 테스트 (순수 네트워크 계층 정상 여부)
echo -e "\n[2] 외부 공용 IP(8.8.8.8) 도달 가능 여부:"
if ping -c 2 -W 2 "$TEST_DNS" &>/dev/null; then
    echo "  [정상] 외부 IP 직통 연결 정상 (네트워크 계층 이상 없음)"
else
    echo "  [경고] 외부 IP로 패킷이 나가지 못하고 있습니다. 게이트웨이 또는 방화벽 문제일 수 있습니다."
fi

# 3. /etc/resolv.conf 점검
echo -e "\n[3] /etc/resolv.conf 상태 점검:"
if [ ! -f /etc/resolv.conf ]; then
    echo "  [오류] /etc/resolv.conf 파일이 존재하지 않습니다."
else
    NAMESERVERS=$(grep -E "^nameserver" /etc/resolv.conf | awk '{print $2}')
    if [ -z "$NAMESERVERS" ]; then
        echo "  [오류] resolv.conf 내에 등록된 nameserver가 없습니다."
    else
        echo "  [정상] 등록된 네임서버:"
        echo "$NAMESERVERS" | sed 's/^/    - /'
    fi
    
    # 심볼릭 링크 여부 확인 (Ubuntu/systemd 계열)
    if [ -L /etc/resolv.conf ]; then
        echo "  [안내] /etc/resolv.conf 는 심볼릭 링크입니다 -> $(readlink -f /etc/resolv.conf)"
    fi
fi

# 4. systemd-resolved 데몬 상태 점검
echo -e "\n[4] systemd-resolved 상태 점검:"
if systemctl is-active --quiet systemd-resolved; then
    echo "  [정상] systemd-resolved 서비스가 활성화되어 있습니다."
else
    echo "  [참고] systemd-resolved 서비스가 비활성 상태이거나 설치되지 않았습니다."
fi

# 5. 실제 도메인 질의 테스트
echo -e "\n[5] 도메인 해석 테스트:"
if getent hosts "$TARGET_DOMAIN" &>/dev/null; then
    echo "  [성공] '${TARGET_DOMAIN}' 이름 해석 성공:"
    getent hosts "$TARGET_DOMAIN" | sed 's/^/    /'
else
    echo "  [실패] '${TARGET_DOMAIN}' 이름 해석 실패 (Temporary failure in name resolution)"
    echo "  -> 외부 DNS(${TEST_DNS}) 직접 질의 테스트 시도..."
    if command -v dig &>/dev/null; then
        dig @"$TEST_DNS" "$TARGET_DOMAIN" +short
    fi
fi

echo -e "\n=========================================="
echo " [진단 완료]"
echo "=========================================="