Shadowrocket 기능 및 설정 가이드: 규칙 라우팅, On Demand, DNS · Shadowrocket 가이드

Global Routing: Config, Proxy, Direct

Global Routing은 연결을 켠 뒤 트래픽을 전반적으로 처리할 방식을 정합니다. Home에서 Global Routing을 찾아 현재 목적에 맞게 Config, Proxy 또는 Direct를 선택하세요. 이 항목은 서버 목록이나 연결 성공 표시가 아닙니다. 모드를 선택한 뒤에도 기본 서버와 주 연결 스위치를 확인해야 합니다. 앱에 세부 설정이 있다면 현재 Config와 함께 살펴보세요.

화면 항목	처리 방식	사용 상황	확인할 항목
Config(구성)	현재 구성의 규칙과 정책에 따라 요청을 처리합니다.	일상적으로 도메인이나 주소별로 트래픽을 분기할 때	현재 사용 중인 구성, 규칙 순서, 기본 처리 정책
Proxy(프록시)	전체 트래픽을 프록시 모드로 처리합니다. 구체적인 동작은 관련 설정에 따라 달라집니다.	프록시 경로를 임시로 확인해 규칙 문제의 범위를 좁힐 때	선택한 서버, 인증 정보, 대상에 연결할 수 있는지 여부
Direct(직접 연결)	전체 트래픽을 직접 연결 모드로 처리합니다. 구체적인 동작은 관련 설정에 따라 달라집니다.	현재 네트워크에서 직접 접속할 수 있는지 임시로 확인할 때	로컬 네트워크가 정상인지, DNS 설정은 적절한지

모드 전환 후 확인 방법

기존 트래픽 분기 구성을 일상적으로 사용할 때는 Config를 선택하고 Config 화면에서 현재 활성화된 파일을 확인하세요. 특정 대상에 접속 문제가 있으면 같은 대상과 같은 서버를 사용해 잠시 Proxy 모드와 비교해 볼 수 있습니다. Proxy에서는 접속되지만 Config에서는 안 된다면 연결 매개변수를 전부 바꾸기보다 규칙 매칭과 정책 지정부터 확인하세요. 비교가 끝나면 원래 모드로 되돌려 임시 점검 상태를 상시 설정으로 착각하지 않도록 합니다.

Direct는 앱의 연결을 끄는 것과 다릅니다. 연결이 켜져 있으면 DNS나 연결 처리 방식이 현재 설정의 영향을 받을 수 있습니다. 문제가 로컬 네트워크에서 비롯된 것인지 확인하려면 주 연결 스위치도 끈 뒤 같은 대상을 다시 접속해 보세요. 한 번에 한 항목만 변경하고 결과를 기록해야 모드, 서버, 로컬 네트워크 중 원인을 구분하기 쉽습니다.

규칙 라우팅: 매칭 조건과 실행 정책

규칙 라우팅은 ‘어떤 요청과 일치하는가’와 ‘일치한 요청을 어떻게 처리하는가’를 구분합니다. 일반적으로 Config에서 현재 구성을 열어 규칙을 확인하거나 편집합니다. 해당 규칙은 구성에 지정된 처리 방식을 사용할 때 그 설정에 따라 라우팅에 적용됩니다. 수정하기 전에 원본 파일을 복사해 두고, 이름이 비슷한 다른 파일이 아니라 실제 활성화된 파일을 편집하는지 확인하세요.

규칙 유형은 매칭 대상을 지정합니다

DOMAIN은 특정 도메인과 일치시키고, DOMAIN-SUFFIX는 도메인 접미사와 일치시키며, DOMAIN-KEYWORD는 도메인에 포함된 키워드와 일치시킵니다. 도메인 접미사 규칙은 특정 도메인과 하위 도메인을 함께 지정할 때 적합합니다. 키워드 규칙은 범위가 넓어 의도하지 않은 도메인까지 매칭될 수 있으므로 가능한 한 구체적으로 작성하세요.

IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 대역을 지정하고, GEOIP는 IP 주소의 지역 분류를 사용합니다. 도메인 접속 전에 먼저 DNS 조회가 필요한지, 어떤 주소가 반환되는지에 따라 IP 주소 규칙의 결과가 달라질 수 있습니다. 도메인 매칭 실패와 DNS 실패를 혼동하지 말고, 대상 사이트 이름만 보고 실제로 어떤 규칙이 적용됐는지 단정하지 마세요.

정책은 처리 동작을 지정합니다

PROXY는 프록시 정책, DIRECT는 직접 연결, REJECT는 차단을 의미합니다. 구성에서 사용자 지정 정책 그룹을 참조할 수도 있습니다. 이 경우 그룹에서 최종적으로 선택된 서버도 확인해야 합니다. 규칙은 일반적으로 순서대로 매칭되므로 구체적인 규칙을 더 포괄적인 규칙보다 앞에 배치하세요. 앞선 규칙과 일치하지 않을 때는 FINAL이 기본 처리에 사용됩니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
FINAL,DIRECT

위 내용은 규칙 문법의 예시이며 완성된 구성은 아닙니다. 두 번째 줄은 첫 번째 줄보다 범위가 넓으며, 두 가지 매칭 방식을 보여 주기 위한 것입니다. 실제로는 대상에 맞게 내용을 수정하거나 삭제하고, 키워드 규칙을 유지할지 확인하세요. 규칙을 하나 추가한 뒤에는 구체적인 대상 도메인으로 매칭 결과를 확인하고 다음 규칙을 추가해야 여러 조건이 한꺼번에 겹쳐 문제 원인을 찾기 어려워지는 일을 피할 수 있습니다.

Subscribe 및 Add Server: 기존 정보 관리

Home은 서버를 선택하고 그룹을 확인하며 연결을 제어하는 주요 화면입니다. 서버 하나를 추가하려면 Add Server를 이용하고, 기존 구독은 앱에서 Subscribe 관련 메뉴를 통해 가져오세요. 두 방법 모두 유효한 정보를 이미 보유하고 있어야 합니다. 구독은 서버 정보를 일괄로 가져오는 방식일 뿐, 가져온 모든 항목의 연결을 보장하지 않으며 앱 구매에 관련 서비스가 포함되는 것도 아닙니다.

수동 추가 및 QR 코드 가져오기

Add Server로 이동해 먼저 Type을 확인한 다음 보유한 정보에 맞춰 Address, Port와 해당 인증 항목을 입력하세요. Shadowsocks, VMess, VLESS, Trojan, WireGuard, Hysteria2 등은 프로토콜마다 필요한 항목이 다릅니다. 한 프로토콜의 비밀번호나 키를 다른 프로토콜에 그대로 적용하면 안 됩니다. 선택 항목은 보유한 정보와 하나씩 대조하고, 확실하지 않은 값은 그대로 둔 채 정보 제공자에게 확인하세요.

QR 코드가 있다면 Scan QR Code로 인식한 뒤 가져온 항목의 유형, 주소, 포트를 확인하세요. QR 코드 스캔은 입력 방식일 뿐 매개변수 확인을 대신하지 않습니다. 서버를 쉽게 알아볼 수 있도록 이름을 지정한 다음 Home으로 돌아가 기본 서버를 선택하세요. 선택 상태를 확인한 뒤 연결 스위치를 켭니다. 목록에 항목이 표시된다는 사실만으로 연결이 완료됐다고 판단할 수는 없습니다.

구독 업데이트 및 민감 정보 보호

기존 구독 링크는 앞뒤에 공백이나 줄바꿈이 들어가지 않도록 전체를 붙여 넣으세요. 구독을 업데이트하면 목록을 다시 가져오며 이름, 그룹, 항목이 바뀔 수 있습니다. 업데이트 후에는 이전에 선택한 서버가 여전히 있는지 확인하세요. 구독으로 생성된 항목을 직접 수정하기 전에 다음 업데이트 때 변경 사항이 덮어써지는지 확인하고, 필요하면 별도로 기록해 두세요.

