공식 가이드 · 기능 안내

Shadowrocket
기능 및 주요 설정

먼저 트래픽 처리 모드를 확인한 뒤 규칙, 연결 조건과 진단 옵션을 조정하세요.

iPhone / iPad 버전은 App Store에서 받을 수 있으며, $2.99 일회성 결제입니다. Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료입니다. 플랫폼별 이용 방법은 앱 다운로드 페이지에서 확인하세요. 컴퓨터 및 Android 설치 파일은 사이트의 /dl/ 경로에서 제공합니다. iPhone / iPad의 시스템 요구 사항은 App Store 페이지 표기를 기준으로 합니다.

먼저 Global Routing 확인 다음으로 Config 및 SERVER 확인 마지막으로 Settings 확인

아래 설명은 iPhone / iPad 화면에 표시되는 용어를 기준으로 조작 위치를 안내합니다. 다른 플랫폼에서는 메뉴 배치, 시스템 통합 기능과 사용 가능한 설정이 다를 수 있으므로 설치된 버전의 화면을 기준으로 확인하세요. 이 문서는 사용자가 보유한 구독 또는 서버 정보를 사용하는 방법을 설명하며, 노드나 구독을 제공·판매·추천하지 않습니다. 클라이언트 일회성 구매와 회선 요금제는 별개입니다.

01 · 모드

Global Routing: Config, Proxy, Direct

Global Routing은 클라이언트가 터널로 들어오는 연결을 처리하는 방식을 결정합니다. Home에서 Global Routing을 찾아 사용 목적에 따라 Config, Proxy 또는 Direct를 선택하세요. 서버 프로토콜이나 연결 스위치와는 다른 설정입니다. 모드를 선택한 뒤에도 Home에서 현재 선택된 서버와 연결 상태를 확인해야 합니다.

화면 용어 / 의미처리 방식사용 상황먼저 확인할 항목
Config / 설정현재 Config에 설정된 규칙에 따라 정책을 결정합니다.프록시, 직접 연결 또는 연결 거부를 구분해야 할 때 사용합니다.선택된 Config 파일, 규칙 순서와 최종 규칙을 확인합니다.
Proxy / 프록시일반적으로 터널에 들어오는 트래픽을 현재 프록시로 전달합니다.서버가 실제 연결을 수립할 수 있는지 임시로 확인할 때 사용합니다.현재 서버, 인증 정보와 대상 서비스의 이용 가능 여부를 확인합니다.
Direct / 직접 연결일반적으로 터널에 들어오는 트래픽을 대상으로 직접 연결합니다.문제가 프록시 경로와 관련 있는지 비교할 때 사용합니다.로컬 네트워크, DNS와 대상 웹사이트 상태를 확인합니다.

평소 규칙에 따라 사용하려면 Config를 선택한 뒤 Config에서 어떤 파일이 활성화되어 있는지 확인하세요. 문제 원인을 찾을 때는 Proxy 또는 Direct로 잠시 전환해 같은 대상을 비교 테스트할 수 있습니다. 테스트가 끝나면 원래 모드로 되돌리세요. 모드를 바꿔도 잘못된 주소, 비밀번호 또는 인증서 설정이 자동으로 수정되지는 않습니다.

02 · 트래픽 분기

규칙 유형과 PROXY / DIRECT / REJECT

규칙은 ‘일치 조건’과 ‘처리 정책’으로 구성됩니다. Config에서 현재 설정을 열어 규칙 목록이나 편집 내용을 확인하세요. Home으로 돌아온 뒤 Global Routing이 Config로 설정되어 있어야 해당 규칙이 트래픽 분기에 적용됩니다. 일반 규칙은 순서대로 비교되므로 구체적인 조건을 포괄적인 조건보다 앞에 두고, 나머지 연결은 마지막에 FINAL로 처리합니다.

PROXY는 Config의 프록시 정책으로 전달, DIRECT는 직접 연결, REJECT는 거부를 뜻합니다. 정책 이름은 현재 Config에서 인식할 수 있어야 합니다. 파일에서 사용자 지정 정책 그룹을 참조한다면 해당 그룹이 정의되어 있고 사용 가능한 항목이 선택되어 있는지도 확인하세요. 규칙 끝의 이름만 바꾸고 해당 정책이 실제로 존재하는지 확인하지 않는 일이 없도록 합니다.

