Shadowrocket 공식 매뉴얼 / 기능 및 설정

Shadowrocket 프록시 모드

Home에서 Global Routing을 확인한 뒤 규칙, 서버, 연결 조건을 점검하세요. 접속 문제가 발생하면 한 번에 한 항목만 변경하고 같은 대상에 다시 접속해 확인합니다.

Global Routing
연결 처리 방식
On Demand
연결 시작 시점
Data
트래픽 사용량
01 라우팅 방식

Global Routing의 세 가지 모드

Home에서 Global Routing을 열고 구성(Config), 프록시(Proxy), 직접 연결(Direct) 중 하나를 선택할 수 있습니다. 이 설정은 클라이언트가 처리하는 트래픽의 경로를 정하며, 연결 시작 시점을 선택하거나 Config에 저장된 규칙을 바꾸지는 않습니다. 아래에서는 각 모드를 화면에 표시되는 용어로 설명합니다. 플랫폼별 메뉴 위치는 실제 화면을 확인하세요.

트래픽 처리 방식과 테스트 상황에 맞춰 선택하세요
모드처리 방식사용 상황
구성(Config) 현재 활성화된 구성의 규칙에 따라 일치하는 정책을 적용합니다. 도메인이나 주소별로 연결을 다르게 처리할 때 사용합니다. 현재 활성화된 구성을 확인한 뒤 대상에 적용된 규칙을 점검하세요.
프록시(Proxy) 구성의 규칙별로 분기하지 않고, 이 모드에서 처리되는 연결을 선택한 프록시 서버로 보냅니다. 서버가 등록되어 있고 특정 대상에 접속할 수 있는지 개별적으로 확인할 때 잠시 사용하세요. 테스트가 끝나면 평소 사용하는 모드로 되돌립니다.
직접 연결(Direct) 클라이언트 연결은 유지하면서 해당 트래픽을 프록시 서버를 거치지 않고 연결합니다. 현재 네트워크에서 대상에 직접 접속할 수 있는지 비교할 때 사용합니다. 클라이언트를 완전히 끈 상태를 확인하려면 연결을 별도로 종료해야 합니다.

예를 들어 어떤 사이트가 Proxy에서는 열리지만 Config에서는 열리지 않는다면, 먼저 예상한 정책이 적용됐는지 확인하세요. 곧바로 서버를 바꿀 필요는 없습니다. 반대로 같은 대상이 프록시에서는 연결되지 않고 직접 연결에서는 열린다면 서버 정보와 프록시 경로를 점검하세요. 비교할 때는 동일한 Wi-Fi 또는 셀룰러 네트워크를 유지하고 요청을 새로 시작하세요. 기존 연결은 모드를 바꾸기 전 경로를 계속 사용할 수 있습니다.

Proxy와 Direct는 모드이고, PROXY와 DIRECT는 구성에 지정된 정책입니다. 전역 모드를 선택하는 것과 특정 규칙에 일치하는 정책을 선택하는 것은 서로 다른 작업입니다.

02 규칙 적용 순서

규칙 유형과 분기 정책

Config에서 현재 활성화된 구성을 찾아 규칙 목록을 연 다음, Home으로 돌아가 Global Routing이 Config인지 확인하세요. 규칙은 일치 조건과 처리 결과를 지정합니다. DOMAIN은 특정 호스트 이름과 일치하고, DOMAIN-SUFFIX는 지정된 도메인과 하위 도메인에 적용되며, DOMAIN-KEYWORD는 호스트 이름에 포함된 문자열을 기준으로 더 넓게 일치합니다. 특정 호스트 하나만 처리하려면 이름이 비슷한 다른 호스트까지 포함되지 않도록 먼저 DOMAIN을 사용하세요.

IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 대역을 기준으로 일치합니다. GEOIP는 도메인 접미사가 아니라 IP 주소의 지리적 분류를 기준으로 합니다. USER-AGENT는 해당 요청 식별 정보를 읽을 수 있는지에 따라 달라지므로, 모든 연결에서 이 정보를 확인할 수 있다고 가정해서는 안 됩니다. 대상에 도메인 이름과 IP 주소로 모두 접속할 수 있다면 재시험할 때 두 접속 방식을 구분하세요.

PROXY는 일치하는 연결을 프록시로 보내고, DIRECT는 직접 연결하며, REJECT는 연결을 거부합니다. 아래 예시는 규칙 순서만 보여 줍니다. 특정 호스트는 직접 연결하고, 같은 도메인의 다른 호스트는 프록시로 보내며, 나머지 요청에는 FINAL을 적용합니다.

DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

