공식 매뉴얼 / 기능 안내

Shadowrocket 기능 및 설정

먼저 Global Routing을 정한 다음 Config와 서버 정보를 확인하세요. 규칙 기반 라우팅, 주문형 연결, 진단은 각각 다른 문제를 해결하므로 따로 설정하고 하나씩 검증해야 합니다.

  • Global Routing
  • Config
  • On Demand
  • Data
  • Settings

iPhone 및 iPad에서의 사용을 기준으로 안내합니다. 화면 구성과 사용 가능한 옵션은 기기에 표시되는 내용을 기준으로 확인하세요.

01 / 라우팅 설정

세 가지 Global Routing 모드

Config, Proxy, Direct는 연결에 적용할 라우팅 방식을 결정하며, 서로 다른 서버 세 대를 뜻하지 않습니다.

기능: Global Routing은 전체 라우팅 방식을 선택하는 곳입니다. Config는 현재 구성의 규칙에 따라 요청을 처리합니다. Proxy는 해당 트래픽을 선택한 프록시 서버로 전달하고, Direct는 선택한 프록시 서버를 거치지 않습니다. 규칙이 적용되지 않는다고 판단하기 전에 먼저 Config 모드인지 확인하세요.

위치 및 설정 방법: Home에서 Global Routing을 열고 원하는 모드를 선택한 뒤, 돌아와 현재 표시된 모드를 확인하세요. 규칙 기반 구성을 사용하는 경우 먼저 Config를 선택합니다. 선택한 서버가 특정 요청을 처리할 수 있는지 시험하려면 Proxy를 일시적으로 사용할 수 있습니다. 현재 네트워크에서 직접 접속한 결과와 비교하려면 Direct를 잠시 선택하세요. 비교가 유효하도록 한 번에 이 설정만 바꾸고 나머지 조건은 그대로 유지합니다.

Global Routing 모드별 주요 차이
화면 표시 / 의미처리 방식사용 시점확인할 항목
Config / 구성현재 Config의 규칙과 정책에 따라 요청을 처리합니다.일상적인 도메인 및 IP 조건별 라우팅에 사용합니다.활성화된 구성, 규칙 순서, 정책 참조를 확인합니다.
Proxy / 프록시해당 트래픽을 선택한 프록시 서버로 전달합니다.서버와 대상까지의 접속 경로를 일시적으로 확인합니다.현재 선택한 서버와 해당 서버의 매개변수를 확인합니다.
Direct / 직접 연결선택한 프록시 서버를 거치지 않습니다.현재 네트워크에서 직접 접속되는지 확인합니다.현재 네트워크, DNS, 대상 서비스 상태를 확인합니다.

주의사항: Proxy를 선택해도 잘못 입력한 인증 정보가 수정되지는 않으며, Direct가 모든 네트워크 문제의 해결책인 것도 아닙니다. 모드를 바꾼 뒤에도 기존 연결이 이전 경로를 계속 사용할 수 있으므로, 확인할 때는 요청을 새로 시작하세요. 일시적으로 문제를 점검한 뒤에는 원래 사용하던 Config로 돌아가 테스트 상태를 일상적인 라우팅 상태로 착각하지 않도록 합니다.

02 / 매칭 및 처리

규칙 유형과 정책

규칙은 요청이 조건에 일치하는지 판단하고, 정책은 일치한 요청을 어떻게 처리할지 결정합니다.

기능: 규칙 기반 라우팅은 요청의 특징을 설정된 조건과 하나씩 비교합니다. DOMAIN은 전체 도메인에, DOMAIN-SUFFIX는 도메인과 하위 도메인에, DOMAIN-KEYWORD는 도메인 키워드에 사용합니다. IP-CIDR과 IP-CIDR6은 각각 IPv4 및 IPv6 대역을 지정하고, GEOIP는 IP의 지리적 위치를 기준으로 매칭합니다. 규칙 유형은 서버 프로토콜이 아니므로 VLESS나 Trojan 같은 프로토콜 이름을 규칙 유형으로 입력하지 않습니다.

위치 및 설정 방법: Config로 이동해 활성화된 구성을 확인한 다음 규칙을 살펴보세요. 일반적으로 구체적인 조건을 포괄적인 조건보다 앞에 배치하고, 앞선 규칙에 일치하지 않은 요청은 FINAL로 처리합니다. 흔히 사용하는 처리 정책은 DIRECT, PROXY, REJECT이며, 구성에 이미 정의된 정책 그룹 이름을 참조할 수도 있습니다. 정책 그룹을 참조할 때는 구성에 정의된 이름과 정확히 일치해야 합니다.

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

