Shadowrocket WireGuard 설정 방법: PrivateKey, PublicKey, AllowedIPs, MTU

Shadowrocket에서 WireGuard를 설정할 때 각 항목의 의미와 입력 출처를 설명합니다. 예시는 모두 가짜 값이며, 흔한 입력 오류의 해결 방법도 안내합니다.

이 글의 핵심

WireGuard를 설정할 때는 먼저 기기와 상대 Peer의 키, 터널 주소, 공인 Endpoint를 구분한 다음 라우팅 범위와 MTU를 확인해야 합니다. 서비스 제공업체의 설정 정보나 직접 관리하는 서버 정보를 이미 갖고 있는 사용자를 대상으로 합니다. 안내는 iPhone / iPad의 Shadowrocket을 기준으로 하며, Mac / Windows / Android / Linux에서는 각 항목의 의미를 참고해 해당 플랫폼의 편집 화면에서 확인하세요. 모바일 화면의 버튼 위치를 다른 플랫폼에 그대로 적용하면 안 됩니다. 이 글을 읽고 설정 출처를 항목별로 확인하고, 핸드셰이크·트래픽 분기·DNS·패킷 크기 문제를 구분할 수 있습니다.

1. 기기와 상대 Peer를 구분한 뒤 설정하기

WireGuard는 UDP로 통신하며 키를 사용해 양쪽을 식별합니다. 사용자 이름과 비밀번호로 로그인하는 방식이 아닙니다. 기기에는 자체 PrivateKey가 있고, 서버에는 이 키와 한 쌍을 이루는 기기의 PublicKey가 등록됩니다. 클라이언트의 Peer에는 서버의 PublicKey를 입력합니다. 양쪽 모두 PublicKey라는 이름을 사용하더라도 서로 바꿔 입력하면 안 됩니다.

항목 구분: 로컬 Interface와 원격 Peer

로컬 Interface
  • PrivateKey: 기기의 개인 키입니다. 이 키를 사용해야 하는 신뢰할 수 있는 기기에만 보관하세요.
  • Address: 기기에 할당된 터널 내부 주소입니다. 서버의 공인 주소가 아닙니다.
  • MTU: 터널 인터페이스에서 허용되는 패킷 크기의 상한입니다. 설정과 실제 네트워크 경로에 맞춰 조정하세요.
  • 로컬 PublicKey: 로컬 개인 키에서 파생되며, 서버에 등록할 때 사용합니다.
원격 Peer
  • PublicKey: 서버의 공개 키입니다. 서버 관리자에게 받으세요.
  • Endpoint: 서버에 접속할 수 있는 도메인 또는 IP 주소와 UDP 포트입니다.
  • AllowedIPs: 해당 Peer가 담당하는 IP 프리픽스 범위입니다.
  • PresharedKey: 양쪽에서 선택적으로 사용하는 추가 키입니다. 임의로 값을 만들어 입력하면 안 됩니다.

항목을 확인할 때마다 어느 쪽의 설정인지 확인하세요. 서버 설정 파일의 PrivateKey를 클라이언트의 개인 키로 사용하면 안 됩니다.

서비스 제공업체가 클라이언트 설정 전체를 제공했다면, 그 안에 포함된 키와 Address를 함께 사용하세요. 기기에서 새 키를 생성하려면 서버에 등록된 클라이언트 PublicKey도 함께 변경해야 합니다. 휴대폰의 PrivateKey만 바꾸면 기존 키 쌍이 맞지 않게 됩니다. 설정 전체의 스크린샷이나 개인 키를 공개 게시판에 올리지 마세요.

2. PrivateKey, PublicKey, 주소 항목 확인하기

아래에서는 WireGuard 설정 파일의 표준 항목명을 기준으로 설명합니다. 모든 플랫폼의 Shadowrocket 편집 화면에 같은 항목이 그대로 표시되는 것은 아닙니다. 편집 화면에 따라 Endpoint가 주소와 포트로 나뉘거나 로컬 IPv4와 IPv6를 따로 입력할 수 있습니다. 항목의 순서만 보고 그대로 복사하지 말고 의미에 맞게 입력하세요.