구독 링크, 비밀번호, 개인 키, 구성에 저장된 인증 정보는 모두 민감한 정보로 취급해야 합니다. 문제 해결을 위해 전체 링크를 다른 사람에게 보낼 필요는 없습니다. 오류가 발생한 단계만 설명하고 계정 정보와 인증 항목은 가리세요. 여러 항목을 삭제하거나 다시 가져오거나 구성을 바꾸기 전에 유효한 정보를 백업해 두면 서버 목록 변경을 앱 구매 기록 손실로 오해하는 일을 막을 수 있습니다.

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

On Demand는 지정한 조건에 따라 연결 동작을 실행하는 기능입니다. 서버 품질을 검사하거나 누락된 인증 매개변수를 보충하는 도구는 아닙니다. 앱에서 On Demand 관련 설정을 열어 현재 조건을 확인하고 필요한 항목만 조정하세요. 화면에서 메뉴 위치를 찾기 어렵다면 Settings에서 해당 항목을 검색하고 앱에 표시되는 내용을 기준으로 설정하세요.

설정하기 전에 수동으로 연결을 확인하세요. 서버를 선택하고 주 연결 스위치를 켠 뒤 시스템에서 VPN 구성을 추가하도록 허용하고, 대상에 정상적으로 접속되는지 확인합니다. 수동 연결부터 실패한다면 서버, DNS, 네트워크 문제를 먼저 해결하세요. On Demand를 반복해서 켜도 근본 원인은 해결되지 않는 경우가 많습니다. 수동 연결이 확인된 다음 트리거 조건을 점검하고 사용하려는 네트워크 환경에서 실제 동작을 확인하세요.

Wi-Fi와 셀룰러 네트워크를 전환하거나, 화면을 잠갔다가 깨우거나, 네트워크를 바꾸면 연결 상태가 달라질 수 있으므로 각각 확인하세요. 연결이 끊겼다가 곧바로 다시 연결된다면 On Demand가 켜져 있는지 먼저 확인하고, 시스템에 VPN에 영향을 줄 수 있는 다른 구성이 있는지도 살펴보세요. 문제를 확인하는 동안 On Demand를 잠시 끄고 수동 스위치로 한 가지 조건씩 테스트한 뒤 다시 설정할 수 있습니다.

Data: 트래픽 및 연결 정보 확인

Data에서는 앱에 기록된 트래픽 정보를 확인할 수 있습니다. 분류 방식, 통계 기간, 펼쳐서 볼 수 있는 항목은 현재 화면에 따라 다릅니다. Data를 열어 기록의 시간과 집계 범위를 확인한 뒤 방금 수행한 접속 동작과 비교해 변화를 살펴보세요. 앱이 관련 활동을 기록했는지 확인하는 데 유용하지만, 누적 수치 하나만으로 현재 서버의 속도나 서비스 상태를 판단해서는 안 됩니다.

비교가 필요하면 시작 시간을 기록하고 불필요한 백그라운드 작업을 종료한 뒤, 확인 가능한 대상에 접속하세요. 이후 Data로 돌아와 해당 기록에 변화가 있는지 확인합니다. 화면에서 연결 세부 정보를 제공한다면 대상, 처리 정책, 관련 기록도 살펴보세요. 트래픽이 발생했다고 해서 대상 페이지가 정상적으로 열린 것은 아닙니다. 인증 실패, 재시도, 백그라운드 동기화도 데이터 전송을 일으킬 수 있습니다.

Data의 집계 기준은 시스템의 셀룰러 데이터 통계나 기존 서비스 계정의 사용량 기록과 다를 수 있으며, 과금 기준을 대신할 수 없습니다. 기록을 지우기 전에 문제 해결에 필요한 정보를 저장하세요. 기록을 공유할 때는 대상에 포함된 개인 식별 정보, 계정 정보, 서버 정보를 가리세요. 배터리 소모가 주된 문제라면 총 트래픽만으로 결론을 내리지 말고 시스템의 배터리 화면과 백그라운드 활동도 함께 확인하세요.

Settings: DNS, 테스트, 위젯 및 동기화

