OFFICIAL MANUAL / FEATURES

Shadowrocket 기능 및 주요 설정

Global Routing부터 시작해 연결 방식, 규칙 매칭, 자동 연결 조건을 살펴보세요. 필요에 따라 구독, DNS, 진단 항목을 조정하고, 원인을 찾기 어렵지 않도록 여러 설정을 한꺼번에 바꾸지 마세요.

Global Routing Rule On Demand Settings

Shadowrocket은 iPhone, iPad, Mac, Windows, Android, Linux 버전을 제공합니다. 이 문서는 주로 iPhone / iPad의 화면 용어와 조작 경로를 기준으로 설명합니다. 다른 플랫폼에서는 메뉴 위치와 시스템 권한이 다를 수 있으니 현재 화면을 기준으로 확인하세요. 다운로드 경로는 전체 플랫폼 다운로드 페이지에서 확인하고, 처음 사용하는 경우 빠른 시작을 먼저 읽어보세요.

사용 전 확인: 구독 또는 서버 정보는 사용자가 직접 준비해야 하며, 구독 링크는 이용 중인 서비스 제공업체에서 받으세요. 앱의 일회성 구매는 회선 요금제가 아닙니다. iPhone / iPad 버전은 App Store에서 $2.99에 1회 구매하며, Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료입니다. 이 사이트는 서버 노드나 구독 서비스를 제공하지 않습니다.

01 / GLOBAL ROUTING

Global Routing: 설정, 프록시 및 직접 연결

먼저 트래픽의 경로 선택 방식을 정한 다음 개별 규칙을 확인하세요. 모드를 선택하는 것만으로 연결이 설정되는 것은 아닙니다.

기능: Global Routing은 전체 라우팅 방식을 선택하는 메뉴입니다. Config는 현재 설정 파일에 따라 트래픽을 분기합니다. Proxy는 클라이언트가 처리하는 일반 요청에 선택된 프록시 경로를 사용합니다. Direct는 직접 연결 경로를 사용합니다. 여기서 Proxy는 화면에 표시되는 모드 이름이고, 규칙의 PROXY는 정책 키워드이므로 서로 다른 계층에 해당합니다.

화면 위치: Home으로 이동해 Global Routing에서 현재 선택된 항목을 확인하세요. 평소 규칙에 따라 트래픽을 분기하려면 Config를 선택하고, Config에서 원하는 설정 파일이 선택되어 있는지 확인합니다. 특정 서버의 연결 가능 여부를 점검할 때는 Proxy를 잠시 선택할 수 있습니다. 선택한 뒤 Home으로 돌아가 서버 선택과 연결 상태를 확인하세요.

세 가지 모드의 용도와 확인 사항
모드경로 선택 방식사용 상황주의 사항
Config(설정)현재 설정의 규칙과 정책에 따라 처리도메인, IP 등의 조건에 따라 평소 트래픽 분기설정이 활성화되어 있고 FINAL이 원하는 정책을 가리키는지 확인
Proxy(프록시)일반 요청에 선택된 프록시 경로 사용서버 문제와 규칙 문제를 임시로 구분시스템의 트래픽 처리 범위, 프로토콜 지원 및 예외 설정의 영향을 받음
Direct(직접 연결)대상에 직접 연결로컬 네트워크에서 직접 접속하는 경우와 비교클라이언트를 끄는 기능이 아니며 프록시 서버의 연결 상태를 검사하지 않음

설정 방법: 먼저 Config를 선택한 뒤, 직접 연결될 것으로 예상하는 대상과 프록시를 사용할 것으로 예상하는 대상을 각각 열어보세요. 후자만 문제가 있다면 현상을 기록한 다음 Proxy로 잠시 전환해 다시 시도합니다. Proxy에서는 정상인데 Config에서 문제가 발생한다면 규칙 순서, 정책 대상, 설정 파일 선택을 확인하세요. 두 모드 모두 문제가 있다면 서버 매개변수, DNS, 현재 네트워크를 점검하세요.

