Shadowrocket 공식 매뉴얼 / 기능 및 설정
Shadowrocket 주요 설정
먼저 분기 모드를 확인한 다음 설정, 서버, 연결 상태를 점검하세요.
이 페이지에서는 각 기능이 무엇인지, 어디에서 설정하는지, 사용 방법과 주의사항을 설명합니다. 화면 위치는 일반적인 iPhone / iPad 구성을 기준으로 합니다. Mac, Windows, Android, Linux에서도 Shadowrocket을 사용할 수 있지만 메뉴 배치와 시스템 연동 옵션은 플랫폼에 따라 다를 수 있으므로 현재 기기에 표시되는 내용을 확인하세요.
연결 방식
Global Routing의 세 가지 모드
기능: Global Routing은 연결에 적용할 트래픽 처리 방식을 결정합니다. 구성, 프록시, 직접 연결은 화면의 Config, Proxy, Direct에 해당합니다. 프로토콜을 선택하는 기능이 아니며 구독에 포함된 서버를 자동으로 사용 가능한 상태로 바꾸지도 않습니다. 모드를 변경하기 전에 선택된 서버와 구성 파일을 확인하세요.
위치 및 설정 방법: Home에서 Global Routing을 열고 원하는 항목을 선택한 뒤 돌아오세요. 기존 분기 규칙을 사용하려면 Config를 선택합니다. 규칙 때문에 문제가 생겼는지 확인하려면 잠시 Proxy로 바꿔 비교할 수 있습니다. 로컬 네트워크에서 대상에 접속할 수 있는지 확인하려면 Direct와 비교하세요. 테스트가 끝나면 원래 모드로 되돌려 임시 설정이 일상 설정으로 남지 않도록 합니다.
| 화면 항목 | 처리 방식 | 사용 상황 | 확인할 사항 |
|---|---|---|---|
| Config · 구성 | 현재 활성화된 구성의 규칙과 정책에 따라 요청을 처리합니다. | 도메인이나 주소별로 접속 경로를 나눠야 할 때 사용합니다. | 구성이 활성화되어 있는지, 규칙 순서와 정책 참조가 올바른지 확인합니다. |
| Proxy · 프록시 | 클라이언트가 처리하는 범위의 트래픽을 프록시 경로로 보냅니다. | 분기 규칙으로 인해 차이가 생기는지 잠시 확인할 때 사용합니다. | 현재 서버에 연결할 수 있는지, 프로토콜 매개변수가 일치하는지 확인합니다. |
| Direct · 직접 연결 | 선택한 프록시 서버를 거치지 않고 직접 연결합니다. | 기본 네트워크를 비교하거나 로컬 리소스에 접속할 수 있는지 확인할 때 사용합니다. | 로컬 네트워크와 대상 서비스 자체가 정상인지 확인합니다. |
주의사항: Proxy를 선택해도 대상에 반드시 접속할 수 있는 것은 아니며, Direct는 시스템 연결 스위치를 끄는 것과 다릅니다. 연결이 설정되었는지, 요청이 클라이언트에 들어왔는지, 어떤 정책이 최종 적용되었는지는 각각 별개의 문제입니다. 시스템 제외 항목이나 앱 자체의 특수한 연결 방식도 실제 처리 범위에 영향을 줄 수 있으므로 요청 기록을 함께 확인하세요.
매칭 및 처리
규칙 유형과 정책
기능: 규칙은 대상을 식별하고 정책은 처리 방식을 결정합니다. 예를 들어 DOMAIN-SUFFIX는 도메인 접미사 조건을, PROXY는 프록시 경로로 처리하는 방식을 나타냅니다. Global Routing의 Proxy 모드와 규칙의 PROXY 정책을 혼동하지 마세요. 전자는 전체 작동 방식을 선택하고, 후자는 구성 내 특정 규칙의 동작을 지정합니다.
위치 및 설정 방법: Config에서 현재 활성화된 구성을 찾아 파일 편집 화면이나 규칙 목록으로 이동하세요. 먼저 백업한 뒤 범위가 좁고 예외적인 규칙을 앞에, 적용 범위가 넓은 규칙을 뒤에 배치하고, 앞선 규칙에 매칭되지 않은 요청은 마지막의 FINAL로 처리합니다. 아래 예시는 문법 설명용 도메인이며 연결 정보가 아닙니다.
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
이 순서에서는 api.example.com이 첫 번째 규칙에 먼저 매칭되므로 뒤에 있는 접미사 규칙은 적용되지 않습니다. 그 외에 example.com 접미사와 일치하는 도메인은 두 번째 규칙을 따릅니다. 규칙을 작성했다고 해서 요청이 반드시 해당 규칙까지 도달하는 것은 아닙니다.
| 키워드 | 매칭 대상 | 사용 시 주의사항 |
|---|---|---|
| DOMAIN | 전체 도메인입니다. | 특정 호스트에 예외를 지정할 때 사용합니다. |
| DOMAIN-SUFFIX | 도메인 접미사와 하위 도메인입니다. | 전체 도메인보다 적용 범위가 넓으므로 앞서 필요한 규칙을 덮어쓰지 않는지 확인하세요. |
| DOMAIN-KEYWORD | 도메인에 포함된 키워드입니다. | 관련 없는 도메인까지 매칭될 수 있으므로 조건을 좁힌 뒤 사용하세요. |
| IP-CIDR / IP-CIDR6 | IPv4 / IPv6 주소 범위입니다. | 주소 계열, 마스크, 도메인 해석이 매칭에 미치는 영향을 확인하세요. |
| GEOIP | 주소 데이터베이스에 등록된 지역 정보입니다. | 데이터베이스의 지역 정보가 서비스 운영자의 실제 소재지를 뜻하지는 않습니다. |
| USER-AGENT | 규칙에서 식별할 수 있는 User-Agent 내용입니다. | 해당 필드를 확인할 수 있는 경우에만 매칭할 수 있습니다. |
| FINAL | 앞선 규칙에 매칭되지 않은 요청입니다. | 기본 처리 규칙으로 규칙 목록의 마지막에 둡니다. |
주의사항: PROXY는 프록시 경로를 사용하고, DIRECT는 직접 연결하며, REJECT는 매칭된 요청을 거부합니다. 거부 규칙으로 페이지가 의존하는 리소스까지 차단될 수 있습니다. 페이지 일부가 표시되지 않으면 서버를 바로 바꾸기보다 어떤 규칙에 매칭되었는지 확인하세요. 사용자 지정 정책을 참조할 때는 구성에 실제로 정의된 이름과 일치해야 합니다. 규칙 우선순위는 사용자 지정 규칙과 FINAL 설명에서 자세히 확인할 수 있습니다.
서버 유형
프로토콜과 매개변수
기능: 프로토콜은 클라이언트와 서버가 통신을 설정하는 방식을 정합니다. Shadowrocket의 Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2는 서로 다른 서버 설정에 대응합니다. 이름만으로 특정 프로토콜이 모든 네트워크에서 더 빠르거나 배터리를 덜 소모한다고 판단할 수는 없습니다.
위치 및 설정 방법: Home에서 Add Server를 열고 보유한 서버 정보에 맞는 유형을 선택하세요. 기존 항목을 편집할 때는 먼저 유형을 확인한 다음 주소, 포트, 인증 정보, 서버에서 요구하는 전송 방식 및 TLS 옵션을 하나씩 점검합니다. 구독을 가져오면 보통 해당 정보가 입력되지만, 클라이언트가 인식한 유형이 원본 정보와 일치하는지도 확인해야 합니다. 유형에 따라 표시되는 입력 항목이 다른 것은 정상입니다. 한 프로토콜의 매개변수를 다른 프로토콜에 그대로 입력하지 마세요.
주의사항: 포트가 같다고 같은 프로토콜인 것은 아니며 TLS를 활성화했다고 인증서 및 호스트 이름 요구 사항이 모두 충족되는 것도 아닙니다. 테스트를 통과시키려고 인증서 검사를 임의로 완화하지 마세요. 먼저 서버 이름, 시스템 시간, 서버에서 제공한 매개변수를 확인하세요. 각 항목의 의미와 선택 기준은 프로토콜 참고 안내를 확인하세요. 인증 정보가 포함된 스크린샷이나 로그를 공유하기 전에는 민감한 내용을 삭제하세요.
서버 정보 관리
Subscribe 및 서버 목록
기능: Subscribe는 사용자가 보유한 구독에서 서버 정보를 가져옵니다. Add Server에서는 서버 정보를 직접 입력할 수 있습니다. 서버 목록은 사용할 연결 대상을 관리하며 완전한 규칙 구성과 같은 것은 아닙니다. 구독 업데이트에 성공했다는 것은 정보를 가져와 해석했다는 뜻일 뿐, 목록의 모든 항목이 연결된다는 보장은 아닙니다.
위치 및 설정 방법: Config에서 Subscribe 관련 메뉴로 이동해 본인의 서비스 제공자로부터 받은 구독 URL을 입력하고 이름을 확인한 뒤 업데이트하세요. 그런 다음 Home으로 돌아가 목록을 확인합니다. 서버를 직접 추가하려면 Add Server를, QR 코드가 있다면 Scan QR Code를 사용하세요. 클립보드에서 가져오기 전에 내용이 본인의 서버 정보인지 확인하고, 저장 후 항목 유형과 개수가 예상과 일치하는지 점검하세요.
기존 목록을 관리할 때는 직접 추가한 항목과 구독 그룹을 용도별로 구분할 수 있는 이름으로 지정하는 것이 좋습니다. 새 항목을 먼저 테스트한 뒤 기존 항목을 삭제하세요. 구독으로 생성된 서버의 매개변수를 직접 수정하면 다음 업데이트 때 변경 내용이 덮어써질 수 있습니다. 개별 설정을 유지하려면 해당 항목의 출처와 업데이트 동작을 먼저 확인해 임시 변경을 영구 저장된 것으로 오해하지 않도록 하세요.
주의사항: 구독 URL에는 인증 정보가 포함되는 경우가 많으므로 비공개 정보로 취급하고 공개 게시판이나 로그에 올리지 마세요. 업데이트에 실패하면 현재 네트워크, URL의 전체 입력 여부, 서비스 유효성, 응답 형식을 차례로 확인하세요. 목록 전체를 반복해서 삭제하지 마세요. 메뉴 위치와 절차는 구독 가져오기 방법을 확인하세요.
구성 파일
Config 저장 및 활성화
기능: Config에서 구성 파일을 관리합니다. 파일에는 규칙, DNS 동작, 로컬 매핑 등이 포함될 수 있습니다. 파일 저장, 활성 파일 선택, Config 분기 모드로 전환은 서로 연관되어 있지만 각각 별개의 작업입니다. 설정을 바꿨는데도 효과가 없는 경우 이 세 항목을 따로 확인하세요.
위치 및 설정 방법: Config로 이동해 현재 활성 표시가 어느 파일에 해당하는지 확인한 뒤 편집하세요. 수정 전 사본을 보관하고 한 번에 동작 하나만 변경합니다. 예를 들어 도메인 규칙 하나를 바꾸고 저장한 뒤 활성화 여부를 확인하고 같은 대상을 테스트하세요. 구성을 가져올 때는 가져오는 내용이 서버 구독인지 구성 파일인지 구분하세요. 링크 모양만으로 용도를 판단하지 마세요.
주의사항: 원격 구성은 업데이트 과정에서 로컬 내용을 덮어쓸 수 있으므로 장기간 사용자 지정하기 전에 덮어쓰기 범위를 확인하세요. 구성의 General, Rule, Host, URL Rewrite는 각각 역할이 다르며 규칙 파일에 서버 주소만 들어 있는 것은 아닙니다. 출처가 불분명한 전체 구성을 현재 파일에 바로 덮어쓰지 마세요. 특히 DNS, 매핑, 주소 재작성에 영향을 주는 항목을 확인해야 합니다. 자세한 내용은 구성 파일 섹션별 기능을 참고하세요.
자동 연결 조건
On Demand 연결
기능: On Demand는 시스템이 지원하는 네트워크 조건에 따라 연결 동작을 시작해 네트워크를 전환할 때마다 스위치를 반복해서 조작할 필요를 줄여 줍니다. 연결을 시도할 시점을 처리하는 기능으로, 연결 후 트래픽을 어떻게 분기할지 정하는 Global Routing을 대신하거나 모든 원격 서비스의 정상 여부를 판단하지는 않습니다.
위치 및 설정 방법: 앱의 Settings에서 On Demand를 찾아 현재 플랫폼에 표시되는 조건을 확인하고 Wi-Fi, 셀룰러 네트워크 또는 지정 네트워크에 따른 동작을 설정하세요. 먼저 수동 연결이 정상인지 확인한 뒤 기능을 활성화하고, 대상 네트워크에 연결할 때와 벗어날 때, 화면을 잠근 뒤 다시 사용할 때를 각각 테스트하세요. 시스템에서 연결 구성을 확인하는 안내가 표시되면 내용을 읽고 확인을 완료하세요.
주의사항: 조건을 여러 개 바꾼 뒤 한 번만 테스트하지 마세요. 연결을 끈 뒤 다시 연결되는 현상이 있으면 먼저 On Demand가 계속 작동하는지 확인하고 다른 시스템 자동화 설정도 점검하세요. 백그라운드 작업, 네트워크 권한, 절전 정책은 시스템마다 다르므로 한 기기의 작동 시점을 모든 플랫폼에 동일하게 적용할 수는 없습니다.
트래픽 기록
Data 통계와 측정 범위
기능: Data에서 클라이언트가 기록한 트래픽을 확인하면 작업 중 데이터가 전송되었는지, 연결 전후에 눈에 띄는 변화가 있었는지 파악할 수 있습니다. 이 수치는 클라이언트의 통계 기준에 따른 것으로 서비스 계정의 사용량 정산 기록이 아니며 시스템의 셀룰러 데이터 사용량을 그대로 나타내지도 않습니다.
위치 및 설정 방법: Data를 열고 현재 통계 범위와 분류를 확인한 다음 업로드 및 다운로드 수치의 변화를 살펴보세요. 한 번의 작업을 진단하려면 먼저 현재 수치를 기록하고 불필요한 백그라운드 전송을 중단한 뒤 테스트 대상을 하나만 열어 작업 전후를 비교합니다. 통계를 초기화할 수 있는 화면이라면 필요한 기록을 먼저 저장하세요. 통계 초기화는 연결 문제를 해결하는 방법이 아닙니다.
주의사항: 프로토콜 오버헤드, 통계 시작 시점, 백그라운드 활동, 처리 범위에 따라 클라이언트 통계와 시스템 기록이 다를 수 있습니다. 연결 스위치가 켜져 있어도 처리 대상 요청이 없으면 데이터가 늘지 않을 수 있습니다. 데이터가 증가해도 페이지 리소스가 모두 정상적으로 로드되었다는 뜻은 아닙니다. 대상 접속 결과와 요청 기록을 함께 확인하세요.
자주 쓰는 옵션
Settings의 주요 항목
Settings에는 앱 동작과 일부 시스템 연동 옵션이 모여 있습니다. 아래 항목은 실제 화면에 표시되는 경우에만 해당합니다. 현재 플랫폼에 항목이 없다면 다른 기기의 스크린샷에서 같은 위치를 찾지 마세요. 변경 전 기존 값을 기록해 두면 문제가 생겼을 때 되돌릴 수 있습니다.
DNS: 이름 해석과 연결을 따로 확인하기
기능 및 위치: DNS는 도메인 이름을 주소로 변환합니다. 관련 옵션은 Settings의 DNS 항목과 구성 파일의 관련 설정에서 확인할 수 있습니다. 이름 해석에 성공해도 대상 포트에 연결할 수 있다는 보장은 없으며, 서버에 연결된다고 모든 도메인이 정상적으로 해석되는 것도 아닙니다.
설정 방법 및 주의사항: 현재 활성화된 구성에 DNS 동작이 지정되어 있는지 먼저 확인한 다음 전역 옵션을 살펴보세요. 두 곳을 동시에 바꾸면 어떤 설정이 적용됐는지 파악하기 어렵습니다. 기존 네트워크나 서비스 구성이 요구하는 해석 방식을 사용하고, 변경 후 대상 요청을 다시 실행하세요. 일부 도메인만 실패한다면 DNS 오류, 규칙 매칭 오류, 연결 오류를 구분하세요. 모든 문제를 DNS 탓으로 돌리지 마세요. IPv6 옵션은 로컬 네트워크의 실제 지원 여부와 함께 확인해야 합니다.
Test Method: 테스트 방식 선택
기능 및 위치: Test Method는 Settings에서 연결 테스트 방식을 지정하는 옵션입니다. 방식마다 확인하는 연결 구간이 다르므로 표시된 결과를 서로 섞어 비교하지 마세요.
설정 방법 및 주의사항: 현재 화면에서 지원하는 항목 중 하나를 선택한 다음 서버 목록으로 돌아가 Connectivity Test를 실행하세요. 서버 여러 개를 비교할 때는 테스트 방식, 네트워크, 테스트 대상을 동일하게 유지하세요. 테스트 결과는 당시 조건에서 한 번 관찰한 결과일 뿐 지속적인 대역폭을 보장하지 않습니다. 테스트에 성공해도 실제로 필요한 대상에 접속해 확인해야 합니다.
Today Widget: 시스템 바로가기
기능 및 위치: Today Widget은 시스템 위젯과 연동되는 빠른 작업 설정입니다. 해당 항목을 지원하는 기기에서는 Settings에서 확인할 수 있습니다. 바로가기만 제공하며 서버나 규칙을 새로 만들지는 않습니다.
설정 방법 및 주의사항: 먼저 앱에서 정상적으로 연결한 다음 시스템의 위젯 관리 방법에 따라 사용할 수 있는 위젯을 추가하세요. 위젯 상태가 실제 연결과 다르게 표시되면 연속해서 누르지 말고 앱을 열어 연결 상태를 확인하세요. 시스템 위젯 지원 범위와 갱신 시점은 다를 수 있으므로 현재 시스템 화면을 기준으로 하세요.
iCloud: 동기화 범위와 로컬 사본
기능 및 위치: iCloud 옵션이 제공되는 Apple 기기에서는 Settings에서 동기화 설정을 확인하고, 시스템에서 앱의 iCloud 사용을 허용했는지도 점검하세요. 이 기능은 시스템 계정과 권한에 따라 작동하며 모든 플랫폼에서 사용할 수 있는 동기화 방식은 아닙니다.
설정 방법 및 주의사항: 활성화하기 전에 로컬 구성 사본을 보관하고 화면에 표시된 동기화 범위를 확인하세요. 서버, 구성, 시스템 연결 권한, 현재 연결 상태가 모두 함께 이전된다고 가정하지 마세요. 기기를 교체한 뒤에는 목록, 활성 구성, 연결 권한을 각각 확인하세요. 두 기기에서 동시에 편집하기 전에 동기화가 완료되었는지 확인해 이전 사본이 최신 내용을 덮어쓰지 않도록 합니다.
문제 원인 찾기
Diagnostics 및 문제 해결 순서
기능 및 위치: Diagnostics는 네트워크 및 연결 문제를 확인하는 데 도움을 줍니다. Settings에서 현재 플랫폼에 제공되는 진단 메뉴를 찾으세요. 서버 목록의 Connectivity Test로 연결을 테스트할 수 있습니다. 진단 기록은 원인을 찾기 위한 참고 자료이며 잘못된 프로토콜 매개변수나 만료된 서비스 정보를 자동으로 수정하지 않습니다.
확인 방법: 설정을 여러 개 바꾸는 것부터 시작할 필요는 없습니다. 서버 하나와 테스트 대상 하나를 정하고 아래 순서대로 진행하세요. 각 단계를 마칠 때마다 결과를 기록한 뒤 다음 단계로 넘어갈지 결정하면 여러 변경 사항을 같은 원인으로 오해하는 일을 막을 수 있습니다.
- 기본 네트워크 확인. 기기가 현재 네트워크에 접속하기 전에 인증이 필요한지, 시스템 시간이 정확한지 확인하세요. 필요하면 기존에 사용할 수 있는 다른 네트워크와 비교합니다.
- 서버 테스트.
Test Method를 동일하게 유지하고Connectivity Test를 실행하세요. 모두 실패하면 먼저 네트워크와 구독 유효성을 확인하고, 일부만 실패하면 해당 항목을 우선 점검하세요. - 프로토콜 항목 확인. 서버 이름만 보지 말고 주소, 포트, 인증 정보, 전송 방식, TLS 매개변수를 하나씩 확인하세요.
- 분기 설정 영향 구분. 현재 모드를 기록하고
Config와Proxy를 잠시 비교한 뒤 원래 설정으로 되돌리세요. 결과가 다르면 규칙과 정책 참조를 이어서 확인합니다. - 개별 요청 확인. 진단 기록이나 요청 기록에서 확인할 수 있는 대상, 해석 결과, 정책, 오류 정보를 살펴보세요. 페이지 리소스 일부만 실패하는 경우 해당 도메인을 따로 분석해야 합니다.
- 최근 변경 사항 되돌리기. 가장 최근에 수정한 DNS, 규칙 또는 구성 사본을 복원한 뒤 같은 대상을 테스트하세요. 원인을 찾기 위해 모든 설정을 초기화하지 마세요.
주의사항: 로그에는 서버 주소, 접속 대상, 인증 정보가 포함될 수 있으므로 외부에 공유하기 전에 민감한 내용을 하나씩 삭제하세요. 한 번의 테스트에서 지연 시간이 낮게 나온다고 실제 다운로드 속도나 모든 앱의 사용 경험이 보장되는 것은 아닙니다. 연결 실패에 대한 자세한 점검 방법은 노드 시간 초과 문제 해결 순서를 참고하세요.