Shadowrocket 설정 및 기능 안내

02 / RULE MATCHING

규칙 유형, 순서 및 정책

개요: 규칙은 매칭 조건과 처리 정책을 연결합니다. DOMAIN은 지정된 도메인과 일치하고, DOMAIN-SUFFIX는 도메인 접미사 및 관련 하위 도메인과 일치하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드로 매칭합니다. IP-CIDR 및 IP-CIDR6은 주소 대역을 대상으로 하고, GEOIP는 주소의 지역 정보 데이터에 따라 판정합니다. USER-AGENT는 요청에서 해당 정보를 확인할 수 있어야 하므로 모든 연결에 이 조건이 있다고 가정할 수 없습니다.

위치: Config에서 현재 활성화된 구성을 확인한 다음 그 안의 규칙을 살펴보세요. Home에서 서버를 선택하는 것과 구성 파일을 바꾸는 것은 별개입니다. 활성화되지 않은 파일을 편집해도 현재 요청의 판정은 달라지지 않습니다. 점검을 시작하기 전에 파일과 Global Routing이 예상한 상태인지 확인하세요.

조건을 먼저 읽고 정책을 확인하세요

PROXY는 프록시 정책으로 처리하고, DIRECT는 대상에 직접 연결하며, REJECT는 일치하는 요청을 거부합니다. 규칙이 구성에 정의된 정책 그룹을 가리킬 수도 있습니다. 이 경우 그룹에서 실제로 어떤 항목이 선택됐는지도 확인해야 합니다. 정책 이름은 연결 성공을 보장하지 않습니다. PROXY 규칙에 일치해도 서버 연결에 실패하면 요청이 완료되지 않을 수 있습니다.

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

위 내용은 설명용 예시이며, 전체 설정을 대체할 수 있는 완성된 구성이 아닙니다. 첫 번째 도메인 규칙은 example.com과 그 하위 도메인에 적용되고, GEOIP 규칙은 해당 주소의 지역 정보를 기준으로 판정하며, FINAL은 앞선 규칙에 일치하지 않은 요청에 기본 정책을 적용합니다. example.com은 문법 설명을 위한 예시일 뿐, 실제로 변경해야 할 대상이 아닙니다.

설정 방법: 먼저 구성의 사본을 보관한 뒤, 더 구체적인 예외 조건을 범위가 넓은 조건보다 앞에 배치하고 마지막으로 FINAL을 확인하세요. 목적이 분명한 규칙을 한 번에 하나씩 추가하고, 저장 후 구성이 활성화됐는지 확인한 다음 해당 대상으로 테스트하세요. 구성에 같은 유형의 규칙이 이미 있다면 중복되거나 먼저 일치하는 항목부터 찾으세요. 규칙을 계속 맨 아래에 덧붙이지 마세요.

유의 사항: 규칙은 일반적으로 순서대로 판정되므로 앞쪽 규칙이 일치하면 뒤쪽 규칙은 적용되지 않을 수 있습니다. 주소 기반 규칙은 도메인 해석과 관련될 수 있으며, 해석 결과와 데이터베이스 내용도 판정에 영향을 줍니다. REJECT는 요청을 거부하는 기능이지 페이지 내용을 편집하는 기능이 아닙니다. 로그인, 리소스 또는 API 도메인을 잘못 차단하면 페이지가 비거나 이미지가 표시되지 않거나 기능이 작동하지 않을 수 있습니다.

문제를 더 자세히 살펴볼 때는 '규칙이 일치하지 않음', '잘못된 정책과 일치함', '정책은 맞지만 연결에 실패함'을 각각 구분하세요. 원인에 따라 확인할 설정이 다르므로 도메인 규칙을 추가하는 것만으로 모두 해결할 수는 없습니다. 증상별로 요청 경로를 점검하려면 문제 해결 가이드를 참고하세요.

04 / ON DEMAND

On Demand 연결 설정

개요: On Demand는 설정된 조건에 따라 시스템이 연결을 시작하도록 하는 기능으로, '언제 연결할지'를 정합니다. Global Routing과 규칙은 '요청을 어떻게 처리할지'를 정합니다. On Demand를 켜도 라우팅 규칙이 자동으로 만들어지거나 서버 설정값이 수정되지는 않습니다. 먼저 수동 연결이 정상적으로 작동하는지 확인한 다음 설정하세요.

위치: Settings에서 On Demand를 찾아 이 기기에 표시되는 네트워크 조건과 각 조건에 따른 동작을 확인하세요. 설정 중 시스템 VPN 구성에 대한 승인이 필요할 수 있습니다. 시스템 팝업은 구성 적용을 확인하는 절차일 뿐, 서버 연결이 정상이라고 확인해 주는 것은 아닙니다. 다른 시스템 VPN 구성이 이미 있다면 현재 활성화된 구성이 예상한 것인지도 확인하세요.

단일 트리거 조건부터 설정하기

1. 먼저 On Demand 트리거를 잠시 비활성화하고 수동으로 연결한 다음 현재 서버와 Config가 예상대로 작동하는지 확인하세요.
2. On Demand의 기존 설정을 기록한 뒤 네트워크 조건과 동작을 하나씩만 변경하세요. Wi-Fi 조건을 사용하는 경우 네트워크 이름을 꼼꼼히 확인하세요.
3. 가능하다면 Wi-Fi와 셀룰러 네트워크를 전환해 트리거 결과를 확인한 다음 요청이 기존 규칙에 따라 처리되는지 살펴보세요.
4. 테스트가 끝나면 실제로 적용되는 조건을 기록하세요. 여러 조건이 서로 덮어쓰면 동작 원인을 파악하기 어려워질 수 있습니다.

