Shadowrocket 공식 매뉴얼

Shadowrocket 사용법

기존 연결 정보를 가져온 다음 라우팅 모드를 선택하세요. 연결 후에는 서버와 실제 접속 결과를 각각 확인하고, 스위치 상태만으로 라우팅 결과를 판단하지 마세요.

01 Add Server

서버 추가 또는 구독 가져오기

Shadowrocket을 열고 하단에서 Home으로 이동한 다음 SERVER 그룹을 찾습니다. 서버 한 대의 설정값이 있다면 수동으로 추가하고, 여러 항목을 동기화하는 링크가 있다면 구독을 가져옵니다. 두 방법 중 하나만 선택하면 되므로 구독에 포함된 항목을 다시 입력할 필요는 없습니다. 처음 설정할 때는 상단 연결 스위치를 끈 상태로 두고 저장한 뒤 항목을 확인하세요.

서버 설정값 직접 입력

Home에서 더하기 버튼이나 Add Server를 누르고, Type에서 기존 서버와 같은 프로토콜을 선택합니다. 유형을 선택하면 해당 필드가 표시됩니다. 제공된 정보를 기준으로 Host와 Port를 각각 입력합니다. Host에는 호스트 이름이나 IP 주소를, Port에는 포트 번호를 입력합니다. 포트, 경로 또는 프로토콜 접두사를 Host에 함께 붙여 넣지 마세요. Password, Method 등의 필드가 표시되면 기존 설정값에 맞춰 입력합니다. 스크린샷에 보이는 필드 배치만으로 본인의 프로토콜 설정을 추측하지 마세요.

저장하기 전에 입력 내용에 불필요한 공백이나 줄바꿈이 있는지, 문자가 자동으로 바뀌지 않았는지 확인합니다. 해당 서버의 QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. 인식한 뒤에도 Type과 주소를 확인하고 저장하세요. 스크린샷 하단에는 Import from Cloud JSON도 보이지만, 일반 구독 링크는 이 기능으로 붙여 넣지 않습니다.

기존 구독 가져오기

더하기 버튼을 눌러 추가 화면으로 이동하고 Type에서 Subscribe를 선택한 다음, 기존 구독 링크 전체를 주소 입력란에 붙여 넣습니다. 링크의 시작과 끝이 온전한지 확인하고 쿼리 매개변수도 모두 포함합니다. 브라우저에서 리디렉션된 뒤 표시되는 페이지 주소를 원래 링크 대신 사용하지 마세요. 저장 후 Home으로 돌아가 해당 그룹을 펼친 다음, 다음 단계에서 테스트할 서버 하나를 선택합니다. 그룹 제목은 보이지만 선택할 항목이 없다면 연결 스위치가 아니라 구독 업데이트가 완료되었는지 먼저 확인합니다.

이 단계가 끝나면 SERVER 그룹 아래에 선택 가능한 항목이 하나 이상 표시되어야 합니다. 현재 선택한 항목의 이름만 기록하면 됩니다. 구독 링크, 비밀번호 또는 QR 코드를 문제 해결 메모에 복사하지 마세요. 다음으로 라우팅 모드를 선택합니다. 서버를 저장해도 어떤 요청을 서버로 전달할지는 자동으로 정해지지 않습니다.

Add Server 화면. Type, Host, Port, Password, Method 필드와 하단의 QR 코드 스캔 및 JSON 가져오기 항목이 표시됩니다.
Add Server: 먼저 Type을 선택한 다음 해당 유형의 필드를 확인합니다.
02 Global Routing

Global Routing 모드 선택

Home으로 돌아가 Global Routing을 누릅니다. 이 메뉴는 연결 후 트래픽을 처리하는 방식을 선택하는 곳이며, 서버를 추가하거나 연결을 켜는 기능은 아닙니다. 사용할 구성 파일이 있고 대상별로 다른 경로를 적용하려면 Config를 선택합니다. 프록시와 직접 연결 상태를 비교하려면 테스트할 경로를 먼저 정한 뒤 임시로 Proxy 또는 Direct를 선택합니다.

Config: 현재 규칙에 따라 라우팅

모드를 선택한 뒤 하단의 Config에서 현재 사용 중인 구성 파일을 확인합니다. 목록에 파일이 보인다고 해서 적용 중이라는 뜻은 아닙니다. Config에서 현재 파일을 열고 Rule 섹션을 확인합니다. 도메인 규칙은 대상 주소와 일치하는지 확인한 뒤 PROXY 또는 DIRECT 같은 정책을 적용할 수 있습니다. 앞선 규칙과 일치하지 않으면 파일의 FINAL 설정도 확인해야 합니다. 처음 결과를 확인할 때는 예상 경로 두 가지를 이해하는 것으로 충분하며, Add Rule에서 임시 규칙을 추가할 필요는 없습니다.

같은 페이지에서도 이미지나 로그인 서비스에 요청할 수 있으며, 이 요청의 도메인은 주소 표시줄에 보이는 도메인과 다를 수 있습니다. 따라서 기본 도메인에 규칙이 있다고 해서 페이지의 모든 요청이 같은 경로를 사용하는 것은 아닙니다. 어떤 규칙이 적용될지 분명하지 않다면 먼저 한 가지 경로를 테스트하고 결과를 확인한 뒤 구성 모드로 돌아가세요.

