공식 핸드북 · 기능 및 설정

Shadowrocket 기능 안내

Global Routing부터 Settings까지 ‘무엇인지, 어디에 있는지, 설정 방법과 주의사항’을 항목별로 확인하세요.

iPhone과 iPad 사용을 중심으로 안내합니다. 먼저 보유한 구독 또는 서버 정보를 준비한 뒤 요청 처리 방식을 설정하세요. 기능을 켜는 것만으로 유효한 연결 정보가 생기지는 않습니다.

  • Config / Proxy / Direct
  • 규칙과 정책을 따로 확인
  • 설정은 한 번에 하나씩 변경

Global Routing: 세 가지 요청 처리 모드

연결 스위치는 연결을 시작할지 결정하고, Global Routing은 연결된 뒤 요청을 어떤 방식으로 처리할지 결정합니다. 서로 다른 설정입니다.

Home에서 Global Routing을 찾아 Config, Proxy 또는 Direct를 선택합니다. 여기서 Config, Proxy, Direct는 각각 구성에 따른 처리, 프록시 처리, 직접 연결을 뜻합니다. 실제 조작 시에는 영어 인터페이스 용어를 확인하세요. 모드를 선택하기 전에 사용할 수 있는 서버가 선택되어 있는지 확인하세요. 규칙에 따라 요청을 분기하려면 Config에서 현재 사용 중인 구성 파일도 확인해야 합니다.

화면 옵션 처리 방식 사용 상황 확인할 항목
Config · 구성 현재 구성의 규칙과 정책에 따라 요청을 처리합니다. 도메인이나 주소에 따라 서로 다른 정책을 적용할 때 사용합니다. 구성이 적용되었는지, 규칙 순서, 정책 이름과 정책 대상
Proxy · 프록시 Proxy 방식으로 요청을 처리하며, Config의 일반 규칙에 따라 요청을 개별 분기하지 않습니다. 선택한 서버로 원하는 대상에 접속할 수 있는지 임시로 확인할 때 사용합니다. 서버 정보, 현재 선택 항목, 대상 사이트와 기본 네트워크
Direct · 직접 연결 요청을 직접 연결 방식으로 처리합니다. 로컬 네트워크에서의 접속 상태와 비교해 문제 범위를 좁힐 때 사용합니다. 로컬 네트워크와 DNS를 확인하세요. 시스템 연결 스위치로 오해하지 마세요.

일상적인 규칙 분기에는 Config를 사용하고, 비교할 때만 모드를 전환하세요

구성 파일을 사용 중이라면 Config를 선택한 뒤, 직접 연결될 것으로 예상되는 대상 하나와 프록시를 사용할 것으로 예상되는 대상 하나에 접속하고 해당 요청 기록을 확인하세요. 테스트에는 응답이 있지만 페이지가 열리지 않는다면 Proxy로 잠시 전환해 같은 대상을 다시 테스트할 수 있습니다. Proxy에서는 접속되고 Config에서는 되지 않는다면 규칙, 정책과 DNS 결과를 먼저 확인하세요. 두 모드 모두 접속되지 않으면 서버와 로컬 네트워크를 확인하세요. 이 비교는 문제 범위를 좁히는 데 도움이 되지만, 한 번의 성공이나 실패만으로 원인을 단정할 수는 없습니다.

테스트가 끝나면 기존 Global Routing 설정으로 되돌리세요. Direct는 시스템 VPN 구성을 끄는 기능이 아닙니다. 앱 연결을 완전히 중지하려면 Home의 연결 스위치를 사용하고, On Demand가 다시 연결을 시작할 수 있는지도 확인하세요.

전체 핸드북에서 Global Routing 알아보기 →

규칙 분기: 매칭 조건과 실행 정책

규칙은 ‘어떤 요청이 조건에 맞는지’를 정하고, 정책은 ‘조건에 맞은 요청을 어떻게 처리할지’를 정합니다. 먼저 매칭을 확인한 다음 처리 경로를 확인하세요.

규칙은 일반적으로 Config에서 구성 파일과 함께 관리합니다. 현재 사용 중인 구성을 열어 규칙 내용과 순서를 확인하고, 수정 전에 복사본을 보관하세요. 일반 규칙은 나열된 순서대로 매칭되므로 구체적인 조건을 넓은 조건보다 앞에 두세요. FINAL은 보통 앞선 규칙에 매칭되지 않은 요청을 처리하도록 마지막에 둡니다. 규칙을 추가했더라도 해당 구성을 선택하지 않았거나 Global Routing이 Config가 아니면 실제 동작이 예상과 달라질 수 있습니다.

