Shadowrocket 공식 매뉴얼
Shadowrocket 기능 및 설정
연결 모드, 규칙, 서버, 자동 연결 조건을 구분해 설정을 이해하세요. 먼저 변경할 항목을 정한 뒤 해당 설정만 조정하면 원인을 파악하기 쉽습니다.
- Global Routing · 연결 모드
- Config · 요청 처리 방식
- On Demand · 연결 조건
Global Routing: 연결 모드 선택
기능: Global Routing은 요청을 어떤 방식으로 처리할지 정합니다. 설정 기반 모드는 Config, 프록시 모드는 Proxy, 직접 연결 모드는 Direct입니다. Home의 연결 스위치와는 역할이 다릅니다. 스위치는 연결을 켜고 끄며, Global Routing은 연결을 켠 뒤 앱에 들어온 요청을 처리하는 방식을 정합니다.
위치와 설정 방법: Home에서 Global Routing을 찾아 원하는 모드를 선택합니다. 평소 도메인이나 대상 주소별로 경로를 나누려면 Config를 선택하고, Config 화면에서 의도한 구성 파일이 선택되어 있는지 확인하세요. 현재 서버가 대상에 연결되는지만 잠시 확인하려면 Proxy로 전환하고, 기기의 일반 네트워크 연결과 비교하려면 Direct를 사용할 수 있습니다.
| 모드 | 처리 방식 | 사용 상황 | 유의 사항 |
|---|---|---|---|
| 설정 · Config | 현재 구성의 규칙과 정책에 따라 요청을 처리합니다. | 일반적인 규칙 라우팅에 사용하며 PROXY, DIRECT 또는 REJECT 정책을 적용합니다. | 활성 구성, 규칙 순서, 마지막으로 일치한 항목을 확인하세요. |
| 프록시 · Proxy | 프록시 처리 대상인 요청을 선택한 서버로 전달합니다. | 서버 연결을 잠시 확인하거나 특정 라우팅 규칙의 영향을 배제할 때 사용합니다. | 모든 시스템 트래픽이 반드시 서버를 거친다는 뜻은 아닙니다. |
| 직접 연결 · Direct | 기기의 네트워크를 통해 대상에 직접 연결합니다. | 네트워크 연결 여부를 확인하고 문제가 프록시 경로와 관련 있는지 비교합니다. | 연결 스위치를 끄는 기능이 아니며 시스템 네트워크 설정을 대신하지 않습니다. |
유의 사항: 모드를 바꾼 뒤 대상 요청을 다시 보내 결과를 확인하세요. 브라우저 캐시, 기존 연결, 앱의 백그라운드 작업은 이전 상태를 유지할 수 있으므로 한 번 새로고침한 결과만으로 규칙이 적용되지 않았다고 판단하면 안 됩니다. 점검이 끝나면 원래 모드로 되돌리세요. 특히 임시로 선택한 Proxy를 Config 규칙 라우팅으로 혼동하지 않도록 주의하세요.
규칙 라우팅: 일치 조건과 처리 정책
기능: 규칙은 일치 유형, 조건, 정책으로 구성됩니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 도메인 접미사를 기준으로 요청을 찾은 뒤 PROXY 정책으로 처리한다는 뜻입니다. 일치 유형은 “어떤 요청을 찾을지”, 정책은 “일치한 요청을 어떻게 연결할지”를 정하므로 각각 확인해야 합니다.
위치와 설정 방법: Config에서 현재 사용 중인 구성을 확인하고, 수정 전에 사본을 저장하세요. 특정 도메인의 경로를 지정하려면 단일 도메인 전체를 대상으로 할지 도메인 접미사 전체를 대상으로 할지 먼저 정한 다음 DOMAIN 또는 DOMAIN-SUFFIX를 선택합니다. 일반적으로 구체적인 규칙을 더 포괄적인 규칙보다 앞에 둡니다. 앞선 규칙에 일치하지 않는 요청에 적용되는 FINAL은 목록 마지막에 배치하세요.
| 유형 | 일치 대상 | 사용 범위 |
|---|---|---|
DOMAIN | 전체 도메인 이름입니다. | 특정 호스트 이름 하나만 처리할 때 적합합니다. |
DOMAIN-SUFFIX | 도메인과 하위 도메인입니다. | 단일 도메인 전체보다 넓은 범위를 대상으로 합니다. |
DOMAIN-KEYWORD | 도메인 이름에 포함된 키워드입니다. | 이름은 비슷하지만 용도가 다른 도메인까지 일치할 수 있습니다. |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 주소 대역입니다. | 웹페이지 도메인만 보지 말고 주소 대역과 실제 대상을 확인해야 합니다. |
GEOIP | IP 주소의 지리적 위치 정보입니다. | 사용하는 데이터베이스와 주소 해석 결과에 따라 달라집니다. |
FINAL | 앞선 규칙에 일치하지 않은 요청입니다. | 최종 연결 경로를 정하므로 구체적인 규칙보다 앞에 두지 마세요. |
아래 예시는 규칙 순서를 이해하기 위한 것으로, 완전한 구성이나 사용 가능한 서버를 포함하지 않습니다. 예시 도메인 example.com은 실제 연결 경로를 의미하지 않습니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
유의 사항: PROXY는 프록시 정책으로 전달, DIRECT는 기기에서 직접 연결, REJECT는 요청 거부를 뜻합니다. REJECT를 선택한 뒤 접속할 수 없다면 규칙이 의도대로 작동한 결과일 수 있습니다. 한 페이지가 여러 도메인에 요청을 보낼 수도 있으므로 주 도메인에만 규칙을 추가해 모든 리소스를 처리할 수 있는 것은 아닙니다. 키워드 범위를 계속 넓히기보다 연결 기록에서 실제 요청을 확인하세요.
Subscribe 및 Add Server: 연결 정보 관리
기능: 서버 항목에는 연결에 필요한 주소, 포트, 프로토콜, 인증 정보가 저장됩니다. Subscribe는 여러 서버 정보를 관리하고 업데이트하는 기능입니다. 구독 업데이트와 Config 업데이트는 별개의 작업입니다. 서버 목록을 새로고침해도 규칙 파일이 바뀌는 것은 아니며, 구성을 가져왔다고 해서 올바른 서버가 선택되는 것도 아닙니다.
위치와 설정 방법: Home에서 Add Server를 선택해 보유한 서버 정보를 직접 입력합니다. 실제 프로토콜에 맞는 항목을 확인하고 다른 프로토콜의 값을 그대로 입력하지 마세요. 보유한 구독을 Subscribe로 추가할 때는 링크 전체를 붙여넣고 저장한 다음, 항목이 원하는 그룹에 들어갔는지 확인합니다. QR 코드나 공유 정보가 있다면 Scan QR Code 또는 해당 가져오기 메뉴를 사용하세요. 가져온 뒤에도 서버 유형과 연결 정보를 확인해야 합니다.
Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard, HTTP, SOCKS5 등의 프로토콜은 필요한 입력 항목이 서로 다릅니다. TLS, 전송 방식, 추가 옵션은 보유한 서버의 실제 설정을 기준으로 입력하세요. 표시 이름만 바꿔도 연결 대상은 바뀌지 않습니다. 익숙하지 않은 항목은 원래 정보를 먼저 보존한 뒤 하나씩 확인하고, 이름만 보고 용도를 추측하지 마세요.
유의 사항: 구독을 업데이트하기 전에 현재 선택된 항목을 기록하고, 업데이트 후에도 해당 항목이 남아 있는지 확인하세요. 여러 구독에 같은 이름의 항목이 있으면 이름만으로 중복이라고 단정하지 말고 그룹별 출처를 확인한 뒤 유지하거나 삭제하세요. Connectivity Test는 초기 확인에 유용하지만 테스트를 통과해도 모든 대상에 접속할 수 있다는 뜻은 아닙니다. 그룹을 삭제하기 전에 백업하고, 구성 파일과 공유 링크에 포함된 인증 정보도 공개하지 마세요.
이 사이트는 서버나 구독을 제공·판매·추천하지 않습니다. 앱의 일회성 구매와 서버 이용 요금제는 별개이므로 앱 구매와 보유한 서버의 이용 조건을 따로 확인하세요. 가져오기, 업데이트, 정리 방법은 구독 및 서버 관리 안내서를 참고하세요.
On Demand: 조건에 따라 연결 실행
기능: On Demand는 네트워크 등의 조건에 따라 연결 동작을 실행합니다. 즉, “언제 연결할지”를 정하며 “요청을 어떤 정책으로 처리할지”를 정하는 기능은 아닙니다. 연결이 시작된 뒤 요청 경로는 당시의 Global Routing과 구성에 따라 결정되므로 On Demand가 규칙 라우팅을 대신하지는 않습니다.
위치와 설정 방법: Settings에서 On Demand 관련 항목을 찾으세요. 특정 Wi-Fi SSID에서 연결 상태를 다르게 하거나 Cellular에서 연결을 켜는 등 원하는 동작을 먼저 정한 뒤, 현재 화면에서 제공하는 조건에 맞춰 규칙을 설정합니다. Domain 조건을 사용할 때는 도메인 연결 조건에 대한 화면 설명을 확인하세요. Config의 DOMAIN-SUFFIX 규칙과는 다른 기능입니다.
- 먼저 수동으로 연결해 보유한 서버와 Config가 정상 작동하는지 확인합니다.
- 한 번에 조건 하나만 추가하고 해당 네트워크 환경과 예상 동작을 기록합니다.
- 조건에 맞는 환경으로 전환하고 시스템이 처리할 때까지 기다린 뒤 연결 상태를 확인하고 요청을 한 번 실행합니다.
- 예상대로 동작하는지 확인한 다음 다른 조건을 추가하고 조건이 겹치는지 살펴봅니다.
유의 사항: 시스템의 작업 처리, 네트워크 전환, 기존 연결에 따라 확인 시점이 달라질 수 있습니다. 수동으로 연결을 끊은 뒤 다시 연결되는 것은 스위치 오류가 아니라 On Demand 조건이 다시 충족된 결과일 수 있습니다. 문제를 확인할 때는 먼저 On Demand를 잠시 끄고 수동 연결을 테스트하세요. 기본 연결이 정상이라면 조건을 하나씩 다시 활성화합니다. 조건 조합은 On Demand 설정 안내에서 확인할 수 있습니다.
Data: 트래픽 및 연결 기록 확인
기능: Data에서는 앱이 기록한 트래픽 정보를 확인해 업로드, 다운로드, 연결 활동을 파악할 수 있습니다. 표시되는 값은 앱에서 확인할 수 있는 사용 내역이며, 이동통신사 요금 청구 내역이나 서버 서비스의 과금 기록과 동일하지 않습니다.
위치와 확인 방법: Data를 열고 화면에 표시되는 통계 범위, 기간, 분류 기준을 확인한 뒤 수치를 기록하세요. 특정 작업에서 발생한 트래픽을 확인하려면 작업 전 통계 상태를 기록하고 관련 없는 백그라운드 다운로드를 잠시 멈춘 다음, 작업을 한 번 수행해 변화를 비교합니다. 통계 초기화 기능이 있다면 필요한 데이터를 저장한 후 사용하세요.
유의 사항: 업로드와 다운로드 방향, 통계 시작 시점, 트래픽이 앱을 통과했는지에 따라 수치의 의미가 달라집니다. 네트워크나 서버를 바꾸기 전후의 누적값은 범위가 다를 수 있으므로 단순히 빼서 비교하지 마세요. 규칙 적용 여부는 실제 연결 기록을 확인해야 하며, 전체 트래픽이 늘었다고 특정 도메인이 PROXY를 거쳤다고 단정할 수 없습니다.
문제를 다른 사람에게 설명할 때는 발생 시각, 네트워크 유형, 대상 도메인, 선택한 정책 등 필요한 정보만 남기세요. 로그와 연결 세부 정보에는 서버 주소, 요청 경로, 인증 정보가 포함될 수 있으므로 공유 전에 민감한 내용을 확인하고 가리세요.
Settings: 주요 설정과 조정 범위
Settings에는 DNS, 테스트, 바로가기, 동기화, 진단 등 서로 다른 범위에 영향을 주는 항목이 있습니다. 일부 동작은 현재 Config에서 정의할 수도 있습니다. 실제 동작을 확인할 때는 구성 파일과 앱 설정을 함께 살펴보고 한 화면만으로 판단하지 마세요. 아래에서는 자주 하는 작업별 조정 방법을 안내하며, 사용 가능한 메뉴는 현재 앱 화면을 기준으로 확인하세요.
DNS: 도메인 이름 해석 확인
기능과 위치: DNS는 도메인 이름을 IP 주소로 변환합니다. Settings에서 DNS 관련 항목을 확인하고 Config에 dns-server 등의 설정이 있는지 살펴볼 수 있습니다. DNS 응답에 따라 같은 도메인도 서로 다른 주소에 연결될 수 있으며, 이는 IP 기반 규칙의 적용 결과에 영향을 줍니다.
설정 방법과 유의 사항: 현재 설정을 보존하고 문제가 발생한 도메인을 기록한 뒤, 이름 해석 문제인지 연결 문제인지 먼저 확인하세요. 해석 방식을 바꿀 때는 한 번에 한 항목만 수정하고 요청을 다시 보내 결과를 비교합니다. 익숙한 주소처럼 보인다는 이유만으로 임의로 바꾸지 말고, 모든 접속 실패를 DNS 문제로 단정하지 마세요. 대상 서버 장애, 규칙에 따른 거부, 기기 네트워크 이상도 비슷한 증상을 일으킬 수 있습니다.
Test Method: 같은 조건에서 테스트하기
기능과 위치: Test Method는 연결 테스트 방식을 정하며 Settings에서 확인할 수 있습니다. Connectivity Test의 진행 방식과 결과 해석에 영향을 주지만, 서버 설정을 자동으로 수정하거나 실제 서비스 속도를 보장하지는 않습니다.
설정 방법과 유의 사항: 서버 목록을 점검할 때는 확인 목적에 맞는 방식을 하나 선택하고 같은 네트워크 환경에서 테스트하세요. Test Method를 바꾼 뒤에는 이전 결과와 새 결과를 그대로 섞어 비교하지 않는 것이 좋습니다. 테스트가 실패하면 실제 대상에도 접속해 테스트 대상에 도달하지 못한 것인지 서버 연결 자체가 실패한 것인지 구분하세요.
Today Widget: 빠른 작업 바로가기
기능과 위치: Today Widget은 시스템 위젯과 관련된 바로가기 설정입니다. Settings에서 해당 항목을 찾은 다음 시스템에서 지원하는 위젯 영역에 추가하세요. 표시 여부와 실행 가능한 작업은 현재 시스템과 앱의 기능에 따라 달라집니다.
설정 방법과 유의 사항: 먼저 앱에서 수동 연결이 정상인지 확인한 뒤 표시할 바로가기를 설정하세요. 사용 후 Home으로 돌아가 실제 연결 상태를 확인하고 위젯에 남아 있는 표시를 최종 결과로 간주하지 마세요. 메뉴를 찾을 수 없다면 현재 시스템의 위젯 관리 방법을 확인하면 됩니다. 이 문제 때문에 기존 구성을 삭제할 필요는 없습니다.
iCloud 동기화: 동기화와 별도 백업 구분
기능과 위치: iCloud 동기화는 지원되는 기기 사이에서 앱이 지원하는 데이터를 동기화합니다. Settings의 관련 메뉴와 시스템 iCloud 설정에서 확인할 수 있습니다. 계정, 네트워크, 시스템 상태에 따라 작동하며 과거 각 시점의 구성 사본을 보관하는 백업과는 다릅니다.
설정 방법과 유의 사항: 먼저 원래 기기에서 필요한 데이터가 온전히 남아 있는지 확인한 다음 동기화를 켜세요. 다른 기기에서는 동기화 스위치만 보지 말고 실제 항목과 Config를 확인합니다. 대량 삭제나 정리 전에는 별도로 백업해 삭제 내용이 다른 기기에도 동기화되는 상황을 방지하세요. 복원이 완전하지 않다면 중복 항목을 만들지 않도록 반복해서 가져오기 전에 계정과 동기화 범위를 확인하세요.
Diagnostics: 재현 가능한 문제의 단서 수집
기능과 위치: Diagnostics는 네트워크와 연결 문제를 파악하는 진단 도구를 제공하며 Settings에서 찾을 수 있습니다. 진단 결과는 당시 네트워크, Global Routing, 서버, 대상 정보를 함께 고려해 해석해야 합니다. 단일 결과만으로 전체 원인을 판단하기는 어렵습니다.
설정 방법과 유의 사항: 먼저 문제를 재현하는 단계를 기록하고 관련 항목을 점검하세요. 매번 조건 하나만 바꾸고 변경 전후 결과를 보관합니다. 문제를 전달하기 전에 구독 링크, 비밀번호 등 인증 정보는 삭제하세요. 로그를 길게 만들려고 의미를 모르는 설정을 켜거나 진단 결과에 표시된 대상 주소를 사용 가능한 서버 정보로 오해하지 마세요.
설정 점검 순서: 수동 연결부터 자동 실행까지
“연결은 되지만 특정 페이지가 열리지 않음” 또는 “연결을 끊어도 다시 자동 연결됨” 같은 문제가 생기면 여러 설정을 동시에 바꾸기보다 항목별로 확인하는 편이 원인을 찾기 쉽습니다. 문제를 재현할 수 있는 구성 사본을 보관해 이후 변경 사항을 비교할 기준으로 삼으세요.
- 기본 네트워크 확인: 현재 Wi-Fi 또는 Cellular가 정상적으로 연결되는지 확인하고 문제가 발생한 네트워크 환경을 기록합니다.
- 서버 확인: Home에서 실제로 선택된 항목, 프로토콜, 연결 정보를 확인해 이름이 비슷한 항목을 혼동하지 않도록 합니다.
- 연결 모드 확인: Global Routing을 확인합니다. 규칙 라우팅을 사용하려면 Config를 선택하고 의도한 구성이 활성화되어 있는지 확인하세요.
- 요청 경로 확인: 연결 기록에서 대상 도메인, 일치 조건, 정책을 확인한 뒤 DNS와 규칙 순서를 살펴봅니다.
- 자동 연결 조건 확인: 수동 연결이 안정적으로 작동한 뒤 On Demand를 다시 활성화하고 트리거 조건을 하나씩 확인합니다.
처음 사용한다면 시작 안내에 따라 가져오기, 연결 모드 선택, 연결 확인을 진행하세요. 구독 업데이트, 중복 항목, 백업을 관리하려면 서버 관리를 참고하세요. 이 페이지에서는 각 기능의 역할을 설명하며, 구체적인 문제는 자주 묻는 질문에서 항목별로 확인할 수 있습니다.