Shadowrocket WireGuard 설정 방법: Private Key·Public Key·Endpoint·MTU 입력 가이드

Shadowrocket에서 WireGuard를 추가하는 방법과 키, 주소, Endpoint, DNS, MTU 항목의 의미를 설명합니다. 서비스 제공업체의 설정값을 각 입력란에 어떻게 옮기는지도 안내합니다.

이 글의 핵심 내용

이 글은 서비스 제공업체에서 WireGuard 설정을 받은 사용자를 대상으로 합니다. 먼저 클라이언트 키와 서버 키를 구분하고, Interface와 Peer의 주소·포트·DNS를 Shadowrocket 입력란에 대응합니다. 마지막으로 핸드셰이크, 라우팅, 도메인 조회, MTU 순서로 문제를 확인합니다. 예시 주소는 형식을 설명하기 위한 것으로, 실제 연결에 사용할 수 있는 설정값이 아닙니다.

1. 추가하기 전에 Interface와 Peer 구분하기

Shadowrocket에서 WireGuard를 연결하려면 서로 맞물리는 여러 설정값이 필요합니다. 서버 주소 하나만 입력해서 사용할 수 있는 방식이 아닙니다. 일반적인 WireGuard 설정 파일은 [Interface]와 [Peer] 두 구역으로 나뉩니다. 앞부분은 내 기기의 터널 인터페이스를, 뒷부분은 연결할 원격 기기를 설명합니다. 설정 파일을 받으면 먼저 두 구역을 구분하세요. Public Key라는 이름만 보고 아무 키 입력란에나 붙여 넣으면 안 됩니다.

이 글에서는 Home에서 WireGuard를 직접 추가하는 방법을 다룹니다. 서비스 제공업체가 Subscribe 링크를 제공했다면 해당 업체에서 링크를 받아 Home → + → Type → Subscribe를 통해 가져오세요. Subscribe 가져오기와 WireGuard 설정값 직접 입력은 서로 다른 설정 방법입니다. 구독 URL을 Endpoint에 입력하거나 설정 전체를 Private Key 입력란에 붙여 넣지 마세요.

2개 구역
Interface는 내 기기, Peer는 원격 기기를 설명합니다
32바이트
WireGuard 공개 키와 개인 키의 원시 길이
UDP
Endpoint에서 사용하는 전송 프로토콜

키는 일반적으로 Base64 문자열로 표시되며, 표준 인코딩에서 흔히 44자입니다. 길이는 복사 과정에서 잘린 부분이 있는지 확인하는 데만 쓸 수 있으며, 키가 올바른지 증명하지는 못합니다. WireGuard는 사용자 이름이나 비밀번호, TLS 인증서로 인증하지 않습니다. 서버에는 이 기기의 Private Key와 짝을 이루는 클라이언트 Public Key가 등록되어 있어야 합니다.

2. Private Key, Public Key, Preshared Key의 관계

Private Key는 이 기기의 비밀 식별 정보입니다. Peer 아래의 Public Key는 원격 기기를 식별하는 데 사용됩니다. 두 키는 모양이 비슷해도 서로 바꿔 쓸 수 없습니다. 서비스 제공업체 페이지에 ‘클라이언트 Public Key’가 별도로 표시된다면, 이는 서버에 등록할 이 기기의 공개 키입니다. 원격 Public Key 입력란에 넣을 값이 아닙니다.

설정 항목입력 방법자주 하는 실수
[Interface] PrivateKey클라이언트의 Private Key를 입력하고 Base64 문자를 빠짐없이 유지합니다.서버 Private Key를 붙여 넣거나 클라이언트 공개 키를 잘못 사용합니다.
[Peer] PublicKey서버의 Public Key를 입력합니다.서비스 제공업체 페이지의 클라이언트 Public Key를 잘못 입력합니다.
[Peer] PresharedKey서비스 제공업체가 제공하고 서버에서 활성화한 경우에만 추가 공유 키를 입력합니다.서버에 설정되지 않은 키를 임의로 만들거나, 필수 값을 빠뜨립니다.

