이 글의 핵심 내용

WireGuard 클라이언트 설정을 받아 Shadowrocket에 직접 추가하려는 분을 위한 안내입니다. 먼저 [Interface]와 [Peer]로 로컬과 상대 피어의 설정을 구분하고, 대상 트래픽이 터널을 거쳐야 하는지 확인하세요. 연결에 문제가 생기면 핸드셰이크, 대상 IP, 도메인 확인, 패킷 크기 순으로 점검하면 여러 설정을 한꺼번에 바꿀 필요가 없습니다.

Home에서 WireGuard 추가하기

iPhone / iPad를 기준으로 설명합니다. 시작하기 전에 기존 서비스를 관리하는 담당자에게 받은 설정이 현재 기기에 배정된 클라이언트 설정인지 확인하세요. 서버 설정이나 다른 기기의 설정이 아닌지 확인해야 합니다. 두 설정 모두 [Interface]와 [Peer]를 포함할 수 있지만, 키와 주소가 지정된 대상은 다릅니다.

  1. Home에서 오른쪽 위의 +를 누른 다음 Add Server로 이동하고, Type에서 WireGuard를 선택합니다.
  2. 원본 설정을 참고해 로컬 주소와 키, 상대 피어 연결 정보를 입력합니다. 화면에서 호스트와 포트를 따로 입력한다면 Endpoint를 두 항목으로 나눠 입력하세요. 호스트 입력란에 포트를 함께 붙여 넣지 마세요.
  3. 저장한 다음 Home으로 돌아와 방금 추가한 WireGuard 항목을 선택하고 연결 스위치를 켭니다. 시스템에서 VPN 구성 추가를 요청하면 기기의 안내에 따라 승인하세요. 스위치가 켜졌다는 것은 로컬 연결이 활성화됐다는 뜻일 뿐, 상대 피어와 핸드셰이크가 완료됐다는 의미는 아닙니다.
  4. 관리자가 해당 항목을 통해 전달된다고 확인해 준 대상에 접속해 보세요. Global Routing에서 Config를 사용하는 경우, 해당 대상이 규칙에 따라 DIRECT 또는 다른 아웃바운드로 지정되지 않았는지 먼저 확인합니다.
클라이언트 정보필드 입력아웃바운드 선택대상 요청응답 확인

PrivateKey, PublicKey, Endpoint의 입력 위치

아래 필드 이름은 일반적인 WireGuard 클라이언트 설정 파일의 표기를 따르며, 각 플랫폼의 입력란 이름과 반드시 일치하는 것은 아닙니다. 예시 주소는 문서용 예약 주소로, 실제 연결에 사용할 수 없습니다.

로컬: [Interface]

PrivateKey
현재 기기의 개인 키입니다. 로컬 기기에 배정된 전체 값을 사용하세요. 로컬 공개 키를 여기에 입력하거나 끝의 =를 삭제하지 마세요.
Address
로컬 기기에 할당된 터널 주소입니다. 예: 192.0.2.10/32. 원래 접두사 길이를 유지하고 서버의 공인 주소는 입력하지 마세요.
DNS
원본 설정에 지정된 DNS 리졸버를 입력합니다. 리졸버가 원격 사설망에 있다면 해당 리졸버로 향하는 요청이 올바른 경로를 이용하는지도 확인해야 합니다.
MTU
터널 인터페이스의 최대 전송 단위로, 바이트 단위입니다. 원본 설정에 값이 있으면 우선 그대로 사용하고, 지정된 값이 없으면 클라이언트의 기본 동작을 유지하세요.

관리자에게 등록을 요청해야 하는 것은 로컬 공개 키이며, 로컬 개인 키가 아닙니다.

상대 피어: [Peer]

PublicKey
상대 피어의 공개 키입니다. 클라이언트는 이 키로 원격 피어를 식별합니다. 로컬 개인 키에서 공개 키를 만들어 여기에 입력하지 마세요.
Endpoint
상대 피어에 연결할 수 있는 주소와 UDP 포트입니다. 예: 192.0.2.20:51820. IPv6를 한 필드에 입력할 때는 [2001:db8::20]:51820 형식을 사용하세요.
AllowedIPs
이 상대 피어에 지정된 주소 접두사입니다. 예: 198.51.100.0/24. 로컬 Address와는 다르며, 도메인을 입력하는 항목도 아닙니다.
PresharedKey
선택 사항인 사전 공유 키입니다. 원본 설정에 이 값이 있으면 상대 피어 설정과 일치해야 합니다. 공개 키로 대체할 수 없습니다.
PersistentKeepalive
초 단위의 연결 유지 간격입니다. 설정에서 요구하거나 NAT 매핑을 유지해야 할 때만 사용하세요. 예를 들어 25는 25초마다 연결 유지 패킷을 보낸다는 뜻입니다.

