공식 안내서 · 기능 및 설정

Shadowrocket
기능 및 자주 쓰는 설정

먼저 Global Routing을 확인한 다음 서버와 규칙을 점검하세요. 기능별 화면 위치와 설정 방법, 주의 사항을 살펴보고 한 번에 여러 항목을 바꾸지 마세요.

라우팅 메뉴

Global Routing 세 가지 모드

구성, 프록시, 직접 연결은 각각 Config, Proxy, Direct에 해당합니다. 먼저 이 항목을 확인한 다음 규칙이 적용되는지 점검하세요.

개요: Global Routing은 클라이언트의 라우팅 처리를 거치는 트래픽의 처리 방식을 결정합니다. Home 상단의 연결 스위치와는 별개입니다. 스위치는 연결을 켜고 끄며, Global Routing은 연결이 켜진 상태에서 사용할 라우팅 모드를 설정합니다. 스위치가 켜져 있어도 모든 요청이 현재 서버를 거친다는 뜻은 아닙니다.

위치: Home에서 Global Routing을 찾아 Config, Proxy 또는 Direct를 선택합니다. 도메인, IP, 지역별로 트래픽을 나누는 일반적인 용도에는 Config를 사용합니다. 현재 서버의 연결 경로가 정상인지 임시로 비교하려면 Proxy를, 로컬 네트워크가 정상인지 확인하려면 Direct를 잠시 사용해 볼 수 있습니다.

Global Routing 모드별 상황 및 점검 항목
모드 / 화면 용어처리 방식사용 상황주의 사항
구성 / Config현재 활성화된 구성의 규칙에 따라 정책을 선택합니다.일상적인 트래픽 분기, 도메인이나 IP에 따른 연결 구분.실제로 활성화된 구성과 규칙 순서를 확인해야 합니다.
프록시 / Proxy프록시 모드로 처리 대상 트래픽을 전달합니다.일부 규칙의 영향을 제외하고 현재 서버를 임시로 확인할 때.서버 시간 초과를 해결하지 않으며, 모든 시스템 연결이 처리된다는 뜻도 아닙니다.
직접 연결 / Direct대상에 직접 연결합니다.로컬 네트워크와 프록시 경로의 차이를 비교할 때.직접 연결이 정상이라고 해서 서버도 정상이라는 뜻은 아닙니다.

설정 방법: 먼저 현재 선택 항목을 기록한 뒤 모드를 하나 선택하고, 같은 대상과 네트워크에서 테스트를 반복하세요. Proxy는 정상인데 Config에서 문제가 발생하면 구성의 규칙과 정책을 먼저 확인합니다. 두 모드 모두 문제가 있으면 서버 연결과 DNS를 점검하세요. 서버, 네트워크, 모드를 한꺼번에 바꾸면 결과를 특정 설정과 연결하기 어렵습니다.

주의 사항: 테스트가 끝나면 원래 사용하려던 모드로 되돌리세요. 문제 해결을 위해 선택한 Proxy를 그대로 두면 원래 직접 연결하려던 요청도 경로가 바뀝니다. Direct를 일상 설정으로 유지하면 기존 규칙이 작동하지 않는다고 오해할 수 있습니다.

규칙 유형과 정책 선택

개요: 규칙은 매칭 조건과 처리 정책으로 구성됩니다. DOMAIN, DOMAIN-SUFFIX 등의 키워드는 ‘무엇을 매칭할지’를 정하고, PROXY, DIRECT, REJECT는 ‘매칭 후 어떻게 처리할지’를 정합니다. 두 요소는 서로 바꿔 쓸 수 없습니다. 규칙에 따른 트래픽 분기에는 Global Routing이 Config로 설정되어 있고 Config에서 예상한 파일이 활성화되어 있어야 합니다.

위치: Config에서 현재 활성화된 구성과 [Rule] 섹션을 확인하세요. 일반적으로 규칙은 위에서부터 차례로 매칭되며, 앞쪽 규칙이 먼저 적용되면 뒤쪽의 기본 규칙까지 진행하지 않습니다. 따라서 특정 도메인 규칙은 이를 덮을 수 있는 광범위한 규칙보다 앞에 두고, FINAL은 보통 마지막에 배치합니다.