키를 복사할 때 PrivateKey = 같은 항목 이름은 제외하세요. 따옴표, 줄바꿈, 끝부분의 공백도 포함하지 않아야 합니다. QR 코드나 가져온 파일을 사용하더라도 현재 기기에 해당하는 설정인지 확인하세요. 여러 기기에서 같은 클라이언트 식별 정보를 재사용하면 서버에 기록되는 Endpoint가 바뀌어 연결이 간헐적으로 끊길 수 있습니다.

3. Address, Endpoint, AllowedIPs의 차이

Address는 클라이언트에 할당된 터널 내부 주소이고, Endpoint는 클라이언트가 공용 네트워크나 현재 네트워크에서 실제로 연결하는 원격 주소입니다. 두 항목이 나타내는 내용은 다릅니다. Address는 ‘터널 안에서 내 기기가 사용할 주소’, Endpoint는 ‘암호화된 UDP 패킷을 보낼 곳’을 뜻합니다. Endpoint의 공인 IP를 내 기기의 Address에 입력하지 마세요.

항목형식 예시입력 기준
Address10.66.0.2/32서비스 제공업체가 이 클라이언트에 할당한 주소와 프리픽스를 사용하세요. 직접 선택하지 마세요.
Endpointvpn.example.com:51820서버 호스트 이름 또는 IP와 실제로 수신 대기 중인 UDP 포트를 입력합니다.
IPv6 Endpoint[2001:db8::10]:51820하나의 Endpoint 문자열에 IPv6 주소를 넣을 때는 대괄호로 감쌉니다.
AllowedIPs0.0.0.0/0, ::/0이 Peer에 해당하는 IPv4 및 IPv6 주소 범위를 나타냅니다. 앱별 트래픽 분할 설정이 완료되었다는 뜻은 아닙니다.

포트 51820은 흔히 쓰이는 예시일 뿐, 고정된 값이 아닙니다. 서비스 제공업체가 다른 포트를 안내했다면 그대로 입력하세요. 어떤 네트워크에서 TCP 443을 사용할 수 있다고 해서 UDP 443도 반드시 연결된다고 볼 수는 없습니다. 편집 화면에서 주소와 포트 입력란이 분리되어 있다면 호스트 이름과 숫자 포트를 각각 입력하고, 주소 입력란에 :51820을 함께 넣지 마세요.

AllowedIPs는 WireGuard에서 Peer를 선택하고 수신 가능한 출발지 주소를 제한하는 데 관여합니다. 반면 Shadowrocket의 Global Routing과 Config는 어떤 요청을 선택한 프록시로 보낼지 결정합니다. 두 계층을 혼동하지 마세요. 설정에 0.0.0.0/0이 있다고 해서 Shadowrocket의 모든 요청이 규칙 선택을 거치지 않고 이 연결로 전송되는 것은 아닙니다.

4. Home에서 연결을 추가하고 확인하기

입력을 시작하기 전에 서비스 제공업체에서 받은 원본 설정을 따로 보관하세요. 아래 경로는 영문 인터페이스 항목명을 기준으로 설명합니다. 플랫폼에 따라 입력란의 배열이 다를 수 있으며, 표준 설정 파일의 모든 항목이 같은 이름의 입력란으로 제공되는 것은 아닙니다. 항목이 보이지 않으면 해당 플랫폼에서 실제로 가져올 수 있는 설정인지 확인하고, 관련 없는 입력란에 넣지 마세요.

  1. 유형 선택

    Home → + → Type → WireGuard로 이동해 Subscribe나 다른 프로토콜이 아닌 WireGuard를 편집하고 있는지 확인합니다.

  2. 키 입력

    Interface의 PrivateKey와 Peer의 PublicKey에 맞춰 각 키를 입력합니다. 서비스 제공업체가 Preshared Key를 요구하면 함께 입력합니다.

  3. 주소 입력

    Endpoint의 호스트와 포트를 서버 주소 및 포트 입력란에 각각 넣고, 서비스 제공업체가 할당한 이 기기의 터널 주소도 입력합니다. DNS와 MTU는 원본 설정에 따릅니다.

  4. 저장 후 선택

    저장한 다음 Home으로 돌아와 방금 추가한 연결을 선택합니다. Home → Global Routing에서 현재 설정을 확인해 테스트 요청이 이 연결을 사용하도록 합니다.

  5. 요청 보내기

    연결 스위치를 켜고 시스템 안내에 따라 필요한 네트워크 설정을 허용합니다. 연결이 확인된 대상을 방문하고, 스위치가 켜졌는지만 보지 말고 연결 로그와 송수신 트래픽도 확인하세요.