도메인으로 매칭

DOMAIN은 지정한 도메인과 매칭되고, DOMAIN-SUFFIX는 도메인 접미사와 매칭되며, DOMAIN-KEYWORD는 도메인에 포함된 키워드로 매칭됩니다. 특정 대상 하나만 조정하려면 범위가 명확한 조건을 우선 고려하세요. 키워드 범위가 너무 넓으면 다른 대상에도 영향을 줄 수 있습니다.

주소 및 기타 조건으로 매칭

IP-CIDR과 IP-CIDR6은 IP 주소 대역에 사용하고, GEOIP는 IP 주소의 위치 정보에 따라 매칭합니다. USER-AGENT는 해당 요청 정보를 가져올 수 있는지에 따라 적용 가능 여부가 달라집니다. 모든 앱 트래픽을 이름으로 식별할 수 있다고 가정해서는 안 됩니다.

먼저 규칙 예시를 이해한 뒤 필요한 내용으로 바꾸세요

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

이 문법 예시는 example.com 하위 도메인 요청을 PROXY로 처리하고, 지정된 로컬 네트워크 주소 대역의 요청은 DIRECT로 처리하며, 나머지 요청은 FINAL에 지정된 PROXY로 보내는 방식입니다. 규칙 구조를 설명하기 위한 예시로, 모든 네트워크에 적합한 완성된 구성은 아닙니다. PROXY, DIRECT, REJECT는 각각 프록시, 직접 연결, 거부 처리를 뜻합니다. 규칙에서 사용자 지정 정책 이름을 참조한다면 구성에 정의된 이름과 정확히 일치해야 합니다.

설정 후에는 대상에 다시 요청을 보내고 매칭된 규칙과 처리 정책을 확인하세요. 규칙이 매칭되었다고 해서 해당 정책이 가리키는 서버까지 반드시 사용할 수 있는 것은 아닙니다. 서버를 사용할 수 있더라도 모든 대상이 예상대로 매칭되는 것은 아닙니다. DNS 조회, 캐시와 기존 연결이 재테스트 결과에 영향을 줄 수 있으므로 검증할 때는 대상과 테스트 조건을 최대한 동일하게 유지하세요.

구독 및 서버 관리

서버 항목에는 연결 정보가 저장되고, Subscribe는 여러 항목을 관리하는 기능입니다. Config는 주로 규칙과 관련 설정을 관리하므로 세 기능의 용도는 서로 다릅니다.

Add Server: 보유한 서버 정보 입력

Home에서 Add Server를 눌러 항목을 추가하세요. 서비스에서 안내한 프로토콜을 선택한 뒤 주소, 포트, 인증 정보와 전송 설정을 확인합니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등의 프로토콜은 입력 항목이 서로 다르므로 한 프로토콜의 정보를 다른 프로토콜에 그대로 적용하면 안 됩니다. 특히 UUID, 비밀번호, 암호화 방식, TLS, SNI, Host와 경로는 보유한 정보를 기준으로 항목별로 입력하세요. 이름만 보고 값을 추측하지 마세요.

Scan QR Code를 사용하는 경우, QR 코드가 보유한 서비스 정보에서 생성된 것인지 먼저 확인하세요. 가져오기가 끝나면 항목을 열어 프로토콜과 주요 입력값을 확인한 뒤 해당 항목을 선택해 테스트하세요. 목록에 표시된다는 것은 가져오기 과정에서 항목이 생성되었다는 뜻일 뿐, 서버가 온라인이거나 인증 및 전송 정보가 모두 올바르다는 뜻은 아닙니다.

Subscribe: 기존 구독 가져오기 및 업데이트

추가 메뉴에서 Subscribe를 선택하고 보유한 구독 주소를 입력해 저장한 다음 업데이트를 실행하세요. 업데이트 후 그룹, 항목 이름과 개수의 변화를 확인하고 현재 선택한 서버가 남아 있는지도 살펴보세요. 구독 업데이트는 해당 구독에서 제공하는 서버 정보를 새로 고치는 기능이며, 현재 Config의 모든 규칙을 바꾸는 기능은 아닙니다. 서버 측 설정에 따라 항목 이름, 주소 또는 정보가 바뀔 수 있고, 기존에 선택한 항목이 삭제될 수도 있습니다.

