공식 가이드 · 기능 안내

Shadowrocket
기능 및 주요 설정

Global Routing부터 Settings까지, 먼저 트래픽 처리 방식을 정한 다음 연결과 진단을 확인하는 순서로 각 기능의 용도, 메뉴 위치, 설정 방법 및 주의사항을 살펴보세요.

  • 라우팅 모드 Config / Proxy / Direct
  • 규칙 정책 PROXY / DIRECT / REJECT
  • 문제 해결 메뉴 Connectivity Test

Shadowrocket은 iPhone, iPad, Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전을 제공합니다. 아래에서는 iPhone / iPad의 영어 메뉴 이름을 기준으로 위치를 안내합니다. 다른 플랫폼은 메뉴 위치와 시스템 권한이 다를 수 있으므로 실제 앱에 표시되는 내용을 확인하세요. 특정 플랫폼의 메뉴 경로를 모든 기기에 그대로 적용하지 마세요.

시작하기 전에 본인이 보유한 구독 또는 서버 정보를 준비하고 현재 선택된 구성을 확인하세요. 아직 앱을 받지 않았다면 전체 플랫폼 다운로드 안내를 먼저 확인하세요. 처음 연결하는 순서별 안내는 사용 안내를 참고하세요. 이 페이지에서는 각 설정의 관계를 설명하며 모든 기본값을 변경할 필요는 없습니다.

01 / GLOBAL ROUTING

Global Routing: Config, Proxy, Direct

기능: Global Routing은 클라이언트가 처리하는 요청의 경로를 결정합니다. 화면의 Config, Proxy, Direct는 각각 구성 규칙 적용, 프록시, 직접 연결 모드입니다. 서버 세 대를 뜻하거나 연결 품질의 등급을 나타내는 것은 아닙니다. 모드를 선택한 뒤에도 연결 스위치, 서버 및 시스템 권한을 확인해야 합니다.

위치 및 설정 방법: Home에서 Global Routing을 열고 용도에 맞는 모드를 선택합니다. 규칙 구성에 따라 도메인이나 주소별로 트래픽을 분기하려면 Config를 선택하세요. 문제가 규칙과 관련 있는지 확인하려면 Proxy 또는 Direct로 잠시 전환한 뒤 같은 대상을 반복 테스트하고 결과를 기록합니다.

화면 옵션처리 방식사용 사례확인 사항
Config · 구성현재 구성의 규칙 및 정책에 따라 요청을 처리합니다.대상마다 다른 경로를 지정하려는 일반적인 사용 상황현재 구성, 규칙 순서 및 정책 연결 대상
Proxy · 프록시클라이언트가 처리하는 요청을 프록시 경로로 보냅니다.규칙 분기의 영향을 잠시 배제하고 서버 경로를 확인할 때기본 서버가 선택되어 있는지, 사용할 수 있는지
Direct · 직접 연결클라이언트가 처리하는 요청을 직접 연결 경로로 보냅니다.현재 네트워크에서 같은 대상에 직접 접속할 수 있는지 비교할 때로컬 네트워크, DNS 및 대상 자체의 상태

주의: Proxy를 선택해도 시스템의 모든 트래픽이 반드시 같은 경로를 통과하는 것은 아닙니다. 실제 적용 범위는 시스템 및 트래픽 처리 설정에 따라 달라집니다. Direct도 연결 스위치를 끄는 것과 같지 않습니다. 문제 해결이 끝나면 원래 모드로 되돌리세요. 구성 파일을 변경하지 않았더라도 트래픽 처리 결과가 달라질 수 있습니다. Proxy에서는 정상이고 Config에서 문제가 생기면 서버를 다시 가져오기보다 먼저 어떤 규칙이 적용되는지 확인하세요.

02 / CONFIG

규칙 분기: 매칭 조건과 처리 정책

기능: 규칙은 일반적으로 매칭 유형, 매칭 대상, 정책으로 구성됩니다. DOMAIN은 정확한 도메인을, DOMAIN-SUFFIX는 도메인과 하위 도메인을, DOMAIN-KEYWORD는 도메인 키워드를 기준으로 매칭합니다. IP-CIDR과 IP-CIDR6은 각각 IPv4 및 IPv6 대역을 지정하고 GEOIP는 IP 주소 위치 데이터베이스를 기준으로 매칭합니다. USER-AGENT는 확인 가능한 요청 정보에 의존하므로 모든 앱 트래픽에 적용되는 범용 조건으로 사용하기 어렵습니다.