Proxy와 Direct: 비교 테스트

Proxy는 클라이언트가 처리하는 트래픽을 프록시 경로로 보내며, 선택한 서버가 실제 요청을 처리할 수 있는지 확인하는 데 적합합니다. Direct는 해당 트래픽을 대상에 직접 연결하므로 현재 네트워크에서 같은 대상에 직접 접속할 수 있는지 확인할 수 있습니다. 비교할 때는 서버, 네트워크, 테스트 대상을 그대로 유지하고 모드만 변경하세요. 직접 연결이 성공해도 프록시가 정상이라는 뜻은 아니며, 프록시가 성공해도 구성 파일이 예상 규칙과 일치했다는 뜻은 아닙니다.

선택을 마치면 Home으로 돌아가 Global Routing 행에 예상한 영어 모드가 표시되는지 확인합니다. 규칙 순서나 프로토콜 필드를 더 알아보려면 기술 참고 자료를 확인하세요. 이 단계에서는 재현할 수 있도록 설정을 유지하고 연결 단계로 진행합니다.

Config 구성 파일 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시됩니다.
Config: 현재 구성 파일에서 Rule 섹션을 확인합니다.
03 Home

연결 스위치 켜기

Home에서 두 가지를 다시 확인합니다. SERVER 그룹에서 테스트할 서버를 선택했는지, Global Routing 행에 방금 선택한 모드가 표시되는지 확인합니다. 그런 다음 페이지 상단의 Not Connected 상태 스위치를 켭니다. 스위치는 클라이언트 연결을 제어합니다. 서버와 모드를 선택하는 것은 연결 전 설정이며 이 단계를 대신하지 않습니다.

Shadowrocket을 처음 사용하는 기기에서는 시스템에서 VPN 구성을 추가하라는 메시지가 표시될 수 있습니다. 방금 수행한 작업으로 나타난 메시지이며 요청 주체가 Shadowrocket인지 확인한 다음 시스템 화면의 안내에 따라 승인하세요. 기기 인증을 요청하면 시스템 화면에서 완료합니다. Home으로 돌아가 상태가 바뀔 때까지 기다린 뒤 스위치가 계속 켜져 있는지 확인합니다. 실수로 취소했다면 저장한 서버나 구독을 삭제하지 말고 Home에서 다시 시도하세요.

기기에 다른 VPN 연결이 활성화되어 있거나 관리되는 네트워크 구성이 있을 수 있고, 이전에 On Demand를 켰을 수도 있습니다. 이 경우 현재 연결을 제어하는 설정이 무엇인지 먼저 확인합니다. 조직에서 관리하는 기기는 관리자의 구성 요구 사항을 따르세요. 첫 테스트는 같은 Wi-Fi 또는 셀룰러 네트워크에서 진행하고, 스위치를 켠 직후 네트워크를 바꾸지 마세요. 네트워크 전환으로 발생한 중단을 서버 문제로 오인할 수 있습니다.

스위치가 켜져 있다는 사실만으로 연결이 활성화된 것을 알 수 있습니다. 선택한 서버에 연결할 수 있는지, 특정 요청이 프록시를 통과했는지는 확인할 수 없습니다. 상태가 유지되면 다음 단계에서 확인하고, 상태가 즉시 되돌아가면 5단계에 따라 점검하세요. 모드와 서버 설정을 연달아 바꾸지 마세요.

Home 화면. 상단에 Not Connected가 표시되고, 아래에 Global Routing, Connectivity Test 및 SERVER 그룹이 순서대로 보입니다.
Home: 상단 스위치, 현재 모드, 테스트 메뉴를 한 화면에서 확인할 수 있습니다.
04 Connectivity Test

서버 및 실제 라우팅 확인

Home에 머물면서 Connectivity Test를 눌러 현재 서버의 결과를 확인합니다. 응답이 있으면 현재 네트워크와 테스트 방식에서 결과를 받았다는 뜻입니다. 시간 초과가 발생하면 이번 테스트에서 예상한 응답을 받지 못한 것입니다. 이 테스트는 설정한 조건에서의 동작을 측정하며 실제 대상에 대한 확인을 대신하지 않습니다. 두 결과를 비교하기 전에 같은 서버 항목을 선택했는지 확인하세요.

그다음 실제 요청을 한 번 보냅니다. 현재 모드가 Config라면 규칙을 확인해 DIRECT로 연결되어야 하는 대상 하나와 PROXY를 거쳐야 하는 대상 하나를 선택해 각각 다시 방문합니다. 이미 열려 있는 페이지만 확인하지 마세요. 캐시된 페이지는 새 요청을 보내지 않아도 정상처럼 보일 수 있습니다. 클라이언트에서 요청 기록을 볼 수 있다면 요청 시간과 대상 도메인으로 항목을 찾아 표시된 정책이나 일치한 규칙을 확인합니다. 페이지가 열렸다는 사실만으로는 연결 경로를 판단할 수 없습니다.

