공식 매뉴얼 / CONFIG
Shadowrocket 규칙 매뉴얼
이 페이지에서는 설정 구간, 규칙 유형, 매칭 결과를 확인할 수 있습니다. 아직 서버 정보를 가져오지 않았거나 첫 연결을 설정하지 않았다면 먼저 사용 안내를 따라 기본 설정을 마친 후 돌아와 규칙을 조정하세요. 설치, 앱 스토어 계정 또는 기기 변경 관련 내용은 앱 다운로드 및 자주 묻는 질문을 확인하세요.
iPhone / iPad 버전은 App Store에서 다운로드할 수 있으며, 미국 스토어 기준 $2.99의 일회성 결제가 필요합니다. 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료이며, 설치 파일은 사이트의 /dl/shadowrocket/에서 제공합니다. 앱의 일회성 구매는 회선 요금제와 별개입니다. 이 안내는 이미 서버나 구독을 보유한 사용자를 대상으로 합니다. 이 사이트는 연결 서비스를 제공하거나 판매하거나 추천하지 않습니다.
설정 파일 구조: General, Rule, Host, URL Rewrite
먼저 세 가지를 구분하세요. 활성 설정은 클라이언트가 사용할 파일을 결정하고, 파일 구간은 각 행의 기능을 구분하며, [Rule]의 순서는 검사할 규칙을 결정합니다. 파일이 Config 목록에 있다는 것은 선택할 수 있다는 뜻일 뿐, 현재 사용 중이라는 뜻은 아닙니다. Home에서 Global Routing이 Config로 설정되어 있는지 확인한 다음, Config에서 현재 사용 중인 파일을 확인하세요. 수정 전에는 되돌릴 수 있는 사본을 보관하세요. 특히 원격으로 관리되는 설정을 로컬 작업 파일로 바로 수정하지 마세요.
General: DNS 기준 설정하기
[General]
bypass-system = true
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[General]에는 키와 값 형식을 사용합니다. 여기서는 dns-server = system으로 시스템 DNS를 기준으로 테스트합니다. DNS 서버 변경과 규칙 분기를 한 번에 바꾸지 마세요. bypass-system은 시스템 트래픽 우회 설정과 관련이 있으므로 특정 도메인의 DIRECT 규칙을 대신할 수 없습니다. 또한 규칙 매칭 기록 하나만으로 모든 시스템 트래픽이 클라이언트를 통과한다고 판단할 수 없습니다. 사용자 지정 DNS 또는 DoH를 비교할 때는 활성 설정, 테스트 대상, 네트워크를 그대로 유지하세요. 자세한 내용은 DNS 설정 자세히 보기를 확인하세요.
Rule: 조건, 대상, 동작을 한 행에 작성
DOMAIN-SUFFIX,example.com,PROXY는 규칙 유형, 매칭 대상, 적용할 정책의 세 부분으로 구성됩니다. FINAL,DIRECT에는 대상 필드가 없습니다. 도메인 필드에 URL, 프로토콜 접두사 또는 설명 문구를 넣지 마세요. 직접 편집할 때는 반각 쉼표, 대괄호, 등호를 사용하고, 서식이 있는 문서에서 복사해 전각 문장부호가 섞이지 않도록 주의하세요. 위 예시에는 서버 정보가 없습니다. PROXY를 테스트하려면 먼저 Home에서 사용 가능한 자신의 서버를 선택하세요. 예시 도메인은 규칙 범위를 설명하기 위한 것으로, 실제 환경에서 연결 가능한 대상임을 보장하지 않습니다.
Host 및 URL Rewrite: 주소 매핑과 요청 변경의 범위
[Host]
dev.example.com = 192.0.2.10
[URL Rewrite]
^http://old\.example\.com/guide$ http://new.example.com/guide 302
[Host] 예시는 지정한 이름을 문서 예시 주소에 연결합니다. 자신의 환경에 적용할 때는 해당 주소에 연결할 수 있는지, 그 주소에서 서비스에 접속할 수 있는지, 기존 호스트 이름이 서버 인증서 및 가상 호스트 설정과 일치하는지 먼저 확인하세요. 주소 매핑은 요청의 호스트 이름을 바꾸는 것이 아니며, 직접 연결을 설정하는 것도 아닙니다. 매핑을 추가한 뒤에만 문제가 생긴다면 먼저 매핑을 제거하고 다시 테스트하세요. DNS와 정책을 동시에 바꿀 필요는 없습니다.
[URL Rewrite] 예시는 지정한 HTTP 경로만 매칭해 다른 주소로 302 리디렉션합니다. 이전 도메인의 모든 연결을 프록시로 보내는 기능이 아닙니다. 정규식에서 마침표는 이스케이프해야 하며, 끝의 $는 문자열의 끝까지 매칭하도록 제한하므로 쿼리 매개변수가 추가된 요청에는 이 예시가 적용되지 않습니다. 암호화된 연결의 경로를 기본적으로 확인할 수 있는 것은 아닙니다. 이 예시를 임의의 HTTPS 요청을 변경할 수 있다는 의미로 해석하지 마세요. 직접 관리하는 서비스에서 테스트하고, 원래 주소와 리디렉션된 주소를 모두 확인하세요.
가져오기 오류가 발생하면 구간 제목의 닫는 대괄호가 있는지, 규칙 행이 올바른 구간에 있는지, 채팅 메시지에서 복사할 때 코드 블록 표시가 함께 들어갔는지 확인하세요. 가져오기는 되지만 동작이 예상과 다르다면 활성 파일과 실제 매칭 대상을 확인하세요. 형식과 동작을 따로 점검하면 파일이 라우팅에 사용되지 않는 상태에서 규칙 순서만 반복해서 수정하는 일을 피할 수 있습니다.
도메인 규칙: 정확 일치, 접미사 일치, 키워드 일치
요청에 사용되는 호스트 이름을 알고 있다면 범위가 가장 명확한 도메인 규칙부터 작성하세요. 규칙은 연결 대상에 따라 선택하며, 웹페이지 제목이나 앱 이름, 화면에 표시된 버튼 문구에 따라 선택하는 것이 아닙니다. 예를 들어 브라우저로 페이지를 열 때 기본 문서, 이미지, API, 로그인 콜백이 각각 다른 호스트에 연결될 수 있습니다. 규칙은 조건에 맞는 연결에만 적용되며, 같은 앱의 모든 요청을 자동으로 같은 정책에 묶지 않습니다.
| 규칙 | 매칭 대상 | 적합한 범위 |
|---|---|---|
DOMAIN | 전체 호스트 이름 | 단일 API, 게이트웨이 또는 예외 호스트 |
DOMAIN-SUFFIX | 지정 도메인 및 하위 도메인 | 같은 정책으로 처리할 호스트 그룹 |
DOMAIN-KEYWORD | 호스트 이름 내 키워드 | 오매칭 범위를 검토한 이름 패턴 |
DOMAIN: 알려진 호스트에 예외 규칙 추가
[Rule]
DOMAIN,auth.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
첫 번째 규칙은 auth.example.com에만 매칭됩니다. 서비스에 api.auth.example.com도 있다면 이 호스트는 직접 연결되지 않고 다음 규칙을 계속 검사합니다. 이 방식은 로그인 게이트웨이를 같은 도메인의 프록시 범위에서 제외할 때 유용하지만, 호스트 이름에 auth가 들어간다고 해서 모든 인증 요청이 포함되는 것은 아닙니다. 로그인 페이지 열기, 요청 제출, 로그인 후 서비스 페이지로 돌아가는 과정을 각각 테스트하세요. 한 단계에서만 문제가 생기면 해당 단계에서 실제로 연결된 대상을 확인하고, 한 호스트의 문제를 해결하려고 도메인 전체의 정책을 바꾸지 마세요.
DOMAIN-SUFFIX: 도메인과 하위 도메인에 적용
DOMAIN-SUFFIX,example.com,PROXY는 example.com과 img.example.com에 적용되지만, notexample.com이나 example.com.example.net은 같은 도메인에 포함되지 않습니다. API 도메인에만 적용하려면 주 도메인 전체를 포함한 뒤 예외를 여러 개 추가하는 대신 DOMAIN-SUFFIX,api.example.com,PROXY를 사용하세요. 필드에는 도메인만 입력하고 https://, 와일드카드 접두사, 포트, 슬래시 또는 경로는 넣지 마세요. 도메인 규칙은 “어떤 호스트에 연결하는가”를 다루며 “그 호스트의 어떤 페이지에 접속하는가”를 다루지 않습니다.
앱 문제에서 규칙을 추적할 때는 대상이 전체 호스트 이름인지, 리디렉션 전 주소인지 먼저 확인하세요. 사용자에게 보이는 URL이 최종 연결 호스트와 같지 않을 수 있습니다. 별칭 해석만으로 해석 과정에 있는 다른 이름의 규칙이 적용된다고 단정할 수도 없습니다. 클라이언트가 실제로 인식한 대상과 확인 가능한 매칭 정보를 기준으로 판단하세요. 요청이 주소를 직접 사용하거나 연결에서 사용할 수 있는 도메인 정보를 제공하지 않으면 도메인 규칙이 매칭되지 않을 수 있습니다. 이때는 주소 규칙을 확인하고, 키워드 규칙을 추측해서 추가하지 마세요.
DOMAIN-KEYWORD: 오매칭 사례도 함께 테스트
[Rule]
DOMAIN,media-admin.example.com,DIRECT
DOMAIN-KEYWORD,media,PROXY
FINAL,DIRECT
키워드 규칙은 조직이나 도메인 경계를 구분하지 않습니다. 위 예시는 media.example.com뿐 아니라 multimedia.example.net에도 매칭될 수 있습니다. URL 경로에서 media를 찾거나 페이지 내용을 기준으로 분류하지도 않습니다. 대상이 알려진 도메인 하나에 한정된다면 넓은 키워드 규칙을 여러 개 추가하기보다 접미사 규칙으로 범위를 제한하는 편이 검토하기 쉽습니다. 키워드가 꼭 필요하다면 예상대로 매칭되어야 하는 대상, 매칭되지 않아야 하는 대상, 우선 예외 처리할 호스트를 먼저 정리한 뒤 세 그룹으로 확인하세요.
문제 해결을 위해 키워드 규칙의 정책을 임시로 바꾸는 것은 첫 번째 테스트로 적합하지 않은 경우가 많습니다. 범위가 넓어 여러 요청이 함께 바뀌므로 어떤 결과가 페이지 복구에 영향을 줬는지 파악하기 어렵습니다. 먼저 설정 사본에 단일 대상용 DOMAIN 규칙을 추가해 해당 대상의 라우팅 차이를 확인한 다음, 접미사 또는 키워드 규칙으로 범위를 넓힐지 결정하세요. 임시 규칙을 제거한 뒤 다시 테스트해야 최종 설정이 디버깅용 예외 규칙에 의존하지 않는지 확인할 수 있습니다.
IP 주소 및 요청 규칙: IP-CIDR, IP-CIDR6, GEOIP, USER-AGENT
도메인 규칙은 이름을 기준으로, 주소 규칙은 대상 IP 주소를 기준으로 분류하므로 결과가 다를 수 있습니다. 같은 이름도 네트워크나 DNS에 따라 다른 주소를 받을 수 있고, 같은 주소가 여러 이름의 서비스에 사용될 수도 있습니다. 서비스 이름에 따라 대상을 구분해야 한다면 도메인 규칙이 대체로 관리하기 쉽고, 명확한 로컬 네트워크 대역이나 고정 주소를 대상으로 한다면 접두사 규칙이 더 직접적입니다. “도메인 규칙을 수정했는데도 다른 경로로 연결된다면” 해당 연결이 원래 이름, IPv4 주소, IPv6 주소 중 무엇을 사용했는지 확인한 다음 규칙 순서를 살펴보세요.
IP-CIDR 및 IP-CIDR6: 접두사 길이로 범위 지정
[Rule]
IP-CIDR,192.168.50.0/24,DIRECT
IP-CIDR,192.168.0.0/16,PROXY
IP-CIDR6,2001:db8:20::/48,DIRECT
FINAL,DIRECT
/24는 IPv4 주소의 앞 24비트를 고정하고, /16은 앞 16비트를 고정합니다. 예시에서는 겹치는 범위에서 예외를 적용하는 방법을 보여 주기 위해 좁은 네트워크 대역을 넓은 대역보다 앞에 둡니다. 다른 사설 네트워크 대역 전체를 프록시로 보내라는 의미는 아닙니다. 두 번째 행을 첫 번째 행보다 앞에 두면 192.168.50.8은 넓은 대역에 먼저 매칭되어 /24가 더 구체적이라는 이유로 정책이 다시 적용되지 않습니다. IPv4 주소 하나만 매칭하려면 /32, IPv6 주소 하나만 매칭하려면 /128을 사용하세요.
IP-CIDR6은 IPv6 접두사를 처리합니다. 위 예시는 문서용 테스트 대역을 사용하므로 실제 서비스 주소로 복사하지 마세요. 듀얼 스택 네트워크에서는 첫 번째 테스트가 IPv4를 사용하고 다음 테스트는 IPv6를 사용할 수 있으므로, IPv4 매칭만으로 두 경로의 정책이 같다고 판단할 수 없습니다. 로컬 네트워크 장치를 대상으로 한다면 먼저 장치 관리 페이지나 네트워크 설정에서 대역을 확인하고, 같은 네트워크에서 주소에 연결할 수 있는지 테스트하세요. DIRECT는 프록시를 거치지 않고 연결한다는 뜻일 뿐, 현재 네트워크에 대상 대역으로 가는 경로를 추가하지 않습니다.
이름으로 지정한 대상에 IP 조건을 적용할 경우 DNS 해석이 필요할 수 있습니다. 해당 옵션을 지원하는 것으로 확인된 주소 규칙에는 IP-CIDR,192.168.50.0/24,DIRECT,no-resolve를 사용해 해당 규칙을 위해 이름을 직접 해석하지 않도록 할 수 있습니다. 이는 전역 DNS 설정이 아니며 다른 처리 단계의 해석을 막지도 않습니다. 이 옵션을 적용한 뒤 주소를 직접 입력하면 매칭되지만 이름으로는 매칭되지 않는다고 해서 규칙이 잘못됐다고 바로 판단하지 마세요. 먼저 두 입력 방식에서 조건을 평가할 수 있는 대상 정보가 충분한지 비교하세요.
GEOIP: IP 데이터베이스 분류는 서비스 소속을 증명하지 않음
[Rule]
DOMAIN,api.example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
GEOIP,CN,DIRECT는 대상 IP를 IP 데이터베이스로 분류합니다. 언어, 최상위 도메인, 기기의 위치 또는 계정의 스토어 지역을 기준으로 하지 않습니다. 공유 인프라나 가까운 접속 지점을 사용하는 서비스는 네트워크가 바뀌면 같은 도메인에서도 다른 IP 주소를 받을 수 있고, 그 결과 다른 정책이 적용될 수 있습니다. 지정된 경로를 안정적으로 사용해야 하는 자체 서비스라면 지역 규칙보다 앞에 도메인 예외를 추가하세요. 서비스의 용도를 지역 조건에 맡기지 마세요. 문제를 확인할 때는 당시 사용된 대상 IP를 기록하세요. “이 도메인은 어제 직접 연결됐다”는 기록만으로는 충분하지 않습니다.
USER-AGENT: 요청 식별 정보를 사용할 수 있을 때만 매칭
[Rule]
USER-AGENT,ExampleDesktop*,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
USER-AGENT는 확인 가능한 요청 식별 정보에 매칭하는 규칙이며, 프로세스 이름이나 시스템 권한, 연결을 시작한 앱의 신원을 판별하지 않습니다. 요청 두 개가 같은 식별 정보를 보낼 수도 있고, 같은 앱이 기능에 따라 서로 다른 식별 정보를 보낼 수도 있습니다. 요청에 이 필드가 없거나 확인할 수 없거나, 연결이 HTTP를 사용하지 않는다면 규칙이 매칭될 것으로 기대하지 마세요. 이 예시는 정해진 식별 정보를 자체 테스트 환경에서 확인할 때만 적합합니다. 특정 서비스가 항상 같은 정책을 사용해야 한다면 독립적으로 확인할 수 있는 도메인이나 주소를 우선 선택하세요.
정책 및 라우팅: PROXY, DIRECT, REJECT의 동작
Global Routing과 규칙의 정책은 서로 다른 단계입니다. 전자는 클라이언트로 들어오는 연결을 처리할 방식을 선택하고, 후자는 Config 상태에서 특정 규칙이 선택하는 처리 결과입니다. 규칙 파일을 테스트하면서 Home의 Global Routing이 Proxy 또는 Direct로 설정되어 있다면, 관찰한 연결 경로로 해당 파일의 규칙 순서를 판단할 수 없습니다. 문제를 확인하기 전에 현재 상태를 기록하고, 같은 요청을 반복해 비교하세요.
| 모드 | 처리 방식 | 확인할 수 있는 사항 |
|---|---|---|
| Config(설정) | 활성 설정에 따라 규칙 분기 | 규칙 조건, 순서 및 기본 정책 |
| Proxy(프록시) | 해당 연결에 프록시 경로 사용 | 선택한 서버로 같은 대상에 연결할 수 있는지 |
| Direct(직접 연결) | 해당 연결에 직접 연결 경로 사용 | 현재 네트워크에서 같은 대상에 직접 연결할 수 있는지 |
PROXY: 규칙 매칭과 서버 연결을 따로 확인
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,local.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
PROXY는 조건에 맞는 연결을 프록시 경로로 보낸다는 뜻입니다. 서버를 자동으로 생성하거나 구독이 여전히 사용 가능한지 확인하지 않습니다. PROXY에 매칭된 뒤에도 서버에 연결할 수 없거나, 인증 정보가 맞지 않거나, 대상 서비스에 문제가 있거나, 앱에서 시간 초과가 발생하면 연결에 실패할 수 있습니다. 이미 보유한 서버로 테스트하세요. 먼저 Home에서 선택 항목을 확인하고 Connectivity Test로 연결 상태를 점검하세요. 테스트 성공은 해당 테스트 조건에서 응답을 받았다는 뜻일 뿐, 모든 서비스 대상에 연결할 수 있다는 보장은 아닙니다. Config와 Proxy를 비교할 때는 같은 서버, 네트워크, 대상을 사용해야 차이를 규칙으로 인한 결과라고 판단할 수 있습니다.
DIRECT: 클라이언트를 잠시 끄는 것과 다름
DIRECT는 대상 연결이 프록시 서버를 거치지 않는다는 뜻이며, 현재 네트워크에서 대상의 DNS 해석과 연결이 가능해야 합니다. local.example.com이 직접 연결 규칙에 매칭됐는데도 열리지 않는다면 현재 기기가 해당 서비스에 접근할 수 있는 네트워크에 있는지, 예상한 주소로 해석되는지, 서비스가 연결을 받고 있는지 확인하세요. Direct로 전환하면 비교 테스트를 할 수 있지만, 클라이언트를 끈 뒤의 결과를 DIRECT 규칙과 동일하게 보면 안 됩니다. 클라이언트를 끄면 활성 설정의 처리가 적용되지 않고 DNS 설정 등의 조건도 달라질 수 있습니다.
같은 페이지에서도 기본 요청과 부가 요청이 각각 직접 연결 또는 프록시를 사용할 수 있습니다. 페이지 제목이 보이는지만 확인하지 말고, 문제가 있었던 로그인, 목록 새로고침 또는 첨부 파일 불러오기를 테스트하세요. 필요한 요청 중 하나라도 완료되지 않으면 앱에는 일반적인 연결 오류만 표시될 수 있습니다. 해당 요청의 도메인을 확인하면 전체 라우팅 모드를 바꾸는 것보다 필요한 규칙 범위를 쉽게 판단할 수 있습니다.
REJECT: 매칭되면 차단되며 다음 규칙으로 자동 재시도하지 않음
REJECT는 매칭된 요청을 차단합니다. 예시에서는 blocked.example.com을 차단하므로 정확한 조건을 접미사 프록시 규칙보다 앞에 둡니다. 이후 앱이 예비 호스트 등 다른 요청을 보내면 그 요청은 별도로 규칙을 검사합니다. 원래 요청이 REJECT에서 다음 행으로 자동 전환되는 것은 아닙니다. 앱에 로딩 실패, 즉시 오류 또는 재시도가 표시될 수 있지만, 화면에 나타난 현상만으로 차단 여부를 판단할 수는 없습니다.
도메인 규칙으로 호스트 하나를 차단하면 조건에 맞는 정상 요청도 영향을 받습니다. 대상과 정상 콘텐츠가 같은 호스트를 공유한다면 도메인만으로 두 요청을 구분할 수 없습니다. 먼저 설정 사본에서 정확한 규칙 하나로 테스트하고, 차단해야 하는 요청과 유지해야 하는 요청을 각각 확인하세요. 두 요청을 구분할 수 없다면 주 도메인 전체로 범위를 넓히지 마세요. 자세한 예시와 주의 사항은 REJECT 규칙 작성법을 확인하세요.
매칭 순서: 첫 번째 일치, 예외 및 FINAL
Config 모드에서 일반 규칙을 이해할 때는 다음 원칙을 기억하세요. 위에서 아래로 검사하며, 처음 매칭된 규칙의 정책을 적용합니다. 규칙 유형이 우선순위를 자동으로 바꾸지는 않습니다. 앞에 있는 접미사 규칙보다 정확한 도메인 규칙이 자동으로 우선하지 않으며, 더 긴 주소 접두사도 앞에 있는 넓은 네트워크 대역보다 자동으로 우선하지 않습니다. 같은 기기에서 규칙 구성이 같은 설정 파일 두 개라도 순서가 다르면 결과가 달라질 수 있습니다.
예외 규칙을 먼저, 예외 범위를 포함하는 일반 규칙은 나중에 작성
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN,unused.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
대상이 login.example.com이면 첫 번째 규칙에서 처리가 끝납니다. unused.example.com은 두 번째 규칙에, files.example.com은 세 번째 규칙에 매칭됩니다. 세 번째 규칙에 이미 매칭된 도메인이 GEOIP,CN에 해당하는 주소로 해석되더라도 뒤의 규칙이 기존 결과를 덮어쓰지 않습니다. 반대로 지역 규칙을 앞에 두면 도메인별로 처리하려던 일부 연결이 먼저 분류될 수 있습니다. 순서를 판단할 때는 결과가 우연히 같은 대상 하나만 테스트하지 말고, 겹치는 두 규칙에서 서로 다른 정책을 적용하는 대상을 찾으세요.
규칙 순서를 테스트할 때는 설정 사본을 만들고 관련 규칙 두 개만 순서를 바꾸세요. DNS, 서버 또는 마지막 정책은 변경하지 마세요. 저장한 뒤 사본이 활성 상태인지 확인하고, 예외 호스트, 일반 접미사 호스트, 두 규칙과 관련 없는 호스트를 각각 테스트하세요. 예외 호스트만 테스트하면 예외 규칙은 정상이어도 일반 규칙이 차단된 것을 놓칠 수 있습니다. 일반 호스트만 테스트하면 예외 규칙이 전혀 매칭되지 않는 문제를 발견하지 못할 수 있습니다. 매칭되지 않아야 하는 대상도 테스트하면 넓은 범위의 규칙이 관련 없는 연결에 영향을 주는지 확인할 수 있습니다.
FINAL로 매칭되지 않은 요청의 기본 처리 방식 지정
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
이 설정은 지정 도메인과 하위 도메인을 프록시로 보내고, 나머지는 직접 연결합니다. FINAL,DIRECT를 FINAL,PROXY로 바꾸면 특정 호스트 하나만 바뀌는 것이 아니라 이전에 매칭되지 않은 모든 해당 요청의 처리가 달라집니다. 설정을 작성하기 전에 “목록에 없는 대상은 어디로 연결할지”를 명확히 정한 다음 기본 정책을 선택하세요. 설정을 합칠 때는 명확한 FINAL을 하나 유지하고 맨 마지막에 배치하세요. 기존 FINAL 뒤에 추가 규칙을 붙이지 마세요.
FINAL에 매칭된 요청을 확인할 때는 기본 처리 대상이 맞는지 먼저 판단하세요. 그렇지 않다면 다른 하위 도메인인지, 주소를 직접 사용하는지, 리디렉션을 거쳤는지, 규칙 조건에 클라이언트가 얻지 못한 요청 속성이 필요한지 확인하세요. 누락된 대상에 구체적인 규칙을 추가하는 것은 매칭 범위를 수정하는 일입니다. FINAL을 바꾸는 것은 설정 전체의 기본 정책을 변경하는 일이며, 두 작업은 서로 대체할 수 없습니다.
두 규칙 집합을 합치기 전에 중복과 가림 여부 확인
합친 텍스트에서 각 구체적인 예외를 기준으로 위쪽에 해당 범위를 포함하는 규칙이 있는지 확인하세요. 같은 대상을 지정한 중복 행도 살펴봐야 합니다. 예를 들어 DOMAIN,api.example.com이 두 번 있어도 뒤의 규칙이 업데이트처럼 우선 적용되지는 않습니다. 먼저 나온 규칙이 테스트 대상입니다. 범위가 겹치는 것이 항상 잘못은 아닙니다. 좁은 범위가 넓은 범위보다 먼저 나오고 다른 정책을 적용한다면 의도한 예외입니다. 반대로 넓은 범위가 앞에 있고 정책도 같다면 뒤의 구체적인 항목은 중복일 수 있습니다. 삭제하기 전에는 해당 항목이 관리용 설명이나 예정된 예외로 쓰이는지 확인하세요.
규칙을 의도에 따라 명확한 구간으로 나누세요. 단일 호스트 예외, 도메인 접미사 분류, 주소 또는 지역 분류, 기본 정책 순으로 구성할 수 있습니다. 반드시 따라야 하는 템플릿은 아닙니다. 특정 사설 네트워크 대역을 도메인 그룹보다 우선하려는 의도가 있다면 그에 맞게 배치하고, 이름 해석에 의존하는 조건을 기록하세요. 우선순위는 외워서 푸는 문제가 아닙니다. 구체적인 대상 하나를 기준으로 어떤 규칙이 매칭되지 않는지, 어떤 규칙이 매칭되는지, 그 결과 어떤 규칙을 더 이상 검사하지 않는지 설명할 수 있어야 합니다.
자주 쓰는 조합: 목록 기반 분기, 로컬 네트워크 예외, 정확한 호스트 차단
아래 각 항목은 독립적인 참고 예시이며, 앞뒤를 이어 하나의 설정으로 붙여 넣어서는 안 됩니다. 각 예시는 기본 동작을 먼저 밝히고 예외와 확인 방법을 설명합니다. 자신의 기기에 적용할 때는 확인이 끝난 도메인과 네트워크 대역만 바꾸세요. 프록시가 필요한 경우 이미 보유한 서버를 사용하세요. 설정 파일에 [Host] 또는 [URL Rewrite]가 포함되어 있다면 조합 규칙 테스트 중에는 해당 구간을 그대로 유지하세요. 주소 매핑이나 요청 리디렉션의 변화를 규칙의 효과로 잘못 판단하지 않도록 하기 위해서입니다.
조합 1: 명시한 서비스에만 프록시 사용
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN,assets.example.net,PROXY
FINAL,DIRECT
기본적으로 직접 연결하고 프록시를 사용할 서비스가 소수인 설정에 적합합니다. 먼저 로그인 호스트가 직접 연결되는지 확인한 다음, 서비스 도메인의 하위 도메인 하나가 프록시를 사용하는지 테스트하고 다른 도메인의 독립 리소스가 어떻게 처리되는지도 확인하세요. 홈페이지가 열리는지만으로 완료 여부를 판단하지 마세요. 캐시된 콘텐츠만 표시되고 인증이나 정적 리소스는 다른 연결을 사용할 수 있습니다. 가능하면 새 세션이나 별도 세션에서 로그인 후 이전에 열지 않았던 페이지를 여는 등 전체 동작을 재현하고 기본 요청과 리소스 요청 결과를 각각 기록하세요.
리소스 도메인을 추가할 때는 같은 도메인의 다른 용도까지 프록시로 보내지 않도록 DOMAIN부터 시작하세요. 테스트 결과 하위 도메인도 같은 용도로 사용된다는 것이 확인되면 DOMAIN-SUFFIX로 범위를 넓힐 수 있습니다. 브라우저와 앱에서 같은 서비스의 결과가 다르면 실제 연결 대상과 오류가 발생한 단계를 먼저 비교하세요. 한쪽이 열린다는 이유만으로 다른 쪽에도 같은 규칙이 적용됐다고 판단할 수 없습니다.
조합 2: 알려진 로컬 네트워크 주소는 직접 연결
[Rule]
DOMAIN,printer.example.com,DIRECT
IP-CIDR,192.168.50.0/24,DIRECT
FINAL,PROXY
이 예시는 기본적으로 프록시를 사용하지만, 알려진 호스트 이름과 실제 사용하는 사설 네트워크 대역에는 별도의 직접 연결 조건을 둡니다. 같은 소유 기기에 이름과 주소로 각각 접속하면 이름 해석 문제와 연결 경로 문제를 구분하는 데 도움이 됩니다. 주소로는 연결되지만 이름으로 연결되지 않으면 이름이 예상한 주소로 해석되는지 확인하세요. 이름으로는 연결되지만 특정 주소로는 연결되지 않는다면 입력한 주소가 현재 기기의 주소인지 확인하세요. 이전 주소나 관리 페이지에 표시된 다른 인터페이스 주소일 수 있습니다.
집 Wi-Fi에서 모바일 네트워크로 바꾸면 대상에 더 이상 연결할 수 없을 수 있습니다. 한 Wi-Fi 네트워크에서 다른 네트워크로 이동할 때는 같은 사설 주소가 다른 기기를 가리킬 수도 있습니다. 이를 이유로 모든 사설 주소를 예외에 추가하거나 연결 실패를 FINAL 탓으로 돌리지 마세요. 앱이 로컬 기기 검색 기능을 사용한다면 먼저 시스템에서 해당 앱에 로컬 네트워크 권한을 허용했는지, 기기와 같은 네트워크에 있는지 확인하세요. 직접 연결 규칙 하나만으로 브로드캐스트, 검색, 실제 연결이 모두 완료되는 것은 아닙니다.
조합 3: 확인된 단일 호스트만 차단하고 같은 도메인의 서비스는 유지
[Rule]
DOMAIN,telemetry.example.com,REJECT
DOMAIN,updates.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
이 예시는 지정한 호스트만 차단하며, 같은 접미사를 사용하는 업데이트나 서비스 요청은 함께 차단하지 않습니다. 테스트 전에 실패해도 되는 동작과 반드시 성공해야 하는 동작을 정하세요. 지정된 호스트 연결이 예상대로 거부되는지 확인하고, 업데이트 호스트와 일반 서비스 호스트는 계속 정상인지 테스트하세요. 클라이언트 기록에는 차단이 적용된 것으로 나오는데 앱의 같은 동작이 완료된다면 캐시, 예비 호스트 또는 다른 전송 방식을 사용했을 수 있습니다. 실제 대상을 확인하고 도메인 그룹 전체로 범위를 자동 확장하지 마세요.
차단 규칙을 추가한 뒤 반복 재시도, 추가 오류 메시지 또는 기능 저하가 나타나면 설정 사본에서 해당 행을 먼저 되돌려 비교하세요. 되돌린 뒤 문제가 사라져도 규칙과 증상이 관련 있다는 뜻일 뿐입니다. 차단 대상 자체가 문제였는지, 같은 호스트를 사용하는 서비스 의존성이 함께 영향을 받았는지 더 확인해야 합니다. 도메인으로 두 요청을 구분할 수 없다면 정상 기능을 유지하세요. 모호한 DOMAIN-KEYWORD 규칙을 계속 추가하지 마세요. 조합 규칙의 성공 기준은 규칙 수가 아니라 실제 대상과 예상 동작의 일치 여부입니다.
검증 및 문제 해결: 설정, DNS 해석, 정책, 연결 실패 구분
문제가 발생하면 같은 방식으로 재현할 수 있도록 현재 기기의 네트워크, 활성 설정 이름, Global Routing 모드, Home에서 선택한 서버, 문제를 일으킨 앱 동작, 확인된 대상을 기록하세요. 구독 링크, 비밀번호, 서버 인증 정보를 기록하지 마세요. “앱이 열리지 않는다”보다 “앱을 다시 연 뒤 자체 서비스의 로그인 요청을 제출하면 실패한다”처럼 구체적으로 기록해야 설명을 실제 연결과 연결하기 쉽습니다. 연결 또는 진단 정보를 확인할 수 있다면 대상, 정책, 결과 세 가지만 우선 기록하고 관련 없는 정보는 수집하지 않아도 됩니다.
1단계: 설정이 라우팅에 사용 중인지 확인
연결 상태를 확인한 뒤 Home의 Global Routing과 Config에서 현재 사용 중인 파일을 확인하세요. 같은 이름의 백업을 수정했거나 초안만 저장했거나, 가져온 뒤 선택하지 않았으면 예상한 규칙이 적용되지 않습니다. 네트워크 전환 뒤 문제가 발생했다면 연결이 복구된 다음 테스트하세요. 막 연결이 끊어진 상태를 규칙에 의해 거부된 것으로 판단하지 마세요. 두 테스트 모두 새 요청을 보내야 합니다. 재사용 중인 연결, 브라우저 캐시, 이미 연결된 앱 세션은 방금 수정한 규칙을 판단하기에 적합하지 않습니다.
초기 설정과 첫 연결 방법은 사용 안내를 확인하세요. Home에 사용 가능한 서버가 표시되지 않으면 먼저 자신의 Subscribe 정보 또는 단일 서버 정보가 올바르게 가져와졌는지 확인하세요. 목록이 비어 있으면 구독 파싱 실패 및 목록이 비어 있을 때 확인 순서를 살펴보세요. 데이터 출처 문제를 해결하려고 FINAL을 임의로 바꾸지 마세요. 규칙은 프록시 경로를 선택할 수 있지만 누락된 서버 정보를 채울 수는 없습니다.
2단계: 제어 가능한 대상 하나로 최소 비교
[General]
dns-server = system
[Rule]
DOMAIN,check.example.com,PROXY
FINAL,DIRECT
설정 사본에서 check.example.com을 테스트할 수 있는 자신의 호스트로 바꾸고 현재 선택된 서버는 그대로 유지하세요. 먼저 정확한 도메인 규칙이 대상에 매칭되고 나머지 연결은 기본적으로 직접 연결될 것으로 예상하세요. 결과가 예상과 다르면 실제 연결에서 해당 이름을 사용했는지 확인하세요. 리디렉션 후에는 다른 호스트를 사용할 수 있습니다. 그런 다음 같은 대상의 Direct 및 Proxy 결과를 비교하세요. 속도 테스트 한 번은 실제 서비스 접속과 같지 않습니다. 가능한 한 같은 요청, 네트워크, 시간대에 테스트하세요.
Proxy 모드에서도 같은 대상에 연결할 수 없다면 규칙 순서가 원인이 아닐 수 있습니다. 서버가 온라인인지, 가져온 정보가 서비스 제공자가 안내한 매개변수와 일치하는지, 같은 서버로 다른 알려진 대상을 열 수 있는지 확인하세요. Config에서만 실패하고 Proxy와 Direct에서는 접속할 수 있다면 Config의 매칭 조건, REJECT가 앞에서 요청을 차단했는지, 설정에 Host 또는 URL Rewrite 구간이 추가되어 있는지를 중점적으로 확인하세요. 모드 전환은 진단을 위한 방법입니다. 테스트가 끝나면 확인하려는 모드로 되돌리세요.
3단계: 오류 양상에 따라 점검 범위 좁히기
예상한 주소를 받지 못했다면 먼저 DNS 해석과 [Host]를 확인하세요. 주소는 있지만 연결이 성립하지 않으면 라우팅, 네트워크 대역의 연결 가능 여부, 서비스 상태를 살펴보세요. 연결은 성립했지만 인증서 경고, 리디렉션 반복 또는 서비스 오류가 발생했다면 서버에 연결할 수 없다고 바로 판단하지 마세요. DNS 캐시, 앱 캐시, 연결 재사용은 서로 다른 요소이며 하나를 지워도 나머지가 반드시 초기화되는 것은 아닙니다. 한 번에 한 항목만 바꾸고 새 요청을 보내야 변경 전후를 비교할 수 있습니다.
로그나 화면에서 필요한 매칭 정보를 확인할 수 없더라도 기록이 없다는 이유만으로 규칙이 매칭되지 않았다고 단정하지 마세요. 통제된 설정으로 비교할 수 있습니다. 먼저 정확한 규칙 하나와 다른 기본 정책으로 대상을 분리한 다음 같은 환경에서 기존 설정을 다시 적용하세요. 두 설정의 결과가 다르면 기존 설정의 규칙과 다른 구간을 조금씩 추가해 원인을 찾으세요. 재현하기 전에 모든 규칙과 설정을 초기화하지 마세요. 기능이 복구되더라도 정확히 어떤 행이 문제였는지 알기 어려워집니다.
유지 관리 및 롤백: 설정 출처, 규칙 변경, 재검증 관리
규칙을 장기간 안정적으로 사용하려면 기본 정책을 명확히 하고, 예외를 추적하며, 변경을 되돌릴 수 있어야 합니다. 일상적으로 사용하는 파일과 테스트 사본을 분리하세요. 서비스 문제가 생기면 검증된 설정으로 먼저 되돌린 다음 사본에서 원인을 찾으세요. 이전 설정으로 돌아가도 서버 상태까지 이전 상태가 되는 것은 아닙니다. 서버 선택, 구독 업데이트, 현재 네트워크가 이미 바뀌었을 수 있습니다. 롤백할 때마다 현재 사용 중인 파일과 Home의 선택 항목을 확인한 뒤 이전 테스트 대상으로 다시 확인하세요.
설정 파일과 서버 목록 구분
Config의 규칙 설정은 트래픽 분기와 관련 설정을 정의하며, Subscribe를 통해 가져온 서버 목록은 연결 대상을 제공합니다. 규칙 설정 사본을 저장해도 서버 인증 정보가 저장되는 것은 아닙니다. 서버 목록을 업데이트해도 규칙 조건이 수정되는 것은 아닙니다. 이미 사용하는 원격 설정을 제공자가 관리하고 있고 로컬 예외를 추가해야 한다면 출처 기록을 남기고 별도의 작업 사본으로 저장하는 것이 좋습니다. 원격 설정을 다시 가져온 뒤에는 새로운 병합 작업으로 취급하세요. 로컬 수정 내용이 유지된다고 가정하지 마세요.
두 설정 파일의 텍스트를 비교할 때는 먼저 [General], [Host], [URL Rewrite]가 바뀌었는지 확인한 다음 [Rule]의 추가, 삭제, 순서 변경을 점검하세요. 두 설정을 모두 가져올 수 있다는 것은 파일 형식이 허용된다는 뜻일 뿐, 동작이 같다는 의미는 아닙니다. 특히 넓은 범위의 규칙이 예외보다 앞에 이동했는지, 기본 정책이 바뀌었는지, 도메인 규칙으로 처리하던 연결이 주소 해석에 의존하기 시작했는지 확인하세요.
변경마다 검증 가능한 예상 결과 정하기
[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
예상 결과를 “상태 호스트는 계속 직접 연결, 서비스 하위 도메인은 프록시 사용, 관련 없는 호스트는 계속 직접 연결”처럼 구체적으로 작성하세요. “규칙을 최적화했다”라고만 적지 마세요. 이렇게 하면 최소 세 대상을 테스트해야 한다는 것을 알 수 있습니다. 로컬 네트워크 예외를 수정했다면 허용 대역 밖의 주소도 추가로 테스트하세요. IPv6 조건을 수정했다면 테스트에서 실제로 IPv6를 사용했는지 확인하세요. 차단 규칙을 수정했다면 같은 도메인에서 반드시 허용해야 하는 기능도 확인하세요. 예시 도메인과 네트워크 대역은 연결 가능성 테스트용이 아닙니다. 자신의 환경에서 예상 결과를 알고 있고 직접 제어할 수 있는 대상을 사용하세요.
중요한 서비스는 홈페이지에 접속하는 데 그치지 말고 재현 가능한 실제 동작을 완료 기준으로 삼으세요. 로그인 예외를 수정했다면 로그인 후 서비스 페이지로 돌아가는 것까지 확인하세요. 파일 서비스 규칙을 수정했다면 실제 리소스 요청을 하나 이상 테스트하세요. 테스트 전에는 이전 세션이 연결 변경 결과를 가리지 않도록 하세요. 테스트가 실패하면 당시 대상, 선택된 정책, DNS 해석 성공 여부를 기록하세요. 조건 없는 성공·실패 목록보다 유용합니다.
파일 전체를 연속으로 수정하지 말고 변경 사항 하나씩 롤백
병합한 설정 사본에서 문제가 발생하면 먼저 이전에 검증한 활성 설정으로 되돌리고 서비스가 복구되는지 확인하세요. 복구된다면 문제가 있는 설정에서 변경 사항 한 묶음만 되돌리세요. 예를 들어 먼저 FINAL을 원래대로 복구하고 다른 규칙은 유지한 채 문제가 계속되는지 확인할 수 있습니다. 설정을 되돌려도 서비스가 복구되지 않으면 현재 네트워크, 서버 변경 또는 앱 상태도 원인일 수 있습니다. 이 경우 검증 및 문제 해결로 돌아가고 관련 없는 규칙을 계속 삭제하지 마세요.
다른 기기에서 사용할 설정을 배포하기 전에 앱 기능, 설정 출처, 현재 네트워크 조건을 다시 확인하세요. 예시를 복사하면 텍스트만 옮겨질 뿐 기기 권한, DNS 환경 또는 선택된 서버까지 동기화되지는 않습니다. 문서에는 정책 의도, 규칙 범위, 롤백 절차를 기록할 수 있습니다. 개인 구독 주소와 인증 정보는 별도로 안전하게 보관하세요. 활성 파일에서 매칭 결과를 재현하고, 문제가 어느 단계에 해당하는지 설명하며, 검증된 동작으로 되돌릴 수 있다면 유지 관리 가능한 설정 기반이 마련된 것입니다.