Shadowrocket 공식 매뉴얼

Shadowrocket 기능 및 설정

먼저 트래픽 처리 방식을 확인한 다음 서버와 규칙을 선택하세요. 연결 후에는 Data와 Diagnostics에서 실제 결과를 확인할 수 있습니다.

  • Config 규칙에 따라 정책 선택
  • Proxy 현재 서버 사용
  • Direct 프록시를 거치지 않고 연결

Global Routing: 트래픽 처리 방식 선택

Home에서 Global Routing을 열고 구성에 따른 라우팅, 프록시 또는 직접 연결을 선택하세요. 화면에서는 각각 Config, Proxy, Direct로 표시됩니다. 이 설정은 클라이언트가 처리하는 트래픽의 전달 방식을 정하며, 연결을 켜고 끄거나 서버 정보를 바꾸지는 않습니다. 설정한 뒤 Home으로 돌아가 현재 모드를 확인하세요. 프록시 경로를 점검하려면 선택된 서버와 연결 상태도 확인해야 합니다.

화면 옵션처리 방식사용 상황먼저 확인할 항목
Config현재 구성의 규칙에 따라 적용할 정책을 선택합니다.요청마다 서로 다른 경로를 사용하려는 경우현재 활성화된 구성, 규칙 순서 및 기본 처리 방식
Proxy처리 대상 트래픽을 현재 프록시 서버로 전달합니다.서버 경로로 요청을 처리할 수 있는지 임시로 확인할 경우Home에서 선택한 서버가 올바른지 확인합니다.
Direct처리 대상 트래픽을 프록시 서버를 거치지 않고 연결합니다.직접 연결 결과와 비교해 문제가 프록시 경로에서 발생하는지 확인할 경우현재 네트워크를 사용할 수 있는지 확인합니다. 이 옵션은 연결을 끄는 설정이 아닙니다.

문제를 확인할 때는 같은 네트워크에서 같은 요청을 각각 테스트하세요. Proxy에서는 접속되지만 Config에서는 안 된다면 먼저 적용된 규칙과 정책을 확인하세요. Direct에서도 접속되지 않으면 현재 네트워크와 대상 서비스를 점검하세요. 테스트가 끝나면 평소 사용하는 모드로 되돌리세요.

Config와 Rule: 대상별 트래픽 라우팅

규칙은 매칭 조건과 일치 후 적용할 정책으로 구성됩니다. Config에서 사용 중인 구성을 찾아 먼저 되돌릴 수 있도록 사본을 보관한 뒤 Rule 항목을 수정하세요. 상황에 따라 DOMAIN은 전체 도메인과 일치시키고, DOMAIN-SUFFIX는 도메인 접미사와 일치시킵니다. DOMAIN-KEYWORD는 지정한 문자열이 포함된 도메인을 매칭하므로 범위가 더 넓습니다. 명확한 도메인 조건을 대신하는 용도로는 적합하지 않습니다.

IP 주소로 처리할 때는 IP-CIDR과 IP-CIDR6이 각각 IPv4와 IPv6 대역을 매칭합니다. GEOIP는 주소의 지리적 분류를 기준으로 매칭하며, 서버의 실제 위치를 확인해 주는 것은 아닙니다. USER-AGENT는 요청에서 확인할 수 있는 관련 정보에 의존하므로 모든 앱 트래픽을 식별하는 범용 방법이 아닙니다. 특정 도메인 테스트가 성공해도 같은 서비스에서 사용하는 다른 도메인까지 동일한 규칙에 매칭된다는 뜻은 아닙니다.

정책과 매칭 순서

PROXY는 일치한 트래픽을 프록시로 전달하고, DIRECT는 직접 연결하며, REJECT는 해당 요청을 거부합니다. 규칙은 순서대로 확인하며 먼저 일치한 규칙의 정책이 적용됩니다. 앞선 규칙에 일치하지 않을 때 FINAL이 적용됩니다. 아래 예시는 지정한 호스트를 먼저 직접 연결하고, 같은 접미사에 해당하는 나머지 요청은 프록시로 보낸 뒤, 그 외 요청은 직접 연결합니다. 예시 도메인은 문법 설명용입니다.

[Rule]
DOMAIN,assets.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

