공식 매뉴얼 · 기능 및 설정

Shadowrocket 기능 소개
및 자주 쓰는 설정

먼저 Global Routing을 설정한 다음 Config와 현재 서버를 확인하세요. 연결이 정상이라면 On Demand, DNS, 동기화를 설정합니다. 설정이 실제 연결에 미치는 영향을 확인하기 쉽도록 한 번에 한 항목씩 변경하세요.

단계별 사용법 보기 App Store 정품 구매 안내
  • Home
  • Config
  • Data
  • Settings

GLOBAL ROUTING

Global Routing 세 가지 모드의 사용 상황

Global Routing은 Shadowrocket으로 들어오는 연결을 어떤 방식으로 처리할지 결정합니다. Home에서 Global Routing을 열고 Config, Proxy 또는 Direct를 선택하세요. 각 옵션은 라우팅 방식을 바꾸지만 서버를 만들거나 연결 정보를 채워 주지는 않습니다. 설정한 뒤 Home으로 돌아가 현재 서버와 연결 스위치를 확인하세요.

모드 처리 방식 사용 상황 확인할 항목
Config (구성) 현재 활성화된 구성 규칙에 따라 정책을 선택합니다. 도메인이나 주소 대역 등의 조건에 따라 트래픽을 분류할 때 사용합니다. 활성화된 구성 파일, 규칙 순서, 정책 참조
Proxy (프록시) 트래픽을 프록시로 라우팅합니다. 단, 적용 범위는 시스템과 앱의 제한을 받습니다. 현재 서버로 대상 연결을 처리할 수 있는지 임시로 확인할 때 사용합니다. 서버 연결 가능 여부, 프로토콜 매개변수, 대상 접속 결과
Direct (직접 연결) 트래픽을 직접 연결로 처리하며, 이 설정으로 프록시 서버를 테스트할 수는 없습니다. 로컬 네트워크와 대상에 연결할 수 있는지 임시로 확인할 때 사용합니다. 로컬 네트워크, 도메인 확인, 대상 서비스 상태

평소 규칙에 따라 트래픽을 분류할 때는 Config를 사용하세요. Config에서 특정 대상에 연결되지 않지만 Proxy에서는 접속된다면, 프로토콜을 바로 바꾸기보다 규칙이 어떤 정책과 일치했는지 먼저 확인하세요. Direct에서도 접속할 수 없다면 로컬 네트워크와 대상 상태를 점검하세요. 한 번의 접속 실패만으로 문제가 반드시 앱에 있다고 단정할 수는 없습니다.

Proxy와 Direct는 비교 테스트에 유용하지만 테스트가 끝난 뒤 원래 모드로 되돌리는 것을 잊지 마세요. 모드를 바꿔도 기존 장기 연결은 즉시 다시 연결되지 않을 수 있습니다. 확인하려면 요청을 새로 보내고, 필요하면 설정을 저장한 후 다시 연결하세요. Global Routing이 시스템의 모든 통신을 완전히 제어하는 것은 아니며, 시스템 서비스와 앱 자체의 연결 방식도 결과에 영향을 줄 수 있습니다.

RULE MATCHING

규칙 유형, 정책, 일치 순서

규칙은 “어떤 연결을 어떤 정책으로 처리할지” 지정합니다. Config에서 활성화된 구성 파일과 규칙을 확인하고 Global Routing은 Config로 설정하세요. 규칙 유형은 일치 조건을, 정책은 일치 후 처리 방식을 나타냅니다. 둘을 혼동하지 마세요. 일반적으로 범위가 명확한 규칙을 먼저 배치하고, 범위가 넓은 규칙을 뒤에 둔 다음 기본 처리 규칙을 확인합니다.

DOMAIN

DOMAIN-SUFFIX

도메인 접미사로 일치시킵니다. 예를 들어 example.com은 해당 도메인과 하위 도메인에 적용될 수 있습니다. DOMAIN은 정확한 도메인을, DOMAIN-KEYWORD는 키워드를 기준으로 일치시킵니다. 키워드 범위가 너무 넓으면 원하지 않는 대상까지 포함될 수 있습니다.

ADDRESS

GEOIP

IP 위치 데이터베이스를 기준으로 일치시키며, 웹사이트의 언어나 콘텐츠를 기준으로 판단하지 않습니다. 데이터베이스 기록, DNS 응답, 실제 서비스 위치는 서로 다를 수 있으므로 웹사이트 이름만 보고 어떤 GEOIP 조건에 해당할지 추측할 수 없습니다.

NETWORK

IP-CIDR / IP-CIDR6

