Shadowrocket .conf 설정 파일 구조 해설: General·Rule·Host·URL Rewrite 역할

.conf 설정 파일의 각 섹션을 살펴봅니다. General은 전역 설정, Rule은 트래픽 분기 순서, Host는 로컬 매핑, URL Rewrite는 요청 변경을 담당합니다. 작성 형식과 자주 하는 실수도 함께 알아봅니다.

이 글의 핵심 내용

이 글은 Home에서 연결을 설정할 수 있고 Config에서 .conf 파일을 읽거나 수정하려는 사용자를 위한 안내입니다. 먼저 연결 정보와 설정 파일의 차이를 짚고, General·Rule·Host·URL Rewrite 네 섹션의 문법과 적용 조건을 확인합니다. 마지막으로 한 번에 하나씩 수정하고 되돌리는 방법으로 문제를 찾습니다. 예시에는 예약 도메인과 문서용 주소를 사용하며, 실제로 사용할 수 있는 연결 설정은 포함하지 않습니다.

.conf 파일, 연결 정보, Global Routing 구분하기

Shadowrocket의 .conf는 전역 설정, 트래픽 분기 규칙 및 기타 요청 처리 옵션을 정의하는 텍스트 설정 파일입니다. 서버 구독과는 다릅니다. Home의 연결 정보는 서버에 연결하는 방법을 지정하고, Config에서 현재 활성화된 파일은 트래픽을 어떤 조건으로 처리할지 결정합니다. 사용 중인 구독은 서비스 제공업체에서 받으세요. 이 사이트는 연결 노드나 구독을 제공·판매·추천하지 않습니다.

“규칙을 바꿨는데 달라진 게 없다”면 먼저 Home → Global Routing을 확인하세요. Proxy, Direct, Config, Scene은 서로 다른 라우팅 모드입니다. 이 글의 Rule 예시를 확인하려면 Config를 선택하고, Config에서 활성화한 파일이 방금 편집한 파일인지 확인해야 합니다. Proxy는 개별 분기 규칙을 검증하는 모드가 아니며, Direct도 프록시 정책을 확인하기에 적절하지 않습니다. Scene을 사용한다면 해당 장면에 실제로 적용된 설정도 확인하세요.

4개 섹션
이 글의 범위: General·Rule·Host·URL Rewrite
4가지
Global Routing:Proxy / Direct / Config / Scene
/32
IPv4 CIDR에서 단일 주소만 지정하는 접두사 길이

설정 파일을 확인하는 과정을 다음 다섯 단계로 나눌 수 있습니다. 이는 문제 해결 순서이며, 클라이언트 내부의 모든 처리 모듈이 항상 이 순서대로 실행된다는 뜻은 아닙니다. 특히 URL Rewrite와 DNS, 규칙 매칭이 모든 요청에서 단순한 하나의 처리 흐름을 따른다고 단정할 수 없습니다.

연결 정보 확인 라우팅 모드 확인 활성화된 파일 확인 설정 섹션 확인 요청 결과 검증

.conf 기본 구조: 섹션 이름, 등호, 영문 구분 기호

섹션 이름은 [General]처럼 영문 대괄호로 감쌉니다. General과 Host에서는 보통 키 = 값 형식을 사용합니다. Rule은 영문 쉼표로 규칙 유형, 일치 조건, 정책을 구분하며, URL Rewrite는 규칙 자체의 공백 구분 형식을 사용합니다. 한 섹션의 작성법을 다른 섹션에 그대로 적용하면 안 됩니다.

아래는 구조를 살펴보기 위한 최소 예시입니다. example.com은 PROXY로, 나머지 요청은 DIRECT로 처리하고 Host에는 문서용 주소 매핑을 추가합니다. PROXY를 사용하려면 연결 정보가 이미 설정되어 있어야 합니다. 192.0.2.10은 문서 전용 주소이므로 이 매핑으로 공개 웹사이트 접속 여부를 확인할 수 없습니다. 실제 사용 전에는 Host 예시 항목을 삭제하세요.

# Structure example; documentation addresses only.

[General]
dns-server = system

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

[Host]
demo.example.com = 192.0.2.10

[URL Rewrite]
# Add rewrite rules only when needed.

General: 전역 설정은 서버 설정이 아닙니다

