이 글은 서비스 정보를 이미 보유하고 있으며 Shadowrocket 설정 파일을 읽거나 수정하려는 사용자를 위한 안내입니다. 먼저 네 설정 섹션의 경계를 파악하고, 확인 가능한 규칙과 매핑 예시로 매칭 과정을 살펴봅니다. 마지막으로 백업, 편집, 적용, 검증 순서로 진행합니다. 예시는 문법 설명용이며 기존 설정을 통째로 대체하는 완성된 구성 파일이 아닙니다.
플랫폼을 확인한 뒤 서비스 정보와 설정 파일을 구분하세요
Shadowrocket(Shadowrocket) 다운로드 경로는 전체 플랫폼 다운로드 페이지에서 확인할 수 있습니다. iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매하며, 개발자는 Shadow Launch Technology Limited입니다. 시스템 요구 사항은 App Store 페이지의 안내를 따릅니다. Mac(Apple 실리콘 / Intel), Windows, Android, Linux 버전은 무료입니다. 아래에서는 Home, Config, Settings 등 인터페이스 용어로 조작 위치를 안내하며, 구체적인 컨트롤 위치는 사용 중인 플랫폼의 화면을 확인하세요.
서비스 정보는 “어떤 서버에 어떤 프로토콜과 인증 정보로 연결할지”를 정하고, 설정 파일은 “트래픽을 어떻게 처리할지”를 정합니다. 기존 구독에 포함된 서버 항목과 Config에서 활성화한 .conf 파일은 서로 다른 항목입니다. 구독을 업데이트해도 설정이 자동으로 전환되는 것은 아니며, 설정을 선택해도 사용할 수 있는 서버가 자동으로 추가되는 것은 아닙니다. 이 글은 사용자가 이미 자신의 서비스 제공업체와 구독을 보유한 경우를 전제로 하며, 노드나 구독을 제공·판매·추천하지 않습니다.
.conf 기본 구조: 섹션 이름, 키-값, 규칙 행
.conf는 텍스트 형식의 설정 파일입니다. 대괄호 안의 이름으로 섹션을 선언하며, 다음 섹션 이름이 나올 때까지 이어지는 행은 해당 섹션에 포함됩니다. 섹션마다 문법이 다릅니다. [General]과 [Host]에는 주로 키-값 형식이 쓰이고, [Rule]에는 쉼표로 구분한 필드가 사용됩니다. [URL Rewrite]는 매칭 표현식, 대상, 동작으로 내용을 구성합니다. 한 섹션의 문장을 다른 섹션에 그대로 옮겨 쓸 수는 없습니다.
[General]
dns-server = system
[Rule]
DOMAIN,example.com,DIRECT
FINAL,PROXY
[Host]
example.com = 192.0.2.10
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
파일을 읽을 때는 먼저 섹션 이름을 찾고, 각 행에서 매개변수를 구분하는 문자를 확인하세요. 규칙의 쉼표는 영문 반각 문자를 사용해야 하며, 정규식의 백슬래시가 편집기에서 바뀌지 않도록 주의해야 합니다. 문제를 추적할 때는 수정 이유를 별도의 주석 행에 기록하세요. 모든 행의 끝에 주석을 자유롭게 덧붙일 수 있다고 가정하면 안 됩니다. 확장자가 같더라도 다른 형식의 설정 파일을 그대로 가져올 수 있는 것은 아닙니다.
[General]: 전역 옵션과 사이트별 트래픽 분기는 다릅니다
[General]에는 DNS 관련 설정처럼 전체 동작에 영향을 주는 옵션이 포함됩니다. 예시의 dns-server = system은 시스템 DNS를 사용하도록 지정한다는 뜻입니다. 이는 명시적인 설정이며 앱의 현재 기본 동작을 나타내는 것이 아니고, 모든 네트워크 환경에 적합하다고 보장하지도 않습니다. 시스템 네트워크에서 DNS 조회가 되지 않는다면 시스템 DNS를 선택하는 것만으로 상위 네트워크의 장애가 해결되지는 않습니다.
- 먼저 문제의 단계를 확인하세요: 도메인에서 주소를 얻지 못하면 DNS를 확인하세요. 주소는 얻었지만 연결 시간이 초과된다면 라우팅, 서버 포트, 전송 조건을 이어서 점검하세요.
- 관련 옵션만 수정하세요: 특정 도메인의 정책이 잘못 적용되는 문제를 해결하면서 DNS, IPv6, 여러 규칙을 한꺼번에 변경하지 마세요. 어떤 변경이 영향을 줬는지 확인하기 어려워집니다.
- 적용 중인 설정을 확인하세요: Config에 저장된 텍스트가 현재 활성화된 설정이어야 합니다. 이름이 같은 다른 파일을 편집해도 현재 사용 중인 파일이 자동으로 바뀌지는 않습니다.
- 값을 추측하지 마세요: 생소한 키를 발견하면 먼저 설정 상세 안내에서 용도와 적용 조건을 확인하세요. 키 이름만 보고 불리언 값을 추측하거나 다른 설정 형식의 내용을 그대로 복사하지 마세요.
Settings의 동작 옵션도 별도로 확인해야 합니다. 예를 들어 Settings → On Demand는 조건에 따라 연결을 시작하는 기능이지, example.com에 어떤 Rule을 적용할지 정의하는 기능이 아닙니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 규칙 섹션을 먼저 삭제하지 말고 On Demand의 활성화 상태와 조건을 확인하세요.
[Rule]: 순서대로 매칭한 뒤 대상 정책을 적용합니다
[Rule]의 핵심은 “매칭 조건 + 처리 대상”입니다. 일반 규칙은 위에서 아래로 검사하며, 일치하는 규칙을 찾으면 해당 대상이 적용됩니다. 따라서 구체적인 예외 규칙은 보통 포괄적인 규칙보다 앞에 둡니다. DIRECT는 직접 연결, REJECT는 거부를 뜻하고, PROXY는 프록시 정책에 사용됩니다. 사용자 지정 정책 이름을 쓰려면 현재 설정에 해당 정책이 실제로 정의되어 있어야 합니다. 임의로 이름을 적어서는 안 됩니다.
| 키워드 | 예시 | 매칭 의미 |
|---|---|---|
DOMAIN | DOMAIN,example.com,DIRECT | example.com과 정확히 일치하는 도메인을 매칭하며 하위 도메인은 포함하지 않습니다. |
DOMAIN-SUFFIX | DOMAIN-SUFFIX,example.com,PROXY | example.com과 그 하위 도메인을 매칭합니다. 임의의 문자열 끝부분과 일치시키는 규칙은 아닙니다. |
DOMAIN-KEYWORD | DOMAIN-KEYWORD,example,REJECT | 도메인에 example이 포함된 요청을 매칭하므로 예상보다 넓은 범위가 적용될 수 있습니다. |
IP-CIDR | IP-CIDR,192.0.2.0/24,DIRECT | 대상 IPv4 주소 대역을 기준으로 매칭합니다. 여기서는 문서용 예시 대역을 사용합니다. |
GEOIP | GEOIP,CN,DIRECT | IP 지리 데이터베이스에서 식별한 지역을 기준으로 매칭하며, 웹페이지 내용과는 무관합니다. |
FINAL | FINAL,PROXY | 앞선 규칙에 매칭되지 않은 트래픽을 처리하며, 일반적으로 규칙의 마지막에 둡니다. |
예를 들어 example.com은 직접 연결하고 나머지 하위 도메인은 프록시를 사용하게 하려면 DOMAIN,example.com,DIRECT를 먼저 작성한 다음 DOMAIN-SUFFIX,example.com,PROXY를 작성합니다. 순서를 반대로 하면 루트 도메인이 먼저 접미사 규칙에 매칭되어 뒤의 정확한 도메인 규칙이 해당 요청을 처리하지 못합니다.
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT
FINAL,PROXY
도메인 규칙과 IP 규칙은 서로 다른 기준으로 매칭됩니다. IP 유형 규칙은 DNS 조회와 관련될 수 있으며, 구체적인 동작은 관련 옵션의 영향을 받습니다. “IP 주소가 특정 지역으로 분류된다”는 것을 “도메인이 해당 지역에 등록되어 있다”는 뜻으로 해석하지 마세요. 검증할 규칙보다 FINAL을 앞에 두지 마세요. 결과를 판단할 때는 웹페이지가 열리는지만 보지 말고 실제로 어떤 규칙이 적용됐는지도 확인해야 합니다.
Global Routing: 현재 Config 기준으로 트래픽을 분기하는지 확인
파일 문법은 맞는데 규칙이 예상대로 작동하지 않는다면 먼저 Home → Global Routing에서 현재 모드를 확인하세요. Config를 선택해야 해당 설정의 Rule 분기를 직접 검증할 수 있습니다. Proxy와 Direct는 전체 트래픽 처리 방향을 전환하는 모드이며, 개별 규칙 테스트를 대신하지 않습니다.
Config
권장현재 활성 설정의 규칙에 따라 트래픽을 분기합니다. 규칙에 매칭되면 PROXY, DIRECT, REJECT 또는 정의된 정책이 적용될 수 있습니다.
적합한 경우: 이 글의 Rule 예시와 규칙 순서를 검증할 때
Proxy
트래픽을 프록시로 처리합니다. 같은 도메인 규칙에 따라 프록시와 직접 연결을 선택하는 방식은 아니며, 사용 가능한 프록시 연결이 필요합니다.
적합한 경우: 문제가 Config의 트래픽 분기와 관련 있는지 비교해 확인할 때
Direct
트래픽을 직접 연결로 처리합니다. 직접 연결로 웹사이트가 열린다고 해서 프록시 설정이 올바르거나 Rule이 매칭된 것은 아닙니다.
적합한 경우: 로컬 네트워크에서 대상에 직접 접속할 때의 상태를 확인할 때
Scene
상황 조건에 따라 해당 설정을 적용합니다. 결과를 판단하기 전에 현재 적용된 Scene과 그 설정을 확인해야 하며, 편집한 파일만 확인해서는 안 됩니다.
적합한 경우: Scene 조건을 설정했고 환경에 따라 전환하려는 경우
[Host]: 조회 주소를 지정하며 포트와 인증은 설정하지 않습니다
[Host]는 로컬 도메인 매핑에 사용됩니다. example.com = 192.0.2.10은 해당 이름을 지정된 주소에 연결한다는 뜻이지, 웹사이트를 프록시로 전환하거나 서비스 포트를 변경한다는 의미가 아닙니다. 여기 쓰인 주소는 예시이므로 실제 서비스에 사용할 수 없습니다. 실제 매핑에는 사용 권한이 있는 서비스나 관리 대상 네트워크의 주소를 사용해야 합니다.
Host 매핑과 Rule 분기를 구분하세요
Host는 이름과 주소를 처리합니다
- 도메인이 어떤 주소에 연결될지 정합니다.
- 매핑에는 URL 경로나 로그인 정보를 넣지 않습니다.
- 주소가 변경되면 기존 매핑이 아직 유효한지 확인해야 합니다.
Rule은 트래픽 처리 정책을 결정합니다
- 요청을 직접 연결할지, 프록시로 보낼지, 거부할지 정합니다.
- DOMAIN-SUFFIX는 하위 도메인까지 매칭할 수 있습니다.
- 규칙 순서에 따라 어떤 조건이 먼저 처리될지 결정됩니다.
주소와 정책을 모두 바꿔야 한다면 Host와 Rule을 각각 확인하세요. Host만 추가해도 트래픽 분기 규칙을 대신할 수는 없습니다.
HTTPS에서는 인증서의 도메인도 검증합니다. 도메인을 임의의 주소에 매핑한다고 해서 그 주소에 설치된 인증서가 유효해지는 것은 아닙니다. 매핑을 추가한 뒤 인증서 이름 불일치, 잘못된 사이트 연결, 지속적인 시간 초과가 발생하면 인증서 오류를 무시해 문제를 감추지 말고 매핑을 취소한 뒤 서비스 주소를 확인하세요. 자체 DNS 조회 방식을 사용하는 앱이 이 매핑을 반드시 따르는 것도 아닙니다.
[URL Rewrite]: 요청 URL을 매칭해 재작성 작업을 수행합니다
[URL Rewrite]는 URL을 처리하며 서버 프로토콜을 선택하지 않습니다. 아래 행은 정규식으로 http://example.com/으로 시작하는 주소를 매칭해 경로를 HTTPS 대상에 유지한 채 302 리디렉션을 적용합니다. 표현식의 \.은 문자 그대로의 마침표를 뜻하고, (.*)는 나머지 경로를 캡처하며, $1은 첫 번째 캡처 그룹을 참조합니다.
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
- 매칭 범위를 확인하세요: 앞의
^는 매칭 시작점을 제한합니다. 이 예시는 다른 하위 도메인이나 이미 HTTPS를 사용하는 원래 URL에는 매칭되지 않습니다. - 리디렉션을 이해하세요:
302는 임시 리디렉션을 뜻합니다. 클라이언트는 리디렉션 주소로 후속 요청을 보내며, 백그라운드에서 대상 IP만 조용히 바꾸는 동작은 아닙니다. - DNS와 혼동하지 마세요: Host는 이름에 대응하는 주소를 바꾸고, URL Rewrite는 요청 URL의 처리 방식을 바꿉니다. 서로 다른 단계의 설정입니다.
- 콘텐츠 확인 범위에 유의하세요: 암호화된 HTTPS 요청의 전체 경로를 읽고 재작성하려면 보통 별도의 HTTPS 복호화 조건이 필요합니다. 규칙 하나만 작성해도 암호화된 콘텐츠를 자동으로 볼 수 있는 것은 아닙니다.
수정 및 검증: 한 번에 변수 하나만 변경하세요
처음 수정하기 전에 복원할 수 있는 사본을 보관하세요. 완성된 설정에는 다른 섹션이나 원격 참조가 포함될 수 있습니다. 이 글에서 네 섹션만 다룬다고 해서 나머지 내용을 전부 삭제하면 안 됩니다. 다음 절차는 현재 연결이 가능한 설정을 바탕으로 수정 범위를 줄이기 위한 것이며, 서비스를 처음부터 다시 구성하는 방법이 아닙니다.
-
설정 백업
Config에서 현재 활성화된 설정을 찾고, 해당 항목의 내보내기 또는 공유 기능으로 사본을 저장하세요. 파일 이름과 현재 Global Routing 모드도 기록합니다.
-
항목 하나만 수정
Config에서 해당 설정의 편집 화면을 열고 한 섹션의 항목 하나만 수정하세요. Rule을 테스트할 때는 먼저 정확한 DOMAIN 규칙 하나를 추가하고 DNS와 Host는 동시에 변경하지 마세요.
-
활성화 상태 확인
저장한 뒤 Config로 돌아가 수정한 파일이 선택되어 있는지 확인하세요. 이어서 Home → Global Routing에서 Config를 선택해 Proxy 또는 Direct 모드에서 규칙 효과를 판단하지 않도록 합니다.
-
새 요청 보내기
대상 앱의 기존 연결을 종료한 다음 새 요청을 보내세요. 확인할 수 있는 연결 기록에서 대상 도메인과 실제 적용된 정책을 살펴봅니다. 이미 연결된 장시간 연결은 이전 처리 결과를 계속 사용할 수 있습니다.
-
기록 및 복원
수정한 행, 매칭 결과, 오류 증상을 기록하세요. 결과가 이상하면 백업을 복원하고 동일한 테스트를 다시 진행하세요. 검증되지 않은 설정을 계속 추가하지 마세요.
기존 구독도 업데이트해야 한다면 별도의 작업으로 진행하세요. 구독 업데이트가 완료됐는지, Home에서 선택한 서버가 여전히 유효한지 확인한 뒤 설정을 테스트합니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard의 연결 매개변수는 각 프로토콜과 서버 설정에 속합니다. FINAL,PROXY를 추가해도 잘못된 비밀번호, 포트 또는 인증 정보는 수정되지 않습니다.
자주 발생하는 현상과 확인 항목
설정을 저장했는데도 example.com에 새 규칙이 적용되지 않는 이유는 무엇인가요?
Config에서 활성화된 파일, Home → Global Routing이 Config인지 여부, 대상보다 앞에 더 포괄적인 규칙이 있는지, 요청이 기존 연결을 계속 사용 중인지 차례로 확인하세요. 실제 요청이 하위 도메인이라면 DOMAIN,example.com,DIRECT만으로는 매칭되지 않습니다. 원하는 범위에 따라 정확한 도메인 규칙 또는 DOMAIN-SUFFIX를 선택하세요.
Host를 추가한 뒤 지연 시간은 정상인데 웹페이지가 열리지 않으면 어떻게 하나요?
새 매핑을 먼저 제거한 뒤 같은 대상으로 새 요청을 보내세요. 서버 지연 시간 테스트와 대상 웹사이트의 DNS 조회는 서로 다른 테스트입니다. 지연 시간이 정상이어도 Host 주소가 정확하거나 대상 서비스가 요청을 받고 있거나 인증서가 일치한다는 뜻은 아닙니다. 이 글의 192.0.2.10은 설명용 주소일 뿐입니다. 그대로 두면 해당 접속이 예시 주소로 향합니다.
원격 설정을 업데이트한 뒤 로컬 수정 내용이 사라지는 이유는 무엇인가요?
원격 콘텐츠 업데이트로 로컬 파일이 대체될 수 있으며, 구체적인 동작은 가져오기 및 관리 방식에 따라 다릅니다. 유지해야 할 수정 사항은 별도 사본으로 저장하고 변경점을 기록한 뒤 업데이트 후 하나씩 확인하세요. 로컬에 추가한 Rule이 원격 콘텐츠와 자동으로 병합된다고 가정하지 마세요. 인증 정보가 포함된 설정 파일 전체나 구독 링크를 공개하지 마세요.
네 섹션을 모두 작성해야 하나요?
형식을 완성하려고 빈 섹션이나 관련 없는 설정을 추가할 필요는 없습니다. 고정 매핑이 필요하지 않다면 Host를 그대로 복사하지 않아도 되고, 재작성할 필요가 없다면 URL Rewrite를 추가하지 않아도 됩니다. 구체적인 목적에 필요한 내용만 유지하고 현재 유효한 설정을 기준으로 기본 동작을 확인하세요. 이 글의 예시를 모든 상황에 적용되는 기본 설정으로 사용하면 안 됩니다.
Shadowrocket 다운로드 및 기본 사용법
iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매할 수 있으며, Mac(Apple 실리콘 / Intel) / Windows / Android / Linux 버전은 무료입니다. 먼저 다운로드 페이지에서 기기를 선택한 뒤, 안내에 따라 이미 보유한 서비스 정보를 가져오세요. 설정 파일은 설정과 트래픽 분기를 관리하며, 서비스 회선을 포함하지 않습니다.