Shadowrocket 규칙 유형 설명: DOMAIN-SUFFIX, GEOIP, IP-CIDR, FINAL의 매칭 대상

DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP, IP-CIDR, FINAL의 매칭 대상과 작성법을 예시로 살펴보고 규칙의 적용 순서를 설명합니다.

핵심 내용

Home → Global Routing에서 Config를 선택하면 Shadowrocket은 현재 구성의 규칙을 위에서부터 확인하고, 처음 일치하는 규칙에 따라 정책을 결정합니다. 도메인 규칙은 호스트 이름을, 주소 규칙은 대상 IP를 확인하며, FINAL은 앞선 규칙에 일치하지 않은 연결을 처리합니다. 트래픽 분리 구성을 정리하거나 특정 연결이 DIRECT 또는 PROXY를 사용하는 이유를 확인할 때 참고할 수 있습니다.

규칙 매칭 순서: Config를 확인하고 첫 번째 일치 규칙 찾기

Home → Global Routing에서 Config를 선택한 다음 Config 페이지에서 현재 사용 중인 구성 파일을 확인합니다. 앞에서의 Config는 라우팅 모드이고, 뒤에서의 Config는 구성 파일을 관리하는 페이지입니다. 다른 파일을 편집해도 현재 연결에는 그 파일의 새 규칙이 적용되지 않습니다. Proxy와 Direct 역시 이 규칙 순서를 검증하는 모드가 아닙니다.

연결 요청대상 정보규칙별 매칭정책 선택연결 전송

규칙은 보통 “유형, 매칭 값, 정책” 형식으로 작성합니다. 예를 들면 DOMAIN,api.example.com,DIRECT입니다. DIRECT는 직접 연결을, PROXY는 프록시 연결을 뜻합니다. 구성은 더 구체적인 규칙을 자동으로 우선 선택하지 않습니다. DOMAIN이 DOMAIN-SUFFIX보다 구체적이더라도 앞에 있는 접미사 규칙이 먼저 일치하면 해당 정확한 규칙까지 확인하지 않습니다.

3가지
이 글에서 다루는 도메인 규칙: 정확한 도메인, 접미사, 키워드
256개
IPv4 /24 서브넷에 포함되는 주소 수
필드 2개
FINAL에는 규칙 유형과 정책만 작성

도메인 규칙: DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD

세 규칙은 모두 호스트 이름을 매칭하며 전체 URL을 매칭하지 않습니다. https://api.example.com:443/v1/status를 예로 들면 도메인 필드에는 api.example.com을 작성합니다. https://, 포트 443, 경로 /v1/status는 포함하지 않습니다. 같은 호스트의 두 경로를 서로 다르게 처리해야 하는 경우 이 세 규칙만으로는 구분할 수 없습니다.

규칙 유형매칭 값일치 예시불일치 예시
DOMAINapi.example.comapi.example.comimg.api.example.com
DOMAIN-SUFFIXexample.comexample.com、api.example.comnotexample.com
DOMAIN-KEYWORDexamplenotexample.netapi.example.net 이외의 관련 없는 호스트(예: api.demo.test)

특정 호스트 하나에 예외를 지정하려면 DOMAIN을 사용합니다. 루트 도메인과 하위 도메인까지 포함하려면 DOMAIN-SUFFIX를 사용하며, 매칭 값은 *.example.com 형식으로 작성할 필요가 없습니다. DOMAIN-KEYWORD는 부분 문자열을 기준으로 매칭하므로 키워드가 두 점 사이에 있어야 하는 것은 아닙니다. 위 표의 notexample.net에도 example이 포함되어 있어 일치합니다. 도메인이 전혀 다른 사이트에 속하더라도 결과는 같습니다. 대상 도메인을 알고 있다면 정확한 도메인이나 접미사 규칙을 사용해 적용 범위를 더 쉽게 제어할 수 있습니다.

주소 규칙: IP-CIDR은 서브넷, GEOIP는 IP 위치 정보 확인

연결 대상이 도메인 이름으로 주어진 경우 주소 규칙은 비교할 대상 IP가 필요합니다. 예를 들어 IP-CIDR,192.0.2.0/24,DIRECT,no-resolve에서 no-resolve는 이 규칙의 매칭을 위해 별도로 DNS 조회를 하지 않는다는 뜻이지, 구성 전체의 DNS를 끄는 것이 아닙니다. 대상 IP가 있으면 해당 서브넷에 속하는지 확인할 수 있습니다. 호스트 이름만 있고 사용할 주소가 없다면 이 규칙이 호스트 이름을 조회한 뒤 매칭할 것이라고 기대해서는 안 됩니다.

같은 호스트 이름에서도 서로 다른 주소가 반환될 수 있습니다. 도메인 접미사 규칙의 매칭 조건은 이 주소에 따라 바뀌지 않지만, GEOIP 결과는 매칭에 사용된 대상 IP와 데이터베이스상의 분류에 따라 달라집니다. 특정 호스트에 항상 같은 정책을 적용해야 한다면 해당 도메인 규칙을 지역 규칙보다 앞에 배치하세요.

FINAL 기본 처리와 규칙 순서 예시