규칙은 일반적으로 위에서부터 확인하며, 일치하는 규칙의 정책을 적용합니다. 예시의 처음 두 규칙 순서를 바꾸면 docs.example.com은 더 넓은 접미사 규칙에 먼저 일치합니다. 수정 전에 원래 구성을 보관하고, 구체적인 규칙을 포괄적인 규칙보다 앞에 둔 뒤 마지막 대체 정책을 확인하세요. 저장 후에는 실제로 편집한 파일이 활성화됐는지 확인해야 합니다. 미리보기에서만 수정했거나 다른 구성이 여전히 활성화되어 있으면 이후 접속 테스트로 변경 사항을 검증할 수 없습니다.

03 기존 연결 정보

구독 가져오기 및 서버 관리

구독은 기존 서버 항목 여러 개를 관리할 때 사용하고, 서버 수동 추가는 알고 있는 엔드포인트 하나만 설정할 때 적합합니다. 서비스 제공업체에서 받은 구독 주소가 있다면 Home에서 Add Server를 열고 Subscribe를 선택한 다음 주소를 입력하고 저장하세요. 서버 하나의 설정값을 알고 있다면 Add Server에서 해당 정보와 일치하는 프로토콜을 선택하고 주소, 포트 및 필요한 항목을 입력합니다. 구독 주소를 개별 서버의 주소 입력란에 넣지 마세요.

가져오기가 끝나면 Home의 서버 목록으로 돌아가 항목이 추가됐는지 확인한 뒤 하나를 선택해 Connectivity Test를 실행하세요. 테스트 결과는 사용한 방법과 대상에 따라 달라질 수 있습니다. 테스트가 통과해도 실제로 사용할 Global Routing 모드에서 대상에 접속해 확인해야 합니다. 실패하면 먼저 프로토콜, 주소, 포트 등 원래 정보를 다시 확인하고, 특정 서버 하나의 문제인지 같은 구독의 여러 항목이 모두 실패하는지 구분하세요.

구독을 새로고침하기 전에 현재 사용 중인 항목을 기록해 두세요. 원격 업데이트 후 이름, 주소, 항목 수가 달라져 이전 항목을 더 이상 선택할 수 없을 수 있습니다. 구독 주소에 접속 자격 정보가 포함될 수 있으므로 전체 링크를 공유 문서, 공개 스크린샷 또는 진단 기록에 붙여 넣지 마세요. 이 사이트는 보유 중인 구독이나 서버 정보를 사용하는 방법만 안내하며, 관련 서비스를 제공·판매·추천하지 않습니다.

04 연결 조건

On Demand 연결

On Demand는 설정한 네트워크 조건에 따라 연결을 시작합니다. 접속할 때마다 규칙을 임시로 선택하는 기능은 아닙니다. 먼저 Home에서 수동으로 연결해 정상 작동을 확인한 다음, Settings에서 On Demand를 찾아 현재 플랫폼에 표시되는 조건에 따라 적용 범위를 설정하세요. Wi-Fi에서 셀룰러 네트워크로 전환하는 등 재현하기 쉬운 상황부터 시작하고 연결이 예상대로 시작되는지 확인합니다.

다시 테스트할 때는 연결이 시작되는 상황과 시작되지 않는 상황을 모두 확인하세요. 수동으로 연결을 끊은 뒤 다시 연결된다면 현재 네트워크가 On Demand의 트리거 조건에 여전히 해당하는지 먼저 살펴보세요. 수동 연결만 테스트하려면 On Demand를 잠시 끄고, 확인을 마친 뒤 다시 켜면 됩니다. 연결이 자주 끊겼다 다시 되거나 대기 중 배터리 사용량이 달라졌다면 네트워크가 반복해서 전환되는지 확인하고 비슷한 시간대를 비교한 다음 트리거 범위를 조정하세요.

05 트래픽 확인

Data 트래픽 통계

Data에서 클라이언트가 기록한 트래픽을 확인하세요. 먼저 표시된 값이 누적 사용량인지 특정 기간의 통계인지, 업로드인지 다운로드인지 확인합니다. 한 번의 작업으로 증가한 양을 알고 싶다면 시작 값을 기록하고 동일한 네트워크에서 재현 가능한 작업을 한 뒤 종료 값을 기록하세요. 통계를 바로 초기화하는 대신 차이를 계산하면 이전 기록을 보존하면서 사용량과 작업 시간을 비교할 수 있습니다.

백그라운드 동기화, 미디어 미리 로드, 반복 요청으로 수치가 계속 증가할 수 있습니다. 같은 시간대에 여러 앱을 사용했다면 전체 사용량 차이만으로 특정 요청의 사용량을 단정할 수 없습니다. Data는 클라이언트의 집계 기준에 따른 값이며 시스템의 셀룰러 데이터 사용량이나 서비스 제공업체의 청구 내역과 같지 않습니다. 특정 접속에 어떤 정책이 적용됐는지 확인하려면 트래픽 수치로 추측하지 말고 규칙 일치 결과나 진단 기록을 살펴보세요.

