이 글은 Shadowrocket에서 이미 사용 중인 서비스를 가져와 Config를 편집하려는 사용자를 위한 안내입니다. 먼저 Global Routing과 규칙 정책의 차이를 확인하고, 도메인·IP 규칙과 기본 처리 규칙을 알아본 다음 간단한 규칙으로 매칭 결과를 검증합니다. 핵심은 대상 사이트 이름으로 연결 경로를 추측하는 것이 아니라, “요청이 어떤 조건에 해당하며 해당 규칙이 어떤 정책을 지정하는지” 확인하는 것입니다.
1. Global Routing이 Config를 사용하는지 확인
규칙이 작성되어 있다고 해서 현재 연결에 적용되는 것은 아닙니다. Home에서는 기존 연결과 구독을 관리하고, Config에서는 구성 파일을 관리하며, Settings에서는 앱 설정을 관리합니다. 확인을 시작하기 전에 Home에서 Global Routing을 열어 Config가 선택되어 있는지 확인하고, Config에서 현재 활성화된 파일을 확인하세요. 아래 단계는 iPhone/iPad 화면을 기준으로 설명합니다.
| Global Routing 옵션 | 확인할 내용 |
|---|---|
| Proxy | 트래픽을 전역 프록시 방식으로 처리하므로 Config의 개별 규칙에 따른 라우팅 결과를 확인하는 데 사용할 수 없습니다. |
| Direct | 트래픽을 전역 직접 연결 방식으로 처리합니다. 규칙을 수정해도 Config로 전환되는 것은 아닙니다. |
| Config | 현재 구성의 규칙에 따라 연결 정책을 결정합니다. 이 글의 규칙 테스트를 진행하려면 이 설정이 필요합니다. |
| Scene | 설정된 Scene에 따라 라우팅 동작이 전환됩니다. 문제를 확인할 때는 현재 Scene에서 실제로 적용 중인 설정을 먼저 확인하세요. |
Settings → On Demand는 조건에 따라 VPN 연결을 설정하는 기능입니다. 도메인에 DIRECT 또는 PROXY를 선택하는 규칙과는 다릅니다. 테스트할 때는 먼저 연결이 설정되었는지 확인한 다음 규칙 매칭 여부를 판단하세요. 그렇지 않으면 “터널이 연결되지 않음”을 “FINAL이 적용되지 않음”으로 오해할 수 있습니다.
2. 규칙은 유형·조건·정책으로 구성됩니다
일반적인 규칙은 영문 쉼표로 구분합니다. 보통 첫 세 항목은 규칙 유형, 매칭 조건, 실행 정책이며, 일부 규칙에는 추가 매개변수가 있습니다. FINAL은 예외로, 별도의 매칭 조건 없이 뒤에 정책을 바로 적습니다. 한글 쉼표를 사용하거나 브라우저 주소창의 전체 URL을 도메인 조건으로 그대로 넣지 마세요.
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY
여기서 [Rule]은 구성 파일의 규칙 섹션을 뜻합니다. 현재 파일에 이미 해당 섹션이 있다면 규칙을 기존 섹션에 추가하세요. 파일 끝에 같은 이름의 섹션을 계속 만들지 마세요. 위 내용은 규칙 예시이며 전체 구성 파일의 다른 설정은 포함하지 않습니다. 프록시 연결도 자동으로 생성되지 않습니다.
DIRECT: 프록시를 거치지 않고 대상에 직접 연결합니다.PROXY: 프록시를 통해 연결합니다. Home에 사용할 수 있는 연결이 있고 적절한 연결이 선택되어 있어야 합니다.REJECT: 매칭된 연결을 차단합니다. 차단이 필요한 대상에만 사용하세요.- 사용자 지정 정책 이름은 현재 구성에 이미 정의된 정책 또는 정책 그룹 이름과 일치해야 합니다. 규칙 끝에 새 이름을 임의로 적어도 사용할 수 없습니다.
3. DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD의 매칭 범위
도메인 규칙은 대상 호스트명을 확인하며 URL 경로나 쿼리 매개변수는 확인하지 않습니다. 예를 들어 https://api.example.com:443/v1/status에 접속할 때 도메인 조건에는 api.example.com만 적습니다. https://, 포트 443, /v1/status는 포함하지 않습니다. 포트는 이 세 가지 도메인 규칙의 매칭 조건이 아닙니다.
| 규칙 예시 | 매칭 범위 | 예시와 경계 |
|---|---|---|
DOMAIN,api.example.com,PROXY | 호스트명 api.example.com 전체와 일치합니다. | www.example.com 및 x.api.example.com과는 일치하지 않습니다. |
DOMAIN-SUFFIX,example.com,PROXY | example.com 자체와 그 하위 도메인에 일치합니다. | api.example.com과 일치하지만 notexample.com과는 일치하지 않습니다. |
DOMAIN-KEYWORD,example,PROXY | 호스트명에 example이라는 문자열이 포함되어 있는지 확인합니다. | notexample.com과 일치할 수도 있습니다. 접미사 규칙보다 범위가 넓습니다. |
기본 도메인과 모든 하위 도메인을 대상으로 하려면 보통 DOMAIN-SUFFIX를 사용하면 됩니다. *.example.com을 적을 필요는 없습니다. 별표는 여기서 하위 도메인 범위를 지정하는 데 필요한 문법이 아닙니다. 특정 API 호스트에만 예외를 적용하려면 DOMAIN을 먼저 쓰고, 적용 범위가 더 넓은 DOMAIN-SUFFIX를 뒤에 배치하세요.
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
이 순서에서는 api.example.com이 첫 번째 규칙에 먼저 매칭되어 PROXY를 사용합니다. www.example.com은 첫 번째 규칙에 매칭되지 않으므로 두 번째 규칙에 매칭되어 DIRECT를 사용합니다. 두 번째 규칙을 맨 앞에 두면 api.example.com도 먼저 DIRECT에 매칭되어 이후의 정확한 규칙으로 정책을 바꿀 수 없습니다.
4. IP-CIDR, GEOIP, no-resolve의 역할
IP-CIDR은 주소가 속한 네트워크 대역을 기준으로 매칭하고, GEOIP는 IP 위치 데이터베이스에 기록된 지역 정보를 기준으로 매칭합니다. 이 규칙들은 IP 정보를 처리하며 웹페이지 언어, 계정 지역, 도메인 등록 지역을 판단하지 않습니다. 하나의 도메인이 여러 주소로 해석되거나 여러 지역의 콘텐츠 전송 노드를 사용할 수 있으므로 GEOIP 결과를 사이트의 실제 소재지와 동일시할 수 없습니다.
[Rule]
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
192.168.0.0/16은 192.168.0.0부터 192.168.255.255까지를 나타내며, 일반적으로 로컬 네트워크에서 사용됩니다. 모든 사설 주소 대역을 뜻하는 것은 아닙니다.10.0.0.0/8은 10.0.0.0부터 10.255.255.255까지를 나타냅니다. 실제 네트워크에서 다른 대역을 사용한다면 해당 주소를 추가해야 합니다. 두 규칙이 모든 내부 네트워크를 처리한다고 가정하지 마세요.GEOIP,CN,DIRECT는 데이터베이스에서 CN으로 판정된 대상 IP에 DIRECT를 적용한다는 뜻입니다. 데이터베이스상 지역 정보와 실제 연결 가능 여부는 별개의 문제입니다.no-resolve는 이 IP 규칙을 매칭하기 위해 별도로 도메인 해석을 요청하지 않는다는 뜻입니다. DNS를 끄거나 이미 확인된 IP의 매칭을 막는 옵션은 아닙니다.
대상이 도메인이고 해당 판단에 사용할 IP가 아직 없는 경우, no-resolve가 붙은 IP 규칙은 자체 매칭을 위해 추가 해석을 요청하지 않습니다. 따라서 “도메인이 나중에 내부 IP로 해석됨”과 “no-resolve 규칙이 먼저 매칭됨”은 같은 의미가 아닙니다. 이미 알고 있는 내부 도메인을 안정적으로 처리하려면 IP 규칙보다 앞에 DOMAIN 또는 DOMAIN-SUFFIX 조건을 명시하세요.
5. 위에서부터 첫 매칭 규칙을 적용하고 FINAL은 마지막에 배치
Config의 일반적인 규칙 처리에서는 규칙을 순서대로 확인하고, 처음 매칭된 규칙이 정책을 결정합니다. 목록에서 더 정확한 규칙이 자동으로 우선된다고 생각하지 마세요. DOMAIN은 DOMAIN-SUFFIX보다 정확하더라도 앞에 적힌 접미사 규칙을 건너뛰지 않습니다. 규칙 순서는 구성 작성자가 명시적으로 정해야 합니다.
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-SUFFIX,blocked.example.net,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
이 예시는 정확한 예외, 도메인 범위, 명시적 차단 대상, 로컬 네트워크 주소, 지역 IP, 최종 기본 처리 순서로 구성되어 있습니다. 순서를 설명하기 위한 예시일 뿐 모든 네트워크에 적합한 권장 구성은 아닙니다. 기존 서비스나 로컬 리소스에 다른 정책이 필요하다면 조건을 유지하고 규칙 간 적용 범위를 하나씩 확인하세요.
| 테스트 대상 | 예상 매칭 규칙 | 결과 설명 |
|---|---|---|
| api.example.com | 첫 번째 DOMAIN 규칙 | PROXY. 이후의 example.com 접미사 규칙은 확인하지 않습니다. |
| www.example.com | 두 번째 DOMAIN-SUFFIX 규칙 | DIRECT. GEOIP 규칙이 판단할 때까지 기다릴 필요가 없습니다. |
| blocked.example.net | 세 번째 DOMAIN-SUFFIX 규칙 | REJECT. 이 경우 연결 차단은 규칙의 의도에 부합합니다. |
| 192.168.1.20 | 네 번째 IP-CIDR 규칙 | DIRECT. 대상이 해당 대역의 IP 주소입니다. |
| 앞선 규칙에 매칭되지 않은 대상 | FINAL | PROXY. 앞선 규칙에 문제가 있다는 뜻은 아닙니다. |
FINAL은 규칙 목록의 맨 마지막에 배치해야 합니다. 앞쪽에 두면 뒤의 규칙은 정상적으로 매칭될 기회가 없습니다. 기존 구성을 수정할 때는 이미 있는 FINAL을 찾아 새 규칙을 그 앞에 넣으세요. 규칙 유형마다 FINAL을 추가할 필요는 없습니다.
6. 최소한의 변경으로 규칙 적용 여부 확인
DNS, 연결 매개변수, 정책 그룹, 여러 규칙을 한꺼번에 수정하지 마세요. 문제가 생겼을 때 원인을 찾기 어려워집니다. 먼저 기존 구성의 사본을 보관한 뒤 알아보기 쉬운 도메인 규칙 하나만 추가하세요. 규칙은 연결에 사용할 정책을 결정합니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등의 연결 매개변수는 기존 서비스 구성에 따라 결정되며, 규칙을 수정해 누락된 매개변수를 보완할 수는 없습니다.
-
현재 구성 백업
Config로 이동해 현재 구성의 사본을 보관하거나 내보내 백업한 다음, 사용 중인 파일을 편집하세요. [Rule]만 포함된 예시를 전체 구성 파일인 것처럼 기존 파일에 덮어쓰지 마세요.
-
규칙 하나 추가
[Rule] 안에서 기존 FINAL 앞에 대상 규칙을 추가하세요. 호스트 하나를 테스트한다면 DOMAIN을 사용하고 조건에는 호스트명만 적습니다. 앞쪽에 같은 도메인에 먼저 적용되는 규칙이 있는지도 확인하세요.
-
현재 라우팅 모드 확인
저장한 뒤 Config에서 해당 파일이 활성화되어 있는지 확인하고 Home → Global Routing → Config로 이동하세요. 이전에 Scene을 사용했다면 Scene의 자동 전환이 영향을 주지 않도록 한 뒤 한 번 테스트하세요.
-
새 연결 설정
대상 페이지나 앱을 닫고 다시 열어 접속하세요. 필요하면 VPN 연결을 끊었다가 다시 연결합니다. 기존 장시간 연결에는 연결 당시의 정책이 계속 적용될 수 있으므로 같은 페이지를 새로 고치는 것만으로 모든 규칙이 다시 매칭되었는지 판단할 수 없습니다.
-
연결 기록 확인
연결 기록에서 대상 호스트, 대상 IP, 매칭된 규칙, 최종 정책을 함께 확인하세요. 먼저 예상한 규칙에 매칭되었는지 확인한 다음 선택한 연결로 대상에 접속할 수 있는지 살펴보세요. 웹페이지가 열리는지만으로 판단하지 마세요.
Home에서 Subscribe를 업데이트하면 주로 기존 구독에서 제공하는 연결 정보가 갱신됩니다. 현재 Config의 규칙이 방금 작성한 내용으로 자동 변경되는 것은 아닙니다. 반대로 원격 구성을 다시 다운로드하면 구성 텍스트가 교체될 수 있습니다. 편집하기 전에 구독, 원격 구성, 로컬 구성 사본 중 무엇을 다루고 있는지 구분하세요.
7. 연결 오류와 규칙 문제 구분하기
아래 문구는 연결 로그에 표시될 수 있는 네트워크 오류 원문이며, 규칙 파서가 항상 표시하는 고정 메시지는 아닙니다. 먼저 기록에 나타난 최종 정책을 확인하세요. REJECT에 매칭된 경우, 프록시 서비스 연결에 실패한 경우, 대상 서버가 연결을 거부한 경우는 각각 해결 방법이 다릅니다. 오류 메시지만으로 DOMAIN-SUFFIX 작성이 잘못되었다고 단정할 수 없습니다.
오류: Connection refused
원인 및 해결 방법: 상대측에서 연결을 거부한 상태입니다. 해당 주소의 포트에서 서비스를 수신 대기하지 않을 때 흔히 발생합니다. 기록을 확인해 프록시 서버와 대상 서버 중 어느 쪽에서 거부했는지 확인한 다음, 사용 중인 서비스의 주소와 포트를 점검하세요. 도메인 규칙을 GEOIP로 바꿔도 잘못된 포트는 해결되지 않습니다.
오류: Operation timed out
원인 및 해결 방법: 제한 시간 안에 연결이 완료되지 않은 상태입니다. 선택한 아웃바운드, 대상 서비스 또는 현재 네트워크가 원인일 수 있습니다. 먼저 매칭된 정책을 확인한 다음 같은 대상과 네트워크 조건에서 한 번에 변수 하나만 바꿔 테스트하세요. 규칙 전체의 순서를 한꺼번에 바꾸지 마세요.
DOMAIN을 작성했는데 하위 도메인에는 왜 적용되지 않나요?
DOMAIN은 호스트명 전체와 정확히 일치하는 경우에만 매칭됩니다. example.com과 api.example.com을 모두 대상으로 하려면 DOMAIN-SUFFIX,example.com,PROXY를 사용하세요. 앞쪽에 먼저 매칭되는 규칙이 있는지도 확인하세요.
규칙을 맨 아래에 넣었는데 왜 적용되지 않나요?
현재 Config의 [Rule]을 열고 FINAL을 찾으세요. 적용하려는 규칙을 FINAL 앞에 옮긴 다음, 더 앞에 있는 DOMAIN-SUFFIX 또는 DOMAIN-KEYWORD가 같은 대상을 이미 포함하는지 확인하세요.
Proxy로 전환하면 접속되는데 규칙이 잘못된 건가요?
두 라우팅 모드에서 아웃바운드 결과가 다르다는 점만 알 수 있습니다. Home → Global Routing → Config로 돌아가 대상이 DIRECT 또는 REJECT에 매칭되었는지 확인하세요. 잘못된 조건에 매칭되었다면 해당 조건이나 규칙 순서를 조정하세요. 직접 연결 규칙을 모두 삭제하지는 마세요.
구독을 업데이트했는데 규칙은 왜 바뀌지 않나요?
먼저 Home의 Subscribe와 Config의 구성 파일을 구분하세요. Config로 돌아가 활성화된 파일과 [Rule] 내용을 확인합니다. 연결 구독 업데이트가 규칙 파일 업데이트를 뜻하는 것은 아니며, 전역 라우팅 모드를 Config로 자동 전환하지도 않습니다.