유의 사항: 수동으로 연결을 끊은 뒤 다시 연결되는 것은 On Demand 조건이 시스템에서 다시 충족됐기 때문일 수 있으며, 스위치가 고장 난 것은 아닐 수 있습니다. 자동 트리거를 끄려면 Home 스위치만 반복해서 누르지 말고 On Demand 설정에서 관련 조건을 확인하세요. 웹 인증이 필요한 Wi-Fi라면 네트워크 인증을 먼저 완료한 후 연결 문제를 살펴보세요. 기기 상태, 시스템 정책, 네트워크 변화가 트리거 시점에 영향을 줄 수 있습니다. On Demand를 앱마다 독립적으로 작동하는 프록시 스위치로 보아서는 안 됩니다.

06 / SETTINGS

Settings에서 자주 쓰는 설정

Settings에서는 일부 앱 설정을 관리할 수 있지만 모든 구성의 유일한 출처는 아닙니다. DNS 등의 설정은 현재 Config에 정의되어 있을 수도 있으므로 활성 구성과 관련 화면을 함께 확인하세요. 아래 안내는 기기에 실제로 표시되는 메뉴를 기준으로 합니다. 없는 옵션을 이름이 비슷한 항목으로 대신하거나 구성에 필드를 추측해 입력하지 마세요.

DNS: 이름 해석과 라우팅을 따로 확인하기

개요 및 위치: DNS는 도메인을 주소로 변환합니다. Settings의 관련 메뉴와 현재 Config에서 DNS 설정을 함께 확인하세요. 도메인이 해석됐다고 프록시 연결까지 성공한 것은 아니며, 해석에 실패했다고 반드시 서버 인증에 문제가 있는 것도 아닙니다. 도메인 규칙과 주소 규칙은 서로 다른 정보를 사용하므로 DNS 설정을 바꾸면 규칙 판정에도 영향을 줄 수 있습니다.

설정 방법: 먼저 기존 설정을 기록하고 모든 도메인에서 문제가 발생하는지 일부 도메인에서만 발생하는지 확인한 다음, DNS 설정과 접근 가능 여부를 점검하세요. 한 번에 한 항목만 바꾸고 저장한 뒤 같은 대상으로 다시 테스트하세요. 필요하다면 새 연결을 시작해 기존 연결이 결과에 영향을 주지 않도록 하세요. 유의 사항: 출처가 불분명한 DNS 설정을 여러 개 중복 적용하지 마세요. 특정 DNS 서비스를 모든 문제의 해결책으로 여겨서도 안 됩니다.

Test Method: 테스트 결과의 의미

개요 및 위치: Settings에서 Test Method를 찾아보세요. 이 설정은 연결 테스트 방식을 정하며, 설정 후 Home으로 돌아가 Connectivity Test를 실행할 수 있습니다. 테스트 방식에 따라 확인하는 네트워크 구간이 다를 수 있습니다. 특정 탐색 방식에서 응답이 없더라도 실제 서비스 요청이 모두 실패한다고 단정할 수는 없습니다.

설정 방법: 서버를 비교할 때는 Test Method, 네트워크를 동일하게 유지하고 가능한 한 비슷한 시간에 테스트한 뒤 실제 대상으로도 확인하세요. 유의 사항: 테스트 수치는 실제 전송 속도를 보장하지 않으며, 테스트 값이 가장 낮다고 모든 웹사이트에서 가장 빠른 것도 아닙니다. 테스트 방식을 바꾸면 측정 방식만 달라질 뿐 서버의 포트, 비밀번호 또는 전송 설정이 수정되지는 않습니다.

Today Widget: 빠른 실행 및 연결 상태

개요 및 위치: Today Widget은 빠른 실행과 관련된 설정입니다. 추가 가능 여부와 표시 방식은 기기의 시스템 지원에 따라 달라집니다. Settings에서 관련 옵션을 확인한 뒤 시스템에서 제공하는 위젯 관리 메뉴를 이용하세요. 위젯은 Home에서 전체 설정을 점검하는 과정을 대신할 수 없습니다.

설정 방법: 위젯을 추가한 뒤 앱으로 돌아와 현재 서버와 Global Routing을 확인하고 빠른 실행이 예상한 연결을 수행하는지 테스트하세요. 유의 사항: 위젯 표시가 갱신되기까지 시간이 걸릴 수 있습니다. 표시된 상태와 실제 상태가 다르면 앱 내부의 상태와 실제 요청을 기준으로 판단하세요. 관련 옵션이 보이지 않더라도 같은 모양을 만들기 위해 무관한 네트워크 설정을 바꾸지 마세요.

iCloud: 동기화와 복원은 별도로 확인하기

개요 및 위치: iCloud 관련 옵션은 앱이 지원하는 데이터 동기화 또는 백업에 사용됩니다. Settings의 관련 메뉴와 시스템 iCloud 설정에서 확인할 수 있습니다. 앱 구매 기록은 App Store 계정에 속하므로 구성 데이터가 동기화됐다는 뜻은 아닙니다. 두 항목을 별도로 확인해야 합니다.

설정 방법: 먼저 기기에 로그인된 iCloud 계정, 시스템 권한, 사용 가능한 저장 공간을 확인한 뒤 앱에 표시되는 동기화 범위를 살펴보세요. 기기를 옮기기 전에 로컬 사본을 보관하고 새 기기에서 서버, Config, 선택 상태를 하나씩 확인하세요. 유의 사항: 모든 데이터가 자동으로 덮어써지거나 즉시 동기화된다고 가정하지 마세요. 구독 및 인증 정보는 민감한 정보이므로 동기화 파일에도 접근을 제한해야 합니다.