WireGuard를 수동으로 입력할 때는 먼저 로컬 기기와 피어를 구분하고, 터널 내부 주소와 외부 연결 주소를 나눠 확인하세요. 이 글은 현재 사용 중인 기기 전용 설정을 받은 iPad 또는 iPhone 사용자를 위한 안내입니다. 항목에 맞춰 입력한 뒤 저장하고, 핸드셰이크와 라우팅, 실제 접속을 차례로 확인하세요. MTU나 Keepalive 조정은 그다음에 필요성을 판단하면 됩니다.
PrivateKey와 PublicKey: 키의 주체부터 확인하기
클라이언트 설정을 기준으로 [Interface]는 로컬 기기, [Peer]는 로컬 기기와 통신하는 피어를 나타냅니다. 양쪽은 각각 고유한 키 쌍을 사용합니다. Shadowrocket에는 로컬 기기의 PrivateKey와 피어의 PublicKey를 입력합니다. 같은 키 쌍의 공개 키와 개인 키를 함께 입력하는 것이 아닙니다.
클라이언트 설정에서 로컬 기기와 피어 구분하기
[Interface] 로컬 기기
PrivateKey는 현재 기기의 개인 키입니다. 원래 문자열을 그대로 입력하고 끝의 등호를 지우지 마세요. 필드 이름까지 함께 붙여 넣지 않도록 주의하세요.Address는 현재 기기가 터널 내부에서 사용하는 주소입니다. 보통 설정 제공자가 지정하며, 현재 Wi-Fi가 iPad에 할당한 주소와는 다릅니다.
[Peer] 피어
PublicKey는 피어를 식별하는 데 사용합니다. 서버는 반대로 로컬 기기의 공개 키를 사용해 해당 기기를 식별합니다.Endpoint는 WireGuard UDP 패킷을 보낼 대상입니다. 설정에PresharedKey가 포함되어 있다면 해당 설정의 값을 같은 이름의 필드에 입력하세요. 공개 키나 개인 키를 대신하는 값은 아닙니다.
서버 설정을 클라이언트 설정으로 사용하지 마세요. 기기 확인을 위해 관리자에게 전달할 때는 로컬 기기의 공개 키만 제공하고, 개인 키나 사전 공유 키는 보내지 마세요.
Address, Endpoint, MTU 필드 비교
WireGuard 설정의 Address와 앱 화면에서 서버 주소를 입력하는 Address는 이름이 같을 수 있습니다. 필드의 위치와 용도를 확인해 구분하세요. Address가 Port와 짝을 이루면 Endpoint의 호스트 부분을 입력하는 필드입니다. 터널 내부 주소는 클라이언트 IP에 해당하는 필드에 입력하세요.
| 필드 | 예시 값 | 입력 위치 및 확인 방법 |
|---|---|---|
Address | 10.20.30.2/32 | 터널 내부에서 사용하는 로컬 IPv4 주소입니다. IPv6도 할당된 경우 화면의 해당 필드에 각각 입력하세요. 설정에 지정된 접두사 길이를 그대로 사용하고, /32를 임의로 /24로 바꾸지 마세요. |
Endpoint | 198.51.100.20:51820 | 피어의 IP 주소 또는 호스트 이름과 UDP 포트입니다. 화면에서 호스트와 포트를 따로 입력한다면 198.51.100.20과 51820을 각각 입력하세요. https://는 붙이지 않습니다. |
MTU | 1420 | 터널 인터페이스가 전달할 수 있는 내부 IP 패킷의 최대 크기이며, 단위는 바이트입니다. 외부 IP, UDP, WireGuard 캡슐화에도 전송 공간이 필요하므로 적정 값은 실제 네트워크 경로에 따라 달라집니다. |
PersistentKeepalive | 25 | 앱의 Keepalive 설정에 해당하며, 단위는 초입니다. 트래픽이 없을 때 NAT 또는 방화벽의 UDP 연결 상태를 유지하는 데 사용합니다. 핸드셰이크 시간 초과나 지연 시간 측정 주기를 뜻하지 않습니다. |
표의 값은 형식을 설명하기 위한 예시일 뿐입니다. 예시 Endpoint에는 문서용 예약 주소가 사용되어 연결할 수 없습니다. 실제 설정을 기준으로 입력하고, 예시 포트를 프로토콜의 필수값으로 오해하지 마세요.
Shadowrocket에 WireGuard 수동으로 추가하기
먼저 현재 기기용 클라이언트 설정을 준비하세요. 설정에 [Peer]가 여러 개 있다면 서로 다른 항목의 값을 하나씩 가져와 한 연결로 조합하면 안 됩니다. 아래 수동 입력 절차는 피어 하나를 기준으로 합니다.
프로토콜 선택
Home →「+」→ Add Server → Type → WireGuard를 엽니다. 먼저 프로토콜 유형을 확인한 다음 매개변수를 입력하세요. WireGuard 포트를 다른 프로토콜 설정에 입력하는 실수를 방지할 수 있습니다.
피어 정보 입력
같은
[Peer]항목에서Endpoint와PublicKey를 확인하세요. 호스트와 UDP 포트를 서버 주소 및 포트 필드에 입력한 다음 피어의 공개 키를 입력합니다.Endpoint가 도메인 이름이라면 설정에 적힌 도메인을 그대로 사용하세요. 한 번 조회한 IP 주소로 고정하지 마세요.로컬 기기 정보 입력
[Interface]의PrivateKey는 개인 키 필드에, 터널 내부Address는 클라이언트 IP에 해당하는 위치에 입력하세요. 설정에 IPv4와 IPv6 주소가 모두 있다면 각각 해당 필드에 입력하고, 설정 행 전체를 하나의 입력란에 붙여 넣지 마세요.선택 항목 확인
원래 설정을 기준으로
MTU,PersistentKeepalive및 사전 공유 키를 확인합니다. 제공되지 않은 값은 인터넷에서 임의로 찾아 추가하지 마세요. 원래 설정에AllowedIPs가 있다면, 특히 소수의 네트워크 대역만 지정된 경우 예상되는 접근 범위를 먼저 확인하세요. 이는 WireGuard의 피어 설정이며 Shadowrocket의Config규칙과는 다릅니다.저장 후 연결 확인
저장한 뒤 Home으로 돌아가 방금 추가한 항목을 선택하고 연결을 켭니다. 해당 피어로 전달되어야 하는 대상에 실제 요청을 보내 확인하세요. 시스템에 VPN 표시가 나타나는 것은 VPN이 켜졌다는 뜻일 뿐, WireGuard가 피어와 핸드셰이크를 완료했다는 의미는 아닙니다.
Global Routing: 연결 문제와 규칙 미일치 구분하기
먼저 테스트 대상의 트래픽이 실제로 WireGuard를 거치는지 확인하세요. AllowedIPs는 WireGuard에서 피어 주소를 매칭하고 수신 패킷을 검증하는 데 사용합니다. 반면 Home → Global Routing은 Shadowrocket이 요청을 프록시로 전달할지 결정합니다. 두 설정은 서로 대체할 수 없습니다. 서버에서 특정 사설 네트워크에만 접속할 수 있다면, 임의의 공용 웹사이트가 아니라 해당 사설 네트워크에서 작동이 확인된 서비스를 테스트 대상으로 선택하세요.
Config
권장현재 설정 파일의 규칙에 따라 요청을 처리합니다. 대상이 예상한 규칙과 일치하는지 확인하고, 해당 규칙의 아웃바운드 정책이 이 WireGuard 항목을 선택했는지도 확인하세요. 요청이 DIRECT로 처리됐다면 접속에 성공해도 WireGuard가 작동한다는 증거가 되지 않습니다.
적합한 경우: 규칙 경로를 확인한 뒤 일상적으로 사용하거나 다시 테스트할 때.
Proxy
Shadowrocket이 처리하는 테스트 요청을 현재 선택된 프록시로 임시 전달해 Config 규칙의 영향을 제외합니다. 먼저 기존 선택값을 기록하고, 테스트가 끝나면 원래대로 되돌리세요. 같은 대상이 Proxy에서는 작동하고 Config로 전환하면 작동하지 않는다면 규칙과 아웃바운드 정책을 우선 확인하세요.
적합한 경우: 규칙에 따라 같은 대상의 아웃바운드 경로가 달라지는지 짧게 확인할 때.
핸드셰이크, MTU, Keepalive 관련 문제 해결
문제를 확인할 때는 네트워크, 연결 항목, 테스트 대상을 동일하게 유지하고 한 번에 한 항목만 변경하세요. 먼저 피어와 통신할 수 있는지 확인한 다음 도메인 이름 조회, 데이터 전송 크기, 유휴 상태 이후의 연결 복구를 살펴보세요. 문제가 발생하는 단계에 따라 원인이 다르므로 같은 매개변수 하나로 모든 문제를 해결하려고 하지 마세요.
연결을 켰는데 피어에 핸드셰이크 기록이 없는 이유는 무엇인가요?
먼저 해당 피어를 실제로 거치는 요청을 보내고 Endpoint의 호스트와 UDP 포트를 확인하세요. 피어 관리자에게 현재 기기의 공개 키가 등록되어 있는지 확인하고, 클라이언트에 입력한 피어 공개 키와 선택 항목인 사전 공유 키도 대조하세요. 특정 Wi-Fi에서만 실패한다면 같은 연결 설정으로 사용 권한이 있는 다른 네트워크에서도 다시 테스트해 설정 문제인지 해당 네트워크의 UDP 연결성 문제인지 구분하세요. MTU나 Keepalive부터 조정하지 마세요.
알려진 IP 주소의 서비스에는 접속되지만 도메인은 열리지 않을 때 무엇을 확인해야 하나요?
먼저 설정에 지정된 DNS 서버가 현재 라우팅 경로에서 연결 가능한지, 대상 도메인을 조회하는 데 사설 DNS가 필요한지 확인하세요. IP 주소로 접속할 수 있는 것으로 확인된 서비스를 비교 테스트에 사용하세요. HTTPS 사이트의 도메인 대신 IP 주소를 직접 입력해 테스트하지 마세요. 인증서 검증이나 사이트 식별이 실패할 수도 있습니다.
작은 요청은 되지만 큰 페이지나 파일 전송이 멈추면 MTU를 바꿔야 하나요?
같은 네트워크와 같은 아웃바운드 경로에서 작은 요청은 성공하지만 큰 데이터 전송은 반복해서 멈추는지 재현한 다음 경로 MTU를 확인하세요. 기존 값이 1420이라면 원래 값을 기록한 뒤 1380으로 낮춰 보는 방법이 있습니다. 다시 연결하고 같은 리소스를 테스트하세요. 개선되지 않으면 원래 값으로 되돌리세요. 두 값은 비교 방법을 설명하는 예시이며 모든 네트워크에 적용되는 고정 설정값이 아닙니다.
연결 직후에는 되지만 한동안 유휴 상태가 지난 뒤 끊깁니다. Keepalive를 켜야 하나요?
같은 네트워크에서 연결이 켜진 상태로 문제가 발생하는지 먼저 확인하세요. Wi-Fi를 바꾸거나 시스템에서 VPN 연결을 끊은 뒤 발생한 문제가 아닌지도 살펴보세요. 최초 핸드셰이크와 지속적인 데이터 전송은 정상이고 유휴 상태 이후에만 응답을 받지 못한다면 설정 제공자의 안내에 따라 25초를 시험하고, 같은 시간 동안 유휴 상태를 유지한 뒤 다시 확인할 수 있습니다. Keepalive는 주기적으로 패킷을 전송합니다. 이런 문제가 없고 설정에서도 요구하지 않는다면 백그라운드 트래픽을 늘릴 필요는 없습니다.