업데이트에 실패하면 먼저 주소가 완전한지, 구독이 유효한지 확인한 다음 현재 네트워크에서 해당 주소에 접속할 수 있는지 살펴보세요. 기존 구성을 보존한 상태에서 네트워크를 바꿔 다시 테스트할 수 있지만, 문제를 확인하는 대신 구독 전체를 반복해서 삭제하지 마세요. 구독 주소에는 접속 자격 정보가 포함되는 경우가 많으므로 스크린샷, 진단 파일과 공개 문의 글에는 전체 주소가 드러나지 않도록 하세요.

Config: 복원 가능한 구성 복사본 저장

규칙이나 DNS를 조정하기 전에 현재 구성을 백업하고, 복사본의 용도를 알아볼 수 있게 이름을 지정하세요. 다른 구성을 가져온 뒤에는 실제로 어떤 파일을 선택했는지 확인하고, 그 안의 정책 참조가 현재 서버나 정책 그룹과 일치하는지도 살펴보세요. 백업 파일에는 서버 주소와 인증 정보가 포함될 수 있으므로 직접 관리할 수 있는 위치에 보관하세요. 앱만 복원해도 모든 로컬 구성이 복구되는 것은 아닙니다.

시작 가이드에서 최초 가져오기와 연결 방법 확인 →

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

On Demand는 ‘언제 연결할지’를 결정하고, Global Routing은 ‘연결 후 요청을 어떻게 처리할지’를 결정합니다. 하나를 켜도 다른 기능을 대신할 수 없습니다.

Settings에서 On Demand를 찾아 필요에 따라 Wi-Fi, Cellular 등의 조건을 확인하세요. 실제로 표시되는 옵션은 앱 화면과 기기의 네트워크 기능에 따라 다를 수 있습니다. 조건을 설정하기 전에 Home에서 직접 연결하고 대상에 접속해 서버와 구성이 정상적으로 작동하는지 확인하세요. 그러면 서버 정보 오류를 자동 연결 조건 오류로 오해하는 일을 줄일 수 있습니다.

조건 하나로 먼저 테스트한 뒤 적용 범위를 넓히세요

자동 연결이 필요한 네트워크 조건 하나를 먼저 선택해 저장한 다음 해당 네트워크로 전환하고 연결 상태와 실제 접속 결과를 확인하세요. 여러 조건을 동시에 켜면 어느 조건이 연결을 시작했는지 파악하기 어렵습니다. iPad에서는 기기에서 실제로 사용할 수 있는 네트워크 기능을 기준으로 확인하세요. Wi-Fi만 지원하는 기기는 셀룰러 네트워크 상황을 기준으로 문제를 확인할 수 없습니다.

연결을 직접 껐는데 다시 자동으로 연결되면 시스템의 VPN 구성을 반복해서 삭제하기보다 먼저 On Demand 조건을 확인하세요. 직접 연결 비교 테스트가 필요하면 On Demand를 잠시 끈 다음 Home의 연결 스위치를 끄세요. 테스트가 끝나면 기존 설정을 복원하세요. On Demand를 켜도 서버가 항상 사용 가능한 것은 아닙니다. 네트워크 전환, 인증 실패와 시스템 상태가 실제 연결에 영향을 줄 수 있으므로 접속 결과를 기준으로 확인하세요.

전체 핸드북에서 On Demand 알아보기 →

Data: 업로드·다운로드와 통계 범위 이해

Data는 앱에 기록된 트래픽을 확인하는 기능입니다. 연결 성공을 증명하지 않으며 서비스 제공업체의 요금 청구 내역과도 다릅니다.

Data를 열고 현재 통계 화면, 기록 범위와 데이터 삭제 여부를 먼저 확인한 다음 업로드 및 다운로드 수치를 살펴보세요. 서버별 또는 앱 관련 기준으로 볼 수 있는 화면이 있다면 현재 그룹화 방식도 확인하세요. 화면마다 분류 기준이 다를 수 있으므로 특정 화면의 수치를 앱 하나의 전체 네트워크 사용량으로 간주하지 마세요. 소속을 확인할 수 없는 기록만으로 정확한 판단을 내리는 것도 적절하지 않습니다.

한 번의 작업으로 변화를 확인

