.conf를 수정하기 전에 Config에서 현재 파일을 백업한 뒤 일반 매개변수, 라우팅 규칙, 도메인 매핑, URL 재작성을 각각 확인하세요. 규칙에 따라 트래픽을 분기하려면 Home → Global Routing을 Config로 설정합니다. 이 글은 이미 이용 중인 서비스 제공업체와 구독이 있고 설정 문법을 이해하려는 사용자를 위해, 단계별로 검증할 수 있는 예시와 되돌리는 방법을 안내합니다. 설정 파일은 연결 인증 정보가 아닙니다.
1. .conf의 섹션 구성과 적용 조건
Shadowrocket의 .conf는 텍스트 설정 파일입니다. 대괄호 안에는 섹션 이름을 쓰고, 각 섹션에는 해당 문법에 따라 매개변수나 규칙을 입력합니다. [General]은 보통 키 = 값 형식을 사용하고, [Rule]은 쉼표로 구분한 규칙을 한 줄씩 작성합니다. 두 문법을 섞어 쓰면 안 됩니다. 저장에 성공했더라도 설정이 적용된 것은 아니므로 Config에서 현재 선택된 파일을 확인해야 합니다.
아래는 구조를 이해하기 위한 최소 예시이며, 기존 설정을 그대로 대체할 수 있는 완성된 연결 구성은 아닙니다. PROXY는 현재 선택된 프록시를 사용합니다. 사용 가능한 서버와 인증 정보는 미리 설정되어 있어야 합니다. 예시에 나온 도메인과 문서용 주소는 문법 설명에만 사용하며, 실제 서비스에 연결할 수 있다는 뜻은 아닙니다.
[General]
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[Host]
lab.example.com = 192.0.2.10
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
Home에서는 주로 서버 선택과 연결을 처리하고, Config에서는 설정 파일을 관리하며, Settings에서는 앱 설정을 변경합니다. Subscribe로 가져오거나 업데이트하는 것은 구독에 포함된 연결 항목입니다. 이 작업으로 로컬 .conf도 함께 업데이트된다고 볼 수는 없습니다. 반대로 .conf의 규칙을 수정해도 서버 주소, 비밀번호, 구독 인증은 변경되지 않습니다. 문제를 해결할 때는 이 두 부분을 나누어 기록하세요.
2. [General]: DNS와 IPv6를 먼저 이해한 뒤 일반 매개변수 조정하기
[General]은 설정의 기본 동작에 영향을 줍니다. 먼저 확인할 항목은 DNS의 출처입니다. dns-server = system은 시스템이 제공하는 DNS를 사용한다는 뜻입니다. 특정 공용 DNS 서버를 지정하는 설정은 아닙니다. Wi-Fi와 셀룰러 네트워크를 전환하면 시스템에서 사용하는 DNS 환경도 달라질 수 있습니다. 도메인 이름을 확인하지 못한다면 시스템 네트워크 자체의 문제인지, 현재 설정이 다른 DNS 동작을 유발했는지 먼저 구분하세요.
[General]
dns-server = system
ipv6 = false
ipv6 = false는 IPv6 관련 문제를 진단할 때 사용할 수 있지만, 모든 네트워크에 적용할 고정 최적화 설정은 아닙니다. IPv6 지원을 끄면 사용할 수 있는 주소 계열이 달라집니다. 일부 네트워크는 IPv6에 의존하므로 그대로 복사하면 연결 가능한 경로가 줄어들 수 있습니다. 기존 설정이 정상 작동한다면 값을 유지하고, 명확한 증상이 있을 때만 한 항목씩 비교 테스트한 뒤 원래 값으로 되돌릴지 결정하세요.
General 매개변수 확인
- dns-server
- system: 시스템에서 제공하는 DNS를 사용합니다.
- ipv6
- false: 해당 설정에서 IPv6 지원을 끕니다. 특정 문제를 진단할 때 사용합니다.
- 변경 단위
- 한 번에 한 항목만 변경하고 저장한 뒤 새 연결로 확인하세요.
여러 매개변수를 동시에 바꾼 뒤 나온 결과를 특정 항목 하나의 영향으로 단정하지 마세요.
Rule 문법 확인
- DOMAIN-SUFFIX
- example.com,PROXY: 도메인 접미사로 매칭합니다.
- IP-CIDR
- 192.0.2.10/32,DIRECT,no-resolve: 단일 IPv4 주소와 매칭합니다.
- FINAL
- DIRECT: 앞선 규칙에 일치하지 않을 때 적용할 최종 정책입니다.
규칙은 영문 쉼표로 구분하고, FINAL에는 도메인이나 네트워크 대역을 입력하지 않습니다.
설정 파일의 DNS와 기기에서 현재 사용하는 네트워크 DNS는 서로 다른 계층의 결과일 수 있습니다. 브라우저가 기존 연결이나 캐시를 사용 중이라면 변경 직후 새로고침해도 차이가 나타나지 않을 수 있습니다. 테스트할 때는 파일을 저장하고 적용 여부를 확인한 뒤 연결을 새로 만드세요. 필요하면 대상 앱을 완전히 종료했다가 다시 열어 기존 연결로 새 매개변수를 판단하지 않도록 합니다.
3. [Rule]: 위에서부터 매칭하고 FINAL은 맨 끝에 배치
[Rule]은 위에서 아래로 매칭하는 것이 핵심이며, 먼저 일치한 유효 규칙이 해당 요청의 정책을 결정합니다. 더 구체적인 예외 규칙은 대개 범위가 넓은 규칙보다 앞에 둡니다. 예를 들어 status.example.com은 직접 연결하고 나머지 example.com 도메인은 프록시를 사용하려면, 정확한 도메인 규칙을 접미사 규칙보다 앞에 배치해야 합니다.
[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
| 규칙 키워드 | 매칭 대상 | 확인할 사항 |
|---|---|---|
| DOMAIN | 완전한 도메인 하나 | 프로토콜, 포트, 경로는 포함하지 않습니다. |
| DOMAIN-SUFFIX | 도메인 자체와 하위 도메인 | example.com은 api.example.com에도 적용될 수 있지만, 임의의 문자열 포함 여부를 검사하는 것은 아닙니다. |
| IP-CIDR | 대상 IPv4 주소 범위 | /24는 네트워크 대역입니다. no-resolve는 이 규칙에 매칭하려고 도메인 조회를 실행하지 않도록 합니다. |
| GEOIP | 주소 데이터베이스에 등록된 지역 정보 | CN은 주소 데이터베이스의 지역 코드이며, 매칭 결과는 해당 데이터베이스의 기록을 따릅니다. |
| FINAL | 앞선 규칙과 일치하지 않은 요청 | 맨 끝에 배치하고 DIRECT 또는 PROXY를 명시합니다. |
no-resolve는 앱 전체의 DNS를 끄는 설정도, “이 도메인을 조회하지 말라”는 뜻도 아닙니다. 해당 IP 규칙의 매칭 과정에만 적용됩니다. 도메인 요청이 이 규칙에 도달했을 때 매칭에 사용할 대상 IP가 없다면 규칙이 반드시 적용된다고 볼 수 없습니다. 특정 도메인을 정확히 제어하려면 주소 정보에만 의존하지 말고 DOMAIN 또는 DOMAIN-SUFFIX를 우선 사용하세요.
요약: 구체적인 규칙부터 확인하고 마지막에 기본 규칙 검증하기
먼저 status.example.com에 해당하는 실제 테스트 대상으로 구체적인 예외 규칙을 확인하고, 이어서 접미사 규칙을 점검한 뒤 앞선 범위에 속하지 않는 자체 테스트 대상을 확인하세요. FINAL을 앞쪽에 두면 뒤에 있는 예외 규칙은 예상대로 매칭되지 않습니다. 중복 규칙을 더 추가하기보다 먼저 순서를 조정하세요.
규칙이 라우팅에 적용되는지는 Home → Global Routing 설정에도 달려 있습니다. Config는 현재 설정에 따라 트래픽을 분기합니다. Proxy와 Direct는 각각 전체 프록시와 전체 직접 연결 방향을 선택하는 모드이므로 규칙 기반 분기 결과를 검증하기에는 적절하지 않습니다. Scene은 설정된 시나리오 조건에 따라 라우팅 동작을 선택하며 Config와 같은 의미가 아닙니다. 이 글의 예시를 점검할 때는 먼저 Config를 선택하세요.
4. [Host]: 도메인 매핑만 입력하고 URL은 넣지 않기
[Host]는 도메인을 특정 주소에 로컬로 매핑할 때 사용합니다. 왼쪽에는 도메인, 오른쪽에는 대상 IP를 입력하세요. https://, 경로, :443은 입력하지 않습니다. 포트는 연결 대상 정보에 해당하며 이러한 도메인 매핑에 포함되지 않습니다. 아래 예시는 문서용으로 예약된 주소를 사용하므로 실제 웹사이트 연결 테스트에 쓸 수 없습니다.
[Host]
lab.example.com = 192.0.2.10
status.example.com = 192.0.2.20
- 사용 사례: 사용자가 관리하는 테스트 도메인을 특정 서버에 임시로 연결해야 하고, 해당 서버가 그 도메인의 요청을 받는다는 점을 확인한 경우입니다.
- 변경되지 않는 항목: 매핑해도 브라우저 주소창의 도메인은 바뀌지 않으며, 대상 서버에 맞는 TLS 인증서가 자동으로 생성되지도 않습니다.
- 흔한 실수:
lab.example.com:443을 왼쪽 값으로 쓰거나, 오른쪽 값에 웹페이지 전체 경로를 입력하는 경우입니다. - 되돌리는 방법: 해당 매핑을 삭제하거나 주석 처리한 뒤 저장하고 연결을 새로 만든 다음, 현재 사용 중인 Config를 확인하세요.
Host 매핑은 강제 직접 연결과 같은 기능이 아닙니다. 요청에 최종적으로 어떤 정책이 적용되는지는 Global Routing과 규칙에 따라 달라집니다. 도메인에 IP를 지정했다고 해서 모든 도메인 규칙을 우회한다고 가정해서도 안 됩니다. 직접 관리하는 HTTPS 서비스에서 테스트할 때는 주소 매핑, 라우팅 규칙 적용, 인증서 도메인, 서버 응답을 각각 확인하세요. 네 항목은 서로 대체할 수 없습니다.
5. [URL Rewrite]: HTTP 리디렉션 예시로 작성법 이해하기
[URL Rewrite]는 URL 매칭과 재작성을 처리하며, 서버 인증 문제를 해결하거나 DNS를 매핑하는 기능은 아닙니다. 일반적인 리디렉션 규칙은 매칭 표현식, 대상 URL, 상태 코드로 구성되며 각 필드는 공백으로 구분합니다. 아래 예시는 문서용 사이트의 HTTP 요청을 HTTPS로 리디렉션하면서 경로를 유지합니다.
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
^는 URL의 시작부터 매칭하도록 제한해 표현식이 다른 위치에서 잘못 매칭되는 것을 방지합니다.example\.com에서는 마침표 앞에 백슬래시를 붙여 이스케이프합니다. 이렇게 하면 정규식의 임의 문자 대신 일반 마침표로 처리됩니다.(.*)는 뒤따르는 내용을 캡처하고, 대상의$1은 첫 번째 캡처 그룹의 결과를 참조합니다.302는 임시 리디렉션을 뜻합니다. 클라이언트가 리디렉션 결과에 따라 후속 요청을 보내도록 하며 서버 응답 본문을 직접 바꾸지는 않습니다.
이 규칙의 원본 주소는 HTTP로 명시되어 있습니다. 표현식의 http만 https로 바꾸면 모든 암호화된 요청의 전체 URL을 읽을 수 있다고 생각해서는 안 됩니다. 일반적인 터널 전달은 TLS 내부의 경로와 콘텐츠를 확인하는 것과 다릅니다. 일부 브라우저는 HSTS 또는 HTTPS 우선 정책에 따라 요청을 보내기 전에 주소를 HTTPS로 바꾸므로, 이 경우 HTTP 예시와 매칭되지 않을 수 있습니다.
URL Rewrite와 Rule은 해결하는 문제가 다릅니다. 전자는 매칭된 요청의 URL 동작을 바꾸고, 후자는 연결에 적용할 라우팅 정책을 결정합니다. 리디렉션 규칙이 적용되더라도 이후 대상에 연결할 수 있는지는 DNS, 라우팅, 서버 상태에 달려 있습니다. 페이지가 끝내 열리지 않는다면 초기 요청, 리디렉션 과정, 새 대상 연결 중 어느 단계에서 실패했는지 먼저 확인하세요.
6. 저장·적용·되돌리기: 한 번에 하나씩 검증
편집 전에 Config에서 현재 정상 작동하는 파일을 복사해 두고 파일 이름을 기록하세요. 편집 메뉴는 플랫폼마다 다르게 표시될 수 있으므로 현재 앱에서 제공하는 편집, 복사, 내보내기 기능을 이용하세요. 작업 중인 설정 파일 한 개만 남겨 둔 채 직접 덮어쓰지 마세요. 원격 설정도 로컬 복사본을 보관해야 이후 업데이트로 수동 변경 내역을 추적하기 어려워지는 상황을 피할 수 있습니다.
- Config에서 수정할 파일을 열고 한 섹션에서 한 항목만 변경한 다음 영문 구두점을 사용해 저장하세요.
- 해당 파일이 현재 설정으로 선택되어 있는지 확인한 뒤 Home → Global Routing에서 Config를 선택하세요.
- 현재 선택된 프록시를 사용할 수 있는지 확인하세요. 규칙 문법이 올바르더라도 유효한 서버 인증 정보가 없으면 연결할 수 없습니다.
- 연결을 새로 만들고 해당 규칙과 직접 관련된 테스트 대상에 접속한 다음, 앱에서 제공하는 연결 기록이나 로그를 확인하세요.
- 대상 도메인, 예상 정책, 실제 결과, 변경한 항목을 기록하세요. 실패하면 백업 파일로 되돌린 뒤 동일한 요청을 다시 보내 비교하세요.
Settings → On Demand는 조건에 따라 연결을 시작하는 기능이며, Rule의 매칭 순서와는 별개의 문제입니다. 수동으로 연결을 끊었는데 다시 연결된다면 FINAL을 삭제하지 말고 On Demand 조건을 확인하세요. 문제를 진단할 변수를 줄이려면 테스트 중에는 On Demand를 잠시 끄고, 검증이 끝난 뒤 원래 설정으로 되돌릴 수 있습니다.
Rule을 수정했는데 왜 모든 웹사이트가 같은 경로로 연결되나요?
먼저 Home → Global Routing이 Config로 설정되어 있는지 확인한 다음 Config에서 현재 선택된 파일을 확인하세요. 이어서 FINAL 앞에 적용 범위가 지나치게 넓은 규칙이 있는지 점검하고, 기존의 긴 연결 페이지를 새로고침하는 대신 연결을 새로 만들어 테스트하세요.
구독을 업데이트했는데 로컬 규칙은 왜 바뀌지 않나요?
서버 구독과 로컬 .conf는 서로 다른 설정 객체입니다. Config에서 현재 파일의 내용을 확인하세요. 원격 설정을 업데이트하려면 해당 설정을 직접 업데이트하고 결과를 확인해야 합니다. Subscribe의 업데이트 시각만으로 업데이트 여부를 판단하지 마세요.
Host를 추가한 뒤 HTTPS에서 인증서가 일치하지 않는다고 표시되는 이유는 무엇인가요?
매핑된 주소가 해당 도메인을 처리하는지, 서버 인증서에 해당 도메인이 포함되어 있는지 확인하세요. Host는 주소 매핑만 변경할 뿐 인증서 문제를 해결하지 않습니다. 먼저 해당 매핑을 되돌려 기존 경로를 확인한 뒤 서버 관리자에게 인증서와 사이트 설정을 점검하도록 요청하세요.
저장 후 구문 분석 오류가 발생하면 어디부터 확인해야 하나요?
오류 메시지에 표시된 줄 번호를 기준으로 섹션 이름과 영문 구두점을 먼저 확인하세요. Rule은 영문 쉼표, General과 Host는 등호, URL Rewrite는 필드 사이의 공백을 사용합니다. 방금 추가한 내용을 되돌려 원본 파일이 정상인지 확인한 다음 한 줄씩 다시 추가하세요.