2026-10-24 · 규칙 설정 · 약 8분

Shadowrocket 규칙 작성법: DOMAIN-SUFFIX·DOMAIN-KEYWORD·GEOIP·IP-CIDR·FINAL 매칭 방식

DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP, IP-CIDR, FINAL의 매칭 대상과 적용 순서를 알아보고, PROXY·DIRECT·REJECT를 사용해 첫 규칙을 작성하는 방법을 설명합니다.

이 글의 핵심 내용

Shadowrocket을 설치했고 현재 Config에 분기 규칙을 추가하려는 사용자를 위한 안내입니다. 도메인 규칙과 대상 IP 규칙을 구분하고, 예외 규칙을 범위가 넓은 규칙보다 위에 둔 다음 연결 기록에서 매칭 항목과 최종 정책을 확인합니다. 예시 도메인과 주소는 구문 설명용이며, 구독을 가져오지 않아도 내용을 읽고 확인할 수 있습니다.

규칙 적용 순서: 위에서 아래로 확인해 처음 일치하는 규칙 적용

Home에서 Global Routing을 Config로 설정하면 Shadowrocket의 연결에 현재 Config의 규칙이 적용됩니다. Config 텍스트의 [Rule] 섹션에는 보통 한 줄에 규칙 하나를 작성하며, 형식은 유형,매칭값,정책입니다. FINAL은 예외로 매칭값 없이 FINAL,정책 형식으로 작성합니다.

앱에서 연결 시작대상 정보 확인규칙을 순서대로 확인처음 일치하는 정책 선택연결 처리

시스템이 정확히 일치하는 DOMAIN 규칙을 자동으로 위에 배치하지는 않습니다. DOMAIN-SUFFIX 규칙이 먼저 매칭되면 아래에 작성한 정확한 도메인 예외 규칙은 적용되지 않습니다. 마찬가지로 FINAL을 중간에 두면 해당 지점까지 매칭되지 않은 연결이 기본 정책으로 처리되어, 뒤에 있는 규칙은 확인되지 않습니다.

도메인 규칙: 정확한 도메인, 접미사, 포함 문자열

도메인 규칙은 호스트명을 확인하며 전체 URL은 확인하지 않습니다. 예를 들어 https://docs.example.com:443/guide를 규칙에 사용할 때는 docs.example.com만 입력합니다. https://, 포트 443, 경로 /guide는 제외합니다. 같은 호스트의 두 웹페이지를 경로에 따라 서로 다른 정책으로 처리할 수는 없습니다.

유형 및 매칭값매칭되는 예매칭되지 않는 예
DOMAIN,example.comexample.comdocs.example.com: 호스트명이 일치하지 않습니다.
DOMAIN-SUFFIX,example.comexample.com、docs.example.comnotexample.com: 도메인 레이블 경계가 없습니다.
DOMAIN-KEYWORD,exampleexample.com、notexample.netsample.net: 지정한 문자열이 포함되어 있지 않습니다.

DOMAIN-SUFFIX에는 example.com을 입력하면 됩니다. *.example.com으로 작성할 필요가 없습니다. 호스트 하나에만 적용하려면 DOMAIN을 사용하고, 기본 도메인과 하위 도메인에 같은 정책을 적용하려면 DOMAIN-SUFFIX를 사용하세요. DOMAIN-KEYWORD는 예상보다 넓은 범위에 매칭될 수 있습니다. 특히 짧은 단어는 도메인 레이블 전체와 일치할 필요도, 도메인 앞부분에 나타날 필요도 없습니다.

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,REJECT
FINAL,DIRECT

위 예시에서 docs.example.com은 첫 번째 규칙에 매칭되어 DIRECT로 연결되고, www.example.com은 접미사 규칙에 매칭되어 PROXY를 사용합니다. notexample.net은 키워드 규칙에 의해 거부됩니다. 여기의 키워드 규칙은 잘못 매칭될 수 있는 범위를 보여 주기 위한 것이므로 실제 Config에 그대로 사용하지 않는 것이 좋습니다. 앞의 두 규칙 순서를 바꾸면 docs.example.com이 접미사 규칙에 먼저 매칭됩니다. 정확한 예외 규칙을 위에 두어야 하는 이유입니다.

IP 규칙: IP-CIDR, GEOIP 및 기본 처리

도메인 규칙에 매칭되지 않으면 대상 주소를 기준으로 연결 정책을 정할 수 있습니다. IP-CIDR은 대상 IPv4 주소가 지정된 네트워크 범위에 속하는지 확인합니다. GEOIP는 대상 IP가 지리 정보 데이터베이스에서 어떻게 분류되는지 확인하며, 도메인 접미사나 휴대전화의 현재 위치를 기준으로 판단하지 않습니다. 특정 도메인에 예외를 적용하려면 해당 도메인 규칙을 범위가 넓은 IP 규칙보다 위에 두세요.

[Rule]
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

첫 규칙 추가 및 적용 확인

