이 글은 서비스 제공업체에서 받은 WireGuard 설정을 보유하고 있으며, Shadowrocket에서 각 항목을 확인하려는 사용자를 위한 안내입니다. 먼저 로컬 기기와 원격 피어의 키를 구분하고, 터널 주소와 대상 네트워크, UDP 엔드포인트를 확인하세요. 마지막으로 Global Routing을 이용해 프로토콜 연결 문제와 규칙 선택 문제를 구분합니다. 예시 주소는 항목을 설명하기 위한 것으로 실제 연결에는 사용할 수 없습니다.
1. 먼저 [Interface]와 [Peer] 구분하기
WireGuard 설정은 보통 [Interface]와 [Peer] 두 부분으로 나뉩니다. 앞부분은 로컬 기기의 터널 인터페이스를, 뒷부분은 통신할 원격 피어를 설명합니다. Shadowrocket에 설정을 입력할 때는 복사된 순서가 아니라 각 항목의 의미에 맞춰 입력하세요. 아래 조작 방법은 iPhone / iPad 기준이며, 다른 플랫폼에서는 항목 배치가 다를 수 있습니다.
PrivateKey는 로컬 기기에 속하고, [Peer] 안의 PublicKey는 원격 피어에 속합니다. 서버에도 로컬 기기에 해당하는 공개 키를 등록하고 올바른 주소를 할당해야 합니다. 클라이언트에 항목을 입력했다고 해서 서버 측 피어 설정까지 완료된 것은 아닙니다.
WireGuard의 개인 키, 공개 키, 선택 사항인 사전 공유 키는 보통 Base64 문자열로 표시되며, 표준 인코딩에서는 44자이고 끝에 =가 붙는 경우가 많습니다. 길이가 같다고 용도가 같은 것은 아니며, 키가 유효하다는 뜻도 아닙니다. 이 항목을 비밀번호, 구독 주소 또는 인증서 내용으로 취급하지 마세요.
2. PrivateKey, PublicKey, PresharedKey의 관계
로컬 기기 신원
- PrivateKey
- 로컬 기기의 개인 키입니다. 로컬 설정에 보관하고 문제 해결 담당자에게 보내지 마세요.
- 로컬 기기의 PublicKey
- 로컬 PrivateKey에서 파생되며, 서버에 로컬 기기 신원을 등록할 때 사용합니다.
- Address
- 서버가 로컬 기기에 할당한 터널 주소이며, 공용 서버 주소가 아닙니다.
로컬 PrivateKey를 변경하면 서버에 등록된 로컬 공개 키도 함께 변경해야 합니다.
원격 피어 신원
- [Peer] PublicKey
- 로컬 기기에서 연결할 피어를 식별하는 원격 공개 키입니다.
- PresharedKey
- 선택 사항인 추가 공유 키입니다. 사용하는 경우 양쪽에 같은 값을 설정해야 합니다.
- Endpoint
- 원격 피어에 연결할 주소와 UDP 포트입니다.
기존 설정에 PresharedKey가 없다면 임의로 만들어 입력하지 마세요.
가장 흔한 실수는 로컬 공개 키를 원격 PublicKey에 입력하거나, 원격 공개 키를 로컬 PrivateKey로 입력하는 것입니다. 두 경우 모두 문자열 형식 검사를 통과할 수 있지만 올바른 암호화 세션을 만들 수 없습니다. 확인할 때는 키가 어느 쪽에 속하는지, 공개 키인지 개인 키인지 모두 살펴보세요.
WireGuard 설정 전체를 공개하지 마세요. PrivateKey와 PresharedKey는 모두 민감한 정보입니다. 문의할 때는 항목 이름, 오류 메시지, 네트워크 증상만 남기고 키 내용은 삭제하세요. 개인 키가 이미 노출됐다면 새 키로 교체하고 서버에도 해당 공개 키를 갱신해야 합니다.
3. Address, DNS, MTU의 역할
Address는 터널 내부에서 사용하는 로컬 기기 주소이며, 보통 10.66.0.2/32처럼 CIDR 접두사를 포함합니다. 현재 Wi-Fi의 로컬 네트워크 주소도 아니고 Endpoint도 아닙니다. Wi-Fi 네트워크를 바꿨다고 이 주소를 새 로컬 네트워크 주소로 변경하지 마세요.
| 항목 | 예시 또는 단위 | 확인할 사항 |
|---|---|---|
| Address | 10.66.0.2/32 | 할당된 주소를 사용하고 접두사 길이를 임의로 늘리지 마세요. |
| DNS | DNS 서버 IP 주소 | DNS 서버에 연결할 수 있는지, Shadowrocket에서 현재 사용하는 DNS 설정이 무엇인지 확인하세요. |
| MTU | 바이트. 예: 1420 | 터널 내부 IP 패킷의 크기를 제한하며, 연결 속도를 뜻하지 않습니다. |
DNS와 Address는 WireGuard 핸드셰이크 자체의 신원 정보가 아닙니다. 일반적인 설정 파일에서 이 항목들은 클라이언트나 설정 도구가 처리합니다. 파일 내용을 Shadowrocket에 입력할 때 파일의 모든 항목이 앱의 전역 설정을 자동으로 덮어쓴다고 가정하지 마세요. Settings → DNS에서 실제로 사용하는 DNS 설정도 확인해야 합니다.
MTU가 너무 크면 작은 요청은 응답하지만 큰 데이터 전송은 멈추는 현상이 나타날 수 있습니다. 다만 다른 네트워크 문제도 같은 증상을 일으킬 수 있습니다. 외부 전송이 IPv4일 때 WireGuard의 일반적인 캡슐화 오버헤드는 60바이트, IPv6일 때는 80바이트입니다. 하위 네트워크의 MTU가 1500인 경우 1420은 IPv6 외부 전송까지 고려한 일반적인 시작값이지만, 모든 네트워크에 적합한 값은 아닙니다.
- 서비스 제공업체가 지정한 MTU를 우선 사용하세요. 지정값이 없다면 클라이언트 기본값을 유지하는 것이 좋습니다.
- 연결은 성립했지만 일부 전송에 문제가 있을 때만 MTU를 따로 조정해 테스트하세요.
- 한 번에 설정 하나만 변경하고, 같은 대상으로 다시 테스트한 뒤 변경 전후 값을 기록하세요.
4. AllowedIPs와 Global Routing은 다릅니다
WireGuard에서 AllowedIPs는 피어와 IP 접두사를 연결하는 데 사용됩니다. 데이터를 보낼 때는 대상 주소를 전달할 피어를 선택하고, 받을 때는 복호화된 패킷의 출발지 주소를 검증합니다. 기존 터널 도구는 이 값을 바탕으로 시스템 라우트를 설정하기도 합니다. 규칙 기반 프록시 클라이언트인 Shadowrocket에는 별도의 트래픽 선택 단계도 있습니다.
따라서 AllowedIPs = 0.0.0.0/0, ::/0는 해당 피어가 IPv4와 IPv6 주소 범위를 모두 담당한다는 뜻이지, 기기의 모든 요청이 Shadowrocket에서 선택되어 그 피어로 전송된다는 뜻은 아닙니다. 연결 스위치, 현재 선택된 연결, Global Routing, 구성 규칙에서 사용하는 정책도 확인해야 합니다.
# 항목 설명용 조각이며, 그대로 가져올 수 있는 완전한 연결 설정이 아닙니다.
# 아래 주소는 문서 예시이며 연결 서비스를 제공하지 않습니다.
[Interface]
Address = 10.66.0.2/32
MTU = 1420
[Peer]
Endpoint = 192.0.2.10:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25
예시에서 키는 의도적으로 생략했습니다. 0.0.0.0/0은 IPv4만 포함하고 ::/0은 IPv6를 포함합니다. 10.66.0.0/24만 입력하면 해당 피어는 이 네트워크만 담당하므로 임의의 공용 인터넷 주소까지 전달할 것으로 기대할 수 없습니다. IPv6 설정 여부는 서버 지원과 실제 할당된 주소를 기준으로 판단하세요.
DOMAIN-SUFFIX,example.com,DIRECT: 규칙 모드에서 해당 도메인 접미사에 DIRECT를 적용합니다.IP-CIDR,192.0.2.0/24,DIRECT,no-resolve: 예시 IPv4 네트워크에 DIRECT를 지정하고, 이 규칙을 위해 도메인을 직접 조회하지 않습니다.GEOIP,CN,DIRECT: 사용 중인 GeoIP 데이터베이스에 따라 IP의 위치 정보를 기준으로 일치시킵니다. 결과는 데이터베이스의 주소 기록에 따라 달라집니다.FINAL,DIRECT: 규칙 목록 끝에서 기본 처리로 사용합니다. 실제 정책은 자신의 설정에 맞춰 지정하세요.
위 항목은 [Rule] 섹션의 규칙이며 AllowedIPs에 붙여 넣으면 안 됩니다. 규칙은 순서대로 적용됩니다. 앞쪽의 DIRECT 규칙이 먼저 일치하면 뒤쪽의 프록시 정책은 해당 요청을 처리하지 않습니다.
5. Endpoint와 PersistentKeepalive 설정 범위
Endpoint는 현재 네트워크를 통해 로컬 기기에서 먼저 접속해야 하는 원격 주소입니다. IP 주소 또는 호스트명과 포트로 구성할 수 있습니다. 표준 설정에서는 192.0.2.10:51820처럼 씁니다. 편집 화면에서 주소와 포트를 따로 입력하게 되어 있다면 각각 입력하고, 전체 문자열을 두 항목에 중복으로 넣지 마세요.
- 주소 항목에는
https://를 붙이거나 웹 경로를 덧붙이지 말고, 구독 URL의 쿼리 매개변수도 붙여 넣지 마세요. - 표준 설정에서 IPv6 엔드포인트는
[2001:db8::10]:51820처럼 대괄호로 감싸야 주소 안의 콜론을 포트 구분 기호로 잘못 해석하지 않습니다. - 원격 서버가 설정에 지정된 UDP 포트에서 수신 대기 중인지 확인하세요. TCP 포트 확인에 성공해도 같은 번호의 UDP 포트에 연결할 수 있다는 뜻은 아닙니다.
- 호스트명을 사용하는 경우 터널이 연결되기 전에도 이름을 조회할 수 있는지 먼저 확인하세요. 아직 연결되지 않은 터널 내부 DNS에 의존하지 않도록 합니다.
PersistentKeepalive의 단위는 초입니다. 필요할 때 주기적으로 데이터를 보내 NAT 또는 방화벽 상태를 유지합니다. 25는 흔히 쓰이는 값이지 필수값은 아닙니다. 설정하지 않거나 0으로 지정하면 보통 주기적인 연결 유지가 비활성화됩니다. 연결 시간 초과 설정이 아니며, 잘못된 공개 키나 서버에서 허용되지 않은 포트를 해결하지도 못합니다.
Wi-Fi와 모바일 네트워크를 전환한 뒤에만 연결이 끊긴다면 전환 시각, 재연결 가능 여부, UDP 연결 가능 여부를 기록한 다음 연결 유지 설정이 필요한지 판단하세요. 연결 유지 간격을 계속 줄이는 것으로 신원 정보와 엔드포인트 확인을 대신하지 마세요.
6. Shadowrocket에 입력하고 단계별로 확인하기
아래 단계는 유효한 설정을 이미 보유하고 있다는 전제에서 설명합니다. 이 사이트는 노드나 구독을 제공하거나 판매하거나 추천하지 않습니다. 직접 이용 중인 구독에서 매개변수를 가져왔다면 먼저 서비스 제공업체의 원본 정보를 확인하세요. 구독을 갱신하면 연결 항목이 다시 기록될 수 있으므로 문제 해결 전에 현재 값을 메모해 수동 변경 사항이 다음 갱신 때 덮어써지지 않게 하세요.
-
프로토콜 선택
Home →「+」→ Type → WireGuard로 이동합니다. 기존 연결을 편집하려면 Home에서 해당 항목을 열고 Type부터 확인하세요. 다른 프로토콜의 비밀번호나 식별자를 WireGuard 키 항목에 입력하지 마세요.
-
신원 정보 확인
로컬 기기와 원격 피어의 대응 관계에 따라 PrivateKey, 원격 PublicKey, 설정에서 요구하는 경우에만 PresharedKey를 입력하세요. 서버에 로컬 기기의 공개 키가 등록되어 있는지도 확인합니다.
-
주소 확인
Address, Endpoint, 포트를 확인하세요. 편집 화면에 기존 설정의 항목이 별도로 없다면 현재 클라이언트에서 그 항목을 입력하는 위치부터 확인하세요. 의미가 비슷해 보여도 다른 항목에 대신 입력하지 마세요.
-
임시 테스트
저장한 뒤 해당 연결을 선택하고 Home → Global Routing → Proxy에서 접속할 수 있는지 확인된 같은 대상을 테스트하세요. 연결 상태와 로그를 확인하고, 목록에 표시된 지연 시간만으로 실제 서비스 동작까지 검증됐다고 판단하지 마세요.
-
규칙 설정 복원
테스트가 끝나면 Home → Global Routing → Config로 돌아가 Config에서 활성화된 설정과 대상에 적용되는 정책을 확인하세요. 자동 재연결이 테스트에 영향을 준다면 Settings → On Demand도 확인합니다.
On Demand는 조건에 따른 자동 연결 동작을 제어하며 AllowedIPs나 [Rule]을 대신하지 않습니다. 문제 해결 중 비활성화했다면 원래 설정을 기록하고 테스트 후 복원하세요. 그래야 자동 재연결을 수동 스위치가 작동하지 않는 것으로 오해하지 않습니다.
Config
권장현재 구성 규칙에 따라 트래픽 처리 방식을 결정합니다. 규칙에 따라 DIRECT를 선택하거나 WireGuard를 사용하는 정책을 선택할 수 있습니다. 일치하지 않은 요청이 모두 자동으로 프록시를 통과하는 것은 아니며, 최종 동작은 FINAL 설정에 따라 달라집니다.
권장 상황: 프로토콜 연결 확인을 마친 뒤 일상적으로 규칙에 따라 트래픽을 분기할 때.
Proxy
트래픽을 프록시 방식으로 처리해 규칙 분기가 테스트에 미치는 영향을 줄일 수 있습니다. 현재 선택 항목이 테스트할 연결을 가리켜야 하며, 시스템에서 처리하는 트래픽 범위나 원격 권한, WireGuard 설정의 제약을 우회하지는 않습니다.
권장 상황: 규칙 선택이 문제 원인인지 임시로 확인할 때.
Direct
트래픽을 직접 연결 방식으로 처리해 로컬 네트워크 상태를 비교할 수 있습니다. 이 상태에서 대상에 접속되더라도 테스트가 해당 연결을 거치지 않았을 수 있으므로 WireGuard 설정이 올바르다는 증거는 아닙니다.
권장 상황: 현재 로컬 네트워크에서 대상에 직접 연결되는지 확인할 때.
7. 증상별로 문제 범위 좁히기
연결 스위치가 켜져 있다는 이유만으로 WireGuard 핸드셰이크가 완료됐다고 판단하지 마세요. 스위치는 클라이언트의 연결 상태를 나타낼 뿐이며, 원격 신원 정보 일치 여부, UDP 송수신, 특정 대상과의 데이터 전송은 각각 확인해야 합니다. 아래는 점검 순서이며, 단일 증상만으로 고장 원인을 확정할 수는 없습니다.
| 관찰된 증상 | 우선 확인할 항목 | 다음 단계 |
|---|---|---|
| 통신이 정상적으로 이루어지지 않음 | 양쪽에 등록된 공개 키, PresharedKey, Endpoint, UDP 포트 | 이용 중인 서비스 제공업체에 서버 수신 대기 상태와 원격 피어 등록 여부를 확인해 달라고 요청하세요. |
| 지정한 IP에는 연결되지만 도메인 접속은 실패함 | DNS 연결 가능 여부와 실제 이름 조회 경로 | 같은 대상을 사용해 도메인 조회 결과를 비교하고, 서로 다른 서비스를 비교하지 않도록 하세요. |
| 작은 요청은 되지만 큰 데이터 전송은 멈춤 | 경로 MTU, 패킷 손실, 원격 측 제한 | 다른 설정은 그대로 두고 MTU만 조정한 뒤 동일한 테스트를 반복하세요. |
| Proxy에서는 정상이나 Config에서는 문제가 발생함 | 현재 구성, 일치한 규칙, 정책 선택 | 대상이 DIRECT 또는 다른 정책에 먼저 일치하는지 확인하세요. |
| 구독 갱신 후 설정값이 변경됨 | 갱신 전후 항목과 서버에서 할당한 값 | 구독 소스에서 반환된 내용을 확인하고, 서비스 제공업체가 변경한 설정을 반복해서 덮어쓰지 마세요. |
서비스 제공업체에 문의할 때는 운영체제 플랫폼, 사용 중인 네트워크 유형, 문제가 발생하는 조건, 확인한 항목 이름, 민감 정보를 제거한 오류 기록을 전달하세요. PrivateKey나 PresharedKey는 보내지 마세요. 서버에서 공개 키, 포트 또는 주소 할당을 변경했다고 확인되면 해당 항목을 함께 갱신한 뒤 프로토콜 테스트부터 다시 점검합니다.