Shadowrocket 사용법: 특정 사이트만 프록시로 연결하는 DOMAIN-SUFFIX 규칙과 순서

DOMAIN-SUFFIX와 DOMAIN-KEYWORD에 FINAL,DIRECT를 조합해 일부 사이트만 PROXY로 연결하는 방법을 안내합니다. 규칙의 적용 순서와 Config에서 수정·검증하는 절차도 확인하세요.

이 글의 핵심

Home에 사용할 수 있는 서버를 추가했고 일부 도메인만 해당 서버로 연결하려면, Config에 대상 도메인의 PROXY 규칙을 작성하고 나머지 요청은 FINAL,DIRECT로 처리하면 됩니다. 예시 도메인을 사용해 직접 연결 예외를 유지하고 기존 규칙의 영향을 제외하는 방법, 두 종류의 요청으로 결과를 확인하는 방법을 설명합니다.

먼저 매칭 범위 확인하기: 호스트명, 도메인 접미사, 키워드

규칙은 브라우저 탭에 표시된 전체 URL이 아니라 요청의 대상에 적용됩니다. 예를 들어 https://docs.example.com/guide?lang=zh에서 도메인 규칙에 입력할 값은 docs.example.com입니다. https://, 경로, 쿼리 매개변수, 포트는 포함하지 않습니다. 같은 페이지에서 이미지, 로그인 API 또는 파일을 불러올 때 다른 호스트로 요청할 수 있으며, 각 요청은 개별적으로 판정됩니다.

호스트명 1개
DOMAIN은 정확히 일치하는 호스트명을 매칭합니다. 예: local.example.com
도메인 접미사 1개
DOMAIN-SUFFIX는 해당 도메인과 하위 도메인을 모두 포함합니다.
기본 규칙 1개
FINAL,DIRECT는 앞선 규칙과 일치하지 않은 요청을 처리합니다.

DOMAIN-SUFFIX,example.com,PROXY는 example.com과 docs.example.com에 적용됩니다. 끝부분이 같다는 이유만으로 notexample.com이 매칭되지는 않습니다. docs.example.com만 프록시로 연결하고 하위 도메인은 포함하지 않으려면 DOMAIN,docs.example.com,PROXY를 사용하세요. DOMAIN-KEYWORD는 호스트명에 포함된 문자열을 매칭하므로 서로 다른 여러 도메인에 적용될 수 있습니다. 지정한 사이트 몇 곳만 프록시로 연결하려면 도메인 접미사를 하나씩 명시하는 편이 좋습니다.

규칙 작성하기: 직접 연결 예외를 프록시 접미사 규칙보다 위에 배치

아래 설정 예시에서는 example.com 전체를 프록시로 연결하되 local.example.com 호스트는 직접 연결한다고 가정합니다. 키워드 규칙은 같은 문자열이 포함된 호스트명 여러 개를 매칭하는 예시입니다. 이런 요구가 없다면 해당 줄을 삭제하세요. 예시 도메인과 규칙의 예상 매칭 결과는 작성 방법을 설명하기 위한 것으로, 해당 호스트가 실제 웹 서비스를 제공한다는 의미는 아닙니다.

[Rule]
DOMAIN,local.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,docs-preview,PROXY
FINAL,DIRECT
대상 호스트순서대로 확인정책 판정연결 경로

규칙은 위에서 아래로 확인하며, 일치하는 규칙을 찾으면 해당 줄의 정책을 적용하고 이후 규칙은 확인하지 않습니다. 따라서 local.example.com은 첫 번째 줄에 따라 DIRECT로 연결됩니다. 이 규칙을 DOMAIN-SUFFIX 아래로 옮기면 접미사 규칙이 먼저 적용되어 PROXY로 연결됩니다. 첫 번째 줄은 해당 호스트만 예외로 처리합니다. 하위 도메인도 예외로 두려면 해당 줄의 DOMAIN을 DOMAIN-SUFFIX로 바꾸세요.

FINAL,DIRECT는 앞에서 이미 매칭된 프록시 규칙을 덮어쓰지 않습니다. 기존 설정에 규칙 세트, IP-CIDR 또는 GEOIP가 있고 그중 다른 대상을 PROXY로 보내는 규칙이 있다면 마지막 줄이 DIRECT여도 해당 요청은 프록시로 연결될 수 있습니다. 지정한 사이트만 프록시로 연결하려면 마지막 줄만 수정하지 말고, [Rule] 전체에서 PROXY로 연결될 수 있는 규칙을 먼저 확인하세요.

Config에서 규칙 수정 및 적용하기

  1. 기존 설정을 보관하세요. Config에서 현재 사용 중인 설정을 확인하고, 먼저 사본을 저장한 다음 로컬 설정을 수정하세요. 원본 파일이 원격 주소에서 업데이트된다면 다음 업데이트에서 변경 사항이 덮어써지지 않도록 사용자 규칙은 로컬 사본에 추가하세요. 트래픽 분류만 조정하는 경우 DNS나 서버 설정은 함께 변경하지 마세요. 여러 항목을 동시에 바꾸면 문제 원인을 파악하기 어렵습니다.
  2. 기존 규칙 섹션에 추가하세요. [Rule]을 찾아 예시 규칙을 해당 섹션에 추가합니다. 섹션 이름을 중복해서 넣지 마세요. 대상 도메인과 직접 연결 예외를 원하는 값으로 바꾸고, 기본 규칙은 하나만 두며 FINAL,DIRECT가 규칙 섹션의 마지막에 있는지 확인하세요. 유지해야 하는 기존 규칙은 각각 테스트 도메인에 먼저 적용되지 않는지 확인합니다.
  3. 수정한 파일이 실제로 적용됐는지 확인하세요. 저장한 뒤 Config에서 해당 설정을 선택하고 Home → Global Routing → Config로 이동합니다. 편집한 파일과 실제 사용 중인 파일은 같아야 합니다. 여기서 사용할 규칙 모드는 Global Routing의 Proxy나 Direct가 아닙니다. 현재 Scene을 선택했다면 이번 테스트에 Scene 조건이 영향을 주지 않도록 Config로 전환하세요.
  4. 새 요청으로 확인하세요. Home에서 사용할 수 있는 서버를 선택하고 연결을 켰는지 확인합니다. 수정 전에 웹페이지나 앱에서 전송 중인 요청이 있었다면 기존 연결을 종료한 뒤 테스트 페이지를 다시 여세요. 확인 과정에서는 한 번에 규칙 하나만 변경하고, 테스트 호스트와 실제 연결 경로를 기록해 두면 쉽게 되돌릴 수 있습니다.

