블로그

WireGuard IPv4/IPv6 장애 조치: 피어 두 개만으로는 충분하지 않은 이유

WireGuard 피어 두 개로 IPv6에서 IPv4 엔드포인트로 장애 조치가 이루어지지 않는 이유와 엔드포인트, 라우팅, 연결 유지 동작을 안전하게 확인하는 방법을 알아봅니다.

FreeGuard Editorial Team · 2026-11-05

WireGuard 프로필에 IPv4 피어와 IPv6 피어를 추가하는 것만으로는 기본 연결과 대기 연결이 만들어지지 않습니다. 먼저 VPN 서버에 도달하는 데 사용하는 주소와 터널 안에서 전달되는 목적지 주소를 구분해야 합니다. 이 차이를 이해하면 구성이 이중화된 것처럼 보이더라도 자동 복구 기능이 없을 수 있는 이유를 알 수 있습니다.

이 가이드에서는 WireGuard 도구가 설치된 Linux 시스템을 대상으로 WireGuard 구성의 의미와 진단 명령을 다룹니다. 모바일 및 데스크톱 애플리케이션은 자체 연결 관리 기능을 추가할 수 있으므로 사용 중인 클라이언트와 버전의 동작을 확인하세요. 여기서는 실제 네트워크 테스트를 수행했다고 주장하지 않습니다.

엔드포인트와 터널 내부 트래픽 구분하기

WireGuard 개념 개요에서는 두 가지 결정을 설명합니다. 먼저 내부 목적지에 사용할 피어를 선택한 다음, 암호화된 패킷을 해당 피어의 엔드포인트로 보냅니다. 이 계층들에서 IPv4와 IPv6을 조합할 수 있습니다.

설정 확인하는 내용
Endpoint 암호화된 UDP 패킷을 어디로 보내야 하나요?
AllowedIPs 어떤 내부 목적지 주소가 이 피어를 선택하며, 이 피어에서 들어오는 어떤 출발지 주소를 허용하나요?

IPv4 엔드포인트는 IPv6 터널 트래픽을 전달할 수 있습니다. IPv6 엔드포인트는 IPv4 터널 트래픽을 전달할 수 있습니다. 따라서 AllowedIPs = ::/0은 “서버의 IPv6 주소를 사용한다”는 뜻이 아니며, AllowedIPs = 0.0.0.0/0은 “서버의 IPv4 주소를 사용한다”는 뜻이 아닙니다. wg 매뉴얼에 설명된 대로 이러한 항목은 내부 목적지의 주소 계열과 일치합니다.

피어 두 개가 장애 조치 쌍을 이루지 못하는 이유

한 피어에 모든 IPv4 목적지를 할당하고 다른 피어에 모든 IPv6 목적지를 할당하면 내부 트래픽이 주소 계열별로 나뉩니다. 엔드포인트가 작동하지 않을 때 첫 번째 피어의 트래픽을 두 번째 피어로 옮기도록 WireGuard에 지시하는 것은 아닙니다.

두 피어에 동일한 목적지 접두사를 할당해도 대기 정책이 되지 않습니다. Linux WireGuard 허용 IP 구현에서는 이미 존재하는 것과 정확히 같은 접두사를 삽입하면 해당 접두사와 연결된 피어가 갱신됩니다. 이는 구현에 대한 관찰이며, 그래픽 클라이언트가 어떤 구성을 허용할지에 관한 크로스 플랫폼 보장은 아닙니다. 중복 접두사를 상태 확인이나 우선순위 목록으로 사용하지 마세요.

라우트 설치는 또 다른 계층입니다. Linux에서 wg-quick은 일반적으로 피어의 허용 IP를 바탕으로 라우트를 만들고 기본 라우트는 특별하게 처리합니다. Table 옵션을 사용하면 이 동작이 달라집니다. WireGuard 인터페이스에 도달하는 라우트와 의도한 목적지를 선택하는 피어가 모두 올바르게 설정되어야 합니다.

로밍, 호스트 이름 갱신, 연결 유지는 서로 다른 문제를 해결합니다

WireGuard는 새로운 출발지 주소와 포트에서 올바르게 인증된 트래픽을 수신한 후 피어의 엔드포인트를 갱신할 수 있습니다. 문서화된 이 로밍 동작은 현재 엔드포인트에 도달할 수 없을 때 순서대로 확인할 IPv6 및 IPv4 목적지 목록을 정의하지 않습니다.

마찬가지로 두 주소 계열을 모두 가진 호스트 이름만으로는 자동 대체 연결이 이루어진다는 증거가 충분하지 않습니다. 실제 사용 중인 엔드포인트를 살펴보고 클라이언트에 문서화된 이름 해석 및 재연결 정책을 확인하세요. 프로젝트에서 별도로 제공하는 DNS 재해석 기여 코드는 동적 DNS 변경 후 커널의 엔드포인트 상태를 갱신합니다. 이는 관리 도구를 살펴볼 유용한 이유이지만, 모든 클라이언트가 호스트 이름을 지속적으로 재해석한다고 가정할 근거는 아닙니다.