오른쪽 예시는 문법 설명용이며 완전한 Config가 아니고 실제 회선 정보도 포함하지 않습니다. 추가하기 전에 현재 파일을 백업하세요. 한 번에 규칙 하나만 수정하고 저장한 뒤 현재 Config를 확인하고 새 연결을 시도하세요. 여러 항목을 동시에 바꾸면 원인을 파악하기 어렵습니다.

핵심 개념 빠른 확인에서 규칙 키워드를 설명합니다. 프로토콜 필드의 차이는 프로토콜 가이드를 참조하세요.

Rule · Policy
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-KEYWORD,ads,REJECT
FINAL,DIRECT
규칙 키워드일치 대상설정 시 참고 사항
DOMAIN지정한 전체 도메인입니다.도메인에는 프로토콜 접두사와 URL 경로를 포함하지 않습니다.
DOMAIN-SUFFIX도메인 자체와 하위 도메인입니다.사이트 도메인 범위를 기준으로 설정할 때 적합합니다.
DOMAIN-KEYWORD도메인에 포함된 키워드입니다.일치 범위가 넓으므로 의도치 않은 일치에 유의하세요.
IP-CIDR / IP-CIDR6IPv4 / IPv6 주소 대역입니다.주소 계열과 네트워크 접두사 길이를 각각 확인하세요.
GEOIPIP 지리 데이터베이스에 지정된 지역입니다.결과는 데이터베이스와 실제로 확인된 주소에 따라 달라집니다.
USER-AGENT읽을 수 있는 User-Agent 요청 필드입니다.모든 연결에서 이 필드를 확인할 수 있는 것은 아니므로 일반적인 앱 식별을 대신할 수 없습니다.
FINAL앞선 규칙에 일치하지 않은 연결입니다.보통 맨 마지막에 두어 기본 처리 정책을 명확히 합니다.
03 · 정보 관리

Subscribe 및 Add Server

서버 항목에는 단일 연결의 프로토콜, 주소, 포트와 인증 정보가 저장됩니다. 구독은 이러한 항목을 일괄적으로 가져오고 갱신하는 데 사용됩니다. 두 기능 모두 사용자가 이미 보유한 정보를 전제로 합니다. 구독과 Config는 서로 다른 개념입니다. 서버 목록을 가져온 뒤에도 사용 중인 규칙 Config와 Global Routing 모드를 따로 확인해야 합니다.

Subscribe: 기존 구독 가져오기

Home의 추가 메뉴에서 해당 유형을 열고 Subscribe를 선택한 다음, 이미 보유한 구독 URL을 입력해 저장하고 목록을 갱신하세요. 먼저 갱신이 정상적으로 완료되는지 확인한 뒤 반환된 항목이 예상과 맞는지 살펴보세요. 이름이 비슷해도 설정이 같다는 뜻은 아니므로 선택할 때 항목이 속한 그룹을 확인해야 합니다.

갱신 과정에서 구독으로 생성된 항목이 교체될 수 있으므로, 계속 보관해야 하는 수동 변경 사항을 해당 항목에만 기록하지 마세요. 갱신에 실패하면 URL이 온전한지, 만료되지 않았는지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 확인하세요. 해결을 위해 모든 Config를 반복해서 삭제하지 마세요.

Add Server: 서버 항목 하나 입력

Home에서 Add Server를 열고, 보유한 정보에 맞는 프로토콜을 선택한 다음 서버 주소, 포트와 인증 항목을 각각 입력하세요. Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2는 입력 필드가 서로 다릅니다. 주소 형식만 보고 프로토콜을 추측하지 마세요.

Scan QR Code로 가져온 경우에도 프로토콜과 주요 필드를 확인해야 합니다. 저장한 뒤 SERVER 목록에서 해당 항목을 선택하고 Connectivity Test를 실행한 다음 실제 접속을 시도하세요. 테스트 통과는 해당 테스트 조건에서의 결과만 의미합니다.

04 · 연결 조건

On Demand: 조건에 따른 자동 연결

