이 글은 WireGuard 서비스 설정값을 보유하고 있으며 Shadowrocket에 입력하거나 설정을 확인하려는 사용자를 위한 안내입니다. 먼저 클라이언트 PrivateKey와 서버 PublicKey를 구분한 다음 Endpoint, 터널 Address, DNS를 확인하고, 라우팅 비교와 MTU 단일 변수 테스트로 문제를 좁혀 갑니다. 구독 링크와 연결 설정값은 이용 중인 서비스 제공업체에서 받으세요. 기기나 Peer가 다른 설정값을 섞어 쓰지 마세요.
WireGuard 설정값 확인 및 입력 순서
Shadowrocket의 WireGuard 연결에는 서로 짝이 맞는 설정값이 필요합니다. 주소와 포트만 입력해서는 연결할 수 없습니다. 일반적인 원본 설정에서는 [Interface]에 내 기기의 신원과 터널 주소를, [Peer]에 원격 기기의 신원과 연결 대상을 적습니다. 두 섹션이 보이면 먼저 각 항목이 어느 쪽에 속하는지 확인한 뒤 Shadowrocket의 입력란에 맞춰 넣으세요.
이 안내는 사용자가 직접 서비스 제공업체와 구독을 이용하고 있다는 전제에서 작성했습니다. Subscribe 업데이트는 제공업체가 배포한 설정을 가져오는 기능이며, 잘못된 키를 자동으로 고쳐 주지는 않습니다. 일반 구독에 WireGuard 항목이 포함되는지는 제공업체가 실제로 제공하는 형식에 따라 다릅니다. 구독에서 생성된 항목을 직접 수정하기 전에 다음 업데이트 때 변경 사항이 덮어써지는지 확인하세요.
-
설정값 출처 확인
서비스 제공업체에서 동일한 WireGuard 설정을 받아
[Interface]와[Peer]를 구분하세요. PresharedKey, IPv6 Address, 지정 DNS가 있는지도 확인하되 전체 설정을 공개하지 마세요. -
유형 선택
Home → 오른쪽 위 “+” → Type → WireGuard로 이동합니다. 기존 항목을 수정하려면 Home에서 해당 항목의 편집 화면을 여세요. 현재 사용 중인 다른 연결을 잘못 수정하지 않도록 주의하세요.
-
인증 정보 입력
먼저 클라이언트 PrivateKey와 클라이언트 Address, 서버 PublicKey를 입력합니다. 원본 설정에 PresharedKey가 있다면 해당 키도 정확히 입력해야 합니다. PublicKey를 대신 넣으면 안 됩니다.
-
연결 대상 입력
Endpoint에 표시된 서버 주소와 포트를 확인한 뒤, 서비스 제공업체가 지정한 DNS와 MTU를 입력합니다. 주소와 포트 입력란이 따로 있으면 각각 나눠 입력하세요.
-
별도로 연결 테스트
저장한 다음 Home에서 해당 항목을 선택하고 Global Routing → Proxy를 임시로 설정해 실제 웹 요청을 테스트합니다. 테스트 중에는 Settings → On Demand의 자동 연결 조건이 영향을 주지 않도록 주의하세요. 테스트가 끝나면 원래 설정으로 되돌리세요.
PrivateKey와 PublicKey: 클라이언트와 서버 구분하기
PrivateKey는 내 기기의 비밀 키이고, PublicKey는 상대방에게 전달해 등록할 수 있는 공개 키입니다. 클라이언트 PrivateKey에서 클라이언트 PublicKey를 계산할 수는 있지만, PublicKey로 PrivateKey를 알아낼 수는 없습니다. Shadowrocket 연결 항목의 원격 PublicKey에는 서버의 키를 입력해야 합니다. 클라이언트 PrivateKey에서 계산한 공개 키를 넣으면 안 됩니다.
| 항목 및 소유 주체 | 입력할 값 | 자주 하는 실수 |
|---|---|---|
[Interface] PrivateKey | 현재 클라이언트에 할당된 PrivateKey | 서버 PublicKey를 입력하거나 복사할 때 공백까지 포함 |
[Peer] PublicKey | 원격 서버의 PublicKey | 클라이언트 자신의 PublicKey를 입력 |
[Peer] PresharedKey | 양쪽에서 합의한 추가 PresharedKey. 원본 설정에 지정된 경우에만 입력 | 한쪽에만 설정하거나 다른 키를 잘못 사용 |
WireGuard의 PrivateKey와 PublicKey는 모두 32바이트 원시 키를 Base64로 표현한 값입니다. 일반적으로 끝에 =가 붙은 44자입니다. 길이는 심하게 잘린 키를 찾아내는 데 참고할 수 있지만, 키가 올바른지 확인해 주지는 않습니다. 복사할 때 대소문자와 +, /, =를 그대로 유지하세요. 설정 행 앞부분의 PrivateKey =까지 키 입력란에 붙여 넣지 마세요.
PrivateKey를 바꾸면 상대편 설정도 업데이트해야 합니다내 기기에서 PrivateKey만 새로 만들면 클라이언트 PublicKey도 함께 바뀝니다. 서버에 이전 공개 키가 등록된 상태라면 새 신원으로 인증할 수 없습니다. 키를 바꿔야 할 때는 서비스 제공업체의 기기 초기화 절차에 따라 등록 정보도 함께 갱신하세요. 키를 계속 새로 만들어 가며 시험하지 마세요. PrivateKey, PresharedKey, 전체 구독 링크는 민감한 정보로 취급해야 합니다.
Endpoint와 Address: 공용 접속 주소와 터널 주소 구분하기
Endpoint는 클라이언트가 처음 접속하는 원격 UDP 주소로, 호스트와 포트를 포함합니다. Address는 터널에 들어간 뒤 클라이언트가 사용하는 내부 주소이며 보통 CIDR 접두사를 포함합니다. 두 항목의 역할은 다릅니다. 서버 도메인을 Address에 넣거나 클라이언트 터널 IP를 공용 Endpoint 대신 입력하면 안 됩니다.
아래 예시는 항목 형식만 보여 주며, 가져오거나 연결할 수 있는 설정이 아닙니다. example.com은 예시 도메인이고 문서용 주소 2001:db8::10은 실제 서비스 주소가 아닙니다. 실제 주소와 포트, 접두사는 현재 클라이언트에 할당된 값으로 입력해야 합니다.
Endpoint = example.com:51820
Address = 10.66.66.2/32
IPv6 Endpoint 형식:
[2001:db8::10]:51820
- Endpoint를 한 칸에 입력하는 경우: 도메인 또는 IPv4 주소 뒤에 콜론과 포트를 입력합니다. IPv6 주소는 포트와 구분할 수 있도록 대괄호로 묶어야 합니다.
- 주소와 포트를 따로 입력하는 경우: 서버 주소란에는
https://, 경로 또는 포트를 넣지 마세요. 포트란에는 서비스 제공업체에서 받은 숫자만 입력하세요. - Address 접두사:
/32는 IPv4 주소 하나,/128은 IPv6 주소 하나를 뜻합니다. 실제 접두사는 원본 설정 그대로 유지하고, “범위를 넓히기” 위해 임의로 바꾸지 마세요. - 기기별 설정: 같은 클라이언트 신원으로 여러 기기에서 동시에 연결하면 서버에 기록되는 통신 Endpoint가 서로 바뀔 수 있습니다. 여러 기기에서 동시에 사용하려면 기기마다 별도의 설정을 받으세요.
Address가 잘못되어도 외부 인증은 성공할 수 있지만, 터널 안에서 사용하는 출발지 주소가 서버에 등록된 해당 Peer의 허용 범위와 맞지 않아 요청을 보내도 유효한 응답을 받지 못할 수 있습니다. 이는 Endpoint에 연결할 수 없는 경우와 다른 문제입니다. Home의 연결 스위치만 보고 어느 단계에서 문제가 생겼는지 판단할 수는 없습니다.
DNS와 AllowedIPs: 이름 확인, 터널 라우팅, 규칙 확인
DNS는 도메인을 IP 주소로 변환하며 키 인증 문제를 해결하지는 않습니다. Endpoint에 도메인을 입력했다면 서버에 처음 접속하기 전에 해당 도메인을 조회할 수 있어야 합니다. 설정된 DNS가 터널 연결 후에만 접근 가능하다면 연결을 시작할 때 도메인을 어떻게 확인하는지, 의존성이 생기지 않는지 점검하세요. 서비스 제공업체가 DNS 조회 기능도 제공한다고 명시한 경우가 아니라면 Endpoint 서버 주소를 DNS로 입력하지 마세요.
AllowedIPs는 WireGuard Peer에서 사용하는 주소 범위이지 도메인 규칙이나 클라이언트 Address가 아닙니다. 터널 내부의 라우팅과 상대편 주소 허용 범위에 관여합니다. 반면 Shadowrocket의 Global Routing과 Config는 앱의 요청에 적용할 정책을 결정합니다. 두 설정이 모두 맞아야 하므로 한쪽만 확인해서는 안 됩니다.
| 설정 | 의미 | 확인 방법 |
|---|---|---|
Address = 10.66.66.2/32 | 이 예시에서 터널 안에 사용하는 클라이언트 주소 | 서버에 해당 클라이언트용으로 등록된 주소와 일치해야 합니다 |
AllowedIPs = 0.0.0.0/0 | Peer의 IPv4 범위가 모든 IPv4 주소를 포함 | 이것만으로 IPv6까지 포함한다고 볼 수는 없습니다 |
AllowedIPs = ::/0 | Peer의 IPv6 범위가 모든 IPv6 주소를 포함 | 서버와 터널 주소도 해당 기능을 지원해야 합니다 |
DOMAIN-SUFFIX,example.com,PROXY | Config에서 도메인 접미사에 따라 PROXY 정책을 선택 | 요청에 실제로 Config 규칙이 적용될 때만 매칭됩니다 |
원본 설정에 AllowedIPs가 있다면 그 의미를 유지하고, 현재 가져오기 방식이 해당 설정을 반영하는지 확인하세요. Address란에 붙여 넣으면 안 됩니다. 편집 화면에 해당 입력란이 없다면 항목을 임의로 대응시키지 말고, 가져오기 형식이 지원하는 범위를 확인하세요. DNS는 현재 Config의 DNS 설정에도 영향을 받을 수 있습니다. 항목에 DNS를 입력했다고 해서 모든 시스템 DNS 요청이 반드시 해당 DNS를 사용하는 것은 아닙니다.
- 도메인 조회가 시간 초과되지만 터널 안의 알려진 주소에는 접속할 수 있음: DNS 주소에 접근할 수 있는지, 터널을 통해야만 접근 가능한지, 현재 Config의 DNS 설정은 어떤지 먼저 확인하세요.
- IPv6 대상에만 접속할 수 없음: PrivateKey를 먼저 바꾸지 말고 Address, Peer의 주소 범위, 서버의 IPv6 외부 연결을 확인하세요.
- 특정 도메인만 예상한 연결을 사용하지 않음: Config의 규칙 순서와 최종 정책을 확인하고, DNS 조회 실패와 정책 선택 오류를 구분하세요.
Global Routing 비교: 먼저 연결을 확인한 뒤 규칙 복원하기
WireGuard 항목을 확인한 다음에는 테스트 요청이 실제로 해당 항목을 통과하는지 확인해야 합니다. Home → Global Routing의 Proxy, Direct, Config는 각각 다른 방식으로 트래픽을 처리합니다. Scene은 상황별로 미리 설정한 동작을 적용하는 기능이지, 네 번째 WireGuard 암호화 방식이 아닙니다. 테스트 전 원래 설정을 기록하고 끝난 뒤 복원해 임시 설정을 장기 설정으로 오해하지 않도록 하세요.
Config
권장현재 Config의 규칙과 정책에 따라 요청을 처리합니다. DOMAIN-SUFFIX, IP-CIDR, GEOIP 등의 규칙이 매칭 결과에 영향을 주고, FINAL은 앞서 매칭되지 않은 요청에 적용됩니다. 최종 연결 방식은 규칙 작성에 따라 달라지므로 나머지 요청이 모두 직접 연결된다고 단정할 수 없습니다.
적합한 경우: 연결 테스트를 마친 뒤 평소처럼 규칙에 따라 트래픽을 나누어 처리할 때.
Proxy
Shadowrocket이 처리하는 요청을 프록시 방식으로 보내 Config의 분기 규칙이 테스트에 미치는 영향을 줄입니다. 먼저 테스트할 WireGuard 항목을 선택한 다음 같은 대상에 다시 접속해 결과를 확인하세요. DNS는 별도로 확인해야 합니다.
적합한 경우: WireGuard 데이터 경로가 작동하는지 임시로 확인할 때.
Direct
직접 연결 방식으로 처리하며 일반 요청을 선택한 WireGuard 항목으로 보내지 않습니다. 이 상태에서 웹페이지가 열린다면 로컬 네트워크가 정상인지 비교하는 데만 활용할 수 있습니다. WireGuard가 정상적으로 통신하고 있다는 증거는 아닙니다.
적합한 경우: 로컬 네트워크의 정상 여부를 비교하고 터널 문제를 분리할 때.
Proxy에서는 연결되지만 Config에서 실패한다면 먼저 적용된 규칙과 정책 대상을 확인하세요. 바로 키를 다시 만들 필요는 없습니다. 둘 다 실패하면 Endpoint, 키, Address를 다시 확인하세요. 지연 시간 테스트 결과는 해당 테스트 방식으로 얻은 응답만 나타내며 실제 서비스 요청을 대신하지 않습니다. 마찬가지로 시스템에서 연결이 활성화된 것으로 표시되어도 원격 인증에 성공했다는 뜻은 아닙니다.
MTU 입력 방법: 특정 증상이 있을 때 단계별로 테스트하기
MTU는 터널 안에서 전송할 수 있는 데이터 패킷의 최대 크기를 제한합니다. WireGuard 바깥에는 IP, UDP, 암호화 캡슐화에 필요한 데이터가 추가되므로 터널에서 사용할 수 있는 크기는 일반적으로 하위 링크의 MTU보다 작습니다. 서비스 제공업체가 값을 지정했다면 우선 원래 값을 사용하세요. 값이 없다면 앱의 기본 처리를 유지하고, 인터넷에서 본 숫자 하나를 모든 네트워크에 적용되는 기준으로 여기지 마세요.
MTU가 맞지 않을 때 나타나는 대표적인 증상은 작은 요청은 처리되지만 큰 응답이나 파일 전송, 일부 TLS 연결이 멈추는 것입니다. 패킷 손실이나 서버 문제도 같은 증상을 일으킬 수 있으므로 비교 테스트가 필요합니다. 통신이 전혀 되지 않는다면 MTU를 크게 낮추기 전에 키, Endpoint, UDP 연결 가능 여부부터 확인하세요.
- 기준값 기록: 현재 MTU, 네트워크 종류, 테스트 대상을 기록한 뒤 같은 Wi-Fi 또는 셀룰러 네트워크에서 같은 페이지와 큰 파일을 반복해서 열어 봅니다.
- 한 번에 한 값만 변경: 예를 들어 원래 설정이
1420이면 임시로1380을 테스트한 다음, 결과에 따라1280도 시험할 수 있습니다. 이 값들은 문제 진단을 위한 테스트값이지 서버가 요구하는 값이나 측정으로 확인된 결론이 아닙니다. - 다시 연결: 변경 사항을 저장하고 연결을 다시 설정해 새 값으로 테스트하세요. DNS, Endpoint, Global Routing을 동시에 바꾸지 마세요.
- 결과 비교: 값을 낮춘 뒤 큰 응답이 안정적으로 처리되고 작은 요청은 원래부터 정상이었다면 결과를 기록해 서비스 제공업체에 경로 문제를 문의하세요. 개선되지 않으면 원래 값으로 되돌리고 다른 항목을 확인하세요.
하위 연결이 IPv4인지 IPv6인지, 추가 터널이 있는지, 네트워크 경로에서 필요한 제어 패킷을 필터링하는지에 따라 결과가 달라집니다. 특히 터널에서 IPv6를 사용해야 한다면 MTU를 임의로 1280보다 낮게 설정하는 것은 적절하지 않습니다. MTU가 지나치게 작으면 패킷 분할과 처리 부담이 늘어납니다. “작을수록 안정적”이라고 생각해 계속 낮추지 마세요.
자주 묻는 질문: 증상에 맞는 항목 확인
연결 스위치는 켜졌는데 왜 접속이 안 되나요?
먼저 Home에서 테스트할 WireGuard 항목이 선택되어 있는지 확인한 뒤 Global Routing → Proxy로 실제 요청을 테스트하세요. Endpoint의 도메인과 UDP 포트, 클라이언트 PrivateKey, 서버 PublicKey를 차례로 확인합니다. 서비스 제공업체에 해당 클라이언트의 핸드셰이크가 수신되는지, 등록된 클라이언트 공개 키가 일치하는지 문의할 수도 있습니다.
PrivateKey 대신 PublicKey를 입력해도 되나요?
안 됩니다. Home에서 해당 항목의 편집 화면을 열고 원본 설정의 [Interface]와 [Peer]를 각각 확인해 입력하세요. PrivateKey를 잃어버렸다면 서비스 제공업체의 절차에 따라 클라이언트 신원을 초기화하고 새 공개 키를 등록해야 합니다. 기존 공개 키로 PrivateKey를 복구할 수는 없습니다.
휴대폰에서는 되는데 다른 기기를 함께 연결하면 끊기나요?
먼저 한 기기의 연결을 끊고 비교하세요. 각 기기에서 따로 연결하면 정상이지만 동시에 연결할 때 번갈아 끊긴다면 PrivateKey와 Address를 재사용하고 있는지 확인하세요. 기기별 설정은 서비스 제공업체에서 받아야 합니다. Address의 마지막 숫자만 바꿔 해결하려고 하지 마세요.
간단한 페이지는 열리지만 다운로드가 멈춘다면 무엇부터 바꿔야 하나요?
네트워크, 연결 항목, 테스트 파일을 고정하고 현재 MTU를 기록하세요. 원래 설정을 시작점으로 삼아 1420, 1380, 1280처럼 단계적으로 낮추며 한 번에 하나씩 비교 테스트합니다. 작은 요청도 실패한다면 기본 연결부터 확인하세요. 도메인에만 문제가 있다면 MTU가 아니라 DNS를 확인하세요.
서비스 제공업체에 문의할 때는 네트워크 종류, 오류 발생 시각, 사용한 Global Routing 방식, 그리고 “도메인 조회 실패”, “작은 응답은 성공하지만 큰 응답은 멈춤”처럼 재현 가능한 증상을 기록하세요. 민감한 항목을 가린 설정 화면을 보낼 수 있지만, 전체 PrivateKey, PresharedKey 또는 구독 링크는 보내지 마세요. Config와 Home의 기본 사용 방법은 사용 안내에서 확인할 수 있습니다.
Shadowrocket 다운로드 및 기본 사용법
iPhone / iPad 버전은 App Store에서 받을 수 있으며 $2.99 일회성 결제입니다. 개발자는 Shadow Launch Technology Limited이며, 시스템 요구 사항은 App Store 페이지에 표시된 내용을 확인하세요. Mac(Apple 실리콘 / Intel), Windows, Android, Linux 버전은 무료입니다. 앱 다운로드 비용과 서비스 제공업체의 연결 서비스 비용은 별도로 부과됩니다. 다운로드 페이지에서 플랫폼을 선택하거나 가져오기 및 연결 방법을 먼저 확인하세요.