주의 사항: 모드를 바꾸면 보통 새 연결에 적용되며, 기존 연결은 이전 상태를 유지할 수 있습니다. 테스트할 때는 해당 요청을 종료하고 다시 실행하세요. 필요한 경우 연결을 다시 설정합니다. 테스트가 끝나면 원래 모드로 되돌리고, 점검용 모드를 평소 설정으로 계속 사용하지 마세요. Proxy를 선택했다고 모든 시스템 트래픽이 반드시 같은 경로를 이용하는 것은 아닙니다.

02 / RULE

규칙 분기: 매칭 조건과 적용 정책

기능: 규칙은 일반적으로 매칭 유형, 매칭 대상, 정책으로 구성됩니다. 매칭 유형은 어떤 요청을 식별할지, 정책은 매칭된 요청을 어떻게 처리할지 정합니다. 규칙은 위에서 아래 순서로 확인하며, 일치하는 규칙의 정책이 적용됩니다. 따라서 규칙 수보다 같은 대상이 어떤 규칙에 매칭되는지가 더 중요합니다.

화면 위치: Config에서 현재 설정을 확인한 뒤 편집 메뉴로 들어가 Rule 항목을 살펴보세요. 수정 전에 설정 파일을 복사해 두고, 목록에서 선택되지 않은 다른 파일이 아니라 현재 사용 중인 파일을 수정하는지 확인합니다. 규칙이 의도한 대로 트래픽을 분기하려면 Global Routing에서 Config를 사용해야 합니다.

자주 사용하는 매칭 유형

  • DOMAIN: 지정한 전체 도메인과 매칭합니다.
  • DOMAIN-SUFFIX: 도메인과 해당 도메인의 하위 도메인을 매칭합니다.
  • DOMAIN-KEYWORD: 도메인에 포함된 키워드로 매칭하며, 범위가 넓을 수 있습니다.
  • IP-CIDR, IP-CIDR6: IPv4 및 IPv6 주소 대역과 매칭합니다.
  • GEOIP: IP 지리 데이터베이스를 기준으로 분류하며, 결과는 데이터베이스 내용에 따라 달라집니다.
  • FINAL: 앞선 규칙에 매칭되지 않은 요청을 처리합니다.

자주 사용하는 정책

  • DIRECT: 프록시 서버를 거치지 않고 대상에 직접 연결합니다.
  • PROXY: 설정에서 지정한 프록시 경로를 사용합니다.
  • REJECT: 매칭된 요청을 거부하며, 페이지 콘텐츠를 수정하지는 않습니다.

설정에는 이름이 지정된 정책 그룹이 포함될 수도 있습니다. 그룹 이름이 설정 내 정의와 일치하는지 확인하세요. 이름만 보고 동작을 추측해서는 안 됩니다.

설정 방법: 범위가 명확한 예외 규칙을 더 포괄적인 규칙보다 위에 두고, 마지막에는 FINAL을 유지하세요. 다음은 문법과 순서만 보여주는 예시입니다. 예시 도메인 요청은 PROXY로 보내고, 나머지 요청은 FINAL에 따라 DIRECT로 처리합니다. 모든 네트워크에 적합한 완성 설정이 아니며 서버 정보도 포함하지 않습니다.

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

주의 사항: 도메인 규칙과 IP 규칙은 서로 다른 정보를 기준으로 매칭합니다. 요청에서 도메인을 식별할 수 있는지, DNS 조회 결과와 규칙 순서는 무엇인지에 따라 최종 매칭 결과가 달라집니다. USER-AGENT처럼 요청 필드에 의존하는 매칭은 적용 조건이 있으므로, 암호화된 모든 요청을 식별하는 범용 방식으로 볼 수 없습니다. 수정 후 요청을 다시 실행하고 연결 기록에 표시된 실제 정책을 확인하세요.

