Shadowrocket 규칙 작성법: DOMAIN-SUFFIX·GEOIP·IP-CIDR·FINAL 매칭 기초

DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP, IP-CIDR, FINAL의 매칭 기준과 규칙 적용 순서, PROXY·DIRECT·REJECT 작성법을 알아봅니다.

이 글 미리 보기

Home → Global Routing에서 Config를 선택한 다음, 현재 구성 파일의 [Rule]을 확인합니다. 규칙은 위에서 아래로 검사하며, 처음 일치하는 규칙이 정책을 결정합니다. 기존 구성이 있고 도메인 예외를 추가하거나 라우팅 결과를 확인하려는 경우에 유용합니다. 규칙 유형을 목적에 맞게 선택하고, 범위가 좁은 예외를 넓은 규칙보다 앞에 배치한 뒤 세 가지 요청으로 라우팅을 확인하세요.

규칙 문법: 매칭 조건과 정책을 구분해 작성

[Rule] 섹션에 한 줄씩 규칙을 작성합니다. 일반 규칙은 유형, 매칭 값, 정책 순으로 입력하고 영문 쉼표로 구분합니다. FINAL에는 매칭 값이 필요 없으며 정책만 작성합니다. 도메인 규칙에는 호스트명이나 매칭 문자열만 입력하고 https://, 포트, 경로는 넣지 않습니다. 아래 도메인과 주소는 작성 예시이며, 연결 가능 여부를 확인하기 위한 값이 아닙니다.

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example-test,REJECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
3가지
이 글에서 비교하는 도메인 매칭 유형
/24
IPv4 주소의 앞 24비트를 네트워크 프리픽스로 사용
필드 2개
FINAL 행에는 유형과 정책만 작성

정책을 바꾸기 전에 먼저 규칙에 일치하는지 확인

하위 도메인 하나를 직접 연결하려면 먼저 요청의 호스트명을 확인하고, 해당 호스트의 DOMAIN 규칙을 이를 포함하는 DOMAIN-SUFFIX 규칙보다 앞에 배치합니다. 먼저 FINAL을 바꾸지 마세요. 앞선 규칙에 이미 선택된 요청은 마지막 규칙까지 도달하지 않습니다.

  • DIRECT: 선택한 프록시를 거치지 않고 요청을 대상에 직접 연결합니다.
  • PROXY: 요청을 프록시로 전달합니다. 테스트하기 전에 Home에서 현재 선택된 프록시를 확인하세요. 이 규칙에 일치해도 프록시가 작동하거나 대상에서 응답한다는 뜻은 아닙니다.
  • REJECT: 일치하는 요청을 거부합니다. 요청을 프록시로 넘기는 것도, 연결 실패 후 다른 경로로 전환하는 것도 아닙니다.

도메인 매칭: DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD

특정 호스트명 하나만 처리하려면 DOMAIN을 선택하고, 루트 도메인과 하위 도메인을 모두 포함하려면 DOMAIN-SUFFIX를 선택합니다. 여러 도메인에 공통으로 포함된 문자열을 매칭해야 할 때만 DOMAIN-KEYWORD를 사용하세요. 접미사 매칭은 도메인 레이블 경계를 기준으로 하지만, 키워드 매칭은 해당 문자열이 레이블 하나와 정확히 일치할 필요가 없습니다.

조건매칭 예시불일치 예시
DOMAIN,docs.example.comdocs.example.comcdn.docs.example.com、example.com
DOMAIN-SUFFIX,example.comexample.com、api.example.comnotexample.com、example.com.example.net
DOMAIN-KEYWORD,example-testcdn-example-test.example.netexampletest.example.net

표는 각 조건을 개별적으로 판단합니다. 실제 정책은 규칙의 위치에도 영향을 받습니다. 예시의 docs.example.com은 앞의 두 조건에 모두 해당하지만, 정확히 지정한 규칙이 먼저 나오므로 DIRECT를 사용합니다. 접미사 규칙을 앞에 두면 같은 호스트가 PROXY를 사용합니다. Shadowrocket은 가능한 규칙을 모두 모은 뒤 가장 구체적인 규칙을 자동으로 선택하지 않습니다.

주소 매칭: IP-CIDR, GEOIP, no-resolve

IP-CIDR은 대상 IPv4 주소가 속한 네트워크 범위를 기준으로 매칭하므로, 주소 범위를 알고 있는 대상에 적합합니다. GEOIP는 IP 데이터베이스의 지역 분류를 바탕으로 대상 주소를 매칭합니다. GEOIP,CN,DIRECT는 도메인이 .cn으로 끝나는지 또는 기기의 위치가 어디인지 판단하는 규칙이 아닙니다. 도메인의 해석 결과는 네트워크나 시간에 따라 달라질 수 있으므로, 특정 서비스의 라우팅 정책을 고정하려면 이미 알고 있는 도메인 규칙을 우선 사용하세요.

  • 192.0.2.0/24는 192.0.2.0부터 192.0.2.255까지 매칭합니다. 예를 들어 대상 IP 192.0.2.42는 이 네트워크에 해당하지만 192.0.3.42는 해당하지 않습니다. 앞의 주소 하나만 매칭하려면 192.0.2.42/32로 작성합니다.
  • 도메인 요청을 주소 규칙으로 확인할 때 대상 IP가 아직 없다면 먼저 도메인을 해석해야 할 수 있습니다. 예시의 no-resolve는 이 IP-CIDR 규칙의 매칭을 위해 DNS 해석을 요청하지 않는다는 뜻입니다. 대상 IP를 이미 알고 있다면 해당 주소로 계속 판단할 수 있습니다. 이후 규칙이나 실제 연결에 필요한 DNS 해석까지 막지는 않습니다.
  • IP-CIDR의 이 IPv4 네트워크 범위는 IPv6를 포함하지 않습니다. 같은 호스트가 네트워크에 따라 다르게 작동한다면 연결에 사용된 주소 체계와 대상 IP를 먼저 확인한 뒤 주소 규칙이 매칭되지 않은 것인지 살펴보세요. 포트가 달라져도 이 네트워크 규칙의 매칭 범위는 바뀌지 않습니다.

