Shadowrocket 규칙은 구체적인 예외를 앞에, 범위가 넓은 조건을 뒤에 두고 FINAL로 마무리합니다. Global Routing에서 Config를 선택한 뒤 동작을 확인하세요. 이미 사용할 서비스와 구독이 있고 설정 파일을 수정하려는 사용자를 위한 안내입니다. 규칙 필드와 정책을 확인하고 도메인 및 IP 예시로 매칭 결과를 점검한 다음, 규칙 미매칭·DNS 오류·아웃바운드 연결 실패를 구분합니다.
1. Config를 활성화한 뒤 규칙 적용 여부 확인하기
규칙을 올바르게 작성했다고 해서 실제로 적용 중인 것은 아닙니다. 먼저 Config에서 선택된 설정 파일을 확인한 다음 Home으로 돌아가 Global Routing을 확인하세요. 설정 파일에 따라 트래픽을 분기하려면 Config를 선택해야 합니다. Proxy 또는 Direct 상태라면 접속 결과만으로 개별 설정 규칙이 올바른지 판단할 수 없습니다.
- Proxy: 모든 트래픽을 프록시로 처리합니다. Config의 개별 규칙에 따른 분기 여부를 확인할 때는 사용하지 않습니다.
- Direct: 트래픽을 직접 연결합니다. 직접 접속에 성공해도 프록시 정책이 올바르게 설정됐다는 뜻은 아닙니다.
- Config: 현재 설정 파일의 규칙에 따라 트래픽을 분기합니다. 이 글의 테스트에서 사용하는 모드입니다.
- Scene: 설정된 Scene 조건에 따라 작동합니다. 문제를 진단할 때는 Scene 전환으로 생기는 변수를 줄이도록 Config를 명확히 선택하세요.
Settings → On Demand에서는 조건에 따른 자동 연결을 설정하며, 규칙 매칭을 대신하지 않습니다. 연결을 끊은 뒤 자동으로 다시 연결된다면 FINAL을 삭제하기 전에 On Demand 설정을 확인하세요. 테스트 중에는 네트워크, 설정 파일, 라우팅 모드를 고정하고 한 번에 조건 하나만 바꿔야 문제를 재현하기 쉽습니다.
2. 규칙 문법: 매칭 조건과 처리 정책 구분하기
일반 규칙은 보통 ‘유형, 매칭 값, 정책’으로 구성하며, 필드는 영문 쉼표로 구분합니다. FINAL에는 매칭 값이 필요 없고 유형과 정책만 지정합니다. 규칙은 설정의 [Rule] 섹션에 작성하세요. [General] 섹션이나 프록시 항목이 있는 섹션에 추가하면 안 됩니다.
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
| 정책 작성법 | 처리 방식 | 확인할 사항 |
|---|---|---|
DIRECT | 프록시 아웃바운드 없이 대상에 직접 연결합니다. | 현재 네트워크에서 대상에 직접 접속할 수 있는지 확인합니다. |
REJECT | 매칭된 연결을 거부합니다. | 매칭 범위가 지나치게 넓지 않은지, 페이지에 필요한 도메인까지 차단하지 않는지 확인합니다. |
PROXY | PROXY라는 이름의 정책으로 처리합니다. | 같은 이름의 정책이 있는지, 정책 그룹에서 현재 선택한 아웃바운드가 사용 가능한지 확인합니다. |
규칙 이름과 프록시 프로토콜은 서로 다른 개념입니다. 기존 아웃바운드가 Shadowsocks, VMess, VLESS, Trojan, Hysteria2 또는 WireGuard를 사용하더라도 DOMAIN-SUFFIX의 매칭 방식은 달라지지 않습니다. 프로토콜은 연결을 담당하고, 규칙은 연결을 어떤 정책으로 보낼지 결정합니다. 구독 가져오기 및 업데이트 시에도 ‘아웃바운드 목록 업데이트’와 ‘설정 규칙 업데이트’를 구분해야 합니다.
3. DOMAIN 계열: 정확한 도메인, 접미사, 키워드
도메인 규칙에는 https://, 웹 페이지 경로, 포트를 입력하지 않습니다. https://api.example.com:8443/account를 처리하려면 DOMAIN의 매칭 값은 전체 주소가 아니라 api.example.com이어야 합니다. 경로 /account와 포트 8443은 도메인 필드에 포함되지 않습니다.
| 규칙 | 매칭되는 항목 | 매칭되지 않는 항목 |
|---|---|---|
DOMAIN,example.com,DIRECT | example.com | www.example.com |
DOMAIN-SUFFIX,example.com,DIRECT | example.com、api.example.com | notexample.com、example.com.other.test |
DOMAIN-KEYWORD,example,PROXY | example.com、myexample.net | 도메인에 example이 포함되지 않은 요청. 웹 페이지 경로에 해당 단어가 있어도 매칭되지 않습니다. |
DOMAIN-SUFFIX는 도메인 계층을 기준으로 매칭하며, 임의의 문자열이 해당 문자열로 끝나는지 확인하지 않습니다. 따라서 example.com은 하위 도메인에도 적용되지만 notexample.com에는 적용되지 않습니다. 로그인 API 하나에만 프록시를 적용하려면 DOMAIN을 우선 사용하세요. 도메인과 모든 하위 도메인에 같은 정책이 필요한 경우에만 DOMAIN-SUFFIX를 사용합니다.
[Rule]
DOMAIN,login.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
이 순서에서는 로그인 도메인이 첫 번째 규칙에 먼저 매칭되고, 같은 도메인의 나머지 하위 도메인은 두 번째 규칙에 적용됩니다. 접미사 규칙을 맨 앞에 두면 로그인 도메인도 먼저 DIRECT로 처리됩니다. DOMAIN-KEYWORD는 일반적으로 범위를 제어하기 더 어렵습니다. 추가하기 전에 같은 문자열이 포함될 수 있는 관련 없는 도메인을 확인하고, 흔한 키워드를 바로 REJECT로 지정하지 마세요.
4. IP-CIDR과 GEOIP: IP 주소와 네트워크 대역으로 매칭
IP-CIDR은 대상 IPv4 주소가 지정된 네트워크 대역에 속하는지 판단합니다. 192.168.0.0/16은 192.168.0.0부터 192.168.255.255까지 포함하며, 192.168.1.10/32는 주소 하나만 매칭합니다. IPv6 대역에는 해당하는 IP-CIDR6 규칙을 사용하고, IPv4 예시에 그대로 넣지 마세요.
[Rule]
IP-CIDR,192.168.1.10/32,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
- IP-CIDR: 명확한 로컬 네트워크 주소나 알려진 대상 네트워크 대역에 적합합니다. 실제 네트워크에 맞춰 대역을 지정해야 하며, 예시를 모든 로컬 네트워크의 전체 목록으로 간주하면 안 됩니다.
- GEOIP: IP 지리 데이터베이스를 기준으로 주소의 국가·지역을 판단합니다.
GEOIP,CN,DIRECT는 ‘중국어 웹사이트는 직접 연결’이라는 뜻이 아니며 도메인 접미사를 기준으로 판단하지도 않습니다. - no-resolve: 이 IP 규칙에 매칭하기 위해 도메인을 별도로 조회하지 않도록 합니다. 요청에 도메인만 있고 사용할 수 있는 대상 IP가 없다면 규칙이 건너뛰어질 수 있습니다.
도메인 요청을 주소 기반 규칙으로 판단하려면 일반적으로 사용할 수 있는 대상 IP 정보가 필요합니다. DNS에 문제가 있으면 이후 IP 판정이 예상대로 이뤄지지 않을 수 있으므로, 매칭되지 않는 모든 사례를 GEOIP 데이터 오류로 단정하면 안 됩니다. 같은 도메인이라도 CDN 사용 여부, DNS 응답, 주소 계열에 따라 실제 대상 IP가 달라질 수 있습니다.
5. 위에서 아래로 매칭: FINAL은 반드시 마지막에 배치
일반 규칙 체인은 요청을 위에서 아래로 확인하며, 처음 매칭된 규칙의 정책을 적용하고 이후 규칙은 확인하지 않습니다. 정확한 규칙이 우선 적용되는 이유는 사용자가 앞에 배치했기 때문이지, 소프트웨어가 정확도에 따라 자동으로 재정렬하기 때문이 아닙니다.
- 우선 처리해야 하는 정확한 도메인, 단일 IP, 명확한 차단 규칙을 먼저 배치합니다.
- 그다음 도메인 접미사, 범위를 확인한 키워드, 대상 네트워크 대역을 배치합니다.
- 이후 GEOIP 등 범위가 넓은 조건을 배치합니다. 다른 규칙과의 순서는 실제 요구 사항에 맞춰 정하세요.
- 마지막에 FINAL을 하나 두어 나머지 요청의 처리 방식을 지정합니다.
FINAL은 도메인이나 IP를 추가로 확인하지 않습니다. 따라서 FINAL,PROXY를 맨 앞에 쓰면 뒤에 있는 일반 규칙은 매칭될 기회가 없습니다. FINAL은 ‘오류가 나면 다시 시도’하는 규칙이 아닙니다. 앞선 규칙에 매칭된 연결이 실패해도 FINAL로 넘어가 다른 경로를 선택하지 않습니다.
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
이 예시에서는 api.example.com은 PROXY, www.example.com은 DIRECT로 처리하고, tracking이 포함된 나머지 도메인은 REJECT합니다. 도메인 규칙에 먼저 매칭된 요청은 대상 IP가 GEOIP에도 해당하더라도 다른 정책으로 바뀌지 않습니다. 마지막까지 매칭되지 않은 요청에만 FINAL이 적용됩니다.
6. 규칙이 적용되지 않을 때: 설정·매칭·아웃바운드 순서로 확인하기
수정하기 전에 현재 설정의 사본을 저장하세요. 수정 후 Config에서 선택된 파일을 확인하고, Home으로 돌아가 Global Routing이 Config인지 확인한 다음 새 테스트 연결을 만드세요. 기존에 열려 있는 연결은 이전 상태를 유지할 수 있으므로, 연결을 계속 유지하는 페이지를 새로고침하는 것만으로 규칙이 적용되지 않는다고 판단하지 마세요.
- 파일 확인: 같은 이름의 백업 파일이 아니라 현재 사용하는 설정을 수정했는지 확인하세요. 원격 설정을 업데이트한 후에는 수동 수정 사항이 유지됐는지도 다시 확인합니다.
- 문법 확인: 영문 쉼표, 규칙 섹션, 정책 이름을 확인하세요. 특히 현재 설정에 PROXY가 실제로 등록되어 있는지 확인합니다.
- 대상 확인: 요청 기록에서 실제 도메인이나 IP를 확인하세요. 한 페이지가 로그인, 이미지, API 도메인에 동시에 요청을 보내는 경우가 많으므로 브라우저 주소창에는 그중 하나만 표시됩니다.
- 매칭 확인: 기록에 표시된 정책과 규칙 정보를 확인하고, 앞에 배치된 DOMAIN-SUFFIX, GEOIP 또는 FINAL이 먼저 매칭되지 않았는지 살펴보세요.
- 아웃바운드 확인: 예상한 정책에 매칭된 뒤에도 실패한다면 DNS, 대상 포트, 기존 서비스의 연결 설정을 확인하세요. 도메인 규칙의 범위를 계속 넓히지는 마세요.
오류: Connection refused
원인 및 해결: 대상 또는 중간 장치가 연결을 거부했을 수 있으며, 규칙 문법 오류라는 뜻은 아닙니다. 먼저 기록에서 실제 적용된 정책을 확인한 뒤 대상 주소, 대기 중인 포트, 기존 아웃바운드 설정을 점검하세요. 로컬 네트워크 서비스라면 해당 포트의 서비스가 실행 중인지도 확인합니다.
오류: Connection timed out
원인 및 해결: 제한 시간 안에 연결이 완료되지 않았으며 네트워크 경로, 대상에 대한 접근성, 아웃바운드 오류 등이 원인일 수 있습니다. 먼저 적용된 정책을 확인한 다음 같은 네트워크에서 기존 서비스의 연결 상태를 점검하세요. 시간 초과를 DOMAIN-SUFFIX 작성 오류로 바로 단정하지 마세요.
위 오류 문구는 연결 단계에서 나타날 수 있는 메시지이며, 연결에 실패할 때마다 반드시 표시되는 고정 문구는 아닙니다. REJECT에 매칭되어 요청이 차단됐다면 먼저 의도한 차단인지 확인하세요. 잘못 차단된 경우에는 범위가 더 좁은 예외를 추가해 차단 규칙보다 앞에 배치하세요. 모든 트래픽을 DIRECT로 바꾸면 안 됩니다.
7. 자주 묻는 질문과 수정 후 확인 사항
DOMAIN-SUFFIX를 추가했는데 특정 하위 도메인이 여전히 프록시로 연결되는 이유는 무엇인가요?
먼저 Home에서 Global Routing이 Config인지 확인한 다음 Config에서 현재 파일을 확인하세요. 이어 해당 하위 도메인이 앞에 배치된 DOMAIN 또는 다른 규칙에 먼저 매칭됐는지 살펴보고, 기록에 표시된 실제 요청 도메인이 해당 접미사에 속하는지도 확인합니다.
FINAL에는 DIRECT와 PROXY 중 무엇을 써야 하나요?
분류되지 않은 트래픽을 어디로 보낼지에 따라 다릅니다. 나머지 트래픽을 기존 프록시 정책으로 보내려면 FINAL,PROXY를 사용하고, 직접 연결하려면 FINAL,DIRECT를 사용하세요. 첫 번째 방식은 PROXY가 등록되어 있고 사용할 수 있는지 확인해야 합니다. 두 규칙 모두 마지막에 배치하세요.
구독을 업데이트하면 직접 작성한 규칙이 사라지나요?
먼저 어떤 항목을 업데이트하는지 구분하세요. 아웃바운드 구독 업데이트와 원격 설정 업데이트는 다릅니다. 원격 설정 전체를 다시 가져오면 로컬 수정 사항이 덮어써질 수 있습니다. 업데이트 전에 사본을 저장하고, 업데이트 후 Config에서 규칙 섹션과 정책 이름을 다시 확인하세요.
같은 도메인에서 443 포트만 프록시로 연결할 수 있나요?
DOMAIN과 DOMAIN-SUFFIX는 포트를 구분하지 않습니다. 도메인 뒤에 :443을 붙이는 것은 올바른 작성법이 아닙니다. 이 글의 예시는 도메인이나 주소에 따라 트래픽을 분기합니다. 포트 조건이 필요하다면 관련 규칙의 지원 여부와 문법을 별도로 확인해야 하며, 도메인 필드를 수정해서는 구현할 수 없습니다.
- 현재 설정이 선택되어 있고 Global Routing이 Config로 설정되어 있습니다.
- 도메인 규칙에는 프로토콜 접두사, 경로, 포트를 넣지 않으며 필드는 영문 쉼표로 구분합니다.
- 정확한 예외는 범위가 넓은 규칙보다 앞에, FINAL은 마지막에 배치합니다.
- 현재 설정에서 PROXY 등 정책 이름에 해당하는 항목을 찾을 수 있습니다.
- 연결을 새로 만든 뒤 실제 적용된 정책이 예상과 일치합니다.
- 복원할 수 있는 설정 사본을 저장하고 이번 변경 사항과 테스트 대상을 기록했습니다.