이 예시는 문법 설명용입니다. example.com과 하위 도메인은 PROXY로, 지정된 로컬 IPv4 대역은 DIRECT로 전달하고, 앞선 규칙에 일치하지 않는 요청은 FINAL,DIRECT로 처리합니다. 범용 구성 전체를 제시하는 것이 아니며 모든 가정 또는 사무실 네트워크에 같은 설정이 적합하다는 뜻도 아닙니다. 수정하기 전에 기존 구성을 보관하고 최종 기본 정책이 필요한 동작에 맞는지 확인하세요.

주의사항: 규칙은 순서대로 매칭되므로 앞쪽의 포괄적인 규칙이 요청에 먼저 적용되면 뒤에 있는 세부 규칙은 매칭되지 않을 수 있습니다. DOMAIN-SUFFIX 한 줄을 추가하는 것만으로 라우팅이 바뀌었다고 볼 수는 없습니다. Global Routing이 Config인지, 구성이 적용되었는지, 대상이 다른 도메인이나 IPv6 주소를 실제로 사용하지 않는지 함께 확인하세요. 규칙과 설정에 대한 자세한 설명은 설정 상세 안내를 참고하세요.

03 / 연결 정보

기존 구독 및 서버 관리

Subscribe는 기존 구독의 업데이트 출처를 관리하고, Add Server는 개별 서버 정보를 관리합니다. 둘 다 Config 규칙 파일과는 다릅니다.

Subscribe: 가져오기 및 업데이트

기존 구독에는 클라이언트가 불러올 수 있는 서버 정보가 포함되어 있습니다. 일반적으로 Home에서 추가 메뉴를 열고 Add Server로 이동한 다음 Subscribe를 선택해 보유한 구독 주소를 입력합니다. 저장한 뒤 목록으로 돌아가 서버 정보가 불러와졌는지 확인하세요. 메뉴 위치는 현재 화면을 기준으로 확인해야 합니다.

구독을 업데이트하면 출처의 내용을 다시 불러옵니다. 업데이트 후 선택하려는 서버가 여전히 있는지, 구성의 정책 그룹이 예상한 항목을 계속 참조하는지 확인하세요. 목록에 이름이 표시되어도 인증에 성공했거나 모든 서버를 사용할 수 있다는 뜻은 아닙니다.

Add Server: 항목별 입력

서버를 직접 추가할 때는 보유한 서버 정보와 일치하는 프로토콜을 먼저 선택한 뒤 Address, Port와 해당 프로토콜에 필요한 인증, 전송, TLS 매개변수를 입력하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 매개변수 구성이 서로 다르므로 프로토콜 이름만 바꾸고 다른 프로토콜의 필드를 그대로 사용하면 안 됩니다.

Scan QR Code로 가져온 경우에도 주소, 포트, 보안 관련 옵션을 확인해야 합니다. 알아보기 쉬운 메모 이름은 항목을 구분하는 데 도움이 되지만 실제 서버 주소나 인증 정보를 대신하지는 않습니다. 저장한 뒤 Home으로 돌아가 사용할 항목을 직접 선택하세요.

설정 방법: 먼저 가져오기 방법 하나를 선택하세요. 직접 서버를 추가하면서 구독을 반복 업데이트하면 구분하기 어려운 중복 항목이 생길 수 있습니다. 용도를 알아보기 쉽도록 메모 이름을 지정하고, 항목을 삭제하기 전에는 현재 구성에서 참조 중인지 확인하세요. 구독 업데이트에 실패하면 주소가 온전한지, 현재 네트워크에서 출처에 접속할 수 있는지, 클라이언트가 읽을 수 있는 내용을 출처에서 반환하는지 확인하세요.

주의사항: 구독 주소, QR 코드, 인증 정보는 민감한 자료로 취급해야 합니다. 도움을 요청할 때 스크린샷에 이런 정보가 포함되어 있다면 가리세요. 클라이언트의 일회성 구매와 서버 이용 요금제는 별개입니다. 앱을 구매하면 클라이언트 사용 권한을 얻으며, 서버 정보와 구독은 사용자가 직접 준비해야 합니다. 이 사이트는 서버나 구독을 제공, 판매 또는 추천하지 않습니다. 처음 가져오는 전체 절차는 빠른 시작을 참고하세요.

04 / 연결 실행 조건

On Demand 주문형 연결

연결이 언제 실행될지 관리하는 기능으로, Global Routing을 대체하지 않으며 특정 도메인을 직접 연결할지 프록시할지 판단하지도 않습니다.

기능 및 위치: On Demand는 설정한 네트워크 조건에 따라 연결 동작을 관리하며, Settings에서 관련 메뉴를 확인할 수 있습니다. Config와 역할이 다릅니다. On Demand는 연결이 실행되는 조건을 정하고, Config는 연결이 시작된 뒤 트래픽을 어떻게 라우팅할지 정합니다. 이 차이를 알아두면 네트워크를 바꾼 뒤 연결이 다시 나타나는 현상을 규칙 파일 문제로 오해하지 않을 수 있습니다.