항목입력 출처와 의미흔한 오류
PrivateKey기기에서 생성한 뒤 서버에 등록한 개인 키 또는 서비스 제공업체가 할당한 클라이언트 개인 키입니다.서버 개인 키를 입력하거나 끝부분을 빠뜨리는 경우, 복사 과정에서 공백이나 줄바꿈이 섞이는 경우입니다.
PublicKeyPeer에는 서버 공개 키를 입력합니다. 클라이언트 공개 키는 서버 측에 별도로 등록합니다.클라이언트 자체의 공개 키를 원격 Peer에 입력하는 경우입니다.
PresharedKey선택 사항인 사전 공유 키입니다. 사용한다면 양쪽의 값이 완전히 일치해야 합니다.서버에서 사용하지 않는 키를 임의로 입력하거나 PrivateKey를 잘못 사용하는 경우입니다.
Address기기에 할당된 터널 주소와 프리픽스입니다. 예: 설명용 주소 192.0.2.2/32.서버 공인 IP를 입력하거나 다른 기기의 내부 주소를 그대로 재사용하는 경우입니다.
Endpoint서버 공인 주소와 실제 UDP 포트입니다. 예: example.com:51820.웹 프로토콜 접두사를 붙이거나 모든 서버 포트가 51820이라고 생각하는 경우입니다.
DNS설정에 이 항목이 포함되어 있다면, 함께 제공된 도구에서 사용하는 DNS 설정입니다. WireGuard 핸드셰이크 자체에 필요한 항목은 아닙니다.DNS 주소를 Address에 입력하거나, 이 항목만 바꾸면 앱의 DNS 설정이 모두 적용된다고 생각하는 경우입니다.

WireGuard의 PrivateKey, PublicKey, PresharedKey는 보통 32바이트 데이터를 Base64로 표현하며, 텍스트 길이는 대개 44자입니다. 하지만 길이가 맞는다고 키가 올바르거나 양쪽이 연결된 것은 아닙니다. 길이를 맞추려고 문자를 덧붙이지 말고 원본을 한 글자씩 대조하세요.

32바이트
WireGuard 키의 원본 데이터 길이
51820
이 글의 예시는 UDP 포트이며, 고정 필수값이 아닙니다
2개 프리픽스
IPv4와 IPv6의 기본 범위는 각각 확인해야 합니다

3. Home에서 WireGuard를 추가하고 처음 연결 확인하기

편집을 시작하기 전에 로컬 PrivateKey, 할당된 주소, 원격 PublicKey, Endpoint와 서비스 제공업체가 요구한 나머지 항목을 준비하세요. Home은 연결 항목을 관리하고 Config는 규칙 설정 파일을 관리합니다. 규칙 파일을 Config에 가져오는 것만으로 WireGuard 연결 항목이 만들어지거나 사용할 수 있게 되는 것은 아닙니다.

  1. 설정 정보 정리

    원본 설정을 안전한 곳에 보관하고 로컬 항목과 원격 항목을 구분해 표시하세요. 기존 Global Routing 상태를 기록하고, 이미 사용할 수 있는 연결 항목이 있다면 덮어쓰지 말고 그대로 두세요.

  2. 유형 선택

    Home → 오른쪽 위 “+” → Type → WireGuard를 엽니다. 아래 설명에 따라 각 항목을 입력하세요. 편집할 수 있는 항목은 플랫폼과 화면 구성에 따라 다를 수 있으므로 실제 표시 내용을 기준으로 합니다.

  3. 항목 입력

    Endpoint를 서버 주소와 포트에 맞춰 입력하고, 로컬 PrivateKey와 로컬 주소, 원격 PublicKey를 각각 해당 항목에 입력하세요. 원본 설정에 PresharedKey가 있을 때만 입력합니다.

  4. 저장하고 선택

    저장한 뒤 Home으로 돌아가 새로 만든 WireGuard 항목을 선택합니다. 규칙의 영향을 줄이려면 잠시 Home → Global Routing을 Proxy로 설정한 뒤 연결을 켜세요. 시스템에서 VPN 구성을 추가하라는 메시지가 표시되면 안내에 따라 확인합니다.

  5. 단계별로 확인

    먼저 정상 작동이 확인된 대상에 접속한 다음 데이터 송수신이 지속되는지 살펴보세요. 서버 관리 권한이 있다면 최근 핸드셰이크와 송수신 카운터도 확인합니다. 확인을 마치면 Global Routing을 평소 사용하는 설정으로 되돌리세요.

4. AllowedIPs와 Global Routing은 서로 다른 계층의 규칙입니다

AllowedIPs는 WireGuard의 IP 프리픽스 목록입니다. 송신 시에는 대상 주소를 Peer에 연결하고, 수신 시에는 복호화된 패킷의 출발지 주소가 해당 Peer에 속하는지 확인합니다. 도메인 규칙은 사용할 수 없으므로 DOMAIN-SUFFIX,example.com,PROXY를 입력하면 안 됩니다.

