Shadowrocket 기능 안내
라우팅, 연결 및 진단 설정

규칙은 ‘무엇과 일치하는지’와 ‘일치한 뒤 어떻게 처리하는지’로 구성됩니다. DOMAIN은 전체 도메인과 정확히 일치하고, DOMAIN-SUFFIX는 지정 도메인과 하위 도메인에 일치합니다. DOMAIN-KEYWORD는 도메인에 포함된 키워드를 기준으로 일치하며, IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 범위에 일치합니다. GEOIP는 주소의 지역 정보를 데이터베이스와 대조합니다. 규칙 유형마다 판단에 사용하는 정보가 다르므로 도메인 규칙을 주소 규칙 대신 사용할 수는 없습니다.

PROXY, DIRECT, REJECT는 규칙 유형이 아니라 정책입니다. 각각 프록시 처리, 직접 연결, 연결 거부를 뜻합니다. 규칙은 일반적으로 위에서 아래 순서로 확인하며, 처음 일치한 규칙이 적용됩니다. 따라서 구체적인 규칙을 포괄적인 규칙보다 위에 배치해야 합니다. 앞선 규칙에 일치하지 않는 트래픽은 FINAL로 처리하므로 규칙의 맨 아래에 둡니다.

[Rule]
DOMAIN-SUFFIX,ads.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

예시에서는 ads.example.com이 REJECT에 먼저 일치하므로 아래쪽의 example.com 범위에 포함되지 않습니다. 해당 도메인 범위의 나머지 트래픽은 PROXY로 처리하고, 지정된 사설 주소 범위는 DIRECT로 연결하며, 나머지는 FINAL,DIRECT로 처리합니다. 이 예시는 문법 설명용이며, 해당 도메인에서 실제 연결 서비스를 이용할 수 있다는 뜻이 아니고 완전한 설정 파일을 대신하지도 않습니다.

수정할 때는 판단 조건을 하나만 바꾸세요

먼저 기존 설정을 보존하고 Config에서 복사본의 [Rule] 구간을 편집하세요. 저장한 뒤 해당 파일이 선택되었는지 확인하고 Home으로 돌아가 Config 모드에서 테스트합니다. 규칙을 수정한 뒤에는 대상을 다시 요청해 이전 연결 결과와 새 규칙의 결과를 혼동하지 않도록 하세요. 실제 적용된 정책이 예상과 다르면 요청 기록에서 앱이 사용한 실제 도메인과 대상 주소를 확인합니다. 한 페이지가 여러 도메인에 요청할 수 있으므로 주소창에 표시된 도메인에 규칙 하나를 추가했다고 모든 요청이 같은 정책을 따르는 것은 아닙니다.

On Demand는 설정한 조건에 따라 시스템에 연결을 요청하므로 특정 네트워크 환경에서 자동 연결이 필요할 때 유용합니다. 규칙 라우팅과는 역할이 다릅니다. On Demand는 연결을 시작할 조건을 처리하고, Global Routing과 Config는 연결 후 트래픽 처리 방식을 결정합니다. On Demand를 켜도 구독 정보가 추가되거나 사용 가능한 서버가 선택되거나 규칙 오류가 수정되지는 않습니다.

처음 설정하기 전에 자동 실행을 끄고 서버 선택, VPN 구성 승인, 접속 확인을 수동으로 완료하세요. 기본 연결이 정상인지 확인한 다음 Settings의 On Demand로 이동해 화면에 실제로 표시되는 네트워크 조건에 따라 설정합니다. 사용할 수 있는 옵션은 기기와 앱 상태에 따라 달라질 수 있으므로 현재 화면에서 하나씩 확인하세요. 다른 기기의 절차를 그대로 적용하지 마세요.

설정 후에는 자동 연결이 필요한 네트워크와 필요하지 않은 네트워크에서 각각 확인해 예상대로 연결되는지 살펴본 다음 대상 접속도 테스트합니다. 수동으로 연결을 끊은 뒤 다시 자동 연결되면 먼저 On Demand 조건과 시스템의 관련 VPN 설정을 확인하세요. 네트워크를 바꾼 뒤 연결이 실패하면 새 네트워크에서 서버를 수동으로 테스트하고, 트리거 조건을 바로 더 추가하지 마세요.

자동 연결이 서버의 상시 사용 가능성을 보장하지는 않습니다. 네트워크 변경, 인증 만료, 구독 정보 변경 등이 결과에 영향을 줄 수 있습니다. 문제 해결 중에는 자동 재연결이 비교 테스트를 방해하지 않도록 On Demand를 잠시 끄고, 테스트가 끝난 뒤 필요한 조건을 복구하세요.

Settings의 옵션을 한 번에 모두 바꿀 필요는 없습니다. 먼저 기본 동작을 유지해 정상적으로 연결되는 기준 상태를 만든 뒤, 확인된 문제에 따라 조정하세요. 일부 기능은 현재 Config, 시스템 권한, 기기 환경의 영향을 받습니다. 옵션이 보이지 않으면 앱 화면을 먼저 확인하고, 다른 기기의 메뉴 위치를 고정된 경로처럼 여기지 마세요.

