공식 매뉴얼 / 기능 및 설정

Shadowrocket
기능 및 설정 가이드

먼저 Global Routing을 확인한 다음 Config와 서버를 살펴보세요. 설정은 한 번에 한 종류씩 변경하고 같은 대상으로 다시 테스트하면 규칙, DNS, 연결 문제를 구분하기 쉽습니다.

첫 연결 가이드 보기

지원 기기: iPhone / iPad / Mac / Windows / Android / Linux. 아래 설명은 iPhone / iPad 인터페이스를 기준으로 합니다. 다른 플랫폼에서는 같은 이름의 항목을 찾아보세요. 실제 메뉴 위치와 사용 가능한 기능은 플랫폼별 인터페이스를 따릅니다.

01 / 전체 처리 방식

Global Routing의 세 가지 모드

메뉴: Home → Global Routing

Global Routing은 클라이언트가 처리하는 범위에 포함된 요청을 어떤 방식으로 다룰지 결정합니다. 구성 모드는 Config, 프록시 모드는 Proxy, 직접 연결 모드는 Direct입니다. 일반적인 규칙 기반 라우팅에는 보통 Config를 사용합니다. 특정 요청이 규칙의 영향을 받는지 확인하려면 Proxy나 Direct로 잠시 전환해 비교할 수 있습니다. 모드를 바꿔도 서버는 바뀌지 않으며 계정, 포트, 프로토콜 설정도 자동으로 수정되지 않습니다.

세 가지 모드의 용도와 점검 항목
화면의 옵션처리 방식사용 시점우선 확인할 항목
Config / 구성현재 활성화된 구성의 규칙에 따라 정책을 선택합니다.일상적인 규칙 기반 라우팅에 사용해 프록시가 필요한 요청과 직접 연결할 요청을 각각 처리합니다.Config가 활성화되어 있는지, 규칙 순서와 정책 대상이 올바른지 확인합니다.
Proxy / 프록시처리 범위에 들어온 요청을 주로 프록시 방식으로 처리합니다. 시스템 및 구성에 설정된 우회 항목은 별도로 확인해야 합니다.규칙 매칭 문제를 잠시 배제하고 선택한 서버로 대상에 접속할 수 있는지 확인할 때 사용합니다.Home에서 선택한 서버, 프로토콜 설정, 서버 측 서비스 상태를 확인합니다.
Direct / 직접 연결처리 범위에 들어온 요청을 직접 연결 방식으로 처리합니다.현재 네트워크에서 대상에 접속할 수 있는지 확인하거나 프록시 정책을 잠시 사용하지 않을 때 선택합니다.로컬 네트워크, DNS, 대상 서비스가 정상인지 확인합니다.

Home에서 Global Routing을 열고 원하는 모드를 선택한 뒤 돌아와 같은 웹사이트나 앱에서 새 요청을 보내세요. 기존의 장시간 연결은 이전 경로를 계속 사용할 수 있으므로 필요하면 대상 앱을 완전히 종료한 후 다시 여세요. Proxy에서는 접속되지만 Config에서는 실패한다면 규칙과 정책을 우선 확인합니다. 두 모드 모두 실패하면 규칙 범위를 넓히기 전에 서버, 네트워크, 대상 서비스부터 점검하세요.

02 / 매칭 및 정책

Rule 규칙 기반 라우팅

메뉴: Config → 현재 구성의 Rule

규칙 기반 라우팅은 ‘요청이 어떤 조건에 해당하는지’와 ‘조건에 맞으면 어떻게 처리할지’를 구분합니다. DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD는 도메인 관련 조건이고, IP-CIDR과 IP-CIDR6는 주소 범위에, GEOIP는 주소의 지역 판별에 사용됩니다. USER-AGENT는 요청 헤더 매칭에 사용됩니다. 클라이언트가 해당 정보를 확인할 수 있을 때만 유효하며, 모든 암호화 트래픽에서 앱을 식별하는 방법은 아닙니다.

자주 쓰는 정책은 DIRECT, PROXY, REJECT입니다. DIRECT는 직접 연결, PROXY는 프록시 정책으로 처리, REJECT는 매칭된 요청을 거부한다는 뜻입니다. 구성에 사용자 지정 정책 이름이 있을 수도 있습니다. 수정하기 전에 해당 이름이 현재 구성에 정의되어 있고 예상한 서버나 정책 그룹을 가리키는지 확인하세요. 이름이 비슷해도 같은 기능을 하는 것은 아닙니다.

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,example,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