On Demand는 조건이 충족될 때 시스템이 VPN 연결을 시작하거나 복구하도록 설정하는 기능입니다. ‘언제 연결할지’를 정하며, Global Routing은 ‘연결된 뒤 트래픽을 어떻게 처리할지’를 정합니다. 두 기능의 역할은 다릅니다. On Demand를 켜도 적절한 서버가 자동으로 선택되거나 Config의 규칙이 대신 적용되지는 않습니다.

설정 위치와 확인 방법

Settings에서 On Demand를 찾아 현재 버전에서 제공하는 네트워크 조건과 연결 동작을 확인하세요. 먼저 수동으로 연결해 서버가 정상 작동하는지 확인한 뒤 자동 연결을 켜세요. 화면에 Wi-Fi, 셀룰러 네트워크 또는 특정 네트워크 조건이 표시된다면 필요한 항목만 설정하고 모든 항목을 한꺼번에 채울 필요는 없습니다.

저장한 뒤 해당 네트워크를 한 번 전환하고 Home으로 돌아가 연결 상태를 확인한 다음 새 요청으로 실제 접속을 검증하세요. 테스트 중에는 현재 네트워크와 연결 조건도 함께 기록해 두세요. 시스템의 일시적인 네트워크 재연결을 규칙 분기 오류로 오해하지 않도록 합니다.

연결을 일시 중지할 때 주의할 점

On Demand가 켜져 있으면 연결을 수동으로 끊어도 계속 연결 해제 상태로 유지되지 않을 수 있습니다. 조건이 다시 충족되면 시스템이 재연결할 수 있습니다. 연결을 확실히 일시 중지하려면 먼저 On Demand 설정이 여전히 적용 중인지 확인한 뒤 Home의 연결 상태를 살펴보세요.

On Demand는 시스템 권한, 네트워크 상태와 현재 Config에 따라 작동합니다. 네트워크를 자주 바꾸면 터널을 다시 연결하는 데 잠시 시간이 걸릴 수 있습니다. DNS, 서버와 규칙을 동시에 변경하기보다 연결 조건을 단순화하고 항목별로 확인하세요.

05 · 사용량 확인

Data: 트래픽 통계와 연결 정보 확인

Data에서는 클라이언트에 기록된 전송량과 현재 버전에서 제공하는 연결 정보를 확인할 수 있습니다. Data에 들어가면 먼저 통계가 현재 세션, 누적값 또는 특정 기간 중 무엇을 나타내는지 확인한 다음 업로드와 다운로드 변화를 살펴보세요. 통계 초기화 기능이 있다면 필요한 수치를 기록한 뒤 실행하고 초기화 시점을 메모해 두면 이후 비교하기 쉽습니다.

문제를 확인할 때는 먼저 다른 전송 작업을 중지하고 현재 수치를 기록한 뒤 대상을 하나 방문해 새 트래픽이 발생하는지 살펴볼 수 있습니다. 연결 상세 정보가 제공된다면 도메인, 대상 주소와 적용된 정책을 함께 확인해 처리 경로를 파악하세요. 트래픽이 있다는 사실은 전송이 발생했음을 나타낼 뿐, 대상 웹페이지가 완전히 열렸거나 모든 연결에 같은 정책이 적용됐음을 증명하지는 않습니다.

클라이언트의 통계 기준은 시스템, 네트워크 사업자 또는 서버 측 기록과 다를 수 있습니다. 프로토콜 오버헤드, 통계 기간, 직접 연결 트래픽의 포함 여부 등이 결과에 영향을 줍니다. Data를 원격 계정의 잔여 데이터 확인 기준으로 사용해서는 안 되며, 한 번의 업로드량만으로 이상 여부를 판단할 수도 없습니다. 스크린샷이나 로그를 공유하기 전에 접속 기록과 서버 정보가 포함되어 있는지 확인하세요.

06 · 주요 설정

Settings: DNS, 테스트 및 시스템 통합

Settings에 들어가기 전에 현재 Config와 기존 값을 기록하세요. 플랫폼과 시스템 버전에 따라 설정 항목이 다를 수 있습니다. 아래 설명은 기능별 안내이며 모든 스위치를 켤 필요는 없습니다. Config 파일에도 같은 종류의 설정이 있다면 해당 내용을 함께 확인하세요. 화면 옵션만 변경하고 현재 Config의 영향을 놓치지 않도록 합니다.

DNS: 도메인 이름 확인