대상 도메인과 비교 도메인으로 트래픽 분류 확인하기

PROXY로 연결되어야 하는 대상 하나, DIRECT로 지정한 예외 하나, 규칙에 포함되지 않은 일반 호스트 하나를 준비하세요. 실제 액세스 로그에 기록된 대상 호스트, 매칭된 규칙, 연결 정책을 기준으로 확인합니다. 페이지가 열린다는 사실만으로 어떤 경로를 사용했는지 알 수는 없습니다. 브라우저가 캐시를 재사용하면 새 요청이 전혀 발생하지 않을 수도 있습니다.

예시 규칙으로 요청 경로 확인
요청 호스트예상 매칭 규칙예상 정책
docs.example.comDOMAIN-SUFFIXPROXY
local.example.comDOMAINDIRECT
docs-preview.example.netDOMAIN-KEYWORDPROXY
example.orgFINALDIRECT

외부 IP를 확인하는 웹사이트를 단독으로 열면 그 웹사이트 자체의 연결 경로만 확인할 수 있습니다. 이 설정에서 해당 사이트가 프록시 규칙에 매칭되지 않는다면 직접 연결 경로가 표시되는 것이 정상이며, 이를 근거로 대상 사이트도 DIRECT라고 단정할 수는 없습니다. 대상 요청이 PROXY에 매칭됐는데도 열리지 않는다면 서버 연결 실패인지 대상 사이트 요청 실패인지 구분하세요. 오류를 없애려고 기본 규칙을 PROXY로 바꾸지 마세요.

오류: ERR_CONNECTION_TIMED_OUT

원인: 연결을 기다리던 브라우저가 시간 초과된 것입니다. 이 오류만으로 잘못된 정책이 적용됐는지, 선택한 경로에 연결할 수 없는지 판단할 수 없습니다. 해결 방법: 먼저 해당 요청의 연결 로그를 확인하세요. 이미 PROXY로 연결됐다면 Home으로 돌아가 선택한 서버의 Connectivity Test를 실행하고, 서버 연결을 확인한 뒤 대상 호스트에 다시 접속하세요.

오류: ERR_NAME_NOT_RESOLVED

원인: 브라우저가 접속하려는 호스트명을 확인하지 못했습니다. 주소 오타가 있거나 현재 DNS 조회 경로에서 결과를 가져오지 못할 때 발생할 수 있습니다. 해결 방법: 주소 표시줄과 로그에 기록된 실제 호스트명을 확인하고, 접속 가능한 도메인인지 확인하세요. 그런 다음 해당 호스트의 DNS 조회 상태를 점검합니다. 도메인 규칙을 추가해도 존재하지 않는 도메인의 DNS 레코드가 만들어지지는 않습니다.

특정 사이트 트래픽 분류 FAQ

홈페이지는 열리는데 로그인이나 이미지가 로드되지 않는 이유는 무엇인가요?

실패한 작업을 다시 실행하고 해당 요청의 호스트명과 매칭된 정책을 확인하세요. 로그인 API나 이미지가 다른 도메인에서 제공되고 그 도메인도 프록시가 필요하다면, 해당 호스트에 DOMAIN 규칙을 추가해 FINAL 앞에 배치하세요. 로그인 API 하나를 처리하기 위해 공용 리소스 도메인 전체를 프록시 범위에 추가하지 마세요.

같은 도메인의 특정 경로만 프록시로 연결할 수 있나요?

여기서 설명한 도메인 규칙으로는 경로를 구분할 수 없습니다. example.com/docs와 example.com/account의 호스트명은 모두 example.com입니다. /docs를 DOMAIN-SUFFIX의 매칭 값에 붙여도 경로 매칭은 되지 않습니다. 서비스에서 문서용 하위 도메인을 별도로 제공한다면 DOMAIN으로 해당 호스트를 정확히 지정할 수 있습니다.

FINAL,DIRECT를 설정했는데 다른 사이트도 프록시로 연결되는 이유는 무엇인가요?

먼저 Home → Global Routing에서 Config가 선택되어 있는지 확인한 다음 Config에서 실제 적용 중인 설정을 확인하세요. DIRECT로 연결되어야 하는 요청 하나를 사용해 가장 먼저 매칭된 규칙을 찾습니다. 앞부분의 규칙 세트나 범위가 너무 넓은 DOMAIN-KEYWORD가 매칭됐다면 해당 규칙의 범위를 줄이거나 로컬 사본에서 제거한 뒤 같은 호스트로 다시 테스트하세요.

Shadowrocket 다운로드