Shadowrocket
기능 및 자주 쓰는 설정

Home / Global Routing

Global Routing: Config, Proxy, Direct

기능:Global Routing은 Shadowrocket에 들어오는 연결을 어떤 방식으로 처리할지 정합니다. Config는 현재 설정의 규칙에 따라 정책을 선택하는 모드입니다. Proxy는 선택한 프록시 서버를 통해 연결을 처리하는 모드입니다. Direct는 프록시 서버를 거치지 않고 연결하는 모드입니다. 모드, 서버 선택, 연결 스위치는 서로 다른 설정 단계입니다. 서버를 선택해도 연결이 자동으로 켜지는 것은 아니며, 연결을 켜도 모든 요청이 프록시를 사용하는 것은 아닙니다.

메뉴 위치:Home에서 Global Routing을 찾아 Config, Proxy, Direct 중 현재 선택된 항목을 확인하세요. 변경하기 전에 기존 모드와 선택된 서버를 기록해 두세요. 서버와 설정을 동시에 바꾸면 어떤 변경이 결과에 영향을 줬는지 파악하기 어렵습니다.

설정 방법:평소에는 Config를 선택하고 Config 페이지에서 원하는 설정이 선택되어 있는지 확인하세요. 일부 접속에 문제가 있다면 잠시 Proxy로 전환해 같은 대상에 선택한 서버로 접속해 보세요. 그런 다음 Direct로 바꿔 로컬 네트워크 결과와 비교하세요. 비교가 끝나면 평소 사용하는 모드로 되돌리세요. 테스트할 때는 요청을 새로 보내야 합니다. 이미 연결된 세션은 연결 당시의 경로를 계속 사용할 수 있습니다.

주의 사항:Proxy를 규칙을 수정하는 대신 장기간 사용하는 방법으로 삼지 마세요. Proxy는 정상인데 Config에서 문제가 생기면 매칭 결과, 정책 이름, DNS를 확인하세요. 두 모드 모두 문제가 있다면 서버 설정, 네트워크 환경, 서비스 제공업체의 상태 안내를 확인하세요.

Config / Rule

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

기능:각 규칙은 무엇을 매칭할지와 매칭된 뒤 어떻게 처리할지를 함께 지정합니다. DOMAIN은 지정된 도메인을, DOMAIN-SUFFIX는 도메인 접미사를, DOMAIN-KEYWORD는 도메인에 포함된 키워드를 매칭합니다. IP-CIDR과 IP-CIDR6은 IP 주소 대역을 기준으로 매칭하고, GEOIP는 IP 지리 데이터베이스를 기준으로 판단합니다. USER-AGENT는 요청에서 확인할 수 있는 관련 정보에 의존하므로 모든 연결에 적용되는 일반적인 조건으로 사용하기에는 적합하지 않습니다.

메뉴 위치:Config에서 현재 설정과 규칙을 확인하세요. 파일에 규칙이 있는지만 볼 것이 아니라 해당 파일이 실제로 사용 중인지, Global Routing이 Config로 설정되어 있는지, 대상 요청에 규칙 매칭에 필요한 정보가 포함되어 있는지도 확인해야 합니다.

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

위 내용은 문법 예시이며 현재 설정을 대체할 수 있는 완성된 파일이 아닙니다. PROXY, DIRECT, REJECT는 각각 프록시, 직접 연결, 차단을 의미합니다. 사용자 지정 정책 이름은 설정에 정의된 이름과 일치해야 합니다. FINAL은 앞선 조건에 매칭되지 않은 연결을 처리하며, 도메인 규칙으로 오해해서는 안 됩니다.

설정 방법:먼저 현재 설정을 백업한 뒤 규칙 편집 메뉴에서 구체적인 조건을 추가하세요. 규칙은 일반적으로 순서대로 매칭되므로 구체적인 예외를 범위가 넓은 규칙보다 앞에 배치하고, 최종 처리 규칙은 맨 뒤에 둡니다. 저장한 다음 수정한 설정이 활성화되어 있는지 확인하고, 알고 있는 대상으로 다시 테스트하세요. 로그나 연결 기록에서 실제 적용된 정책도 확인하세요.

