Shadowrocket 설정 파일 .conf 구조와 사용법: [General], [Rule], [Host], [URL Rewrite] 설명

Shadowrocket .conf 설정 파일의 [General], [Rule], [Host], [URL Rewrite] 항목별 역할과 변경 사항 적용 방법을 살펴봅니다.

이 글의 핵심

Shadowrocket의 .conf는 텍스트 형식의 설정 파일이며, 구독 주소나 연결 인증 정보를 대신하지 않습니다. 필요한 서비스 정보를 이미 보유한 사용자를 대상으로 설정 항목별 실행 매개변수, 트래픽 분기 규칙, 도메인 매핑, URL 리디렉션의 차이를 설명하고 백업, 편집, 활성화, 복원 절차를 안내합니다. 먼저 최소한의 규칙으로 확인한 뒤 설정을 하나씩 되돌리면 DNS, 규칙 순서, 연결 오류를 구분해 점검할 수 있습니다.

1. .conf 섹션 구조와 설정 범위

설정 파일은 [General]처럼 대괄호로 섹션을 표시합니다. 섹션 이름 아래의 내용은 다음 섹션 이름이 나올 때까지 해당 섹션의 문법에 따라 해석됩니다. [General]은 주로 키 = 값 형식을 사용하고, [Rule]은 쉼표로 구분한 규칙을 사용합니다. 모든 섹션에 같은 형식을 적용할 수는 없습니다. 편집할 때는 영문 반각 대괄호, 쉼표, 등호를 사용하고 한글 입력기가 기호를 바꾸지 않도록 주의하세요.

섹션담당 기능담당하지 않는 기능
[General]DNS 등 기본 실행 설정개별 웹사이트의 트래픽 분기 규칙을 대체하지 않음
[Rule]조건에 따라 DIRECT, PROXY 등의 정책 선택요청 URL을 수정하지 않음
[Host]특정 도메인의 DNS 응답 지정프록시 사용 여부를 단독으로 결정하지 않음
[URL Rewrite]정규식에 일치하는 URL 처리DNS 매핑이나 라우팅 규칙과는 다름

이 네 섹션을 모두 반드시 사용할 필요는 없습니다. 웹사이트 트래픽 분기만 설정한다면 필요한 기본 매개변수와 [Rule]만 남기고, Host나 URL Rewrite는 추가하지 않아도 됩니다. 설정 파일에는 지원되는 다른 섹션이 포함될 수 있으므로, 이 글에서 다루지 않았다는 이유로 삭제하지 마세요. 다른 형식의 설정 파일은 확장자만 .conf로 바꿔도 사용할 수 없습니다.

2. [General]: DNS 기준을 확인한 뒤 다른 설정 변경

[General]에서는 지원 여부가 명확한 설정부터 소수만 적용하는 것이 좋습니다. 아래 예시의 dns-server = system은 여기서 시스템 DNS를 조회 출처로 사용한다는 뜻입니다. 모든 네트워크에서 DNS 조회가 성공한다는 보장은 아니며, 실제 결과는 현재 네트워크, 캐시, 다른 DNS 설정의 영향을 받습니다.

[General]
dns-server = system

기존 설정에 DNS 매개변수가 있다면 먼저 원래 값을 기록한 뒤 비교 테스트를 진행하세요. DNS 조회 출처를 바꾸면 도메인에서 얻는 IP가 달라져 GEOIP 또는 IP-CIDR 규칙의 일치 결과에 영향을 줄 수 있습니다. 따라서 웹사이트 문제를 점검할 때 DNS 변경, 규칙 순서 조정, 연결 항목 전환을 동시에 하지 마세요. 어떤 변경이 결과를 바꿨는지 알 수 없게 됩니다.

기본 설정 확인

섹션
[General]
예시 키
dns-server
예시 값
system
작성 형식
키 = 값

작동하는 기본 설정을 먼저 유지하고, 모르는 매개변수는 이름만 보고 추측해 추가하지 마세요.

DNS 조회 문제 확인