대상 하나의 문제를 해결하려고 설정 파일 전체를 바로 교체하지 마세요. 먼저 범위가 명확한 테스트 규칙을 추가해 매칭 여부를 확인한 다음 정리하세요. 특히 REJECT를 사용할 때는 잘못 매칭되지 않는지 확인해 로그인, 이미지 또는 공유 API가 차단되지 않도록 주의하세요. 규칙 순서에 관한 자세한 내용은 규칙 매칭 및 FINAL 참고를 확인하세요.

03 / SUBSCRIBE & SERVER

구독 및 서버 관리

기능: 서버 항목에는 연결에 필요한 주소, 포트, 인증 정보, 프로토콜 매개변수가 저장됩니다. 구독은 서버 항목을 묶음으로 가져오고 업데이트하는 데 사용됩니다. 구독 링크는 서버 주소가 아니며, 서버 목록은 트래픽 분기 설정 파일과 다릅니다. 가져오기에 성공했다는 것은 콘텐츠를 인식했다는 뜻일 뿐이므로, 서버를 선택하고 실제 연결을 확인해야 합니다.

화면 위치: Home에서 서버 목록을 확인하고 Add Server를 눌러 항목을 추가한 다음 내용에 맞는 유형을 선택하세요. 구독을 가져오려면 Subscribe를 선택하고 전체 URL을 입력합니다. Config는 주로 설정 파일을 관리합니다. 설정 구독 메뉴가 보이면 가져오는 항목이 설정 파일인지 서버 목록인지 먼저 확인하세요. Scan QR Code로 기존 QR 코드를 인식할 수 있지만, 사용 전에 출처와 형식을 확인해야 합니다.

설정 방법: 서버를 직접 추가할 때는 서비스 제공업체의 안내에 따라 Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2 등의 유형을 선택한 뒤 각 매개변수를 입력하세요. 주소와 포트가 정확해도 항목이 완성된 것은 아닙니다. 일부 유형은 TLS, Server Name, 전송 방식 등의 추가 필드가 필요하므로 이름만 보고 임의로 값을 입력하지 마세요. 필드의 의미는 프로토콜 참고 자료에서 확인할 수 있습니다.

구독 링크는 이용 중인 서비스 제공업체에서 받으세요. 붙여넣을 때 앞뒤 공백, 줄바꿈, 내용 누락이 없는지 확인하고 저장한 뒤 업데이트를 실행해 예상한 그룹과 항목이 표시되는지 확인합니다. 구독과 직접 추가한 항목에는 알아보기 쉬운 이름을 지정하세요. 구독에 포함된 서버를 임시로 수정해야 한다면 별도 항목으로 저장해 이후 업데이트가 변경 사항을 덮어쓰지 않도록 합니다.

주의 사항: 구독 그룹을 삭제하기 전에 그 안의 항목을 보관해야 하는지 확인하세요. 업데이트에 실패했다면 링크에 접근할 수 없는 문제, 응답 형식이 지원되지 않는 문제, 목록 업데이트 후 연결에 실패하는 문제를 구분해야 합니다. 각각 점검 방법이 다릅니다. 구독 URL, 전체 QR 코드, 인증 정보를 공개 이미지에 포함하지 마세요. 동기화 및 백업 데이터에도 인증 정보가 들어 있을 수 있으므로 주의해서 다루세요.

04 / ON DEMAND

On Demand: 조건에 따라 연결 설정

기능: On Demand는 시스템의 주문형 연결 기능을 이용해 지정된 네트워크 조건이 충족될 때 연결을 시도합니다. On Demand는 ‘언제 연결할지’를 관리하고 Global Routing은 ‘연결 후 어떤 경로를 사용할지’를 관리합니다. 두 기능은 함께 사용할 수 있지만 서로 대체하지는 않습니다.

화면 위치: Settings에서 On Demand를 찾아 현재 사용할 수 있는 네트워크 조건과 동작을 확인하세요. 표시되는 조건은 시스템과 버전에 따라 다를 수 있으므로 현재 화면의 선택 항목을 기준으로 합니다. 연결 프로파일을 처음 승인할 때는 시스템 안내에 따라 확인한 뒤 자동 연결을 테스트하세요.

