기능 경로 및 설정 원리

Shadowrocket 주요 설정 및 모드 안내

이 페이지에서는 실제 작업 순서에 따라 Global Routing, 규칙, Subscribe, On Demand, Data 및 Settings를 설명합니다. 각 항목에서 “무엇인지, 어디에 있는지, 어떻게 설정하는지, 무엇을 주의해야 하는지”를 차례로 안내하므로 App Store 설치를 완료하고 기존 설정을 정리하려는 사용자에게 적합합니다.

사용 설명서 보기 정식 구매 및 설치 안내 보기

Apple 플랫폼 네이티브 클라이언트 App Store 정식 버전 일회성 구매 규칙은 순서대로 매칭

이 페이지의 모든 가져오기 절차는 사용자가 이미 보유한 구독 또는 서버 정보를 전제로 합니다. Shadowrocket을 구매하면 클라이언트 사용 권한을 얻는 것이며, 클라이언트 일회성 구매 ≠ 연결 서비스 요금제입니다. 앱 설치, 시스템 요구 사항 및 호환 기기 정보는 App Store 제품 페이지 표기를 기준으로 확인하세요.

01 / GLOBAL ROUTING

Global Routing의 세 가지 모드

Global Routing은 연결이 설정된 후 네트워크 요청을 규칙에 따라 처리할지, 모두 Proxy로 보낼지, 직접 연결할지를 결정합니다. 이는 전체 처리 모드이며 특정 규칙과 동일하지 않고 서버 선택을 대신하지도 않습니다. 평소 사용하기 전에 현재 선택한 서버가 작동하는지 확인한 뒤 목적에 맞는 모드를 선택하세요.

중국어 모드	화면 용어	처리 방식	적합한 상황	주요 주의사항
Config	`Config`	현재 Config의 규칙을 위에서 아래로 매칭한 다음 해당 정책으로 처리합니다.	도메인, 주소 또는 지역별로 PROXY, DIRECT, REJECT를 나누어 사용해야 할 때 적합합니다.	결과는 규칙 순서, 규칙 내용, 정책 이름 및 현재 Config가 적용되었는지에 따라 달라집니다.
Proxy	`Proxy`	요청을 현재 선택한 Proxy로 모두 보내므로 규칙 차이를 배제하고 확인하기 쉽습니다.	문제가 규칙에서 비롯되었는지 임시로 확인하거나 짧은 시간 동안 모든 요청을 동일하게 처리해야 할 때 사용합니다.	세부 규칙의 의도를 건너뛰므로 모든 설정 문제의 최종 해결 방법으로 사용하기에는 적합하지 않습니다.
Direct	`Direct`	요청을 Direct로 처리하며 선택한 Proxy를 거치지 않습니다.	로컬 네트워크가 정상인지 확인하거나 연결 차이를 임시로 검증할 때 사용합니다.	Direct는 정상인데 Config에서 문제가 발생한다면 일반적으로 규칙, DNS 및 서버 상태를 계속 점검해야 합니다.

무엇이며 어디에 있는가

Home에서 Global Routing을 열면 Config, Proxy, Direct 세 가지 모드를 확인할 수 있습니다. Config는 규칙 기반 처리 방식이고, Proxy는 현재 Proxy를 일괄 사용하며, Direct는 직접 연결합니다. 모드 전환은 현재 처리 방식만 바꾸며 Config 파일을 자동으로 수정하거나 다른 서버를 대신 선택하지 않습니다.

장기간 규칙에 따라 사용하려면 일반적으로 먼저 Config에서 설정을 확인한 뒤 Home으로 돌아가 Config를 선택합니다. Config에서 특정 웹사이트에 문제가 발생하면 Proxy와 Direct로 잠시 전환해 각각 확인할 수 있습니다. 세 결과의 차이를 통해 문제가 규칙, 서버 또는 로컬 네트워크 중 어디에 있는지 판단할 수 있습니다.

02 / RULES