주의 사항:하나의 대상은 여러 도메인과 주소를 사용할 수 있으므로 첫 페이지의 도메인만 수정해도 모든 요청에 적용되지 않을 수 있습니다. 주소 기반 규칙은 도메인 해석 결과의 영향을 받을 수도 있습니다. 페이지가 열리는지만으로 규칙이 적용됐다고 판단하지 말고 기록을 확인해 연결 경로를 파악하세요. 한 번에 설명하기 어려운 규칙을 많이 추가하지 마세요.

Home / Subscribe / Add Server

구독 및 서버 관리: 설정과 목록을 따로 관리하기

기능:Subscribe는 보유 중인 서버 목록을 가져오고 업데이트하는 기능이며, Add Server는 서버 하나를 직접 입력하는 기능입니다. 구독은 서버 항목을 제공할 뿐 Config의 전체 라우팅 정책을 대신하지 않습니다. 서버 목록을 업데이트해도 모든 라우팅 규칙이 자동으로 변경되는 것은 아닙니다.

메뉴 위치:Home의 추가 메뉴에서 원하는 유형을 선택하세요. 서버를 직접 입력하려면 Add Server를, 구독을 가져오려면 Subscribe를 선택합니다. 기존 정보는 Scan QR Code 또는 클립보드로 가져올 수도 있습니다. 인식 여부는 내용 형식과 현재 버전의 지원 여부에 따라 다릅니다.

설정 방법:구독 주소는 이용 중인 서비스 제공업체에서 확인하고, 복사할 때 전체 주소가 포함되었는지 확인하세요. 앞뒤 공백, 줄바꿈 또는 누락된 매개변수가 없는지도 살펴보세요. 서버를 직접 추가할 때는 먼저 해당 프로토콜을 선택한 다음 주소, 포트, 인증 정보, 전송 매개변수를 하나씩 확인하세요. Shadowsocks, VMess, VLESS, Trojan, WireGuard, Hysteria2는 입력 항목이 서로 다르므로 한 프로토콜의 설정 방법을 다른 프로토콜에 그대로 적용하지 마세요.

1. 각 구독에 용도를 알아보기 쉬운 이름을 붙이고 출처를 기록해 두세요.
2. 가져온 뒤 그룹과 서버 항목을 확인하고, 항목 하나를 선택해 Connectivity Test를 실행하세요.
3. 실제 접속을 테스트한 뒤 목록을 정리하거나 중복된 수동 항목을 삭제하세요.
4. 구독을 업데이트한 뒤 선택한 서버가 여전히 있는지, 설정에서 참조하는 이름이 유효한지 확인하세요.

주의 사항:구독을 업데이트하면 구독 항목을 직접 수정한 내용이 덮어써질 수 있습니다. 계속 보관할 사용자 지정 항목은 별도로 관리하세요. 구독 링크에 계정 정보가 포함될 수 있으므로 로그, 스크린샷, 백업에 전체 주소가 노출되지 않도록 주의하세요. 구독을 삭제하기 전에 백업을 복원할 수 있는지 확인하세요. 자세한 방법은 구독 및 서버 관리 가이드를 참고하세요.

Settings / On Demand

On Demand: 조건에 따라 연결 시작

기능:On Demand는 시스템에서 지원하는 네트워크 조건에 따라 연결 동작을 시작합니다. 연결을 시도할 시점을 정하는 기능이며 Global Routing의 트래픽 선택을 대신하거나 사용할 수 없는 서버를 복구하지는 않습니다. 규칙 기반 라우팅은 요청이 어디로 갈지를, On Demand는 연결이 언제 시작될지를 정합니다. 두 기능을 구분해서 이해하세요.