수정한 구성을 저장하고 활성화됐는지 확인한 다음 Global Routing으로 돌아가 Config를 선택하세요. 새 요청으로 예외 규칙과 기본 규칙을 각각 테스트합니다. 접미사 규칙을 전체 도메인 규칙보다 앞에 두면 예외가 접미사 규칙에 먼저 매칭될 수 있습니다. DNS, 현재 서버, 여러 규칙을 한꺼번에 바꾸지 마세요. 문제가 사라져도 어떤 변경이 영향을 줬는지 판단하기 어렵습니다. 자세한 항목은 구성 전체 안내를 참고하세요.

Home: 서버 및 Subscribe

서버 항목은 단일 엔드포인트에 연결하기 위한 정보이며, 구독은 기존 서버 항목을 묶어 가져오고 관리하는 기능입니다. 두 방식 모두 이미 본인의 구독 정보나 서버 정보를 보유한 경우에 사용할 수 있습니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 가져오기 전에 정보의 출처를 확인하고 링크, QR 코드 또는 인증 정보를 공개 페이지에 게시하지 마세요.

Add Server: 서버 하나 추가하기

Home에서 Add Server를 열고 제공된 정보에 표시된 프로토콜을 선택한 다음 주소, 포트, 인증 정보와 필요한 전송 매개변수를 원래 값 그대로 입력하세요. 프로토콜마다 입력 항목이 다르므로 서로 다른 프로토콜의 값을 그대로 적용할 수 없습니다. 확실하지 않은 값은 원본 정보와 대조하세요. 저장 후 Home으로 돌아가 SERVER에서 새 항목이 선택됐는지 확인하고 Connectivity Test를 실행한 뒤 실제 요청으로 확인하세요. 테스트 성공은 해당 탐색 요청에 응답이 왔다는 뜻일 뿐, 모든 대상에 접속할 수 있음을 보장하지 않습니다.

Subscribe: 목록 가져오기 및 업데이트

Add Server의 유형 옵션에서 Subscribe를 선택하고 본인의 구독 주소를 입력한 뒤 저장하세요. Home으로 돌아가 항목이 가져와졌는지 확인하고, 업데이트가 필요하면 해당 구독의 업데이트 기능을 사용하세요. 업데이트 후에는 현재 선택 항목을 다시 확인하세요. 원본 목록에서 항목이 삭제되거나 이름이 바뀔 수 있습니다. 원격 목록을 로컬 백업으로 간주하지 말고, 표시 이름만으로 두 항목이 같은 정보인지 판단하지 마세요. 처음 사용하는 경우 사용 가이드를 참고하세요.

On Demand: 네트워크 조건에 따라 연결 시작

On Demand는 시스템이 지정된 네트워크 조건을 감지했을 때 연결을 시작하거나 조정하는 기능입니다. 개별 요청의 라우팅 정책을 선택하는 기능은 아닙니다. Settings에서 On Demand를 열고 화면에서 제공하는 조건에 맞춰 Wi-Fi 또는 셀룰러 네트워크 동작을 설정하세요. 저장 후 Wi-Fi 연결, Wi-Fi 연결 해제, 원래 네트워크 복귀 시 각각 상태를 확인합니다. 기기에 시스템 권한 안내가 표시되면 내용을 읽고 필요한 확인 절차를 완료하세요.

특정 네트워크에서만 클라이언트를 사용하려면 조건을 최소한으로 설정해 먼저 확인한 다음 예외를 추가하세요. 네트워크를 전환할 때 기존 연결을 다시 설정해야 할 수 있습니다. 상태가 잠시 바뀌는 것만으로 서버에 문제가 있다고 판단할 수는 없습니다. 예기치 않은 재연결을 점검하려면 On Demand를 잠시 끄고 수동으로 연결해 비교하고, 시스템에 자동으로 시작되는 다른 연결 설정이 있는지도 확인하세요. 점검이 끝나면 기존 자동 연결 설정을 복원하세요.

Data: 트래픽이 예상한 경로를 거치는지 확인

Data에는 클라이언트가 기록한 트래픽이 표시됩니다. 페이지를 연 뒤 현재 통계 보기 방식을 확인하고 업로드, 다운로드 및 누적 값을 살펴보세요. 서버별 보기에서는 해당 서버에 집계된 트래픽을, 앱별 보기에서는 특정 앱에 연결해 집계할 수 있는 기록을 보여줍니다. 두 보기는 별도로 추가되는 사용량이 아니므로 값을 합산하면 안 됩니다.