설정 방법: 먼저 수동 연결 상태에서 서버, 설정, DNS가 정상인지 확인한 다음 On Demand를 켜세요. 지정 네트워크에서 연결 동작을 설정하는 등 조건을 한 번에 하나씩 추가하고, 네트워크를 전환해 예상대로 작동하는지 확인합니다. 조건에 Wi-Fi 이름이 포함된다면 기기에 실제 표시되는 이름을 입력하세요. 이름이 비슷해도 서로 다른 네트워크일 수 있습니다.

주의 사항: On Demand가 작동한다고 해서 연결할 수 없는 서버가 복구되거나 시스템이 백그라운드 프로세스를 항상 유지하는 것은 아닙니다. 시스템 권한, 네트워크 전환, 다른 VPN 설정이 작동에 영향을 줄 수 있습니다. 자동 연결을 잠시 멈추려면 먼저 On Demand를 끈 다음 연결을 해제하세요. 그렇지 않으면 조건이 충족되어 다시 연결될 수 있습니다. 모든 설정을 반복해서 삭제하고 다시 만들 필요는 없습니다.

05 / DATA

Data: 트래픽 및 연결 기록 확인

기능: Data에서는 클라이언트가 기록한 트래픽과 연결 상태를 살펴볼 수 있습니다. 요청이 처리 범위에 들어왔는지, 데이터 전송이 계속되는지, 연결이 반복해서 발생하는지 확인하는 데 도움이 됩니다. 통계는 클라이언트의 측정 기준을 반영하므로 서비스 제공업체의 청구 내역이나 기기의 모든 네트워크 활동을 보여주는 전체 기록은 아닙니다.

화면 위치: Data를 열어 현재 화면에 표시되는 업로드, 다운로드 및 연결 관련 기록을 확인하세요. 통계의 시간 범위와 현재 세션 기준 여부, 기록을 지우거나 초기화하는 기능이 있는지 먼저 살펴봅니다. 통계 메뉴마다 집계 기간이 다를 수 있으므로 비교할 때는 같은 기준을 사용하세요.

확인 방법: 특정 접속 문제를 점검할 때는 먼저 현재 상태를 기록한 뒤 대상 하나만 열어 요청을 다시 실행하고 데이터 변화 여부를 살펴보세요. 연결 세부 정보가 표시된다면 대상, 정책, 오류 메시지도 확인합니다. 통계를 초기화해야 한다면 비교에 사용할 기록을 먼저 저장해 근거를 잃지 않도록 하세요.

주의 사항: 업로드와 다운로드 수치가 늘어나는 것은 데이터가 전송되었다는 뜻일 뿐, 대상 페이지가 올바르게 응답했다는 증거는 아닙니다. 프로토콜 오버헤드, 재시도, 시스템의 집계 주기, 서비스 제공업체의 측정 기준에 따라 수치가 달라질 수 있습니다. 프록시 경로의 통계로 모든 직접 연결 트래픽을 추정할 수도 없습니다. 문제를 알릴 때는 시간, 오류 유형, 정책을 남기고 개인 도메인, 주소, 인증 정보를 가리세요.

06 / SETTINGS

Settings: 주요 항목과 설정 범위

설정 항목의 표시 여부, 메뉴 위치, 권한 요구 사항은 현재 플랫폼의 화면을 기준으로 확인하세요. 다음 내용은 각 항목의 용도를 설명하며, 특정 플랫폼의 메뉴 경로를 모든 플랫폼에 동일하게 적용하지 않습니다.

DNS: 적용 위치부터 확인

기능 및 위치: DNS는 도메인 이름을 IP 주소로 변환합니다. 먼저 Settings에서 DNS 관련 옵션을 확인하고, 현재 Config 파일의 General 항목에 DNS 매개변수가 설정되어 있는지도 살펴보세요. 전역 설정과 설정 파일이 함께 결과에 영향을 줄 수 있으므로 한 화면만 보고 실제 적용 값을 판단할 수는 없습니다.