메뉴 위치:Settings에서 On Demand와 관련 규칙 메뉴를 찾으세요. 사용할 수 있는 조건은 기기 운영체제와 현재 화면에 따라 다를 수 있습니다. 활성화하기 전에 수동으로 구독, 서버, 설정을 확인해 기본 연결이 정상인지 확인하세요.

설정 방법:먼저 기존 설정을 보존한 뒤 현재 메뉴에서 제공하는 네트워크 조건을 선택하세요. 예를 들어 Wi-Fi 환경이나 네트워크 유형에 따라 연결 동작을 지정할 수 있습니다. 한 번에 조건 하나만 추가하고 해당 네트워크에 접속할 때, 네트워크를 벗어날 때, 모바일 네트워크로 전환할 때 각각 동작을 테스트하세요. 여러 조건을 동시에 켜 서로 덮어쓰게 하기보다 검증한 뒤 다른 조건을 추가하세요.

주의 사항:활성화한 뒤 연결을 수동으로 꺼도 다음에 조건이 충족되면 다시 연결이 시작될 수 있습니다. 연결을 껐는데 다시 켜지는 문제를 확인할 때는 먼저 On Demand를 살펴본 뒤 시스템의 네트워크 설정을 확인하세요. 네트워크 전환, 절전 모드에서 복귀, 시스템 권한도 테스트에 고려해야 합니다. 한 번 전환한 결과만으로 모든 상황을 확인했다고 단정하지 마세요.

Data

Data: 트래픽 확인과 서비스 요금은 별개

기능:Data에서는 클라이언트가 기록한 트래픽을 확인할 수 있습니다. 연결 후 데이터가 전송되는지, 테스트 전후 사용량이 어떻게 달라지는지 파악하는 데 도움이 됩니다. 집계 범위, 초기화 방법, 표시 항목은 화면에 안내된 내용을 확인하세요. 표시된 수치를 기기 전체 네트워크 사용량으로 간주해서는 안 됩니다.

메뉴 위치:Data를 열고 현재 어떤 통계 항목과 기간을 표시하는지 확인한 다음 업로드와 다운로드 데이터를 살펴보세요. 초기화 기능이 있다면 필요한 값을 먼저 기록해 초기화 후에도 비교할 수 있도록 하세요.

설정 방법:테스트 전에 현재 수치를 기록하고 관련 없는 백그라운드 전송을 일시 중지한 뒤, 알고 있는 대상에 접속하세요. 그런 다음 Data로 돌아와 변화를 비교합니다. 로그도 함께 확인한다면 테스트 시간대를 일치시키세요. 이를 통해 연결은 되었지만 실제 데이터 전송이 없는 경우와 데이터는 전송되지만 대상에서 오류가 반환되는 경우를 구분할 수 있습니다.

주의 사항:통계 시간, 프로토콜 오버헤드, 초기화 주기가 달라 클라이언트 통계와 서비스 제공업체의 요금 산정 기준이 다를 수 있습니다. Data에 트래픽이 표시되어도 모든 요청이 성공한 것은 아니며, 수치가 작다고 연결이 끊어진 것도 아닙니다. 트래픽 변화는 실제 접속 결과, 매칭 정책, 로그와 함께 판단하세요. 이 수치로 구독 잔여량을 추정하지 마세요.

Settings

Settings: DNS, 테스트 방식 및 동기화

DNS: 이름 해석과 연결을 구분하기

기능 및 메뉴 위치:DNS는 도메인 이름을 IP 주소로 변환합니다. 관련 옵션은 Settings 또는 현재 Config의 DNS 설정에서 확인할 수 있으며, 실제 적용 방식은 설정 내용에 따라 달라집니다. 서버에는 연결되지만 도메인 접속에 문제가 있다면 DNS를 점검할 수 있지만, 모든 접속 오류가 이름 해석 문제인 것은 아닙니다.

