Shadowrocket 사용자 규칙 작성법과 우선순위: 위에서 아래로 매칭하고 FINAL로 마무리

규칙은 위에서 아래로 검사하며 처음 일치하는 항목에서 멈춥니다. PROXY·DIRECT·REJECT의 차이와 FINAL을 마지막에 두는 이유를 알아봅니다.

이 글의 핵심

이미 보유한 서비스 정보를 가져와 Shadowrocket에서 트래픽 분기를 조정하려는 사용자를 위한 안내입니다. 먼저 Home → Global Routing에서 Config를 사용하는지 확인한 다음 규칙 순서, 도메인 및 IP 조건, FINAL의 위치를 살펴보세요. 마지막으로 개별 요청을 확인해 실제로 어떤 규칙이 적용됐는지 점검합니다. 예시 도메인과 주소는 문법 설명용이며, 실제로 사용할 수 있는 서비스 정보가 아닙니다.

먼저 Config 분기가 활성화되어 있는지 확인

규칙을 파일에 작성했다고 해서 현재 연결에 적용되는 것은 아닙니다. Home에서는 연결과 서비스 선택을 관리하고, Config에서는 설정 파일을, Settings에서는 앱 설정을 관리합니다. 문제를 확인하기 전에 현재 활성화된 설정 파일과 Global Routing의 작업 모드를 각각 확인하세요. 파일에 방금 추가한 규칙이 있는지만 확인해서는 안 됩니다.

Global Routing의 Proxy, Direct, Config, Scene은 연결에 적용되는 작업 모드입니다. 규칙 행의 대문자 PROXY, DIRECT, REJECT는 매칭 후 적용되는 정책입니다. 두 용어는 서로 다른 단계에 속합니다. 이 글에서는 Config 모드에서 현재 활성화된 설정의 Rule 목록 순서를 다룹니다.

Global Routing확인할 항목이 글의 규칙과의 관계
ConfigConfig에서 현재 활성화된 파일 확인설정에 작성된 규칙에 따라 트래픽을 분기하는 모드입니다. 이 글의 검증은 이 모드를 기준으로 합니다.
Proxy현재 선택한 프록시 서비스가 사용 가능한지 확인연결을 프록시 모드로 처리합니다. Config 분기 순서 전체를 검증하는 데는 사용할 수 없습니다.
Direct현재 기기의 네트워크에서 대상에 직접 접속할 수 있는지 확인연결을 직접 연결 모드로 처리합니다. 규칙의 PROXY가 적용되는지 검증하는 용도가 아닙니다.
Scene현재 적용되는 Scene과 그 설정 확인규칙을 분석하기 전에 Scene이 실제로 어떤 동작을 하는지 확인하세요. Scene 이름만 보고 결과를 추측해서는 안 됩니다.

Settings → On Demand는 필요에 따라 연결하는 조건을 처리하며, 도메인 규칙의 순서를 바꾸지는 않습니다. 테스트 중에는 연결 상태를 안정적으로 유지하세요. 네트워크 전환으로 연결 상태가 바뀐 것을 규칙 미적용으로 잘못 판단하지 않도록 주의해야 합니다.

매칭 우선순위: 처음 일치하는 규칙에서 중단

Rule 목록은 ‘도메인이 IP보다 항상 우선’하거나 ‘규칙이 길수록 자동으로 우선’하도록 정렬되지 않습니다. 요청이 매칭 조건에 해당하는지 판단할 수 있으면 Shadowrocket은 규칙을 위에서 아래로 검사하고, 처음 일치한 행의 정책을 적용합니다. 뒤에 있는 일반 규칙이 이를 덮어쓰지는 않습니다. 따라서 구체적인 예외 규칙은 대개 포괄적인 조건보다 앞에 두어야 합니다.

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

요청 도메인이 api.example.com이면 첫 번째 도메인 규칙이 일치해 DIRECT가 적용됩니다. www.example.com에 접속하면 첫 번째 규칙은 일치하지 않고, 두 번째 접미사 규칙이 일치해 PROXY가 적용됩니다. example.net에 접속하고 앞의 규칙이 모두 일치하지 않을 때 FINAL이 적용됩니다.

정책 3가지
이 글에서 다루는 PROXY, DIRECT, REJECT
주요 키워드 4가지
DOMAIN-SUFFIX, GEOIP, IP-CIDR, FINAL을 중점적으로 확인
마지막 규칙 1개
간단한 설정에서는 마지막에 FINAL 규칙 하나를 두어 나머지 요청을 처리

위 예시에서 두 번째 행을 첫 번째 행보다 앞에 두면 api.example.com도 접미사 규칙이 먼저 일치해, 뒤에 있는 정확한 도메인 규칙이 적용되지 않습니다. 이는 ‘규칙이 있는데도 적용되지 않는’ 흔한 원인입니다. 문법 오류가 아니라 요청이 위쪽 조건에서 이미 처리된 것입니다.

