사용자 지정 규칙은 목록을 위에서 아래로 확인하며, 처음 일치하는 규칙의 정책이 적용됩니다. 더 구체적인 규칙을 계속 찾지는 않습니다. 연결 설정을 마치고 도메인 예외나 로컬 네트워크 접근을 처리하려는 사용자를 위한 안내입니다. 먼저 Global Routing을 Config로 설정하고, 예외 규칙은 포괄적인 규칙보다 위에 배치하며 FINAL은 맨 아래에 둡니다. 예시 문법은 여러 플랫폼의 설정을 이해하는 데 활용할 수 있으며, 실제 조작은 사용 중인 기기의 Home, Config, Settings 화면을 기준으로 확인하세요.
먼저 규칙 적용 조건 확인
Shadowrocket의 연결 성공 여부와 규칙 적용 여부는 별개입니다. Home에서 선택한 연결은 사용할 수 있는 프록시 출구를 결정하고, Config에서 활성화한 구성은 규칙 내용을 결정합니다. Global Routing은 현재 요청을 구성에 따라 분기할지 결정합니다. 규칙을 작성했는데 달라진 점이 없다면 규칙을 계속 추가하기보다 먼저 이 세 곳을 확인하세요.
이 문서에서는 Global Routing → Config를 전제로 합니다. Proxy는 전체 요청에 프록시를 적용하는 모드이고, Direct는 전체 요청을 직접 연결하는 모드입니다. 이 두 모드로는 구성에 작성된 개별 규칙의 분기 결과를 확인할 수 없습니다. Scene을 사용한다면 해당 장면에 실제로 적용된 설정도 확인하세요. 네트워크가 바뀐 뒤 테스트 조건이 달라졌을 수 있습니다. Global Routing의 Proxy와 규칙 행의 PROXY는 서로 다른 단계입니다. 전자는 전체 모드이고, 후자는 개별 규칙에 지정하는 정책입니다.
- Home에서 현재 연결을 사용할 수 있는지 확인하세요. 규칙의 PROXY를 적용하려면 정상 작동하는 프록시 출구가 필요합니다.
- Config로 이동해 수정하려는 구성이 선택되어 있는지 확인하세요. 이름이 비슷한 다른 파일과 혼동하지 않도록 주의하세요.
- 규칙을 추가하고 테스트하기 전에 Global Routing을 Config로 설정하세요.
- 테스트하는 동안 네트워크 환경을 유지하세요. Settings → On Demand가 켜져 있다면 자동 연결 동작을 확인하되, 이를 규칙 우선순위 설정으로 여기지는 마세요.
이하에서는 구성에 작성된 규칙의 판정만 다루며, 프로토콜 매개변수는 변경하지 않습니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등의 연결 설정과 DOMAIN-SUFFIX 등의 분기 조건은 나누어 확인하세요.
규칙 행의 기본 작성법
구성 파일의 규칙은 [Rule] 섹션에 작성합니다. 일반적인 규칙은 규칙 유형, 매칭 값, 정책의 세 부분으로 이루어지며 영문 쉼표로 구분합니다. FINAL에는 매칭 값이 필요 없으므로 유형과 정책만 씁니다. 키워드는 원문 그대로 유지하고 영문 쉼표를 한국어 쉼표로 바꾸지 마세요. 도메인에 경로를 붙여 전체 URL로 작성하지도 마세요.
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
example.com은 설명을 위한 예시 도메인이며 서비스 접속 주소가 아닙니다. 이 도메인의 접속 결과로 연결 품질을 판단하지 마세요. 기존 파일에 [Rule] 섹션이 있다면 그 안에서 해당 항목을 수정하세요. 섹션 이름을 반복해서 추가하거나 규칙을 [General]에 붙여 넣으면 안 됩니다.
도메인 조건
- DOMAIN
- login.example.com,DIRECT
- DOMAIN-SUFFIX
- example.com,PROXY
- 매칭 값
- https://, 포트, 경로 없이 도메인만 입력
DOMAIN은 도메인을 정확히 매칭하고, DOMAIN-SUFFIX는 지정 도메인과 하위 도메인을 모두 매칭합니다.
IP 주소 조건과 기본 처리
- IP-CIDR
- 192.168.0.0/16,DIRECT,no-resolve
- GEOIP
- CN,DIRECT
- FINAL
- PROXY
IP 조건은 대상 주소를 처리하고, FINAL은 앞선 규칙에 매칭되지 않은 요청을 처리합니다.
no-resolve는 IP 규칙에 추가할 수 있는 옵션으로, 해당 규칙을 매칭하기 위해서만 도메인 조회가 실행되는 것을 방지합니다. 모든 DNS 조회를 끄는 기능은 아니며, 대상 IP가 아직 확인되지 않은 도메인 요청이 해당 네트워크 대역에 매칭되도록 보장하지도 않습니다. 도메인 조건과 IP 조건은 서로 다른 정보를 바탕으로 하므로 테스트할 때 구분해야 합니다.
규칙의 우선순위는 위치로 결정
규칙 목록은 도메인, 네트워크 대역, 지리적 위치에 각각 점수를 매긴 뒤 가장 정확한 조건을 선택하는 방식이 아닙니다. 기본적으로 위에서 아래로 확인하며, 조건에 처음으로 일치하는 규칙이 정책을 결정합니다. 구체적인 도메인 규칙을 포괄적인 접미사 규칙보다 아래에 두면 해당 규칙이 실행되지 않을 수 있습니다.
앞 절의 목록을 예로 들면, login.example.com 요청은 먼저 DOMAIN에 매칭되어 DIRECT가 적용됩니다. static.example.com 요청은 첫 규칙을 건너뛰고 DOMAIN-SUFFIX에 매칭되어 PROXY가 적용됩니다. 두 행의 순서를 바꾸면 login.example.com도 example.com의 접미사 조건에 맞으므로 먼저 PROXY로 처리됩니다. 뒤에 있는 DOMAIN 규칙은 이를 DIRECT로 바꾸지 않습니다.
| 요청 대상 | 첫 매칭 규칙 | 적용 정책 | 판정 근거 |
|---|---|---|---|
| login.example.com | DOMAIN | DIRECT | 구체적인 예외 규칙이 접미사 규칙보다 앞에 있음 |
| static.example.com | DOMAIN-SUFFIX | PROXY | example.com의 하위 도메인 |
| 192.168.1.20 | IP-CIDR | DIRECT | 대상 주소가 192.168.0.0/16에 포함됨 |
| 기타 대상 | GEOIP 또는 FINAL | 첫 매칭 규칙에 따라 결정 | 주소 소속을 먼저 확인하고, 매칭되지 않으면 기본 처리 규칙으로 이동 |
요약: 예외 규칙을 먼저 옮긴 다음 규칙을 추가하세요
정확한 규칙을 작성했는데도 잘못된 정책이 적용된다면, 먼저 그 위에 동일한 대상을 포괄하는 넓은 조건이 있는지 확인하세요. 예외를 해당 조건보다 앞에 옮긴 뒤 새 연결로 테스트하세요. 목록 끝에 같은 규칙을 반복해서 추가하지 마세요.
FINAL은 규칙 목록의 맨 아래에 배치
FINAL은 특정 도메인이나 네트워크 대역을 검사하지 않고, 여기까지 도달한 나머지 요청을 처리합니다. 따라서 적용할 규칙을 모두 배치한 뒤에 두어야 합니다. FINAL 아래에 도메인 예외를 작성해도 문법상 올바를 수는 있지만, 그 예외가 실행될 기회는 없습니다.
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY
이 예시 조각은 ‘특정 요청 거부, 도메인 예외, 일반 도메인 규칙, 사설 네트워크 대역, 최종 정책’ 순서를 보여줍니다. 모든 환경에 그대로 적용할 수 있는 범용 구성은 아닙니다. example.com의 하위 도메인이 사설 IP로 확인되더라도 위쪽 도메인 규칙에 먼저 매칭될 수 있습니다. 사설 IP를 우선 직접 연결해야 한다면 DNS와 대상 주소를 확인할 수 있는 조건을 고려해 순서를 다시 정하세요.
FINAL,PROXY는 앞의 조건에 매칭되지 않은 요청을 프록시로 처리합니다. FINAL,DIRECT는 나머지 요청을 직접 연결합니다. 어느 쪽이든 항상 더 낫다고 할 수 없으므로 기본 연결 방식에 맞춰 선택하세요. 기본 정책을 바꾸려면 기존 FINAL을 교체하고, 서로 충돌하는 FINAL 규칙을 여러 개 남기지 마세요.
세 가지 실행 정책 구분하기
규칙 유형은 ‘어떤 요청이 조건에 맞는가’를 결정하고, 정책은 ‘조건에 맞으면 어떻게 처리할 것인가’를 결정합니다. 정책을 바꿔도 매칭 범위는 달라지지 않습니다. 예를 들어 DOMAIN-SUFFIX의 정책을 PROXY에서 REJECT로 바꾸면 해당 접미사에 속하는 모든 대상에 영향을 줍니다. 웹페이지의 특정 리소스 하나에만 적용되는 것은 아닙니다.
| 정책 | 동작 | 확인할 사항 |
|---|---|---|
| PROXY | 구성에서 사용하는 프록시 출구로 요청 전송 | 출구가 정상 작동하는지 확인하세요. 규칙 매칭 여부만 확인해서는 안 됩니다. |
| DIRECT | 로컬 네트워크를 통해 대상에 직접 연결 | 현재 네트워크에서 대상과 해당 주소에 접근할 수 있는지 확인하세요. |
| REJECT | 조건에 매칭된 요청 거부 | 해당 요청이 실패하는 것은 대체로 예상된 동작이며, 프록시 지연이 증가한 것이 아닙니다. |
DIRECT는 Shadowrocket의 연결 스위치를 끄는 것과 다르며, Global Routing을 Direct로 바꾸는 것과도 다릅니다. 연결이 켜져 있어도 요청마다 DIRECT, PROXY 또는 REJECT 정책이 적용될 수 있습니다. REJECT는 웹페이지 요소를 숨기는 규칙도 아닙니다. 페이지에 필요한 스크립트, 로그인 API 또는 이미지 도메인이 거부되면 페이지가 일부만 로드될 수 있습니다.
- 프록시 출구에 문제가 있으면 PROXY에 매칭된 요청이 실패할 수 있습니다. 실패했다는 이유만으로 규칙이 적용되지 않았다고 판단해서는 안 됩니다.
- 로컬 네트워크에서 대상에 접근할 수 없다면 DIRECT로 바꿔도 네트워크 연결 문제가 자동으로 해결되지 않습니다.
- 잘못된 거부를 확인하려면 의심되는 REJECT 규칙 하나를 잠시 비활성화한 뒤 새 요청을 만들어 결과를 비교하세요. 모든 규칙을 한꺼번에 삭제하지 마세요.
저장 및 테스트 순서
편집하기 전에 기존 구성을 보관하고, 가능하면 복사본에서 테스트하세요. 원격 구성 업데이트로 로컬 변경 사항이 덮어써질 수 있습니다. 서비스 제공업체의 연결 구독 업데이트와 규칙 구성 업데이트는 서로 다른 작업입니다. 구독 링크는 서비스 제공업체에서 받으세요. 도메인 규칙 하나를 조정하려고 모든 연결을 다시 가져올 필요는 없습니다.
- 테스트 조건을 기록합니다. 대상 도메인, 현재 네트워크, Global Routing 모드, 사용 중인 구성을 기록해 여러 변수를 동시에 바꾸지 않도록 합니다.
- 적용 중인 파일을 편집합니다. Config에서 현재 구성을 찾아 편집 화면으로
[Rule]섹션을 확인합니다. 예외 규칙은 이를 포괄하는 규칙보다 앞에 삽입합니다. - 문법을 확인합니다. 영문 쉼표, 규칙 키워드, 도메인, 네트워크 대역을 확인하세요. FINAL에는 정책만 쓰고 비어 있는 매칭 필드를 추가하지 마세요.
- 저장하고 활성화 여부를 확인합니다. 저장한 뒤 Config에서 선택된 파일을 다시 확인하세요. 변경 후에도 이전 연결이 유지된다면 연결을 끊었다가 다시 연결해 기존 세션의 영향을 배제할 수 있습니다.
- 새 요청을 발생시킵니다. 대상 페이지의 기존 연결을 닫고 다시 접속한 다음, 현재 플랫폼에서 제공하는 연결 기록이나 로그에서 대상, 매칭된 규칙, 출구 정책을 확인하세요.
- 한 번에 조건 하나만 바꿔 다시 테스트합니다. 결과가 예상과 다르면 먼저 규칙 위치를 조정한 뒤 DNS와 출구를 확인하세요. 프로토콜, 네트워크, 구성 전체를 동시에 바꾸지 마세요.
새 연결을 대상으로 테스트해야 합니다. 브라우저의 연결 재사용, 페이지 캐시, 앱의 백그라운드 장기 연결 때문에 저장한 규칙이 화면에 바로 반영되지 않을 수 있습니다. 한 페이지에서 여러 도메인에 접속할 수도 있습니다. 기본 문서가 직접 연결되더라도 이미지, API, 동영상 연결에 같은 정책이 적용된다는 뜻은 아닙니다.
자주 발생하는 규칙 문제
DIRECT를 작성했는데 왜 PROXY가 적용되나요?
먼저 Home에서 Global Routing이 Config인지 확인한 다음, Config에서 올바른 파일이 활성화되어 있는지 확인하세요. 이어서 DIRECT보다 위에 있는 DOMAIN-SUFFIX, GEOIP 또는 FINAL이 먼저 매칭되는지 살펴보세요. 필요한 구체적인 예외 규칙을 위로 옮긴 뒤 저장하고 새 연결로 다시 테스트하세요.
DOMAIN-SUFFIX에는 별표를 써야 하나요?
example.com과 하위 도메인을 매칭하려면 DOMAIN-SUFFIX,example.com,PROXY라고 작성하면 됩니다. *.example.com이나 URL 경로는 쓰지 마세요. login.example.com만 대상으로 하려면 DOMAIN을 사용하고, 포괄적인 접미사 규칙보다 앞에 배치하세요.
사설 네트워크 대역 규칙을 추가했는데도 로컬 네트워크 도메인이 열리지 않는 이유는 무엇인가요?
먼저 ‘192.168.1.20에 직접 접속하는 경우’와 ‘해당 주소로 조회되는 도메인에 접속하는 경우’를 구분하세요. 로컬 DNS에서 해당 도메인을 조회할 수 있는지, 위쪽 도메인 규칙이 먼저 매칭되는지 확인합니다. no-resolve가 붙은 IP-CIDR 규칙은 매칭만을 위해 DNS 조회를 실행하지 않습니다. 필요한 경우 알고 있는 로컬 네트워크 도메인에 대해 더 앞쪽에 DOMAIN 예외를 추가하세요.
구성을 업데이트한 뒤 사용자 지정 규칙이 사라진 이유는 무엇인가요?
업데이트된 항목이 원격 규칙 구성인지, Home의 연결 구독인지 확인하세요. 원격 구성이 로컬 파일을 덮어썼다면 미리 저장해 둔 복사본을 복원한 뒤 새 규칙을 확인하세요. 수동 변경 사항이 원격 원본에 자동으로 병합된다고 가정하지 마세요. 장기간 사용하기 전에 구성을 저장하고 업데이트하는 방법을 확인하세요.
조건과 구성 형식을 더 알아보려면 규칙 참조를 확인하세요. Config, Global Routing 또는 DNS의 의미가 확실하지 않다면 용어집을 먼저 살펴보세요. 규칙을 조금씩 추가하면서 매칭 결과를 확인하면 규칙의 우선 적용과 순서 문제를 더 쉽게 찾을 수 있습니다.