위 내용은 문법 예시일 뿐, 현재 구성을 통째로 대체할 수 있는 완성된 설정은 아닙니다. DOMAIN은 지정한 도메인과 정확히 일치하고, DOMAIN-SUFFIX는 하위 도메인도 포함합니다. DOMAIN-KEYWORD는 매칭 범위가 넓어 의도하지 않은 도메인까지 처리할 수 있습니다. 규칙은 일반적으로 위에서부터 순서대로 검사하며 먼저 일치한 조건이 우선 적용됩니다. 따라서 구체적인 규칙을 포괄적인 조건보다 앞에 두고, 남은 요청은 마지막의 FINAL로 처리하는 것이 일반적입니다.

설정을 바꾸기 전에 현재 Config를 백업하세요. 범위가 명확한 규칙을 하나 추가하고 Global Routing이 Config인지 확인한 다음 새 요청을 보내 기록에서 매칭 결과를 확인합니다. 규칙이 매칭되지 않으면 실제 접속 도메인과 리디렉션된 도메인이 일치하는지 확인하세요. 매칭은 됐지만 경로가 잘못됐다면 같은 조건을 반복해서 추가하지 말고 정책 대상을 점검하세요. IP 판별 규칙에는 도메인 조회 결과와 구성의 DNS 옵션도 영향을 줄 수 있습니다.

03 / 정보 가져오기 및 관리

Subscribe 및 서버 관리

메뉴: Config / Subscribe, Home / Add Server

구독은 서버 항목을 일괄로 가져와 업데이트하는 데 사용합니다. 서버 항목에는 실제 연결에 필요한 주소, 포트, 프로토콜, 인증 정보가 저장됩니다. 이 안내는 이미 본인 소유의 구독이나 서버 정보를 가지고 있다는 전제에서 설명합니다. 구독 링크는 이용 중인 서비스 제공업체에서 받으세요. 클라이언트를 구매하거나 설치해도 사용할 수 있는 연결 경로가 자동으로 제공되지는 않습니다.

구독 링크가 있다면 Config의 Subscribe에서 추가하고 저장한 뒤 업데이트를 실행하세요. 이후 Home으로 돌아가 항목을 확인합니다. 서버 정보가 하나뿐이라면 Add Server에서 해당 유형을 선택하고 항목별로 입력하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등 프로토콜마다 필요한 항목이 다릅니다. 서비스 제공업체가 안내한 정보를 입력해야 하며 주소와 포트만 복사한다고 설정이 완료되는 것은 아닙니다.

Scan QR Code와 클립보드 가져오기는 서버 공유 정보가 이미 있을 때 사용할 수 있습니다. 가져오기 전에 내용이 서버 공유 정보인지 전체 구성인지 확인해 구성 주소를 서버 주소 입력란에 넣지 않도록 하세요. 구독 URL에는 접근 인증 정보가 포함되는 경우가 많으므로 공개 스크린샷, 채팅 기록, 진단 첨부 파일에 노출하지 마세요. 링크가 유출됐다면 서비스 제공업체에 문의해 처리하세요.

업데이트 전에 현재 선택한 서버와 중요한 메모를 기록해 두세요. 구독 업데이트 과정에서 항목이 교체되거나 구독 항목에 수동으로 변경한 값이 덮어써질 수 있습니다. 계속 관리할 서버 정보는 별도로 정리하세요. 구독이 여러 개라면 용도별로 이름을 지정하고, 삭제하기 전에 출처와 그룹을 확인하세요. 표시 이름이 같다는 이유만으로 같은 항목이라고 판단하지 마세요.

구독 업데이트, 정렬 및 백업 매뉴얼 보기 →

04 / 자동 연결

On Demand 조건부 연결

메뉴: Settings → On Demand

On Demand는 설정된 네트워크 조건에 따라 연결을 자동으로 시작합니다. Global Routing과 역할이 다릅니다. On Demand는 ‘언제 연결할지’를, Global Routing은 ‘연결 후 요청을 어떻게 처리할지’를 결정합니다. 플랫폼의 네트워크 확장 기능과 현재 권한에 따라 작동하므로 모든 앱과 네트워크 상태에서 똑같이 동작한다고 볼 수는 없습니다.

먼저 Home에서 수동으로 연결해 서버가 정상인지 확인한 뒤 Settings의 On Demand로 이동하세요. 현재 화면에 제공되는 네트워크 유형, Wi-Fi 등의 조건에 맞춰 설정합니다. 처음에는 확인하기 쉬운 조건 하나만 활성화하고 네트워크를 전환해 연결 상태를 살펴본 다음 예외 조건을 추가하세요. 현재 플랫폼에 해당 메뉴가 없다면 그 플랫폼에서 제공하는 기능에 맞춰 설정하고 다른 기기의 설정을 그대로 따라 하지 마세요.