규칙 유형, 매칭 순서 및 정책

규칙 분기의 핵심은 “위에서 아래로 확인하며, 처음 일치한 규칙에서 중지”하는 것입니다. 규칙 왼쪽에는 매칭 조건이, 끝에는 처리 방식을 나타내는 정책이 표시됩니다. 실제 규칙은 대개 현재 Config의 Rule 구간에 있으며, 사용할 때 키워드, 매칭 값, 정책 이름 및 배치 순서를 함께 확인해야 합니다.

주요 규칙 키워드

DOMAIN은 전체 도메인에 사용하고, DOMAIN-SUFFIX는 특정 도메인 접미사와 하위 도메인에 사용하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드로 매칭합니다. IP-CIDR과 IP-CIDR6은 주소 대역을 각각 처리하고, GEOIP는 주소의 지역 정보를 기준으로 판단하며, USER-AGENT는 요청의 식별자를 기준으로 매칭합니다. 유형마다 해결하는 문제가 다르므로 이름이 비슷하다는 이유만으로 서로 바꿔 사용하지 마세요.

도메인 규칙은 일반적으로 범위가 넓은 GEOIP 또는 FINAL보다 앞에 배치합니다. 구체적인 조건을 넓은 조건보다 우선해야 하며, 그렇지 않으면 앞의 광범위한 규칙이 먼저 매칭되어 뒤의 세부 규칙이 실행되지 않을 수 있습니다. 수정한 뒤에는 저장하고 방금 편집한 Config가 현재 활성화되어 있는지 확인하세요.

설정 방법 및 주의사항

PROXY, DIRECT, REJECT는 일반적인 정책입니다. PROXY는 요청을 지정된 정책 또는 현재 프록시 경로로 보내고, DIRECT는 직접 연결하며, REJECT는 요청을 거부합니다. 규칙 끝에 사용자 지정 정책 그룹 이름이 있다면 Config에 정의된 이름과 일치해야 합니다. 철자, 대소문자 또는 이름이 다르면 예상과 다른 결과가 발생할 수 있습니다.

FINAL은 기본 처리 규칙이므로 규칙 목록의 마지막에 배치해야 합니다. 앞의 모든 규칙과 일치하지 않은 요청을 처리합니다. 문제를 확인할 때는 먼저 대상 요청이 어느 규칙과 매칭되었는지 확인한 다음 해당 규칙의 정책을 살펴보세요. FINAL만 확인해서는 안 됩니다. 새 규칙을 추가한 뒤에는 명확한 도메인 몇 개로 검증하여 한 번에 너무 많은 내용을 변경하지 않도록 하세요.

03 / SUBSCRIBE

Subscribe 및 서버 관리

Subscribe는 사용자가 이미 보유한 구독 정보를 읽어 서버 목록을 업데이트하는 기능입니다. Add Server, Scan QR Code 및 Import from Cloud JSON은 서로 다른 출처에서 기존 정보를 추가할 때 사용합니다. 가져오기는 데이터를 클라이언트에 기록하는 작업일 뿐이며, 실제 사용 가능 여부는 정보 자체, 네트워크 상태 및 서버 설정에 따라 달라집니다.

추가 위치

Home에서 서버 목록으로 들어가면 Add Server를 사용해 직접 입력하거나, 기존 자료에 따라 Subscribe, Scan QR Code 또는 Import from Cloud JSON을 선택할 수 있습니다. 직접 추가할 때는 프로토콜 유형, 서버 주소, 포트, 인증 필드 및 추가 매개변수가 원본 자료와 일치해야 합니다. 일반적인 프로토콜 이름으로는 Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard 및 Hysteria2가 있습니다.

Subscribe를 사용할 때는 먼저 링크가 완전한지 확인한 다음 저장하고 업데이트를 실행하세요. 업데이트가 끝나면 목록에 예상한 변화가 있는지 확인하고 항목 하나를 선택해 Connectivity Test를 실행하세요. 테스트 결과는 현재 시점의 연결 상태를 참고하는 자료일 뿐 지속적인 사용 환경을 단독으로 나타내지는 않습니다.