51820은 흔히 사용하는 예시 포트일 뿐, 고정값이 아닙니다. 상대 피어가 실제로 수신 대기 중인 UDP 포트를 사용하세요.

PrivateKey를 변경했다면 관리자에게 요청해 상대 피어에 등록된 로컬 공개 키도 업데이트하세요. 클라이언트에서만 키를 바꾸고 상대 피어를 업데이트하지 않으면 주소와 포트가 모두 정확해도 핸드셰이크가 완료되지 않습니다. 문제를 확인할 때 PrivateKey 또는 PresharedKey가 포함된 설정 원문이나 화면 캡처를 보내지 마세요.

AllowedIPs와 Global Routing의 역할

AllowedIPs는 WireGuard가 어떤 대상 주소로 향하는 아웃바운드 트래픽을 해당 피어로 전달할지 결정하며, 해당 피어에서 받은 내부 패킷의 출발지 주소를 확인하는 데도 사용됩니다. 반면 Global Routing은 Shadowrocket이 특정 연결을 해당 아웃바운드로 보낼지 결정합니다. 두 설정 모두 맞아야 합니다. 대상 네트워크를 AllowedIPs에 추가해도 Shadowrocket의 라우팅 규칙은 바뀌지 않으며, 규칙에서 WireGuard를 선택해도 해당 대상이 피어의 주소 범위에 자동으로 추가되지는 않습니다.

/32
단일 IPv4 주소
/128
단일 IPv6 주소
0.0.0.0/0
모든 IPv4 주소
::/0
모든 IPv6 주소

정리: 대상 IP를 먼저 확인한 뒤 접두사를 수정하세요

예를 들어 대상이 198.51.100.0/24 범위에 없다면 먼저 해당 트래픽이 상대 피어를 거쳐야 하는지 확인하세요. 테스트를 통과하려고 곧바로 0.0.0.0/0으로 바꾸지 마세요. 도메인이 IPv4와 IPv6 주소를 모두 반환한다면 실제로 사용된 주소 계열도 확인해야 합니다.

핸드셰이크 실패, 도메인 접속 문제, MTU 점검

테스트할 때는 대상과 네트워크를 동일하게 유지하고, 한 번에 한 항목만 변경하세요. Endpoint에 도메인을 입력했다면 터널이 연결되기 전에 해당 도메인을 확인할 수 있어야 합니다. 터널 연결 후에만 접근할 수 있는 DNS 리졸버로는 첫 연결 단계에서 발생한 문제를 해결할 수 없습니다.

증상점검 방법
대상에 요청을 보내도 핸드셰이크가 되지 않음클라이언트에 핸드셰이크 상태가 표시되지 않으면 관리자에게 상대 피어의 최근 핸드셰이크 시각을 확인해 달라고 요청하세요. Endpoint의 호스트와 실제 UDP 포트, 상대 피어의 공개 키와 사전 공유 키를 확인하고, 상대 피어에 로컬 공개 키가 등록되어 있는지도 점검합니다. 일반 웹사이트에 접속된다고 해서 해당 UDP 포트에 연결할 수 있다는 뜻은 아닙니다.
핸드셰이크는 성공했지만 대상 IP에 접속할 수 없음앱에서 선택한 아웃바운드와 대상이 로컬 AllowedIPs에 포함되는지 확인하세요. 상대 피어에 로컬 터널 주소의 올바른 접두사가 설정되어 있는지, 응답 경로가 구성되어 있는지도 확인합니다. 핸드셰이크 성공이 대상 네트워크의 전달 설정까지 완료됐다는 뜻은 아닙니다.
대상 IP에는 접속되지만 도메인은 접속되지 않음먼저 도메인이 해석되는지, DNS 리졸버에 연결할 수 있는지 확인한 뒤 반환된 주소와 라우팅 결과를 비교하세요. 브라우저에서 HTTPS 사이트의 IP 주소에 직접 접속하는 방법만으로 비교하지 마세요. 인증서나 사이트 선택 문제로도 접속에 실패할 수 있습니다.
작은 요청은 되지만 큰 응답은 계속 멈춤대상 서비스에 문제가 없는지 확인한 다음 경로 MTU를 테스트하세요. 원래 값을 기록하고, 예를 들어 1420을 잠시 1380으로 낮춘 뒤 동일한 요청을 다시 테스트합니다. 이 차이는 문제를 찾기 위한 테스트일 뿐 일반적인 권장값이 아닙니다. 개선되지 않으면 원래 값으로 되돌리세요.

Shadowrocket 전체 플랫폼 다운로드

iPhone / iPad에서는 App Store에서 다운로드할 수 있으며, 가격은 $2.99 일회성 결제입니다. 개발자는 Shadow Launch Technology Limited이며, 시스템 요구 사항은 App Store 페이지 표기를 기준으로 확인하세요. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료이며, 설치 파일은 이 사이트의 다운로드 페이지에서 받을 수 있습니다.