이 글의 핵심

수정하기 전에 Config에서 현재 설정 파일을 확인하고, Home에서 Global Routing을 점검하세요. 이 글은 iPhone / iPad 화면을 기준으로 설명하며, 연결을 설정할 수 있고 트래픽 분기를 조정하거나 규칙이 매칭되지 않는 문제를 확인하려는 사용자를 위한 내용입니다. 섹션별로 수정하고 기존 설정을 보존하면 아웃바운드 정책, 도메인 해석, URL 리디렉션을 각각 검증할 수 있습니다.

먼저 .conf 파일과 라우팅 모드 확인하기

.conf는 섹션별로 구성된 설정 파일입니다. 대괄호 안의 이름에 따라 다음 항목을 처리하는 섹션이 결정됩니다. [General]과 [Host]는 등호로 값을 지정하고, [Rule]은 쉼표로 필드를 구분하며, [URL Rewrite]의 리디렉션 예제는 공백으로 필드를 나눕니다. 줄을 다른 섹션으로 옮길 때는 새 섹션의 문법도 확인해야 합니다.

현재 설정라우팅 모드대상 매칭아웃바운드 정책연결 기록

Config에서 테스트하려는 파일을 사용 중인지 확인하세요. 파일의 편집 화면을 열어 둔 것만으로는 충분하지 않습니다. 사본을 저장한 다음 Home으로 돌아가 Global Routing을 Config로 설정하고 트래픽 분기를 테스트하세요. Proxy와 Direct는 서로 다른 전역 라우팅 옵션이므로 [Rule]의 특정 규칙이 매칭되는지 확인하는 데 적합하지 않습니다. Settings의 On Demand는 연결을 자동으로 시작할 시점을 설정하며, 이 단계와는 별개입니다.

4개 섹션
General, Rule, Host, URL Rewrite를 각각 확인합니다
쉼표 2개
기본 DOMAIN-SUFFIX 행은 규칙 유형, 도메인, 정책을 구분합니다
302
이 URL Rewrite 예제에서 사용하는 HTTP 리디렉션 상태 코드

먼저 매칭 결과를 확인한 뒤 경로를 판단하세요

같은 페이지가 열린다고 해서 트래픽이 예상한 아웃바운드 경로를 이용한다는 뜻은 아닙니다. 확인된 대상에 새 연결을 요청하고 앱의 연결 기록에서 정책을 확인하세요. 정책은 맞는데 요청이 실패한다면 해석 결과나 해당 아웃바운드의 사용 가능 여부를 점검하세요.

General: 전역 DNS 설정

[General]에는 설정 파일 전체에서 공통으로 사용하는 매개변수를 둡니다. 예를 들어 dns-server 값을 system으로 설정하면 이 줄에서 DNS 서버를 고정으로 지정하는 대신 시스템 DNS를 사용합니다. Wi-Fi와 셀룰러 네트워크를 전환하면 시스템이 제공하는 DNS 환경이 달라질 수 있으므로, 수정 전후 결과를 비교할 때는 연결된 네트워크를 동일하게 유지하세요.

[General]
dns-server = system
  • 기존 [General] 섹션에서 해당 키를 수정하세요. 매개변수 한 줄을 시험하려고 같은 이름의 섹션을 추가하거나 서로 충돌하는 dns-server 항목을 두 개 남겨 두지 마세요.
  • 수정 전후를 비교할 때는 기존에 접속할 수 있었던 동일한 도메인을 사용하고, 테스트 요청이 새 연결로 전송됐는지 확인하세요. 기존 연결을 재사용하거나 캐시된 결과를 읽는 경우 페이지를 새로고침해도 DNS를 다시 조회하지 않을 수 있습니다.
  • 이름 해석과 아웃바운드 경로를 따로 확인하세요. 대상 주소를 얻었다고 해서 현재 정책으로 해당 주소에 접속할 수 있는 것은 아닙니다. 반대로 기존 연결로 데이터가 계속 전송되더라도 새 DNS 조회가 성공한다는 뜻은 아닙니다.

Rule: 구체적인 규칙부터 FINAL 대체 규칙까지