결과가 예상과 다르면 현재 네트워크, 서버, 테스트 대상을 그대로 유지한 채 Proxy와 Direct를 비교합니다. 예를 들어 같은 대상이 Proxy에서는 열리지만 Config로 돌아간 뒤 실패한다면 서버 설정을 반복 입력하기보다 현재 구성 파일, 규칙 우선순위, 실제 요청 도메인을 먼저 확인합니다. 비교를 마치면 Global Routing을 평소 사용할 모드로 되돌립니다.

확인할 때는 스위치가 계속 켜져 있는지, 서버 테스트에 응답이 있는지, 요청에 어떤 정책이 적용되었는지 세 항목을 기록할 수 있습니다. 각각 따로 기록하면 이후 변화가 생겼을 때 기기 연결, 서버 접근성, 라우팅 결과 중 어느 부분의 문제인지 파악하기 쉽습니다.

05 Settings

문제 증상별 점검

한 번에 한 항목만 변경하고 같은 대상으로 다시 테스트하세요. 하단의 Settings로 이동해 Diagnostics, Test Method, On Demand를 찾습니다. 모든 설정을 한꺼번에 바꾸지 말고 현재 증상에 해당하는 항목부터 확인하세요.

스위치를 켜자마자 끊기거나 끈 뒤 다시 연결됨

스위치를 켠 직후 연결이 끊기면 처음 표시된 시스템 확인을 완료했는지, 기기에서 다른 VPN 구성이 실행 중인지 확인합니다. 그런 다음 Diagnostics에서 해당 시도 시간과 관련된 정보를 확인하세요. 수동으로 껐는데 다시 연결된다면 On Demand에 현재 네트워크에서 연결을 시작하는 조건이 설정되어 있는지 확인합니다. 기존 설정을 수정하기 전에 현재 상태를 기록해 두면 점검 후 되돌리기 쉽습니다.

서버 목록이 비어 있거나 항목을 선택한 뒤 테스트 시간 초과

목록이 비어 있다면 추가 단계로 돌아가 구독 그룹에 항목이 있는지, 동기화가 완료되었는지 확인합니다. 항목은 있지만 테스트 시간이 초과된다면 먼저 기기 네트워크를 확인한 뒤 선택한 항목의 프로토콜, 호스트, 포트를 기존 정보와 하나씩 비교합니다. Test Method를 확인하는 것은 현재 어떤 테스트를 하는지 파악하기 위해서입니다. 단지 다른 결과를 얻기 위해 테스트 방식을 변경하지 마세요. Wi-Fi와 셀룰러 네트워크를 비교할 때는 매번 네트워크만 바꾸고 다른 조건은 동일하게 유지합니다.

테스트에는 응답이 있지만 일부 페이지에 접속할 수 없음

먼저 페이지 전체에 문제가 있는지, 이미지나 로그인 같은 개별 요청에만 문제가 있는지 확인합니다. 앞 단계의 모드 비교로 범위를 좁힙니다. 문제가 Config에서만 발생한다면 현재 활성 구성 파일과 실패한 요청의 대상 도메인을 확인하고, 앞선 규칙이 처리했는지 또는 FINAL로 넘어갔는지 점검합니다. 규칙을 한꺼번에 변경하지 마세요. 구독 새로고침, 시스템 메시지 또는 모드 차이를 더 확인하려면 자주 묻는 질문을 참고하세요.

문제를 기록할 때는 발생 시간, 연결 모드, 네트워크 유형, 증상만 남기면 됩니다. 스크린샷이나 진단 정보를 공유하기 전에 구독 주소, 서버 인증 정보, 다시 가져오기에 사용할 수 있는 QR 코드를 가리세요.

Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics와 Proxy, TCP, UDP 설정 항목이 표시됩니다.
Settings: 증상에 따라 Diagnostics, Test Method 또는 On Demand를 확인합니다.

Shadowrocket 다운로드 및 설치

iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제로 제공되며, 시스템 요구 사항은 App Store 페이지를 기준으로 합니다. Mac / Windows / Android / Linux 버전은 무료이며, 설치 파일은 이 사이트의 /dl/에서 제공합니다. Mac에서는 먼저 ‘이 Mac에 관하여’에서 칩 종류를 확인한 다음 Apple 칩 버전 또는 Intel 버전을 선택하세요.

클라이언트 일회성 구매 ≠ 연결 서비스 요금제. 이 안내에서는 이미 보유한 구독 또는 서버 정보를 사용합니다. 클라이언트를 구매해도 해당 정보를 제공받는 것은 아닙니다.

iPhone / iPad $2.99 일회성 결제; Mac / Windows / Android / Linux 무료

Mac, Windows 또는 Android에서 처음 설치할 때 시스템 차단 메시지가 표시되면 설치 파일이 이 사이트에서 제공되었으며 기기에 맞는지 먼저 확인한 다음 플랫폼별 설치 및 실행 허용 안내를 따르세요. 출처를 확인할 수 없다면 설치를 중단하세요.