IPv4와 IPv6 주소 대역을 각각 일치시킵니다. 설정 전에 주소 유형과 프리픽스 길이를 확인하세요. 같은 도메인에서도 서로 다른 주소가 반환될 수 있으므로 IPv4 규칙만으로 IPv6 연결도 같은 방식으로 처리된다고 판단해서는 안 됩니다.

FALLBACK

FINAL

앞선 조건과 일치하는 규칙이 없을 때 적용되는 기본 규칙입니다. 도메인이나 주소 대역 일치 값은 지정하지 않습니다. FINAL의 정책을 확인하면 별도 규칙이 없는 대상이 최종적으로 프록시 또는 직접 연결 중 어느 쪽으로 처리되는지 파악할 수 있습니다.

PROXY, DIRECT, REJECT

PROXY는 프록시 처리, DIRECT는 직접 연결, REJECT는 해당 연결 거부를 의미합니다. 구성에서 사용자 지정 정책이나 정책 그룹 이름을 사용한다면 참조 대상이 존재하고 이름 철자가 일치하는지 확인하세요. 아래는 문법 설명을 위한 예시이며 완전한 구성 파일이 아닙니다. 예시 도메인은 규칙 구조를 설명하기 위한 것입니다.

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

REJECT는 페이지의 특정 부분이 아니라 연결을 대상으로 합니다. 페이지 본문과 다른 리소스가 같은 도메인을 사용한다면 해당 도메인을 거부할 때 정상 기능도 영향을 받을 수 있습니다. USER-AGENT 등의 조건은 클라이언트가 관련 정보를 가져올 수 있어야 하므로 모든 암호화 연결에 적용되는 것은 아닙니다. 규칙을 수정한 뒤에는 실제 연결 기록에서 대상, 일치 규칙, 최종 정책을 확인하세요. 페이지가 달라 보이는지만으로 판단하지 마세요.

프로토콜 필드와 선택 기준을 알아보려면 프로토콜 기술 참고 자료를 확인하세요. 규칙 일치 오류와 프로토콜 매개변수 오류는 서로 다른 문제입니다. 문제를 해결할 때는 먼저 트래픽이 어디로 향했는지 확인한 다음 연결을 설정할 수 있는지 점검하세요.

SERVER MANAGEMENT

기존 구독 및 서버 관리

서버 항목에는 단일 연결에 필요한 주소, 포트, 프로토콜, 인증 정보가 저장됩니다. 구독은 여러 항목을 가져오고 업데이트하는 데 사용됩니다. 이러한 정보는 주로 Home에서 관리합니다. 이미 구독을 보유한 경우 Add Server를 열고 Subscribe를 선택한 뒤 전체 링크를 입력하세요. 개별 서버 정보를 보유한 경우 실제 프로토콜 유형을 선택하고 제공된 정보에 따라 항목을 입력합니다. QR 코드가 있다면 Scan QR Code로 가져온 뒤 내용을 확인하세요.

가져온 뒤 확인하고 연결하기

저장한 뒤 항목 이름, 프로토콜 유형, 서버 주소와 포트를 확인하고 사용하려는 서버가 선택되었는지 살펴보세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 매개변수 구조가 다르므로 Type만 바꿔 한 프로토콜을 다른 프로토콜로 전환할 수 없습니다. TLS 이름과 전송 설정 같은 추가 항목도 기존 정보와 일치해야 합니다. 테스트를 통과시키려고 검증을 임의로 끄지 마세요.

구독을 업데이트하면 원격 목록을 다시 가져오지만, 기존 항목의 이름과 개수가 그대로 유지된다는 보장은 없습니다. 업데이트 전에 구독 그룹을 확인하고, 업데이트 후에는 현재 선택된 항목을 다시 확인하세요. 구독에서 생성된 항목을 직접 편집했다면 다음 업데이트에서 수정 내용이 덮어써질 수 있습니다. 별도로 유지해야 할 설정은 앱에서 저장 및 관리하는 방법을 먼저 확인하세요.

목록이 비어 있는 경우와 연결 실패는 따로 확인

목록이 비어 있다면 먼저 링크가 온전히 복사되었는지, 공백이 섞이지 않았는지, 응답 내용이 지원되는 구독 형식인지 확인한 뒤 기존 구독의 유효 상태를 점검하세요. 목록은 있지만 연결에 실패한다면 주소, 포트, 인증 정보, 네트워크 연결 가능 여부를 확인합니다. Config의 라우팅 구성과 Home의 서버 목록은 용도가 다릅니다. 구독을 가져왔다고 적절한 분류 규칙까지 활성화된 것은 아닙니다.

구독 링크에는 접근 자격 정보가 포함될 수 있습니다. 문제를 문의할 때는 오류 유형만 설명하고, 스크린샷과 로그에서는 링크 매개변수, 인증 정보, 개인 주소를 가리세요. 전체 링크를 공개 게시판에 붙여 넣지 마세요. 자세한 가져오기 순서는 사용법 안내를 확인하세요.

