SHADOWROCKET / SETTINGS REFERENCE
Shadowrocket 설정 가이드
먼저 연결 요청을 어떤 경로로 처리할지 정한 다음 규칙, 연결 조건, 진단 결과를 확인하세요. 이 페이지에서는 각 설정의 용도와 조작 순서, 혼동하기 쉬운 부분을 화면 위치에 따라 설명합니다. iPhone 또는 iPad에서 Shadowrocket을 사용 중이며, 본인이 보유한 구독 정보나 서버 정보가 있는 사용자를 위한 안내입니다.
01 / ROUTING
Global Routing:Config、Proxy、Direct
Global Routing은 연결을 켰을 때 요청을 어떤 라우팅 방식으로 먼저 처리할지 정합니다. 서버 주소를 입력하는 기능은 아닙니다. 모드를 변경하기 전에 Home에 사용할 서버가 있는지, Config에 원하는 규칙이 적용되어 있는지 확인하세요.
| 화면 옵션 | 처리 방식 | 사용 상황 | 확인할 점 |
|---|---|---|---|
| Config(구성) | 현재 구성 파일의 규칙에 따라 요청을 매칭하고 해당 정책으로 전달합니다. | 도메인이나 주소별로 서로 다른 경로를 지정해야 할 때 사용합니다. | 선택한 구성, 규칙 순서, 최종 정책을 확인하세요. |
| Proxy(프록시) | 선택한 프록시 서버를 주 경로로 사용하며, Config의 분기 규칙을 하나씩 적용해 결정하지 않습니다. | 선택한 서버로 연결할 수 있는지 잠시 확인할 때 사용합니다. | 서버가 선택되어 있는지 확인하세요. 테스트 결과를 규칙 적용 여부로 오해하지 마세요. |
| Direct(직접 연결) | 요청을 직접 연결 경로로 보냅니다. | 문제가 프록시 경로와 관련 있는지 비교해 확인할 때 사용합니다. | Config로 돌아간 뒤 대상 요청에 규칙이 적용되는지 다시 확인하세요. |
위치와 설정 방법: Home에서 Global Routing을 찾아 Config, Proxy, Direct 중 하나를 선택한 다음 연결을 켜고 확인하려는 대상에 접속하세요. 평소 규칙에 따라 트래픽을 분기하려면 보통 Config를 선택합니다. 문제를 진단할 때는 잠시 Proxy 또는 Direct로 바꿔 비교해 볼 수 있습니다. 테스트가 끝나면 원래 모드로 되돌려 임시 설정이 계속 사용되지 않도록 하세요.
주의할 점: Global Routing은 라우팅 방식을 선택하는 기능일 뿐, 서버가 작동한다는 뜻은 아니며 Config의 규칙 확인을 대신하지도 않습니다. Config에서 Proxy와 다른 결과가 나오면 먼저 규칙이 대상을 DIRECT 또는 REJECT로 보내는지, 이어서 예상한 PROXY 정책에 매칭되는지 확인하세요. Home의 연결 스위치만 보고 요청이 실제로 어떤 경로를 사용했는지 판단하지 마세요.
02 / RULES
Config의 규칙 분기
규칙은 ‘어떤 요청을 매칭해 어떤 정책으로 보낼지’를 정합니다. Global Routing에서 Config를 선택한 경우, 현재 구성 파일의 규칙을 기준으로 트래픽 분기 동작을 확인해야 합니다.
매칭 조건
DOMAIN은 지정된 도메인과 매칭되고, DOMAIN-SUFFIX는 도메인 접미사와, DOMAIN-KEYWORD는 도메인에 포함된 키워드와 매칭됩니다. IP-CIDR과 IP-CIDR6은 주소 범위를 대상으로 하며, GEOIP은 주소의 지리적 정보를 기준으로 매칭합니다. USER-AGENT는 요청 식별자와 관련됩니다. 조건을 선택하기 전에 대상 요청에 도메인과 주소 중 무엇이 표시되는지 확인하세요.
실행 정책
PROXY는 프록시 경로로 보내고, DIRECT는 직접 연결하며, REJECT는 매칭된 요청을 거부합니다. 규칙은 보통 순서대로 확인하므로, 조건 범위가 넓은 규칙이 앞에 있으면 더 구체적인 규칙보다 먼저 매칭될 수 있습니다. 앞선 규칙에 매칭되지 않은 경우의 처리 방식은 마지막의 FINAL이 결정합니다.
위치와 설정 방법: Home에서 Config로 들어가 현재 활성화된 구성 파일을 확인한 뒤 규칙을 살펴보세요. 직접 관리하는 구성을 수정할 때는 먼저 원본을 백업하고, 한 번에 소수의 규칙만 변경하세요. 저장한 뒤 Global Routing을 Config로 유지하고 대상 도메인을 다시 테스트합니다. 규칙 문법에 사용하는 영문 키워드와 정책 이름은 원문 그대로 입력해야 합니다.
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
위 주소는 문법 설명을 위한 예시입니다. DOMAIN과 DOMAIN-SUFFIX는 매칭 범위가 다르며, IP-CIDR의 네트워크 대역은 특정 도메인과 같지 않습니다. 규칙을 작성했는데 적용되지 않는다면 현재 구성 파일, Global Routing 모드, 규칙 순서, 대상 요청에서 실제로 사용되는 주소를 차례로 확인하세요. 자세한 조작 방법은 시작 가이드를 참고하세요.
03 / SERVER MANAGEMENT
Subscribe 및 서버 관리
서버 항목에는 연결에 필요한 매개변수가 들어 있고, Subscribe는 사용자가 보유한 구독 정보를 관리합니다. 두 기능은 정보 입력과 관리에 관한 것으로, Global Routing의 세 가지 모드를 결정하지 않습니다.
기능과 위치: Home의 서버 목록에서 기존 항목을 선택하세요. 직접 입력하려면 Add Server를 사용하고, 본인이 보유한 서버 정보에 맞는 프로토콜을 선택한 뒤 주소, 포트, 인증 정보를 입력합니다. Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2 같은 프로토콜 이름은 원본 정보와 일치해야 합니다. 이름만 바꾸고 다른 프로토콜의 입력 항목을 그대로 사용해서는 안 됩니다.
설정 방법: 본인 소유의 구독 링크가 있다면 Subscribe에서 전체 링크를 추가하고 저장한 다음 업데이트를 실행하세요. 서버 목록으로 돌아와 예상한 항목이 표시되는지 확인합니다. 해당 메뉴에서 Scan QR Code를 사용해 본인이 보유한 정보를 가져올 수도 있습니다. Import from Cloud JSON을 사용할 때는 파일이 본인의 구성 정보인지 확인하고 가져온 뒤 각 항목을 점검하세요. 추가에 성공해도 서버 연결이 보장되는 것은 아니므로, 항목을 선택해 별도로 테스트해야 합니다.
주의할 점: 구독을 업데이트하면 목록의 항목이 변경될 수 있습니다. 구독에서 생성된 항목을 직접 수정하기 전에는 다음 업데이트에서 변경 사항이 덮어써지는지 확인하세요. 여러 구독을 관리한다면 각각의 출처와 용도를 구분하고, 하나씩 업데이트하며 확인하세요. 삭제하기 전에 계속 사용할 서버 정보는 따로 보관해야 합니다. 앱을 한 번 구매하는 것과 회선 요금제를 이용하는 것은 별개입니다. Shadowrocket을 구매하면 앱 사용 권한을 얻으며, 보유한 서버나 구독의 사용 가능 여부는 각각 확인해야 합니다. 항목 입력, 업데이트, 정리 방법은 서버 관리 가이드를 참고하세요.
04 / CONNECTION CONDITIONS
On Demand 자동 연결
On Demand는 설정한 네트워크 조건에 따라 연결을 시도할 시점을 결정합니다. 연결 시작 조건을 관리하는 기능이며, 서버 선택이나 Config의 요청 분기 규칙을 대신하지 않습니다.
위치와 설정 방법: Settings에서 On Demand를 찾아 어떤 네트워크 환경에서 자동 연결할지 먼저 정한 다음, 화면에 표시되는 조건을 설정하세요. 기능을 켠 후에는 조건을 충족하는 네트워크와 충족하지 않는 네트워크에서 각각 연결 상태를 확인합니다. 수동으로만 제어하고 싶다면 기존처럼 직접 조작하면 됩니다. 모든 네트워크 조건에 규칙을 설정할 필요는 없습니다.
주의할 점: 네트워크 전환, 기기 깨우기, 시스템 연결 상태 변경으로 인해 조건이 다시 확인될 수 있습니다. 연결을 끈 직후 다시 연결된다면 서버 매개변수부터 바꾸지 말고 On Demand 조건과 Home의 연결 상태를 먼저 확인하세요. 특정 요청의 경로를 진단할 때는 당시의 네트워크 환경, Global Routing 모드, 선택한 서버를 함께 기록하세요. On Demand는 ‘언제 연결할지’를 관리하는 기능이지 ‘요청이 어떤 규칙에 매칭되는지’를 정하는 기능이 아닙니다.
05 / TRAFFIC
Data 트래픽 통계
Data에서는 클라이언트가 기록한 트래픽 사용량을 확인할 수 있습니다. 연결 중 데이터가 전송되었는지 살펴보는 데 도움이 되지만, 구독 서비스 제공업체의 잔액이나 사용량을 확인하는 페이지는 아닙니다.
위치와 확인 방법: Data를 열고 먼저 현재 표시되는 통계 기간을 확인한 다음, Home의 연결 상태와 접속 시간을 함께 살펴보세요. 설정 변경 전후를 비교하려면 테스트 시작 시간과 통계 수치를 기록하고, 같은 방식으로 접속한 뒤 수치 변화를 확인합니다. 통계 초기화 기능이 있다면 필요한 데이터를 먼저 기록해 두세요.
주의할 점: 트래픽 수치만으로는 해당 통계 기준에서 클라이언트가 데이터를 기록했다는 사실만 알 수 있습니다. 특정 도메인이 PROXY, DIRECT 또는 REJECT에 매칭되었는지는 확인할 수 없습니다. 백그라운드 요청, 반복 테스트, 네트워크 전환도 수치에 영향을 줄 수 있습니다. 실제 경로를 확인하려면 총량만으로 서버 상태를 추측하지 말고 Data, Global Routing, 구성 규칙, Diagnostics 결과를 함께 살펴보세요.
06 / NAME RESOLUTION
Settings의 DNS
DNS는 도메인을 주소로 변환합니다. 변환 결과는 주소 조건을 사용하는 규칙의 판단에 영향을 줄 수 있으므로 DNS 문제와 규칙 문제는 비슷하게 보일 때가 있습니다. 두 항목을 나누어 확인하세요.
위치와 설정 방법: Settings에서 DNS 관련 옵션을 찾으세요. 현재 Config에도 DNS 매개변수가 정의되어 있다면 먼저 설정 내용을 확인한 뒤 변경 여부를 결정해야 합니다. 사용자 지정 DNS나 DNS over HTTPS를 사용하려면 본인이 보유하고 있고 확인 가능한 DNS 서비스 정보를 기준으로 항목을 하나씩 입력한 다음 같은 도메인으로 반복 테스트하세요. 변수를 한 번에 하나만 바꾸면 결과 변화가 DNS 때문인지 라우팅 규칙 때문인지 판단하기 쉽습니다.
주의할 점: 도메인 해석 실패, 예상과 다른 주소로 해석되는 문제, 서버 연결 실패는 서로 다른 진단 방향입니다. 웹페이지가 열리지 않으면 먼저 도메인이 해석되는지 확인한 뒤 관련 규칙과 서버를 살펴보세요. DNS 변경 후 연결이 불안정해지면 이전에 작동하던 설정으로 되돌린 다음 원인을 찾으세요. 비교 기준을 잃지 않도록 Global Routing, DNS, 서버를 한꺼번에 바꾸지 마세요. 설정 방법과 고려 사항은 DNS 설정 가이드를 참고하세요.
07 / TESTING
Test Method 및 Connectivity Test
테스트 방법은 클라이언트가 서버를 확인하는 방식을 정하며, Connectivity Test는 진단 작업입니다. 테스트 결과는 문제 범위를 좁히는 데 도움이 되지만 실제 대상 콘텐츠 접속을 대신하지는 않습니다.
위치와 설정 방법: Settings에서 Test Method를 확인하고 현재 설정을 유지한 채 같은 서버를 테스트해 결과를 기록하세요. 비교가 필요하면 그때 방법을 변경하고 같은 서버를 다시 테스트합니다. Connectivity Test를 사용할 때는 네트워크가 정상적으로 연결되어 있고 Home에서 올바른 서버를 선택했는지 확인한 뒤 결과를 살펴보세요. 서버 목록에서 지연 시간 테스트를 지원한다면 결과를 정렬에 참고할 수 있지만, 실제 연결은 각 서버별로 확인해야 합니다.
주의할 점: 테스트 방법마다 확인하는 대상이나 연결 단계가 다를 수 있습니다. 테스트 하나가 통과해도 모든 도메인과 프로토콜 요청이 성공한다는 뜻은 아니며, 한 번 실패했다고 구독 내용의 문제로 단정해서도 안 됩니다. 진단할 때는 네트워크 환경과 서버를 그대로 유지하고 테스트 방법부터 비교한 다음, Global Routing의 Config, Proxy, Direct를 사용해 경로를 비교하세요. 결과 숫자만 기록하는 것보다 ‘어떤 방법으로 어떤 항목을 테스트했는지’를 적어 두면 나중에 확인하기 쉽습니다.
08 / UTILITIES
Today Widget, iCloud 및 Diagnostics
각 옵션은 빠른 확인, 설정 정보 동기화, 문제 진단과 관련이 있습니다. 일상적인 관리에 도움이 되는 기능이며 규칙 키워드 자체의 의미를 바꾸지는 않습니다.
Today Widget
기능과 위치: Settings에서 Today Widget 관련 옵션을 확인하세요. 시스템의 빠른 실행 영역에서 연결 상태를 확인하거나 조작할 때 사용할 수 있습니다. 설정 방법: 먼저 클라이언트에서 관련 옵션을 확인한 다음 기기의 위젯 관리 화면에서 추가할 수 있는지 살펴보세요. 주의: 메뉴 표시 여부와 시스템에서 보이는 방식은 사용 중인 기기의 화면을 기준으로 확인해야 합니다. 빠른 실행 영역에 표시되는 상태는 Home의 상태와 비교하세요.
iCloud 동기화
기능과 위치: Settings의 iCloud 관련 설정에서 동기화 대상 정보를 관리할 수 있습니다. 설정 방법: 기기에 로그인된 계정과 시스템의 iCloud 상태를 확인한 뒤 클라이언트에서 제공하는 동기화 옵션을 살펴보세요. 주의: 동기화 전에 중요한 개인 구성의 사본을 보관하고, 다른 기기에서 실제로 전송된 내용을 하나씩 확인하세요. 동기화 상태가 서버 사용 가능 여부를 증명하는 것은 아닙니다.
Diagnostics의 기능, 위치 및 사용 방법: Settings에서 Diagnostics를 찾으세요. 연결 문제가 발생하면 먼저 재현 절차를 기록하고 확인 가능한 진단 정보를 살펴보세요. ‘기기의 현재 네트워크 → 선택한 서버 → Global Routing → Config 규칙 → DNS’ 순서로 확인하면 서로 다른 단계의 문제를 혼동하지 않는 데 도움이 됩니다. 진단 기록에는 도메인, 주소, 연결 정보가 포함될 수 있습니다. 다른 사람에게 전달해 도움을 요청하기 전에 본인의 민감한 정보가 있는지 확인하고 필요한 부분을 처리하세요.
권장 설정 순서: 처음 설정할 때는 본인이 보유한 서버 정보를 먼저 가져와 연결을 확인한 다음 Global Routing을 선택하세요. 트래픽을 분기해야 한다면 Config의 규칙을 확인하고, On Demand, DNS, Test Method 같은 보조 설정은 마지막에 검토합니다. 변경 후에는 같은 대상을 다시 테스트하고 차이를 기록하세요. 원인을 찾지 못했다면 여러 옵션을 한꺼번에 바꾸지 말고 문제 해결 안내에 따라 하나씩 확인하세요.
App Store에서 정식 앱 확인
Shadowrocket은 App Store에서만 받을 수 있습니다. 구매 전에 개발자 이름이 Shadow Launch Technology Limited이고 앱 ID가 932747118인지 확인하세요. 가격, 호환 기기 및 시스템 요구 사항은 App Store 페이지의 안내를 기준으로 합니다.