[General]에서는 DNS 확인 관련 설정 등 전역 동작을 구성합니다. 예시의 dns-server = system은 시스템 DNS 설정을 사용한다는 뜻입니다. 프록시 서버를 지정하는 항목이 아니며, DNS 조회가 특정 프록시 연결을 통과한다고 보장하지도 않습니다. 실제 DNS 확인 경로는 연결 방식, 다른 DNS 옵션, 그리고 앱이 자체적으로 주소를 조회하는지 여부에 따라 달라집니다.

먼저 이해한 설정만 소수 적용한 뒤, 문제 상황에 따라 필요한 항목을 추가하세요. 익숙하지 않은 General 설정을 통째로 덮어쓰면 DNS 확인, IPv6, 트래픽 제외 방식이 한꺼번에 바뀌어 단일 문제를 재현하기 어려워질 수 있습니다. “전역”이라는 이름만 보고 서버 비밀번호, WireGuard 키, TLS 연결 설정을 이 섹션에 입력해서도 안 됩니다.

General 설정 확인 카드

섹션 이름
[General]
필드 형식
키 = 값
DNS 예시
dns-server = system
확인할 항목
필드 철자, 중복 키, 기존 DNS 설정

전역 옵션은 한 번에 하나만 바꾸고, 변경 전 값을 기록하세요.

Rule 설정 확인 카드

섹션 이름
[Rule]
도메인 규칙
DOMAIN-SUFFIX,example.com,PROXY
기본 규칙
FINAL,DIRECT
확인할 항목
위에서 아래로 적용되는 순서와 마지막 정책

규칙 유형은 일치 조건을, 마지막 정책은 처리 방식을 결정합니다.

연결을 시작하는 조건과 요청을 분기하는 규칙도 구분해야 합니다. Settings → On Demand는 필요할 때 연결할 조건을 설정하는 기능이며, General의 트래픽 분기 규칙과는 다릅니다. “수동으로 연결을 끊었는데 다시 연결된다”면 FINAL을 반복해서 수정하기보다 On Demand 조건과 시스템 VPN 상태를 확인하세요.

Rule: 위에서 아래로 매칭하고 FINAL은 마지막에 배치

[Rule]은 가장 자주 수정하는 섹션입니다. 규칙은 위에서 아래로 확인하며, 조건에 일치하면 해당 정책을 적용하고 “더 정확한” 항목을 찾기 위해 계속 검사하지 않습니다. 따라서 구체적인 도메인이나 명확한 주소 규칙은 더 포괄적인 규칙보다 앞에 두고, 기본 규칙인 FINAL은 마지막에 배치하세요.

키워드예시일치 조건
DOMAIN-SUFFIXDOMAIN-SUFFIX,example.com,PROXYexample.com과 그 하위 도메인에 일치합니다. 해당 문자열이 포함된 모든 도메인에 일치하는 것은 아닙니다.
IP-CIDRIP-CIDR,192.0.2.0/24,DIRECT,no-resolve지정된 IPv4 대역에 일치합니다. no-resolve는 이 규칙의 매칭을 위해 도메인 조회를 새로 시작하지 않는다는 뜻입니다.
GEOIPGEOIP,CN,DIRECT주소 데이터베이스를 기준으로 대상 IP의 지역을 판단합니다. 웹페이지 언어나 도메인 문자열을 기준으로 하지 않습니다.
FINALFINAL,PROXY앞선 규칙에 모두 일치하지 않으면 PROXY 정책을 적용합니다.

예를 들어 아래에서는 특정 도메인을 주소 및 지역 규칙보다 앞에 둡니다. DIRECT는 직접 연결, PROXY는 해당 프록시 선택 항목을 사용하는 정책입니다. 이는 Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 같은 프로토콜 이름이 아닙니다. 프로토콜 이름을 일반적인 정책으로 그대로 입력하지 마세요.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

