파이썬 소켓 프로그래밍 DNS 해석 getaddrinfo 권장 패턴과 IPv4 IPv6 동시 지원

🔎 getaddrinfo 기본 개념과 동작 방식

네트워크 프로그래밍에서 호스트 이름을 직접 IP 주소로 변환하는 일은 흔히 발생합니다.
하지만 단순히 IPv4 주소만 처리하거나, 하드코딩된 주소를 사용하는 방식은 매우 취약하며 확장성도 떨어집니다.
이 문제를 해결하기 위해 표준 라이브러리에서는 getaddrinfo()라는 함수를 제공합니다.
이 함수는 운영체제의 네임 서비스와 DNS 해석기를 활용하여, 도메인 이름에 대해 가능한 모든 주소 정보를 반환합니다.

getaddrinfo()가 반환하는 정보는 단순한 문자열 IP가 아니라, 소켓을 생성하고 연결하는 데 필요한 구조화된 데이터입니다.
즉, 주소 패밀리(AF_INET, AF_INET6), 소켓 타입(SOCK_STREAM, SOCK_DGRAM), 프로토콜 번호, 실제 바인딩 가능한 주소 튜플 등이 모두 포함되어 있죠.
이 덕분에 개발자는 직접 IPv4와 IPv6를 구분하거나 DNS 쿼리를 따로 작성할 필요가 없습니다.

📌 getaddrinfo 호출 시 주요 인자

위와 같은 정보를 토대로 getaddrinfo()는 가능한 모든 후보 주소를 리스트 형태로 반환합니다.
개발자는 이 리스트를 순회하며 연결을 시도하면 되고, IPv4와 IPv6 모두를 안전하게 지원할 수 있습니다.

🛠️ 파이썬에서 getaddrinfo 사용하는 방법

파이썬의 socket 모듈은 네트워크 프로그래밍을 위한 기본 도구를 제공합니다.
그중에서도 socket.getaddrinfo()는 호스트 이름과 서비스명을 바탕으로 연결 가능한 주소 정보를 반환하는 핵심 함수입니다.
이를 활용하면 DNS 해석뿐 아니라 IPv4, IPv6, TCP, UDP 등 다양한 조합에 대해 일관된 결과를 얻을 수 있습니다.

기본적인 사용법은 다음과 같습니다.
첫 번째 인자로는 접속하려는 호스트(예: www.google.com), 두 번째 인자로는 포트(예: 80 또는 “http”)를 전달합니다.
추가 인자를 통해 주소 패밀리(AF_INET, AF_INET6), 소켓 타입(SOCK_STREAM, SOCK_DGRAM) 등을 제한할 수도 있습니다.
반환 결과는 튜플의 리스트이며, 각 튜플에는 네트워크 프로그래밍에 필요한 구조화된 데이터가 포함되어 있습니다.

📌 기본 코드 예제

import socket

# www.google.com 의 80번 포트(HTTP)에 대해 주소 정보 조회
results = socket.getaddrinfo("www.google.com", 80)

for res in results:
    family, socktype, proto, canonname, sockaddr = res
    print(f"Family: {family}, Type: {socktype}, Proto: {proto}, Address: {sockaddr}")

위 코드를 실행하면 IPv4와 IPv6 주소가 함께 출력될 수 있으며, 소켓을 생성할 때 어떤 정보를 사용해야 하는지 명확히 알 수 있습니다.
이처럼 getaddrinfo()는 단순히 IP 문자열만 반환하는 gethostbyname()보다 훨씬 강력하고 유연한 방식입니다.

📌 반환값 구조

반환되는 각 튜플은 다음과 같은 구조를 가집니다.

• 📡family: 주소 체계 (AF_INET, AF_INET6)
• 🔌socktype: 소켓 유형 (SOCK_STREAM, SOCK_DGRAM)
• ⚙️proto: 사용되는 프로토콜 번호
• 🌍canonname: 정규화된 호스트 이름
• 📍sockaddr: 실제 네트워크 주소 (IP, Port)

🌐 IPv4와 IPv6 동시 지원 패턴

오늘날 인터넷 환경은 IPv4와 IPv6가 공존하고 있습니다.
만약 애플리케이션이 IPv4만 지원하도록 구현되어 있다면, IPv6 전용 네트워크에서는 정상적인 접속이 불가능해질 수 있습니다.
반대로 IPv6만 고려하면 여전히 다수의 IPv4 기반 환경과 호환되지 않는 문제가 생기죠.
따라서 getaddrinfo()를 활용해 두 프로토콜을 동시에 처리하는 패턴이 권장됩니다.

실무에서는 getaddrinfo()가 반환한 후보 주소 리스트를 순회하며 연결을 시도하는 것이 일반적입니다.
이 방식은 IPv6 우선 정책을 사용하는 운영체제에서도 올바르게 동작하며, 특정 주소가 실패해도 다른 주소로 재시도를 할 수 있습니다.

📌 IPv4와 IPv6를 동시에 지원하는 예제 코드

import socket

def connect(host, port):
    for res in socket.getaddrinfo(host, port, socket.AF_UNSPEC, socket.SOCK_STREAM):
        family, socktype, proto, canonname, sockaddr = res
        try:
            sock = socket.socket(family, socktype, proto)
            sock.connect(sockaddr)
            print(f"Connected to {sockaddr}")
            return sock
        except OSError as e:
            print(f"Failed to connect {sockaddr}: {e}")
            continue
    raise OSError("All connection attempts failed.")