처음 수정할 때는 범위가 명확한 규칙 하나만 추가하고 DNS, 프록시 연결 경로, 기본 처리 설정을 동시에 바꾸지 마세요. 아래에서는 DOMAIN,example.com,DIRECT를 예시로 사용합니다. 현재 네트워크에서 해당 사이트에 직접 접속할 수 없다면, 직접 연결이 확인된 테스트 호스트로 바꾸세요.

  1. 현재 Config 백업

    Config에서 현재 사용 중인 파일을 확인하고 사본을 먼저 만들어 두세요. 파일이 원격 업데이트 대상이라면 개인용 로컬 사본을 수정해 다음 업데이트에서 변경 사항이 덮어써지지 않도록 하세요.

  2. 정확한 도메인 규칙 추가

    Config에서 편집할 Config의 세부 정보를 열고 Rules에 DOMAIN을 추가합니다. 매칭값은 example.com으로 입력하고 정책은 DIRECT를 선택하세요. 텍스트 편집기를 사용한다면 해당 규칙을 [Rule] 섹션에 추가합니다.

  3. 규칙 위치 및 모드 확인

    새 규칙을 이를 덮어쓸 수 있는 접미사 규칙, 키워드 규칙, FINAL보다 위에 배치하세요. 저장한 뒤 수정한 파일이 실제 사용 중인지 확인합니다. 그런 다음 Home → Global Routing에서 Config를 선택하고 연결 스위치를 켜세요.

  4. 새 연결을 만들어 확인

    기존 테스트 페이지를 닫고 요청을 다시 보내 브라우저의 기존 연결을 재사용하지 않도록 하세요. Data에서 해당 요청의 기록을 찾아 호스트명과 시간으로 식별하고 정책이 DIRECT인지 확인합니다. 페이지가 다른 주소로 이동하거나 다른 호스트의 리소스를 불러오면 각 연결 기록을 따로 확인하세요.

검증 실패 시: DNS, 대상 포트, 규칙 매칭 확인

페이지가 열리지 않는다고 해서 규칙이 적용되지 않았다는 뜻은 아닙니다. 먼저 Data에서 실패한 연결의 대상과 정책을 확인하세요. 매칭 기록이 있는데도 페이지가 실패한다면 브라우저 오류를 확인합니다. 아래 오류는 Chromium의 메시지이며 Shadowrocket 규칙 이름이 아닙니다.

오류: ERR_NAME_NOT_RESOLVED

원인: 브라우저가 대상 호스트의 유효한 DNS 조회 결과를 받지 못했습니다. 호스트명을 잘못 입력했거나 사용 중인 DNS에서 조회하지 못했을 수 있습니다. 해결 방법: 주소 표시줄에 표시된 실제 호스트명을 확인하고, 같은 네트워크에서 조회 가능한 도메인으로 테스트하세요. 먼저 DNS가 정상적으로 작동하는지 확인하고, DNS 문제를 해결하기 위해 FINAL의 위치를 바꾸지는 마세요.

오류: ERR_CONNECTION_REFUSED

원인: 연결 시도가 거부되었습니다. 예를 들어 HTTPS 대상이 예상한 TCP 443 포트에서 연결을 수락하지 않았을 수 있습니다. 해결 방법: 먼저 실제 정책이 REJECT인지 확인하고 URL의 프로토콜과 포트를 점검하세요. 직접 관리하는 서비스를 테스트하는 경우 해당 포트에서 서비스가 연결을 수신 중인지 확인합니다.

자주 묻는 질문: 규칙이 매칭되지 않을 때 확인할 사항

DIRECT 규칙을 추가했는데 기록에는 왜 PROXY로 표시되나요?

먼저 Home → Global Routing에서 Config가 선택되어 있는지 확인한 다음, Config에서 사용 중인 파일이 방금 수정한 파일인지 확인하세요. 이어서 [Rule]의 첫 줄부터 아래로 살펴보고 접미사 또는 키워드 규칙이 먼저 매칭되는지 확인합니다. 해당 규칙을 찾으면 정확한 예외 규칙을 그보다 위로 옮기세요.

같은 웹페이지의 연결에 서로 다른 정책이 적용되는 이유는 무엇인가요?

페이지 본문, 이미지, 스크립트가 서로 다른 호스트에서 제공되거나 다른 주소로 이동할 수 있습니다. Data에서 요청 시간과 각 연결의 대상 호스트를 비교하세요. 브라우저 탭 제목만 확인해서는 안 됩니다. 다른 리소스 호스트에도 같은 정책을 적용하려면 해당 호스트의 정확한 규칙을 추가하고, 키워드 규칙으로 범위를 불필요하게 넓히지 마세요.

Connectivity Test는 통과했는데 사이트가 열리지 않는 이유는 무엇인가요?

Connectivity Test는 테스트 대상을 확인할 뿐, 현재 웹페이지에 예상한 정책이 적용됐는지 또는 모든 페이지 리소스에 접속할 수 있는지를 보장하지 않습니다. 대상 페이지를 다시 열고 Data에서 해당 사이트의 연결 기록을 확인하세요. 실제로 DIRECT를 사용한다면 먼저 로컬 네트워크와 사이트 간의 연결을 점검하고, PROXY를 사용한다면 선택한 연결 경로를 확인하세요.

Global Routing의 Scene으로 Config를 대신할 수 있나요?

개별 규칙을 검증할 때는 먼저 Config로 고정하세요. Proxy와 Direct는 전역 라우팅 모드이므로 개별 규칙 검증에 사용하지 않습니다. Scene은 설정된 시나리오에 따라 라우팅 방식을 선택하므로 장면이 바뀌면 결과도 달라질 수 있습니다. 먼저 Config에서 같은 대상의 매칭 결과를 확인한 다음, 평소 사용하는 Scene으로 돌아가 다시 확인하세요.

Shadowrocket 다운로드 및 가이드 보기

iPhone/iPad 버전은 App Store에서 $2.99 일회성 결제로 이용할 수 있습니다. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 확인하세요. Mac(Apple 실리콘/Intel), Windows, Android, Linux 버전은 무료이며, 설치 파일은 이 사이트의 다운로드 페이지에서 받을 수 있습니다.

Shadowrocket 다운로드