공식 매뉴얼 규칙 및 설정

Shadowrocket 규칙 가이드

설정 섹션부터 첫 매칭 규칙까지, 조건과 정책 및 적용 범위를 문제별로 확인하세요.

이 페이지는 설정을 수정하려는 사용자를 위한 체계적인 참고 매뉴얼입니다. 연결 방법을 처음 익히는 경우 먼저 시작 가이드를 읽고, 보유한 구독을 가져와 연결을 확인한 뒤 규칙을 살펴보세요. 아래 설명은 본인의 구독 또는 서버 정보가 있다는 전제입니다. 구독 링크는 이용 중인 서비스 제공업체에서 확인하세요.

Shadowrocket은 iPhone / iPad, Mac, Windows, Android, Linux 버전을 제공합니다. iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매하며, Mac / Windows / Android / Linux 버전은 무료입니다. 앱을 한 번 구매하는 것과 회선 요금제는 별개입니다. 기기별 설치 방법은 다운로드 가이드에서 확인하세요. iPhone / iPad 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 아래 조작 방법은 iPhone / iPad를 기준으로 하며, 다른 기기의 메뉴 위치와 사용 가능한 설정은 현재 앱에 표시되는 내용을 따릅니다.

설정 파일 구조

Shadowrocket 규칙 설정은 보통 .conf 텍스트 파일로 저장하며, 대괄호로 기능별 섹션을 구분합니다. 설정 전체를 외우기보다 각 섹션의 역할을 이해하는 편이 중요합니다. 연결 정보는 서버에 연결하는 방법을 정하고, 규칙은 각 요청에 적용할 정책을 지정하며, DNS는 도메인에서 IP 주소를 얻는 방식을 다룹니다. 서로 영향을 주지만 같은 설정은 아닙니다. 구독 링크를 규칙 섹션에 붙여 넣거나 도메인 규칙을 Host 섹션에 작성해도 원하는 결과를 얻을 수 없습니다.

먼저 세 가지 항목을 구분하세요

Home의 서버 항목은 연결에 사용하고, 구독은 여러 서버 항목을 함께 관리하며, Config의 설정 파일은 라우팅과 관련 동작을 저장합니다. 기존 구독을 업데이트해도 현재 설정 파일이 바뀌는 것은 아니며, 다른 설정 파일을 선택해도 현재 서버가 반드시 바뀌는 것은 아닙니다. 문제를 확인할 때는 구독 이름, 현재 서버, 활성화된 설정 이름을 각각 기록해 세 항목의 변경을 하나의 작업으로 혼동하지 않도록 하세요.

Config에서 대상 설정을 열고 로컬 사본인지 원격 설정인지 확인하세요. 원격 내용을 다시 가져오면 직접 작성한 수정 사항이 덮어써질 수 있습니다. 오래 보관할 테스트 설정은 먼저 로컬 파일로 복사하고 알아보기 쉬운 이름을 붙이는 것이 좋습니다. 저장한 뒤에는 해당 파일이 선택되어 있는지도 확인하세요. 목록에 설정 파일이 있다고 해서 현재 사용 중이라는 뜻은 아닙니다.

설정 섹션주요 역할대신할 수 없는 항목
[General]DNS 등 전반적인 동작 설정서버 인증 정보와 개별 트래픽 분기
[Rule]요청을 매칭하고 정책 지정사용 가능한 프록시 서버 생성
[Host]지정 도메인의 고정 IP 매핑연결에 PROXY 또는 DIRECT 적용
[URL Rewrite]식별 가능한 요청의 URL 처리일반 네트워크 라우팅 및 임의의 암호화 콘텐츠 읽기

최소 구성부터 살펴보기

[General]
dns-server = system

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY

이 조각은 전역 설정과 규칙 섹션의 관계만 보여 줍니다. dns-server = system은 시스템 DNS를 사용한다는 뜻입니다. 이어지는 규칙은 예시 도메인, 사설 IP 범위, 나머지 요청을 순서대로 처리합니다. Host나 재작성 섹션은 비어 있는 섹션이 필수는 아니므로 포함하지 않았습니다. 설정이 간결할수록 각 항목과 그로 인한 현상을 연결하기 쉬워 문제 해결의 기준을 세우기 좋습니다.

규칙에서 쉼표는 필드 구분자이므로 영문 반각 쉼표를 사용하세요. 유형, 매칭 대상, 정책 순으로 작성하고 추가 매개변수는 마지막에 둡니다. 정책 뒤에 한국어 설명을 붙이지 마세요. 예시 설명은 별도의 주석 줄에 작성해 복사할 때 눈에 띄지 않는 공백이나 전각 쉼표가 섞이지 않도록 하세요. 도메인 필드에는 프로토콜을 붙이지 말고 전체 웹 주소를 입력하지 마세요.

저장만으로 검증이 끝나는 것은 아닙니다

수정 후에는 섹션 제목이 온전한지, 규칙이 올바른 섹션에 있는지 확인한 다음 저장하고 대상 설정을 다시 선택하세요. 앱에서 파싱 오류가 표시되면 다른 규칙을 더 추가하지 말고 우선 방금 수정한 줄의 필드 개수를 확인하세요. 저장에 성공했다는 것은 편집이 끝났다는 뜻일 뿐입니다. 실제 라우팅이 의도대로 작동하는지는 새 요청을 만들어 연결 기록을 확인해야 합니다.

일부 변경 사항은 새 연결부터 적용되며, 이미 연결된 장시간 연결은 이전 경로를 계속 사용할 수 있습니다. 검증 전에 테스트 페이지를 닫았다가 다시 열고, 필요하면 적절한 시점에 Shadowrocket을 다시 연결하세요. 중요한 데이터 전송 중에는 설정을 연달아 전환하지 마세요. 롤백 뒤에도 현상이 바로 달라지지 않는다면 롤백 실패로 판단하기 전에 연결 재사용과 앱 캐시부터 확인하세요.