문제 해결 중에는 Config 규칙의 영향을 줄이기 위해 Global Routing → Proxy를 잠시 사용할 수 있습니다. 그렇더라도 시스템의 모든 유형의 트래픽이 반드시 이 연결을 통과하는 것은 아닙니다. 확인이 끝나면 평소 사용하는 Config로 되돌리고 실제로 활성화된 설정을 확인하세요. Direct는 선택한 프록시를 통해 요청을 전달하지 않으므로 WireGuard 출구를 확인하는 데 사용할 수 없습니다. Scene은 설정된 장면 조건에 따라 확인해야 하며, 고정된 전역 프록시 상태로 간주하면 안 됩니다.

5. DNS, MTU, PersistentKeepalive 설정

DNS는 도메인 조회를 어느 리졸버에 맡길지 정하고, MTU는 터널 인터페이스가 전달할 수 있는 패킷 크기를 제한하며, PersistentKeepalive는 일부 NAT 매핑을 유지하는 데 쓰입니다. 서로 대체할 수 없는 항목입니다. DNS를 바꿔도 잘못된 Public Key는 해결되지 않고, MTU를 낮춰도 도달할 수 없는 UDP Endpoint가 응답하지는 않습니다.

DNS: 조회 경로부터 확인

표준 WireGuard 설정의 DNS는 흔히 사용하는 클라이언트 확장 항목이지 WireGuard 핸드셰이크 프로토콜 자체의 필드는 아닙니다. 가져온 뒤에는 현재 Shadowrocket의 Config와 DNS 설정에서 실제로 어떻게 적용되는지 확인하세요. 설정 파일에 있는 DNS가 모든 조회에 적용된다고 단정해서는 안 됩니다. 터널 내부 DNS 주소가 지정되어 있다면 일반적으로 터널을 연결한 뒤에야 접근할 수 있습니다.

MTU: 기존 값을 유지한 뒤 한 번에 한 가지만 테스트

서비스 제공업체 설정 또는 기본값 유지

권장

서비스 제공업체가 MTU 값을 안내했다면 우선 그대로 입력합니다. 안내가 없다면 클라이언트 기본 동작을 사용해 재현 가능한 테스트 기준을 마련하세요.

적합한 경우: 처음 추가할 때, 연결 후 웹페이지와 다운로드가 모두 정상일 때

MTU 수동으로 낮추기

작은 요청은 되지만 큰 요청이 멈추는 현상이 반복해서 재현될 때만 점진적으로 낮추세요. 예를 들어 1420에서 1380으로 시험하되, 한 번에 한 항목만 변경합니다.

적합한 경우: 경로 MTU 또는 캡슐화 오버헤드 문제를 집중적으로 확인할 때

결론: 현상을 기록한 뒤 변경값 유지 여부 결정

같은 네트워크와 같은 대상을 사용해 변경 전후의 접속 결과와 전송 중단 여부를 비교하세요. MTU를 낮춰도 개선되지 않으면 원래 값으로 되돌리고, 1380이나 1420을 모든 네트워크에 통용되는 값으로 여기지 마세요.

적절한 MTU 값은 기본 경로와 추가 캡슐화에 따라 달라집니다. 무작정 낮추면 패킷 수가 늘어날 수 있습니다. 핸드셰이크조차 성립하지 않았다면 MTU를 반복해서 바꾸기보다 키와 Endpoint부터 확인하세요.

PersistentKeepalive: 유휴 상태 이후 연결 가능성 확인