확인할 때는 먼저 현재 수치와 네트워크 유형을 기록한 다음, 캐시되지 않은 페이지를 새로고침하는 등 구분하기 쉬운 작업을 한 번 실행하세요. 같은 보기로 돌아와 증가량을 비교합니다. 백그라운드 요청, 캐시, 통계 갱신이 결과에 영향을 줄 수 있습니다. 클라이언트 통계와 통신사 데이터 측정 기준 및 기간은 다르므로 청구 내역을 대신할 수 없습니다. 서로 다른 시간대의 수치를 비교하기 전에는 통계가 초기화되거나 보기 방식이 바뀌지 않았는지 확인하세요.

Settings: DNS, 테스트 방식, 구성 요소 및 진단

아래 안내는 iPhone / iPad 화면을 기준으로 합니다. 기기에서 옵션 위치가 다르면 현재 화면을 기준으로 확인하세요. 원래 설정을 기록하고 한 번에 하나씩만 변경한 뒤 같은 네트워크와 요청으로 다시 테스트하세요.

DNS: 도메인 이름이 어떻게 해석되는지 확인

Settings에서 DNS 관련 옵션을 찾고 Config에서 현재 구성에 별도의 DNS 설정이 지정되어 있는지 확인하세요. 먼저 기존 값을 기록한 뒤 현재 네트워크나 서비스 요구사항에 맞춰 설정 하나만 변경하고, 적용 후 같은 도메인으로 새 요청을 보내세요. 로컬 네트워크의 호스트 이름만 작동하지 않는다면 현재 네트워크의 DNS 서비스에 의존하는지 먼저 확인하세요. DNS는 이름 해석을 처리하며 Global Routing이나 대상 도메인의 라우팅 규칙을 대신하지 않습니다.

Test Method: 같은 방식으로 결과 비교

Settings에서 Test Method를 열고 화면에서 제공하는 테스트 방식을 선택한 다음 Home으로 돌아가 Connectivity Test를 실행하세요. 일부 테스트는 연결 수립 여부만 확인하고, 다른 테스트는 탐색 대상의 응답도 필요합니다. 여러 결과를 비교할 때는 테스트 방식, 탐색 대상, 네트워크 조건을 동일하게 유지하세요. 지연 시간이 낮더라도 실제 요청으로 확인해야 하며, 이를 근거로 다운로드 속도나 장기적인 안정성을 단정할 수는 없습니다.

Today Widget: 빠른 동작의 실제 결과 확인

Settings에서 Today Widget 관련 설정을 확인한 뒤 시스템의 위젯 편집 화면에서 기기에 해당 항목이 제공되는지 확인하세요. 추가한 후 위젯에서 동작을 한 번 실행하고 Home에서 연결 상태와 Global Routing을 확인합니다. 위젯은 빠른 실행을 위한 진입점이지 별도의 라우팅 설정이 아닙니다. 위젯 표시와 Home 상태가 다르면 Home 상태와 실제 테스트 결과를 우선하세요.

iCloud: 동기화 전 계정과 범위 확인

Settings에서 iCloud 관련 옵션을 확인하고 시스템에서 Shadowrocket의 iCloud 사용을 허용했는지 확인하세요. 두 기기 사이에서 동기화하려면 먼저 두 기기가 같은 iCloud 계정을 사용하는지 확인하고 현재 구성의 사본을 보관한 다음, 화면 안내에 따라 동기화를 활성화하고 결과를 확인하세요. 구독, 구성, 모든 기기별 설정이 함께 복원된다고 가정하지 마세요. 다른 기기에서도 현재 구성과 선택된 서버를 확인해야 합니다.

Diagnostics: 다시 확인할 수 있는 문제 단서 기록

Settings에서 Diagnostics를 찾아 문제가 발생했을 때의 네트워크 유형, Global Routing 모드, 현재 구성과 테스트 결과를 기록하세요. 재현 가능한 요청으로 문제를 다시 발생시킨 뒤 확인 가능한 DNS 해석, 연결 및 규칙 기록을 비교합니다. 진단 정보를 공유하기 전에 구독 주소, 서버 인증 정보, 공개하기 부적절한 접속 기록을 삭제하세요. 단일 단계에 문제가 있는 것으로 보이면 전체 설정을 초기화하지 말고 문제 해결에서 관련 항목을 먼저 확인하세요.