아웃바운드 정책을 바꾸려면 [Rule], 도메인 해석 결과를 바꾸려면 [Host], 요청 URL을 바꾸려면 [URL Rewrite], DNS 등 전역 설정을 바꾸려면 [General]을 확인하세요. Shadowrocket에서 설정 파일을 사용 중이며 항목을 점검하거나 수정하려는 사용자를 위한 안내입니다. 화면 조작은 iPhone / iPad를 기준으로 설명하며, 다른 플랫폼에서는 섹션 이름을 참고하세요.
먼저 적용 중인 파일을 확인한 다음 수정할 섹션을 찾으세요
.conf 파일은 대괄호로 표시된 제목으로 섹션을 구분합니다. 한 섹션의 제목부터 다음 섹션 제목 전까지의 항목은 같은 섹션에 속합니다. 네 섹션의 순서가 요청 처리 순서를 고정하는 것은 아닙니다. [Host]를 [Rule] 앞에 옮겨도 DNS 매핑 항목의 트래픽 분기 우선순위가 높아지는 것은 아닙니다. 실제로 행 순서를 확인해야 하는 곳은 [Rule] 섹션 내부입니다.
먼저 Home → Global Routing 확인
Config에서 선택된 파일을 확인한 다음, Home → Global Routing에서 Config를 선택해 트래픽 분기를 확인하세요. 현재 Proxy 또는 Direct가 선택되어 있다면 연결 결과만 보고 규칙 순서를 바꾸지 마세요.
아래 흐름은 Config 모드에서 트래픽 분기 정책을 선택하는 방법만 설명합니다. DNS 조회와 URL 재작성이 항상 같은 시점에 실행된다는 뜻은 아닙니다. Scene에서는 상황에 따라 라우팅 방식을 선택할 수 있습니다. 개별 규칙을 점검할 때는 상황 전환으로 인한 영향을 줄이도록 Config로 먼저 전환하세요.
- 원본 설정은 보관하고 복사본에서 수정하세요. 원본 파일이 원격 주소를 통해 업데이트되는 경우에는 수정 내용을 별도로 저장해 다음 업데이트 때 덮어쓰이지 않도록 하세요.
- 한 번에 한 곳만 수정하고, 같은 기기·네트워크·대상을 사용해 다시 테스트하세요. 먼저 수정 전 현상을 기록해 네트워크 전환이나 캐시 변화가 설정 적용으로 오인되지 않도록 하세요.
General: DNS 등 전역 설정
[General] 항목은 키 = 값 형식으로 작성합니다. 여기서는 특정 도메인의 아웃바운드 정책을 개별 지정하지 않습니다. 아래 두 줄은 각각 시스템 DNS와 IPv6 설정을 지정합니다. DNS를 테스트할 때 IPv6까지 함께 바꿀 필요는 없습니다.
[General]
dns-server = system
ipv6 = false
dns-server = system: 시스템에 설정된 DNS를 사용합니다. 특정 Wi-Fi에서만 같은 도메인이 제대로 해석되지 않는다면, 먼저 해당 네트워크에서 시스템 DNS가 정상적으로 작동하는지 확인한 다음 모바일 네트워크나 정상 작동이 확인된 다른 네트워크와 비교하세요. 시스템 DNS는 네트워크마다 다를 수 있습니다.ipv6 = false: 설정에서 IPv6 지원을 끄고 IPv6 경로의 영향을 분리해 확인합니다. 이는 시스템 전체에 적용되는 설정이 아니며, 대상에 IPv4 주소가 반드시 있다는 뜻도 아닙니다. 테스트가 끝나면 원래 설정으로 되돌린 뒤 변경 사항을 유지할지 결정하세요.
도메인 하나만 잘못된 주소로 해석된다면 전역 DNS를 바꾸기 전에 [Host]에 같은 이름의 항목이 있는지 확인하세요. 도메인은 정상적으로 해석되지만 아웃바운드 정책이 잘못 적용된다면 [Rule]을 살펴보세요. 자세한 항목은 설정 필드 안내를 참고하세요.
Rule: 행 순서대로 매칭해 첫 일치 규칙 적용
[Rule]의 일반적인 형식은 유형,매칭값,정책이며, FINAL에는 매칭값이 필요하지 않습니다. 아래 예제에서는 특정 도메인에 대한 예외를 도메인 접미사 규칙보다 앞에 둡니다. 앞선 규칙에 해당하지 않는 요청은 FINAL에서 처리됩니다. PROXY는 선택된 프록시를 사용하고, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 예제의 도메인과 IP 대역은 매칭 방식을 설명하기 위한 것으로, 실제 이용 가능한 서비스 주소가 아닙니다.
[Rule]
DOMAIN,lab.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,REJECT,no-resolve
FINAL,DIRECT
도메인 매칭
DOMAINlab.example.com과 정확히 일치하는 도메인을 매칭합니다. 하위 도메인은 포함하지 않습니다.DOMAIN-SUFFIXexample.com및 그 하위 도메인을 매칭합니다.FINAL- 앞선 규칙에 일치하지 않으면
DIRECT를 선택합니다.
접미사 규칙을 정확히 일치하는 규칙보다 앞에 두면 두 규칙 모두에 해당할 때 PROXY가 먼저 선택됩니다.
IP 매칭
IP-CIDR- 지정된 IP 대역과 매칭합니다. 예를 들어 IP 주소
192.0.2.10은192.0.2.0/24에 속합니다. no-resolve- 이 IP 규칙을 시험하기 위해 도메인을 직접 조회하지 마세요.
GEOIP- 도메인 접미사가 아니라 대상 IP의 지리적 분류를 기준으로 매칭합니다. 예:
GEOIP,CN,DIRECT.
설정에 GEOIP를 추가할 때는 FINAL보다 앞에 두고, 위쪽에 먼저 일치하는 규칙이 있는지 확인하세요.
규칙 순서를 확인할 때는 ‘규칙이 특정 정책을 선택했다’는 것과 ‘대상 서비스에 접속할 수 있다’는 것을 구분하세요. 예를 들어 요청 대상이 lab.example.com으로 식별되면 첫 번째 행이 DIRECT와 일치합니다. 서비스 자체에 접속할 수 없더라도 두 번째 행의 PROXY로 넘어가지는 않습니다. 문제를 확인할 때는 먼저 매칭 결과를 확인하고, 그다음 서비스 연결 가능 여부를 점검하세요.
Host: 지정 도메인의 해석 결과 덮어쓰기
[Host]에서는 설정 파일 안에서 도메인을 지정한 주소에 매핑할 수 있습니다. 아래 예제에서는 문서용으로 예약된 주소 192.0.2.10을 사용합니다. 실제로 확인할 때는 직접 관리하는 테스트 도메인과 현재 네트워크에서 접속 가능한 주소로 바꾸고, 해당 연결이 설정의 영향을 받는 DNS 해석 경로를 사용하는지 확인하세요.
[Host]
lab.example.com = 192.0.2.10
- 원래 설정으로 테스트 도메인에 접속해 연결 여부와 서버에 요청이 도달한 위치를 기록하세요. 매핑이 적용된 복사본을 활성화한 다음 같은 도메인으로 새 연결을 시작해 기존 연결이나 DNS 캐시의 영향을 피하세요.
- 계속 원래 주소로 연결된다면 복사본이 선택되어 있는지, 대상 앱이 기존 연결을 재사용하거나 자체 DNS를 사용하는지 확인하세요. 시스템 DNS 조회 도구의 결과가 앱이 Shadowrocket을 통해 연결할 때 사용하는 해석 결과와 다를 수 있습니다.
- 지정한 주소에 연결되지만 HTTPS 인증서 오류가 발생한다면 대상 서비스에 원래 도메인용 유효한 인증서가 설정되어 있는지 확인하세요.
[Host]는 해석 주소를 바꾸는 기능입니다. URL의 도메인을 바꾸거나 도메인이 일치하지 않는 인증서를 유효하게 만들지는 않습니다.
‘같은 도메인에 접속하되 다른 서버에서 응답하게 하려는’ 경우에는 [Host]를 확인하세요. ‘한 경로에 접속한 뒤 다른 경로로 이동하려는’ 경우에는 [URL Rewrite]를 확인하세요. IP 주소만 바꿔서는 브라우저 주소창의 /old가 /new로 바뀌지 않습니다.
URL Rewrite: URL 패턴에 따라 리디렉션 응답 반환
아래 [URL Rewrite] 예제는 매칭 표현식, 대상 URL, 동작 코드 302 순서로 작성하며 각 필드는 공백으로 구분합니다. 전체 HTTP 주소 http://lab.example.com/old만 매칭합니다. 도메인의 마침표는 백슬래시로 이스케이프하고, ^와 $로 매칭 범위를 제한하므로 /old/나 쿼리 매개변수가 붙은 주소에는 일치하지 않습니다.
[URL Rewrite]
^http://lab\.example\.com/old$ http://lab.example.com/new 302
- 테스트할 때는 직접 관리하며 일반 HTTP 접속을 허용하는 도메인을 사용하고 계정 정보나 민감한 내용을 보내지 마세요. 요청이 여전히
http://인지 확인하세요. 브라우저가 먼저 HTTPS로 업그레이드하면 예제의 매칭 조건에 해당하지 않습니다. - 예상 결과는 원래 요청에
302응답이 오고, 응답의Location이/new를 가리키는 전체 URL을 지정하는 것입니다. 리디렉션을 따라가는 클라이언트는 이후 새 요청을 보냅니다. 주소창이/new로 바뀌었는데 페이지를 찾을 수 없다면 서버에 대상 경로가 실제로 존재하는지 먼저 확인하세요. - HTTPS의 경로와 쿼리 매개변수는 암호화된 콘텐츠에 포함됩니다. Shadowrocket에서 요청의 전체 URL을 볼 수 없다면 표현식의
http만https로 바꿔도 경로 매칭은 적용되지 않습니다. 제어 가능한 HTTP 예제로 먼저 표현식을 확인하고, HTTPS에서 매칭되지 않는 문제를 곧바로[Rule]탓으로 돌리지 마세요.
자주 묻는 질문: 설정을 바꾼 뒤 확인할 항목
도메인 규칙을 추가했는데 왜 기존 정책이 적용되나요?
먼저 Config에서 파일 이름을 확인한 다음, Home → Global Routing이 Config로 설정되어 있는지 확인하세요. [Rule]을 위에서 아래로 살펴보며 특히 앞쪽에 있는 DOMAIN-SUFFIX에 주의하세요. 예외 범위가 분명한 경우에만 정확히 일치하는 규칙을 해당 광범위 규칙보다 앞에 두세요.
IP 주소로 직접 접속할 때와 도메인을 입력할 때 결과가 다른 이유는 무엇인가요?
먼저 두 요청이 각각 어떤 대상을 향하는지 따로 기록하세요. 도메인을 입력하면 도메인 규칙이 먼저 적용될 수 있지만, IP 주소를 직접 입력하면 같은 도메인 규칙이 매칭되지 않습니다. 두 요청이 같은 주소에 도달하더라도 서버는 도메인에 따라 사이트를 선택할 수 있으며, IP 주소로 직접 접속하면 인증서가 일치하지 않을 수도 있습니다.
재작성 후 리디렉션이 계속 반복되면 어떤 행을 먼저 삭제해야 하나요?
먼저 복사본에서 이번에 추가한 재작성 규칙을 제거하고 다시 테스트하세요. 반복이 멈춘다면 대상 URL도 원래 표현식과 일치하는지, 또는 대상 페이지가 다시 원래 주소로 리디렉션하는지 확인하세요. 표현식을 정확한 원본 경로로 좁힌 뒤 원본 주소와 대상 주소를 각각 테스트하세요.
설정 업데이트 후 직접 추가한 항목이 사라졌다면 어떻게 해야 하나요?
먼저 Config에서 현재 선택된 것이 원격 설정인지 로컬 복사본인지 확인하세요. 원격 콘텐츠가 로컬 수정 사항을 덮어썼다면 보관해 둔 복사본에서 항목을 복구해 새 복사본의 해당 섹션에 병합하세요. 병합 후에는 규칙 순서와 중복된 도메인 매핑을 확인하고 항목별로 다시 테스트하세요.