규칙 작성법: 도메인, 주소 대역, 지역 조건

일반 규칙은 보통 ‘유형, 매칭 대상, 정책’ 순서로 작성하며, 영문 쉼표로 필드를 구분하고 한 줄에 하나씩 입력합니다. 한글 쉼표를 사용하거나 여러 도메인을 공백으로 구분해 하나의 매칭 필드에 넣지 마세요. FINAL은 도메인이나 주소 조건 없이 정책만 지정하는 예외입니다.

도메인 규칙과 기본 처리

DOMAIN
api.example.com,DIRECT
DOMAIN-SUFFIX
example.com,PROXY
FINAL
PROXY

위 항목은 키워드와 뒤따르는 필드의 관계를 보여줍니다. 파일에 작성할 때는 영문 쉼표로 연결하세요.

IP 조건과 DNS 조회

IP-CIDR
192.0.2.0/24,DIRECT,no-resolve
GEOIP
CN,DIRECT
no-resolve
이 IP 규칙이 도메인 DNS 조회를 직접 요청하지 않도록 합니다

192.0.2.0/24는 문서에 사용하는 예시 주소 대역이며, 실제로 직접 연결해야 할 서비스 네트워크가 아닙니다.

도메인 규칙이 일치하려면 판단에 필요한 도메인 정보를 확인할 수 있어야 하며, IP 규칙에는 판단에 사용할 대상 주소가 필요합니다. 도메인 요청에서 DNS 조회가 발생하는지는 규칙 옵션과 DNS 설정에도 영향을 받습니다. no-resolve를 추가하면 해당 IP 규칙이 조회를 직접 요청하지 않도록 할 수 있지만, 모든 도메인 요청이 그 주소 대역에 일치한다고 볼 수는 없습니다. 접속 방식에 따라 결과가 다르면 기록에 표시된 실제 대상이 도메인인지 IP인지 먼저 확인하세요.

PROXY, DIRECT, REJECT와 FINAL 조합하기

PROXY는 프록시 정책에 따라 처리하며, 실제 연결 경로는 현재 선택한 서비스나 설정에서 참조하는 정책에 따라 달라집니다. DIRECT는 대상에 직접 연결하고 REJECT는 요청을 거부합니다. 어느 것도 ‘연결을 자동으로 복구’하는 버튼은 아닙니다. PROXY를 사용해도 잘못된 서비스 매개변수가 바로잡히지 않으며, DIRECT로 모든 대상에 현재 네트워크에서 접속할 수 있는 것도 아닙니다.

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,blocked.example.net,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

이 예시는 Rule 섹션만 보여주며 완전한 설정 파일이 아닙니다. 기존 파일에 [Rule]이 있다면 필요한 규칙을 해당 섹션에 추가하세요. 같은 이름의 섹션을 기계적으로 다시 붙여 넣지 마세요. 예시는 정확한 도메인을 더 포괄적인 접미사 조건보다 앞에 두고, 그 뒤에 주소 및 지역 조건을 배치한 다음 마지막에 FINAL을 둡니다. 실제 규칙 순서는 사용자의 접속 요구에 맞춰야 하며, 예시를 보편적인 정책으로 간주해서는 안 됩니다.

FINAL로 나머지 요청 처리하기: 두 가지 방식

FINAL,PROXY
  • 앞에서 DIRECT 또는 REJECT가 필요한 대상을 명시합니다.
  • 나머지 일치하지 않은 요청은 프록시 정책으로 보냅니다.
  • 현재 선택한 프록시 서비스와 프로토콜 매개변수가 정상적으로 작동하는지 확인해야 합니다.
FINAL,DIRECT
  • 앞에서 PROXY 또는 REJECT가 필요한 대상을 명시합니다.
  • 나머지 일치하지 않은 요청은 기기의 현재 네트워크로 직접 연결합니다.
  • 새 대상이 규칙에 추가되지 않았다면 자동으로 프록시 정책을 사용하지 않습니다.

두 방식의 차이는 일치하지 않은 트래픽의 처리 경로입니다. 하나를 선택하고 FINAL은 일반 매칭 규칙 뒤에 배치하세요.

FINAL에는 조건이 없습니다. 목록 중간에 있으면 그 지점까지 도달한 요청은 이미 정책이 결정되므로 뒤에 있는 일반 규칙이 처리할 수 없습니다. 파일에 FINAL이 여러 개 있다면 먼저 마지막에 둘 명확한 기본 규칙 하나만 남기고 정리한 다음 다른 규칙을 점검하세요.

수정 및 검증: 한 번에 조건 하나만 변경