no-resolve는 “DNS를 전부 끄기” 위한 옵션이 아닙니다. 관련 IP 규칙이 매칭될 때 도메인 조회를 새로 시작할지 여부만 제한합니다. 요청이 처음부터 IP 주소를 사용하거나 대상 주소를 이미 알고 있다면 주소 규칙에 일치할 수 있습니다. 반대로 클라이언트에 대상 IP만 전달되고 도메인 정보가 없다면 모든 DOMAIN-SUFFIX 규칙이 브라우저 주소창의 문자열을 기준으로 일치한다고 기대할 수 없습니다.

  1. 먼저 Config에서 활성화된 파일을 확인한 다음 Home → Global Routing에서 Config를 선택하세요.
  2. 검증할 구체적인 조건을 더 포괄적인 조건보다 앞에 두고, FINAL은 하나만 마지막에 배치하세요.
  3. 대상 요청을 다시 보내고 요청 기록에서 대상, 일치한 규칙, 실제 정책을 확인하세요. 연결 스위치가 켜져 있는지만 확인해서는 안 됩니다.
  4. 도메인 규칙이 일치하지 않으면 리디렉션 후 도메인을 포함해 실제 요청 도메인을 먼저 확인한 뒤 규칙 순서와 DNS 확인 정보를 점검하세요.

Host: 로컬 주소 매핑은 요청 변경과 다릅니다

[Host]에서는 지정한 호스트 이름을 특정 IP 주소에 연결할 수 있습니다. 일반적인 형식은 왼쪽에 도메인, 오른쪽에 주소를 두는 것입니다. 예: demo.example.com = 192.0.2.10. 여기에 https://, URL 경로, :443을 입력하지 마세요. Host는 호스트 이름과 주소의 매핑을 정의하며, 완전한 접속 URL을 지정하는 항목이 아닙니다.

[Host]
demo.example.com = 192.0.2.10
api.example.com = 198.51.100.20

위의 두 주소는 모두 문서 예시용입니다. 실제 설정에는 사용 권한이 있고 대상 서비스를 실제로 제공하는 주소를 입력해야 합니다. Host는 브라우저 주소창의 도메인을 IP로 바꾸지 않으며 HTTP Host나 TLS SNI도 자동으로 변경하지 않습니다. 매핑 대상 서버에 해당 도메인의 인증서가 없으면 HTTPS에서 인증서 오류가 발생할 수 있습니다.

URL Rewrite: URL을 매칭한 뒤 변경 작업 적용

[URL Rewrite]는 요청 URL을 처리하며, 도메인을 IP에 매핑하는 기능이 아닙니다. 아래 예시는 정규식으로 HTTP 주소를 매칭해 /old/로 시작하는 경로를 /new/로 리디렉션합니다. 한 줄에서 매칭 표현식, 대상 주소, 302 순으로 작성하고 각 필드는 공백으로 구분합니다.

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

표현식에서 ^는 시작 부분, $는 끝부분을 지정하고, \.은 도메인에 있는 마침표 자체를 나타냅니다. (.*)은 뒤에 오는 내용을 캡처하며, 대상의 $1은 첫 번째 캡처 결과를 참조합니다. 이 규칙에 따르면 http://example.com/old/help의 대상 주소는 http://example.com/new/help입니다. 이는 문법을 설명하기 위한 예시일 뿐, 해당 사이트에 실제 페이지가 있다는 뜻은 아닙니다.

리디렉션은 이후 요청의 동작에도 영향을 줄 수 있습니다. 로그인, 결제, 업로드, API 요청에서는 302가 모든 요청 메서드에 투명하게 적용된다고 볼 수 없습니다. 실제 환경에 적용하기 전에 직접 관리하는 테스트 주소에서 매칭 범위, 대상 URL, 쿼리 매개변수, 요청 메서드를 확인하세요.

Config에서 안전하게 수정하기: 백업, 활성화, 재검증

원격 설정 파일, 연결 구독, 로컬 사본은 각각 구분해 관리하세요. 연결 구독을 업데이트하면 보통 Home의 연결 정보가 갱신됩니다. 원격 .conf 파일을 업데이트하면 설정 파일의 내용이 교체될 수 있습니다. 원격 파일에 직접 추가한 규칙이 다음 업데이트 후에도 유지된다고 가정하지 마세요.

  1. 기준 파일 보관: Config에서 현재 활성화된 파일을 찾아 전체 사본을 먼저 보관하고, 현재 Global Routing 모드를 기록하세요. 백업 파일에 민감한 설정이 포함될 수 있으므로 공개적으로 업로드하지 마세요.
  2. 섹션 확인: 파일에 해당하는 편집 메뉴를 열어 텍스트를 수정하고, General·Rule·Host·URL Rewrite 중 올바른 섹션을 편집하는지 확인하세요.
  3. 한 번에 하나씩 수정: 규칙 하나를 추가하거나 키 하나만 변경하세요. 좁은 매칭 범위로 먼저 검증하고 DNS, 라우팅, URL 변경을 한꺼번에 수정하지 마세요.
  4. 저장 후 활성화: Config로 돌아가 해당 파일이 선택되어 있는지 확인하세요. 화면에 다시 불러오거나 재연결하라는 안내가 표시되면 그대로 진행한 뒤 Home에서 Global Routing을 확인하세요.
  5. 재검증 및 복원: 대상 요청을 새로 보내고 일치한 규칙, 오류 유형, 대상 주소를 기록하세요. 문제가 발생하면 백업 파일로 전환한 뒤 같은 요청을 다시 테스트하세요.