위치 및 설정 방법: Config에서 현재 사용 중인 구성을 확인한 다음 규칙과 정책을 살펴봅니다. 규칙은 보통 순서대로 매칭되므로 구체적인 조건을 포괄적인 조건보다 앞에 두고, 앞선 규칙에 매칭되지 않은 요청은 마지막의 FINAL에서 처리하도록 설정합니다. PROXY는 프록시 정책, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 구성에서 이름이 지정된 정책을 참조한다면 해당 이름이 실제로 어떤 대상에 연결되어 있는지도 확인하세요.

DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

위 내용은 규칙 문법을 읽기 위한 예시일 뿐이며, example.com은 설명용 도메인입니다. 그대로 가져와 적용할 수 있는 완성된 구성은 아닙니다. 첫 번째 규칙에서 이미 매칭된 도메인에는 뒤에 있는 키워드 규칙이 적용되지 않습니다. 마지막의 FINAL은 앞선 규칙에서 처리하지 않은 요청을 담당합니다. 규칙을 살펴볼 때는 무엇을 매칭하는지와 어디에서 처리하는지를 나눠 확인하면 행 끝의 PROXY만 보는 것보다 문제를 찾기 쉽습니다.

주의: 규칙으로 작동하지 않는 서버를 복구할 수는 없습니다. 한 번에 한 항목만 변경하고 저장한 뒤, 해당 구성이 계속 선택되어 있는지 확인하고 요청을 다시 보내 결과를 확인하세요. IP 관련 규칙은 도메인 해석 결과, IPv6 및 데이터베이스 차이도 고려해야 합니다. 지리 정보 매칭 규칙 하나만으로 모든 요청의 실제 경로를 단정하지 마세요.

03 / HOME · SUBSCRIBE

구독 및 서버 관리

기능: 서버 항목에는 연결에 필요한 프로토콜과 매개변수가 저장됩니다. Subscribe는 본인이 보유한 구독 주소에서 서버 목록을 업데이트하는 기능입니다. 구독과 Config는 서로 다른 항목입니다. 서버 목록을 가져와도 규칙 구성이 자동으로 전환되거나 기본 서버가 선택되는 것은 아닙니다.

위치 및 설정 방법: Home에서 추가 메뉴를 사용합니다. 기존 구독을 가져오려면 Subscribe 유형을 선택하고 전체 주소를 붙여 넣은 다음 알아보기 쉬운 메모를 입력해 저장하고 업데이트를 실행하세요. 직접 입력할 때는 Add Server에서 제공받은 서버 정보에 명시된 프로토콜을 선택한 뒤 주소, 포트, 인증 매개변수를 입력합니다. Scan QR Code는 본인이 보유한 유효한 QR 코드가 있을 때 사용할 수 있습니다.

Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2는 매개변수 구성이 서로 다릅니다. 주소가 같다는 이유로 프로토콜을 바꾸거나 서버 도메인을 모든 TLS 필드에 그대로 입력하지 마세요. 각 필드는 본인이 보유한 정보에 맞게 입력해야 합니다. 필드의 용도는 프로토콜 참고 안내에서 확인하세요.

주의: 구독을 업데이트하면 항목 이름과 목록 내용이 바뀔 수 있습니다. 업데이트 후 기본 서버를 다시 확인해 삭제된 항목이 계속 선택되어 있지 않은지 살펴보세요. 같은 구독을 반복해서 가져오면 관리할 항목이 늘어납니다. 삭제 전에는 구독에서 생성된 항목과 직접 추가한 항목을 구분하세요. 구독 주소에 접근 정보가 포함될 수 있으므로 스크린샷, 로그 또는 구성을 공유하기 전에 전체 주소와 인증 정보를 가리세요.

04 / ON DEMAND

On Demand: 조건에 따른 연결 실행

기능: On Demand는 설정된 조건이 충족되면 연결을 시작하도록 하는 시스템의 주문형 연결 설정입니다. 도메인에 PROXY 또는 DIRECT를 지정하는 기능은 아닙니다. 연결을 시작할지 여부와 연결 후 트래픽을 어떻게 분기할지는 서로 다른 설정입니다.

위치 및 설정 방법: Settings에서 On Demand를 찾아 현재 설정된 조건을 먼저 확인한 뒤 필요한 규칙을 활성화합니다. 네트워크 유형이나 특정 네트워크에 따라 조건을 설정하는 옵션이 표시된다면 실제 사용 환경에 맞춰 항목별로 설정하세요. 저장 후 해당 네트워크 환경에서 작동을 확인하고, 시스템이 VPN 구성을 추가하도록 허용했는지도 점검합니다.