업데이트 및 정리 방법

구독을 업데이트하면 서버 이름, 정렬 순서 또는 기존 항목이 바뀔 수 있습니다. 업데이트 전에 현재 선택된 항목을 기억해 두고, 업데이트 후 Home에서 다시 선택을 확인하세요. 목록에 변화가 없다면 링크가 완전한지, 현재 네트워크에서 해당 주소에 접근할 수 있는지, 구독이 아직 유효한지, 클라이언트에 명확한 오류가 표시되는지를 차례로 점검하세요.

여러 출처의 정보가 동시에 존재한다면 알아보기 쉬운 그룹과 메모를 사용하여 이름이 같은 항목을 잘못 선택하지 않도록 하세요. 오래된 항목을 삭제하기 전에는 해당 항목이 정책 그룹이나 Config에서 여전히 참조되는지 확인하세요. 서버 정보에는 민감한 필드가 포함될 수 있으므로 Diagnostics, 스크린샷 또는 설정 내용을 공유하기 전에 주소, 인증 정보 및 전체 구독 링크를 먼저 삭제하세요.

04 / ON DEMAND

On Demand 네트워크 조건에 따른 연결

On Demand는 미리 설정한 네트워크 조건에 따라 연결을 설정할지 결정합니다. 트리거 조건과 예외 조건을 명확히 알고 있을 때 사용하는 것이 적합합니다. 활성화하기 전에 수동 연결 테스트를 한 번 수행하여 일반 연결에서 서버, Global Routing, 규칙 및 DNS가 정상적으로 작동하는지 확인하세요.

설정 위치 및 활성화 순서

Settings에서 On Demand로 들어가 화면에 제공되는 네트워크 조건에 따라 규칙을 추가합니다. 사용할 수 있는 조건은 현재 앱 화면의 표시를 기준으로 확인하세요. 먼저 하나의 검증하기 쉬운 조건부터 시작하세요. 저장한 뒤 해당 네트워크로 한 번 전환하여 시스템 연결 상태를 확인하고, 이후 다른 조건을 단계적으로 추가합니다. 이렇게 하면 트리거 조건이 매칭되지 않은 것인지, 연결 후 네트워크 문제가 발생한 것인지 구분할 수 있습니다.

On Demand는 “언제 연결을 시도할지”를 결정하고, Global Routing은 “연결 후 요청을 어떻게 처리할지”를 결정하므로 역할이 다릅니다. Global Routing을 수정해도 On Demand 조건은 자동으로 바뀌지 않습니다. 반대로 On Demand가 정상적으로 트리거되었다고 해서 현재 규칙, DNS 및 서버가 반드시 정상이라는 뜻은 아닙니다.

05 / DATA

Data 트래픽 통계 확인 방법

Data는 Shadowrocket에 기록된 트래픽 정보를 확인하는 기능입니다. 어떤 연결에서 데이터가 발생했는지, 현재 세션이 계속 전송 중인지, 통계 주기별 변화가 어떤지 판단하는 데 활용할 수 있습니다. 이는 클라이언트 측 관찰 도구이며 서비스 청구서나 통신사 과금 기준으로 직접 사용해서는 안 됩니다.

통계 범위 및 확인 방법

앱에서 Data 통계 화면을 연 뒤 먼저 표시된 통계 범위와 시간 구간을 확인하고 업로드와 다운로드를 비교하세요. 연결 직후에도 데이터가 계속 변하지 않는다면 대상 앱에서 요청이 발생했는지, 시스템 연결이 유지되는지, 규칙이 요청을 예상한 정책으로 보냈는지를 함께 확인하세요. 트래픽이 증가했다는 사실만으로 대상 콘텐츠가 완전히 로드되었다고 볼 수는 없습니다.