[Rule]은 작성된 순서대로 매칭되며, 처음 일치한 규칙이 적용할 정책을 결정합니다. 특정 도메인에 대한 예외는 해당 도메인을 포함하는 접미사 규칙보다 위에 두고, FINAL은 마지막에 배치하세요. 아래 도메인과 주소는 규칙의 매칭 방식을 설명하기 위한 예시이며 실제 서비스를 나타내지 않습니다. 자신의 설정에서 PROXY를 사용하기 전에 Home에서 사용할 수 있는 프록시 서버가 있는지 확인하세요.

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT
FINAL,DIRECT

앱이 요청 도메인을 확인했다고 가정하면 docs.example.com은 첫 번째 행에, 같은 접미사를 가진 img.example.com은 두 번째 행에 매칭됩니다. 첫 두 행의 순서를 바꾸면 docs.example.com도 접미사 규칙에 먼저 매칭됩니다. 세 번째 행은 지정된 IPv4 대역과 일치합니다. IP 주소를 직접 입력해 요청하면 도메인 규칙에 매칭될 것으로 기대해서는 안 됩니다. 앞선 행에 매칭되지 않은 요청만 FINAL에 도달합니다.

도메인으로 매칭

DOMAIN
docs.example.com처럼 전체 도메인과 일치합니다.
DOMAIN-SUFFIX
example.com과 그 하위 도메인에 매칭되며, notexample.com에는 매칭되지 않습니다.
자주 하는 실수
도메인 필드에는 https://, 포트, 경로를 넣지 마세요.

같은 접미사에 예외 도메인이 있다면 전체 도메인 규칙을 접미사 규칙보다 위에 작성하세요.

IP 주소 매칭 및 대체 규칙

IP-CIDR
192.0.2.0/24처럼 IPv4 주소 범위와 일치합니다.
GEOIP
대상 IP의 지리적 분류에 따라 매칭합니다. 예: GEOIP,CN,DIRECT.
FINAL
앞선 규칙에 매칭되지 않았을 때 적용할 정책을 지정합니다. 예: FINAL,DIRECT.

IP 규칙은 대상 주소를 기준으로 적용되며, 도메인 접미사나 기기의 위치를 기준으로 판단하지 않습니다.

도메인 규칙 하나를 시험하려고 기존 FINAL을 바꾸지 마세요. 매칭되지 않은 모든 트래픽의 아웃바운드 경로가 함께 바뀌어 결과의 원인을 파악하기 어려워집니다. 기존 대체 규칙은 유지하고 명확한 예외 규칙 하나만 추가한 뒤, 매칭되어야 하는 도메인과 매칭되지 않아야 하는 도메인을 각각 테스트하세요.

Host: 도메인을 지정한 IP에 매핑

[Host]에서는 왼쪽에 해석할 도메인을, 오른쪽에 매핑할 주소를 적습니다. Shadowrocket이 해당 도메인의 이름을 해석할 때 요청을 지정한 주소로 보내는 데 사용합니다. [Rule]을 대신하지 않으며 DIRECT 또는 PROXY를 선택하지도 않습니다. 주소 표시줄의 도메인을 다른 도메인으로 바꾸는 기능도 아닙니다.

[Host]
staging.example.com = 192.0.2.10

192.0.2.10은 문서 예시용 주소이며 서비스 연결 여부를 확인하는 데 사용할 수 없습니다. 실제로 테스트할 때는 직접 관리하는 테스트 도메인과 현재 네트워크에서 접속 가능한 서비스 주소를 사용하세요. 도메인으로 요청을 보내야 합니다. IP를 직접 입력하면 도메인 매핑을 거치지 않으며 서버가 요청을 다른 사이트로 처리할 수도 있습니다.

  1. 요청이 Shadowrocket에서 처리하는 이름 해석 경로를 이용하는지 먼저 확인하세요. 앱 캐시, 이미 설정된 연결, 원격에서 수행되는 이름 해석 때문에 로컬 매핑이 바로 적용되지 않을 수 있습니다.
  2. 대상 서비스가 해당 포트에서 요청을 받는지 확인하세요. http://는 기본적으로 80번 포트를, https://는 443번 포트를 사용합니다. 매핑 행은 포트를 변경하지 않습니다.
  3. HTTPS를 사용할 때는 서버가 원래 도메인에 맞는 인증서를 제공해야 합니다. 주소가 지정된 IP로 바뀐 뒤 인증서 오류가 발생하면 먼저 서버 인증서와 사이트 설정을 확인하세요. 인증서 오류를 매핑 규칙 미적용으로 판단하지 마세요.