Shadowrocket의 Global Routing은 앱의 트래픽 분기 계층에서 트래픽을 처리하는 방식을 결정합니다. WireGuard의 AllowedIPs가 모든 주소를 포함하더라도 Global Routing에서 직접 연결로 지정한 트래픽이 해당 연결 항목을 자동으로 통과하지는 않습니다. 반대로 Proxy를 선택해도 서버에 전달 경로가 없으면 문제가 해결되지 않습니다.

Config: 설정에 따라 확인

권장

현재 Config의 규칙과 정책에 따라 트래픽을 처리합니다. DOMAIN-SUFFIX, GEOIP, IP-CIDR, FINAL의 순서와 대상 정책을 확인하고 필요한 요청이 WireGuard 항목 또는 해당 항목을 포함하는 정책 그룹으로 전달되는지 확인하세요.

적합한 경우: 연결 확인을 마친 뒤 규칙에 따라 일상적으로 트래픽을 분기할 때

Proxy: 분기 변수를 줄여 확인

전역 라우팅 계층에서 프록시 경로를 선택해 Config 규칙에 따른 차이를 배제합니다. 그래도 현재 선택한 연결 항목, 터널 범위, 서버 접속 가능 여부를 확인해야 합니다. 모든 시스템 트래픽이 반드시 원격으로 전송된다는 뜻은 아닙니다.

적합한 경우: 규칙에 따른 트래픽 분기가 문제의 원인인지 잠시 확인할 때

Direct: 직접 연결과 비교

전역 라우팅 계층에서 직접 연결 경로를 선택합니다. 같은 대상에 로컬 네트워크로 접속할 수 있는지 비교하는 데 사용할 수 있지만, 직접 연결이 성공해도 WireGuard 설정이 올바르다는 뜻은 아닙니다.

적합한 경우: 대상 자체에 접속할 수 없는 문제와 터널 경로 문제를 구분할 때

현재 Scene을 사용하고 있다면 비교 테스트 전에 해당 Scene이 실제로 어떤 라우팅 동작을 사용하는지 확인하세요. Settings → On Demand에서는 필요 시 연결 조건을 관리합니다. 이는 AllowedIPs가 아니며 특정 도메인을 프록시 규칙으로 지정하는 기능도 아닙니다. 수동 테스트 중에는 자동 연결 조건이 영향을 주지 않도록 상태를 기록해 두세요.

5. MTU와 Keepalive: 현상에 맞춰 조정하기

MTU는 터널 인터페이스가 전달할 수 있는 IP 패킷 크기를 제한합니다. 외부 네트워크에서는 WireGuard, UDP, IP 헤더도 함께 전달해야 하므로 터널 MTU를 물리 인터페이스의 값과 단순히 똑같이 설정할 수 없습니다. 1420은 흔히 사용하는 시작값이지만 외부 IPv4 / IPv6, 모바일 네트워크, 추가 캡슐화에 따라 실제로 사용할 수 있는 크기가 달라집니다.

관찰된 현상우선 확인할 항목조정 방법
핸드셰이크가 전혀 되지 않음Endpoint, UDP 허용 여부, 키 쌍, PresharedKey먼저 키와 접속 가능 여부를 확인하세요. MTU는 보통 우선 점검 항목이 아닙니다.
작은 요청은 성공하지만 큰 페이지나 업로드가 멈춤경로 MTU, 패킷 손실, 서버의 트래픽 전달기존 값을 기록한 뒤 편집 화면에서 지원한다면 1420에서 1380으로 낮춰 같은 대상을 다시 테스트하세요.
유휴 상태가 지난 뒤 접속이 느리게 복구됨NAT 매핑 만료, 네트워크 전환, 서버 상태양쪽 설정이 허용한다면 키를 계속 새로 만들기보다 PersistentKeepalive 사용을 검토하세요.
도메인으로만 접속되지 않음DNS 서버 접속 가능 여부, 조회 결과, DNS 경로DNS 조회 실패와 연결 실패를 구분하고, 먼저 MTU나 PublicKey를 변경하지 마세요.

PersistentKeepalive = 25는 필요한 경우 25초 간격으로 연결 유지 패킷을 보낸다는 뜻입니다. NAT 뒤에 있는 클라이언트에서 흔히 사용하는 설정이지만 모든 연결에 반드시 필요한 것은 아닙니다. NAT 매핑을 유지하는 데 도움이 될 수 있으나 백그라운드 네트워크 사용량이 늘고, 포트 차단이나 잘못된 키 문제는 해결하지 못합니다.