PersistentKeepalive = 25는 25초 간격으로 연결 유지 패킷을 보내는 설정으로, 일반적인 NAT 환경에서 볼 수 있는 예시이지 필수 값이나 성능 조정값은 아닙니다. 표준 WireGuard 설정에서 0은 주기적인 연결 유지를 끈다는 뜻입니다. 서비스 제공업체가 이 항목을 안내하고 현재 클라이언트 입력 화면에서 설정할 수 있다면 안내에 따르세요. 입력란이 없다면 포트나 MTU 같은 다른 항목으로 대신하지 마세요.

6. 연결 스위치가 핸드셰이크 결과는 아닙니다

WireGuard는 보낼 데이터가 있을 때 유효한 핸드셰이크가 시작되는 경우가 많습니다. Shadowrocket의 연결 스위치를 켜면 우선 로컬 연결 절차가 시작된다는 뜻입니다. 원격 기기 인증, DNS, 대상 서비스 접속까지 모두 정상이라는 의미는 아닙니다. 직접 요청을 보내고 확인할 수 있는 로그를 함께 살펴보세요. 서비스 제공업체가 서버 측 핸드셰이크 기록을 제공한다면 같은 시각에 해당 클라이언트의 데이터가 수신되었는지도 확인할 수 있습니다.

증상우선 확인할 항목다음 조치
요청을 보냈지만 유효한 응답이 없음키 대응 관계, Endpoint, UDP 연결 가능 여부서버 Public Key, 클라이언트 공개 키 등록 여부, 수신 대기 포트를 확인한 뒤 다른 네트워크에서도 테스트합니다.
핸드셰이크 기록은 있지만 서비스가 작동하지 않음Address, AllowedIPs, 서버 측 전달 설정할당된 주소와 반환 경로를 확인하고 요청이 실제로 이 연결을 선택하는지 점검합니다.
일부 도메인에 접속할 수 없음DNS 및 Config 규칙조회 결과와 규칙 매칭을 비교해 요청이 Direct나 다른 정책으로 전달되지 않는지 확인합니다.
작은 요청은 되지만 큰 데이터 전송이 멈춤경로 MTU, 패킷 손실, 대상 상태대상을 고정하고 MTU를 하나씩 테스트합니다. 비교 기록을 남기고 DNS는 동시에 변경하지 마세요.
네트워크 전환 후 잠시 연결이 끊김새 네트워크의 UDP, Endpoint 조회, On DemandWi-Fi와 셀룰러 네트워크에서 각각 수동으로 테스트해 네트워크 제한과 자동 연결 조건을 구분합니다.

Config를 다시 확인할 때는 먼저 현재 활성화된 파일을 확인하고 Rule의 순서를 살펴보세요. DOMAIN-SUFFIX는 도메인 접미사를, IP-CIDR은 주소 범위를, GEOIP는 IP 주소의 지리 정보를 기준으로 매칭합니다. FINAL은 앞선 규칙에 매칭되지 않은 요청을 처리합니다. 규칙에 매칭되면 해당 정책이 적용됩니다. 규칙이 요청을 Direct로 보내는 경우, WireGuard 키를 바꿔도 해당 요청의 출구는 바뀌지 않습니다.

7. 설정 저장 및 이후 사용

처음 확인을 마치면 원본 설정을 안전한 곳에 보관하고, 사용 중인 Global Routing 상태와 유효한 MTU 값을 기록해 두세요. 이후 네트워크를 바꾸거나 구독을 업데이트하거나 Config를 조정한 뒤 문제가 생기면, 설정값을 무작위로 다시 입력하는 대신 확인된 조건으로 돌아가 재시험할 수 있습니다. 서비스 제공업체가 서버 Public Key나 할당 주소를 변경한 경우에도 관련 항목을 함께 확인하세요.

Shadowrocket 다운로드 및 첫 설정

iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제이며, Mac(Apple 실리콘 및 Intel) / Windows / Android / Linux 버전은 무료입니다. 앱 구매와 연결 서비스 요금제는 별개입니다. 구독은 이용 중인 서비스 제공업체에서 받으세요.

Shadowrocket 다운로드