Shadowrocket 규칙 작성법: DOMAIN-SUFFIX·GEOIP·FINAL 등 키워드 매칭

DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP, IP-CIDR, FINAL의 매칭 대상과 적용 순서, PROXY / DIRECT / REJECT 작성법을 알아봅니다.

이 글의 핵심

Shadowrocket 규칙은 구체적인 예외를 앞에, 범위가 넓은 조건을 뒤에 두고 FINAL로 마무리합니다. Global Routing에서 Config를 선택한 뒤 동작을 확인하세요. 이미 사용할 서비스와 구독이 있고 설정 파일을 수정하려는 사용자를 위한 안내입니다. 규칙 필드와 정책을 확인하고 도메인 및 IP 예시로 매칭 결과를 점검한 다음, 규칙 미매칭·DNS 오류·아웃바운드 연결 실패를 구분합니다.

1. Config를 활성화한 뒤 규칙 적용 여부 확인하기

규칙을 올바르게 작성했다고 해서 실제로 적용 중인 것은 아닙니다. 먼저 Config에서 선택된 설정 파일을 확인한 다음 Home으로 돌아가 Global Routing을 확인하세요. 설정 파일에 따라 트래픽을 분기하려면 Config를 선택해야 합니다. Proxy 또는 Direct 상태라면 접속 결과만으로 개별 설정 규칙이 올바른지 판단할 수 없습니다.

6가지
이 글에서 다루는 규칙: DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP, IP-CIDR, FINAL
4개 항목
Global Routing:Proxy / Direct / Config / Scene
1개 규칙
설정 마지막에 기본 처리용 FINAL 규칙을 하나 두는 것을 권장합니다.

Settings → On Demand에서는 조건에 따른 자동 연결을 설정하며, 규칙 매칭을 대신하지 않습니다. 연결을 끊은 뒤 자동으로 다시 연결된다면 FINAL을 삭제하기 전에 On Demand 설정을 확인하세요. 테스트 중에는 네트워크, 설정 파일, 라우팅 모드를 고정하고 한 번에 조건 하나만 바꿔야 문제를 재현하기 쉽습니다.

2. 규칙 문법: 매칭 조건과 처리 정책 구분하기

일반 규칙은 보통 ‘유형, 매칭 값, 정책’으로 구성하며, 필드는 영문 쉼표로 구분합니다. FINAL에는 매칭 값이 필요 없고 유형과 정책만 지정합니다. 규칙은 설정의 [Rule] 섹션에 작성하세요. [General] 섹션이나 프록시 항목이 있는 섹션에 추가하면 안 됩니다.

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
정책 작성법처리 방식확인할 사항
DIRECT프록시 아웃바운드 없이 대상에 직접 연결합니다.현재 네트워크에서 대상에 직접 접속할 수 있는지 확인합니다.
REJECT매칭된 연결을 거부합니다.매칭 범위가 지나치게 넓지 않은지, 페이지에 필요한 도메인까지 차단하지 않는지 확인합니다.
PROXYPROXY라는 이름의 정책으로 처리합니다.같은 이름의 정책이 있는지, 정책 그룹에서 현재 선택한 아웃바운드가 사용 가능한지 확인합니다.

규칙 이름과 프록시 프로토콜은 서로 다른 개념입니다. 기존 아웃바운드가 Shadowsocks, VMess, VLESS, Trojan, Hysteria2 또는 WireGuard를 사용하더라도 DOMAIN-SUFFIX의 매칭 방식은 달라지지 않습니다. 프로토콜은 연결을 담당하고, 규칙은 연결을 어떤 정책으로 보낼지 결정합니다. 구독 가져오기 및 업데이트 시에도 ‘아웃바운드 목록 업데이트’와 ‘설정 규칙 업데이트’를 구분해야 합니다.

3. DOMAIN 계열: 정확한 도메인, 접미사, 키워드

도메인 규칙에는 https://, 웹 페이지 경로, 포트를 입력하지 않습니다. https://api.example.com:8443/account를 처리하려면 DOMAIN의 매칭 값은 전체 주소가 아니라 api.example.com이어야 합니다. 경로 /account와 포트 8443은 도메인 필드에 포함되지 않습니다.

규칙매칭되는 항목매칭되지 않는 항목
DOMAIN,example.com,DIRECTexample.comwww.example.com
DOMAIN-SUFFIX,example.com,DIRECTexample.com、api.example.comnotexample.com、example.com.other.test
DOMAIN-KEYWORD,example,PROXYexample.com、myexample.net도메인에 example이 포함되지 않은 요청. 웹 페이지 경로에 해당 단어가 있어도 매칭되지 않습니다.