ON DEMAND

On Demand 조건 설정 및 확인

On Demand는 설정된 조건에 따라 시스템이 VPN 연결을 시작하도록 합니다. 이는 “언제 연결할지”를 정하는 기능이지 “연결 후 어떻게 분류할지”를 정하는 기능은 아닙니다. 후자는 Global Routing과 현재 구성에 따라 결정됩니다. 구독 자동 업데이트와도 다르며, 자동 연결로 만료된 서버 정보를 보충하지 않습니다.

Settings에서 On Demand를 찾아 현재 버전에 표시되는 조건을 확인하고 실제 네트워크 환경에 맞게 설정하세요. 처음 설정하기 전에 Home에서 수동으로 연결해 서버가 작동하는지 확인한 다음 자동 실행을 켜세요. Wi-Fi 관련 조건이 있다면 네트워크 이름과 해당 동작을 하나씩 확인해 연결 대상에서 제외하려던 환경을 실수로 조건에 포함하지 않도록 하세요.

설정한 뒤 조건에 해당하는 환경과 해당하지 않는 환경에서 각각 테스트하고 시스템 VPN 상태와 앱의 연결 상태를 살펴보세요. 수동으로 연결을 끊었는데 다시 연결되더라도 스위치가 고장 난 것은 아닐 수 있습니다. On Demand 조건이 다시 충족되었을 가능성도 있습니다. 문제를 확인할 때는 기존 조건을 먼저 기록한 뒤 On Demand를 일시 중지하고 수동 테스트를 마친 후 다시 켜세요.

DATA

트래픽 통계와 연결 결과의 차이

Data에서는 클라이언트가 기록한 트래픽 정보를 확인할 수 있습니다. Data를 열고 먼저 표시되는 통계 범위와 카운터의 의미를 확인한 다음 업로드와 다운로드 항목 등을 비교하세요. 트래픽 수치는 클라이언트가 데이터 전송을 감지했다는 뜻이지, 대상 페이지가 정상적으로 열렸거나 모든 요청이 예상한 정책을 따랐다는 뜻은 아닙니다.

특정 동작을 확인하려면 현재 수치를 기록한 뒤 명확한 접근 작업을 한 번 수행하고 돌아와 변화를 비교하세요. 현재 화면에 초기화 기능이 있더라도 과거 데이터가 필요 없는지 확인한 후 사용하세요. 초기화는 해당 통계만 지우며 서버 측 사용량을 삭제하지 않습니다. 백그라운드 앱과 시스템 작업에서도 트래픽이 발생할 수 있으므로 테스트 중에는 다른 전송을 가능한 한 줄이세요.

Data는 구독 잔여량을 일괄 조회하는 기능이 아닙니다. 클라이언트 통계와 기존 서비스의 과금 기록은 집계 주기, 프로토콜 오버헤드, 초기화 시점에 따라 다를 수 있습니다. 사용량이 일치하지 않는 이유를 확인할 때는 기간과 집계 기준을 맞춰 비교하세요. 접속할 수 없는 문제라면 연결 기록, DNS, 서버 상태를 확인해야 하며 트래픽 수치만으로 접속 가능 여부를 판단해서는 안 됩니다.

SETTINGS & DIAGNOSTICS

자주 쓰는 설정 확인 순서

Settings에서는 연결, 테스트, 보조 기능 관련 설정을 확인할 수 있으며, 일부 항목은 현재 Config의 내용에 따라 제어될 수도 있습니다. 앱에 실제로 표시되는 항목을 기준으로 원래 값을 기록한 뒤 한 가지씩 바꾸고 확인하세요. 여러 구성의 DNS, 테스트, 자동 연결 옵션을 한꺼번에 적용하면 어떤 설정이 변화를 일으켰는지 파악하기 어렵습니다.

DNS: 어떤 설정이 적용되는지 먼저 확인

DNS는 도메인을 주소로 변환하며, 결과는 이후 연결과 일부 규칙 일치에 영향을 줍니다. 먼저 Settings에서 DNS 관련 옵션을 확인한 다음 현재 Config에도 DNS 설정이 포함되어 있는지 살펴보세요. 한 곳만 바꾸고 설정이 적용됐다고 단정하지 마세요. 기존 구성을 사용한다면 DNS 요청의 라우팅과 대체 처리 방식을 먼저 파악해야 합니다.