자동 연결을 잠시 중단하려면 Home 스위치만 끄지 말고 On Demand도 확인하세요. 연결이 반복해서 다시 시작된다면 먼저 조건부 연결을 비활성화한 뒤 상태를 확인하세요. 서버를 모두 삭제해 해결하려고 하지 마세요. Wi-Fi와 모바일 네트워크를 전환한 뒤 잠깐 연결이 끊겼다면 네트워크 재연결과 자동 연결 규칙 매칭을 구분해 살펴보세요.

05 / 사용량 확인

Data 사용량 통계

메뉴: Data

Data에서는 클라이언트에 기록된 업로드, 다운로드 및 관련 연결 사용량을 확인할 수 있습니다. 수치를 보기 전에 집계 범위를 확인하세요. 현재 연결, 누적 기록, 서버별 항목은 각각 집계 기간이 다를 수 있습니다. 이 통계는 시스템의 셀룰러 데이터 사용량이나 서비스 제공업체 계정의 과금 데이터와 같지 않습니다.

특정 작업에서 데이터가 발생했는지 확인하려면 먼저 현재 수치를 기록하세요. 다른 백그라운드 전송을 멈춘 뒤 분명한 접속 동작을 한 번 실행하고 전후 변화를 비교합니다. 현재 화면에서 통계를 지울 수 있다면 필요한 기록을 먼저 저장하세요. 통계를 초기화해도 서비스 제공업체 계정의 잔여 데이터가 복구되는 것은 아닙니다.

통계가 증가했다는 사실만으로 해당 콘텐츠가 완전히 로드됐다고 볼 수는 없습니다. 연결 재시도, 프로토콜 오버헤드, 백그라운드 동기화에서도 데이터가 발생합니다. 사용량이 비정상적으로 증가하면 연결 기록, 서버 선택, 대상 앱을 차례로 확인해 원인을 좁히세요. 사용량이 적은데 페이지가 열리지 않는다면 DNS, 연결 수립, 대상 서버의 응답을 계속 점검합니다.

06 / 자주 쓰는 설정

Settings 항목 설명

메뉴: Settings; 구성 내부 옵션은 Config에서도 확인

Settings의 전역 설정과 Config 내부의 옵션이 함께 연결에 영향을 줄 수 있습니다. 이름이 같거나 비슷한 옵션이 있다면 현재 활성화된 구성과 해당 항목의 설명을 먼저 확인하세요. 모든 플랫폼에서 설정 우선순위가 같다고 가정하지 마세요. 아래는 사용 목적에 따른 안내이며, 실제 선택지는 현재 화면을 기준으로 합니다.

DNS: 먼저 이름 조회를 확인하고 라우팅을 점검하세요

DNS는 도메인을 주소로 변환하며 접속 과정에서 별도로 작동합니다. Settings의 DNS 관련 항목을 확인하고 활성화된 Config에 DNS 설정이 포함되어 있는지도 살펴보세요. 현재 네트워크에서 사용할 수 있는 것으로 확인된 설정을 사용하고 한 번에 한 항목씩 변경하세요. 저장한 뒤 다시 연결하고 같은 도메인으로 재시험하면 캐시가 변경 사항을 가리는 일을 줄일 수 있습니다.

문제를 확인하려고 모든 DNS 항목을 한꺼번에 바꾸지 마세요. 도메인이 정상적으로 조회되어도 프록시 연결까지 성공했다는 뜻은 아닙니다. DNS 요청의 경로와 대상 연결에 적용되는 정책도 따로 확인해야 합니다. 일부 도메인만 실패한다면 철자, 조회 결과, 규칙 매칭부터 점검하세요. 여러 대상에서 동시에 문제가 생기면 로컬 네트워크와 선택한 DNS 설정을 비교합니다.

Test Method: 테스트 방식과 실제 사용 경험은 다릅니다

Test Method는 서버 테스트에 사용할 방식을 결정합니다. Settings에서 현재 방식을 확인한 뒤 Home에서 Connectivity Test를 실행하세요. 테스트 결과는 특정 탐지 조건에서의 연결 가능 여부나 소요 시간을 나타낼 뿐, 모든 웹사이트의 응답 속도를 뜻하지 않습니다. 인증, 전송, 대상 접속의 모든 단계가 정상임을 보장하지도 않습니다.

서버를 비교할 때는 테스트 방식, 네트워크, 테스트 대상을 동일하게 유지하세요. 특정 탐지가 실패하면 먼저 서버가 해당 탐지 방식에 응답하는지 확인한 다음 실제 접속 결과와 함께 판단합니다. 테스트 수치가 낮다는 이유만으로 안정적으로 사용 중인 서버를 자주 바꾸지 마세요.