DOMAIN-SUFFIX는 도메인 계층을 기준으로 매칭하며, 임의의 문자열이 해당 문자열로 끝나는지 확인하지 않습니다. 따라서 example.com은 하위 도메인에도 적용되지만 notexample.com에는 적용되지 않습니다. 로그인 API 하나에만 프록시를 적용하려면 DOMAIN을 우선 사용하세요. 도메인과 모든 하위 도메인에 같은 정책이 필요한 경우에만 DOMAIN-SUFFIX를 사용합니다.

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

이 순서에서는 로그인 도메인이 첫 번째 규칙에 먼저 매칭되고, 같은 도메인의 나머지 하위 도메인은 두 번째 규칙에 적용됩니다. 접미사 규칙을 맨 앞에 두면 로그인 도메인도 먼저 DIRECT로 처리됩니다. DOMAIN-KEYWORD는 일반적으로 범위를 제어하기 더 어렵습니다. 추가하기 전에 같은 문자열이 포함될 수 있는 관련 없는 도메인을 확인하고, 흔한 키워드를 바로 REJECT로 지정하지 마세요.

4. IP-CIDR과 GEOIP: IP 주소와 네트워크 대역으로 매칭

IP-CIDR은 대상 IPv4 주소가 지정된 네트워크 대역에 속하는지 판단합니다. 192.168.0.0/16은 192.168.0.0부터 192.168.255.255까지 포함하며, 192.168.1.10/32는 주소 하나만 매칭합니다. IPv6 대역에는 해당하는 IP-CIDR6 규칙을 사용하고, IPv4 예시에 그대로 넣지 마세요.

[Rule]
IP-CIDR,192.168.1.10/32,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

도메인 요청을 주소 기반 규칙으로 판단하려면 일반적으로 사용할 수 있는 대상 IP 정보가 필요합니다. DNS에 문제가 있으면 이후 IP 판정이 예상대로 이뤄지지 않을 수 있으므로, 매칭되지 않는 모든 사례를 GEOIP 데이터 오류로 단정하면 안 됩니다. 같은 도메인이라도 CDN 사용 여부, DNS 응답, 주소 계열에 따라 실제 대상 IP가 달라질 수 있습니다.

5. 위에서 아래로 매칭: FINAL은 반드시 마지막에 배치

일반 규칙 체인은 요청을 위에서 아래로 확인하며, 처음 매칭된 규칙의 정책을 적용하고 이후 규칙은 확인하지 않습니다. 정확한 규칙이 우선 적용되는 이유는 사용자가 앞에 배치했기 때문이지, 소프트웨어가 정확도에 따라 자동으로 재정렬하기 때문이 아닙니다.

요청 진입 설정 읽기 순서대로 매칭 정책 적용 연결 설정
  1. 우선 처리해야 하는 정확한 도메인, 단일 IP, 명확한 차단 규칙을 먼저 배치합니다.
  2. 그다음 도메인 접미사, 범위를 확인한 키워드, 대상 네트워크 대역을 배치합니다.
  3. 이후 GEOIP 등 범위가 넓은 조건을 배치합니다. 다른 규칙과의 순서는 실제 요구 사항에 맞춰 정하세요.
  4. 마지막에 FINAL을 하나 두어 나머지 요청의 처리 방식을 지정합니다.

FINAL은 도메인이나 IP를 추가로 확인하지 않습니다. 따라서 FINAL,PROXY를 맨 앞에 쓰면 뒤에 있는 일반 규칙은 매칭될 기회가 없습니다. FINAL은 ‘오류가 나면 다시 시도’하는 규칙이 아닙니다. 앞선 규칙에 매칭된 연결이 실패해도 FINAL로 넘어가 다른 경로를 선택하지 않습니다.

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

이 예시에서는 api.example.com은 PROXY, www.example.com은 DIRECT로 처리하고, tracking이 포함된 나머지 도메인은 REJECT합니다. 도메인 규칙에 먼저 매칭된 요청은 대상 IP가 GEOIP에도 해당하더라도 다른 정책으로 바뀌지 않습니다. 마지막까지 매칭되지 않은 요청에만 FINAL이 적용됩니다.

6. 규칙이 적용되지 않을 때: 설정·매칭·아웃바운드 순서로 확인하기

