공식 가이드 · 기능 및 설정
Shadowrocket 기능 및 설정
Global Routing에서 트래픽 경로를 선택하고 On Demand에서 연결 시점을 설정합니다. 이 페이지는 iPhone / iPad 화면을 기준으로 설명하며, 다른 플랫폼에서는 각 클라이언트에 표시되는 옵션을 확인하세요.
- Config설정 · 규칙에 따라 정책 선택
- Proxy프록시 · 선택한 서버 사용
- Direct직접 연결 · 프록시 서버를 거치지 않음
01 라우팅 모드
Global Routing: Config, Proxy, Direct
Home에서 Global Routing을 열고 Config, Proxy 또는 Direct를 선택합니다. 이 옵션은 Shadowrocket으로 들어오는 트래픽의 경로를 결정하며, 연결을 켜고 끄는 설정은 아닙니다. 모드만 전환해도 연결이 자동으로 시작되지는 않습니다. 모드를 선택한 뒤 Home으로 돌아가 연결 상태를 확인하세요.
| 화면 옵션 | 트래픽 처리 방식 | 사용 상황 | 전환 전 확인 사항 |
|---|---|---|---|
Config(설정) |
현재 설정의 규칙에 따라 정책을 선택합니다. | 사이트나 주소마다 다른 경로를 사용해야 할 때 적합합니다. | Config에서 실제로 활성화된 파일과 규칙 순서를 확인하세요. |
Proxy(프록시) |
클라이언트로 들어오는 트래픽을 선택한 프록시로 보내며, 규칙에 따라 경로를 선택하지 않습니다. | 규칙의 영향을 잠시 배제하고 현재 서버가 테스트 요청을 처리할 수 있는지 확인할 때 적합합니다. | Home에서 테스트할 서버가 선택되어 있는지 확인하세요. |
Direct(직접 연결) |
클라이언트로 들어오는 트래픽이 프록시 서버를 거치지 않습니다. | 같은 요청의 직접 연결 결과를 기준으로 삼아 문제가 프록시 경로에서만 발생하는지 확인할 때 사용합니다. | 연결을 끄는 설정이 아닙니다. 연결을 끊으려면 Home의 연결 스위치를 사용하세요. |
같은 사이트가 Proxy에서는 열리지만 Config에서는 열리지 않는다면, 먼저 어떤 규칙이 일치했는지와 해당 규칙이 지정한 정책을 확인한 뒤 설정 변경 여부를 판단하세요. 두 모드에서 모두 실패한다면 규칙 전체를 먼저 재정렬하지 마세요. 현재 네트워크, 선택한 서버, 실제 테스트한 대상 주소부터 확인하세요. 비교할 때는 모드만 바꾸고 나머지 조건은 동일하게 유지하세요.
02 규칙 매칭 및 정책
규칙 기반 라우팅: 조건, 순서, 기본 처리
Config에서 사용할 설정을 열고 Rule 섹션을 확인합니다. 규칙 앞부분에는 매칭 조건을, 끝부분에는 일치했을 때 적용할 정책을 지정합니다. 예를 들어 PROXY는 프록시를 사용하고, DIRECT는 직접 연결하며, REJECT는 요청을 거부합니다. 설정을 적용한 뒤에는 Global Routing에서 Config를 선택해야 합니다. 그렇지 않으면 규칙을 수정해도 해당 모드의 경로는 바뀌지 않습니다.
요청 정보에 따라 규칙 유형 선택
DOMAIN은 호스트 이름을 정확히 일치시켜 특정 도메인 하나의 경로만 변경할 때 적합합니다.DOMAIN-SUFFIX는 도메인 접미사를 기준으로 매칭하므로 루트 도메인과 하위 도메인에 같은 정책을 적용할 수 있습니다.DOMAIN-KEYWORD는 도메인에 포함된 문자열을 기준으로 매칭합니다. 문자열이 짧을수록 원치 않는 도메인까지 매칭될 가능성이 높으므로 사용 전에 관련 없는 도메인이 포함되지 않는지 확인하세요.IP-CIDR과IP-CIDR6은 각각 IPv4와 IPv6 대역을 기준으로 매칭하고,GEOIP는 IP 주소의 지리적 분류를 기준으로 매칭합니다. 도메인 요청을 대상 IP 주소에 따라 판단해야 한다면 DNS 조회 결과도 확인하세요.USER-AGENT는 확인할 수 있는 요청 식별 정보를 기준으로 매칭하며, 앱 이름으로 트래픽을 식별하는 규칙은 아닙니다. 클라이언트에서 해당 필드를 가져올 수 없다면 이 규칙에 의존해 트래픽을 분리하지 마세요.
구체적인 규칙을 먼저, FINAL은 마지막에
규칙은 순서대로 평가되며, 처음 일치한 규칙이 적용할 정책을 결정합니다. 아래 예시는 예외 규칙의 동작을 보여 주기 위한 도메인입니다. 첫 번째 줄은 static.example.com만 직접 연결하고, 두 번째 줄은 같은 접미사를 가진 나머지 요청을 프록시로 보냅니다. 두 줄의 순서를 바꾸면 범위가 넓은 접미사 규칙이 먼저 일치해 구체적인 예외가 적용되지 않습니다.
DOMAIN,static.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
규칙 순서를 설명하기 위한 예시이며, 완전한 설정은 아닙니다. FINAL은 앞선 규칙과 일치하지 않은 요청만 처리합니다. 기본 처리로 DIRECT를 사용할지는 목록에 없는 대상을 어떻게 처리할지에 따라 결정하세요. 변경 전에 기존 설정을 저장하고, 테스트할 때는 명확히 일치하는 대상과 기본 처리로 넘어가야 하는 대상을 각각 하나 이상 확인하세요. REJECT로 차단하려면 범위가 명확한 도메인부터 시작해 로그인이나 정적 리소스에 필요한 요청까지 함께 막지 않도록 주의하세요.
03 연결 정보
Subscribe, Add Server 및 서버 선택
Home에서 등록된 서버 정보를 관리합니다. 구독 링크를 받았다면 서버 추가 메뉴에서 Add Server를 열고 유형으로 Subscribe를 선택한 뒤 전체 링크를 입력하고 저장하세요. 화면에 업데이트 기능이 있으면 구독을 새로고침한 다음 항목이 SERVER 목록에 표시되는지 확인합니다. 구독 링크에는 접속 자격 증명이 포함될 수 있으므로 전체 링크를 공개 게시물, 스크린샷 또는 진단 기록에 올리지 마세요.
개별 서버의 연결 정보를 받았다면 Add Server에서 안내된 프로토콜을 선택하고 주소, 포트 및 해당 프로토콜에 필요한 인증·전송 매개변수를 입력하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 입력 항목이 서로 다르므로 한 프로토콜의 매개변수를 다른 프로토콜에 적용하지 마세요. 저장한 뒤 Home으로 돌아가 SERVER에서 사용할 항목을 선택하고 Connectivity Test와 실제 접속으로 확인하세요.
구독 업데이트와 설정 파일 업데이트는 서로 다른 작업입니다. 전자는 서버 항목을 갱신하고, 후자는 규칙 매칭에 사용되는 내용을 변경합니다. 구독 업데이트 후 기존 항목이 교체되었다면 현재 선택한 서버를 다시 확인하세요. 설정에서 서버 이름이나 정책 그룹을 참조한다면 이름이 여전히 올바른 항목을 가리키는지도 확인해야 합니다. 구독 새로고침에 실패하면 먼저 업데이트 상태를 확인해 목록을 가져오지 못한 것인지 판단하세요. 기존 서버의 연결 문제와 구독 업데이트 문제를 한꺼번에 점검하지 마세요.
04 연결 조건
On Demand: 네트워크 조건에 따른 연결
On Demand는 시스템이 조건에 따라 연결을 시작할 시점을 제어하며, 요청을 프록시로 보낼지 직접 연결할지는 결정하지 않습니다. 먼저 Home에서 수동으로 연결해 시스템 연결 권한 설정이 완료되었고 서버를 사용할 수 있는지 확인하세요. 그런 다음 Settings에서 On Demand를 열고 화면에 제공되는 네트워크 조건을 설정합니다. 필요한 조건 하나만 먼저 활성화해 확인한 뒤 예외를 추가하면 어떤 설정이 연결 동작을 바꾸었는지 파악하기 쉽습니다.
예를 들어 셀룰러 네트워크로 전환했을 때만 자동 연결하려면 해당 네트워크 조건만 먼저 설정하세요. 저장한 뒤 Wi-Fi와 셀룰러 네트워크를 전환하면서 같은 테스트 대상을 사용해 전환 전, 전환 후, 원래 네트워크로 돌아온 뒤의 연결 상태를 각각 기록합니다. 설정 화면에서 스위치가 켜져 있는 것만으로는 조건이 실제로 작동했다고 볼 수 없습니다.
수동으로 연결을 끊더라도 기기가 자동 연결 조건을 계속 만족하면 시스템이 다시 연결할 수 있습니다. 수동 연결 해제의 효과를 확인하려면 테스트 전에 On Demand를 잠시 끄세요. 연결 상태는 예상대로지만 접속 경로가 잘못되었다면 자동 연결 조건을 반복해서 조정하기보다 Global Routing과 규칙을 확인하세요.
05 사용량 확인
Data: 트래픽 통계 확인
Data에서는 클라이언트에 기록된 트래픽을 확인할 수 있습니다. Data를 열고 먼저 통계 범위와 단위를 확인한 다음 송신량과 수신량을 구분하세요. 특정 작업의 사용량을 추정하려면 현재 수치를 기록하고 작업을 한 번만 실행한 뒤 수치가 갱신되면 전후 차이를 비교합니다. 테스트 중에는 다른 다운로드, 동기화 또는 미디어 재생을 피해야 관련 없는 요청이 통계에 포함되지 않습니다.
앱 통계, 시스템의 셀룰러 데이터 통계, 서비스 제공업체의 청구서는 집계하는 트래픽과 기간이 다를 수 있으므로 단순히 차감해 누락 여부를 판단하기 어렵습니다. 수치가 변하지 않는 것처럼 보이면 먼저 연결이 유지되고 있는지, 요청이 클라이언트를 통과했는지, 표시 정밀도로 변화를 확인할 수 있는지 점검하세요. 특정 요청이 규칙에 일치했는지 확인하려면 요청 기록을 살펴보세요. 총 트래픽만으로는 적용된 정책을 알 수 없습니다.
06 자주 쓰는 옵션
Settings: DNS, 테스트, 동기화 및 진단
문제 해결을 시작하기 전에 현재 설정, 서버, 라우팅 모드를 기록하세요. 한 번에 옵션 하나만 변경하고 같은 대상으로 다시 테스트합니다. 결과가 나아지지 않더라도 원래 값을 복원할 수 있어 연결 설정 전체를 다시 구성할 필요가 없습니다.
DNS: 현재 설정의 DNS 항목 확인
DNS는 도메인을 IP 주소로 변환하는 방식을 결정합니다. 현재 설정에 DNS 서버가 지정되어 있다면 Config에서 해당 파일의 General 섹션을 확인하세요. 예를 들어 dns-server가 설정되어 있는지 살펴봅니다. 설정을 확인하지 않은 채 문제 원인을 시스템 네트워크로 단정하지 마세요. 실제 DNS 문제가 있다면 기존 설정을 기록한 뒤 DNS 항목을 변경하고 같은 도메인을 다시 테스트합니다. 사용자 지정 DNS 서버는 현재 네트워크에서 접속할 수 있어야 합니다. 서버에 연결할 수 있다고 해서 대상 도메인도 반드시 조회되는 것은 아닙니다.
Test Method: 동일한 조건으로 연결 테스트
Settings에서 Test Method를 확인하고 화면에 제공되는 방식 중 하나를 선택한 다음 Home으로 돌아가 Connectivity Test를 실행하세요. 여러 항목을 비교할 때는 테스트 방식, 네트워크, 대상을 동일하게 유지해야 합니다. 테스트 성공은 해당 방식의 성공 조건을 이번 탐색이 충족했다는 뜻일 뿐, 모든 사이트에 접속할 수 있음을 보장하지 않습니다. 반대로 테스트 대상 하나에 접속하지 못했다고 해서 서버가 모든 대상에 연결할 수 없는 것은 아닙니다.
Today Widget: 상태 확인 및 빠른 작업
Settings에서 Today Widget을 찾아 앱에 표시되는 옵션에 따라 위젯 기능을 설정한 다음 시스템 위젯 화면에서 기기에 추가할 수 있는지 확인하세요. 위젯으로 작업을 실행한 뒤 Home으로 돌아가 연결 상태와 현재 서버를 확인합니다. 위젯은 빠른 작업을 제공하는 기능입니다. 탭한 뒤 곧바로 다시 연결된다면 먼저 On Demand 조건을 확인하세요.
iCloud: 기기 변경 전 동기화 범위 확인
Settings에서 iCloud 관련 옵션을 찾으세요. 동기화를 준비할 때는 두 기기가 같은 Apple 계정을 사용하고 있는지, 시스템에서 해당 iCloud 기능이 켜져 있는지 확인한 뒤 클라이언트에 실제로 표시되는 동기화 항목을 살펴봅니다. 기기를 바꾸기 전에 중요한 설정을 별도로 보관하세요. 새 기기에서는 서버 목록, 활성화된 설정, 연결 권한을 각각 확인합니다. 구입 항목 복원과 앱 데이터 동기화는 별개의 작업이므로 앱을 다시 설치했다고 기존 설정까지 복원되는 것은 아닙니다.
Diagnostics: 기록 시간으로 문제 찾기
Settings에서 Diagnostics 또는 화면에 표시되는 진단 메뉴를 열고 문제가 발생한 시간을 기록한 뒤 실패한 작업을 한 번만 재현하세요. 전후 기록을 살펴보고 도메인 조회 실패, 잘못된 규칙 정책, 연결 시간 초과를 먼저 구분한 다음 해당 설정을 점검합니다. 진단 정보를 전달해야 한다면 문제와 관련된 부분만 남기고 구독 링크, 인증 정보, 개인 주소는 삭제하세요. 점검을 위해 임시로 높인 기록 수준은 진단이 끝난 뒤 원래 값으로 되돌리세요.