주의: On Demand가 활성화되어 있으면 직접 연결을 끊은 뒤에도 연결이 다시 시작될 수 있습니다. 스위치가 작동하지 않는다고 단정하지 말고 먼저 실행 조건을 확인하세요. 연결 문제를 해결할 때는 On Demand를 잠시 끄고 수동 연결로 재현 가능한 테스트 환경을 만드세요. 문제 해결 후에는 다시 활성화합니다. 네트워크 변경 후 연결이 시작되는 시점은 시스템의 제어를 받으므로 어떤 상황에서도 항상 연결 상태를 유지한다고 볼 수 없습니다.

05 / DATA

Data: 트래픽 기록 확인

기능: Data에서는 클라이언트가 기록한 트래픽 통계를 확인해 연결 중 데이터 활동을 살펴볼 수 있습니다. 이 통계는 클라이언트가 기록하는 범위에 한정되며 시스템의 모든 앱 사용량을 집계한 청구 내역이 아닙니다. 본인이 이용하는 서비스의 요금 기록을 대신하지도 않습니다.

위치 및 사용 방법: Data에서 통계 기간, 송수신 방향 및 분류 기준을 먼저 확인한 뒤 사용 전후의 변화를 비교합니다. 예를 들어 테스트할 대상 하나만 열고 전후 데이터가 증가했는지 확인하면서 현재 Global Routing 모드도 함께 살펴보세요. 통계 초기화 기능이 표시된다면 실행 전에 기존 기록을 보관해야 하는지 확인합니다.

주의: 트래픽이 증가했다는 사실만으로 대상의 콘텐츠가 정상적으로 로드되었거나 모든 요청에 예상한 정책이 적용되었다고 볼 수는 없습니다. 백그라운드 요청, 재시도 및 연결 오버헤드가 통계에 함께 포함될 수 있습니다. 기기별 데이터는 통계 기간, 단위 및 측정 방식이 서로 다를 수 있으므로 단순 합산해 서비스 제공자의 기록과 비교하지 마세요.

06 / SETTINGS

Settings: 주요 설정 항목과 적용 범위

Settings의 항목은 플랫폼과 시스템 권한에 따라 달라질 수 있습니다. 아래에서는 기능 이름을 기준으로 위치를 안내하며 하위 메뉴 경로를 고정해 설명하지 않습니다. 설정을 변경하기 전에 기존 값을 기록해 두세요. 앱에 구성별 설정과 전역 설정이 모두 있다면 여러 위치에서 같은 항목을 반복해서 바꾸기보다 현재 구성에 별도 설정이 적용되어 있는지 확인하세요.

DNS: 도메인 해석 경로 확인

용도 및 위치: DNS는 도메인을 IP 주소로 변환합니다. Settings의 DNS 관련 항목과 현재 구성에서 설정을 확인할 수 있습니다. 설정 방법: 현재 구성에서 해석 방식을 지정하는지 먼저 확인한 다음 기존 구성의 요구 사항에 맞춰 조정하고 저장한 뒤 요청을 다시 보냅니다. 주의: DNS가 정상이어도 프록시 연결이 성공하는 것은 아니며, DNS 설정을 바꿔도 잘못된 인증 매개변수는 해결되지 않습니다. IP 주소로는 접속되지만 도메인으로는 실패한다면 DNS를 우선 확인할 수 있습니다. 모든 연결 문제를 DNS 탓으로 돌리지는 마세요.

Test Method: 일관된 테스트 방법

용도 및 위치: Settings의 Test Method는 관련 연결 테스트에 사용할 방식을 결정합니다. 설정 방법: 현재 화면에서 선택할 수 있는 테스트 방법을 고른 다음 Home으로 돌아가 Connectivity Test를 실행합니다. 여러 서버를 비교할 때는 테스트 방법과 네트워크 환경을 동일하게 유지하세요. 주의: 테스트 방법마다 확인하는 연결 단계가 다르므로 결과를 그대로 비교하지 마세요. 테스트 하나가 성공해도 모든 웹사이트, 프로토콜 또는 장시간 데이터 전송이 정상이라는 뜻은 아닙니다.

Today Widget: 빠른 접근 기능 확인