같은 서버와 Global Routing 설정을 유지한 상태에서 테스트 전 수치를 기록하고, 명확한 접속 작업을 한 번 수행한 다음 Data로 돌아와 변화를 확인하세요. 이 방법으로 트래픽이 발생했는지 살펴볼 수 있지만, 백그라운드 동기화, 재시도 요청과 다른 앱의 활동도 함께 집계될 수 있습니다. 수치가 뚜렷하게 달라지지 않았다면 연결 상태, 대상 요청이 실제로 발생했는지, 현재 화면이 해당 접속을 포함하는지도 확인하세요.

앱과 서비스 제공업체의 관리 화면 통계는 기록 주기, 송수신량 산정 기준, 프로토콜 오버헤드, 과금 방식과 여러 기기 사용 여부에 따라 달라질 수 있습니다. 차이만으로 이상 여부를 판단하거나 Data의 누적 수치를 구독 잔여량으로 해석하지 마세요. 문제를 확인할 때는 같은 시간 범위의 수치와 테스트 조건을 기록하세요. 서비스 사용량을 확인하려면 보유한 서비스의 계정 기록을 살펴보세요.

Data 트래픽 통계 산정 기준 알아보기 →

Settings: 자주 쓰는 설정 6가지

설정 메뉴와 구성 파일이 함께 결과에 영향을 줄 수 있습니다. 현재 값을 기록한 다음 한 항목씩 변경하세요. 메뉴 위치와 사용 가능한 옵션은 현재 앱 화면을 기준으로 합니다.

DNS: 도메인 조회 방식

무엇이며 어디에 있나요:DNS는 도메인 이름을 네트워크 주소로 변환합니다. Settings의 DNS 관련 메뉴와 현재 Config에서 옵션을 확인하세요. 현재 구성이 DNS 설정을 포함하는지도 함께 살펴봐야 하며, 한 화면의 값만 확인해서는 충분하지 않습니다.

어떻게 설정하고 무엇을 주의해야 하나요:먼저 현재 조회 방식과 구성에 포함된 DNS 항목을 확인해 실제로 어떤 경로를 사용하는지 살펴본 다음 필요에 따라 조정하세요. 변경 후 같은 도메인에 다시 요청을 보내고 기록을 확인합니다. 서버 테스트에 응답이 있지만 웹페이지가 열리지 않는다면 DNS 조회 실패, 연결 실패와 대상 응답 실패를 구분하세요. 서로 다른 DNS 설정을 한 번에 여러 개 추가하면 어떤 설정이 적용되었는지 파악하기 어렵고 원래 상태로 되돌리기도 힘듭니다.

Test Method: 테스트 방법

무엇이며 어디에 있나요:Settings에서 Test Method를 찾아 연결 가능성 테스트에 사용할 방법을 선택합니다. Connectivity Test 결과는 테스트 방식, 대상과 현재 네트워크에 따라 달라지며 고정된 서버 성능 지표가 아닙니다.

어떻게 설정하고 무엇을 주의해야 하나요:문제 확인 목적에 맞는 방법을 선택한 뒤 같은 네트워크에서 같은 항목을 다시 테스트하세요. 결과를 비교하기 전에 테스트 조건이 같은지 확인합니다. 특정 방법에서 응답이 왔다는 것은 해당 테스트 경로에서 응답을 받았다는 뜻일 뿐, 모든 웹페이지와 전송 방식이 정상 작동하거나 지속적인 처리량을 보장한다는 뜻은 아닙니다. 실패가 표시되어도 실제 접속 결과를 함께 확인하고, 수치 하나만 보고 항목을 삭제하지 마세요.

Today Widget: 빠른 실행

무엇이며 어디에 있나요:Settings에서 Today Widget 관련 설정을 확인한 다음 시스템에서 지원하는 위젯 위치에 해당 항목을 추가합니다. 실제로 표시되는 내용과 지원 방식은 시스템 버전 및 앱의 현재 기능에 따라 달라지므로 기기 화면에서 사용 가능 여부를 확인하세요.

어떻게 설정하고 무엇을 주의해야 하나요:앱에서 서버를 선택하고 처음 VPN 구성을 승인한 다음 위젯에서 실행했을 때 예상대로 작동하는지 확인하세요. 위젯 상태와 메인 화면이 다르면 앱을 열어 연결 상태와 갱신 여부를 먼저 확인합니다. 빠른 실행은 조작을 간소화할 뿐 서버 정보, Config 선택이나 시스템 승인을 대신하지 않습니다. 위젯 아이콘만으로 요청이 실제로 어떤 규칙을 따랐는지 판단하지 마세요.

iCloud: 구성 동기화