URL Rewrite: URL을 매칭해 리디렉션 응답 반환

[URL Rewrite]의 302 형식은 식별 가능한 HTTP 요청 URL을 대상으로 합니다. 규칙이 매칭되면 리디렉션 응답이 반환되고, 요청을 보낸 클라이언트가 리디렉션을 따를지 결정합니다. DNS 매핑과는 다르며 대상 IP를 오른쪽 값으로 바꾸지도 않습니다. 아래 예제는 일반 HTTP를 사용해 특정 이전 주소 전체에만 매칭합니다.

[URL Rewrite]
^http://docs\.example\.com/old$ http://docs.example.com/new 302
  • 첫 번째 필드는 정규식입니다. \.은 문자 그대로의 점과 일치하고, 앞의 ^와 끝의 $는 전체 URL을 대상으로 제한해 다른 호스트나 비슷한 경로가 규칙에 포함되지 않도록 합니다.
  • 두 번째 필드는 리디렉션 대상입니다. 이 예제에서는 /old/나 쿼리 매개변수가 붙은 /old?ref=test가 매칭되지 않습니다. /new도 원래 규칙과 일치하지 않으므로 이 행에서 다시 리디렉션되지 않습니다.
  • 세 번째 필드는 동작을 나타내는 302입니다. 확인할 때는 원래 요청이 302를 받았는지, Location이 예상한 대상으로 지정됐는지, 새 요청이 성공했는지 각각 점검하세요. 새 주소에서 오류가 발생해도 원래 리디렉션이 이루어지지 않았다는 뜻은 아닙니다.

직접 제어하는 테스트 사이트에서 확인하세요. 클라이언트가 요청을 보내기 전에 HTTP를 HTTPS로 업그레이드하면 http://로 시작하는 이 정규식은 매칭되지 않습니다. HTTPS의 경로와 쿼리 매개변수는 TLS로 보호되므로 호스트 이름만으로 경로 단위 재작성은 할 수 없습니다. 정규식을 수정하거나 [Host]를 추가하는 방법으로 해결하려 하지 마세요.

설정이 적용되지 않을 때: 파일, 정책, 요청 순서로 점검

Config에서 수정했는데 요청에는 왜 이전 정책이 적용되나요?

수정 사항을 저장했는지, 현재 사용 중인 파일이 수정한 파일인지 먼저 확인하세요. 그런 다음 Home의 Global Routing이 Config로 설정되어 있는지 확인합니다. 테스트 앱에서 새 연결을 설정한 뒤 해당 요청의 아웃바운드 정책을 확인하세요. 수정 전 연결 기록으로 판단하지 마세요.

규칙에 DIRECT를 지정했는데 왜 PROXY를 이용하나요?

위쪽에 더 일찍 작성된 접미사 규칙이나 해당 대상을 포함할 수 있는 다른 규칙이 있는지 확인하세요. 전체 도메인에 적용할 DOMAIN 예외를 해당 규칙보다 앞에 옮긴 다음, 예외 도메인과 같은 접미사를 가진 다른 도메인을 각각 테스트하세요.

Host에서 테스트 서버를 지정했는데 왜 원래 사이트가 열리나요?

요청이 여전히 테스트 도메인으로 전송되는지 확인한 뒤 테스트 서버에 새 요청이 도착했는지 살펴보세요. 요청이 도착하지 않았다면 기존 연결, 캐시, 원격 이름 해석을 확인하세요. 요청은 도착했지만 원래 사이트 내용이 반환된다면 테스트 서버에 해당 도메인의 사이트가 올바르게 설정됐는지 점검하세요.

302를 추가했는데 브라우저가 왜 리디렉션하지 않나요?

실제로 전송된 URL을 정규식과 대조하고 프로토콜, 끝의 슬래시, 쿼리 매개변수를 특히 확인하세요. 이미 302를 받았다면 원래 정규식을 반복해서 수정하기보다 Location과 새 요청을 확인하세요. 이 규칙을 잠시 비활성화하고 다시 테스트하면 설정에 의한 리디렉션인지 서버 자체 리디렉션인지 구분할 수 있습니다.