지속적인 연결 유지는 유휴 상태에서 NAT 또는 방화벽 매핑이 유지되도록 하는 데 사용됩니다. 공식 빠른 시작 가이드는 이러한 설정 중 다수에 적합한 간격으로 25초를 제시하며 대부분의 사용자에게는 필요하지 않다고 설명합니다. 연결 유지는 대체 엔드포인트나 라우트 전환 정책을 지정하지 않습니다. 모바일 네트워크 변경 후 연결이 멈춘다는 증상만으로는 통신사 장애나 연결 유지 문제의 증거가 되지 않습니다.

구성을 내보내지 않고 Linux 연결 확인하기

wg0을 사용 중인 인터페이스 이름으로 바꾸세요. 다음은 자신의 컴퓨터에서 사용할 수 있는 참고 명령이며, 독자의 VPN을 대상으로 실행한 명령이 아닙니다.

sudo wg show wg0 endpoints
sudo wg show wg0 allowed-ips
sudo wg show wg0 latest-handshakes
sudo wg show wg0 transfer

wg 매뉴얼에는 이러한 선택적 조회 방법이 설명되어 있습니다. 출력은 로컬에 보관하세요. 엔드포인트와 피어 식별자도 네트워크 정보를 드러낼 수 있습니다. 전체 구성 내보내기 결과나 비밀 정보가 포함된 덤프를 공유하지 마세요.

알려진 공개 서비스에 접속을 시도하기 전후의 상태를 기록하세요. 유휴 터널에서 핸드셰이크가 오래되었다는 사실만으로는 장애를 진단하기에 충분하지 않습니다. 엔드포인트, 핸드셰이크, 전송량 관찰 결과를 애플리케이션의 결과와 비교하세요.

관찰 결과 다음 확인 사항
엔드포인트의 주소 계열이 내부 트래픽의 주소 계열과 다름 정상일 수 있으므로 목적지 선택을 별도로 확인하세요
접두사가 중복되어도 트래픽이 한 피어에 머무름 피어 연결 관계를 확인하세요. 중복만으로는 대기 동작이 설정되지 않습니다
네트워크 변경 후 엔드포인트에 도달할 수 없음 클라이언트의 엔드포인트 선택 및 재연결 정책을 확인하세요
터널 트래픽은 재개되지만 이름 해석은 여전히 실패함 Linux DNS 확인 절차를 사용해 DNS를 별도로 조사하세요

복구 정책 선택 및 확인하기

두 주소 계열로 모두 접속할 수 있는 서버가 하나라면, 필요한 엔드포인트 선택 및 복구 동작이 문서화된 클라이언트나 네트워크 관리자를 사용하세요. 일반 프로필에서는 한 번에 하나의 엔드포인트를 사용하는 통제된 비교를 통해 어떤 경로가 작동하는지 확인할 수 있지만, 수동 전환은 자동 장애 조치가 아닙니다.

변경하기 전에 원래 설정을 안전하게 저장하세요. 신뢰할 수 있는 연결에서 일반적인 네트워크 전환 전후에 동일한 무해한 애플리케이션 요청을 반복하세요. VPN 보호 기능은 계속 켜두세요. 복구에 필요한 원격 연결에서 강제로 장애를 일으키지 마세요.

자동 복구가 목표라면 전환 후 도달 가능한 엔드포인트, 새로운 핸드셰이크와 트래픽의 증거, 성공적인 애플리케이션 요청을 확인하세요. 두 내부 주소 계열이 모두 필요하다면 둘 다 확인하세요. 보장된 복구 시간이 있다고 가정하지 말고 직접 기록하세요. 변경으로 연결 상태가 더 나빠지면 저장해 둔 설정을 복원하세요.

브라우저 IP 확인 결과는 해당 브라우저 요청에 관한 증거입니다. 이 결과로 WireGuard가 선택한 엔드포인트를 식별하거나, 모든 애플리케이션의 라우트를 증명하거나, 향후 장애 조치가 작동한다고 입증할 수는 없습니다. 사이트의 DNS 확인 역시 기기의 재귀 DNS 리졸버를 확인하거나 VPN 라우팅을 증명하지는 않습니다. 실행 중 관찰 결과와 애플리케이션 확인을 함께 활용하세요.

어떤 목적지에 터널을 사용해야 하는지 더 폭넓게 알아보려면 분할 터널링 주제 허브를 참조하세요. 이 라우팅 결정은 장애가 발생한 서버 연결을 복구하는 정책과 별도로 다루세요.