키워드매칭 대상설정 시 점검 항목
DOMAIN전체 도메인.이 도메인 하나만 매칭하면 되는지 확인합니다.
DOMAIN-SUFFIX도메인과 하위 도메인.예상보다 넓은 범위에 적용되는지 확인합니다.
DOMAIN-KEYWORD도메인에 포함된 키워드.키워드가 너무 짧아 의도하지 않은 항목까지 매칭되는지 확인합니다.
GEOIPIP의 지역 정보.지역 정보 데이터베이스와 실제 연결 경로의 결과가 다를 수 있습니다.
IP-CIDR / IP-CIDR6IPv4 / IPv6 주소 대역.주소 유형과 네트워크 대역이 올바른지 확인합니다.
FINAL앞선 규칙에 매칭되지 않은 요청.기본 정책이 의도한 대로 설정되어 있는지 확인합니다.

설정 방법: 먼저 기존 구성을 저장한 뒤, 명확한 대상 하나를 지정해 규칙을 추가하세요. 아래는 문법 예시이며 example.com은 설명용 도메인으로, 서버나 구독 주소가 아닙니다. 이 예시는 해당 도메인과 하위 도메인을 PROXY로 보내고, GEOIP에서 CN에 매칭되는 요청은 DIRECT로 처리하며, 나머지 요청은 FINAL에 지정된 정책을 따르게 합니다.

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

주의 사항: PROXY를 사용하려면 이용 가능한 서버나 해당 정책이 필요합니다. DIRECT는 해당 프록시 경로를 거치지 않으며, REJECT는 매칭된 요청을 거부합니다. REJECT를 연결 실패 시 자동으로 전환되는 대체 정책으로 생각하지 마세요. 편집 후에는 파일에 규칙이 있는지만 보지 말고 실제로 어떤 규칙이 적용되는지 확인하세요. DNS가 확인한 주소, IPv6 연결, 앞선 규칙에 따라 매칭 결과가 달라질 수 있습니다.

USER-AGENT처럼 요청 내용에 의존하는 조건은 트래픽을 확인할 수 있는 범위에 영향을 받으므로 모든 암호화 연결에서 앱을 식별하는 방법으로 사용할 수 없습니다. 대상이 여러 도메인을 사용하는 경우에도 도메인 규칙 하나만으로 앱의 모든 트래픽 경로를 판단할 수는 없습니다.

구독 및 서버 관리

서버 정보, 구독 목록, 규칙 구성은 각각 역할이 다릅니다. 가져오기에 성공했다고 연결 확인까지 끝난 것은 아닙니다.

개요: 개별 서버 항목에는 연결 주소, 포트, 프로토콜, 인증 정보 등이 저장됩니다. Subscribe는 기존 구독의 서버 목록을 업데이트하고, Config는 규칙과 전역 설정을 저장합니다. 서버 목록을 업데이트해도 현재 규칙 파일이 반드시 갱신되는 것은 아니며, 구성을 전환해도 기본 서버가 자동으로 바뀌지는 않습니다.

위치: Home에서 서버 목록을 확인합니다. Add Server로 본인이 보유한 서버 정보를 직접 입력하거나 Scan QR Code로 본인의 정보를 가져올 수 있습니다. 구독을 추가하려면 현재 화면에서 Subscribe를 선택하고 본인의 구독 주소를 입력하세요. 메뉴 위치는 플랫폼에 따라 다를 수 있으므로 작업 후에는 Home으로 돌아와 목록을 확인하세요.

설정 방법: 직접 입력할 때는 먼저 서버 측 정보에 따라 프로토콜을 선택한 뒤 주소, 포트, 인증 항목을 하나씩 확인하세요. Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2의 입력 항목은 서로 바꿔 쓸 수 없습니다. TLS, 전송 방식, 서버 이름도 기존 정보와 일치해야 합니다. 포트만 보고 프로토콜을 추측하지 마세요.

  1. 구독 주소가 완전한지 먼저 확인하세요. 복사할 때 공백이나 줄바꿈이 들어가거나 쿼리 매개변수가 누락되지 않도록 주의합니다.
  2. 가져온 다음 업데이트를 실행하고 예상한 서버가 목록에 표시되는지 확인하세요. 업데이트에 실패하면 오류 내용을 먼저 기록하고 기존 목록을 바로 삭제하지 마세요.
  3. Home에서 기본 서버를 선택하고 선택 표시를 확인한 뒤 Connectivity Test를 실행하세요.
  4. 사용 가능 여부를 확인한 기준 서버를 하나 유지하고, 다른 서버는 하나씩 비교하세요. 여러 항목을 한꺼번에 바꾸면 이전 상태로 되돌리기 어렵습니다.