테스트 대상
동일한 전체 도메인
고정 조건
동일한 네트워크, 동일한 연결 항목
기록할 내용
DNS 조회 결과, 일치한 규칙, 연결 오류
복원 방법
원래 값으로 되돌린 뒤 새 연결 생성

도메인이 조회되더라도 대상 포트에 연결된다는 뜻은 아니므로 각각 확인해야 합니다.

3. [Rule]: 일치 순서, 정책, FINAL 기본 처리

[Rule]에서는 위에서 아래 순서로 규칙을 확인하며, 처음 일치한 규칙이 해당 요청에 적용될 정책을 결정합니다. 아래는 “example.com과 하위 도메인은 PROXY를 사용하고 나머지는 DIRECT로 처리”하는 예시입니다. 트래픽 분기 방식만 보여 주며 실제 연결 정보는 포함하지 않습니다. PROXY를 사용하려면 먼저 Home에서 사용 가능한 본인 연결 항목을 준비하고 선택해야 합니다.

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

DOMAIN-SUFFIX,example.com,PROXY는 example.com과 www.example.com에 일치하며, URL 경로를 문자열로 검색하지 않습니다. https://, 포트 번호, /path는 입력하지 마세요. 앞선 조건에 하나도 일치하지 않을 때 적용하는 기본 규칙인 FINAL은 규칙 맨 끝에 두어야 합니다. 앞쪽에 배치하면 이후 규칙이 일치할 기회를 잃습니다.

규칙 예시판단 기준확인 사항
DOMAIN-SUFFIX,example.com,PROXY도메인 접미사관련 도메인 그룹을 명시적으로 지정할 때 적합
GEOIP,CN,DIRECT대상 IP의 지리적 위치 데이터베이스 결과웹페이지 언어나 도메인 접미사로 판단하지 않음
IP-CIDR,192.0.2.0/24,DIRECT,no-resolveIPv4 주소가 속한 네트워크 대역no-resolve는 이 규칙을 위해 도메인을 별도로 조회하지 않도록 합니다.
FINAL,DIRECT다른 규칙이 모두 일치하지 않음마지막 줄에 두어 나머지 요청의 처리 방식을 명시

표의 각 항목은 문법을 설명하기 위한 것으로, 모두 같은 설정에 추가할 필요는 없습니다. 192.0.2.0/24는 문서용 예시 대역이며 실제 서비스 주소가 아닙니다. GEOIP처럼 적용 범위가 넓은 규칙을 추가할 때는 더 구체적인 웹사이트 예외 규칙 뒤, FINAL 앞에 배치하세요. 그렇지 않으면 넓은 조건이 먼저 일치해 이후 규칙에서 처리해야 할 요청을 가로챌 수 있습니다.

4. [Host]: 도메인 매핑은 트래픽을 직접 연결하지 않음

[Host]에서는 특정 도메인의 DNS 응답을 정적으로 지정할 수 있습니다. 아래 예시는 테스트용으로 예약된 도메인을 문서용 주소에 매핑한 것으로, 형식 설명에만 사용하며 실제 서비스와 관련이 없습니다. 왼쪽에는 프로토콜이나 경로 없이 도메인을 쓰고, 오른쪽에는 지정할 주소를 입력합니다.

[Host]
lab.example.test = 192.0.2.10

Host는 “도메인이 어느 주소를 가리키는지”를 설정하고, Rule은 “요청에 어떤 정책을 적용하는지”를 정합니다. Host를 설정했다고 요청이 DIRECT로 처리된다고 단정할 수는 없습니다. 일치한 규칙, 현재 Global Routing 모드, 연결 기록에 표시된 실제 대상과 정책을 확인해야 합니다.

문제에 따라 수정할 위치 선택

대상 주소를 고정해야 함
  • Host에 도메인과 주소의 매핑을 명시적으로 설정합니다.
  • 대상 서버가 해당 도메인의 요청을 계속 처리하는지 확인합니다.
  • HTTPS에서는 원래 도메인과 일치하는 유효한 인증서가 필요합니다.