# 예시 실행
s = connect("www.google.com", 80)

위 예제에서는 socket.AF_UNSPEC을 지정하여 IPv4와 IPv6를 모두 고려하도록 했습니다.
반환된 주소 목록을 순회하며 연결을 시도하므로, 특정 프로토콜이 실패해도 다른 주소로 접속할 수 있습니다.
이 방식은 크로스 플랫폼 환경에서 안정적으로 동작하며, 클라이언트 애플리케이션뿐 아니라 서버 프로그램에서도 동일하게 적용할 수 있습니다.

⚡ 안정적인 연결을 위한 예외 처리

실제 네트워크 환경에서는 DNS 해석이 실패하거나, 특정 주소 체계(IPv6 등)에서 연결이 정상적으로 이루어지지 않는 경우가 발생할 수 있습니다.
따라서 getaddrinfo()를 사용하더라도 반드시 예외 처리를 포함해야 안정적인 동작을 보장할 수 있습니다.
특히 여러 주소를 순회하면서 연결을 시도하는 구조에서는 중간 실패를 허용하고, 마지막까지 성공할 가능성을 열어두는 것이 중요합니다.

일반적으로는 각 연결 시도에 대해 try-except 블록을 사용하여 예외를 잡고, 실패할 경우 소켓을 닫은 후 다음 후보 주소로 넘어가는 방식이 권장됩니다.
또한 모든 시도가 실패했을 때만 전체 예외를 발생시켜 호출 측에서 적절히 처리하도록 해야 합니다.

📌 예외 처리 패턴 예제

import socket

def safe_connect(host, port):
    last_error = None
    for res in socket.getaddrinfo(host, port, socket.AF_UNSPEC, socket.SOCK_STREAM):
        family, socktype, proto, canonname, sockaddr = res
        try:
            sock = socket.socket(family, socktype, proto)
            sock.connect(sockaddr)
            return sock
        except OSError as e:
            last_error = e
            sock.close()
            continue
    raise OSError(f"모든 연결 시도가 실패했습니다: {last_error}")

위 예제에서는 각 시도가 실패할 경우 sock.close()로 자원을 정리하고, 마지막 오류를 보존한 뒤 모든 시도가 끝난 후 최종적으로 예외를 발생시킵니다.
이 패턴은 안정적인 연결 로직의 기본 구조로 널리 사용됩니다.

📌 추가 고려 사항

• ⏳연결 시도 시 timeout을 설정하여 무한 대기를 방지
• 🔄실패 시 즉시 종료하지 말고 다른 주소로 재시도
• 🧹예외 발생 시 소켓 리소스를 적절히 정리하여 누수 방지

💡 실무에서 자주 쓰이는 코드 예제

지금까지 getaddrinfo()의 기본 개념과 IPv4/IPv6 동시 지원, 그리고 예외 처리 패턴을 살펴보았습니다.
이번에는 실제 프로젝트에서 자주 활용되는 코드 예제를 정리해 보겠습니다.
아래 예제는 TCP 클라이언트로, 입력받은 도메인과 포트로 안전하게 연결을 시도하는 패턴을 보여줍니다.

📌 TCP 클라이언트 예제

import socket

def tcp_client(host, port, message):
    for res in socket.getaddrinfo(host, port, socket.AF_UNSPEC, socket.SOCK_STREAM):
        family, socktype, proto, canonname, sockaddr = res
        try:
            sock = socket.socket(family, socktype, proto)
            sock.settimeout(5)
            sock.connect(sockaddr)
            sock.sendall(message.encode())
            response = sock.recv(1024)
            print("Response:", response.decode())
            return
        except OSError as e:
            print(f"Error connecting {sockaddr}: {e}")
            continue
        finally:
            sock.close()
    raise OSError("모든 연결 시도가 실패했습니다.")

# 실행 예시
tcp_client("example.com", 80, "GET / HTTP/1.1\r\nHost: example.com\r\n\r\n")

위 코드 패턴은 IPv4와 IPv6 어느 환경에서도 유연하게 동작하며, 연결 시도를 실패하더라도 예외 처리 덕분에 프로그램 전체가 중단되지 않습니다.
또한 settimeout()을 설정하여 무한 대기를 방지하는 것도 실무에서 매우 중요한 부분입니다.

📌 서버 측 예제 (에코 서버)

import socket

def echo_server(host, port):
    for res in socket.getaddrinfo(host, port, socket.AF_UNSPEC, socket.SOCK_STREAM):
        family, socktype, proto, canonname, sockaddr = res
        try:
            sock = socket.socket(family, socktype, proto)
            sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
            sock.bind(sockaddr)
            sock.listen(5)
            print(f"Listening on {sockaddr}...")
            while True:
                conn, addr = sock.accept()
                data = conn.recv(1024)
                if not data:
                    break
                conn.sendall(data)
                conn.close()
        except OSError as e:
            print(f"Bind failed {sockaddr}: {e}")
            continue

이 에코 서버는 getaddrinfo()로 얻은 IPv4/IPv6 주소 모두에 대해 바인딩을 시도합니다.
실패한 주소는 건너뛰고, 가능한 주소에서 서버를 실행하게 됩니다.
이러한 구조는 다양한 환경에서 안정적으로 서비스를 운영할 수 있도록 보장합니다.

❓ 자주 묻는 질문 (FAQ)