주의 사항: 구독 주소에는 계정 식별 정보가 포함될 수 있으므로 스크린샷이나 로그를 공유하기 전에 가리세요. 전체 주소를 공개 댓글에 붙여 넣지 마세요. 구독을 업데이트하면 해당 그룹의 항목이 바뀔 수 있으므로 직접 수정하기 전에 다음 업데이트에서 덮어쓰이는지 확인하세요. Connectivity Test 결과는 해당 테스트 방식으로 확인한 연결 가능 여부만 나타내므로 실제 대상에 접속해 추가로 확인해야 합니다.

On Demand 조건부 연결

개요: On Demand는 시스템에서 지원하는 네트워크 조건에 따라 연결 동작을 실행합니다. ‘언제 연결할지’를 정하는 기능이며, 연결 후 트래픽을 어떻게 분기할지 정하는 Global Routing을 대신하지 않습니다. 사용할 수 없는 서버나 만료된 구독을 자동으로 수정하지도 않습니다.

위치: Settings에서 On Demand와 관련 조건 설정을 찾으세요. 시스템마다 제공하는 조건이 다를 수 있으므로 현재 화면의 항목을 먼저 확인한 다음 활성화 여부를 결정하세요. 한 플랫폼의 조건 목록을 다른 플랫폼에 그대로 적용할 수는 없습니다.

설정 방법: 먼저 수동 연결로 서버와 규칙이 정상인지 확인한 다음 필요한 네트워크 조건을 설정하세요. 조건은 한 번에 하나씩 추가하고 Wi-Fi와 셀룰러 네트워크를 전환해 예상대로 연결이 시작되거나 종료되는지 확인합니다. 특정 네트워크에 예외를 설정할 수 있다면 예외 조건과 일반 조건을 함께 점검해 서로 덮어쓰지 않도록 하세요.

주의 사항: 연결을 수동으로 끈 뒤 다시 자동 연결된다면 On Demand 조건이 여전히 충족된 것일 수 있으며, 스위치 오류라고 단정할 수 없습니다. 자동 연결을 잠시 멈추려면 Home 스위치를 반복해서 조작하기보다 On Demand 설정도 확인하세요. 네트워크를 자주 전환할 때는 재연결 횟수를 확인해 조건에 따른 연결, 시스템 절전, 서버 연결 끊김을 구분하세요. 상태 막대 아이콘만으로 원인을 판단하지 마세요.

Data 트래픽 통계

연결 변화와 트래픽 추이를 확인하는 기능이며, 네트워크 사업자나 서버 측의 사용량 측정을 대신하지 않습니다.

개요: Data는 클라이언트에서 기록할 수 있는 범위의 트래픽과 연결 정보를 표시합니다. 특정 시간대에 데이터가 전송되었는지, 연결 후 업로드나 다운로드가 있었는지 확인하는 데 활용할 수 있습니다. 진단을 위한 참고 정보이지 모든 기기의 트래픽을 합산한 청구 내역이 아닙니다. 시스템에서 우회되는 트래픽이나 집계 방식에 따라 결과가 달라질 수 있습니다.

위치: Data를 열고 먼저 표시되는 집계 범위와 시간을 확인한 다음, 이용할 수 있는 상세 정보를 살펴보세요. 버전과 플랫폼에 따라 표시 항목이 다를 수 있습니다. 데이터를 비교할 때는 같은 범위를 사용하고, 한 번의 연결에 대한 수치와 누적 수치를 직접 비교하지 마세요.

설정 방법: 특정 대상을 점검할 때는 현재 데이터를 기록한 뒤 해당 대상에 한 번만 접속해 증가분을 확인하세요. 통계를 초기화하는 기능이 있다면 필요한 기록을 먼저 저장한 뒤 초기화합니다. 연결을 다시 시작해도 모든 누적 데이터가 지워지는 것은 아닙니다. 요청 기록에서 적용된 정책을 함께 확인해야 예상한 경로로 전송되었는지 판단할 수 있습니다.