특정 오류를 확인할 때는 먼저 시작 시각을 기록하고 문제를 한 번 재현한 뒤 Data와 Diagnostics를 대조하세요. 누적 숫자만 관찰하는 것보다 원인을 찾기 쉽습니다. 삭제 또는 초기화를 실행할 때는 먼저 보존해야 할 정보를 기록하세요. 구체적인 삭제 경로와 통계 기준은 현재 화면의 문구를 따릅니다.

06 / SETTINGS

Settings 주요 항목별 설명

Settings에는 DNS, Test Method, Today Widget, iCloud 및 Diagnostics 등의 항목이 모여 있습니다. 이러한 설정은 이름 해석, 테스트, 시스템 진입점, 동기화 및 문제 해결 방식에 영향을 줍니다. 변경하기 전에 현재 상태를 기록하고 한 번에 한 종류만 수정한 뒤 동일한 네트워크 조건에서 다시 테스트하세요.

DNS

무엇인가: DNS는 도메인 이름을 네트워크 주소로 변환합니다. 해석 결과는 이후의 도메인 규칙, 주소 규칙 및 연결 대상에 영향을 주므로 DNS 오류는 도메인이 열리지 않거나 일부 요청이 시간 초과되거나, 동일한 주소가 네트워크에 따라 다르게 작동하는 현상으로 나타날 수 있습니다.

어디에 있으며 어떻게 설정하는가: Settings에서 DNS 관련 항목으로 들어가고 현재 Config의 General 구간에 별도의 DNS 설정이 있는지도 확인하세요. 출처가 명확하고 설명 가능한 하나의 설정을 우선 사용하며 서로 충돌하는 여러 해석 설정을 동시에 적용하지 마세요. 변경 후에는 도메인 접근과 직접 주소 연결을 각각 테스트하세요.

주의사항: Direct에서는 접근되지만 Config에서 문제가 발생하거나 서버 테스트는 도달 가능하지만 도메인 접근에 실패한다면 DNS와 규칙의 관계를 중점적으로 확인하세요. Wi-Fi와 셀룰러 네트워크를 전환한 뒤 결과가 다르다면 각각의 해석 결과를 기록한 후 판단해야 합니다.

Test Method

무엇인가: Test Method는 Connectivity Test에서 연결 상태를 판단하는 방식을 결정합니다. 테스트 값은 특정 테스트 대상과 방법에서의 응답을 나타낼 뿐 앱 로딩, 동영상 전송 또는 장시간 연결의 전체 사용 환경과 같지는 않습니다.

어디에 있으며 어떻게 설정하는가: Settings에서 Test Method를 찾고 현재 화면에 제공되는 방법을 선택하세요. 여러 서버를 비교할 때는 동일한 Test Method, 동일한 네트워크 및 비슷한 시간대를 유지하여 테스트 조건의 차이를 서버 차이로 잘못 판단하지 않도록 하세요.

주의사항: 한 번의 시간 초과만으로 바로 결론을 내리지 마세요. 테스트를 반복하고 실제 접근, Data 및 Diagnostics를 함께 확인하세요. 모든 서버에서 동시에 문제가 발생한다면 서버 매개변수를 하나씩 수정하기보다 먼저 로컬 네트워크, DNS 및 구독 정보를 확인하세요.

Today Widget

무엇인가: Today Widget은 시스템 위젯 관련 진입점으로, 시스템에서 허용하는 영역에서 Shadowrocket이 제공하는 빠른 정보나 작업을 확인하는 데 사용합니다. 구체적으로 사용할 수 있는 내용은 시스템 및 앱 화면의 표시를 기준으로 합니다.

어디에 있으며 어떻게 설정하는가: 먼저 Settings에서 Today Widget 관련 옵션을 확인한 뒤 시스템의 위젯 편집 영역에서 Shadowrocket을 추가하세요. 추가 후 위젯이 현재 상태를 읽는지 확인하고, 탭했을 때 예상한 화면으로 이동하는지 테스트하세요.