도메인으로는 접속할 수 없지만 주소로는 연결되는 경우 DNS를 확인해 볼 수 있습니다. 다만 이는 단서일 뿐입니다. 인증서 이름, 서버 요구사항, 캐시도 차이를 일으킬 수 있습니다. DNS를 변경한 뒤 요청을 다시 보내고 필요하면 재연결한 다음 진단 결과를 확인하세요. 익숙해 보이는 주소가 반환됐다는 이유만으로 설정이 올바르다고 판단하지 마세요.

Test Method 및 Connectivity Test

Test Method는 연결 테스트에 사용할 방식을 선택하고, Connectivity Test는 해당 테스트를 실행합니다. Settings에서 Test Method를 확인한 뒤 서버 목록으로 돌아가 점검할 항목을 테스트하세요. 테스트 방식마다 측정 대상이 다르므로 결과를 다운로드 속도로 간주하거나 서로 다른 방식으로 나온 수치를 한데 놓고 비교하지 마세요.

테스트 성공은 해당 조건에서 상호 작용이 완료되었다는 뜻일 뿐 모든 대상에 접속할 수 있음을 보장하지 않습니다. 테스트가 실패했다면 방식, 대상, 현재 네트워크를 함께 고려하세요. 일부 테스트 동작은 네트워크 환경의 제한을 받을 수 있습니다. 항목을 비교할 때는 방식과 네트워크 환경을 동일하게 유지하고, 최종 판단은 실제 서비스 접속 결과를 기준으로 하세요.

Today Widget: 빠른 실행 및 상태 확인

Today Widget은 시스템 위젯 관련 보조 기능입니다. Settings에서 해당 옵션을 확인하고 기기 시스템에서 허용하는 위치에 위젯을 추가하거나 관리하세요. 사용 가능한 위치, 표시 방식, 조작 기능은 시스템 환경과 앱의 현재 구현에 따라 달라질 수 있으므로 기기에 실제로 표시되는 내용을 기준으로 확인하세요.

위젯 상태만으로 Home에서 확인할 수 있는 모든 항목을 대체할 수는 없습니다. 위젯으로 조작한 뒤 상태가 일치하지 않는다면 앱으로 돌아가 연결 스위치, Global Routing, 서버 선택을 확인하세요. 처음 사용할 때는 앱에서 구성을 마치고 필요한 시스템 권한을 허용해야 합니다.

iCloud: 동기화와 구매 기록 구분

iCloud 기능은 앱에서 지원하는 범위의 데이터를 동기화합니다. Settings에서 동기화 옵션을 확인하고 기기 시스템에서 iCloud를 사용할 수 있는지도 점검하세요. 다른 기기에서 데이터가 보이는지 확인하기 전에 양쪽 기기의 계정, 동기화 권한, 네트워크 환경이 적절한지 확인하세요. 변경한 내용이 다른 기기에 즉시 표시된다고 가정하지 마세요.

동기화 범위는 앱에 표시된 안내를 기준으로 하며 모든 서버 인증 정보, 통계 기록, 시스템 VPN 권한이 포함된다고 단정할 수 없습니다. 중요한 구성을 변경하기 전에 복원할 수 있는 사본을 보관하세요. App Store 구매 기록과 iCloud 데이터 동기화는 서로 다른 기능입니다. 구매 복원은 구성 복원을 뜻하지 않으며, 구성을 가져왔다고 구매가 완료되는 것도 아닙니다.

Diagnostics: 단서를 보존한 뒤 설정 변경

Diagnostics에서는 연결 문제 해결에 필요한 정보를 수집하고 확인할 수 있습니다. Settings에서 해당 메뉴를 찾아 문제를 한 번 재현한 다음 현재 제공되는 진단 정보를 확인하거나 내보내세요. 문제가 발생한 네트워크 유형, Global Routing, 대상 도메인, 현재 구성, 오류 상황을 기록하면 DNS 확인, 연결 수립, 규칙 처리 중 어느 단계에서 문제가 생겼는지 구분하는 데 도움이 됩니다.

문제를 문의하기 전에 로그에 구독 주소, 인증 정보, 개인 도메인 등 민감한 내용이 포함되어 있는지 확인하고 필요하면 가리세요. 진단 로그는 특정 시간 동안의 기록이지 모든 과거 동작을 완전히 증명하지는 않습니다. 설정을 바꾼 뒤 문제가 사라졌다면 어떤 항목을 변경했는지 기록하고, 다른 설정까지 한꺼번에 초기화하지 마세요.

이 문서는 주로 iPhone과 iPad의 기능을 설명합니다. Mac, Apple TV, Apple Vision의 호환성, 시스템 요구 사항, 구매 조건은 App Store 페이지에 표시된 내용을 기준으로 확인하세요. 기기마다 화면 구성이 다를 수 있으므로 이 페이지의 조작 위치가 모든 기기에서 동일하다고 볼 수는 없습니다.