Global Routing에서 Config를 선택하면 먼저 일치하는 규칙이 해당 연결에 적용됩니다. 규칙을 처음 편집하거나 새로 추가한 규칙이 적용되지 않는 경우에 유용합니다. 도메인·주소·기본 규칙의 차이를 이해하고, 요청이 어떤 행에 일치하는지 판단한 뒤 변경 결과를 확인할 수 있습니다.
규칙 순서: 첫 번째 일치 규칙부터 FINAL까지
규칙 파일에서의 위치를 먼저 확인하고, 규칙의 구체성은 그다음에 살펴보세요. Shadowrocket은 현재 설정의 순서대로 규칙을 확인하며, 일치하는 행을 찾으면 해당 행의 정책을 적용합니다. DOMAIN을 사용했다고 해서 규칙이 DOMAIN-SUFFIX보다 자동으로 앞에 배치되지는 않습니다. 특정 호스트에 예외를 적용하려면 해당 호스트를 포괄하는 넓은 범위의 규칙보다 앞에 예외 규칙을 두세요.
PROXY: 연결을 프록시 출구로 전달합니다. 선택한 프록시 서버를 사용할 수 있어야 규칙에 일치한 뒤 프록시 연결을 설정할 수 있습니다.DIRECT: 기기의 현재 네트워크를 통해 연결을 직접 전송합니다.DIRECT규칙에 일치해도 대상 주소에 반드시 접속할 수 있는 것은 아닙니다.REJECT: 일치하는 연결을 거부합니다. 앱에는 연결 실패만 표시되고, 원인이 된 규칙 행은 표시되지 않을 수 있습니다.FINAL: 앞선 규칙에 일치하지 않은 연결을 처리합니다.FINAL,DIRECT또는FINAL,PROXY형식으로 작성하며 도메인이나 주소는 입력하지 않습니다.[Rule]의 마지막에 배치하세요.
규칙은 연결마다 정책을 선택하며 앱 전체에 고정된 태그를 지정하지 않습니다. 한 페이지를 불러오는 동안에도 페이지 호스트, 정적 리소스 호스트, 로그인 호스트에 각각 연결할 수 있으며, 각 연결에는 서로 다른 규칙이 적용될 수 있습니다. 문제를 확인할 때는 주소 표시줄의 호스트만 보는 대신 실패한 요청에 해당하는 호스트명을 찾아보세요.
도메인 규칙: 전체 호스트명, 도메인 접미사, 키워드
도메인 규칙의 매칭 값에는 호스트명이나 키워드만 입력합니다. 예를 들어 https://www.example.com:443/docs의 호스트명은 www.example.com입니다. https://, 포트 443, 경로 /docs는 규칙 값에 넣지 않습니다. 아래 결과는 연결에서 대상 호스트명을 확인할 수 있는 경우를 전제로 합니다.
| 규칙 및 매칭 값 | 일치하는 예 | 일치하지 않는 예 |
|---|---|---|
DOMAIN,example.com | example.com | www.example.com |
DOMAIN-SUFFIX,example.com | example.com、www.example.com | notexample.com、example.com.example.net |
DOMAIN-KEYWORD,example | example.net、notexample.com | www.test.invalid |
호스트 하나만 조정하려면 DOMAIN을 사용하고, 루트 도메인과 모든 하위 도메인에 적용하려면 DOMAIN-SUFFIX를 사용하세요. 접미사 매칭은 도메인 레이블 경계를 확인하므로 문자열이 단순히 example.com으로 끝나는지만 판단하지 않습니다. DOMAIN-KEYWORD는 호스트명에 포함된 문자열을 찾으며 레이블 전체가 일치할 필요는 없습니다. 특정 도메인 하나만 대상으로 할 때 키워드를 쓰면 다른 도메인까지 함께 매칭될 수 있습니다.
주소 규칙: IP-CIDR 대역 및 GEOIP 지역
IP-CIDR은 대상 IPv4 주소가 지정한 네트워크 대역에 포함되는지 확인합니다. GEOIP는 대상 IP가 지리 IP 데이터베이스에서 어느 지역으로 분류되는지 확인합니다. 지역 코드는 도메인 접미사, 웹사이트 등록 국가 또는 기기 위치를 뜻하지 않습니다.
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve에서/24는 앞의 24비트가 고정됨을 뜻합니다.192.0.2.7은 일치하고192.0.3.7은 일치하지 않습니다. IPv4 주소192.0.2.7하나만 매칭하려면192.0.2.7/32로 작성할 수 있습니다. 여기에 사용한 주소 대역은 문서 예시용으로 예약된 범위이며, 공용 인터넷 연결 테스트에는 사용할 수 없습니다.GEOIP,CN,DIRECT는 대상 IP가 주소 데이터베이스에서CN으로 분류될 때 직접 연결하라는 뜻입니다. 도메인이.cn으로 끝나더라도 규칙에 일치한다고 단정할 수 없으며, 방문자의 위치만으로 결과를 판단할 수도 없습니다. 같은 도메인도 네트워크에 따라 서로 다른 IP로 해석될 수 있어 지역 매칭 결과가 달라질 수 있습니다.no-resolve는 이 규칙을 위해 도메인을 IP로 능동적으로 해석하지 않는다는 뜻입니다. 이때 매칭에 사용할 대상 IP가 이미 있다면 네트워크 대역을 기준으로 판단할 수 있습니다. 설정 전체의 DNS를 끄거나 이후 규칙이 해석 결과를 사용하지 못하게 하는 옵션은 아닙니다.
특정 호스트에 항상 같은 정책을 적용하려면 해당 호스트가 한 번 해석된 IP로 도메인 규칙을 대체하지 마세요. 명확한 도메인 규칙을 주소 규칙보다 앞에 두면 호스트명을 확인할 수 있을 때 주소 규칙을 기다리지 않고 예외를 먼저 처리할 수 있습니다.
예시 규칙: 특정 호스트 예외를 먼저 매칭하기
아래 예시는 규칙 순서를 읽고 확인하기 위한 것으로, 완전한 설정 파일이 아닙니다. 지정한 호스트를 먼저 거부하고, 같은 도메인의 나머지 요청은 프록시로 전달한 다음 키워드와 IP 조건을 처리합니다. 기존 설정에 적용할 때는 필요한 규칙만 기존 [Rule] 섹션에 넣고, 끝에 FINAL 하나를 유지하세요.
[Rule]
DOMAIN,api.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,DIRECT
api.example.com은 앞의 세 도메인 조건을 모두 만족하지만 첫 번째 행이 먼저 적용되어 결과는REJECT입니다. 접미사 규칙을 첫 번째 행으로 옮기면 결과는PROXY로 바뀝니다.www.example.com은 첫 번째 행에 일치하지 않고 두 번째 행의 접미사 규칙에 일치하므로 결과는PROXY입니다. 대상 IP가CN으로 분류되더라도 이미 적용된 정책을 뒤의GEOIP규칙이 덮어쓰지 않습니다.example.net은 앞의 두 도메인 조건에 일치하지 않으므로 세 번째 행의 키워드 규칙에 일치해DIRECT로 연결됩니다. 키워드 규칙을 접미사 규칙보다 앞에 잘못 배치하면www.example.com도 먼저DIRECT로 연결됩니다.- 목적지 주소를
192.0.2.7로 직접 지정하면 네 번째 행에 일치할 수 있습니다. 앞의 다섯 행에 일치하지 않는 연결은FINAL,DIRECT로 처리됩니다. 이 행들은 모두DIRECT를 적용할 수 있으므로 정책 이름만으로는 어떤 행에 일치했는지 구분할 수 없습니다.
규칙 적용 및 결과 확인
테스트에 사용할 설정과 라우팅 방식을 먼저 확인한 다음 새 연결을 시도하세요. 아래 경로는 iPhone / iPad 인터페이스를 기준으로 설명합니다. 규칙을 저장했다고 테스트가 끝난 것은 아닙니다. 현재 선택된 설정, 재사용 중인 연결, 프록시 서버 상태가 관찰 결과에 영향을 줄 수 있습니다.
설정 확인
하단의
Config를 열어 현재 선택된 설정 파일을 확인합니다. 편집 전에는 복구할 수 있는 사본을 보관해 한 번의 테스트로 기존 규칙 여러 개를 변경하는 일을 피하세요.변경 사항 저장
확인할 규칙을 같은 설정의
[Rule]섹션에 넣습니다. 항목 사이에 영문 쉼표를 사용했는지, 예외 규칙을 넓은 범위의 규칙보다 앞에 배치했는지 확인한 뒤 저장합니다.라우팅 방식 확인
Home으로 돌아가Global Routing을 열고Config를 선택합니다. 이전에Proxy,Direct또는 사용 시나리오의Scene을 선택했다면 먼저Config로 전환한 뒤 이 글의 규칙 순서를 확인하세요.새 연결 테스트
Home에서 연결이 켜져 있는지 확인하고 테스트 앱이 사용 중인 연결을 종료한 다음, 접속 가능한 것으로 확인된 호스트에 새 요청을 보냅니다.Data에서 해당 시간대의 연결 기록을 확인해 대상 호스트, 일치한 규칙, 적용된 정책을 살펴보세요. 페이지가 열렸다는 사실만으로PROXY에 일치했다고 볼 수는 없습니다.
연결 실패: 먼저 DNS 및 서버 문제 확인
브라우저 오류는 연결이 어떤 단계에서 실패했는지 보여줄 뿐, 특정 규칙에 일치했다는 증거는 아닙니다. 먼저 해당 요청의 기록을 확인하세요. 기록이 없다면 테스트 앱이 연결을 다시 설정했는지, Shadowrocket 연결이 켜져 있는지부터 확인합니다.
브라우저 오류별 확인 방법
오류: ERR_NAME_NOT_RESOLVED
원인: 브라우저가 대상 호스트명의 유효한 DNS 응답을 받지 못했습니다.
해결 방법: 먼저 호스트명의 철자를 확인한 다음 Config에서 현재 설정의 DNS를 점검합니다. DNS 문제를 해결하기 위해 FINAL을 수정하지 마세요.
오류: ERR_CONNECTION_RESET
원인: 연결이 재설정되었습니다. 오류 메시지만으로는 출구 경로와 대상 서버 중 어느 쪽에서 연결을 끊었는지 알 수 없습니다.
해결 방법: 먼저 Data에서 적용된 정책을 확인합니다. PROXY에 일치했다면 Home으로 돌아가 현재 서버에서 Connectivity Test를 실행한 뒤 같은 호스트를 다시 테스트합니다.
자주 묻는 질문: 규칙을 바꿨는데 왜 달라지지 않나요?
증상별 확인 방법
DOMAIN을 추가했는데 왜 기존 정책이 계속 적용되나요?
먼저 Home → Global Routing에서 Config가 선택되어 있는지 확인합니다. 그런 다음 현재 규칙 섹션에서 새 행보다 앞에 일치하는 DOMAIN-SUFFIX, DOMAIN-KEYWORD 또는 다른 규칙이 있는지 살펴보세요. 정확한 예외 규칙을 해당 행보다 앞으로 옮긴 다음 새 연결을 시도합니다.
하위 도메인 하나만 직접 연결하려면 접미사 규칙 전체를 바꿔야 하나요?
기존 접미사 규칙은 그대로 두고 그 앞에 DOMAIN,files.example.com,DIRECT 한 줄을 추가하세요. 이 규칙은 files.example.com에만 적용됩니다. 웹페이지를 새로 불러올 때 페이지에서 요청하는 다른 호스트는 각각 일치하는 규칙에 따라 처리됩니다.
IP 주소로는 연결되는데, 왜 도메인 규칙을 확인할 수 없나요?
IP를 직접 입력하면 테스트 대상이 원래 호스트명과 달라지므로 이 결과로 DOMAIN 규칙의 적용 여부를 확인할 수 없습니다. 원래 호스트명으로 테스트하고 연결 기록을 확인하세요. 브라우저에서 DNS 오류가 발생하면 DNS부터 점검한 뒤 도메인 규칙을 다시 확인합니다.
앞선 규칙의 직접 연결이 아니라 FINAL이 적용됐는지 어떻게 확인하나요?
DIRECT인지 여부만 보지 말고 Data에서 해당 연결에 적용된 규칙을 확인합니다. 기록에 앞선 도메인 또는 주소 규칙이 표시된다면 테스트 대상을 바꾸세요. 앞선 조건이 모두 일치하지 않아야 FINAL에 도달합니다.