FINAL에는 도메인, 서브넷 또는 지역 코드를 지정하지 않습니다. 예를 들어 FINAL,PROXY는 앞선 규칙에 일치하지 않은 연결을 프록시로 보냅니다. [Rule]의 마지막에 배치하세요. 아래 규칙은 적용 순서를 살펴보기 위한 예시이며 완전한 구성은 아닙니다. PROXY 경로를 확인할 때는 직접 구성해 사용할 수 있는 프록시를 이용해야 합니다.

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,demo-example,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
  1. 대상 호스트 이름이 api.example.com이면 첫 번째 줄에서 DIRECT가 선택됩니다. 앞의 두 규칙 순서를 바꾸면 같은 호스트 이름이 먼저 접미사 규칙에 일치해 PROXY를 사용합니다.
  2. 대상 호스트 이름이 demo-example.example.com이면 접미사와 키워드 규칙이 모두 일치하지만 접미사 규칙이 앞에 있으므로 PROXY를 사용합니다. 키워드 매칭은 이미 선택된 정책을 덮어쓰지 않습니다.
  3. 대상이 192.0.2.18로 직접 주어진 경우 앞의 세 도메인 조건은 일치하지 않고 서브넷 규칙이 DIRECT를 선택합니다. 192.0.3.18로 바꾸면 해당 서브넷에 일치하지 않는다는 뜻일 뿐입니다. 뒤에 있는 GEOIP를 확인해야 하므로 곧바로 FINAL을 사용한다고 단정할 수 없습니다.
  4. 도메인, 서브넷, 지역 조건이 모두 일치하지 않을 때 마지막 줄의 PROXY를 사용합니다. 이 연결 경로가 실패하더라도 FINAL이 다른 정책을 제공하지는 않습니다. FINAL은 “규칙에 일치하지 않음”을 처리하며 “연결 실패”를 처리하지 않습니다.

규칙 미적용과 연결 실패 확인

먼저 정책이 잘못 선택된 것인지, 정책은 맞게 선택됐지만 연결이 실패한 것인지 구분합니다. 대상 호스트를 명확히 지정해 다시 시도하세요. 예를 들어 직접 접속할 수 있는 테스트 호스트에 DOMAIN 규칙을 추가하고 더 넓은 범위의 규칙보다 앞에 배치한 다음 저장하고 연결을 다시 시도합니다. 웹페이지는 이미지와 스크립트가 있는 다른 호스트에도 요청을 보내는 경우가 많으므로, 페이지 전체가 열리는지만으로 모든 요청의 정책을 판단할 수 없습니다.

브라우저 오류

다음은 브라우저에 표시될 수 있는 오류 원문이며, Shadowrocket의 규칙 매칭 결과를 나타내는 것은 아닙니다.

오류: ERR_NAME_NOT_RESOLVED

원인: 브라우저가 요청한 호스트 이름을 주소로 변환하지 못했습니다. 해결 방법: 요청한 호스트 이름의 철자와 DNS 조회 결과를 먼저 확인한 다음, 대상 IP가 필요한 규칙을 조정해야 하는지 판단하세요.

오류: ERR_CONNECTION_TIMED_OUT

원인: 제한 시간 안에 연결되지 않았습니다. 이 오류만으로 어떤 규칙이 일치했는지는 알 수 없습니다. 해결 방법: 현재 구성의 순서에 따라 예상 정책을 확인하세요. PROXY를 사용해야 한다면 Home에서 현재 사용 중인 프록시의 Connectivity Test를 실행하세요.

자주 묻는 질문

DOMAIN 규칙을 추가했는데도 왜 프록시를 사용하나요?

Home → Global Routing에서 Config가 선택되어 있는지 확인하고 편집한 파일이 현재 사용 중인 파일인지 확인하세요. 그런 다음 앞에 이미 일치한 DOMAIN-SUFFIX 또는 DOMAIN-KEYWORD 규칙이 있는지 살펴보세요. 해당 규칙이 있다면 정확한 예외 규칙을 앞에 배치하고 연결을 다시 시도하세요.

같은 도메인에 접속했는데 GEOIP 결과가 달라지는 이유는 무엇인가요?

두 연결에서 실제로 사용된 대상 IP를 비교하세요. 도메인이 같더라도 두 연결이 같은 주소를 사용한다는 뜻은 아닙니다. 도메인에 따라 정책을 고정하려면 뒤에 있는 GEOIP에 의존하는 대신 앞쪽에 DOMAIN 규칙을 사용하세요.

FINAL을 수정하기 전에 어떤 규칙을 확인해야 하나요?

알려진 도메인 규칙에 일치하지 않는 테스트 대상을 사용해 IP-CIDR 또는 GEOIP 규칙에 일치하는지 계속 확인하세요. 앞선 조건이 모두 성립하지 않아야 FINAL을 바꿨을 때 해당 연결에 영향을 줍니다. 결과를 비교하기 쉽도록 한 번에 한 항목만 수정하세요.

Shadowrocket 다운로드 및 시작하기

iPhone / iPad 버전은 App Store에서 받을 수 있으며, $2.99 일회성 결제입니다. 시스템 요구 사항은 App Store 페이지를 기준으로 합니다. Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료이며 이 사이트의 다운로드 페이지에서 받을 수 있습니다.

Shadowrocket 다운로드