테스트 기록에는 “대상은 api.example.com, 예상 규칙은 DOMAIN-SUFFIX, 실제 적용 규칙은 FINAL”처럼 구체적인 내용을 적으세요. “네트워크가 안 됨”만으로는 원인을 찾기 어렵습니다. 모든 대상에 연결할 수 없다면 먼저 Home에서 선택한 연결과 서비스 제공업체의 설정을 확인하세요. 특정 도메인만 문제가 있다면 Rule, DNS, Host를 점검하고, 특정 경로만 리디렉션된다면 URL Rewrite를 우선 확인하세요.

자주 묻는 질문: 파일은 저장되는데 결과가 예상과 다른 이유는?

Rule을 수정했는데 왜 모든 요청에 같은 정책이 적용되나요?

먼저 Home → Global Routing에서 Config가 선택되어 있는지 확인한 다음 Config에서 활성화된 파일을 확인하세요. 그런 다음 Rule에 너무 앞쪽에 있는 FINAL이 있는지, 더 포괄적인 규칙이 대상 규칙보다 앞에 있는지 살펴보세요. 파일을 저장했다고 해서 해당 파일이 자동으로 활성화되는 것은 아닙니다.

Host에 주소를 입력했는데 HTTPS에서 인증서가 일치하지 않는다고 표시되는 이유는 무엇인가요?

매핑된 주소의 서버가 원래 도메인에 유효한 인증서를 제공하는지 확인하세요. Host는 TLS 검증에 사용되는 도메인을 바꾸지 않으며 서버 인증서를 설정하지도 않습니다. 해당 매핑을 먼저 삭제하고 다시 연결해 오류가 사라지는지 확인하세요.

URL Rewrite가 적용되지 않는데 프록시 규칙을 추가해야 하나요?

실제 URL의 프로토콜, 호스트 이름, 경로, 쿼리 매개변수가 표현식과 일치하는지 먼저 확인하세요. HTTPS 경로는 암호화된 내용을 확인할 수 있는지와 MITM 조건의 영향도 받습니다. PROXY 규칙을 추가해도 이러한 조건을 대신할 수 없습니다. 관리 가능한 HTTP 테스트 주소로 먼저 표현식을 검증하세요.

업데이트 후 사용자 지정 규칙이 사라진 이유는 무엇인가요?

먼저 업데이트한 대상이 Home의 연결 구독인지 Config의 원격 파일인지 구분하세요. 원격 설정 파일 전체가 교체되었다면 백업에서 로컬 사본을 복원한 뒤 필요한 변경을 다시 적용하세요. 다음 업데이트 전에는 변경 사항을 비교하고, 검증을 마친 로컬 파일을 바로 덮어쓰지 마세요.

.conf를 읽을 때 핵심은 각 섹션의 역할을 구분하는 것입니다. General은 전역 동작, Rule은 순서에 따른 정책 선택, Host는 로컬 매핑, URL Rewrite는 조건에 맞는 URL 처리를 담당합니다. 변경 범위를 한 섹션, 한 필드, 한 요청으로 좁혀야 반복해서 전체 설정을 가져와 시험하지 않고도 결과가 어떤 설정에서 비롯되었는지 판단할 수 있습니다.

Shadowrocket 다운로드 및 설정 가이드

iPhone / iPad 버전은 App Store에서 다운로드할 수 있으며, 가격은 $2.99 일회성 결제입니다. Mac(Apple 칩 / Intel), Windows, Android, Linux 버전은 무료입니다. iPhone / iPad의 시스템 요구 사항은 App Store 페이지를 확인하세요. 앱 설치와 연결 서비스는 별개로 관리되며, 구독은 서비스 제공업체에서 받으세요.

Shadowrocket 다운로드