수정하기 전에 현재 설정의 사본을 저장하세요. 수정 후 Config에서 선택된 파일을 확인하고, Home으로 돌아가 Global Routing이 Config인지 확인한 다음 새 테스트 연결을 만드세요. 기존에 열려 있는 연결은 이전 상태를 유지할 수 있으므로, 연결을 계속 유지하는 페이지를 새로고침하는 것만으로 규칙이 적용되지 않는다고 판단하지 마세요.

  1. 파일 확인: 같은 이름의 백업 파일이 아니라 현재 사용하는 설정을 수정했는지 확인하세요. 원격 설정을 업데이트한 후에는 수동 수정 사항이 유지됐는지도 다시 확인합니다.
  2. 문법 확인: 영문 쉼표, 규칙 섹션, 정책 이름을 확인하세요. 특히 현재 설정에 PROXY가 실제로 등록되어 있는지 확인합니다.
  3. 대상 확인: 요청 기록에서 실제 도메인이나 IP를 확인하세요. 한 페이지가 로그인, 이미지, API 도메인에 동시에 요청을 보내는 경우가 많으므로 브라우저 주소창에는 그중 하나만 표시됩니다.
  4. 매칭 확인: 기록에 표시된 정책과 규칙 정보를 확인하고, 앞에 배치된 DOMAIN-SUFFIX, GEOIP 또는 FINAL이 먼저 매칭되지 않았는지 살펴보세요.
  5. 아웃바운드 확인: 예상한 정책에 매칭된 뒤에도 실패한다면 DNS, 대상 포트, 기존 서비스의 연결 설정을 확인하세요. 도메인 규칙의 범위를 계속 넓히지는 마세요.

오류: Connection refused

원인 및 해결: 대상 또는 중간 장치가 연결을 거부했을 수 있으며, 규칙 문법 오류라는 뜻은 아닙니다. 먼저 기록에서 실제 적용된 정책을 확인한 뒤 대상 주소, 대기 중인 포트, 기존 아웃바운드 설정을 점검하세요. 로컬 네트워크 서비스라면 해당 포트의 서비스가 실행 중인지도 확인합니다.

오류: Connection timed out

원인 및 해결: 제한 시간 안에 연결이 완료되지 않았으며 네트워크 경로, 대상에 대한 접근성, 아웃바운드 오류 등이 원인일 수 있습니다. 먼저 적용된 정책을 확인한 다음 같은 네트워크에서 기존 서비스의 연결 상태를 점검하세요. 시간 초과를 DOMAIN-SUFFIX 작성 오류로 바로 단정하지 마세요.

위 오류 문구는 연결 단계에서 나타날 수 있는 메시지이며, 연결에 실패할 때마다 반드시 표시되는 고정 문구는 아닙니다. REJECT에 매칭되어 요청이 차단됐다면 먼저 의도한 차단인지 확인하세요. 잘못 차단된 경우에는 범위가 더 좁은 예외를 추가해 차단 규칙보다 앞에 배치하세요. 모든 트래픽을 DIRECT로 바꾸면 안 됩니다.

7. 자주 묻는 질문과 수정 후 확인 사항

DOMAIN-SUFFIX를 추가했는데 특정 하위 도메인이 여전히 프록시로 연결되는 이유는 무엇인가요?

먼저 Home에서 Global Routing이 Config인지 확인한 다음 Config에서 현재 파일을 확인하세요. 이어 해당 하위 도메인이 앞에 배치된 DOMAIN 또는 다른 규칙에 먼저 매칭됐는지 살펴보고, 기록에 표시된 실제 요청 도메인이 해당 접미사에 속하는지도 확인합니다.

FINAL에는 DIRECT와 PROXY 중 무엇을 써야 하나요?

분류되지 않은 트래픽을 어디로 보낼지에 따라 다릅니다. 나머지 트래픽을 기존 프록시 정책으로 보내려면 FINAL,PROXY를 사용하고, 직접 연결하려면 FINAL,DIRECT를 사용하세요. 첫 번째 방식은 PROXY가 등록되어 있고 사용할 수 있는지 확인해야 합니다. 두 규칙 모두 마지막에 배치하세요.

구독을 업데이트하면 직접 작성한 규칙이 사라지나요?

먼저 어떤 항목을 업데이트하는지 구분하세요. 아웃바운드 구독 업데이트와 원격 설정 업데이트는 다릅니다. 원격 설정 전체를 다시 가져오면 로컬 수정 사항이 덮어써질 수 있습니다. 업데이트 전에 사본을 저장하고, 업데이트 후 Config에서 규칙 섹션과 정책 이름을 다시 확인하세요.

같은 도메인에서 443 포트만 프록시로 연결할 수 있나요?

DOMAIN과 DOMAIN-SUFFIX는 포트를 구분하지 않습니다. 도메인 뒤에 :443을 붙이는 것은 올바른 작성법이 아닙니다. 이 글의 예시는 도메인이나 주소에 따라 트래픽을 분기합니다. 포트 조건이 필요하다면 관련 규칙의 지원 여부와 문법을 별도로 확인해야 하며, 도메인 필드를 수정해서는 구현할 수 없습니다.

Shadowrocket 다운로드