설정 방법 및 주의 사항: 정상 작동하는 기본 설정은 유지하고, DNS 서비스에서 지원하는 주소 형식을 입력하세요. 한 번에 한 항목만 바꾼 뒤 다시 연결하고 새 DNS 조회 요청을 실행합니다. 특정 사이트가 실패했다고 DNS, 서버, 규칙을 동시에 변경하지 마세요. DNS 조회에 성공해도 대상 연결까지 성공한 것은 아닙니다. 도메인 조회 오류, 주소 연결 가능 여부, TLS 연결 오류를 구분해야 합니다. 내부 도메인의 경우 선택한 DNS 서비스에서 조회할 수 있는지 먼저 확인해, 로컬 네트워크에서만 유효한 이름이 적절하지 않은 DNS 경로로 전달되지 않도록 하세요.

Test Method: 테스트 결과의 의미 이해

기능 및 위치: Settings의 Test Method는 Connectivity Test에서 사용하는 테스트 방식을 결정합니다. 테스트 방식에 따라 포트 연결을 확인하거나 특정 요청을 보내 응답을 확인할 수 있으므로, 표시되는 수치의 의미가 서로 다를 수 있습니다.

설정 방법 및 주의 사항: 현재 화면에서 제공하는 방식 중 서버에 적합한 항목을 선택한 다음 Home에서 Connectivity Test를 실행하세요. 여러 항목을 비교할 때는 테스트 방식, 대상, 네트워크 환경을 동일하게 유지해야 합니다. 조건이 다른 결과를 단순히 순위로 비교하지 마세요. 한 번 응답이 빠르다고 해서 지속적인 다운로드 속도, 배터리 소모량, 모든 사이트의 접속 상태까지 알 수 있는 것은 아닙니다. 테스트 실패는 테스트 대상 자체의 문제일 수도 있으므로 실제 접속도 확인하세요.

Today Widget: 시스템에서 빠르게 실행

기능 및 위치: Today Widget은 시스템 위젯과 연동되는 빠른 제어 또는 상태 확인 기능입니다. Settings에서 관련 항목을 찾고 시스템의 위젯 관리 화면에서 해당 위젯을 사용할 수 있는지 확인하세요. 위젯 지원 여부는 현재 시스템에 따라 달라집니다.

설정 방법 및 주의 사항: 먼저 앱에서 설정과 권한을 완료한 다음 시스템 안내에 따라 사용할 수 있는 위젯을 추가하고, 표시된 정보가 Home 화면과 일치하는지 확인하세요. 위젯은 빠른 조작을 위한 기능으로 설정 편집을 대신하거나 시스템 연결 권한을 우회하지 않습니다. 상태 표시가 늦어질 수 있으므로 연결에 문제가 있으면 앱으로 돌아가 세부 정보를 확인하세요. 시스템에 해당 위젯이 표시되지 않는다면 다른 플랫폼의 추가 방법을 그대로 적용하지 마세요.

iCloud: 설정 동기화와 데이터 범위

기능 및 위치: iCloud 관련 항목은 지원되는 Apple 기기 간에 앱이 허용한 데이터를 저장하거나 동기화하는 데 사용됩니다. Settings에서 동기화 옵션을 확인하고 시스템 설정에서 iCloud와 앱 접근 권한을 확인하세요. 실행 상태, 기록, 모든 필드가 동기화된다고 가정하지 마세요.

설정 방법 및 주의 사항: 동기화를 켜기 전에 중요한 설정을 백업하고, 같은 Apple 계정에 연결된 각 기기의 권한을 확인한 뒤 동기화 후 설정 이름과 내용을 비교하세요. 충돌이 발생하면 먼저 두 버전을 모두 복사해 두고 어느 쪽을 사용할지 결정하세요. 여러 기기에서 같은 설정을 동시에 편집하지 않는 것이 좋습니다. 서버 인증 정보가 포함된 설정도 민감한 데이터입니다. iCloud 동기화는 모든 플랫폼에 적용되는 범용 방식이 아니며 App Store 구매 기록을 복원하지도 않습니다.