아래 절차는 Home, Config, Settings의 화면 구성을 기준으로 합니다. 플랫폼에 따라 편집 기능의 위치가 다를 수 있으므로 현재 화면에서 제공되는 파일 작업을 따르세요. 검증 전에 원본 파일을 복사하고 테스트 대상, 예상 정책, 실제 결과를 기록하세요. 조건을 여러 개 한꺼번에 바꾸면 원인을 찾기 어려워집니다.

  1. 원본 복사본 보관

    Config에서 현재 사용 중인 설정 파일을 찾아 파일 작업 기능으로 먼저 복사본을 저장하거나 백업 파일을 내보내세요. 원격 설정은 별도의 로컬 테스트 복사본을 만들어 두는 것이 좋습니다. 이후 업데이트에서 실험한 내용이 덮어써지는 것을 방지할 수 있습니다.

  2. 규칙 편집

    Config에서 대상 파일의 편집 기능을 열고 [Rule]을 찾습니다. 구체적인 도메인 규칙을 포괄적인 접미사 규칙보다 앞에 배치하고, 영문 쉼표와 정책 표기, 마지막의 FINAL을 확인한 뒤 저장하세요.

  3. 활성화 상태 확인

    Config에서 방금 저장한 파일이 활성화되어 있는지 확인한 다음 Home → Global Routing에서 Config를 선택하세요. 복사본을 편집했더라도 활성화하지 않으면 현재 사용 중인 설정은 바뀌지 않습니다.

  4. 새 연결로 다시 테스트

    테스트 앱에서 대상에 연결된 기존 연결을 종료합니다. 필요하면 Shadowrocket의 연결 스위치를 껐다가 다시 켠 뒤 새 요청을 보냅니다. 기존 연결은 생성 당시의 정책을 계속 사용할 수 있으므로 연결을 재사용하는 페이지를 새로 고치는 것만으로 판단해서는 안 됩니다.

  5. 기록 확인

    앱에서 제공하는 연결 기록이나 로그를 열고 테스트 시간대의 대상 도메인 또는 IP를 찾아 실제 정책과 표시되는 매칭 정보를 확인합니다. 요청이 리디렉션되면 원래 도메인과 이동 후 도메인을 각각 점검하세요.

검증 기준은 ‘지정한 대상에 대한 새 연결이 예상한 정책을 적용하는가’입니다. 웹페이지가 우연히 열리는지만으로 판단하지 마세요. 새 연결에 PROXY가 표시되는데도 핸드셰이크에 실패하면 기존 서비스의 연결 매개변수를 확인하세요. 새 연결에 DIRECT가 표시되고 위쪽의 포괄적 규칙이 일치했다면 먼저 규칙 순서를 조정하세요. 두 경우의 점검 방향은 다릅니다.

규칙이 적용되지 않을 때 확인할 항목

DIRECT를 추가했는데도 왜 PROXY로 연결되나요?

먼저 Home → Global Routing에서 Config가 선택되어 있는지 확인한 다음 Config에서 활성화된 파일을 점검하세요. 대상 도메인을 검색해 위쪽에 더 포괄적인 DOMAIN-SUFFIX 규칙이나 앞서 배치된 FINAL이 있는지 살펴봅니다. 구체적인 예외 규칙을 포괄적인 규칙보다 앞에 옮겨 저장한 뒤 새 연결로 다시 테스트하세요.

같은 웹사이트인데 요청마다 왜 다른 정책이 적용되나요?

연결 기록에서 전체 도메인을 확인하세요. 메인 페이지, 이미지, 로그인 API가 서로 다른 도메인을 사용할 수 있습니다. example.com에 일치하는 규칙이 독립된 example.net까지 자동으로 포함하지는 않습니다. 브라우저 주소창만 보고 전체 트래픽을 판단하지 말고 실제 요청에 필요한 조건을 추가하세요.

IP-CIDR가 도메인 요청을 처리하지 않는 이유는 무엇인가요?

기록에 표시된 대상 주소가 해당 대역에 속하는지, IPv6를 사용하는지, 해당 규칙에 no-resolve가 포함되어 있는지 확인하세요. 도메인 조회 결과로 여러 주소가 반환될 수 있습니다. 다른 시점에 조회한 단일 주소만으로 현재 연결을 판단하지 마세요. 대상이 항상 도메인으로 표시된다면 먼저 정확한 DOMAIN 규칙으로 확인할 수 있습니다.

업데이트 후 사용자 규칙이 사라진 이유는 무엇인가요?

먼저 업데이트한 것이 Home의 기존 서비스 구독인지 Config의 원격 설정인지 구분하세요. 전자는 Rule 파일과 별개의 항목이고, 후자는 파일 내용을 다시 가져올 수 있습니다. 현재 파일의 출처와 활성화 상태를 확인한 뒤 로컬 백업을 복원하고, 별도 설정을 계속 관리할지 해당 원격 설정의 업데이트 방식을 사용할지 결정하세요.

Shadowrocket 다운로드