한 번에 변수 하나만 바꾸고 네트워크 유형, 기존 값, 변경 값, 재현 방법을 기록하세요. MTU를 낮춰도 안정적으로 개선되지 않으면 원래 값으로 되돌린 뒤 다른 항목을 확인하세요. 웹페이지가 한 번 열렸다는 이유만으로 일반적인 해결책이라고 판단하지 마세요.

6. 예시 설정 읽는 법과 자주 묻는 질문

아래는 항목의 위치를 설명하기 위한 표준 WireGuard 형식의 텍스트입니다. 모든 플랫폼의 Shadowrocket에서 가져오기를 지원한다고 보장하는 것은 아닙니다. 모든 값은 설명용 가짜 값이며, 키는 의도적으로 유효하지 않은 텍스트를 사용했습니다. 도메인과 문서용 주소도 실제 서비스에 연결되지 않습니다. 이 설정으로 연결을 만들 수 없으며 그대로 저장해 사용할 수도 없습니다.

[Interface]
PrivateKey = DEMO_PRIVATE_KEY_NOT_VALID
Address = 192.0.2.2/32
MTU = 1420

[Peer]
PublicKey = DEMO_SERVER_PUBLIC_KEY_NOT_VALID
PresharedKey = DEMO_PRESHARED_KEY_NOT_VALID
Endpoint = example.com:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

실제 설정에서는 본인의 원본 정보를 항목별로 대조하세요. 서비스 제공업체가 PresharedKey를 제공하지 않았다면 예시 행을 그대로 입력하지 마세요. IPv6 주소를 할당받지 않았거나 IPv6 전달 기능이 제공되지 않는다면 예시에 ::/0이 있다는 이유만으로 활성화하지 마세요. MTU와 Keepalive 값도 실제 네트워크에서 확인해야 합니다.

PublicKey를 정확히 복사했는데도 핸드셰이크가 되지 않는 이유는 무엇인가요?

먼저 입력한 키가 서버의 공개 키인지 확인한 다음, 서버 관리자에게 해당 Peer에 현재 클라이언트 공개 키가 등록되어 있는지 확인해 달라고 요청하세요. 이어서 Endpoint의 실제 UDP 포트와 PresharedKey를 확인합니다. 형식이 올바르다는 사실만으로 입력 형식 오류를 배제할 수 있을 뿐, 양쪽 설정이 일치한다고 증명되지는 않습니다.

핸드셰이크는 되지만 웹페이지가 열리지 않을 때는 무엇을 확인해야 하나요?

먼저 Home에서 선택된 WireGuard 항목을 확인하고 Global Routing → Proxy로 잠시 비교 테스트를 하세요. 그래도 실패하면 서버의 IP 전달, 외부 경로, 방화벽을 확인합니다. 도메인만 접속되지 않을 때는 DNS를 확인하고, 큰 요청에서만 문제가 생길 때 MTU를 점검하세요.

휴대폰과 컴퓨터에서 같은 설정을 그대로 복사해 사용할 수 있나요?

먼저 서비스 제공업체가 기기별로 별도의 Peer를 할당하는지 확인하세요. 여러 기기에서 같은 개인 키와 터널 주소를 동시에 사용하면 원격 Endpoint가 계속 바뀔 수 있습니다. 여러 기기를 함께 사용해야 한다면 각 기기의 공개 키를 별도로 등록하고 주소를 할당한 뒤 각자 설정하세요.

구독을 업데이트한 뒤 설정값이 바뀌었습니다. 수동으로 원래대로 돌려야 하나요?

먼저 해당 연결 항목이 본인의 구독으로 관리되는지 확인하세요. 업데이트 시 서비스 제공업체가 전달한 설정값이 다시 적용될 수 있습니다. 수동 항목과 구독 항목을 구분한 뒤, 변경 이유를 서비스 제공업체에 확인하고 수동 설정을 유지할지 구독 관리 항목을 사용할지 결정하세요.

Shadowrocket 다운로드 및 다음 설정 단계

iPhone / iPad 버전은 App Store에서 $2.99에 한 번 결제해 구매할 수 있으며, 시스템 요구 사항은 App Store 페이지의 안내를 확인하세요. Mac(Apple 실리콘 / Intel) / Windows / Android / Linux 버전은 무료입니다. 전체 플랫폼 다운로드 페이지에서 기기를 선택한 뒤 안내에 따라 기본 설정을 진행하세요. WireGuard에 필요한 서버 정보는 직접 준비해야 합니다.

Shadowrocket 다운로드