요청 처리 정책을 변경해야 함
  • Rule에 도메인 또는 IP 조건을 추가합니다.
  • 예외 규칙이 범위가 넓은 규칙보다 앞에 있는지 확인합니다.
  • Config 모드에서 실제로 적용된 정책을 확인합니다.

주소 매핑과 라우팅 선택은 각각 검증해야 합니다. IP를 고정해도 인증서 불일치가 해결되지는 않으며 서비스가 계속 사용 가능하다는 보장도 없습니다.

5. [URL Rewrite]: URL 일치 처리, Rule 대체 아님

[URL Rewrite]는 URL 정규식에 따라 작업을 수행합니다. 아래 예시는 HTTP 루트 주소를 HTTPS 루트 주소로 리디렉션하며, 마지막의 302는 임시 리디렉션을 뜻합니다. 루트 경로만 대상으로 하고 해당 도메인의 모든 페이지를 처리하지 않으므로 테스트 범위를 좁히기 쉽습니다.

[URL Rewrite]
^http://example\.com/$ https://example.com/ 302

일반 HTTPS 요청의 전체 경로는 암호화로 보호되므로 URL Rewrite를 추가했다고 경로와 일치할 수 있다고 가정해서는 안 됩니다. HTTPS 콘텐츠를 처리하려면 복호화 범위와 인증서 신뢰 등 추가 조건도 필요합니다. 이 글의 기본 설정을 확인하는 데는 해당 기능을 활성화할 필요가 없습니다. 리디렉션 하나를 테스트하려고 모든 도메인의 처리 범위를 넓히지 마세요.

6. 편집 후 적용: 저장, 선택, 연결 다시 생성

파일 저장은 첫 단계일 뿐입니다. Config에서 방금 편집한 설정이 선택되어 있는지 확인하고, Home → Global Routing에서 Config를 사용하도록 설정해야 합니다. 아래에서는 iPhone/iPad의 Home, Config, Settings 구성을 기준으로 안내합니다. 다른 플랫폼에서는 해당 기능을 확인하되 화면 위치가 모든 플랫폼에서 똑같다고 가정하지 마세요.

  1. 원본 백업

    Config로 이동해 현재 설정의 작업 메뉴를 열고 원본 설정을 내보내 별도 사본으로 보관합니다. 현재 설정 이름과 Home → Global Routing의 기존 모드도 기록해 두세요.

  2. 한 항목씩 편집

    Config에서 대상 설정의 텍스트 편집 기능을 열고 한 번에 한 섹션만 수정합니다. 섹션 이름, 반각 문장 부호, FINAL 위치를 확인한 뒤 저장하세요.

  3. 설정 선택

    Config 목록으로 돌아가 대상 파일이 선택되어 있는지 확인합니다. 사본을 편집했다면 해당 사본으로 명확히 전환해야 합니다. 원본 파일을 계속 사용한 상태로 테스트하지 마세요.

  4. 모드 전환

    Home → Global Routing으로 이동해 Config를 선택합니다. Settings → On Demand가 활성화되어 있다면 설정을 먼저 기록하고, 테스트 중 자동 연결이 수동 전환에 영향을 주지 않도록 하세요.

  5. 연결을 새로 만들고 확인

    연결을 끊었다가 다시 연결한 후 새 테스트 요청을 보냅니다. 연결 기록에서 도메인, 일치한 규칙, 적용된 정책을 확인하세요. 실패하면 백업한 설정으로 전환한 뒤 같은 요청을 다시 테스트합니다.

기존 연결은 연결을 만들 당시의 상태를 계속 사용할 수 있으며, 브라우저도 연결이나 캐시를 보유할 수 있습니다. 설정을 수정한 뒤 기존 페이지를 한 번 새로고침하는 것만으로는 새 설정이 적용됐다고 확인할 수 없습니다. 테스트할 때 관련 기존 연결을 종료하고 새 요청을 보내되, 네트워크와 연결 항목은 그대로 유지하세요. 필요한 경우 도메인 조회와 대상 서비스 연결을 각각 테스트합니다.

7. 설정 검증에 영향을 주는 Global Routing 모드