설정 방법: 먼저 수동 연결 상태에서 서버, DNS, 라우팅이 모두 정상적으로 작동하는지 확인한 다음 On Demand에서 실제로 제공되는 네트워크 조건을 설정하세요. 사용하는 Wi-Fi와 셀룰러 데이터 환경을 각각 확인하고, 네트워크 이름은 기기에 표시되는 이름을 기준으로 입력합니다. 저장한 뒤 설정 화면만 확인하지 말고 네트워크를 실제로 전환해 연결 상태가 예상대로 바뀌는지 확인하세요.

주의사항: 기능을 활성화하면 조건이 충족될 때 시스템이 연결을 다시 시작할 수 있습니다. 연결이 끊기는 현상을 일시적으로 점검할 때는 Home에서 연결을 끄는 것만으로 끝내지 말고 On Demand도 확인하세요. 변경을 되돌리려면 먼저 해당 주문형 조건을 끈 뒤 다시 관찰합니다. 서버 정보가 잘못된 문제를 이 기능으로 해결하려 하지 마세요. 연결 실행 조건이 충족되는 것과 연결을 실제로 사용할 수 있는 것은 별개입니다.

05 / 사용 상태 확인

Data 트래픽 통계

먼저 통계 범위와 기간을 확인한 다음 업로드 및 다운로드 수치로 실제 사용량을 파악하세요.

기능 및 위치: Data는 클라이언트가 확인할 수 있는 트래픽 정보를 모아 보여줍니다. Data로 이동해 현재 통계 대상과 사용할 수 있는 보기를 먼저 확인하세요. 서버별 보기를 제공한다면 서버 사용 분포를 확인하는 데 적합하고, 앱별 보기는 각 앱에서 발생한 트래픽을 파악하는 데 유용합니다. 업로드와 다운로드는 데이터 사용량이며 네트워크 지연 시간이나 회선 품질을 직접 나타내지는 않습니다.

사용 방법: 테스트 전에 통계 범위와 수치를 기록하고, 확인할 접속을 한 번만 실행한 뒤 돌아와 변화량을 살펴보세요. 특정 규칙의 작동 여부를 판단할 때는 Data뿐 아니라 현재 Global Routing, 선택한 서버, 연결 기록도 함께 확인해야 합니다. 기기에서 백그라운드 동기화가 실행될 수도 있으므로 테스트 중 증가한 모든 사용량이 방금 연 페이지에서 발생했다고 단정할 수 없습니다.

주의사항: 웹페이지를 한 번 열어도 여러 도메인과 연결이 사용될 수 있습니다. 따라서 서버의 사용량이 증가했다는 사실만으로 모든 요청이 같은 정책에 일치했다고 볼 수는 없습니다. 보기와 통계 기간이 다르거나 통계를 초기화했다면 두 수치를 직접 비교하기 어렵습니다. Data는 서비스 제공자의 과금 내역과도 다릅니다. 차이를 해석하려면 먼저 통계 시작 시점과 범위를 맞추세요.

06 / 주요 설정

Settings 확인할 항목

각 설정의 용도를 설명하며 모든 기기에 같은 초기값이 설정되어 있다고 가정하지 않습니다. 실제 설정값은 현재 앱과 구성에 표시되는 내용을 기준으로 확인하세요.

DNS: 도메인 이름 확인

기능 및 위치: DNS는 도메인 이름을 연결에 필요한 주소로 변환합니다. Settings의 DNS 관련 설정과 현재 Config에 해당 설정이 포함되어 있는지 모두 확인해야 합니다. 한쪽만 보면 실제 이름 확인 동작을 설명하기 어려울 수 있습니다.

설정 방법 및 주의사항: 먼저 문제가 도메인 이름 확인 실패인지 연결 실패인지 구분한 뒤 확인된 주소, 요청 경로, 현재 네트워크의 접속 가능성을 점검하세요. 여러 옵션을 한 번에 바꾸지 마세요. IP 조건을 사용하는 규칙은 확인된 주소에 따라 매칭 결과가 달라질 수 있으므로, 설정을 바꾼 뒤에는 요청을 새로 시작하고 로컬 네트워크 리소스에 계속 접속할 수 있는지도 확인하세요.

Test Method: 테스트 방식

기능 및 위치: Settings의 Test Method는 연결 테스트에 사용할 방식을 정합니다. Connectivity Test 결과는 이 설정과 함께 해석해야 합니다. 테스트 방식마다 확인하는 범위가 다르므로 한 종류의 테스트 결과로 다른 네트워크 기능까지 판단할 수는 없습니다.