설정 방법 및 주의 사항:먼저 현재 설정을 기록하고 설정 파일에 이를 덮어쓰는 항목이 있는지 확인한 다음, 현재 설정 안내에 따라 변경하세요. 한 번에 DNS 옵션 하나만 변경하고 요청을 새로 보내 로그에 표시되는 해석 및 연결 결과를 확인하세요. DNS, Global Routing, 서버를 동시에 변경하지 마세요. 기존 연결이나 캐시된 결과가 테스트에 영향을 줄 수 있으므로 다시 연결한 뒤 비교해야 합니다.

Test Method: 무엇을 측정하는지 확인하기

기능 및 메뉴 위치:Test Method는 관련 테스트 설정에 있으며 클라이언트의 연결성 또는 지연 시간 확인 방법을 선택합니다. 테스트 방식마다 확인하는 단계가 다를 수 있으므로 결과를 볼 때 선택한 방식도 함께 확인하세요. 화면에 표시된 시간만 단순 비교해서는 안 됩니다.

설정 방법 및 주의 사항:Settings에서 Test Method를 확인하고 테스트 방식, 대상, 네트워크 환경을 동일하게 유지한 상태에서 서버 여러 개에 Connectivity Test를 실행하세요. 테스트에 응답이 있지만 실제 접속이 실패하면 프로토콜, TLS, SNI 등 해당하는 설정을 확인하세요. 한 가지 테스트 방식에서 모두 실패하더라도 모든 서버를 바로 삭제하지 말고 먼저 테스트 대상이 정상적으로 작동하는지 확인하세요.

Today Widget: 시스템에서 지원하는 빠른 메뉴

기능 및 메뉴 위치:Today Widget은 지원되는 시스템 화면에서 상태를 확인하거나 사용 가능한 작업을 실행하는 시스템 위젯 메뉴입니다. 먼저 Settings에서 관련 설정을 제공하는지 확인한 다음 시스템의 위젯 관리 화면에서 추가할 수 있는 항목을 살펴보세요.

설정 방법 및 주의 사항:시스템 안내에 따라 위젯을 추가한 뒤 클라이언트로 돌아와 서버와 연결 상태를 확인하고 빠른 작업을 테스트하세요. 위젯의 추가 가능 여부, 표시 내용, 새로 고침 시점은 시스템 버전에 따라 달라질 수 있습니다. 위젯 표시가 늦게 갱신되면 클라이언트와 시스템의 연결 상태를 기준으로 판단하고, 위젯 문구만으로 실시간 진단 결과라고 단정하지 마세요.

iCloud: 동기화 전에 복구 가능한 사본 보관하기

기능 및 메뉴 위치:iCloud 설정은 지원되는 데이터의 동기화에 사용됩니다. 먼저 시스템 계정 설정에서 iCloud를 사용할 수 있는지 확인한 다음 Shadowrocket의 동기화 옵션과 동기화 대상을 살펴보세요. 모든 로컬 데이터, 시스템 권한, 현재 연결 상태가 다른 기기에 동기화된다고 가정하지 마세요.

설정 방법 및 주의 사항:활성화하기 전에 보관할 설정을 내보내고 두 기기가 원하는 iCloud 계정을 사용 중인지 확인한 다음 동기화가 완료될 때까지 기다리세요. 복원 후 Subscribe, 서버 선택, Config, Global Routing을 하나씩 확인하고 연결을 시작하세요. 동기화는 별도의 백업을 대신하지 않습니다. 실수로 삭제하거나 잘못 수정한 내용도 동기화될 수 있습니다. 컴퓨터와 다른 운영체제 간에 데이터를 옮길 때는 각 플랫폼에서 실제로 지원하는 가져오기 및 내보내기 방법을 사용하세요.

Settings / Diagnostics

Diagnostics: 단계별로 연결 문제 확인하기