Settings에는 자주 쓰는 설정과 도구가 모여 있지만, 모든 네트워크 동작이 여기서만 결정되는 것은 아닙니다. 현재 Config에 DNS나 관련 매개변수가 포함될 수도 있습니다. 전체 설정을 바꾸기 전에 구성에 같은 종류의 설정이 있는지 확인하세요. 기기와 시스템에 따라 메뉴 위치가 다를 수 있으므로, 아래에서는 특정 메뉴 경로가 모든 기기에서 같다고 가정하지 않고 기능 이름을 기준으로 안내합니다.

DNS: 이름 해석 문제를 확인한 뒤 설정 변경

DNS는 도메인 이름을 IP 주소로 변환합니다. Settings와 현재 Config에서 DNS 관련 항목을 확인하고 기존 값과 현재 네트워크를 기록한 뒤, 설정이 중복되거나 서로 영향을 주는지 살펴보세요. 서버 주소가 도메인 이름을 사용하는 경우 연결을 시작하기 전에 DNS 조회가 필요할 수 있습니다. 따라서 대상 사이트가 열리지 않는 문제와 서버 주소의 DNS 조회 실패는 따로 확인해야 합니다.

DNS를 바꿀 때는 관련 항목 하나만 조정하고 같은 도메인으로 반복 테스트해 특정 네트워크에서만 실패하는지 확인하세요. 흔히 쓰이는 DNS 주소라는 이유만으로 구성 전체를 바꾸지 말고, 암호화된 DNS를 사용한다고 모든 연결이 성공하는 것도 아닙니다. 변경해도 효과가 없다면 원래 값으로 복구한 뒤 라우팅 규칙, 서버 매개변수, 로컬 네트워크를 차례로 확인하세요.

Test Method 및 Connectivity Test: 측정 대상 확인

Test Method에서는 해당 테스트에 사용할 방법을 선택하며, Settings에서 선택 가능한 방식을 확인할 수 있습니다. Connectivity Test는 연결 상태를 확인하는 데 도움을 줍니다. 테스트 방식마다 측정하는 단계가 다르며 서버에서 테스트 결과를 받았다고 해서 모든 웹사이트에 접속할 수 있는 것은 아닙니다. 테스트 전에 기본 서버, 네트워크 환경, 테스트 대상을 확인하고 결과를 비교할 때는 같은 방식을 사용하세요.

테스트가 실패하면 먼저 테스트 방식과 대상이 현재 서버에 적합한지 확인한 다음 주소, 포트, 인증 매개변수를 살펴보세요. 테스트 결과는 정상이지만 실제 접속에 실패한다면 대상에 적용되는 규칙과 DNS를 추가로 확인해야 합니다. 서로 다른 테스트 방식의 수치를 그대로 나열해 안정성이나 장기 속도를 판단하지 마세요.

Today Widget: 시스템 지원 및 표시 내용 확인

Today Widget은 시스템 위젯과 관련된 기능입니다. Settings에서 해당 설정을 확인한 다음 시스템의 위젯 관리 화면에서 추가할 수 있는지와 표시 가능한 항목을 살펴보세요. 메뉴 위치와 표시 기능은 시스템 지원 여부에 따라 달라지므로 기기에 실제로 표시되는 내용을 기준으로 판단하세요. 위젯이 보이지 않는다고 바로 서버 문제로 볼 수는 없습니다.

위젯은 정보를 빠르게 확인하거나 제공되는 동작을 실행할 때 유용합니다. 현재 선택한 서버, 라우팅 모드, 자세한 오류를 확인하려면 앱으로 돌아가야 합니다. 위젯과 앱의 상태가 잠시 일치하지 않으면 앱을 열어 새로고침한 뒤 시스템의 위젯 지원 여부를 확인하세요. 이 때문에 기존 구성을 바로 삭제할 필요는 없습니다.

iCloud: 동기화 범위 및 별도 백업