용도 및 위치: Today Widget은 시스템 위젯에 표시되는 항목과 관련된 설정입니다. Settings에서 현재 설정할 수 있는 내용을 확인하세요. 설정 방법: 앱과 시스템이 제공하는 메뉴에서 표시 항목을 설정한 뒤, 시스템의 해당 위젯 영역에서 추가할 수 있는지 확인합니다. 주의: 위젯 표시 여부, 새로 고침 시점 및 실행 가능한 작업은 시스템 버전에 따라 다릅니다. 표시되지 않으면 먼저 시스템 위젯 설정을 확인하고 서버 구성을 다시 만들지는 마세요. 위젯 상태가 의심스러우면 앱 내 Home에 표시된 상태를 기준으로 확인하세요.

iCloud: 동기화 범위와 덮어쓰기 확인

용도 및 위치: iCloud 관련 항목에서는 앱이 지원하는 데이터 동기화 또는 복구 설정을 확인할 수 있습니다. 설정 방법: 먼저 시스템에서 올바른 계정으로 로그인했는지, 앱의 iCloud 사용이 허용되어 있는지, 앱에 표시된 동기화 범위가 적절한지 확인한 다음 동기화 또는 복구를 진행합니다. 주의: 모든 연결 상태, 통계 및 모든 플랫폼의 구성이 자동으로 일치한다고 가정하지 마세요. 복구 전에 현재 사용 가능한 구성을 보관하세요. 충돌이 발생하면 로컬과 클라우드의 내용을 구분한 뒤 진행해 이전 데이터가 최근 변경 사항을 덮어쓰지 않도록 합니다.

Diagnostics: 문제 해결 정보 수집

용도 및 위치: Settings에서 Diagnostics를 찾아 앱에서 제공하는 진단 또는 로그 메뉴를 통해 오류 단서를 확인합니다. 설정 방법: 재현 가능한 문제를 먼저 확인한 다음 화면 안내에 따라 해당 작업의 기록을 수집하고, 필요하지 않게 되면 상세 기록을 중지합니다. 주의: 기록에는 대상 도메인, 서버 주소 및 기타 민감한 정보가 포함될 수 있습니다. 다른 사람에게 전달하기 전에 인증 매개변수, 구독 정보 및 관련 없는 내용을 삭제하세요. 전체 구성을 일반 스크린샷으로 공개하지 마세요.

07 / CONNECTIVITY TEST

설정 변경 후 확인 순서

매번 한 가지 문제만 대상으로 테스트하면 서버 미선택, 서버 연결 실패, 규칙 매칭 오류, 대상 자체의 문제를 구분할 수 있습니다. DNS, 프로토콜 매개변수, Global Routing 및 규칙을 한꺼번에 바꾸지 마세요. 정상으로 돌아와도 어떤 설정이 영향을 주었는지 알 수 없습니다.

  1. Home 확인. 본인이 보유한 서버 정보가 빠짐없이 입력되었는지, 기본 서버가 선택되어 있는지, 연결 스위치가 예상한 상태인지, 시스템 권한이 취소되지 않았는지 확인하세요.
  2. Connectivity Test 실행. Test Method를 그대로 유지하고 현재 네트워크와 테스트 결과를 기록하세요. 실패하면 주소, 포트, 인증 정보 및 구독 업데이트 상태부터 확인합니다.
  3. Global Routing 모드 비교. 같은 대상에 Proxy와 Direct를 각각 임시로 적용해 접속한 다음 Config로 되돌리세요. Config에서만 차이가 발생한다면 현재 구성과 규칙 정책을 확인합니다.
  4. 단서에 따라 설정 확인. 도메인 해석에 문제가 있으면 DNS를, 자동 재연결에 문제가 있으면 On Demand를 확인하고, 통계 관련 문의는 Data에서 살펴보세요. 필요한 경우 Diagnostics를 통해 해당 기록을 수집합니다.
  5. 일상 사용 상태로 복원. 임시 테스트 모드를 원래대로 되돌리고 더 이상 필요하지 않은 상세 기록을 끄세요. 유효한 변경 사항과 기존 값에 대한 기록은 보관해 다음 문제 해결 때 같은 테스트를 반복하지 않도록 합니다.

다운로드 방법을 확인하려면 iPhone / iPad 버전은 지정된 App Store 제품 페이지에서 받으세요. 시스템 요구 사항은 App Store 페이지의 안내를 따릅니다. Mac, Windows, Android, Linux용 설치 파일은 이 사이트의 설치 안내에서 확인할 수 있습니다. 그 밖의 상황과 해결 방법은 자주 묻는 질문을 참고하세요. 한 번의 테스트 실패만으로 모든 설정을 초기화할 필요는 없습니다.