Today Widget: 빠른 실행 및 메인 화면 확인

Today Widget은 해당 구성 요소를 지원하는 플랫폼에서 빠른 실행이나 상태 확인에 사용할 수 있습니다. Settings에서 관련 옵션을 확인한 뒤 시스템에서 제공하는 추가 방법에 따라 활성화하세요. 사용 가능 여부와 표시 위치는 시스템 버전에 따라 달라집니다. 기기에 관련 메뉴가 없다면 Home에서 연결 및 전환을 관리하세요.

위젯에서 작업한 뒤에도 Home으로 돌아가 서버와 연결 상태를 확인하세요. 위젯 화면은 갱신이 지연될 수 있으므로 오래된 상태만 보고 연결이 끊겼다고 판단하지 마세요. 위젯은 규칙이나 구독을 관리하는 전체 기능을 제공하지 않습니다.

iCloud 동기화: 동기화 전에 백업

iCloud 동기화는 현재 플랫폼과 화면에서 지원하는 항목을 동기화하는 기능이지, 모든 기기의 내용을 실시간으로 완전히 복제하는 기능은 아닙니다. 먼저 시스템에서 iCloud 권한을 확인한 다음 Settings의 동기화 옵션과 대상 항목을 살펴보세요. 처음 활성화하기 전에 로컬 백업을 저장하고 어느 기기의 데이터를 기준으로 삼을지 정한 뒤 다른 기기에서 결과를 확인합니다.

설정 동기화가 앱 구매 기록이나 서비스 제공업체 계정까지 동기화한다는 뜻은 아니며, 연결 상태가 기기 간에 자동으로 일치하는 것도 아닙니다. 여러 기기에서 동시에 편집하면 내용이 덮어써질 수 있습니다. 큰 변경은 한 기기에서 먼저 완료하고 동기화 결과를 확인한 다음 다른 기기를 처리하세요. 동기화 파일에 민감한 연결 정보가 포함될 수도 있으므로 기기와 클라우드 계정의 접근 권한을 관리하세요.

07 / 문제 진단

Diagnostics 및 연결 기록

메뉴: Settings → Diagnostics 관련 항목

Diagnostics는 DNS 조회 실패, 서버 연결 실패, 인증 실패, 요청 처리 이상을 구분하는 데 도움이 됩니다. 현재 화면에서 제공하는 진단 및 기록 기능을 켜고 오류 발생 시각, 네트워크, Global Routing 모드, 현재 서버를 먼저 기록한 뒤 문제를 한 번만 재현하세요. 이렇게 하면 오랫동안 쌓인 기록을 추측하며 살피지 않고 특정 동작과 기록을 연결할 수 있습니다.

실패가 어느 단계에서 발생했는지 먼저 확인하세요. 도메인 조회 결과가 없다면 DNS를 점검합니다. 서버 연결에 실패했다면 주소, 포트, 네트워크를 확인하세요. 연결은 됐지만 대상 접속에 문제가 있다면 정책, 프로토콜 추가 항목, 대상 서버의 응답을 확인합니다. 서로 다른 오류가 비슷하게 보일 수 있으므로 모든 시간 초과를 규칙 문제로 단정하지 마세요.

서비스 제공업체에 상황을 설명해야 한다면 오류 메시지, 재현 절차, 네트워크 유형을 정리하세요. 공유하기 전에 구독 URL, 비밀번호, 인증 식별 정보와 불필요한 접속 기록을 삭제하고 스크린샷도 하나씩 확인하세요. 문제 해결 후에는 평소 기록 설정으로 되돌리고 더 이상 필요하지 않은 진단 파일을 삭제해 민감한 접속 정보가 장기간 남지 않도록 하세요.

08 / 설정 재점검

같은 연결 경로를 따라 점검

문제가 발생하면 먼저 현재 상태를 기록한 뒤 한 항목씩 비교하세요. 정상으로 돌아오면 임시 설정을 원래대로 되돌리고 효과가 확인된 변경만 유지합니다.

  1. Home: 연결 스위치, 현재 서버, Global Routing을 확인해 잘못된 항목을 선택하지 않았는지 점검합니다.
  2. Config: 구성을 내려받았는지만 보지 말고 활성화된 구성, 규칙 순서, 정책 이름을 확인합니다.
  3. Connectivity Test: 같은 네트워크와 Test Method를 유지하고 실제 접속 결과와 함께 판단합니다.
  4. DNS / Diagnostics: 실패한 단계를 기준으로 점검하고 필요한 기록을 저장한 뒤 평소 설정으로 되돌립니다.