주의 사항: 업로드와 다운로드 수치가 증가했다는 사실만으로 웹페이지가 완전히 로드되었다고 볼 수 없습니다. 테스트, 백그라운드 동기화, 재시도도 트래픽을 발생시킵니다. 페이지가 표시되지 않는데 재시도가 계속된다면 DNS, 연결 오류, 규칙을 함께 확인하세요. 배터리나 데이터 사용량이 비정상적이라면 백그라운드 작업을 끈 상태와 먼저 비교한 다음 특정 연결을 확인하세요. 스위치 하나만 원인으로 단정하지 않는 것이 좋습니다.

Settings 자주 쓰는 항목

기존 값을 기록한 뒤 한 번에 하나씩 변경하세요. 현재 구성에 설정된 관련 매개변수도 함께 확인해야 합니다.

DNS: 도메인 조회 실패 여부부터 확인

개요 및 위치: DNS는 도메인을 연결에 필요한 주소로 변환합니다. Settings에서 DNS 관련 항목을 찾고 Config의 [General]에 dns-server 등의 매개변수가 있는지도 확인하세요. 설정 화면과 구성 파일 양쪽에 관련 항목이 있다면 실제 적용되는 설정이 무엇인지 확인하세요. 한 곳을 수정하면 모든 상황에 적용된다고 가정하지 마세요.

설정 방법: 현재 값을 기록하고 몇 개의 구체적인 도메인을 테스트한 뒤 조회 방식을 바꿀 필요가 있는지 판단하세요. 모든 서버에서 도메인으로 접속할 때만 실패한다면 DNS를 중점적으로 확인합니다. 특정 대상 하나에서만 문제가 생긴다면 해당 대상의 규칙과 서비스 상태도 살펴보세요. 변경 후에는 같은 대상을 다시 테스트하고 캐시가 결과에 영향을 주는지 확인하세요.

주의 사항: DNS 리졸버에도 연결할 수 있어야 합니다. 출처를 알 수 없는 주소를 찾아 구성에 입력하지 말고, DNS를 인증 오류나 포트 시간 초과를 해결하는 만능 방법으로 취급하지 마세요. IPv6를 사용하는 경우에는 할당된 주소 유형과 현재 네트워크에서 IPv6 연결이 가능한지도 함께 확인해야 합니다.

Test Method: 테스트 기준 통일

개요 및 위치: Settings의 Test Method는 연결 테스트에 사용할 방식을 지정합니다. 방식마다 확인하는 연결 단계가 다르므로 테스트 방법을 고려하지 않은 채 두 수치를 직접 비교할 수 없습니다. 한 가지 방식의 테스트가 실패해도 실제 요청이 모두 실패한다고 단정할 수는 없습니다.

설정 방법: 현재 점검 목적에 맞고 화면에서 지원하는 방식을 선택한 다음 Home에서 Connectivity Test를 실행하세요. 여러 서버를 비교할 때는 테스트 방법, 네트워크, 대상을 동일하게 유지하고 필요하면 테스트를 반복한 뒤 실제 접속 결과로 확인하세요.

주의 사항: 테스트에 걸린 시간은 다운로드 속도가 아니며, 한 번의 측정값으로 장기적인 안정성을 판단할 수도 없습니다. 더 낮은 수치를 얻으려고 방법을 계속 바꾸다 실제 연결 성공 여부를 놓치지 마세요.

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

개요 및 위치: Today Widget은 시스템이 허용하는 경우 제공되는 빠른 제어 기능입니다. Settings에서 관련 옵션을 찾은 다음 시스템 위젯 화면에서 추가할 수 있는지 확인하세요. 위젯의 형태와 백그라운드 동작에 대한 제한은 시스템 버전에 따라 다릅니다.

설정 방법 및 주의 사항: 현재 시스템에서 해당 기능을 제공하는 경우에만 추가하고, 사용 후 Home으로 돌아와 실제 상태를 확인하세요. 위젯 표시에는 갱신 지연이 있을 수 있으므로 이전 상태를 현재 연결 결과로 착각하지 마세요. 같은 메뉴를 찾을 수 없다면 현재 시스템의 지원 여부를 기준으로 판단하세요. 이 기능 때문에 구성을 반복해서 초기화할 필요는 없습니다.

iCloud: 동기화 전에 로컬 구성 보호

개요 및 위치: iCloud를 지원하는 Apple 기기에서 Settings의 관련 옵션은 앱이 지원하는 범위 내에서 클라우드 동기화를 관리합니다. 모든 설정, 연결 상태, 로그가 다른 기기에 완전히 복사되는 것은 아닙니다.