Diagnostics: 오류 재현 정보 수집

기능 및 위치: Settings의 Diagnostics에서 현재 사용할 수 있는 진단 옵션을 확인하세요. 진단 기능은 DNS, 연결 설정, 인증, 요청 단계의 문제를 구분할 수 있도록 오류 단서를 수집합니다. 서버를 자동으로 변경하거나 원격 서비스를 복구하는 기능은 아닙니다.

설정 방법 및 주의 사항: 현재 화면에서 제공하는 기록 기능을 필요한 경우에만 켜고, 시작 시간을 기록한 뒤 실패 상황을 한 번 재현하고 해당 결과를 확인하거나 내보내세요. 완료 후에는 임시로 켠 상세 기록을 꺼서 불필요한 데이터가 장기간 남지 않도록 합니다. 공유 전에는 구독 URL, 비밀번호, 인증 항목, 서버 주소, 개인 접속 기록을 하나씩 확인하세요. 문제와 관련된 부분만 제공하고, 화면에 표시된 이름만 가린 채 전체 링크를 남기지 마세요.

07 / CHECKLIST

주요 설정 확인 순서

‘연결됨’ 상태와 ‘예상한 대로 트래픽이 분기됨’은 서로 다른 문제입니다. 시스템에 연결 상태가 표시된 뒤에도 요청 경로와 응답 결과를 확인해야 합니다. 다음 순서대로 점검하면서 한 번에 하나의 설정만 변경하고, 문제를 재현하는 방법을 기록해 두세요.

  1. 먼저 Home 확인: 선택한 서버가 예상한 그룹에 속하는지, 구독 업데이트 후 이름이 같은 이전 항목을 잘못 선택하지 않았는지 확인하세요. 스위치 위치만 보지 말고 실제로 연결이 설정되었는지도 확인합니다.
  2. 다음 Global Routing 확인: 평소 Config를 사용한다면 현재 설정 파일과 대상 정책을 확인하세요. 비교가 필요하면 Proxy로 잠시 전환하고 테스트가 끝난 뒤 원래 모드로 되돌립니다.
  3. Config 확인: 관련 규칙을 위에서 아래로 살펴보고 정책 그룹과 FINAL을 확인하세요. 파일을 편집한 뒤 다시 선택하거나 화면 안내에 따라 변경 사항을 적용한 다음 요청을 다시 실행합니다.
  4. DNS 확인: DNS 조회 실패와 연결 실패를 구분하고, 정상 작동이 확인된 설정을 비교 기준으로 유지하세요. 여러 DNS 매개변수를 한꺼번에 변경하지 마세요.
  5. Data 및 Diagnostics 확인: 대상 동작을 한 번만 재현하고 시간과 오류 내용을 바탕으로 요청이 어느 단계에서 멈췄는지 확인하세요.
  6. 마지막으로 자동화 복원: 수동 연결이 안정적으로 작동한 뒤 On Demand, 동기화 또는 빠른 실행 기능을 켜고 네트워크를 전환해도 예상대로 동작하는지 확인하세요.

서버 연결은 정상인데 특정 대상만 계속 문제가 발생하면 같은 구독을 반복해서 가져오지 말고 해당 대상의 규칙, DNS, 서비스 상태를 확인하세요. 여러 대상에서 모두 실패한다면 서버 매개변수, 구독 유효성, 로컬 네트워크를 차례로 점검합니다. 자세한 조작 방법은 빠른 시작을, 문제별 안내는 자주 묻는 질문을 확인하세요. 화면 이름과 규칙 용어는 용어 설명에서 찾아볼 수 있습니다.

Shadowrocket 전체 플랫폼 다운로드