06 설정 및 문제 해결

Settings 주요 항목

현재 설정과 값을 먼저 기록한 뒤 증상에 해당하는 항목을 변경하세요. 이름 해석 문제는 DNS, 테스트 결과가 일치하지 않는 문제는 Test Method, 자동 재연결 문제는 On Demand를 확인합니다. 여러 항목을 동시에 바꾸면 연결이 복구되더라도 어떤 설정이 원인이었는지 파악하기 어렵습니다.

DNS: 도메인 이름 확인

DNS는 도메인 이름을 확인하는 방식을 결정합니다. Settings에서 현재 설정을 살펴보고 활성화된 Config에 이름 확인 옵션이 지정되어 있는지도 확인하세요. 네트워크가 정상이라면 현재 값을 그대로 두면 됩니다. 변경해야 한다면 문제가 일반 도메인에서 발생하는지 로컬 네트워크 이름에서만 발생하는지 확인한 뒤 한 번에 한 항목만 바꾸고 같은 네트워크와 도메인으로 다시 테스트하세요. 기존 연결이나 캐시 때문에 결과가 바로 반영되지 않을 수 있으며, 이름 확인에 성공해도 이후 연결까지 보장되지는 않습니다.

Test Method: 연결 테스트 방법

Test Method는 연결 테스트 방식을 선택하는 항목입니다. Settings에서 사용 가능한 옵션을 확인한 뒤 Home으로 돌아가 같은 서버에서 Connectivity Test를 실행하세요. 여러 항목을 비교할 때는 테스트 방법, 대상, 네트워크 조건을 동일하게 유지합니다. 방법마다 측정하는 단계가 다르므로 결과 수치를 직접 비교하기는 어렵습니다. 지연 시간이 짧더라도 실제 접속을 대신할 수 없으며, 특히 전송 속도를 판단하는 근거로 삼아서는 안 됩니다.

Today Widget: 빠른 접근

이 기능을 지원하는 기기에서 Today Widget을 사용하면 시스템 위젯에서 상태를 확인하거나 화면에 제공되는 빠른 작업을 사용할 수 있습니다. 먼저 Settings에서 해당 항목을 확인한 다음 시스템 위젯 화면에서 추가하세요. 위젯 상태가 바로 갱신되지 않으면 Home을 열어 표시되는 연결 상태를 기준으로 확인합니다. 라우팅 모드를 바꾸거나 현재 구성을 확인하려면 클라이언트에서 직접 조작해야 합니다.

iCloud 동기화: 기기 간 구성 사용

iCloud를 지원하는 기기에서 같은 구성을 사용하려면 먼저 Settings에서 동기화 옵션과 실제 동기화 범위를 확인하고, 각 기기가 예상한 계정을 사용 중인지 확인하세요. 기능을 켜기 전에 중요한 구성의 사본을 보관하고, 알아보기 쉬운 구성을 선택해 다른 기기에 전달되는지 테스트합니다. 파일이 나타나더라도 동기화가 활성화됐다는 뜻은 아니며 연결 권한까지 이전되는 것도 아닙니다. 받는 기기에서도 현재 구성을 확인하고 연결을 별도로 테스트해야 합니다.

Diagnostics: 연결 실패 원인 확인

Settings에서 Diagnostics를 열고 구체적인 대상을 지정해 문제를 재현한 뒤 발생 시각, 네트워크 유형, 당시의 Global Routing을 기록하세요. 도구에 요청 기록이 표시된다면 확인 가능한 정보에 따라 도메인 이름 확인 실패, 규칙 경로 불일치, 서버 연결 실패를 구분합니다. 시간 초과 기록 하나만으로 서버 측 문제라고 단정할 수는 없습니다. 기록을 공유하기 전에 구독 주소, 계정 정보, 비공개 도메인, 불필요한 접속 내역을 삭제하세요.

Settings 자세히 알아보기 →

전체 플랫폼 다운로드 및 사용 안내

iPhone / iPad 버전은 App Store 제품 페이지에서 받을 수 있습니다. 미국 스토어 가격은 $2.99이며 한 번 결제하면 iPhone과 iPad에서 사용할 수 있습니다. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 확인하세요. Mac(Apple 실리콘 / Intel), Windows, Android, Linux 버전은 무료이며 설치 파일은 사이트의 /dl/에서 제공합니다. 스토어 항목을 확인할 때 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 확인하세요.

클라이언트의 일회성 구매는 연결 서비스 이용료와 별개입니다. 구성을 설정할 때는 이미 보유한 서버 정보나 구독을 사용하세요. 처음 설정할 때는 사용 안내를 따르고, 플랫폼별 설치 방법과 최초 실행 시 허용 절차를 확인하려면 전체 플랫폼 다운로드 페이지를 방문하세요.