무엇이며 어디에 있나요:Settings에서 iCloud 관련 옵션을 확인하고 시스템 계정과 iCloud 권한도 살펴보세요. 동기화는 지원 범위 내에서 구성 데이터를 저장하거나 전달하는 기능입니다. 동기화되는 항목은 앱의 현재 안내를 기준으로 하며, 모든 연결 상태와 로컬 기록이 동기화된다고 가정해서는 안 됩니다.

어떻게 설정하고 무엇을 주의해야 하나요:먼저 현재 구성을 복사해 둔 다음 동기화를 켜고 다른 기기에서 파일과 내용이 모두 온전한지 확인하세요. 구성 충돌이 발생하면 먼저 어느 쪽을 보존할지 정하고 두 기기에서 연달아 덮어쓰지 마세요. App Store 구매 기록과 iCloud 데이터 동기화는 서로 별개입니다. 앱을 다시 받은 뒤에도 구성, 서버 정보와 연결 권한을 각각 확인해야 합니다.

Diagnostics: 진단 정보

무엇이며 어디에 있나요:Settings에서 Diagnostics를 찾아 문제 확인에 필요한 정보를 수집하거나 살펴보세요. 진단 자료는 문제 재현 절차와 함께 확인해야 합니다. 로그 하나만으로는 문제가 발생했을 때의 모든 설정을 파악하기 어려운 경우가 많습니다.

어떻게 설정하고 무엇을 주의해야 하나요:먼저 네트워크 유형, 선택한 서버, Global Routing과 문제가 발생하는 대상을 기록한 다음 문제를 한 번 재현하고 관련 기록을 확인하세요. 자료를 공유하기 전에 구독 주소, 인증 정보, 개인 주소와 기타 민감 정보를 삭제해야 합니다. 문제와 관련된 부분만 남기고 이미 시도한 조정 내용도 설명하세요. 진단이 끝나면 임시로 변경한 기록 옵션을 평소 설정으로 되돌리세요.

연결과 권한: 먼저 시스템 상태 확인

무엇이며 어디에 있나요:처음 연결할 때 시스템이 표시하는 VPN 구성 요청은 앱이 해당 네트워크 연결을 만들도록 허용하는 절차입니다. 앱의 연결 스위치는 시스템에 저장된 VPN 구성과 관련이 있지만 Config 규칙 파일과는 다릅니다.

어떻게 설정하고 무엇을 주의해야 하나요:시스템 안내를 읽고 필요한 경우 허용한 다음 Home으로 돌아가 연결 상태를 확인하세요. 이전에 시스템 구성을 거부하거나 삭제했다면 Config에서 규칙을 반복해서 바꾸기보다 연결을 다시 시작해 안내가 표시되는지 확인하세요. 시스템에 연결됨으로 표시되어도 대상에 실제로 접속되는지 검증해야 합니다. 권한 승인은 연결을 만들 수 있게 해줄 뿐 구독이나 서버에 입력한 잘못된 정보를 수정하지 않습니다.

시스템 VPN 구성과 연결 스위치의 관계 알아보기 →

설정 확인 순서

연결 정보, 처리 모드, 규칙과 DNS, 자동 연결의 네 단계로 확인해 여러 설정을 동시에 바꾸지 않도록 하세요.

  1. 먼저 보유한 서버 정보를 확인합니다.프로토콜, 주소, 포트, 인증 정보와 전송 설정을 확인하고 해당 항목을 선택해 직접 연결을 한 번 테스트하세요. 가져오기에 성공했는지와 실제로 사용할 수 있는지는 별도로 확인해야 합니다.
  2. 다음으로 Global Routing을 정합니다.일상적인 규칙 분기에는 Config를 사용하고 예상한 구성이 선택되어 있는지 확인하세요. Proxy와 Direct는 목적이 명확한 임시 비교에 사용하고, 테스트가 끝나면 기존 설정으로 되돌립니다.
  3. 요청 기록에서 규칙과 DNS를 확인합니다.먼저 DNS 조회가 성공했는지 확인한 뒤 매칭 조건과 최종 정책을 살펴보세요. 서버 테스트, 도메인 조회와 대상 응답은 서로 다른 단계이므로 하나의 결과로 모두 판단하지 마세요.
  4. 마지막으로 On Demand와 편의 기능을 설정합니다.직접 접속 테스트를 통과한 뒤 자동 연결, Today Widget과 iCloud를 설정하고 복원용 사본을 보관하세요. 설정을 바꿀 때마다 같은 대상을 다시 테스트하고 변화를 기록합니다.