“규칙을 작성했는데 반응이 없다면” 파일을 바로 다시 수정하기보다 먼저 Global Routing을 확인하세요. Config는 현재 설정에 따라 트래픽을 분기합니다. Proxy와 Direct는 문제 범위를 좁히는 데 사용할 수 있지만, 해당 모드의 테스트 결과로 규칙이 실제 일치했는지 판단할 수는 없습니다.

Config

권장

현재 설정의 규칙에 따라 요청 정책을 결정합니다. DOMAIN-SUFFIX와 FINAL을 확인할 때는 이 모드에서 실제 일치 결과를 살펴보세요.

적합한 용도: 일상적인 규칙 분기, 설정 변경 확인.

Proxy

트래픽을 프록시로 처리해 현재 연결이 작동하는지 비교 확인합니다. 페이지가 열리더라도 특정 Rule이 일치했다는 의미는 아닙니다.

적합한 용도: 연결 항목 문제와 규칙 선택 문제 구분.

Direct

트래픽을 직접 연결해 프록시 경로와 비교합니다. 이 모드에서는 Config 모드처럼 새 PROXY 분기 규칙이 적용되리라고 기대해서는 안 됩니다.

적합한 용도: 현재 네트워크에서 대상에 접속할 수 있는지 확인.

Scene

이미 설정된 Scene에 따라 작동 방식을 결정합니다. 문제를 점검할 때는 Scene 전환으로 테스트 조건이 달라지지 않도록 조건과 작업을 먼저 확인하세요.

적합한 용도: Scene 설정이 명확한 네트워크 환경 전환.

8. 자주 발생하는 설정 오류와 복원 점검

.conf를 저장했는데 왜 이전 정책이 계속 적용되나요?

Config에서 선택된 파일, Home → Global Routing → Config 설정, 대상 규칙이 FINAL 앞에 있는지 차례대로 확인하세요. 그런 다음 연결을 다시 만들고 새 요청을 보냅니다. 파일 내용은 올바르지만 현재 사용 중인 설정이 아닌 파일을 편집했을 가능성을 먼저 배제해야 합니다.

Host를 추가한 뒤 HTTPS 인증서 오류가 발생하는 이유는 무엇인가요?

Host는 주소 매핑만 바꾸며 요청 도메인이나 인증서 검증 조건은 바꾸지 않습니다. 새로 추가한 매핑을 먼저 제거하고 다시 테스트한 뒤, 지정한 서버가 해당 도메인의 서비스를 실제로 제공하는지 확인하세요. 인증서 오류를 무시하는 방식으로 주소 매핑이나 인증서 설정 문제를 대신 해결하지 마세요.

구독을 업데이트했는데 규칙은 왜 함께 업데이트되지 않나요?

연결 항목 구독과 원격 설정은 서로 다른 항목입니다. Home의 서비스 정보와 Config의 원격 설정 중 무엇을 업데이트했는지 먼저 확인하세요. 업데이트 전에 로컬 사본을 보관하고, 원격 설정을 다시 가져온 뒤 직접 수정한 규칙이 덮어써지지 않았는지도 확인해야 합니다.

수정 후 연결되지 않는데 모든 항목을 다시 가져와야 하나요?

먼저 백업한 설정으로 되돌리고 기존 연결 항목은 그대로 둔 채 다시 연결하세요. 정상으로 돌아온다면 최근 수정한 섹션을 하나씩 비교합니다. 계속 실패하면 서비스 주소, 포트, 인증 정보를 확인하세요. 비교 기준을 잃을 수 있으니 모든 설정과 구독을 바로 삭제하지 마세요.

변경 사항을 확인할 때는 현재 선택한 설정, Global Routing 모드, 테스트 도메인, 실제 적용된 정책 등 최소 네 가지를 기록하세요. 변경 전후를 비교할 때는 한 번에 변수 하나만 바꾸세요. 이렇게 하면 문법 오류, 규칙 우선 적용, DNS 응답 차이, 서비스 연결 불가를 구분할 수 있으며 설정을 무작정 추가하지 않아도 됩니다.

Shadowrocket 공식 다운로드