DNS는 도메인 이름을 연결에 필요한 IP 주소로 변환합니다. Settings에서 DNS 관련 항목을 확인하고 Config에서 현재 설정에 이름 확인 방식이 정의되어 있는지 살펴보세요. 사용 가능 여부를 확인한 DNS 서비스를 설정하고 일반 DNS, 암호화된 DNS와 프록시 경로를 구분하세요. 서로 다른 형식의 주소를 같은 입력란에 함께 넣지 마세요.

‘주소로는 연결되지만 도메인으로는 열리지 않는’ 문제가 발생하면 DNS 조회 실패 여부, 반환된 주소 계열에 접속할 수 있는지, DNS 요청 자체가 어떤 경로를 사용하는지 먼저 확인하세요. 변경 후에는 현재 화면에서 제공하는 방법으로 캐시를 지우거나 다시 연결한 다음 새 요청을 보내세요. 웹사이트 한 곳에서 한 번 실패했다고 IPv6를 모두 끄거나 DNS 설정 전체를 다시 작성하지 마세요.

Test Method: 테스트 방식

Test Method는 서버 목록을 테스트하는 방식을 정하며 Settings에서 해당 항목을 찾을 수 있습니다. 옵션이 연결 수립 여부를 테스트하는지, 지정된 대상의 응답을 확인하는지 먼저 파악한 뒤 Home에서 Connectivity Test를 실행하세요. 여러 항목을 비교할 때는 테스트 방식, 대상과 로컬 네트워크를 동일하게 유지하세요.

표시된 시간은 다운로드 속도가 아니며 모든 웹사이트에서의 사용 경험을 예측하지도 않습니다. 대상 사이트 상태, 핸드셰이크 과정과 순간적인 네트워크 변화가 결과에 영향을 줄 수 있습니다. 특정 방식의 테스트가 실패하면 실제 요청으로 다시 확인하고, 한 번의 결과만으로 서버 항목을 삭제하지 마세요.

Today Widget: 빠른 확인 및 조작

Today Widget은 시스템 위젯을 통한 빠른 접근 기능이며, 시스템과 현재 버전에서 이 기능을 제공하는 환경에서 사용할 수 있습니다. Settings에서 관련 옵션을 확인한 다음 시스템에서 지원하는 위젯 관리 화면에서 추가하세요. 사용할 수 있는 레이아웃과 조작 방법은 기기에 실제로 표시되는 내용을 기준으로 합니다.

처음 설정할 때도 Home으로 돌아가 서버, Global Routing과 연결 권한을 확인해야 합니다. 위젯 상태는 일정 간격을 두고 갱신될 수 있습니다. 표시 내용과 실제 접속 결과가 다르면 빠른 설정을 반복해서 전환하지 말고 먼저 앱을 열어 확인하세요. 위젯은 On Demand의 조건 설정을 대신하지 않습니다.

iCloud: Config 동기화

iCloud는 이 기능을 지원하는 기기 간에 해당 Config 내용을 동기화하는 데 사용됩니다. Settings 또는 Config 관리 화면의 클라우드 항목에서 동기화할 수 있는 항목을 확인하고, 시스템의 iCloud 권한과 로그인 상태도 살펴보세요. 동기화 범위는 현재 화면의 안내를 기준으로 하며 모든 서버 항목, 통계 또는 연결 상태가 포함된다고 가정해서는 안 됩니다.

기능을 켜기 전에 로컬 백업을 저장하세요. 여러 기기에서 같은 Config를 동시에 편집하지 마세요. 내용이 충돌하면 먼저 파일을 비교한 뒤 유지할 파일을 결정해 사용 중인 규칙이 덮어써지지 않도록 합니다. Config에는 구독 URL과 인증 정보가 포함될 수 있으므로 계정 및 기기 접근 권한을 고려해 동기화 여부를 결정하세요.

07 · 문제 해결

Diagnostics: 근거를 바탕으로 문제 범위 좁히기

