서비스 제공업체에서 받은 WireGuard 설정을 Shadowrocket에 입력하기 전에 각 항목을 확인하려는 사용자를 위한 안내입니다. 먼저 로컬 Interface와 원격 Peer, 터널 주소를 구분한 다음 Allowed IPs와 앱 규칙의 차이를 살펴보고, 마지막으로 핸드셰이크와 소량·대량 데이터 전송 순서로 MTU 문제를 점검합니다. 예시 주소는 항목 설명용이며 실제 서버 접속에 사용할 수 없습니다.
1. 로컬 Interface와 원격 Peer 구분하기
Shadowrocket의 WireGuard 설정은 ‘서버 주소와 비밀번호’ 방식이 아닙니다. WireGuard는 공개 키로 통신 상대를 식별합니다. 로컬 기기에는 자신의 Private Key를 저장하고, 이에 대응하는 Public Key를 원격에 등록합니다. 로컬 설정의 Peer에는 원격 Public Key를 입력합니다. 양쪽 키가 서로 맞아야 하며, 서버 주소만 알아서는 유효한 터널을 만들 수 없습니다.
표준 WireGuard 설정 파일은 보통 [Interface]와 [Peer] 섹션으로 나뉩니다. 앞부분에는 로컬 신원과 터널 내부 주소 등의 항목이, 뒷부분에는 통신 상대와 해당 Peer를 통해 전송할 수 있는 주소 범위가 들어갑니다. Shadowrocket의 노드 입력 화면에서는 이 항목들이 여러 입력란으로 나뉠 수 있으므로, 의미에 맞춰 대응시켜 입력하세요. 설정 파일 전체를 특정 키 입력란에 붙여 넣으면 안 됩니다.
2. Private Key, Address, Peer 입력 항목
Private Key는 로컬 기기의 개인 키이며, 원격 비밀번호가 아닙니다. 로컬 Public Key와 한 쌍을 이룹니다. 로컬 Private Key를 바꿨는데 원격에 새 Public Key를 등록하지 않으면 원격은 기존 신원으로 통신을 허용하지 않습니다. ‘다시 시도’하려고 키를 임의로 생성하거나 교체하지 마세요. 먼저 서비스 제공업체에서 받은 설정이 완전한지, 현재 기기에 해당하는 설정인지 확인해야 합니다.
Address는 터널 내부 주소이며 Endpoint가 아닙니다. 예를 들어 10.66.66.2/32는 터널에서 사용하는 로컬 IPv4 주소와 프리픽스를 나타냅니다. 서버 공인 IP, 현재 Wi-Fi 주소, 접속하려는 웹사이트 주소를 여기에 입력하지 마세요. 서비스 제공업체가 IPv4와 IPv6 주소를 모두 제공했다면 입력 화면에서 지원하는 방식에 따라 각각 입력하세요. 할당되지 않은 주소를 임의로 계산해 사용하면 안 됩니다.
로컬 Interface
- Private Key
- 서비스 제공업체 설정에 있는 로컬 Private Key를 입력합니다. Base64 문자와 끝의 패딩 문자를 그대로 유지하세요.
- Address
- 예: 10.66.66.2/32. 터널 주소 형식을 보여 주기 위한 예시입니다.
- MTU
- 터널 인터페이스에서 허용할 IP 패킷 크기를 지정합니다. 우선 설정에 명시된 값을 사용하세요.
- DNS
- 원본 설정에 이 항목이 있다면 Shadowrocket의 DNS 설정에서도 적용되는지 확인하세요.
Address, DNS, MTU는 설정 항목이며 키 인증을 대신하지 않습니다.
원격 Peer
- Public Key
- 원격 Public Key를 입력합니다. 로컬 Public Key나 어느 쪽의 Private Key를 입력하는 곳이 아닙니다.
- Endpoint
- 예: 192.0.2.10:51820. 주소와 포트는 설명용 예시입니다.
- Allowed IPs
- 예: 0.0.0.0/0. 구체적인 범위는 서비스 제공업체의 설정과 사용 목적에 따라 달라집니다.
- Preshared Key
- 선택 사항인 추가 공유 키입니다. 원격에서 사용한다면 양쪽 값이 일치해야 합니다.
원본 파일의 PublicKey, AllowedIPs 같은 축약 표기는 여기서 의미에 맞는 항목으로 입력합니다.
Preshared Key와 Private Key는 서로 다른 항목입니다. 전자는 양쪽이 합의해 사용하는 추가 공유 비밀 키이고, 후자는 로컬 신원을 나타내는 키입니다. 원본 설정에 Preshared Key가 없다면 임의의 문자열을 입력하지 마세요. 키의 길이나 모양이 비슷하더라도 서로 바꿔 쓸 수 있는 것은 아닙니다.
3. Endpoint 주소·포트와 UDP 연결 확인
Endpoint는 WireGuard 통신을 시작할 외부 네트워크의 목적지를 지정합니다. 입력 화면에서 Address 또는 Server와 Port가 나뉘어 있다면 주소란에는 호스트명이나 IP만, 포트란에는 서비스 제공업체가 안내한 숫자만 입력하세요. https://나 웹 경로는 붙이지 않습니다. 원본 파일에서 IPv6 Endpoint를 사용한다면 흔히 [2001:db8::10]:51820 형식으로 입력합니다. 대괄호는 주소 안의 콜론과 포트 구분자를 구별하기 위한 것입니다.
- 호스트명 Endpoint: 먼저 DNS 조회가 성공해야 합니다. 조회에 실패하면 WireGuard 키를 확인하는 단계까지 진행되지 않습니다.
- 포트: 설정에 지정된 값을 사용하세요. 51820을 443으로 바꾼다고 연결이 자동으로 되는 것은 아니며, WireGuard가 HTTPS로 바뀌는 것도 아닙니다.
- UDP 연결 가능 여부: 현재 Wi-Fi, 모바일 네트워크, 라우터, 원격 방화벽이 모두 UDP 연결에 영향을 줄 수 있습니다. 일반 웹페이지가 열린다고 해서 해당 UDP 포트에 연결할 수 있는 것은 아닙니다.
- 네트워크 전환: Wi-Fi에서 모바일 네트워크로 바꾼 뒤 결과가 달라지면 네트워크, Endpoint 주소 계열, 테스트 결과를 각각 기록하세요. 키를 동시에 바꾸지 마세요.
Persistent Keepalive는 NAT 매핑을 유지하는 데 도움을 주도록 주기적으로 연결 유지 패킷을 보냅니다. 설정의 PersistentKeepalive = 25는 25초 간격을 사용하는 흔한 예시일 뿐, 모든 네트워크에 필요한 값은 아닙니다. 잘못된 Public Key, 닫힌 원격 포트, 만료된 계정 권한은 이 설정으로 해결할 수 없습니다.
4. Allowed IPs와 Global Routing의 트래픽 분기 구분
WireGuard에서 Allowed IPs는 목적지 트래픽을 보낼 Peer를 선택하는 데 쓰이며, 해당 Peer에서 수신할 내부 소스 주소도 제한합니다. 0.0.0.0/0은 모든 IPv4 주소를, ::/0은 모든 IPv6 주소를 포함합니다. 앞 항목만 입력해도 IPv6까지 자동으로 포함되는 것은 아닙니다. 서비스 제공업체가 사설 네트워크 대역만 제공했다면 보통 특정 내부망 접속을 위한 설정입니다. 범위를 임의로 넓힌다고 원격에서 인터넷 전체를 전달할 수 있게 되는 것은 아닙니다.
Shadowrocket에는 별도의 트래픽 결정 단계도 있습니다. Global Routing과 Config 규칙이 트래픽을 해당 노드로 보낼지 먼저 결정합니다. Peer의 Allowed IPs에 기본 경로가 포함되어 있어도 DIRECT에 일치하는 트래픽이 자동으로 해당 노드를 경유하지는 않습니다. 반대로 앱 규칙이 트래픽을 WireGuard로 보내더라도 원격에서 적절한 포워딩, 라우팅, 외부 연결을 설정했다는 뜻은 아닙니다.
| 설정 단계 | 구체적인 예 | 해결하는 문제 |
|---|---|---|
| Peer의 Allowed IPs | 10.20.0.0/16 | 해당 Peer에서 사용할 내부 주소 범위를 지정합니다. 도메인 규칙은 아닙니다. |
| Peer의 기본 경로 범위 | 0.0.0.0/0, ::/0 | 두 IP 주소 계열을 모두 포함합니다. 원격에서 해당 트래픽을 전달할 수 있어야 합니다. |
| Config의 도메인 규칙 | DOMAIN-SUFFIX,example.com,DIRECT | 일치하는 도메인의 트래픽에 DIRECT 정책을 적용합니다. |
| Config의 주소 규칙 | IP-CIDR,192.0.2.0/24,DIRECT | 목적지 IPv4 대역에 따라 정책을 선택합니다. Peer 키는 변경하지 않습니다. |
Global Routing에서 Proxy는 프록시 라우팅, Direct는 직접 연결, Config는 현재 설정의 규칙 적용, Scene은 설정된 시나리오에 따른 동작을 뜻합니다. 문제를 확인할 때는 먼저 현재 모드를 기록하세요. Direct 모드에서 외부 웹사이트를 테스트한 결과만으로는 WireGuard 노드가 작동한다고 판단할 수 없습니다. Config를 사용하는 경우 테스트 대상에 실제로 어떤 규칙과 정책이 적용되는지 확인하세요.
5. Shadowrocket에 설정을 입력하고 순서대로 테스트하기
다음은 iPhone / iPad에서 Home 화면의 노드를 편집하는 절차입니다. 서비스 제공업체의 원본 설정과 현재 작동하는 설정을 보관한 뒤 항목별로 입력하세요. 화면에서 항목 순서는 달라질 수 있지만 로컬과 Peer의 대응 관계는 같습니다. 구독으로 가져온 WireGuard 노드가 있다면 새로 만들기보다 기존 노드의 편집 화면에서 먼저 확인하세요. 이름은 비슷하지만 매개변수가 다른 노드를 여러 개 만들지 마세요.
매개변수 준비
서비스 제공업체에서 설정을 받아 Interface와 Peer를 구분하고 Endpoint, 포트, Address, Allowed IPs, MTU를 확인하세요. 키는 공개 메모에 복사하지 마세요.
프로토콜 선택
Home → 오른쪽 위 ‘+’ → Type → WireGuard. 양식에서 로컬 매개변수와 Peer 매개변수를 구분해 입력하고, 설정 파일 전체를 Private Key란에 붙여 넣지 마세요.
항목별 입력
로컬 Private Key와 Address를 입력한 다음 Peer의 Public Key, Endpoint 주소와 포트를 입력하세요. 나머지 옵션도 원본 설정에 맞춰 입력한 뒤 저장합니다.
노드 선택
Home으로 돌아가 해당 서버 왼쪽의 점을 선택한 뒤 Global Routing 설정을 확인하세요. 규칙의 영향을 배제해야 한다면 잠시 Proxy로 전환해 테스트하고, 완료 후 기존 모드로 되돌립니다.
트래픽 확인
연결 스위치를 켭니다. 처음 VPN 설정 추가 안내가 나오면 시스템 안내에 따라 진행하세요. Connectivity Test를 실행한 다음 작은 웹페이지와 큰 데이터 전송을 각각 테스트하고 결과를 기록합니다.
Connectivity Test 성공은 선택한 테스트 방식에서 연결이 확인되었다는 뜻일 뿐, 터널 내부 서비스까지 정상임을 보장하지 않습니다. 시스템에 VPN 연결됨으로 표시되어도 원격과 유효한 핸드셰이크가 완료된 것은 아닐 수 있습니다. 화면이나 로그에서 핸드셰이크 시간, 송신량, 수신량을 확인할 수 있다면 함께 살펴보세요. 송신 카운터만 증가하는 것을 양방향 통신이 정상이라고 해석해서는 안 됩니다.
6. MTU 오류 증상과 한 번에 한 항목씩 조정하는 방법
MTU는 터널 인터페이스에서 허용하는 IP 패킷 크기를 바이트 단위로 제한합니다. WireGuard는 내부 IP 패킷에 암호화와 UDP/IP 캡슐화를 추가하고, 외부 경로에 다른 터널이 포함될 수도 있으므로 물리 네트워크 인터페이스에서 흔히 쓰는 1500을 그대로 적용할 수 없습니다. 1420은 자주 쓰이는 설정값이지만 모든 네트워크에 맞는 정답은 아닙니다. 실제 사용 가능한 값은 외부 주소 계열과 경로의 전송 용량에 따라 달라집니다.
MTU 또는 경로 MTU 탐색에 문제가 있을 때 나타나는 전형적인 증상은 핸드셰이크와 소량 데이터 전송은 되는 듯하지만 큰 응답, 업로드, 지속적인 전송이 멈추는 것입니다. 패킷 손실, DNS, 원격 제한, 앱 시간 초과도 같은 증상을 일으킬 수 있으므로 이는 점검을 위한 단서일 뿐입니다. 핸드셰이크조차 되지 않으면 먼저 키, Endpoint, UDP를 확인하고 MTU는 나중에 조정하세요.
설정된 MTU 사용
권장서비스 제공업체가 명시한 값을 먼저 사용해 비교 기준을 확보하세요. 원본 설정에 값이 없다면 네트워크 속도로 추측하지 말고 클라이언트의 기본 동작을 유지하세요.
적합한 경우: 처음 설정하거나 큰 패킷 전송 문제가 확인되지 않은 경우
MTU를 낮춰 비교
기존 값이 1420이라면 다른 매개변수는 그대로 둔 채 1380, 1280으로 한 번씩 낮춰 비교할 수 있습니다. 매번 저장한 뒤 다시 연결해 테스트하세요. 테스트 값이 최종 최적값이라고 단정하면 안 됩니다.
적합한 경우: 소량 전송은 정상이지만 큰 데이터 전송이 반복해서 멈추는 경우
MTU 높이기
경로 조건과 테스트 결과가 뒷받침될 때만 고려하세요. 값이 크다고 속도가 빨라지는 것은 아닙니다. 경로의 전송 용량을 넘으면 오히려 단편화, 패킷 손실, 연결 대기가 발생할 수 있습니다.
적합한 경우: 안정적인 기준값이 있고 테스트 조건을 통제할 수 있는 고급 진단
- 같은 네트워크, 같은 대상, 같은 전송 작업으로 비교하세요. MTU를 조정하는 동안 Peer나 DNS를 함께 바꾸지 마세요.
- IPv6의 최소 링크 MTU는 1280입니다. IPv6를 사용해야 한다면 일반적인 해결책이라며 MTU를 1280 미만으로 계속 낮추지 마세요.
- ‘기존 값, 변경 값, 재연결 여부, 소량 전송 결과, 대량 전송 결과’를 기록하세요. 한 번의 로딩 속도만으로 결론 내리지 마세요.
- MTU를 낮춰도 안정적으로 개선되지 않으면 기존 값으로 복구하고 패킷 손실, 네트워크 제한, 서버 측 포워딩을 확인하세요.
7. 장애가 발생한 단계별로 점검하고 모든 문제를 키 오류로 보지 않기
외부부터 안쪽 순서로 점검하세요. 먼저 Endpoint가 정상적으로 조회되고 설정이 올바른지 확인한 다음 UDP 통신과 신원 매개변수를 점검하고, 이어서 내부 주소, 라우팅, DNS, 앱 트래픽 분기를 확인합니다. 여러 항목을 한꺼번에 바꾸지 마세요. 연결이 복구되더라도 원인을 알 수 없고, 잘못된 주소 범위나 불필요한 연결 유지 설정이 남을 수 있습니다.
| 관찰된 증상 | 먼저 확인할 항목 | 다음 조치 |
|---|---|---|
| Endpoint 호스트명을 조회할 수 없음 | 호스트명 철자, 현재 DNS, 네트워크 연결 | Private Key는 바꾸지 말고 먼저 호스트명 조회를 복구하세요. |
| 유효한 핸드셰이크나 양방향 트래픽이 확인되지 않음 | UDP 포트, 원격 Public Key, 원격에 등록된 로컬 키, Preshared Key | Private Key를 직접 보내지 말고 서비스 제공업체와 항목별로 확인하세요. |
| 핸드셰이크는 정상이지만 대상에 연결할 수 없음 | Address, Allowed IPs, 원격 포워딩, Global Routing, 규칙 | 해당 대상 트래픽이 실제로 이 노드를 통해 전달되는지 확인하세요. |
| IP로는 접속되지만 도메인으로는 접속되지 않음 | DNS 조회와 DNS 요청의 실제 라우팅 | Peer를 다시 만들기 전에 DNS 조회 경로만 따로 점검하세요. |
| 작은 요청은 정상이지만 큰 데이터 전송이 멈춤 | MTU, 경로 패킷 손실, 원격 제한 | 다른 조건을 고정하고 MTU를 한 단계씩 낮춰 비교하세요. |
| 구독 갱신 후 기존 매개변수로 되돌아감 | 해당 노드가 구독으로 관리되는지 여부 | 서비스 제공업체에 원본 설정을 확인하고 구독 노드와 수동 노드를 구분하세요. |
구독을 갱신하면 서비스 제공업체가 전달한 노드 매개변수가 다시 적용될 수 있습니다. 진단을 위해 항목을 수동으로 바꿨다면 변경 내용을 기록하고, 이후 갱신 과정에서 덮어쓰이는지 확인하세요. 기기에서 일시적으로 문제가 해결됐다고 원본 설정의 오류를 무시하면 안 됩니다. 한 번의 테스트 값을 유지하려고 필요한 설정 업데이트를 장기간 중단하지도 마세요.