iCloud 관련 기능은 지원되는 환경에서 해당 구성 정보를 저장하거나 동기화합니다. Settings에서 스위치와 앱 안내를 확인하고 기기의 시스템 설정에서 앱의 iCloud 사용이 허용됐는지 살펴보세요. 동기화 전에 별도 백업을 만들어 두세요. 다른 기기에서 앱을 연 뒤에는 모든 서버, 키, 설정이 함께 옮겨졌다고 가정하지 말고 실제로 표시되는 파일과 내용을 확인하세요.

App Store 구매 기록과 iCloud 구성 정보는 서로 다른 데이터입니다. 구입 항목을 복원해도 연결 정보 전체가 복원되는 것은 아니며, 구성이 동기화됐다고 구매 자격 확인을 대신할 수도 없습니다. 새 기기로 바꿀 예정이라면 구성 백업 및 이전 안내를 참고해 사용 가능한 백업을 먼저 확인한 다음 기존 기기의 데이터를 정리하세요.

Diagnostics: 문제를 재현하는 최소 절차 기록

Diagnostics에서는 문제 해결에 필요한 진단 정보를 수집하거나 확인할 수 있습니다. 사용할 수 있는 도구와 출력은 Settings에 실제로 표시되는 메뉴를 기준으로 확인하세요. 진단을 시작하기 전에 네트워크 유형, Global Routing 모드, 문제 발생 시각, 작업 순서를 기록해 두세요. 그러면 기록을 구체적인 실패 사례와 연결해 불필요한 정보 속에서 원인을 찾는 일을 줄일 수 있습니다.

진단 파일에는 도메인, 주소, 기기 환경, 구성 정보가 포함될 수 있습니다. 내보내거나 공유하기 전에 내용을 확인하고 민감한 정보는 가리세요. 필요한 오류 정보만 남기고 구독 링크 전체, 인증 항목, 개인 키는 공개하지 마세요. 증상별 자세한 문제 해결 절차는 문제 해결 매뉴얼을 참고하세요.

설정 확인 순서: 기준을 정한 뒤 하나씩 조정

기능 설정은 ‘특정 도메인에 프록시 정책 적용’이나 ‘특정 네트워크에서만 연결 실행’처럼 분명한 목표에 맞춰야 합니다. 현재 사용 가능한 구성을 보존하고 서버, 모드, DNS의 초기 상태를 기록하세요. 구독 업데이트, 규칙 수정, DNS 변경을 동시에 진행하면 접속이 다시 되더라도 어떤 조치가 효과가 있었는지 알기 어렵습니다.

입력 정보를 확인합니다. Home에서 서버가 있는지, Type, Address, Port와 인증 항목이 보유한 정보와 일치하는지 확인하고 기본 서버를 명확히 선택합니다.
수동 연결의 기준 상태를 확인합니다. On Demand의 자동 연결 영향을 잠시 제외하고 수동으로 연결을 켠 뒤, 구체적인 대상 하나로 현재 상태를 확인합니다.
Global Routing을 확인합니다. 일상적인 트래픽 분기는 Config에서 확인합니다. 비교를 위해 모드를 임시 전환했다면 확인 후 원래 모드로 되돌리고 결과를 기록합니다.
규칙과 DNS를 확인합니다. 대상에 예상한 규칙이 적용되는지 먼저 확인한 뒤 DNS와 정책 그룹의 지정 상태를 살펴봅니다. 한 번에 원인 하나만 수정하세요.
자동화와 기록을 다시 확인합니다. 필요한 On Demand 조건을 복구하고 Data와 Diagnostics에서 실제 동작을 확인한 뒤 사용할 수 있는 구성을 하나 보관합니다.

현재 연결이 필요한 목적을 충족한다면 더 많은 설정을 사용하려고 기능을 하나씩 켤 필요는 없습니다. 설정을 이해하고 검증하고 되돌릴 수 있도록 관리하는 편이 용도를 확인하지 않은 옵션을 여러 개 추가하는 것보다 유지 관리하기 쉽습니다. 이 문서는 Shadowrocket 공식 매뉴얼입니다. 구매 및 설치 방법은 App Store 안내를, 처음 설정하는 순서는 시작하기를 참고하세요. 구체적인 오류는 자주 묻는 질문에서 확인할 수 있습니다.