완성된 설정에는 이 문서에서 다루지 않는 섹션과 항목이 더 있을 수 있습니다. 용도를 모르는 설정은 원래 값을 유지하고 먼저 기능을 확인하세요. 출처가 다른 설정 파일 전체를 그대로 이어 붙이지 마세요. 중복 섹션, 충돌하는 매개변수, 원격 업데이트로 인한 덮어쓰기는 단일 규칙의 오타보다 원인을 찾기 어려운 경우가 많습니다. 아래 예시는 필요한 부분만 바꾸거나 확인하기 위한 것이므로 모든 내용을 한꺼번에 적용할 필요는 없습니다.

매칭 순서와 라우팅 모드

규칙에 무엇을 썼는지만큼 규칙의 위치도 중요합니다. 라우팅 모드가 Config일 때 Rule 섹션은 일반적으로 위에서 아래로 확인하며, 요청이 규칙 하나에 매칭되면 해당 정책을 적용하고 다음 규칙은 더 정밀할 것이라며 계속 확인하지 않습니다. Shadowrocket은 DOMAIN을 DOMAIN-SUFFIX보다 자동으로 앞에 배치하지 않으며, 더 구체적으로 보이는 규칙을 대신 정렬해 주지도 않습니다.

먼저 Global Routing 확인하기

Global Routing에서 자주 사용하는 Config, Proxy, Direct 모드는 각각 설정, 프록시, 직접 연결에 해당합니다. 사용자 규칙을 확인할 때는 먼저 Config가 선택되어 있는지 확인하세요. Proxy 또는 Direct 모드에서는 요청이 Rule 섹션대로 분기되지 않을 수 있으므로, 이를 근거로 규칙 문법이 잘못됐다고 단정할 수 없습니다. 모드는 설정을 사용하는 방식을 정하며, 실제 트래픽 처리는 시스템 라우팅 범위와 앱의 실제 트래픽 처리 능력에도 영향을 받습니다.

화면 표시처리 방식확인에 적합한 항목
Config현재 설정에 따라 라우팅 처리Rule 순서와 적용 정책 확인
Proxy프록시 모드로 처리 대상 트래픽 전달프록시 경로가 작동하는지 잠시 비교
Direct직접 연결 모드로 처리 대상 트래픽 전달로컬 네트워크에서 연결 가능한지 비교

세 가지 모드는 진단을 위한 변수이지 성능 등급이 아닙니다. Proxy로 바꿨을 때 페이지가 열린다면 경로 변경 후 현상이 달라졌다는 뜻일 뿐, 모든 DNS 설정이 올바르다는 증거는 아닙니다. Direct로 바꾼 뒤 열리지 않아도 로컬 네트워크에서 대상에 접근할 수 없는 것일 수 있습니다. 비교가 끝나면 Config로 돌아가 유지할 규칙을 검증하세요. 임시 모드를 최종 해결책으로 오인하기 쉽습니다.

구체적인 예외 규칙을 앞에 두세요

