도메인 및 요청 특성
DOMAIN은 지정한 도메인과 일치합니다. DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인에 일치합니다. DOMAIN-KEYWORD는 지정한 문자열이 포함된 도메인과 일치하므로 이름이 비슷한 다른 사이트까지 매칭될 수 있습니다. USER-AGENT는 식별 가능한 요청 필드에 적용되며, 일반적인 앱 식별 규칙으로 사용하면 안 됩니다.
Shadowrocket 공식 매뉴얼
먼저 Global Routing에서 트래픽 처리 방식을 정한 다음 필요에 따라 규칙, 서버, On Demand를 조정합니다. 아래 설명은 iPhone / iPad 화면을 기준으로 합니다. 다른 플랫폼에서는 해당 버전에 표시되는 메뉴와 항목을 확인하세요.
Home → Global Routing에서 모드를 선택한 뒤 Home으로 돌아와 현재 모드와 연결 스위치를 확인합니다. 두 설정의 역할은 다릅니다. 연결 스위치는 클라이언트가 트래픽을 처리할지 결정하고, Global Routing은 처리 대상으로 지정된 트래픽을 어떻게 다룰지 정합니다. 변경 사항을 확인하려면 요청을 새로 시작하세요. 이미 열려 있는 페이지로 판단하지 마세요.
| 모드 | 트래픽 처리 방식 | 사용 상황 | 설정 후 확인 사항 |
|---|---|---|---|
| Config(구성) | 현재 Config에 설정된 규칙에 따라 정책을 선택합니다. | 한 연결에서 일부 대상은 직접 연결하고 나머지는 프록시로 보내려는 경우 | 활성화된 Config, 처음 일치하는 규칙, FINAL을 확인합니다. |
| Proxy(프록시) | 처리 대상으로 지정된 트래픽을 프록시로 보내며 Config 규칙별로 라우팅하지 않습니다. | 같은 대상을 이용해 선택한 서버에서 프록시 연결을 설정할 수 있는지 잠시 확인할 때 | 먼저 Home에서 서버를 확인하고 테스트가 끝나면 원래 모드로 되돌립니다. |
| Direct(직접 연결) | 처리 대상으로 지정된 트래픽을 프록시를 거치지 않고 현재 네트워크에서 직접 보냅니다. | 문제가 프록시 경로에 있는지 현재 네트워크에 있는지 확인할 때 | Direct는 연결을 끄는 설정이 아닙니다. 클라이언트가 트래픽을 처리하지 않는 상태를 테스트하려면 연결 스위치를 별도로 끄세요. |
특정 대상만 점검하려면 네트워크와 대상을 그대로 두고 한 번에 모드 하나만 바꾸세요. Proxy에서는 접속되지만 Config에서는 안 된다면 규칙이 일치하는지, 해당 정책에 연결된 서버가 무엇인지 먼저 확인하세요. DNS와 서버를 동시에 바꾸지 마세요.
규칙은 일치 조건과 일치 후 적용할 정책으로 구성됩니다. Config에서 현재 활성화된 구성 파일을 확인한 다음 해당 파일의 규칙 편집 화면으로 이동합니다. 변경하기 전에 기존 규칙과 순서를 기록하고, 수정 후 저장한 뒤 Home에서 Global Routing이 Config인지 확인하세요. 규칙을 여러 묶음 한꺼번에 가져오기보다 구체적인 규칙 하나부터 테스트하면 결과를 확인하기 쉽습니다.
DOMAIN은 지정한 도메인과 일치합니다. DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인에 일치합니다. DOMAIN-KEYWORD는 지정한 문자열이 포함된 도메인과 일치하므로 이름이 비슷한 다른 사이트까지 매칭될 수 있습니다. USER-AGENT는 식별 가능한 요청 필드에 적용되며, 일반적인 앱 식별 규칙으로 사용하면 안 됩니다.
IP-CIDR은 IPv4 대역에, IP-CIDR6은 IPv6 대역에 일치합니다. GEOIP는 대상 IP의 지리적 분류를 기준으로 매칭하며, 웹사이트 운영자의 소재지를 뜻하지 않습니다. 도메인의 DNS 응답은 네트워크에 따라 달라질 수 있으므로 주소 기반 매칭 결과도 달라질 수 있습니다.
PROXY는 프록시를 사용하고, DIRECT는 직접 연결하며, REJECT는 요청을 거부합니다. Config에 정의된 정책 그룹을 지정할 수도 있습니다. 프록시 규칙에 일치했는데도 접속되지 않는다면 먼저 정책이 어느 서버를 가리키는지, 해당 서버에 연결할 수 있는지 확인하세요.
규칙은 순서대로 검사하며 일반적으로 처음 일치하는 규칙이 적용됩니다. 아래 예시에서는 첫 번째 규칙이 status.example.com을 직접 연결하고, 두 번째 규칙이 같은 도메인의 나머지 대상을 프록시로 보냅니다. 앞선 규칙과 일치하지 않는 트래픽은 FINAL에서 처리합니다. 앞의 두 규칙 순서를 바꾸면 구체적인 하위 도메인이 범위가 더 넓은 접미사 규칙과 먼저 일치해 직접 연결 예외가 적용되지 않습니다.
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
이 예시는 규칙의 매칭 순서만 보여 주며 전체 Config는 아닙니다. 저장한 뒤 예외 규칙에 일치해야 하는 대상과 프록시를 사용해야 하는 대상을 각각 테스트하세요. 페이지에서 다른 도메인도 요청한다면 메인 페이지 요청과 구분해 확인하세요. 페이지를 한 번 열어 본 결과만으로 모든 규칙의 동작을 판단하지 마세요.
구독과 수동 추가는 입력 방식이 서로 다릅니다. 사용 중인 구독 URL이 있다면 Home에서 Add Server를 열고 유형을 Subscribe로 설정한 다음 원본 URL을 입력해 저장하세요. 목록에 예상한 항목이 표시되는지 확인합니다. 서버 하나의 설정 정보를 가지고 있다면 Add Server에서 받은 정보와 맞는 프로토콜 유형을 선택하고 주소, 포트 및 필요한 항목을 입력하세요. Scan QR Code를 사용하는 경우에도 스캔 후 인식된 유형과 주소를 확인해야 합니다.
구독을 업데이트하면 해당 구독에 포함된 항목이 새로고침됩니다. Home에서 구독을 찾아 업데이트를 실행한 뒤, 기존에 선택한 서버가 목록에 남아 있는지 확인하세요. 같은 URL을 중복으로 가져오면 목록에서 항목을 구분하기 어려울 수 있습니다. 업데이트에 실패하면 먼저 URL 전체가 입력됐는지, 현재 네트워크에서 구독에 접속할 수 있는지 확인한 다음 필요한 조치를 검토하세요. 프록시 서버 목록과 Config는 별개입니다. 서버 목록을 업데이트해도 현재 규칙 구성이 바뀌는 것은 아닙니다.
가져오기에 성공해도 서버를 사용할 수 있다는 뜻은 아닙니다. Home에서 선택한 서버의 Connectivity Test를 실행하고 테스트 방법과 결과를 기록한 다음, 확인된 대상으로 실제 연결을 테스트하세요. 테스트에 실패하면 먼저 프로토콜 유형과 포트를 확인하고 해당 프로토콜에서 요구하는 인증 항목을 살펴보세요. 문제를 정리할 때 스크린샷이나 로그에 구독 URL, 인증 정보, 개인 서버 주소가 노출되지 않도록 가리세요. 프로토콜 항목의 의미는 기술 참고 자료에서, 첫 연결 순서는 사용 가이드에서 확인할 수 있습니다.
On Demand는 시스템이 어떤 조건에서 연결을 시작할지 정하고, Global Routing은 연결된 뒤 트래픽을 처리하는 방식을 정합니다. 먼저 서버와 라우팅 모드를 수동으로 확인한 다음 Settings → On Demand에서 조건부 연결을 설정하세요. 기능을 켠 뒤에는 네트워크 유형처럼 조건 하나만 설정합니다. 저장 후 해당 네트워크로 전환하고 같은 대상으로 요청을 새로 시작한 다음 Home에서 실제 연결 상태를 확인하세요.
수동으로 연결을 끊은 뒤 다시 연결되면 현재 네트워크가 여전히 조건에 해당하는지 확인하세요. 원치 않는 재연결을 점검할 때는 On Demand를 잠시 끈 뒤 수동으로 연결과 해제를 반복해 조건에 따른 재연결인지 연결 자체의 불안정인지 구분할 수 있습니다. 조건 하나의 동작을 확인한 다음 다른 조건을 추가하세요.
Data에서 클라이언트에 기록된 트래픽을 확인합니다. 수치를 확인하기 전에 페이지에 표시된 통계 범위와 기간을 살펴보고 송신량과 수신량을 비교하세요. 두 모드를 비교하려면 같은 네트워크에서 테스트 전후의 수치를 기록하고 동일한 작업을 각각 실행하세요. 서로 다른 통계 기간의 누적 합계를 그대로 비교하지 마세요.
Data의 통계 기준은 시스템의 셀룰러 데이터 통계나 서비스 제공업체의 과금 기록과 다릅니다. 백그라운드 동기화, 캐시, 자동 재시도도 테스트 수치에 영향을 줄 수 있습니다. 페이지에 초기화 기능이 있다면 초기화 전에 보관해야 할 값을 기록하세요. 초기화 후에는 이전 수치와 비교할 수 없습니다.
한 번에 설정 하나만 바꾸고 기존 값을 기록한 뒤 같은 대상으로 확인하세요. 네트워크를 전환한 뒤 문제가 발생했다면 전환 전후의 연결 상태를 먼저 기록하고 관련 설정을 조정하세요.
DNS는 도메인을 IP 주소로 변환합니다. Settings에서 DNS 관련 옵션을 확인하세요. 현재 Config에도 DNS 설정이 있다면 함께 살펴봅니다. 어떤 DNS 설정을 사용해야 하는지 명확히 알고 있을 때만 변경한 뒤, 기존에 접속되지 않았던 도메인으로 다시 테스트하세요. 로컬 네트워크의 도메인은 현재 네트워크의 DNS 서버가 필요할 수 있으므로 다른 DNS 서버를 사용하면 접속되지 않을 수 있습니다.
Settings의 Test Method에서 테스트 방식을 선택한 뒤 Home으로 돌아와 Connectivity Test를 실행하세요. 서버를 비교할 때는 테스트 방식, 네트워크, 테스트 대상을 동일하게 유지합니다. 방식에 따라 확인하는 연결 단계가 다를 수 있고, 표시되는 시간은 다운로드 속도가 아닙니다. 테스트에 성공해도 실제 대상으로 다시 확인해야 합니다.
Settings에서 Today Widget 관련 옵션을 확인하세요. 기기에서 해당 기능을 지원한다면 시스템의 위젯 편집 화면에서 추가합니다. 위젯은 상태를 빠르게 확인하거나 제공되는 제어 기능을 사용하는 데 적합합니다. 위젯 표시가 예상과 다르면 Home의 연결 상태와 Global Routing 모드를 기준으로 확인하세요.
기기가 필요한 Apple 계정을 사용 중인지, 시스템에서 앱의 iCloud 사용이 허용되어 있는지 먼저 확인한 다음 Settings에서 iCloud 옵션과 동기화 범위를 살펴보세요. 처음 동기화를 켤 때는 두 기기에서 같은 설정을 동시에 수정하지 마세요. 동기화 후 각 기기에서 선택된 Config와 서버를 확인하세요. 동기화는 전체 백업이 아니며 다른 기기가 연결되었다는 뜻도 아닙니다.
Settings에서 Diagnostics를 열고 현재 네트워크, Global Routing 모드, 문제가 발생한 시간을 기록한 뒤 오류를 한 번 재현하세요. 오류가 DNS 조회, 프록시 연결, 대상 요청 중 어느 단계에서 발생했는지 먼저 구분한 다음 관련 설정 하나만 조정합니다. 진단 내용을 공유하기 전에 구독 URL, 서버 주소 또는 개인적으로 접속한 대상이 드러나는 정보를 삭제하세요.
iPhone / iPad 버전은 App Store 제품 페이지에서 받을 수 있으며, $2.99 일회성 결제입니다. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 확인하세요. 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 확인하세요.
Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료이며 설치 파일은 이 사이트의 /dl/에서 제공합니다. 기기에 맞는 버전을 선택하고 첫 실행 안내를 확인하려면 다운로드와 설치 페이지를 방문하세요.
앱을 한 번 구매하는 것과 네트워크 서비스 이용권은 다릅니다. Shadowrocket은 이미 보유한 구독 또는 서버 정보를 사용합니다. 이 사이트는 노드나 구독을 제공하거나 판매하거나 추천하지 않습니다.