Shadowrocket 공식 매뉴얼 · 설정 참고
Shadowrocket 규칙 및 설정 가이드
이 페이지는 설정을 수정하거나 점검할 때 참고할 수 있도록 섹션, 규칙 필드, 문제 해결 절차별로 구성했습니다. 기존 구독을 처음 가져오거나 연결 모드를 선택하고 연결을 켜려면 먼저 사용 방법을 확인하세요. 연결은 되지만 특정 요청이 왜 직접 연결되거나 프록시를 거치는지, 또는 거부되는지 알고 싶다면 아래 목차에서 해당 항목으로 이동하세요.
예시에 사용된 도메인과 문서용 주소는 설정 및 매칭 방식을 설명하기 위한 값이며, 실제로 사용할 수 있는 연결 경로가 아닙니다. 프록시 정책을 확인하기 전에 사용할 구독이나 서버 정보가 준비되어 있는지 확인하세요. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다.
설정 구조: 일반 설정, 규칙, 호스트 매핑 구분하기
먼저 사용 중인 파일 확인하기
설정 파일에는 대괄호로 표시된 섹션이 여러 개 들어갈 수 있습니다. 섹션 제목은 다음 섹션 제목이 나올 때까지 각 줄을 어떻게 해석할지 결정합니다. 같은 문자열도 어느 섹션에 있느냐에 따라 의미가 달라집니다. 예를 들어 portal.example.com은 [Rule]에서는 매칭할 호스트 이름이 될 수 있고, [Host]에서는 매핑할 호스트 이름이 될 수 있습니다. 먼저 섹션을 확인한 다음 내용을 편집하세요. 파일 전체를 임의로 이어 붙일 수 있는 규칙 목록처럼 취급하지 말고, 기존 규칙 목록 중간에 새 섹션 제목을 끼워 넣지 마세요.
Config에서 현재 선택된 설정을 확인하세요. 목록에 이름이 같은 파일이 있으면 방금 수정한 파일이 무엇인지 이름만으로 구분하기 어렵습니다. 사용 가능한 원본은 따로 보관하고, 테스트용 복사본에는 용도를 알아보기 쉬운 이름을 붙이는 것이 좋습니다. 편집, 저장, 선택은 서로 다른 작업입니다. 복사본을 저장해도 트래픽이 그 설정에 따라 처리되는 것은 아닙니다. 수정 후에는 복사본이 실제로 선택되었는지 확인하고 Global Routing이 Config인지 점검하세요. 원본 파일이 원격 주소에서 가져온 것이라면 새로고침할 때 로컬 수정 사항이 덮어써질 수 있습니다. 개인 규칙을 계속 유지하려면 별도의 복사본을 사용하세요.
| 섹션 | 주요 역할 | 점검할 상황 |
|---|---|---|
[General] | DNS 설정 등 전체 네트워크 동작을 설정 | IP 주소로 접속되지만 도메인 이름 해석에 문제가 있을 때 |
[Rule] | 조건에 따라 처리 정책을 선택 | 실제 적용 정책이 예상과 다를 때 |
[Host] | 특정 호스트 이름의 매핑 지정 | 일부 호스트만 예상하지 못한 주소로 해석될 때 |
[URL Rewrite] | 확인 및 매칭 가능한 URL에 재작성 적용 | 리디렉션이나 경로별 처리 결과에 문제가 있을 때 |
[General]과 [Host]: 이름 해석과 트래픽 분기는 다릅니다
[General]
dns-server = system
[Host]
portal.example.com = 192.0.2.10
여기서 dns-server = system은 시스템 DNS 설정을 사용하도록 지정합니다. 실제 해석 결과는 현재 네트워크, 캐시, 앱의 DNS 처리 방식에도 영향을 받습니다. [Host] 예시는 지정한 이름을 문서용 주소에 매핑합니다. 이는 라우팅 정책이 아니며, 해당 주소의 서비스가 자동으로 사용 가능해지는 것도 아닙니다. 실제 환경에서 고정 매핑을 만들려면 대상 주소의 소유자, 용도, 관리 주체를 먼저 확인하세요. 대상이 여러 서버를 번갈아 사용하거나 동적 DNS에 의존한다면, 정적 매핑으로 인해 주소가 바뀐 뒤 일부 요청이 실패할 수 있습니다.
고정 주소를 지정해도 브라우저가 원래 도메인에 대해 수행하는 인증서 검증은 달라지지 않습니다. 연결은 되지만 해당 도메인에 맞는 인증서가 없는 서버로 이름을 연결하면 이름 불일치 오류가 발생할 수 있습니다. 테스트 결과가 단순히 “열리지 않음”으로만 표시된다면 도메인 해석, 연결 수립, 인증서 검증의 세 단계로 나눠 확인하세요. 앞 단계가 성공했다는 것은 다음 단계까지 진행했다는 뜻일 뿐, 다음 단계도 통과했다는 의미는 아닙니다. 테스트 매핑을 삭제한 뒤에는 새 요청을 보내세요. 이미 열려 있는 페이지로 변경 적용 여부를 판단하지 마세요.
[Rule]과 [URL Rewrite]: 한 섹션에 섞어 쓰지 마세요
[Rule]
DOMAIN,portal.example.com,DIRECT
FINAL,PROXY
첫 번째 규칙은 전체 호스트 이름이 일치하면 직접 연결하고, 마지막 규칙은 나머지 규칙 처리 대상 트래픽을 프록시로 보냅니다. [URL Rewrite]는 별도의 문법을 사용합니다. 경로 매칭 정규식을 DOMAIN 필드에 넣거나, 리디렉션 동작으로 PROXY를 대신할 수 없습니다. 낯선 파일을 수정할 때는 먼저 섹션을 찾고 키워드, 구분자, 정책을 확인하세요. 한 줄이 도메인처럼 보인다는 이유만으로 DNS, 트래픽 분기, 요청 처리 중 무엇에 적용되는지 알 수는 없습니다.
설정 복사본은 변경을 최소화해 검증할 수 있습니다. 기존 설정을 복사한 뒤 DNS 설정은 그대로 두고, 확인할 규칙을 올바른 섹션의 기본 규칙 앞에 추가한 다음 파일이 정상적으로 불러와지는지 확인하세요. 저장 후 구문 오류가 발생하면 DNS나 서버부터 살피기보다 최근에 넣은 섹션 제목, 전각 문장 부호, 편집기에서 잘린 줄을 먼저 확인하세요. 화면에서 줄이 바뀌어 보이는 것은 표시 방식일 뿐입니다. 실제 파일에서 줄바꿈되면 규칙 하나가 유효하지 않은 두 줄로 나뉠 수 있습니다. 원래 상태로 되돌리려면 원본을 다시 선택하면 됩니다. 같은 파일에서 계속 수동으로 취소할 필요는 없습니다.
구독에는 연결에 필요한 정보가 포함되고, 설정은 요청을 어떻게 처리할지 정의합니다. 기존 구독을 업데이트한 뒤에도 현재 설정이 선택되어 있는지, 정책에 필요한 서버를 사용할 수 있는지 확인해야 합니다. 한쪽을 확인했다고 다른 쪽까지 확인한 것은 아닙니다.
Global Routing과 정책: 먼저 모드를 선택한 뒤 규칙 확인하기
세 가지 모드의 점검 용도
Global Routing은 클라이언트가 처리하는 트래픽을 현재 설정에 따라 분기할지 결정합니다. 설정 모드인 Config는 규칙을 확인할 때 사용하고, 프록시 모드인 Proxy는 프록시 경로를 비교 기준으로 사용하며, 직접 연결 모드인 Direct는 직접 연결 경로를 비교 기준으로 사용합니다. 이는 클라이언트가 처리하는 범위에 들어온 트래픽에 대한 설명이며, 기기의 모든 트래픽이 반드시 동일한 설정을 따른다는 뜻은 아닙니다. 다른 두 모드와 비교한 뒤에는 Config로 돌아와야 개별 규칙의 적용 여부를 확인할 수 있습니다.
| 화면 표시 | 처리 기준 | 확인할 수 있는 내용 |
|---|---|---|
Config | 현재 설정에 있는 규칙과 해당 정책 | 이 요청은 어떤 규칙에 매칭되었나요? |
Proxy | 현재 프록시 경로로 처리 | 현재 트래픽 분기 규칙을 사용하지 않을 때 프록시 경로가 작동하나요? |
Direct | 직접 연결 경로로 처리 | 현재 네트워크에서 같은 대상에 직접 연결할 수 있나요? |
비교할 때는 같은 네트워크, 같은 대상, 같은 서버를 유지하고 모드만 바꾸세요. 무선 네트워크에서 셀룰러 네트워크로 바꾸거나 중간에 서버를 변경하면 차이가 라우팅 모드 때문인지 네트워크 조건 때문인지 구분하기 어렵습니다. 이미 로드된 웹페이지로만 판단하지 마세요. 브라우저가 기존 연결을 재사용하거나 캐시를 표시할 수 있습니다. 같은 대상에 새 연결을 만들고 확인 가능한 요청 기록을 함께 살펴보는 편이 페이지가 로드되는지만 보는 것보다 정확합니다. 여러 번 비교해야 한다면 매번 사용한 모드와 결과를 기록해 두고 기억에 의존해 원인을 추정하지 마세요.
PROXY, DIRECT, REJECT
[Rule]
DOMAIN,admin.example.com,DIRECT
DOMAIN,metrics.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
DIRECT는 프록시 서버를 거치지 않고 대상에 연결한다는 뜻이지만, 정상적인 DNS 해석과 로컬 네트워크 경로가 필요합니다. PROXY는 프록시 경로를 사용한다는 뜻이며, 서버 주소, 프로토콜, 인증 정보가 유효해야 합니다. REJECT는 이 규칙에 매칭된 요청을 거부합니다. 앱에는 연결 실패, 재시도, 기능 작동 불가로 나타날 수 있으며, 명확한 거부 안내가 표시되지 않을 수도 있습니다. 설정 파일에서는 대문자로 된 정책 이름을 사용하고, 화면의 Proxy와 Direct는 모드 선택 항목입니다. 두 가지는 서로 다른 개념입니다.
예를 들어 위 설정에서 Config를 선택하면 관리 호스트는 첫 번째 규칙에, 지표 호스트는 두 번째 규칙에 매칭되고, 접미사 조건에 맞는 나머지 호스트만 프록시 연결을 시도합니다. Proxy로 직접 바꾼 뒤 특정 대상에 다시 접속할 수 있게 되더라도, 우선 프록시 경로가 해당 테스트 대상에서 작동한다고만 판단할 수 있습니다. 원래 규칙에서 반드시 DIRECT에 매칭되었다고 단정할 수는 없습니다. 실제로는 REJECT에 매칭되었거나 다른 단계에서 실패했을 수도 있습니다. 반대로 규칙이 예상대로 PROXY에 매칭되었는데도 페이지가 열리지 않는다고 해서 규칙이 적용되지 않았다고 단정할 수는 없습니다.
연결 상태, 테스트, 요청 결과를 따로 기록하기
연결 스위치가 켜졌다는 것은 클라이언트의 연결 상태가 바뀌었다는 뜻이지, 모든 대상에 접속할 수 있다는 뜻은 아닙니다. Connectivity Test는 현재 서버에 연결할 수 있는지 비교하는 참고 자료로 활용할 수 있지만, 테스트 대상과 실제 서비스 요청은 다릅니다. 사이트의 기본 문서는 열려도 인증, 이미지, API 요청 단계에서 실패할 수 있습니다. 이런 경우 같은 모드에서 문제가 발생한 동작을 재현한 뒤, 그 시점에 함께 발생한 실패 요청을 확인하세요. 홈 화면이 열리는 것만을 합격 기준으로 삼으면 결제, 로그인, 파일 업로드처럼 나중에 생성되는 연결의 문제를 놓치기 쉽습니다.
On Demand는 어떤 조건에서 연결을 설정하거나 유지할지 다루며, 도메인별 정책을 지정하지 않습니다. 네트워크를 바꾼 뒤 연결이 다시 설정된다면 먼저 연결 동작을 확인하고, 그다음 현재 모드와 규칙을 점검하세요. 이렇게 하면 “클라이언트가 요청을 처리하는가”와 “처리할 때 어떤 경로를 이용하는가”를 별개의 문제로 나눌 수 있습니다. 두 문제를 FINAL 하나로 해결하려 하지 마세요. 기기가 조직에서 관리된다면 시스템에서 연결 동작을 별도로 제한할 수 있으므로 기기 관리 정책을 따르세요.
도메인 규칙: 정확한 호스트, 접미사, 키워드
규칙 필드에는 호스트 이름을 입력합니다
도메인으로 트래픽을 분기하려면 주소에서 호스트 이름만 분리하세요. 예를 들어 https://api.example.com:443/v1/items의 호스트 이름은 api.example.com입니다. 프로토콜, 포트, 경로, 쿼리 매개변수는 도메인 매칭 필드에 포함되지 않습니다. DOMAIN은 특정 호스트 하나에만 적용할 때, DOMAIN-SUFFIX는 도메인 자체와 하위 도메인을 함께 처리할 때 적합합니다. DOMAIN-KEYWORD는 호스트 이름에 포함된 문자열을 기준으로 매칭합니다. 뒤의 두 규칙은 의도하지 않은 요청까지 포함할 가능성이 높으므로, 수정 전에 매칭되면 안 되는 반례를 정리하세요.
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,preview-build,DIRECT
FINAL,PROXY
| 조건 | 매칭 예시 | 매칭되지 않는 예시 |
|---|---|---|
DOMAIN,login.example.com | login.example.com | test.login.example.com |
DOMAIN-SUFFIX,example.com | example.com、api.example.com | notexample.com、example.com.example.net |
DOMAIN-KEYWORD,preview-build | preview-build.example.net | preview.example.net |
접미사는 단순히 문자열의 마지막 몇 글자를 확인하는 방식이 아니라 도메인 경계를 기준으로 판단합니다. 하위 도메인을 나타내려고 DOMAIN-SUFFIX에 *.를 넣을 필요도 없습니다. 반대로 키워드 규칙은 키워드가 반드시 하나의 하위 도메인 레이블과 일치할 필요가 없으며, 특정 회사나 프로젝트에 속하는지도 보장하지 않습니다. 여러 도메인에 걸친 임시 테스트에 이런 규칙을 사용한다면 나중에 제거할 수 있도록 확인 내용을 기록해 두세요. 장기간 사용할 규칙이라면 확인된 호스트나 접미사로 범위를 최대한 좁히는 것이 좋습니다.
실제 요청에서 도메인을 확인하세요. 페이지 이름으로 추정하지 마세요
주소창에서 페이지 하나를 열었다고 해서 모든 요청이 주소창에 표시된 호스트로 전송되는 것은 아닙니다. 로그인 과정에서 리디렉션이 발생하거나 정적 파일이 다른 도메인에서 제공될 수 있고, 한 페이지도 여러 API를 통해 데이터를 불러올 수 있습니다. 특정 버튼을 누를 때만 실패한다면 재현하기 쉬운 동작으로 범위를 좁힌 뒤 해당 시간대에 실패한 호스트 요청을 확인하세요. 관련이 확실한 호스트 하나에 정확한 규칙을 먼저 추가하고 같은 동작을 다시 수행하세요. 여러 하위 도메인에 실제로 같은 처리가 필요할 때만 접미사 규칙으로 범위를 넓히세요. 도메인 전체를 다른 정책에 맡기면 문제가 사라질 수는 있지만 어떤 요청을 조정해야 했는지 알기 어렵습니다.
기록에 대상 주소만 있다면 도메인 규칙을 적용하는 데 필요한 매칭 대상이 없을 수 있습니다. 앱이 IP 주소로 직접 연결하거나 자체 DNS를 사용하거나 기존 연결을 재사용한다면, 서비스에서 사용하는 도메인만 보고 클라이언트도 반드시 그 도메인을 확인했다고 추정할 수 없습니다. 반대로 DNS가 별칭이나 여러 주소를 반환한다고 해서 별칭과 모든 주소를 규칙에 추가해야 하는 것도 아닙니다. 클라이언트에서 실제로 확인할 수 있고 비교적 안정적인 요청 속성을 우선 사용하세요. 주소가 자주 바뀌는 대상은 호스트 이름을 확인하는 것보다 고정 주소를 관리하는 편이 더 쉽게 실패할 수 있습니다.
검증할 때는 반례를 하나 이상 포함하세요
로그인 호스트를 직접 연결하도록 설정했다면 해당 호스트가 DIRECT로 처리되는지, 같은 도메인의 다른 호스트는 예상한 경로를 유지하는지도 확인하세요. 접미사 규칙은 루트 도메인, 매칭되어야 하는 하위 도메인 하나, 접미사는 비슷해도 해당 도메인에 속하지 않는 호스트 하나를 함께 점검할 수 있습니다. 정방향·반례는 매칭 범위를 확인하기 위한 것이며 예시 도메인이 실제 서비스에 해당할 필요는 없습니다. 실제 테스트에는 접근할 수 있고 검증이 허용된 대상을 사용하고, 예상 정책과 실제 정책을 모두 기록하세요.
두 규칙의 정책이 같다면 접속 결과만으로 어느 규칙에 매칭되었는지 구분할 수 없습니다. 가능하면 기존 매칭 기록을 확인하거나, 허가된 테스트 대상에서 임시 복사본을 사용해 확인할 조건과 기본 규칙에 서로 구분되는 정책을 지정하세요. 검증이 끝나면 원래 설정으로 되돌리세요. 규칙 하나를 확인하려고 일상 업무에서 사용하는 도메인 전체에 거부 정책을 적용하지 마세요. 다른 API까지 실패하면 원래 문제인지 테스트 규칙 때문인지 판단하기 어려워집니다.
IP 주소 규칙: IP-CIDR, IP-CIDR6, GEOIP
접두사 길이는 주소 범위를 나타내며 포트와는 다릅니다
[Rule]
IP-CIDR,192.0.2.10/32,DIRECT,no-resolve
IP-CIDR,198.51.100.0/24,PROXY,no-resolve
IP-CIDR6,2001:db8:40::/48,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
IP-CIDR은 IPv4에, IP-CIDR6은 IPv6에 사용합니다. 슬래시 뒤의 정수는 일치해야 하는 접두사 비트 수를 나타냅니다. IPv4의 /32는 주소 하나를 가리키고, 198.51.100.0/24는 198.51.100.0부터 198.51.100.255까지의 주소 범위를 포함합니다. 이 범위에 속한다고 해서 해당 주소를 모두 호스트로 접속할 수 있는 것은 아닙니다. IPv6에서 주소 하나를 지정하는 표기는 /128이며, 예시의 /48은 앞의 16진수 그룹 세 개가 같은 주소를 포함합니다. 서비스 하나에 예외를 적용하려는 경우 입력이 편하다는 이유로 전체 서브넷까지 범위를 넓히지 마세요.
IPv4와 IPv6를 모두 사용하는 대상을 관리할 때는 실제 연결에 사용된 주소 체계부터 확인하세요. 브라우저나 시스템은 두 주소 중 하나를 선택할 수 있으며, IPv4 규칙이 IPv6 요청까지 자동으로 처리하지는 않습니다. 같은 대상이 어떤 때는 주소 규칙에 매칭되고 어떤 때는 기본 규칙으로 처리된다면 두 연결에서 사용한 대상 주소를 비교하고 네트워크에 따라 DNS 결과가 달라졌는지 확인하세요. 한 번의 테스트를 통과하려고 주소 범위를 넓히면 같은 네트워크 대역의 다른 요청까지 함께 바뀔 수 있습니다. 클라이언트에서 안정적인 호스트 이름을 확인할 수 있다면 도메인 규칙이 실제 용도를 더 정확히 나타내는 경우가 많습니다.
no-resolve는 해당 규칙의 이름 해석 동작을 제어합니다
요청이 도메인 이름으로 들어오면 주소 규칙은 접두사를 비교하기 위해 대상 주소를 알아야 합니다. 지원되는 규칙의 끝에 no-resolve를 추가하면 해당 규칙을 위해 도메인을 새로 조회하지 않습니다. 이미 알고 있는 주소는 여전히 비교할 수 있습니다. 이 옵션은 설정 전체의 DNS 스위치가 아니며 기존 해석 결과를 지우지도 않습니다. 앞의 접두사 규칙은 “대상 주소를 이미 알고 있을 때 주소에 따라 분류”하는 용도입니다. 뒤에 오는 규칙은 여전히 DNS 조회가 필요할 수 있고, 실제 연결을 시작할 때도 DNS가 필요할 수 있습니다.
이 옵션을 확인할 때는 IP 주소로 직접 접근하는 요청과 도메인 이름으로 시작하는 요청을 나눠 살펴보는 것이 좋습니다. 브라우저에서 HTTPS 주소에 접속하지 못했다고 해서 주소 규칙이 매칭되지 않았다고 단정하지 마세요. 인증서가 IP 주소에 맞는 신원을 제공하지 않을 수 있고, 서비스가 원래 도메인 이름을 요구할 수도 있습니다. 매칭된 정책과 서비스 응답을 따로 기록하세요. 테스트를 위해 no-resolve를 제거했을 때 동작이 달라진다면 도메인이 마침내 일치하는 주소로 해석되었는지, DNS 조회가 느려지거나 실패했는지 확인하세요. 두 경우에 필요한 조치는 다릅니다.
GEOIP는 주소 분류이며 지리적 위치를 증명하지 않습니다
GEOIP,CN,DIRECT는 대상 주소가 현재 데이터에서 CN으로 분류되면 직접 연결을 선택한다는 뜻입니다. 도메인 접미사, 클라이언트의 실제 위치, 계정 지역을 기준으로 하는 규칙이 아닙니다. 같은 도메인도 네트워크에 따라 다른 주소를 반환할 수 있고, 주소 분류 결과도 데이터 업데이트에 따라 달라질 수 있습니다. 분류 범위가 넓으므로 명확한 도메인 및 서브넷 예외 뒤에 두는 것이 적절합니다. 특정 호스트가 항상 같은 경로를 사용해야 한다는 뜻을 나타내는 용도로는 적합하지 않습니다.
예를 들어 프록시가 필요한 특정 서비스가 우연히 직접 연결 범위로 분류된 주소로 해석될 수 있습니다. 해당 서비스의 예외보다 지리 분류 규칙을 먼저 두면 앞선 조건이 충족되어 뒤의 정확한 서비스 규칙은 매칭될 기회가 없습니다. 문제를 확인할 때는 이번 연결에 사용된 정확한 호스트 이름과 주소, 처음 매칭된 규칙을 기록하세요. 도메인 접미사만으로는 주소가 어떻게 분류되었는지 알 수 없으며, 같은 도메인이 다른 네트워크에서 다른 경로를 사용한 이유도 설명할 수 없습니다.
주소 분류에 따라 처리해야 하는 경우에만 주소 규칙을 추가하세요. 조직 내부 서비스를 대상으로 한다면 대상 서브넷과 현재 네트워크 연결 범위를 먼저 확인하세요.
DIRECT를 선택해도 내부 네트워크 경로가 자동으로 만들어지지는 않습니다.
요청 속성과 재작성: USER-AGENT, REJECT, URL Rewrite
USER-AGENT는 확인 가능한 요청 속성을 매칭합니다
[Rule]
USER-AGENT,ExampleClient*,DIRECT
FINAL,PROXY
USER-AGENT는 클라이언트에서 확인할 수 있는 요청 식별 정보를 대상으로 합니다. 위 예시는 ExampleClient로 시작하는 식별 정보를 와일드카드 패턴으로 표현한 것이며, 시스템에서 앱의 표시 이름으로 프로세스를 찾는 방식이 아닙니다. 같은 앱의 웹페이지, API 요청, 백그라운드 연결이 모두 같은 식별 정보를 보내는 것은 아닙니다. 여러 앱이 같은 요청 구성 요소를 사용할 수도 있습니다. 설정을 수정하기 전에 직접 제어할 수 있는 테스트 요청에서 식별 정보가 실제로 존재하고 형식이 안정적인지 확인하세요. 다른 식별 정보로 대조 요청을 보내 함께 매칭되지 않는지도 점검하세요.
일반적인 암호화 연결에서는 대상 도메인만 확인한다고 HTTP 요청 헤더를 읽을 수 있는 것이 아닙니다. USER-AGENT를 모든 HTTPS 트래픽에서 사용할 수 있는 앱 식별 방식으로 여기거나, 특정 앱의 모든 요청이 같은 정책을 따를 것이라고 추정하지 마세요. 규칙이 매칭되지 않으면 먼저 클라이언트가 해당 필드를 확인할 수 있는지 판단한 다음 패턴과 순서를 점검하세요. 와일드카드 범위를 계속 넓혀도 필드가 보이지 않는 문제는 해결되지 않으며, 다른 요청이 잘못 매칭될 수 있습니다. 안정적인 대상 호스트에는 확인하기 쉬운 도메인 규칙을 우선 사용하세요.
REJECT로 특정 호스트의 요청 거부하기
[Rule]
DOMAIN,telemetry.example.com,REJECT
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
이 예시는 지정한 호스트 하나의 요청을 거부하고, 같은 접미사를 사용하는 다른 호스트는 다음 규칙으로 넘어가도록 합니다. 호스트 아래의 경로를 확인하거나 같은 호스트의 서로 다른 API를 구분하지는 않습니다. 로그인과 지표 전송을 같은 호스트에서 처리하는 서비스라면 도메인 기준 거부가 둘 다 영향을 줄 수 있습니다. 영향 범위를 확인하려면 먼저 복사본에서 정확한 도메인을 사용하고 기본 페이지, 로그인, 관련 API를 점검하세요. 처음부터 접미사 전체를 거부하지 마세요. 요청 재시도, 오차단, 실패 양상은 REJECT 규칙의 원리와 적용 범위를 참고하세요.
규칙은 매칭 절차에 들어온 요청을 차단합니다. 이미 완료된 다운로드를 취소하거나 앱에 저장된 콘텐츠를 삭제하지는 않습니다. 처음 테스트했을 때 변화가 없어 보인다면 앱이 캐시를 사용했을 수 있습니다. 여러 번 테스트하면서 연결 안내가 늘어났다면 앱이 자동으로 재시도하고 있을 수 있습니다. 두 현상 모두 요청 시각과 매칭 기록을 함께 확인해야 합니다. 오류가 사라지는 동시에 서비스 기능도 사용할 수 없게 되었다면 요구사항을 충족한 것으로 볼 수 없습니다. 변경 전과 동일한 절차로 기능이 정상인지 다시 확인하세요.
URL Rewrite는 확인 가능한 URL을 처리합니다
[URL Rewrite]
^http://example\.com/old$ http://example.com/new 302
이 예시의 각 부분은 왼쪽부터 매칭 표현식, 대체 대상, 리디렉션 동작입니다. 표현식에는 시작 및 끝 앵커가 사용되며, 이스케이프된 마침표는 문자 그대로의 마침표를 뜻합니다. 따라서 예시의 전체 주소와 정확히 일치하는 경우만 처리하며, 쿼리 매개변수가 붙은 주소는 매칭되지 않습니다. 302는 임시 리디렉션을 나타냅니다. 리디렉션 후에도 대상 주소에 별도로 접속할 수 있어야 합니다. 새 주소를 같은 규칙의 매칭 범위에 넣으면 테스트 중 리디렉션 루프가 생길 수 있습니다. 영구 리디렉션으로 시험하지 마세요. 브라우저가 이전 결과를 저장할 수 있어 설정을 되돌린 뒤 결과를 확인하기 어려워집니다.
여기서 일반 HTTP를 사용한 것은 URL 필드 자체의 매칭 조건을 보여주기 위해서입니다. 최신 브라우저는 자동으로 HTTPS로 전환할 수 있으며, 전환 후에는 예시 조건에 맞지 않습니다. HTTPS에서는 현재 처리 환경이 필요한 URL 필드를 실제로 확인할 수 있을 때만 경로를 기준으로 매칭할 수 있습니다. 호스트 이름이 보인다고 해서 경로나 쿼리 매개변수도 보이는 것은 아닙니다. 이 문서에서는 트래픽 분기를 확인하기 위해 별도로 복호화를 설정하도록 요구하지 않습니다. 호스트 전체의 연결 경로를 선택하려면 [Rule]을 사용하면 됩니다. 앱이 재작성된 주소로 이동하지 않는다면 표현식을 넓혀 문제를 가리기보다 대상 접속 가능 여부, 요청 방식 변경 여부, 앱의 리디렉션 지원 여부를 확인하세요.
매칭 순서: 예외는 해당 범위를 덮는 규칙보다 앞에 두기
우선순위는 규칙 이름이 아니라 처음 매칭된 항목으로 판단합니다
Config 모드에서 일반 [Rule] 목록을 읽을 때는 위에서 아래로 내려가며 조건에 맞는 첫 규칙을 찾으면 정책을 판단할 수 있습니다. 접미사 규칙이 먼저 요청을 처리하면 아래에 있는 정확한 호스트 규칙은 더 구체적이라는 이유만으로 자동 우선 적용되지 않습니다. 마찬가지로 뒤에 있는 거부 규칙도 정책 이름이 REJECT라고 해서 우선순위가 높아지지 않습니다. 수정 전에는 두 가지를 확인하세요. 어떤 요청의 처리를 바꾸려는지, 새 규칙 앞에 이미 해당 요청을 처리할 수 있는 조건이 있는지 살펴보세요.
[Rule]
DOMAIN,auth.example.com,DIRECT
DOMAIN,metrics.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
예시 순서에서는 호스트 이름이 auth.example.com인 요청이 먼저 직접 연결되고, metrics.example.com은 먼저 거부됩니다. 접미사 조건에 맞는 나머지 요청은 프록시로 연결됩니다. 접미사 규칙을 첫 줄로 옮기면 앞의 두 호스트도 먼저 그 규칙에 매칭됩니다. 지리 분류를 접미사 규칙 뒤에 둔 것은 확인된 도메인들이 대상 주소의 분류 변경에 영향을 받지 않도록 하기 위해서입니다. 이는 “도메인 규칙이 항상 IP 규칙보다 우선한다”는 뜻이 아닙니다. 애플리케이션 수준에서 명확히 정한 예외를 먼저 처리하고, 범위가 넓고 조건이 바뀌기 쉬운 요청은 그다음에 처리하라는 의미입니다.
FINAL은 앞선 규칙에 하나도 매칭되지 않을 때의 처리만 지정합니다
FINAL에는 도메인이나 주소 매개변수가 없으며 정책은 쉼표 바로 뒤에 옵니다. 설정을 관리할 때는 기본 정책을 명확히 지정하는 규칙 하나를 목록 맨 아래에 두면 됩니다. FINAL,DIRECT는 다른 규칙에 포함되지 않은 요청을 기본적으로 직접 연결합니다. 명시한 대상만 프록시로 보내는 설정에 적합합니다. FINAL,PROXY는 나머지 요청을 기본적으로 프록시로 보내며, 직접 연결할 예외를 명시하는 설정에 적합합니다. 기본 정책을 바꾸면 설정 전체의 기본 동작이 달라집니다. 특정 호스트 하나의 문제를 부분적으로 해결하는 변경이 아닙니다. 변경 전에는 명시적인 규칙이 없어도 정상적으로 접근해야 하는 서비스가 무엇인지 확인하세요.
예를 들어 FINAL,PROXY를 사용하면 구체적인 프록시 규칙이 전혀 매칭되지 않아도 대상이 프록시를 이용할 수 있습니다. “프록시로 연결된다”는 사실을 “추가한 규칙이 적용됐다”는 뜻으로 해석하는 것이 흔한 오판입니다. 실제로 매칭된 조건을 확인하거나 테스트 복사본에서 직접 제어할 수 있는 요청에 서로 구분되는 결과를 지정하세요. REJECT도 마찬가지입니다. 한 번의 연결 오류를 거부 규칙이 성공적으로 적용된 결과라고 단정할 수 없습니다. DNS 해석에 실패한 요청은 예상한 분기까지 도달하지 않았을 수도 있습니다.
규칙을 옮길 때마다 적용 범위가 바뀐다고 생각하세요
기존 설정을 검토할 때는 먼저 기본 규칙을 표시하고, 목록 아래쪽부터 위로 올라가며 범위가 넓은 규칙을 찾으세요. 특히 키워드, 접미사, 큰 주소 접두사를 확인합니다. 새 예외마다 기존 규칙 중 어떤 항목과 범위가 겹치는지 정리한 다음 가장 먼저 겹치는 규칙 앞에 배치하세요. 기존 규칙이 다른 예외 뒤에 있는 일반 규칙이라면 해당 구간 전체를 목록 맨 위로 옮기지 마세요. 원래 우선 처리되던 거부 또는 직접 연결 항목까지 가릴 수 있습니다. 순서를 바꿀 때 영향을 받지 않아야 하는 요청 하나를 기준으로 남겨 두면 예상치 못한 변경을 빠르게 찾을 수 있습니다.
다른 사람이 제공한 설정 조각을 합칠 때는 어떤 섹션과 정책을 대상으로 하는지, 필요한 전제 조건은 무엇인지 먼저 확인하세요. 두 번째 [Rule] 제목, 다른 파일의 기본 설정, 아직 만들지 않은 정책 이름을 그대로 붙여 넣지 마세요. 원격 규칙 출처가 포함된 설정은 현재 로컬에서 보이는 순서와 원격 출처 업데이트로 인한 내용 변경을 구분해야 합니다. 이전에는 매칭되지 않던 호스트가 더 앞에 있는 규칙 묶음에 갑자기 포함되었다면, 마지막에 추가한 예외만 봐서는 결과를 설명할 수 없습니다. 다시 확인할 때는 테스트에 실제로 사용한 설정 출처와 복사본을 기록하세요.
우선순위를 점검할 때마다 규칙 하나만 옮기거나 수정하고, 영향을 받지 않아야 할 요청 하나를 비교 대상으로 유지하세요. 변화가 확인되면 다음 규칙을 점검합니다.
자주 쓰는 설정: 원하는 동작에 맞춰 규칙을 최소화하기
지정한 대상만 프록시로 연결하기
[Rule]
DOMAIN,signin.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
이 규칙은 로그인 호스트를 직접 연결하고, 같은 접미사의 다른 호스트는 프록시로 보내며, 나머지 요청은 직접 연결 상태로 유지합니다. 처리 대상이 명확하고 소수의 호스트 이름으로 표현할 수 있을 때 적합합니다. 테스트할 때는 로그인 호스트, 같은 접미사의 서비스 호스트 하나, 접미사 범위 밖의 대상 하나를 각각 확인하세요. 같은 서비스의 파일 서버가 나중에 다른 접미사로 이전되면 기존 규칙이 자동으로 적용되지 않습니다. 이전한 호스트와 필요한 연결 방식을 따로 확인한 뒤 좁은 범위의 규칙을 추가하세요. 기능 하나를 보완하려고 FINAL까지 바꾸지 마세요.
로그인 전에는 서비스가 열리지만 로그인 후 일부 기능만 실패한다면, 로그인 호스트에서 서비스 호스트로 돌아온 뒤의 요청에서 문제가 발생했을 수 있습니다. 서로 다른 연결 경로가 관련되었는지 확인하려면 한 번의 전체 동작에서 웹페이지, 인증, API를 각각 어떤 호스트가 처리하는지 정리한 다음 정책을 하나씩 점검하세요. 이들 호스트가 모두 같은 경로를 사용해야 한다면 이름에 특정 단어가 포함되었다는 이유만으로 일괄 적용하지 말고 서비스 간 의존 관계를 기준으로 규칙을 작성하세요. 상대 서비스의 접속 조건이 있다면 허용된 연결 방식을 따르세요.
프록시를 기본값으로 사용하고 특정 로컬 서비스는 예외 처리하기
[Rule]
DOMAIN,printer.example.net,DIRECT
IP-CIDR,192.0.2.10/32,DIRECT,no-resolve
FINAL,PROXY
이 예시는 특정 서비스에 이름으로 접속할 때 직접 연결하고 지정한 주소에 직접 접속할 때도 직접 연결하도록 각각 설정합니다. 도메인과 주소는 설명을 위한 값일 뿐이며, 이를 통해 기기의 로컬 서비스에 접속할 수 있다는 뜻은 아닙니다. 실제 환경에 적용할 때는 사용하려는 이름이 올바르게 해석되는지, 현재 네트워크에서 해당 기기로 가는 경로가 있는지 확인한 뒤 실제 상황에 맞춰 도메인 규칙, 주소 규칙 또는 둘 다 사용하세요. 기기 주소가 네트워크에서 동적으로 할당된다면 단일 주소 규칙도 그에 맞게 관리해야 합니다. 반대로 넓은 주소 범위를 허용하면 해당 서비스와 무관한 연결까지 예외로 처리될 수 있습니다.
같은 설정을 두 네트워크에서 사용한다고 해서 동일한 사설 IP 주소가 같은 기기를 가리키는 것은 아닙니다. 사무실 기기를 가리키던 주소가 집에서는 다른 기기를 가리키거나 응답하지 않을 수 있습니다. 다시 확인할 때는 네트워크 환경도 예상 결과에 포함하세요. 기존 네트워크에서는 대상의 신원과 직접 연결 결과를 확인하고, 다른 네트워크에서는 우연히 같은 주소를 사용하는 서비스에 잘못 접속하지 않는지 확인합니다. 주소 규칙은 요청의 연결 경로만 결정할 뿐 원격 서비스의 신원을 확인하지는 않습니다.
서비스 호스트는 유지하고 별도의 요청만 정확히 거부하기
[Rule]
DOMAIN,stats.example.org,REJECT
DOMAIN-SUFFIX,example.org,DIRECT
FINAL,PROXY
별도의 호스트 하나에 접속할 필요가 없다는 점을 확인했다면 정확한 거부 규칙으로 요구사항을 표현할 수 있습니다. 수정 전에는 기본 페이지 열기, 설정 저장처럼 계속 사용할 수 있어야 하는 동작을 정리하세요. 규칙을 추가한 뒤 같은 절차로 다시 확인합니다. 중요한 기능이 거부 대상 요청과 같은 호스트를 사용한다면 이 방식으로 두 요청을 구분할 수 없습니다. 접미사 전체를 직접 연결해야 하는 경우에는 거부 규칙의 위치도 중요합니다. 접미사 규칙 뒤에 두면 먼저 나타나는 직접 연결 조건이 거부 규칙을 덮어씁니다.
설정을 관리할 때는 변경 사유, 필요한 대상, 실패 시 되돌릴 줄을 간단히 기록해 두세요. 설정 일부를 발췌할 때는 앞뒤의 범위 조건도 함께 보존하고, 특히 FINAL만 또는 그럴듯해 보이는 키워드 규칙 한 줄만 복사하지 마세요. 예시를 기존 설정에 합치기 전에 원래 기본 정책과 비교하세요. 예외 하나를 추가하려는 것이라면 목록에 없는 대상의 동작까지 함께 바뀌어서는 안 됩니다.
검증과 복구: 단계별로 문제 범위 좁히기
먼저 반복 가능한 기준 상태 만들기
시작하기 전에 최근에 정상 작동한 설정을 보관하고, Config에서 현재 선택을 확인한 다음 사용 중인 네트워크, 모드, 테스트 대상을 기록하세요. 직접 연결이 가능한 것으로 확인된 대상 하나와 기존 서버를 통해 연결해야 하는 대상 하나를 선택해 각각 결과를 기록합니다. Home에서 서버 선택을 확인하고 Connectivity Test 결과를 참고할 수 있지만, 테스트가 한 번 성공했다고 모든 대상에 접속할 수 있다고 판단하지 마세요. 두 경로가 모두 실패한다면 먼저 기기 네트워크를 점검하세요. 프록시 경로만 실패할 때 기존 서버 주소, 인증 정보, 프로토콜 매개변수를 확인합니다.
Config 모드에서만 문제가 발생하고 두 비교 경로가 정상이라면, 현재 설정에서 해당 대상에 매칭되어야 할 규칙과 정책, 그 앞에서 적용 범위를 덮을 수 있는 조건을 모두 기록하세요. 새 연결을 만들어 같은 동작을 다시 수행한 뒤 현재 플랫폼에서 확인할 수 있는 진단 기록을 살펴봅니다. 기본 규칙에 매칭되었다면 클라이언트에서 실제로 확인 가능한 호스트 이름이나 주소를 먼저 점검하세요. 예상하지 못한 일반 규칙에 매칭되었다면 규칙 순서를 확인하세요. 정책이 예상과 맞는다면 매칭 규칙을 계속 추가하기보다 이름 해석, 연결, 대상 서비스 문제를 점검해야 합니다.
오류가 발생한 단계별로 점검하고 여러 조건을 한꺼번에 바꾸지 마세요
- 설정을 불러올 수 없음: 마지막으로 수정한 부분을 확인하고 섹션 위치, 문장 부호, 매개변수 개수, 정책 표기를 점검하세요. 같은 설정 복사본에서 해당 부분만 되돌려 정상적으로 불러와지는지 확인합니다.
- 대상 주소를 확인할 수 없음: DNS 설정과
[Host]에 오래된 매핑이 남아 있는지 확인하세요. 한 네트워크에서만 실패한다면 다른 네트워크의 DNS 결과를 비교 기준으로 보존하고, 서버까지 동시에 바꾸지 마세요. - 주소는 확인되지만 연결되지 않음: 현재 모드, 실제로 매칭된 정책, 연결 경로를 확인하세요. 주소 체계가 바뀌면서 규칙이 다른 분기에 들어갔는지, 연결에 사용해야 할 네트워크가 실제로 작동하는지도 살펴보세요.
- 연결은 되지만 서비스 기능이 제대로 작동하지 않음: 실패한 동작이 발생시킨 후속 요청을 찾아 다른 호스트가 필요한지, 리디렉션 대상에 접속할 수 있는지, 거부 규칙의 범위가 너무 넓지 않은지 확인하세요.
예를 들어 시스템이 주소 두 개를 확인했는데 경로 하나에서만 실패한다면 먼저 해당 요청에서 사용한 주소를 기록한 뒤 주소 범위 규칙이 한쪽 주소 체계만 포함하는지 살펴보세요. 반대로 같은 도메인에서 인증서 오류가 발생하면 인증서 오류를 무시하고 테스트를 통과시키려 하지 말고 정적 매핑이 잘못된 서버를 가리키는지 먼저 확인하세요. 실패 단계를 구분하면 유용한 단서를 보존할 수 있습니다. 모드, DNS, 서버를 반복해서 바꾸면 매번의 결과를 서로 비교하기 어려워집니다.
[Rule]
DOMAIN,check.example.com,PROXY
FINAL,DIRECT
이 최소 규칙은 직접 제어할 수 있는 프록시 대상 하나와 나머지 직접 연결 대상을 구분하기 위한 것입니다. 도메인을 실제 테스트 호스트로 바꾸고 별도의 복사본에서 검증하되, 기존 설정에 필요한 네트워크 설정은 유지하세요. 비교를 위해 정상 작동하는 설정을 삭제하거나 기존 서버 정보를 지우거나 평소 사용하는 구독 내용을 수정하지 마세요. 최소 설정이 정상 작동하면 도메인 예외, 주소 분류, 재작성 규칙을 한 부분씩 추가하세요. 문제가 처음 재현된 부분을 다음 점검에서 범위를 좁힐 출발점으로 삼으면 됩니다.
복구한 뒤에도 다시 테스트하세요
새 설정이 미치는 범위를 설명하기 어렵다면 백업을 다시 선택하고 원래 필요했던 Global Routing 모드로 복원한 다음 기존 시나리오와 정상 비교 대상 하나를 다시 테스트하세요. 오류 화면이 사라졌다는 것만으로 복구가 완료되었다고 판단할 수 없습니다. 도움을 요청할 때는 민감한 정보를 가린 규칙 줄, 예상 정책, 사용 중인 네트워크 종류, 재현 절차를 제공할 수 있습니다. 구독의 전체 주소, 인증 정보, 민감한 매개변수가 포함된 요청 주소, 처리하지 않은 로그는 공개하지 마세요. 다른 점검 방법은 문제 해결과 연결됨으로 표시되지만 웹페이지가 열리지 않을 때 점검하는 방법을 참고하세요.
기기를 바꿀 때는 전체 플랫폼 다운로드 페이지에서 해당 플랫폼을 선택하세요. iPhone / iPad에서는 App Store 제품 페이지를 통해 다운로드할 수 있으며, 미국 스토어 기준 가격은 $2.99 일회성 결제입니다. 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료이며 설치 파일은 이 사이트의 /dl/에서만 제공합니다. 앱의 일회성 구매와 연결 서비스 요금제는 별개입니다. 기기를 바꾼 뒤에도 기존에 보유한 구독 또는 서버 정보를 사용해야 합니다.