· 규칙과 라우팅 · 약 8분

Shadowrocket 규칙 문법 입문: DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP, IP-CIDR, FINAL 매칭 범위

자주 쓰이는 규칙 키워드 6개의 매칭 대상과 순서, PROXY / DIRECT / REJECT 조합 방법을 example.com 예시와 함께 설명합니다.

이 글의 핵심

Global Routing에서 Config를 선택하면 먼저 일치하는 규칙이 해당 연결에 적용됩니다. 규칙을 처음 편집하거나 새로 추가한 규칙이 적용되지 않는 경우에 유용합니다. 도메인·주소·기본 규칙의 차이를 이해하고, 요청이 어떤 행에 일치하는지 판단한 뒤 변경 결과를 확인할 수 있습니다.

규칙 순서: 첫 번째 일치 규칙부터 FINAL까지

규칙 파일에서의 위치를 먼저 확인하고, 규칙의 구체성은 그다음에 살펴보세요. Shadowrocket은 현재 설정의 순서대로 규칙을 확인하며, 일치하는 행을 찾으면 해당 행의 정책을 적용합니다. DOMAIN을 사용했다고 해서 규칙이 DOMAIN-SUFFIX보다 자동으로 앞에 배치되지는 않습니다. 특정 호스트에 예외를 적용하려면 해당 호스트를 포괄하는 넓은 범위의 규칙보다 앞에 예외 규칙을 두세요.

대상 호스트현재 설정순서대로 매칭정책 적용

규칙은 연결마다 정책을 선택하며 앱 전체에 고정된 태그를 지정하지 않습니다. 한 페이지를 불러오는 동안에도 페이지 호스트, 정적 리소스 호스트, 로그인 호스트에 각각 연결할 수 있으며, 각 연결에는 서로 다른 규칙이 적용될 수 있습니다. 문제를 확인할 때는 주소 표시줄의 호스트만 보는 대신 실패한 요청에 해당하는 호스트명을 찾아보세요.

도메인 규칙: 전체 호스트명, 도메인 접미사, 키워드

도메인 규칙의 매칭 값에는 호스트명이나 키워드만 입력합니다. 예를 들어 https://www.example.com:443/docs의 호스트명은 www.example.com입니다. https://, 포트 443, 경로 /docs는 규칙 값에 넣지 않습니다. 아래 결과는 연결에서 대상 호스트명을 확인할 수 있는 경우를 전제로 합니다.

규칙 및 매칭 값일치하는 예일치하지 않는 예
DOMAIN,example.comexample.comwww.example.com
DOMAIN-SUFFIX,example.comexample.com、www.example.comnotexample.com、example.com.example.net
DOMAIN-KEYWORD,exampleexample.net、notexample.comwww.test.invalid

호스트 하나만 조정하려면 DOMAIN을 사용하고, 루트 도메인과 모든 하위 도메인에 적용하려면 DOMAIN-SUFFIX를 사용하세요. 접미사 매칭은 도메인 레이블 경계를 확인하므로 문자열이 단순히 example.com으로 끝나는지만 판단하지 않습니다. DOMAIN-KEYWORD는 호스트명에 포함된 문자열을 찾으며 레이블 전체가 일치할 필요는 없습니다. 특정 도메인 하나만 대상으로 할 때 키워드를 쓰면 다른 도메인까지 함께 매칭될 수 있습니다.

주소 규칙: IP-CIDR 대역 및 GEOIP 지역

IP-CIDR은 대상 IPv4 주소가 지정한 네트워크 대역에 포함되는지 확인합니다. GEOIP는 대상 IP가 지리 IP 데이터베이스에서 어느 지역으로 분류되는지 확인합니다. 지역 코드는 도메인 접미사, 웹사이트 등록 국가 또는 기기 위치를 뜻하지 않습니다.

특정 호스트에 항상 같은 정책을 적용하려면 해당 호스트가 한 번 해석된 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
  1. api.example.com은 앞의 세 도메인 조건을 모두 만족하지만 첫 번째 행이 먼저 적용되어 결과는 REJECT입니다. 접미사 규칙을 첫 번째 행으로 옮기면 결과는 PROXY로 바뀝니다.
  2. www.example.com은 첫 번째 행에 일치하지 않고 두 번째 행의 접미사 규칙에 일치하므로 결과는 PROXY입니다. 대상 IP가 CN으로 분류되더라도 이미 적용된 정책을 뒤의 GEOIP 규칙이 덮어쓰지 않습니다.
  3. example.net은 앞의 두 도메인 조건에 일치하지 않으므로 세 번째 행의 키워드 규칙에 일치해 DIRECT로 연결됩니다. 키워드 규칙을 접미사 규칙보다 앞에 잘못 배치하면 www.example.com도 먼저 DIRECT로 연결됩니다.
  4. 목적지 주소를 192.0.2.7로 직접 지정하면 네 번째 행에 일치할 수 있습니다. 앞의 다섯 행에 일치하지 않는 연결은 FINAL,DIRECT로 처리됩니다. 이 행들은 모두 DIRECT를 적용할 수 있으므로 정책 이름만으로는 어떤 행에 일치했는지 구분할 수 없습니다.

규칙 적용 및 결과 확인

테스트에 사용할 설정과 라우팅 방식을 먼저 확인한 다음 새 연결을 시도하세요. 아래 경로는 iPhone / iPad 인터페이스를 기준으로 설명합니다. 규칙을 저장했다고 테스트가 끝난 것은 아닙니다. 현재 선택된 설정, 재사용 중인 연결, 프록시 서버 상태가 관찰 결과에 영향을 줄 수 있습니다.

  1. 설정 확인

    하단의 Config를 열어 현재 선택된 설정 파일을 확인합니다. 편집 전에는 복구할 수 있는 사본을 보관해 한 번의 테스트로 기존 규칙 여러 개를 변경하는 일을 피하세요.

  2. 변경 사항 저장

    확인할 규칙을 같은 설정의 [Rule] 섹션에 넣습니다. 항목 사이에 영문 쉼표를 사용했는지, 예외 규칙을 넓은 범위의 규칙보다 앞에 배치했는지 확인한 뒤 저장합니다.

  3. 라우팅 방식 확인

    Home으로 돌아가 Global Routing을 열고 Config를 선택합니다. 이전에 Proxy, Direct 또는 사용 시나리오의 Scene을 선택했다면 먼저 Config로 전환한 뒤 이 글의 규칙 순서를 확인하세요.

  4. 새 연결 테스트

    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에 도달합니다.

Shadowrocket 다운로드