[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

login.example.com에 접속하면 첫 번째 규칙에 먼저 매칭되므로 두 번째 규칙까지 진행하지 않습니다. www.example.com은 첫 번째 규칙에 맞지 않아 두 번째 규칙이 적용됩니다. 앞의 두 줄 순서를 바꾸면 후방 일치 규칙이 로그인 도메인을 먼저 처리해 원래의 직접 연결 예외가 실행되지 않습니다. 이는 규칙 순서 문제이므로 같은 도메인을 반복해서 추가할 필요가 없습니다.

일반적으로 명확한 예외를 앞에 두고, 그 뒤에 범위가 좁은 서비스 규칙, 더 넓은 주소나 지역 조건을 배치한 다음 마지막에 FINAL을 둡니다. 검토하기 편한 관례일 뿐 고정 규칙은 아닙니다. 조건이 겹친다면 원하는 결과에 따라 우선순위를 정하세요. 예를 들어 도메인이 키워드 규칙에도 해당하고 별도 예외도 있다면 예외를 키워드 규칙보다 먼저 두어야 합니다.

규칙 매칭과 연결 성공은 따로 확인하세요

규칙이 매칭됐다는 것은 정책이 선택됐다는 뜻일 뿐입니다. PROXY에 매칭되어도 서버에 연결할 수 없거나 인증에 실패하거나 전송이 제한되면 접속이 실패할 수 있습니다. DIRECT에 매칭되어도 대상 서버가 연결을 거부할 수 있습니다. ‘규칙이 올바르게 매칭됨’과 ‘접속에 성공함’을 별도로 판단하면 서버나 대상 웹사이트 문제를 규칙을 계속 수정해 해결하려는 실수를 줄일 수 있습니다.

앞선 정책의 연결이 실패했다고 다음 Rule을 자동으로 시도하지는 않습니다. 뒤에 있는 규칙은 앞선 규칙의 장애 대응 목록이 아닙니다. 연결을 전환해야 한다면 같은 도메인 아래에 서로 다른 정책을 여러 개 연속으로 작성해 순차 재시도를 기대하지 말고, 실제로 설정된 서버 선택이나 정책 그룹 동작을 확인하세요. 여기서 PROXY는 현재 선택된 프록시를 가리키며 가장 빠른 회선을 자동으로 선택한다는 뜻이 아닙니다.

On Demand는 조건에 따라 연결을 설정할지 결정하며, Rule의 개별 요청 매칭을 대신하지 않습니다. Scene의 구체적인 설정도 위의 세 가지 모드와 혼동하지 마세요. 네트워크가 바뀐 뒤 연결 상태가 예상과 다르면 자동 연결 조건을 먼저 확인한 다음 트래픽 분기를 살펴보세요. 첫 번째로 매칭되는 규칙의 추가 사례는 사용자 규칙과 우선순위 가이드에서 확인할 수 있습니다.

도메인 및 요청 조건

도메인 규칙은 ‘어떤 서비스에 어떤 정책을 적용할지’를 표현하기에 적합하며, 웹사이트 주소 변경을 직접 따라가는 것보다 관리하기 쉽습니다. 먼저 보유한 값이 호스트명인지, 전체 URL인지, 앱에 표시된 이름인지 확인한 다음 규칙 유형을 선택하세요. 페이지 제목, 앱 이름, 실제 연결에 사용되는 호스트명은 서로 다릅니다. 화면에 보이는 한국어 이름을 DOMAIN에 입력해도 해당 네트워크 서비스를 자동으로 찾지는 않습니다.

DOMAIN과 도메인 접미사 범위

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN-KEYWORD,example,PROXY
FINAL,DIRECT

DOMAIN은 도메인명을 정확히 매칭합니다. 첫 번째 규칙은 api.example.com에 적용되며 www.example.com이나 더 깊은 하위 도메인에는 적용되지 않습니다. 호스트명만 입력하고 https://, 포트, 경로는 붙이지 마세요. 특정 인터페이스 하나에만 적용하려는 경우 정확한 규칙을 사용하면 영향 범위를 예측하고 이후 도메인 변경을 확인하기 쉽습니다.

DOMAIN-SUFFIX는 지정한 도메인과 그 하위 도메인을 매칭합니다. 두 번째 규칙은 example.org와 img.example.org에 적용될 수 있지만, 임의의 문자열 끝부분을 검색하는 기능은 아닙니다. 따라서 notexample.org는 정상적인 매칭 대상이 아닙니다. 앞에 별표를 붙일 필요도 없습니다. *.example.org는 여기서 설명하는 접미사 규칙 표기가 아닙니다.

접미사 규칙을 쓰기 전에 도메인의 소유 범위를 확인하세요. 공용 호스팅 플랫폼의 넓은 접미사 전체에 하나의 정책을 적용하면 서로 무관한 사이트까지 영향을 받을 수 있습니다. 구체적인 서비스 도메인으로 조건을 표현할 수 있다면 공용 접미사까지 범위를 넓히지 마세요. 반대로 서비스가 여러 하위 도메인을 명확히 사용한다면 메인 도메인에만 DOMAIN을 적용할 경우 범위가 부족해 메인 페이지는 열리지만 이미지나 로그인이 실패할 수 있습니다.

키워드만으로 서비스를 식별할 수는 없습니다

DOMAIN-KEYWORD는 도메인에 특정 키워드가 포함되어 있는지 매칭하므로 접미사 규칙보다 범위가 넓은 경우가 많습니다. 예시의 example은 서로 다른 여러 도메인에 매칭될 수 있으며, 이들이 같은 서비스 제공업체에 속한다는 뜻은 아닙니다. 키워드 규칙은 확인 가능한 명명 규칙에 적합하지만, 흔한 짧은 단어를 신뢰할 수 있는 분류 기준으로 쓰기에는 적합하지 않습니다. 의도하지 않은 매칭이 발생하면 예외를 계속 추가하기보다 정확한 조건으로 바꾸세요.

예를 들어 ads를 REJECT로 지정하는 것은 키워드 차단 문법을 보여 줄 뿐, 광고 요청만 정확히 매칭한다고 보장하지 않습니다. 일반 도메인에도 이 세 글자가 들어갈 수 있습니다. 실제 연결 기록에서 도메인을 확인한 뒤 차단 여부를 결정하세요. 페이지 하나가 열린다고 해서 로그인, 미디어, 제출 인터페이스까지 모두 정상이라는 뜻은 아닙니다. 검증할 때 실제 사용 동작을 확인하세요.

USER-AGENT의 한계

[Rule]
USER-AGENT,ExampleClient*,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

USER-AGENT는 식별 가능한 요청의 User-Agent 내용에 따라 매칭하며, 예시의 별표는 와일드카드 범위를 나타냅니다. 프로세스 이름을 식별하거나 특정 앱의 모든 트래픽을 처리하는 기능은 아닙니다. 같은 앱도 요청 라이브러리에 따라 식별 문자열이 다를 수 있고, 여러 앱이 비슷한 문자열을 사용할 수도 있습니다. 따라서 USER-AGENT 규칙 하나만으로 앱 단위 트래픽 분기가 완성됐다고 단정할 수 없습니다.

HTTPS에서는 요청 헤더가 암호화되므로 일반적인 터널 전송만으로 User-Agent를 임의로 읽을 수 없습니다. 이 규칙의 매칭 여부는 앱에서 실제로 얻을 수 있는 정보와 관련 처리 조건에 따라 달라집니다. 규칙을 작동시키려는 이유만으로 추가 인증서 신뢰나 복호화 설정을 필수 절차로 여기지 마세요. 이 페이지에서는 해당 기능을 활성화할 필요가 없으며, 일반적인 트래픽 분기에는 검증 가능한 도메인 조건을 우선 사용하세요.

도메인 규칙이 적용되지 않는 것처럼 보이면 연결에서 실제로 사용하는 대상을 먼저 확인하세요. 페이지 리디렉션, 콘텐츠 전송, 별도의 인증 도메인, IP 주소 직접 접속 등으로 기존 가정이 맞지 않을 수 있습니다. 클라이언트에 사용할 수 있는 도메인 정보가 없다면 DOMAIN 계열 규칙도 대상을 알아낼 수 없습니다. 연결 기록을 근거로 필요한 조건만 추가하고, 모든 실패를 접미사 규칙이 ‘약해서’라고 단정하지 마세요.

규칙을 관리할 때는 근거가 있는 소수의 규칙을 서비스별로 묶고, 특별한 예외를 각 묶음 앞에 두는 것이 좋습니다. 서비스가 바뀌면 더 이상 필요하지 않은 도메인을 삭제해 설명하기 어려운 조건이 쌓이지 않도록 하세요. 규칙이 많다고 매칭이 정확해지는 것은 아닙니다. 각 규칙을 둔 이유와 매칭 대상이 분명해야 안정적인 설정을 유지할 수 있습니다.

IP 및 지역 매칭

대상이 IP 주소로 연결되거나 로컬 네트워크 주소를 명시적으로 처리해야 할 때는 IP 규칙이 더 직접적입니다. 도메인 표기가 아니라 최종 대상 주소를 기준으로 합니다. 사용 전에 단일 주소, 서브넷 범위, 지역 데이터베이스를 구분하세요. 웹사이트 하나가 여러 주소로 해석될 수 있고, IP 하나가 여러 도메인을 제공할 수도 있습니다. IP 기준 분기의 영향 범위는 특정 웹사이트의 서비스 범위와 다를 수 있습니다.

IP-CIDR 범위

[Rule]
IP-CIDR,192.168.50.10/32,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
FINAL,PROXY

IP-CIDR은 IPv4 네트워크 범위를 처리합니다. 슬래시 뒤의 숫자는 접두사 길이이며 포트 번호나 주소 개수가 아닙니다. /32는 IPv4 주소 하나를 가리키고, /16은 앞의 16비트가 고정된 범위를 뜻합니다. 규칙에는 필요한 네트워크 범위를 사용하세요. 특정 기기 하나를 직접 연결하려고 실제 로컬 네트워크보다 훨씬 넓은 주소 범위를 임의로 지정하지 마세요.

예시의 앞쪽 세 범위는 흔히 사용하는 사설 IP 대역으로, 로컬 네트워크 직접 연결을 이해하는 데 활용할 수 있습니다. 다만 현재 네트워크에서 실제로 접근할 수 있다는 보장은 없습니다. 회사 내부망, 게스트 네트워크, 가정용 라우터는 서로 격리될 수 있고 라우팅 테이블도 다를 수 있습니다. DIRECT에 매칭되면 로컬 네트워크에서 연결을 시도할 뿐, 접근 권한이 생기거나 네트워크 장비로 분리된 두 서브넷이 자동으로 연결되는 것은 아닙니다.

no-resolve의 의미

no-resolve의 핵심은 해당 IP 규칙과 매칭하기 위해 도메인 조회를 새로 유발하지 않는다는 점입니다. 모든 DNS를 끄거나, 규칙이 조회된 주소를 절대 확인하지 못하게 한다는 뜻은 아닙니다. 대상 자체가 IP 주소이거나 처리 과정에서 이미 대상 주소를 확보한 경우에는 해당 주소를 기준으로 판단할 수 있습니다. 특정 대역을 확인하려고 불필요한 조회를 추가하는 일을 줄이는 데 쓸 수 있지만, 실제 요청 경로와 함께 동작을 이해해야 합니다.

요청에 처음부터 도메인만 있고 앞선 도메인 규칙이 매칭됐다면 뒤의 IP 규칙으로 정책을 다시 정할 필요가 없습니다. 도메인 규칙이 매칭되지 않았고 뒤따르는 주소 규칙에 모두 no-resolve가 붙었다면 클라이언트가 먼저 조회한 다음 반드시 특정 대역에 매칭된다고 단정할 수 없습니다. 작성과 문제 해결 과정에서는 ‘판단에 사용할 주소가 이미 있는 경우’와 ‘매칭을 위해 조회가 필요한 경우’를 구분하세요.

IPv6 및 GEOIP

[Rule]
IP-CIDR6,fd00::/8,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

IP-CIDR6은 IPv6 주소에도 같은 접두사 방식을 사용합니다. 예시는 유일 로컬 주소 공간 일부로 문법을 설명하며, 모든 IPv6 로컬 주소의 전체 목록은 아닙니다. 대상에 A와 AAAA 레코드가 모두 있다면 IPv4 범위만으로는 의도를 온전히 표현할 수 없습니다. 검증할 때는 도메인만 같다고 보지 말고 실제 연결에 사용된 주소 체계도 확인하세요.

GEOIP는 대상 IP의 지역 데이터베이스를 기준으로 판단합니다. 예시의 CN은 지역 코드이며, 중국어 웹페이지나 중국어 도메인 또는 계정 지역을 뜻하지 않습니다. 콘텐츠 전송과 여러 지역에 분산된 서버로 인해 같은 도메인도 네트워크에 따라 다른 지역의 IP 주소로 해석될 수 있으며, 데이터베이스에는 갱신 시점과 분류 범위의 한계도 있습니다. 따라서 GEOIP는 넓은 범위의 분류 조건에 적합하며, 구체적인 서비스 예외를 대신할 수는 없습니다.

정책을 고정해야 하는 서비스라면 도메인이나 정확한 주소의 예외를 먼저 작성하고 GEOIP로 나머지 범위를 처리하세요. 반대로 넓은 지역 규칙을 앞에 두면 뒤의 서비스 규칙이 실행되지 않을 수 있습니다. GEOIP가 조회를 새로 유발하지 않도록 하려면 no-resolve 동작으로 판단 가능한 요청이 어떻게 달라지는지 이해해야 합니다. 결과를 확인하지 않고 매개변수만 복사하지 마세요.

주소 문제를 확인할 때는 대상 도메인, 실제 대상 IP, 주소 체계, 매칭된 규칙을 함께 기록하세요. 터미널에서 임의로 조회한 IP 하나를 앱 연결의 유일한 대상으로 간주하지 마세요. 캐시, 네트워크 DNS, 콘텐츠 전송 조정으로 결과가 달라질 수 있습니다. ‘같은 도메인이 가끔 다른 정책을 사용한다’면 먼저 이 네 항목이 일치하는지 살펴보세요. 지역 규칙을 계속 넓히는 것보다 효과적인 경우가 많습니다.

정책 및 FINAL

규칙의 왼쪽은 ‘무엇을 매칭할지’를, 오른쪽 정책은 ‘매칭 뒤 어떻게 처리할지’를 나타냅니다. PROXY, DIRECT, REJECT는 서로 다른 동작이며 서버 프로토콜 이름이나 연결 품질 등급이 아닙니다. 조건과 정책을 모두 올바르게 작성해야 규칙이 의도한 동작을 나타냅니다. 각 줄을 ‘대상이 이 조건을 만족하면 지정한 방식으로 처리한다’라고 읽으며 설정을 검토해 보세요.

PROXY와 DIRECT

PROXY는 프록시 정책을 사용한다는 뜻입니다. 구체적인 출구는 현재 선택된 프록시 또는 설정과의 실제 연결 관계에 따라 달라집니다. 구독에서 사용할 수 있는 서버를 자동으로 골라 주거나 대상 서비스가 해당 출구를 허용한다고 보장하지 않습니다. PROXY에 매칭된 뒤에도 현재 서버, 프로토콜 매개변수, 연결 가능 여부를 확인하세요. 서버 정보가 만료됐다면 PROXY 규칙을 더 추가해도 인증 문제는 해결되지 않습니다.

DIRECT는 선택한 프록시 서버를 거치지 않고 로컬 네트워크에서 대상에 직접 접속한다는 뜻입니다. Shadowrocket을 비활성화하거나 모든 시스템 네트워크 동작을 완전히 우회한다는 뜻은 아닙니다. 앱이 처리하는 범위에서는 DNS와 다른 설정이 접속에 영향을 줄 수 있습니다. 로컬 네트워크에서 접속해야 하는 대상에 사용하되, ‘직접 연결’을 장소와 네트워크에 관계없이 어디서나 접속 가능하다는 뜻으로 이해하지 마세요.

정책동작다음으로 확인할 항목
PROXY프록시 경로로 전달현재 서버, 인증, 대상 서버의 응답
DIRECT로컬 네트워크 경로로 전달로컬 라우팅, 네트워크 권한, 대상 연결 가능 여부
REJECT매칭된 요청 거부필요한 인터페이스나 관련 도메인까지 차단했는지

REJECT 범위를 제한하세요

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

이 예시에서는 정확한 도메인 하나를 먼저 거부하고, 로그인 도메인에는 직접 연결 예외를 적용한 뒤 나머지 예시 하위 도메인은 프록시로 보냅니다. REJECT에 매칭된 요청은 DIRECT로 자동 전환되지 않습니다. 앱에서 재시도가 반복되거나 콘텐츠 일부가 비거나 제출 버튼이 반응하지 않는다면 홈페이지가 열리는지만 확인하지 말고, 앱에 필요한 인터페이스를 차단했는지 점검하세요.

차단 규칙에는 특히 명확한 근거가 있어야 합니다. 용도를 모르는 도메인은 실제 요청과 기능상의 관계를 먼저 살펴보고, 이름이 낯설다는 이유만으로 바로 거부하지 마세요. 통계, 인증, 설정 요청이 기본 도메인을 공유할 수 있으므로 범위가 넓은 접미사나 키워드는 필수 기능에 영향을 줄 수 있습니다. 차단으로 인한 오작동을 확인하려면 규칙 전체를 삭제하기보다 규칙 하나를 잠시 비활성화하고 같은 동작을 반복하는 편이 원인을 찾기 쉽습니다.

FINAL은 기본 동작을 지정합니다

FINAL에는 도메인이나 네트워크 범위 필드가 필요하지 않습니다. 일반적인 표기는 FINAL,PROXY 또는 FINAL,DIRECT입니다. 앞의 조건에 하나도 매칭되지 않았을 때 적용되므로 설정 전체의 기본 정책을 결정합니다. 무엇을 선택할지는 사용 목적과 네트워크 환경에 따라 달라지며 모든 기기에 맞는 고정 답은 없습니다. 변경 전에 알 수 없는 도메인, 백그라운드 요청, 새 서비스가 어디로 처리될지 고려하세요.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

이 설정은 ‘명시한 도메인만 프록시로 보내고 나머지는 직접 연결’하는 방식입니다. FINAL,PROXY로 바꾸면 나머지 요청이 기본적으로 프록시를 사용하므로 직접 연결할 예외를 먼저 따로 지정해야 합니다. 어느 방식이든 사용할 수 있지만 관리 초점은 다릅니다. 앞의 방식은 프록시로 보낼 대상을 빠뜨리지 않도록 살펴야 하고, 뒤의 방식은 직접 연결할 대상을 빠뜨리지 않도록 확인해야 합니다. 두 가지 기준을 하나의 설정에 혼용하지 마세요.

허용 범위를 직접 관리하고 각 항목을 검증할 준비가 되어 있지 않다면 FINAL을 REJECT로 설정해 일상적으로 사용하지 않는 것이 좋습니다. 기본 거부로 설정하면 명시적으로 포함되지 않은 새 도메인이 실패할 수 있고, 페이지에 인터페이스 하나가 추가되는 것만으로도 문제가 생길 수 있습니다. 학습 단계에서는 관찰하기 쉬운 기본 정책으로 안정적인 기준을 만든 뒤, 명확한 목적에 따라 조건을 좁히세요.

설정에서 사용자 지정 정책 이름을 참조한다면 해당 이름이 실제로 존재하고 철자가 정확한지 확인하세요. 이 문서에서는 이런 혼동을 피하기 위해 기본 정책만 사용합니다. 서비스 제공업체가 표시한 서버 이름을 기본 제공 키워드로 취급하지 마세요. 최종 검증에서는 세 가지를 확인해야 합니다. 조건이 올바르게 매칭되는지, 동작이 의도에 맞는지, 동작 후 연결 경로를 사용할 수 있는지입니다. 하나라도 빠지면 검증이 끝난 것이 아닙니다.

General 및 DNS

General은 네트워크 전반의 동작을 설정하며, DNS는 ‘규칙은 맞아 보이는데 웹페이지가 열리지 않는’ 상황의 주요 변수인 경우가 많습니다. DNS는 도메인을 IP 주소로 변환하고, 라우팅 규칙은 사용 가능한 정보를 바탕으로 정책을 선택합니다. 실제 동작에서는 서로 영향을 줄 수 있지만 개념상 분리해 점검해야 합니다. 프록시 서버 지연 시간이 정상이라는 것은 테스트에 포함된 연결 단계가 작동한다는 뜻일 뿐, 도메인 조회와 페이지 리소스 요청까지 모두 성공했다는 의미는 아닙니다.

비교를 위한 DNS 기준 세우기

[General]
dns-server = system

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

dns-server = system은 시스템 DNS를 사용한다는 예시이며 모든 네트워크에 적합한 성능 설정을 뜻하지 않습니다. 이미 정해 둔 DNS 설정이 있다면 비교하기 전에 원래 값을 백업하세요. 온라인에서 찾은 DNS 서버 주소를 긴 목록으로 추가한다고 더 안정적인 것은 아닙니다. 조회 결과의 차이, 네트워크 연결 가능 여부, 오류 발생까지 걸리는 시간 때문에 문제 원인을 파악하기 더 어려워질 수 있습니다.

사용자 지정 DNS를 설정할 때는 먼저 주소 형식이 맞고 현재 앱에서 지원하는 표기인지 확인한 다음, 로컬 네트워크나 해당 요청 경로에서 DNS 서버에 도달할 수 있는지 확인하세요. DNS 서버 연결 가능 여부, 유효한 응답을 받는지, 이후 대상에 접속할 수 있는지는 각각 확인해야 합니다. 조회에 성공해도 반환된 주소가 현재 접속 경로에 적합하지 않을 수 있으며, 프록시가 작동해도 DNS 요청 자체가 예상한 경로를 따른다는 보장은 없습니다.

서로 다른 세 가지 실패 지점 구분하기

첫째, 주소를 얻지 못한 경우로 조회 시간 초과나 도메인 관련 오류가 나타날 수 있습니다. 둘째, 주소를 얻었지만 해당 주소에 연결하는 과정에서 시간 초과가 발생한 경우입니다. 셋째, 연결은 성립했지만 대상에서 인증서 오류나 애플리케이션 계층 오류를 반환한 경우입니다. 각 상황의 해결 방법은 다릅니다. 브라우저에 표시된 ‘페이지를 열 수 없음’이라는 문구만으로는 구분하기 어려우므로 Shadowrocket의 연결 기록과 같은 시점의 테스트 결과를 함께 확인하세요.

같은 도메인이 두 네트워크에서 서로 다른 IP를 반환하더라도 어느 한쪽이 반드시 잘못됐다고 볼 필요는 없습니다. 콘텐츠 전송은 네트워크 위치와 조회 경로에 따라 주소를 선택할 수 있습니다. 확인할 점은 현재 결과로 선택한 정책을 통해 접속할 수 있는지, 예상한 서비스에 연결되는지입니다. 네트워크를 바꾼 뒤에는 새 요청을 만들어 테스트하고 캐시에 이전 주소가 남아 있을 가능성도 고려하세요. 모든 차이를 규칙 순서 탓으로 돌리지 마세요.

IPv6도 비교에 필요한 요소입니다. 도메인에 IPv4와 IPv6 주소가 모두 반환되면 시스템은 둘 중 하나를 먼저 시도할 수 있으며, 실제 선택은 네트워크 상태에도 영향을 받습니다. IPv4 규칙만 확인했는데 IPv6 주소로 연결되면 예상과 다른 정책이 적용된 것처럼 보일 수 있습니다. 먼저 실제 주소 체계를 확인한 뒤 필요한 규칙을 추가하세요. 특정 주소 체계를 끄는 것을 모든 DNS 문제의 기본 해결책으로 삼지 마세요.

전역 설정을 한꺼번에 바꾸지 마세요

General에는 우회 범위, 주소 체계, 기타 전반적인 동작 설정이 포함될 수 있습니다. Rule과는 적용 계층이 완전히 같지 않습니다. 특정 트래픽이 예상한 처리 경로에 들어오지 않는다면, 이후의 정밀한 도메인 규칙만으로는 그 원인을 설명할 수 없습니다. 설정에 skip-proxy 같은 매개변수가 있으면 용도와 현재 값을 먼저 확인하고 일반적인 DOMAIN 예외처럼 임의로 바꾸지 마세요.

전역 설정은 정확한 규칙을 추가할 때보다 더 신중하게 수정해야 합니다. DNS, 주소 체계, 우회 범위, FINAL을 한 번에 바꾸면 문제가 잠시 사라지더라도 어느 항목이 효과를 냈는지 알 수 없고 부작용을 찾기도 어렵습니다. 먼저 서버와 Rule을 그대로 둔 채 DNS 설정 하나만 바꿔 보세요. 원래 상태로 복구한 다음 DNS를 고정하고 대상 규칙을 조정하세요. 변경한 항목, 테스트 대상, 결과를 매번 기록해 재현 가능한 비교를 만드세요.

‘일부 웹페이지가 열리지 않는’ 경우에는 여러 사이트를 번갈아 시험하기보다 대상 하나를 정해 오류가 발생하는 단계를 기록하세요. 특정 앱에서만 실패한다면 브라우저가 같은 도메인과 주소 체계를 사용하는지 비교해 보세요. 자세한 확인 순서는 DNS 조회 실패 문제 해결에서 확인할 수 있습니다. 이 장에서는 개념과 범위를 설명하고, 해당 문서에서는 증상에 따라 원인을 찾아가는 절차를 안내합니다.

Host 및 URL Rewrite

Host와 URL Rewrite는 모두 접속 과정에 영향을 주지만 일반 Rule을 대신하는 설정은 아닙니다. Host는 지정한 도메인에 어떤 주소를 사용할지 정하고, URL Rewrite는 요청 정보를 확인할 수 있을 때 URL을 처리하며, Rule은 트래픽에 적용할 정책을 정합니다. 세 기능의 역할을 나누면 ‘도메인 매핑을 바꾸면 자동으로 프록시를 사용한다’거나 ‘리디렉션을 쓰면 모든 연결 문제가 해결된다’고 오해하지 않을 수 있습니다.

Host는 주소를 매핑합니다

[Host]
test.example.com = 192.0.2.10

[Rule]
DOMAIN,test.example.com,DIRECT
FINAL,PROXY

여기서는 test.example.com을 192.0.2.10에 매핑하고, Rule에서 해당 도메인에 적용할 정책을 따로 지정합니다. 이 주소는 문서용 예시 범위에 속하며 실제 서비스를 제공하지 않으므로 페이지 접속 여부를 시험하는 데 사용할 수 없습니다. 실제로 사용할 때는 사용 권한이 있고 해당 도메인에 적합하다고 확인한 대상 주소를 입력하세요. 임시 매핑 규칙에는 추가 이유와 해제 조건을 기록하세요.

고정 매핑은 일반적인 DNS 갱신으로 주소가 바뀌는 상황을 우회하지만, 그에 따라 자동으로 서버 변경을 따라가는 기능도 사라집니다. 서비스 이전이나 콘텐츠 전송 경로가 바뀌면 이전 주소가 더 이상 작동하지 않을 수 있습니다. 다른 기기에서는 도메인이 정상인데 현재 설정에서만 문제가 생기면 DNS 서버를 새로 추가하기 전에 오래된 Host 항목이 남아 있는지 확인하세요. 임시 매핑은 검증 후 유지할지 삭제할지 결정해야 합니다.

HTTPS 인증서는 여전히 접속에 사용된 도메인을 주요 기준으로 검증합니다. 도메인을 연결 가능한 임의의 IP에 매핑해도 해당 서버에 올바른 인증서나 해당 사이트가 자동으로 생기지는 않습니다. 인증서 오류를 무시해 주소 불일치를 감추지 마세요. 매핑된 주소가 실제 대상 서비스를 제공하는지 확인하고, 필요하다면 매핑을 해제한 뒤 일반 DNS 경로와 비교하세요.

URL Rewrite 필드

[URL Rewrite]
^http://old\.example\.com/(.*)$ http://new.example.com/$1 302

다음은 HTTP 리디렉션 예시입니다. 첫 부분은 정규식 매칭식, 가운데는 대상 URL, 끝부분은 리디렉션 상태 코드입니다. ^는 문자열 시작 부분부터 매칭하도록 제한하고, 도메인에서 점은 역슬래시로 이스케이프합니다. (.*)는 뒤의 내용을 캡처하며 대상의 $1은 캡처한 그룹을 참조합니다. 문법 설명용 예시일 뿐 두 예시 호스트에 실제로 접속할 수 있는 웹페이지가 있다는 뜻은 아닙니다.

정규식은 프로토콜, 호스트, 필요한 경로만 매칭하도록 범위를 좁히세요. 도메인의 점을 이스케이프하지 않으면 임의의 문자 하나와 일치하는 메타문자로 처리됩니다. 시작 위치를 제한하지 않으면 매칭 범위가 필요 이상으로 넓어질 수도 있습니다. 수정 전에 매칭되어야 하는 URL 하나와 매칭되지 않아야 하는 URL 하나를 정한 다음 표현식이 둘을 구분하는지 확인하세요. 올바른 예시 하나만 테스트하면 범위가 너무 넓은 문제를 놓치기 쉽습니다.

리디렉션은 클라이언트가 새 주소를 다시 요청하게 하므로 반복 리디렉션도 고려해야 합니다. 대상이 다시 같은 정규식에 매칭되거나 다른 규칙이 이전 주소로 되돌리면 무한히 이동할 수 있습니다. 새 도메인도 정상적으로 조회되어야 하고 해당 Rule의 정책을 적용받습니다. 재작성에 성공했다고 새 대상에 접속할 수 있는 것은 아니므로 원래 요청이 처리됐는지, 새 요청이 발생했는지, 이후 라우팅 결과는 어떤지 각각 확인하세요.

암호화 범위 및 민감한 매개변수

일반 HTTPS 전달에서는 암호화된 요청 경로와 헤더 전체를 확인할 수 없습니다. 정규식을 작성했다고 임의의 URL을 재작성할 수 있는 것은 아닙니다. 이 문서에서는 인증서 신뢰, 복호화 조건, 기본 규칙을 혼동하지 않도록 HTTP 예시를 사용합니다. 명확한 필요가 있고 기능을 충분히 이해한 경우가 아니라면 재작성 예시를 시험하려고 기기의 신뢰 설정을 변경하지 마세요. 기본 도메인 분기에는 이런 변경이 필요하지 않습니다.

URL에는 로그인 상태나 다른 민감한 쿼리 매개변수가 포함될 수 있습니다. 예시의 (.*)는 매칭 범위의 내용을 새 대상으로 전달하므로 실제로 사용할 때 도메인 간에 전달하면 안 되는 매개변수가 있는지 확인하세요. 실제 서비스 URL, 인증 링크, 비공개 설정을 공개된 공간에 붙여 넣지 마세요. 문제 해결에는 예시 도메인으로 구조를 설명하고 필드 형식은 유지하되 민감한 값은 삭제하세요.

Host와 재작성을 함께 설정했다면 단계별로 검증하는 것이 좋습니다. 먼저 재작성을 비활성화해 원래 도메인의 주소와 라우팅을 확인하고, 다음에 재작성을 활성화해 대상이 바뀌는지 살펴본 뒤 새 대상의 조회 결과와 정책을 확인하세요. 한 단계씩 다시 활성화하면 고정 주소 만료, 정규식 불일치, 대상 라우팅 오류를 구분할 수 있으며 단순한 DNS 문제를 복잡한 재작성 규칙으로 가리는 일도 줄어듭니다.

검증, 문제 해결 및 관리

규칙 관리의 목표는 설정을 계속 길게 만드는 것이 아니라 중요한 요청마다 현재 정책을 적용하는 이유를 설명할 수 있게 하는 것입니다. 신뢰할 수 있는 절차에는 백업, 한 번에 한 항목 수정, 정방향·역방향 테스트, 롤백이 포함됩니다. 현재 정상적으로 연결되는 설정을 보관한 다음 테스트 사본을 만드세요. 기본 연결부터 불안정하다면 같은 작업에서 모든 규칙을 다시 만들지 말고 서버나 네트워크 문제부터 해결하세요.

정해진 순서에 따라 검증

  1. Home에서 현재 서버가 작동하는지, Global Routing이 Config인지, Config에서 테스트할 파일이 선택되어 있는지 확인하세요.
  2. 규칙 하나만 추가하거나 수정하고 저장한 다음 대상 요청을 새로 만들어 이전 연결 경로가 재사용되지 않도록 하세요.
  3. 대상 도메인, 실제 IP, 주소 체계, 매칭된 규칙, 최종 정책을 확인하고 접속 결과를 기록하세요.
  4. 영향을 받지 않아야 하는 대상도 테스트해 새 조건이 의도한 범위를 벗어나지 않았는지 확인하세요.
  5. 결과가 예상과 일치하면 수정 사항을 유지하세요. 그렇지 않으면 해당 항목을 롤백하고 기준 상태를 복구한 뒤 다음 가설을 시험하세요.

정방향 테스트는 추가한 규칙에 명확히 매칭되어야 하며, 역방향 테스트는 조건을 만족하지 않되 정방향 대상과 최대한 비슷해야 합니다. 예를 들어 접미사 규칙은 같은 접미사 아래의 호스트와 다른 도메인을 각각 테스트할 수 있습니다. 정확한 도메인 규칙은 다른 하위 도메인에도 적용되는지 확인하세요. 이렇게 비교하면 범위가 넓은 앞선 규칙이 먼저 매칭되어 새 규칙이 실제로는 작동하지 않았는데 성공한 것처럼 보이는 문제를 발견할 수 있습니다.

최소 설정으로 충돌 분리하기

[Rule]
DOMAIN,api.example.com,PROXY
FINAL,DIRECT

설정이 길어 판단하기 어렵다면 사본에 정확한 조건 하나와 기본 정책만 남겨 잠시 테스트하세요. 최소 설정이 의도대로 작동하는지 확인한 뒤 다른 규칙을 묶음별로 복구합니다. 특정 묶음을 복구한 뒤 결과가 바뀌면 그 묶음이 대상을 먼저 처리하는지 확인하세요. 원본에서 많은 내용을 지운 뒤 기억에 의존해 다시 작성하지 마세요. 테스트 사본과 명확한 백업이 있어야 매번 신뢰할 수 있는 상태에서 복구할 수 있습니다.

관찰된 현상우선 확인할 항목성급하게 내려서는 안 되는 결론
모든 요청에 같은 정책이 적용되는 것처럼 보임Global Routing, 현재 설정, 먼저 매칭된 규칙모든 도메인 규칙을 지원하지 않음
규칙은 올바르게 매칭되지만 접속 실패DNS, 현재 서버, 대상 서버 응답같은 규칙을 계속 추가하면 해결됨
일부 페이지 기능만 오작동관련 도메인, REJECT, 재작성, 캐시메인 페이지가 열리면 사이트 전체가 정상임
업데이트 후 수정 사항이 사라짐원격 설정 덮어쓰기, 로컬 사본, 선택 상태구독을 업데이트하면 모든 설정이 바뀜

두 종류의 업데이트 구분하기

구독 업데이트는 주로 서비스 제공업체가 제공한 서버 항목을 관리하며, 원격 설정 업데이트는 규칙 텍스트를 교체할 수 있습니다. 두 작업은 같은 것이 아닙니다. 업데이트 전에 사용 중인 항목과 이름을 기록하고, 업데이트 후에는 서버 목록과 설정 내용을 따로 확인하세요. 서버 항목을 새로 고치는 방법만 필요하다면 구독 업데이트 가이드를 참고하세요. 일반적인 갱신을 대신하려고 설정 파일 전체를 반복해서 가져오지 마세요.

장기적으로 관리할 때는 규칙 묶음마다 모호한 ‘수정’이라는 메모 대신 용도를 한 문장으로 적어 두세요. 메모에는 영향 대상, 예상 정책, 유지하는 이유를 포함하고 실제 인증 정보는 기록하지 마세요. 네트워크 환경이나 서비스 도메인이 바뀌면 규칙이 여전히 필요한지 먼저 확인하세요. 만료된 조건을 삭제하면 서로 겹치는 관계가 줄어들어 나중에 문제를 확인하는 사람도 관련 규칙을 찾기 쉽습니다.

문제 해결 자료를 공유할 때는 규칙 유형, 상대적인 순서, 오류 발생 단계만 남기세요. 서버 인증 정보, 비공개 구독 주소, 개인 네트워크 정보는 먼저 삭제해야 합니다. 구독 링크는 이용 중인 서비스 제공업체에서 확인하세요. 인증이나 서버 측 매개변수에 문제가 있다면 기존 서비스 정보를 다시 확인해야 합니다. 이 매뉴얼은 클라이언트 설정을 설명하며 출처를 알 수 없는 서버 정보를 해결의 전제로 삼지 않습니다.

마지막으로 웹페이지 로딩, 로그인, 미디어 재생, 파일 전송 등 실제 동작을 확인하고 네트워크를 전환한 뒤에도 의도대로 작동하는지 검증하세요. 지연 시간 테스트만 한 경우에는 해당 테스트가 작동했다고만 기록해야 하며 전체 설정이 정상이라고 적어서는 안 됩니다. 빠른 시작 절차는 시작 가이드에서 확인하세요. 기기별 설치 방법과 자주 묻는 설치 관련 질문은 전 플랫폼 다운로드 안내를 참고하세요. 안정적인 설정은 재현하고 설명할 수 있어야 하며, 원할 때 명확하게 되돌릴 수 있어야 합니다.