설정 방법 및 주의사항: 현재 방식을 기록한 뒤 실제로 제공되는 옵션 중 하나를 선택하고, 같은 네트워크와 같은 서버에서 다시 테스트하세요. 테스트 대상이 필요한 방식이라면 대상에 접속할 수 있는지도 확인해야 합니다. 연결 테스트를 통과해도 모든 사이트에 접속할 수 있다는 뜻은 아닙니다. 테스트에 실패한 경우 테스트 대상, 인증, 전송 방식, 현재 네트워크 중 어떤 문제인지 구분하세요.

Today Widget: 빠른 확인 및 조작

기능 및 위치: Today Widget은 시스템 위젯에서 빠르게 정보를 확인하고 조작하는 기능입니다. 먼저 Settings에서 관련 옵션을 확인한 뒤 시스템 위젯 관리 화면에서 추가 여부를 살펴보세요. 실제로 사용할 수 있는 형태는 기기의 시스템과 앱에서 제공하는 위젯에 따라 다릅니다.

설정 방법 및 주의사항: Home에서 정상적으로 연결하고 서버를 선택한 다음 위젯을 설정하세요. 위젯은 일상적인 빠른 조작에 적합하지만 전체 문제 해결 절차를 대신하지는 않습니다. 표시된 상태가 갱신되기까지 시간이 걸릴 수 있습니다. 예상과 다르게 표시되면 앱으로 돌아가 Global Routing, 현재 서버, 시스템 연결 상태를 확인하세요.

iCloud: 구성 동기화

기능 및 위치: iCloud 관련 옵션은 앱에서 지원하는 데이터를 여러 기기 간 동기화하는 데 사용합니다. Settings에서 동기화 메뉴를 확인하고 시스템 설정에서 해당 앱의 iCloud 사용 권한도 살펴보세요. 동기화 범위는 화면에 표시된 설명을 기준으로 확인해야 하며, 모든 로컬 상태가 기기를 바꿀 때 이전된다고 가정해서는 안 됩니다.

설정 방법 및 주의사항: 먼저 중요한 구성을 보관한 뒤 필요한 동기화 옵션을 켜고 다른 기기에서 데이터가 불러와질 때까지 기다리세요. 최종적으로 유지되는 내용을 구분할 수 있도록 두 기기에서 같은 구성을 동시에 수정하지 마세요. 앱 구매 권한, 구독 출처 업데이트, iCloud 구성 동기화는 서로 다른 기능입니다. 동기화가 끝난 뒤에도 서버 선택, 구성 적용 상태, 해당 기기의 시스템 권한을 확인해야 합니다.

Diagnostics: 진단 정보

기능 및 위치: Diagnostics는 진단 정보를 수집하고 확인하는 메뉴로, Settings의 관련 항목에서 찾을 수 있습니다. 문제 범위를 좁히는 데 도움이 되지만 서버 매개변수를 자동으로 수정하거나 연결 성공을 보장하지는 않습니다.

사용 방법 및 주의사항: 문제가 발생한 네트워크, Global Routing 모드, 작업 순서를 기록한 뒤 한 번 재현하고 해당 시각 전후의 정보를 확인하세요. 자료를 공유하기 전에 구독 주소, 서버 주소, 인증 정보가 포함되어 있는지 살펴보고 필요한 부분을 가리세요. 점검이 끝나면 불필요한 상세 기록이 계속 남지 않도록 평소 로그 설정을 복원하세요.

07 / 확인 순서

구성부터 접속까지 확인 순서

한 번에 조건 하나만 바꾸면 매번 무엇을 확인했는지 명확해집니다.

  1. 먼저 연결 정보를 확인합니다. 기존 구독을 제대로 불러왔는지, 또는 직접 추가한 서버의 Address, Port, 인증 및 전송 매개변수가 원본 정보와 일치하는지 확인하세요. 이름이 같아도 매개변수까지 같다는 뜻은 아닙니다.
  2. 다음으로 라우팅 모드를 확인합니다. 일상적인 규칙 기반 라우팅에는 Config를 사용하고 현재 적용 중인 구성을 확인하세요. Proxy 또는 Direct로 잠시 전환할 때는 테스트 목적을 기록하고 완료 후 원래 설정으로 되돌립니다.
  3. 요청을 새로 시작합니다. 기존 페이지나 연결을 닫고 다시 시도한 다음 Data와 진단 정보를 함께 확인하세요. 연결 스위치가 켜져 있는지 또는 테스트 수치가 한 번 표시되었는지만으로 결론을 내리지 마세요.
  4. 마지막으로 자동 동작을 설정합니다. 수동 연결이 안정적으로 작동한 뒤 On Demand, 위젯, 동기화를 설정하고 네트워크를 전환했을 때와 다른 기기에서의 결과를 직접 확인하세요.