주의사항: 위젯 표시에는 시스템의 새로 고침 주기가 영향을 줄 수 있으므로 짧은 시간 동안 업데이트되지 않았다는 이유만으로 연결이 끊겼다고 판단해서는 안 됩니다. 실시간 상태를 확인하려면 Shadowrocket의 Home, Data 또는 시스템 연결 상태로 돌아가 확인하세요.

iCloud

무엇인가: iCloud 관련 기능은 조건을 충족하는 Apple 기기 간에 앱 데이터를 저장하거나 동기화하는 데 사용됩니다. 마이그레이션과 복구에 적합하지만 동기화 결과는 기기의 로그인 상태, iCloud 사용 가능 여부 및 앱에서 현재 제공하는 동기화 범위에 따라 달라집니다.

어디에 있으며 어떻게 설정하는가: Settings에서 iCloud 옵션을 확인하고 기기에서 예상한 Apple 계정을 사용 중인지 확인하세요. 활성화하기 전에 중복 서버와 오래된 설정을 정리하세요. 다른 기기에서 동기화가 완료된 뒤 Config, 서버 이름 및 현재 선택 항목을 대조하고 양쪽이 완전히 일치한다고 바로 가정하지 마세요.

주의사항: 동기화 충돌이 발생하면 출처가 명확하고 더 최근에 저장된 데이터를 먼저 보존한 뒤 항목별로 대조하세요. 설정에는 서버 주소와 인증 필드가 포함될 수 있으므로 민감한 데이터로 관리하고 전체 동기화 내용을 공개 페이지에 그대로 표시하지 마세요.

Diagnostics

무엇인가: Diagnostics는 연결, 이름 해석 및 요청 처리 과정의 진단 정보를 수집합니다. 실패가 어느 계층에서 발생했는지 찾도록 돕는 기능이며 설정을 자동으로 수정해 주지는 않습니다.

어디에 있으며 어떻게 설정하는가: Settings에서 Diagnostics로 들어가 문제를 재현하기 전에 시간, 네트워크 유형, Global Routing 모드 및 현재 서버를 기록하세요. 그런 다음 대상 문제를 한 번만 재현하고 인접 시간대의 오류, DNS 결과 및 규칙 처리 정보를 확인하세요.

주의사항: 진단 내용을 공유하기 전에 전체 구독 주소, 서버 주소, 인증 필드, 기기 식별자 및 문제와 관련 없는 접근 기록을 삭제하세요. 진단 중에는 변경을 최소화하고 한 항목을 수정한 뒤 다시 재현해야 설정과 결과 사이의 관계를 파악할 수 있습니다.

07 / WORKFLOW

계층별로 설정하면 반복 전환보다 원인을 찾기 쉽습니다

권장 순서는 로컬 네트워크 확인, 서버 정보 점검, Global Routing 검증, 규칙 및 DNS 확인, 마지막으로 On Demand, Today Widget 및 iCloud 같은 보조 기능 활성화입니다. 각 단계를 완료할 때마다 명확한 테스트를 한 번 수행하세요.

01
기존 정보 준비

Subscribe 링크 또는 서버 필드가 완전하고 프로토콜 유형이 원본 자료와 일치하는지 확인하세요.
02
서버 확인

대상 서버를 선택하고 동일한 Test Method로 Connectivity Test를 실행하세요.
03
처리 모드 선택

먼저 Config로 테스트한 다음 Proxy와 Direct를 통해 규칙 문제와 로컬 네트워크 문제를 구분하세요.
04
규칙 및 DNS 확인

처음 매칭된 규칙을 찾고 정책, FINAL 위치 및 DNS 설정 출처를 확인하세요.
05
자동 기능 활성화

수동 연결이 안정된 후 On Demand를 설정하고 하나의 트리거 조건부터 검증하세요.
06
기록 및 재현

Data와 Diagnostics를 활용해 시간, 네트워크, 모드 및 실제 결과를 기록하세요.