공식 가이드 · 기능 및 설정
먼저 Global Routing을 선택한 다음 Config와 서버를 확인하세요. 연결 스위치, 요청에 적용되는 정책, 실제 접속 가능 여부는 각각 따로 확인해야 합니다.
아래 안내는 iPhone / iPad에서 흔히 볼 수 있는 화면을 기준으로 합니다. 플랫폼에 따라 메뉴 위치와 사용할 수 있는 설정이 다를 수 있으므로 현재 앱 화면을 기준으로 확인하세요. Shadowrocket은 iPhone / iPad, Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전을 제공합니다. 다운로드 경로는 전체 플랫폼 다운로드에서 확인하세요.
모드 선택
구성, 프록시, 직접 연결은 각각 화면의 Config, Proxy, Direct에 해당합니다. 모드는 요청의 경로를 선택하며 연결 스위치와는 별개입니다.
기능 및 위치:Global Routing은 전체 라우팅 방식을 선택하는 메뉴입니다. Home에서 Global Routing을 찾아 현재 선택된 항목을 확인하세요. 처음 설정한다면 먼저 기존 서버를 가져와 사용 가능한지 확인한 뒤 평소 사용할 모드를 선택하세요. 여러 옵션을 시험하기 위해 서버, DNS, 구성 파일을 한꺼번에 바꾸지 마세요.
| 화면 옵션 | 요청 처리 방식 | 사용 상황 | 확인할 항목 |
|---|---|---|---|
| Config(구성) | 현재 활성화된 구성의 규칙에 따라 정책을 선택합니다. | 도메인, 주소 또는 기타 조건에 따라 평소 트래픽을 분기할 때 사용합니다. | 구성이 활성화되어 있는지, 규칙 순서와 정책 참조가 올바른지 확인합니다. |
| Proxy(프록시) | 전체 요청에 프록시 경로를 사용합니다. 구체적인 처리 방식은 앱과 플랫폼의 기능에 따라 달라집니다. | 규칙 선택이 문제의 원인인지 확인하기 위한 짧은 비교 테스트에 사용합니다. | 선택한 서버에 연결할 수 있는지, 대상 서비스에 접속할 수 있는지 확인합니다. |
| Direct(직접 연결) | 전체 요청에 직접 연결 경로를 사용합니다. | 로컬 네트워크를 확인하거나 일시적으로 직접 연결과 비교할 때 사용합니다. | 로컬 네트워크와 대상 서비스가 정상인지 확인합니다. |
검증된 규칙 구성이 있다면 보통 Config부터 사용합니다. Config에서 특정 대상에 접속할 수 없지만 같은 서버를 Proxy에서 사용하면 접속되는 경우, 구독을 바로 다시 가져오기보다 규칙과 정책을 확인하세요. Direct에서도 직접 연결해야 할 대상에 접속할 수 없다면 Wi-Fi, 셀룰러 네트워크 또는 대상 서비스 상태부터 확인합니다. 한 번에 한 가지 조건만 바꾸고 결과를 기록하세요. 테스트가 끝나면 원래 사용할 모드로 되돌리세요.
유의 사항:Direct를 선택해도 연결이 꺼지는 것은 아니며, Proxy를 선택해도 대상 서비스 접속이 보장되는 것은 아닙니다. 시스템에 연결 상태가 표시될 수 있지만 요청 경로를 확인할 때는 시스템 상태 아이콘만 보지 말고 요청 기록도 함께 살펴보세요. 새 요청과 이미 연결된 세션도 구분해야 합니다. 모드를 바꾼 뒤 대상에 다시 접속해 확인하세요.
매칭 조건과 실행 정책
규칙 유형은 ‘무엇을 매칭하는지’를, 정책은 ‘매칭 후 어떻게 처리하는지’를 나타냅니다. 서로 대체할 수 없습니다.
Config에서 현재 구성의 Rule 내용을 확인하세요. DOMAIN은 정확한 도메인, DOMAIN-SUFFIX는 도메인 접미사, DOMAIN-KEYWORD는 도메인 키워드와 매칭합니다. IP-CIDR과 IP-CIDR6은 주소 범위를 지정하고, GEOIP는 주소에 해당하는 지역 데이터로 매칭합니다. 결과는 데이터와 주소 확인 방식에 따라 달라질 수 있으므로 웹사이트가 특정 지역에 속한다는 보장으로 해석하면 안 됩니다.
USER-AGENT 매칭 여부는 요청에 확인할 수 있는 해당 정보가 포함되어 있는지에 따라 달라집니다. 모든 연결에서 이 정보를 확인할 수 있다고 가정하지 마세요. 규칙을 추가하기 전에 대상 요청이 실제로 사용하는 도메인이나 주소를 확인하고, 화면에 표시된 이름을 요청 도메인으로 착각하지 않도록 주의하세요.
DIRECT는 직접 연결, REJECT는 거부, PROXY는 해당 프록시 정책으로 처리한다는 뜻입니다. 구성에서 사용자 지정 정책 이름을 참조할 수도 있으므로 규칙에 적힌 이름이 구성에 정의된 정책과 일치해야 합니다. 규칙 마지막에 이름 하나를 적는 것만으로 사용할 수 있는 서버나 정책이 만들어지지는 않습니다.
잘못 매칭된 경우 먼저 어떤 규칙이 적용됐는지 확인한 다음 매칭 값을 수정할지 정책을 바꿀지 결정하세요. 대상이 REJECT 규칙에 매칭됐다면 서버를 바꿔도 결과는 달라지지 않는 경우가 많습니다. 규칙이 참조하는 정책을 사용할 수 없다면 해당 정책의 구성원과 선택 상태를 확인하세요.
아래는 규칙 문법의 예시일 뿐 전체 구성이나 서버 정보가 아닙니다. example.com은 접미사 매칭을 설명하기 위한 예시입니다. 실제 구성에는 처리할 대상을 사용하세요.
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY규칙은 일반적으로 순서대로 확인하며 먼저 매칭된 규칙이 요청에 적용될 정책을 결정합니다. 구체적인 규칙을 더 넓은 범위의 규칙보다 앞에 두고, 앞선 규칙에 매칭되지 않은 요청은 FINAL로 처리합니다. 편집 전에 현재 사용할 수 있는 구성의 사본을 보관하세요. Config에서 새 구성이 활성화됐는지 확인한 뒤 Global Routing을 Config로 설정하고 대상에 다시 접속해 요청 기록에서 매칭된 규칙과 정책을 대조하세요.
유의 사항:원격 구성 업데이트로 로컬 변경 사항이 덮어써질 수 있습니다. 계속 유지할 사용자 지정 내용은 현재 앱에서 제공하는 구성 관리 방법에 따라 별도로 관리하세요. 저장에 성공했다는 것은 내용이 기록됐다는 뜻일 뿐, 규칙이 선택됐거나 대상 요청에 해당 규칙이 적용됐다는 뜻은 아닙니다.
연결 정보 관리
Subscribe는 서버 목록의 업데이트 출처를 관리하고, Add Server는 개별 연결 정보를 관리합니다. Config는 규칙과 관련 설정을 관리합니다.
기능 및 위치:Home에서 기존 서버와 그룹을 확인하고 추가 메뉴에서 Add Server로 이동하세요. 구독 링크가 있다면 앱에서 지원하는 Subscribe 메뉴를 사용하세요. 서버 한 대의 정보만 있다면 해당 프로토콜에 맞춰 입력합니다. Scan QR Code로 QR 코드를 가져올 수도 있지만, 스캔하기 전에 정보가 이용 중인 서비스 제공업체에서 온 것인지 확인하세요.
설정 방법:구독 링크는 이용 중인 서비스 제공업체에서 받으세요. 링크의 경로, 쿼리 매개변수와 대소문자를 그대로 유지하고, 붙여넣기 전후에 공백이나 줄바꿈이 섞이지 않았는지 확인하세요. 서버를 직접 추가할 때는 먼저 프로토콜을 선택한 다음 서버 주소, 포트와 해당 프로토콜에 필요한 인증, 전송 및 TLS 매개변수를 입력합니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 입력 항목이 서로 다르므로 다른 프로토콜의 설정 방법을 그대로 적용하지 마세요.
가져오기가 끝나면 Home에 서버 항목이 표시되는지 확인하고, 항목 하나를 선택해 Connectivity Test를 실행한 뒤 실제로 접속해 보세요. 구독을 가져오는 데 성공해도 목록에 있는 모든 서버를 사용할 수 있다는 뜻은 아닙니다. Connectivity Test에 결과가 나와도 모든 웹사이트에 접속할 수 있다는 뜻은 아니므로 두 가지를 각각 확인하세요.
구독 내용이 변경되면 해당 구독을 업데이트한 뒤 서버 수, 그룹과 현재 선택 항목이 달라졌는지 확인하세요. 업데이트에 실패하면 먼저 로컬 네트워크에서 구독 주소에 접속할 수 있는지 확인하고, 링크가 만료되지 않았는지와 응답 내용이 앱에서 인식되는 형식인지 살펴보세요. 오류 페이지, 로그인 페이지 또는 일반 웹페이지는 서버 구독으로 가져올 수 없습니다.
유의 사항:여러 항목을 정리하기 전에 구독으로 생성된 항목과 직접 추가한 항목을 구분하세요. 구독을 업데이트하면 구독에서 관리하는 내용이 다시 생성될 수 있으므로 자동 생성 항목을 임시로 수정한 내용에 의존하지 않는 편이 좋습니다. 구독 주소에는 대개 접근 인증 정보가 포함됩니다. 스크린샷, 로그와 문의 내용에서는 전체 링크와 인증 항목을 가리고, 공개 댓글이나 불필요한 검사 도구에 붙여넣지 마세요.
구독 가져오기 및 첫 연결 방법 보기 →연결 트리거 조건
On Demand는 연결을 시작할 시점을 정하고, Global Routing과 규칙은 연결 후 요청을 분기하는 방식을 정합니다.
기능 및 위치:On Demand는 설정한 조건에 따라 연결을 시작합니다. Settings에서 On Demand 또는 해당 요청 시 연결 설정 메뉴를 찾아 현재 조건과 스위치 상태를 확인하세요. 설정할 수 있는 조건은 현재 플랫폼에 표시된 항목을 기준으로 합니다. 다른 기기의 설정 목록에 있는 항목을 이 기기에서도 사용할 수 있다고 가정하지 마세요.
설정 방법:먼저 자동 연결로 인한 혼선을 막은 뒤 수동으로 연결해 서버, DNS와 규칙이 정상 작동하는지 확인하세요. 그런 다음 요청 시 연결 조건을 설정합니다. 현재 화면에 Wi-Fi, 셀룰러 네트워크 또는 지정된 네트워크 조건이 있다면 어떤 상황에서 연결하고 어떤 상황에서는 연결하지 않을지 하나씩 확인하세요. 저장한 뒤 제어 가능한 환경에서 네트워크를 한 번 바꾸어 연결 동작을 확인하고, 대상 요청에 적용된 정책도 테스트하세요.
유의 사항:On Demand는 서버 오류를 해결하는 기능이 아닙니다. 수동 연결부터 실패한다면 이 기능을 켜도 같은 문제가 반복될 뿐입니다. 연결을 끈 뒤 자동으로 다시 연결된다면 구성을 바로 삭제하지 말고 요청 시 연결 조건과 시스템의 관련 연결 설정부터 확인하세요. 문제를 확인하는 동안에는 기존 조건을 기록하고 자동 연결을 일시 중지했다가, 확인을 마치면 다시 설정하세요. 이렇게 하면 의도된 자동 연결을 오류로 오해하지 않을 수 있습니다.
사용량 확인
통계는 앱에 기록된 전송량을 확인하기 위한 것이며 서비스 제공업체의 사용량이나 통신사 요금 내역을 대체하지 않습니다.
기능 및 위치:Data를 열어 앱의 트래픽 통계를 확인하세요. 먼저 현재 화면에 표시된 통계 기준과 시간 범위를 읽고 업로드, 다운로드 또는 데이터 유형별 값을 비교합니다. 플랫폼에 따라 관련 항목이 다른 메뉴에 있을 수 있으므로 실제 화면의 이름과 설명을 기준으로 확인하세요.
사용 방법:특정 작업에서 트래픽이 발생했는지 확인하려면 현재 값을 기록하고, 명확한 작업을 한 번만 실행한 다음 Data에서 값이 변했는지 확인하세요. 장기간 살펴보기 전에 카운터가 연결을 바꿔도 유지되는지, 초기화 메뉴가 있는지, 초기화할 경우 어떤 기록에 영향을 주는지 확인하세요. 범위가 다른 데이터 값을 단순히 빼서 특정 앱의 정확한 사용량이라고 단정하지 마세요.
유의 사항:프로토콜 오버헤드, 재전송, 통계 기준과 청구 주기에 따라 값이 달라질 수 있습니다. Data 값이 증가했다는 사실만으로 특정 웹 요청이 지정한 서버를 통과했다고 단정할 수는 없습니다. 라우팅을 확인하려면 요청 기록과 정책을 살펴보세요. 백그라운드 사용량이 의심된다면 시스템의 앱별 네트워크 사용량 및 배터리 기록과 함께 비교하세요.
자주 쓰는 설정 항목별 안내
정상적으로 연결되는 기본 설정을 먼저 유지하세요. 아래 항목은 하나씩 조정하고, 조정할 때마다 같은 대상을 사용해 확인하세요.
기능 및 위치:DNS는 도메인을 주소로 변환합니다. 관련 설정은 Settings 또는 현재 Config의 구성 내용에 있을 수 있습니다. 먼저 어떤 구성을 사용 중인지, 해당 구성에 DNS가 정의되어 있는지 확인하세요. 전역 설정만 바꾸고 구성 내부의 관련 설정을 놓치지 않도록 주의하세요.
설정 방법 및 유의 사항:현재 정상 작동하는 DNS 설정을 유지하고, 분명한 필요가 있을 때만 사용자 지정 DNS나 DNS over HTTPS로 바꾸세요. 설정 후 같은 도메인으로 요청을 다시 보내 해석 결과, 접속 결과와 기록을 비교합니다. DNS over HTTPS 엔드포인트 자체에도 접속할 수 있어야 합니다. 이 설정만으로 잘못된 규칙, 인증 정보 또는 사용할 수 없는 서버가 자동으로 해결되지는 않습니다. 자세한 내용은 DNS 설정 안내를 확인하세요.
기능 및 위치:Settings의 Test Method에서 연결 테스트 방법을 선택할 수 있습니다. 방법에 따라 확인하는 단계가 다르므로 테스트 결과를 볼 때 선택한 방법도 함께 고려하세요. 단일 수치만 따로 비교하지 마세요.
설정 방법 및 유의 사항:서버를 비교하기 전에 Test Method, 테스트 대상과 로컬 네트워크를 동일하게 유지한 다음 Connectivity Test를 실행하세요. 포트에 연결된다고 전체 프록시 요청이 성공하는 것은 아니며, 테스트 대상에 접속된다고 다른 대상에도 접속할 수 있는 것은 아닙니다. 테스트 결과와 실제 사용 경험이 다르면 모든 설정을 자주 바꾸기보다 먼저 테스트 방법과 대상을 확인한 뒤 실제 요청 기록을 살펴보세요.
기능 및 위치:Today Widget은 해당 플랫폼에서 제공하는 빠른 확인 또는 조작 메뉴입니다. Settings에서 관련 설정을 찾고, 시스템의 위젯 관리 화면에서 추가할 수 있는지 확인하세요. 표시 방식은 시스템 버전에 따라 다를 수 있습니다.
설정 방법 및 유의 사항:먼저 앱에서 서버를 선택하고 연결이 정상인지 확인한 다음 위젯에서 실제로 사용할 수 있는 항목을 설정하세요. 추가한 뒤 빠른 조작을 한 번 시험하고 앱으로 돌아가 현재 상태를 확인합니다. 위젯은 일정 간격으로 갱신될 수 있으므로 표시 문구가 바로 바뀌지 않는다는 이유만으로 연결 실패라고 판단하지 마세요. 위젯이 보이지 않으면 현재 시스템과 앱에서 해당 메뉴를 제공하는지 확인하세요.
기능 및 위치:iCloud 관련 설정은 앱에서 지원하는 데이터 동기화 또는 백업 기능을 관리합니다. Settings에서 구체적인 안내를 확인하고 시스템의 iCloud 권한, 계정 및 사용 가능한 저장 공간도 살펴보세요. 동기화 범위는 앱에 명시된 항목을 기준으로 하며 모든 데이터가 옮겨진다고 가정하지 마세요.
설정 방법 및 유의 사항:처음 켜기 전에 기기에서 사용할 수 있는 구성을 보관하세요. 먼저 한 기기에서 업로드 또는 동기화를 마친 다음 다른 기기에서 내용이 맞는지 확인합니다. 충돌이 발생하면 덮어쓰기 작업을 반복하지 말고 먼저 보존할 내용을 확인하세요. 동기화가 계속 유지되는 별도 백업을 의미하지는 않으며 삭제 내용도 다른 기기에 반영될 수 있습니다. 서버 인증 정보와 구독 링크는 민감한 정보로 관리하세요.
기능 및 위치:Diagnostics는 연결과 요청 문제를 파악하는 데 도움이 되는 정보를 제공합니다. Settings에서 해당 메뉴를 열고 도구가 실제로 검사하는 대상과 현재 결과를 확인하세요. 하나의 진단 결과를 전체 네트워크에 대한 결론으로 확대 해석하지 마세요.
사용 방법:문제가 발생한 대상, 현재 Global Routing 모드, 선택한 서버와 네트워크 종류를 기록한 뒤 같은 상황을 한 번 재현하세요. 도메인 해석 실패, 연결 시간 초과, 인증 실패 또는 예상과 다른 정책 선택 중 어느 문제인지 확인하고 해당 단계만 조정합니다. 같은 문제가 여러 네트워크에서 발생하더라도 각각 따로 기록하고 한 번의 진단에 섞지 마세요.
유의 사항:로그를 내보내거나 공유하기 전에 서버 주소, 구독 링크, 인증 항목과 개인 접속 기록이 포함되어 있는지 확인하고 꼭 필요한 범위만 제공하세요. 추가 확인이 필요하면 증상에 맞춰 문제 해결 가이드를 참고하세요. 도움을 요청하려고 전체 구성을 공개할 필요는 없습니다.
설정 후 확인
서버 사용 가능 여부, 모드 설정, 규칙 매칭을 따로 확인하면 설정을 반복해서 바꾸는 일을 줄일 수 있습니다.
한 가지 설정을 바꾼 뒤 문제가 생기면 직전의 정상 설정으로 되돌리고 한 번에 한 가지 조건만 바꿔 다시 확인하세요. 가져오기부터 시작해야 한다면 처음 사용 가이드를 읽어보세요. 연결은 되지만 일부 대상에 접속할 수 없다면 증상별 문제 해결 가이드를 먼저 확인하세요. 앱 다운로드와 설치 문제는 전체 플랫폼 다운로드에서 확인할 수 있으며 규칙을 수정할 필요는 없습니다.