아웃바운드 정책을 바꾸려면 [Rule], 도메인에 대응하는 주소를 바꾸려면 [Host], URL 경로를 바꾸려면 [URL Rewrite], 전체 설정의 파싱 등 공통 동작을 조정하려면 [General]을 사용합니다. 이 글에서는 iPhone / iPad의 Home과 Config를 기준으로 확인 방법을 안내합니다. Mac, Windows, Android, Linux에서 설정 파일을 볼 때는 섹션 이름과 규칙 문법을 참고하고, 동일한 탭 경로를 따를 필요는 없습니다.
01. 현재 Config와 Global Routing 확인
.conf는 섹션별로 나뉜 일반 텍스트 설정 파일입니다. 대괄호로 된 제목은 이어지는 각 줄이 속한 섹션을 나타냅니다. 예를 들어 같은 도메인이라도 [Rule]에 있으면 매칭 조건이고, [Host]에 있으면 주소 매핑의 키입니다. 아래 섹션은 각각 대조해 볼 수 있는 예제이며, 전체 설정을 이 내용으로 덮어쓰지 마세요.
- Config를 열어 현재 선택된 파일 이름을 기록하고 원본을 보관합니다. 복사본을 따로 저장한 뒤 편집하세요. 기존 파일에 해당 섹션이 이미 있다면 새 줄을 그 섹션에 추가하고, 예제를 붙여 넣기 위해 섹션 제목을 다시 쓰지 마세요.
- Config에서 편집한 복사본이 선택되어 있는지 확인한 다음 Home으로 돌아가 Global Routing을
Config로 설정합니다.[Rule]을 테스트할 때는Proxy나Direct로 고정하지 마세요. 그러면 현재 요청으로 규칙별 분기 결과를 확인할 수 없습니다. - 연결을 유지하고 같은 테스트 대상을 사용해 수정 전후 결과를 비교합니다. 매번 한 섹션에서 조건 하나만 바꾸세요. DNS, 규칙, 재작성을 동시에 수정하면 페이지가 정상으로 돌아와도 어떤 변경이 효과가 있었는지 확인하기 어렵습니다.
02. [General]: 전역 설정과 DNS 기본값
[General]은 주로 키 = 값 형식으로 작성합니다. 이 섹션은 설정의 공통 동작을 정의하며, 특정 사이트의 아웃바운드 선택을 지정하지는 않습니다. 이름 해석 문제를 확인할 때는 먼저 기존 dns-server 값을 기록한 뒤 변경 여부를 판단하세요. 도메인 하나를 해결하려고 섹션 전체를 바꾸지 마세요.
[General]
dns-server = system
system은 시스템 DNS를 사용한다는 뜻이며, 이 줄에서 특정 리졸버를 지정하지 않습니다. Wi-Fi와 모바일 네트워크를 전환하면 시스템이 사용하는 DNS 환경도 달라질 수 있습니다. 결과를 비교할 때는 먼저 네트워크를 고정한 뒤 같은 도메인을 확인하세요. 도메인이 IP 주소로 해석되더라도 대상 포트에 연결할 수 있다는 뜻은 아니며, 서버가 연결을 받아들인다는 보장도 없습니다.
dns-server를 수정한 뒤 여러 도메인에서 동시에 이름 해석 문제가 발생하면 기존 값으로 되돌리고 같은 네트워크에서 다시 확인하세요.- 직접 관리하는 도메인 하나만 이전 주소로 해석된다면 먼저
[Host]에 해당 이름의 매핑이 남아 있는지 확인하세요. 도메인 하나만으로 전역 DNS가 작동하지 않는다고 판단하지 마세요. - 도메인은 정상적으로 해석되지만 아웃바운드 경로가 잘못되었다면
[Rule]과 Global Routing을 확인하세요. 리졸버를 바꿔도 규칙 순서 문제는 해결되지 않습니다.
03. [Rule]: 첫 일치 규칙, IP 조건과 FINAL
일반 규칙은 매칭 유형, 조건, 정책을 반각 쉼표로 구분합니다. Shadowrocket은 위에서 아래로 규칙을 확인하고, 일치하는 규칙을 찾으면 해당 정책을 적용하며 더 구체적인 규칙을 계속 찾지 않습니다. FINAL에는 별도의 매칭 조건이 없으며, 앞선 규칙에 일치하지 않은 요청을 처리합니다. 규칙 섹션의 마지막에 배치하세요.
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY
각 줄에서 예상 아웃바운드 확인
도메인 매칭
DOMAINapi.example.com은 첫 번째 줄과 정확히 일치하므로PROXY를 사용합니다.DOMAIN-SUFFIXwww.example.com은 접미사 규칙과 일치하므로DIRECT를 사용합니다.- 규칙 순서 변경
- 접미사 규칙을 맨 위로 옮기면
api.example.com도 해당 줄과 먼저 일치해DIRECT로 연결됩니다.
같은 접미사에 예외 도메인이 있다면 정확히 일치하는 규칙을 더 넓은 범위의 규칙보다 앞에 두세요.
주소 매칭과 기본 처리
IP-CIDR- 확인 가능한 대상 IP를 기준으로 서브넷을 매칭합니다. 대상 IP가
192.0.2.10인 요청은 예제 서브넷에 해당합니다. no-resolve- 이 규칙을 매칭하기 위해 도메인을 직접 해석하지 않습니다. DNS 전체를 비활성화하는 것은 아닙니다.
FINAL- 앞선 규칙이 모두 일치하지 않을 때만
PROXY를 사용합니다. 실제 프록시 아웃바운드를 확인하려면 사용 가능한 서비스가 있어야 합니다.
예제 서브넷은 문서용으로 예약된 주소이며, 매칭 동작을 설명하는 데만 사용합니다. 공용 인터넷 연결 테스트에는 사용하지 마세요.
특정 도메인의 아웃바운드가 잘못되면 첫 일치 규칙부터 확인
규칙 섹션의 위쪽부터 해당 도메인에 적용될 수 있는 정확 일치 또는 접미사 규칙을 찾으세요. 범위가 넓은 규칙이 예외보다 앞에 있다면 예외 규칙만 위로 옮긴 뒤 원래 도메인으로 확인합니다. FINAL을 수정하면 일치하지 않은 다른 요청의 아웃바운드도 달라지므로 변경하지 마세요.
GEOIP도 대상 IP를 기준으로 판단합니다. 예를 들어 GEOIP,CN,DIRECT는 지리 IP 데이터에서 CN으로 분류된 대상과 일치한다는 뜻입니다. 웹페이지 언어를 읽거나 도메인 접미사로 판단하지 않습니다. 정확한 도메인 예외를 먼저 적용하려면 해당 예외를 적용 범위가 겹칠 수 있는 IP 유형 규칙보다 앞에 두세요.
04. [Host]: 도메인의 해석 주소 고정, URL은 변경하지 않음
[Host]에서는 지정한 이름에 로컬 매핑을 설정할 수 있습니다. 아래 줄은 문서용 예약 주소를 사용해 문법을 보여줍니다. 왼쪽에는 프로토콜, 포트, 경로 없이 호스트 이름만 쓰고, 오른쪽에는 대상 IP를 씁니다. 이 설정은 [Rule]에서 해당 도메인에 DIRECT를 지정하는 것과 다릅니다.
[Host]
lab.example.com = 192.0.2.10
- 테스트하려면 예제 도메인과 IP를 직접 관리하는 테스트 이름 및 접속 가능한 서버 주소로 바꾸세요. 서버의 접속 기록을 확인해 요청이 예상한 서버에 도달했는지 확인하고, 브라우저 주소 표시줄만 보지 마세요. 매핑이 적용되어도 주소 표시줄에는 원래 도메인이 표시될 수 있습니다.
- 기존 프록시 서비스를 사용한다면 대상 이름을 로컬에서 해석하는지, 원격에서 해석하는지도 구분해야 합니다. 로컬 매핑을 확인할 때는 직접 제어할 수 있는 직결 테스트 대상을 먼저 사용하세요. 원격 해석 결과를 로컬 매핑 실패로 오해하지 않도록 합니다.
- 서버가 요청을 받았지만 인증서 오류를 반환한다면 인증서에 URL의 원래 호스트 이름이 포함되어 있는지 확인하세요. 해석 주소를 바꿔도 HTTPS 검증에 사용되는 이름은 바뀌지 않으며, 서버의 다른 포트를 URL에 지정된 포트로 바꾸지도 않습니다.
05. [URL Rewrite]: URL 매칭 및 리디렉션 응답
[URL Rewrite]는 클라이언트가 전체 URL을 확인할 수 있는 요청을 대상으로 합니다. 예제는 왼쪽부터 정규 표현식, 대상 URL, 리디렉션 유형 순서입니다. 일반 HTTP의 /old 요청을 같은 호스트의 /new로 임시 리디렉션합니다. DNS 매핑을 처리하지 않으며, DIRECT나 PROXY를 재작성 대상으로 사용하지 않습니다.
[URL Rewrite]
^http://lab\.example\.com/old$ http://lab.example.com/new 302
\.는 점 문자를 그대로 매칭하고,^와$는 URL 전체를 대상으로 매칭하도록 제한합니다./old/와/old?from=test는 일치하지 않으며, 대상인/new도 이 줄과 다시 일치하지 않습니다.- 확인할 때는 직접 관리하며 일반 HTTP 요청을 받을 수 있는 테스트 사이트를 사용하세요.
/old와/old/의 첫 응답을 비교합니다. 전자는302와/new를 가리키는Location을 받을 것으로 예상되며, 후자는 이 규칙으로 리디렉션되지 않아야 합니다. 브라우저의 최종 주소만 보면 리디렉션을 자동으로 따라간 뒤의 결과를 첫 응답으로 오해할 수 있습니다. - 브라우저가 먼저
http://를https://로 업그레이드하면 요청은 예제 정규식과 일치하지 않습니다. HTTPS 요청에서는 경로가 암호화되므로 도메인만으로 경로가/old인지 판단할 수 없습니다. 이 HTTP 예제로 HTTPS 경로 재작성의 작동 여부를 판단하지 마세요.
06. 변경 사항이 적용되지 않을 때 확인 순서
복사본을 저장했는데도 이전 규칙이 적용되는 이유는?
먼저 Config에서 현재 선택된 파일 이름을 확인하고, Home에서 Global Routing이 Config인지 확인하세요. 같은 대상에 새 요청을 보냅니다. 연결이 계속 재사용된다면 기존 요청을 종료한 뒤 다시 테스트하세요. 그래도 예상과 다르면 규칙 섹션의 맨 위부터 해당 대상에 적용되는 첫 규칙을 찾으세요.
Host를 바꿨는데 주소 표시줄이 바뀌지 않는 이유는?
[Host]는 해석 주소를 바꾸며 URL은 바꾸지 않습니다. 대상 서버에서 새 요청이 도착했는지 확인하세요. 주소 표시줄의 /old를 /new로 바꾸려면 리디렉션을 확인해야 합니다. 경로를 [Host]의 키 이름에 추가하지 마세요.
원래 접속되던 사이트가 변경 후 열리지 않을 때, 무엇부터 되돌려야 하나요?
Config에서 편집 전 원본을 다시 선택하고, 같은 네트워크와 테스트 주소를 사용해 비교합니다. 원본이 작동한다면 복사본에서 마지막 변경 하나를 되돌린 뒤 항목별로 확인하세요. 원본도 실패한다면 Home의 연결 상태와 현재 네트워크부터 확인하고, FINAL을 계속 수정하거나 DNS 설정을 추가하지 마세요.