DNS: 도메인 조회와 규칙 판단의 기반

DNS는 도메인을 주소로 변환하며, 관련 동작은 Settings와 현재 설정 파일의 [General] 구간에 있는 값 모두의 영향을 받을 수 있습니다. 문제를 확인할 때는 실제 적용 중인 설정의 DNS 매개변수를 먼저 살펴보고, 네트워크에서 지정된 DNS 서비스에 접속할 수 있는지도 확인하세요. 여러 곳의 값을 한데 합친 뒤 한 곳만 수정하면 어떤 설정이 결과를 바꿨는지 파악하기 어렵습니다.

일부 도메인만 실패한다면 다른 도메인과 네트워크별 결과를 비교한 다음 DNS 결과와 규칙 일치 여부를 확인하세요. 한 번에 한 항목만 바꾸고 연결을 다시 설정한 뒤 새 요청을 보냅니다. 주소 하나에 접속할 수 있다고 도메인 조회가 전반적으로 정상인 것은 아닙니다. DNS를 무작정 바꿔도 인증 문제나 서버 접속 불가가 해결되지는 않습니다.

Test Method: Connectivity Test의 테스트 범위 이해하기

Test Method는 Connectivity Test에서 사용할 테스트 방식을 정합니다. Settings에서 해당 항목을 찾아 현재 선택할 수 있는 방식을 확인한 뒤 동일한 방법으로 항목을 비교하세요. 화면에서 테스트 대상을 설정할 수 있다면 접속 가능 여부가 확인된 대상 중 테스트 요구사항에 맞는 것을 사용하고, 비교하는 동안 조건을 동일하게 유지합니다.

테스트 방식에 따라 측정 단계가 다르므로 결과를 단순 비교해서는 안 됩니다. 테스트 성공이 모든 웹사이트에 접속할 수 있다는 뜻은 아니며, 시간 초과는 테스트 대상이나 현재 네트워크 때문일 수도 있습니다. 먼저 방식과 대상을 확인한 다음 서버 주소, 포트, 인증 정보를 점검하세요. 한 번의 테스트 결과만 보고 항목을 반복해서 바꾸지 마세요.

Today Widget: 빠른 작업 및 상태 확인

Today Widget은 시스템에서 지원하는 위젯 기능을 위한 설정입니다. 먼저 앱에서 관련 옵션을 확인한 다음 시스템에서 제공하는 편집 메뉴를 통해 추가하세요. 사용 가능한 위치와 조작 방법은 시스템 지원 여부에 따라 달라질 수 있으므로 기기에 실제로 표시되는 내용을 기준으로 확인하세요. 시스템 요구 사항은 App Store 페이지를 따릅니다.

최초 설정, 서버 수정, 규칙 확인은 앱에서 진행해야 합니다. 위젯의 상태는 빠른 확인에 유용하지만 표시가 바로 갱신되지 않거나 연결 결과가 예상과 다르면 Home을 열어 현재 서버와 스위치를 확인하세요. 빠른 작업을 연속해서 누르지 마세요.

iCloud 동기화: 기기 간 사용 전 동기화 범위 확인

iCloud 기능은 지원되는 범위에서 앱 정보를 동기화하는 데 사용됩니다. Settings에서 동기화 스위치를 확인하고 시스템 설정에서 관련 iCloud 권한과 사용 가능한 저장 공간을 살펴보세요. 동기화 대상은 앱 화면의 설명을 기준으로 확인해야 합니다. 앱 구매 내역, 서버 정보, 연결 상태, 과거 통계를 모두 같은 종류의 동기화 데이터로 간주해서는 안 됩니다.

처음 활성화하기 전에 중요한 설정을 보관하세요. 다른 기기에서 정보가 모두 도착했는지 하나씩 확인한 뒤 로컬 설정을 변경합니다. 클라우드에 정보가 표시되더라도 시스템 VPN 승인이 완료된 것은 아니므로 대상 기기에서 별도로 확인해야 합니다. 서버와 구독에 인증 정보가 포함될 수 있으므로 동기화 전에 사용 계정과 기기를 본인이 안전하게 관리하고 있는지 확인하세요.

Diagnostics: 실패 한 건을 재현해 단서 수집

Diagnostics에서는 문제 해결에 필요한 진단 정보를 확인하거나 생성할 수 있습니다. 문제가 발생하면 Settings에서 해당 메뉴를 열고 화면에 안내된 방법으로 재현 과정을 한 번 기록하세요. 먼저 네트워크 환경, Global Routing 모드, 선택한 서버, 대상을 기록한 뒤 한 번 작업하면 여러 설정을 바꾼 후의 기록보다 원인을 파악하기 쉽습니다.

연결 설정 실패, 도메인 조회 실패, 대상 요청 실패를 구분하세요. 기록을 공유하기 전에 구독 주소, 서버 인증 정보, 개인 요청 내용을 숨기고 문제 파악에 필요한 부분만 남깁니다. Diagnostics는 보조 자료일 뿐 올바른 서버 정보를 대신하지 않으며, 한 줄의 알림만으로 전체 원인을 단정할 수 없습니다.