설정 방법: 중요한 구성을 먼저 저장한 뒤 시스템에 원하는 계정으로 로그인했는지, iCloud를 사용할 수 있는지, 앱 권한이 켜져 있는지 확인하세요. 다른 기기에서 처음 사용할 때는 동기화가 완료될 때까지 기다린 다음 파일 내용, 활성화된 항목, 기본 서버를 확인하세요. 기존 로컬 파일을 바로 덮어쓰지 마세요.

주의 사항: 동기화는 별도의 백업이 아니며 삭제나 덮어쓰기도 동기화될 수 있습니다. 두 기기의 내용이 다르면 먼저 양쪽 파일을 복사해 보관한 다음 비교하세요. 같은 파일을 두 기기에서 연달아 수정하지 마세요. 플랫폼 간 구성 이전이 항상 iCloud로 자동 완료된다고 볼 수도 없습니다.

Diagnostics: 재현 가능한 오류 기록

개요 및 위치: Settings에서 Diagnostics와 사용할 수 있는 진단 메뉴를 찾아 연결 문제와 관련된 정보를 수집합니다. 로그를 확인할 때는 특정 상황을 한 번 재현해 살펴보세요. 장시간 쌓인 기록은 현재 문제와 관련된 오류를 구분하기 어렵습니다.

설정 방법: 네트워크 유형, Global Routing, 현재 서버와 대상을 기록한 다음 문제를 한 번 재현하고 비슷한 시각의 조회, 연결, 규칙 기록을 확인하세요. DNS 실패, 연결 시간 초과, 인증 오류, 규칙 매칭 이상을 먼저 구분한 뒤 해당 항목의 점검 절차를 따르세요.

주의 사항: 진단 정보를 제출하기 전에 구독 주소, 인증 정보 및 기타 개인 정보를 가리세요. 진단이 끝나면 일상적인 사용에 필요한 기록 수준으로 되돌려 불필요한 로그가 장기간 쌓이지 않도록 하세요. 증상별 추가 안내는 문제 해결 안내서를 확인하세요.

설정 후 점검 순서

기능마다 서로 의존하는 항목이 있습니다. 서버에 연결할 수 없는 경우 규칙을 바꿔도 연결 문제가 해결되지 않는 경우가 많습니다. Global Routing이 Config가 아니라면 [Rule]만 수정해도 기대한 변화가 나타나지 않을 수 있습니다. 아래 순서대로 확인하면 각 결과를 특정 설정과 연결할 수 있습니다.

  1. 기본 네트워크 확인. Wi-Fi인지 셀룰러 네트워크인지 기록하고 네트워크 자체가 정상인지 먼저 확인하세요. 비교하는 동안 네트워크를 바꾸지 마세요.
  2. 서버 확인. Home에서 기본 선택 항목과 매개변수를 확인하고 Connectivity Test로 기준을 기록한 뒤 대상에 실제로 접속하세요.
  3. 라우팅 모드 확인. Global Routing을 확인하세요. Config를 사용하는 경우 파일이 존재하는지만 보지 말고 실제로 활성화된 구성 파일을 확인하세요.
  4. 조회 및 규칙 매칭 확인. DNS 결과, 규칙 순서, 최종 정책을 확인하세요. 관련 규칙은 한 번에 하나씩만 수정하고 저장한 뒤 다시 테스트하세요.
  5. 자동 동작 확인. 수동 연결이 정상인지 확인한 다음 On Demand, 동기화, 빠른 실행 기능을 테스트하세요. 여러 자동 동작이 동시에 실행되면 원인을 파악하기 어려울 수 있습니다.
  6. 정상 작동한 결과 보존. 문제가 해결된 구체적인 변경 사항을 기록하세요. 개선되지 않았다면 다른 항목을 시도하기 전에 이전 설정을 복원하세요. 확실하지 않은 설정을 계속 추가하지 마세요.

처음 설정할 때는 사용법 안내에 따라 정보를 가져오고 첫 연결을 완료하세요. 같은 오류가 반복되면 문제 해결 안내서에서 증상별로 확인할 수 있습니다. 자주 묻는 설정 질문은 FAQ에서 확인하세요. 특정 대상 하나를 점검하기 위해 모든 기능을 다시 설정할 필요는 없습니다.

Shadowrocket 무료 다운로드