Diagnostics에는 현재 버전에서 사용할 수 있는 진단 기능이 제공됩니다. Settings에서 Diagnostics를 찾아 문제에 맞는 도구나 기록 방식을 선택하세요. 구독 갱신, 연결 수립, 도메인 조회, 대상 접속 중 어느 단계에서 실패하는지 먼저 파악한 뒤 해당 항목을 점검하세요. 모든 문제를 서버 속도 탓으로 돌리지 마세요.

  1. 로컬 네트워크를 확인합니다. 클라이언트 연결을 잠시 끊고 로컬 네트워크에서 원래 접속할 수 있던 서비스에 정상적으로 접속되는지 확인해 Wi-Fi 로그인 페이지나 시스템 네트워크 전환 등의 영향을 배제합니다.
  2. 연결 매개변수를 확인합니다. 프로토콜, 주소, 포트, 인증 및 TLS 관련 항목을 점검하고 복사 과정에서 공백이 들어가거나 내용이 빠지지 않았는지 살펴보세요. 인증서 오류가 발생하면 도메인, 기기 시간과 설정을 확인해야 하며 검증을 무시해서는 안 됩니다.
  3. 모드와 규칙을 분리해 확인합니다. 같은 대상을 사용해 Proxy와 Config를 각각 테스트하세요. Proxy는 정상인데 Config에서 실패한다면 규칙 일치, 정책 참조와 DNS 경로를 중점적으로 확인합니다.
  4. 문제를 재현하는 데 필요한 정보를 기록합니다. 문제가 발생한 네트워크 유형, 조작 단계, 대상과 오류 메시지를 적어 두세요. 필요한 경우에만 상세 기록을 켜고 재현한 뒤 중지해 불필요한 데이터 수집과 개인정보 노출을 줄이세요.

로그에는 대상 도메인, IP 주소, 구독 URL 또는 계정 정보가 포함될 수 있습니다. 공유하기 전에 민감한 부분을 가리되 오류 유형과 필요한 상황 정보는 남기세요. ‘연결할 수 없음’이라는 설명만으로는 DNS 조회 실패, 핸드셰이크 실패와 규칙 선택 오류를 구분하기 어렵습니다.

08 · 확인 순서

설정을 변경한 뒤 적용 여부 확인하기

‘Home에서 서버 선택 → Config에서 파일 확인 → Global Routing 모드 선택 → 연결 수립 → 새 요청 전송 → Data 또는 Diagnostics에서 결과 확인’ 순서로 점검하세요. 한 번에 한 가지 영향 요소만 변경하고 기존 값은 기록해 둡니다. 결과가 나빠지면 해당 항목을 먼저 원래대로 되돌린 다음 계속 확인하세요. 처음 사용하는 경우 빠른 시작 가이드의 단계를 따라 진행할 수 있습니다.

구독을 가져왔는데 왜 규칙대로 트래픽이 분기되지 않나요?

구독은 주로 서버 항목을 제공하며 필요한 규칙 Config까지 포함한다고 보장하지는 않습니다. 먼저 Home에서 Global Routing이 Config로 설정되어 있는지 확인한 뒤 Config에서 선택된 파일, 규칙 순서와 정책 참조를 점검하세요. 가져오기에 성공했다고 해서 현재 파일이 적용된 것은 아닙니다.

Connectivity Test는 통과했는데 웹페이지가 열리지 않습니다. 무엇부터 확인해야 하나요?

테스트와 실제 접속에 같은 서버 항목을 사용했는지 먼저 확인한 다음 대상 도메인의 DNS 결과, 일치한 규칙과 연결 오류를 점검하세요. 테스트 대상과 실제 웹페이지는 서로 다른 경로를 사용할 수 있으므로 한 번 응답이 왔다고 모든 접속이 정상인 것은 아닙니다.

연결을 끊어도 자동으로 다시 연결됩니다. 어떤 설정을 바꿔야 하나요?

먼저 On Demand의 활성화 상태와 연결 조건을 확인하세요. 네트워크 조건이 충족되면 다시 연결될 수 있습니다. 연결을 일시 중지하려면 On Demand 동작을 먼저 조정한 뒤 Home에서 상태를 확인하세요. On Demand를 끄는 대신 서버나 Config 파일을 삭제하지 마세요.

컴퓨터와 Android에서도 Shadowrocket을 사용할 수 있나요?

네. iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제이며, Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료입니다. 전 플랫폼 다운로드 안내에서 해당 플랫폼을 선택하세요. 설정 위치와 시스템 통합 기능은 플랫폼별 화면을 기준으로 합니다.