기능:Diagnostics는 진단 정보를 수집하거나 확인하는 기능으로 Connectivity Test, 연결 기록, 로그와 함께 문제를 파악하는 데 사용됩니다. 문제 해결에 필요한 근거를 제공하지만 연결을 자동으로 복구하지는 않습니다. 로컬 네트워크, 서버, 이름 해석, 규칙, 대상 서비스 순서로 점검하세요.

메뉴 위치:Settings에서 Diagnostics를 찾으세요. 로그와 도구의 위치는 현재 화면에 표시되는 내용을 확인하세요. 문제가 발생한 네트워크, 시간, 증상을 먼저 기록한 다음 필요한 기록 기능을 시작하세요. 일부 기록은 문제를 다시 재현하기 전에 켜야 하며, 문제가 발생한 뒤에 켜면 이전 연결 과정을 모두 확인할 수 없을 수 있습니다.

1. 로컬 네트워크 확인:기기가 사용할 수 있는 네트워크에 연결되어 있는지, 시스템 시간이 정확한지 확인하세요.
2. 서버 확인:현재 서버에서 Connectivity Test를 실행하고 주소, 포트, 인증 정보, 해당되는 TLS 설정을 확인하세요.
3. 라우팅 비교:선택한 서버를 그대로 둔 채 같은 대상으로 Config와 Proxy를 각각 사용해 비교하세요.
4. 문제 재현 및 기록:대상을 다시 열고 이름 해석, 매칭된 정책, 연결 실패가 어느 단계에서 발생하는지 확인하세요.
5. 설정 복원:임시 진단 기록을 끄고 평소 모드로 되돌린 뒤 검증된 변경 사항만 유지하세요.

주의 사항:진단 자료를 공유하기 전에 구독 주소, 서버 인증 정보, 접속 도메인, 개인 네트워크 정보가 포함되어 있는지 확인하고 공개할 필요가 없는 부분은 가리세요. 핸드셰이크 실패는 해당 프로토콜 설정과 시스템 시간을, 규칙이 맞지 않는 문제는 매칭 순서를 확인하세요. 모든 오류를 서버 시간 초과로 단정하지 마세요. 용어 설명은 용어집을 참고하세요.

기능 범위 및 다운로드 안내

클라이언트 설정과 서버 서비스는 별도로 확인하세요

Shadowrocket은 서버 가져오기, 프록시 연결, 규칙 기반 라우팅, 진단 등의 클라이언트 기능을 제공합니다. 기존 서버의 사용 가능 여부, 구독의 유효성, 서버 측에서 허용하는 전송 방식은 이용 중인 서비스 제공업체의 안내를 확인하세요. 클라이언트 일회성 구매 ≠ 서버 서비스 요금제. 이 사이트는 서버나 구독을 제공·판매·추천하지 않으며, 설정 변경으로 사용자가 보유한 서비스 이용 권한을 대체할 수도 없습니다.

다운로드는 두 가지 방식으로 제공됩니다. iPhone / iPad 버전은 App Store에서 $2.99에 한 번 결제하며, Mac / Windows / Android / Linux 버전은 무료입니다.Mac 버전은 Apple 실리콘 및 Intel용으로 제공됩니다. iPhone / iPad의 시스템 요구 사항은 App Store 페이지를 확인하세요. 개발자 Shadow Launch Technology Limited와 앱 ID 932747118이 일치하는지도 확인하세요. 다른 플랫폼의 설치 파일은 사이트의 /dl/shadowrocket/에서 제공됩니다.

클라이언트를 다운로드하거나 시스템 권한 허용 방법을 확인하려면 전체 플랫폼 다운로드 및 설치 안내를 참고하세요. 이미 연결할 수 있는 기기라면 현재 설정을 먼저 백업한 다음 이 페이지의 해당 항목을 참고해 기능을 조정하세요. 한 번에 하나씩 변경하고 확인해야 여러 설정을 동시에 바꿔 원인을 찾지 못하는 일을 방지할 수 있습니다.