구체적인 주소 예외는 범위가 넓은 GEOIP 규칙보다 앞에 배치하세요. GEOIP,CN,DIRECT를 먼저 작성하면 데이터베이스에서 CN으로 분류된 대상이 이미 DIRECT를 선택해 뒤에 있는 네트워크 예외를 검사하지 않을 수 있습니다. 마지막의 FINAL은 앞선 규칙에 일치하지 않은 요청만 처리하며, 앞선 연결이 시간 초과된 뒤 라우팅을 다시 결정하지 않습니다.

Config에서 첫 번째 매칭 규칙 확인

규칙을 수정하기 전에 각 테스트 대상에 적용될 정책을 미리 정리하세요. 구체적인 예외를 테스트할 때는 정상적으로 접속할 수 있는 대상인지 확인한 후 사용하고, 문서용으로 예약된 네트워크 주소를 실제 연결 가능한 서비스로 간주하지 마세요. 규칙 순서와 연결 가능성이라는 두 변수를 한꺼번에 바꾸지 않도록 수정 전에 원래 구성을 보관하세요.

  1. 구성 확인

    Config로 이동해 현재 사용 중인 구성 파일을 확인합니다. PROXY를 테스트하려면 Home에서 직접 준비한 사용 가능한 프록시가 선택되어 있는지도 확인하세요.

  2. 규칙 저장

    현재 구성의 [Rule] 섹션에 정확한 예외 규칙을 추가합니다. 대상에 적용될 수 있는 접미사·키워드·주소 규칙보다 앞에 배치하고, FINAL은 마지막에 둡니다.

  3. Config로 전환

    Home → Global Routing에서 Config를 선택합니다. Proxy 또는 Direct 모드의 결과를 규칙 검증으로 간주하지 마세요. 기존에 Scene을 사용했다면 먼저 Config로 명시적으로 전환해 Scene 선택의 영향을 제외합니다.

  4. 새 요청 보내기

    정확한 예외, 같은 접미사를 가진 다른 호스트, 앞선 조건에 하나도 해당하지 않는 대상을 각각 요청합니다. 이 글의 예시에서 예상 결과는 차례대로 DIRECT, PROXY, FINAL에서 지정한 PROXY입니다. 세 번째 대상이 GEOIP에 먼저 일치하면 다른 대상을 선택해 기본 규칙을 테스트하세요.

  5. 결과 비교

    새 요청에 해당하는 연결 기록을 열어 실제 호스트명, 정책, 표시된 매칭 정보를 확인합니다. 페이지가 캐시에서 표시되거나 기존 연결을 재사용했다면 새 규칙의 적용 여부를 판단할 수 없습니다. 기존 연결을 종료한 다음 다시 테스트하세요.

규칙이 적용되지 않을 때: 정책·DNS·연결 오류 구분

같은 호스트에 잘못된 정책이 적용되면 활성 구성, Global Routing, 규칙 순서를 먼저 확인하세요. 정책은 맞지만 요청이 실패한다면 DNS 또는 연결 문제를 확인합니다. 아래는 Chromium 브라우저에서 표시될 수 있는 오류 문구이며 Shadowrocket의 규칙 검사 메시지가 아닙니다. 브라우저 오류만으로 어떤 규칙 행이 원인인지 단정할 수 없습니다.

오류: ERR_NAME_NOT_RESOLVED

원인: 브라우저가 요청 도메인의 유효한 해석 결과를 얻지 못했습니다. 해결 방법: 먼저 요청에 입력한 호스트명이 올바른지 확인한 다음 현재 DNS 설정을 점검하세요. 철자나 DNS를 확인하기 위해 FINAL의 정책을 먼저 바꾸지 마세요.

오류: ERR_CONNECTION_TIMED_OUT

원인: 제한 시간 안에 연결이 설정되지 않았습니다. 대상 또는 현재 전달 경로가 응답하지 않을 수 있습니다. 해결 방법: 새 요청에 예상한 정책이 적용되는지 먼저 확인한 다음, 같은 정책으로 접속 가능한 것으로 확인된 대상을 테스트해 특정 대상의 시간 초과인지 경로 전체의 문제인지 구분하세요.

두 대상이 모두 최종적으로 PROXY를 사용한다면 정책 이름만으로는 접미사 규칙과 FINAL의 기본 처리를 구분할 수 없습니다. 먼저 기록에 표시된 매칭 정보를 확인하세요. 현재 기록에 구체적인 규칙이 표시되지 않는다면 테스트용 복사본에서 확인할 규칙 하나만 조정하고, 직접 관리할 수 있는 테스트 대상에 새 요청을 보내 변경 전후의 정책을 비교한 뒤 원래 구성을 복원하세요.

Shadowrocket 무료 다운로드