On Demand는 시스템 VPN 연결을 언제 시작하거나 끊을지 결정하고, Config 규칙은 연결된 뒤 트래픽을 어떻게 분기할지 처리합니다. 사용할 연결 정보가 준비된 iPhone·iPad 사용자를 대상으로 Settings → On Demand, SSID 조건, 셀룰러 네트워크, 도메인 평가와 확인 순서를 설명합니다. 먼저 수동 연결을 확인한 다음 자동 실행 조건을 추가하면 연결 문제와 조건 설정 오류를 구분해 해결하기 쉽습니다.
On Demand와 Config의 역할 구분
Shadowrocket의 On Demand는 시스템의 주문형 연결 기능을 사용합니다. Home의 연결 스위치를 정해진 시간에 자동으로 누르거나, 요청마다 노드를 다시 고르는 기능은 아닙니다. 네트워크 환경이 바뀌거나 조건에 맞는 요청이 발생하면 시스템이 저장된 주문형 규칙에 따라 연결 여부를 평가합니다. 터널이 연결된 뒤에는 트래픽이 현재 Global Routing 설정과 Config 규칙에 따라 처리됩니다.
따라서 “자동으로 연결됨”과 “대상 요청이 프록시를 통과함”은 서로 다른 결과입니다. Global Routing이 Config라면 Config에서 현재 선택한 설정과 일치하는 규칙을 확인해야 합니다. Direct에서는 시스템에 VPN 연결됨으로 표시되더라도 요청이 프록시를 통해 전송된다고 볼 수 없습니다. 반대로 Proxy는 전체 트래픽을 프록시로 보내는 모드이므로, Proxy에서의 테스트 결과를 Config의 트래픽 분기 확인에 대신 사용하면 안 됩니다.
- Home: 이미 보유한 사용 가능한 노드를 선택해 수동으로 연결하고 대상 요청을 확인합니다.
- Settings → On Demand: 자동 연결 조건을 설정하고 전체 스위치, 동작, 조건 범위를 확인합니다.
- Config: 연결 후 적용되는 트래픽 분기 정책을 확인합니다. 예: DOMAIN-SUFFIX, IP-CIDR, FINAL.
사용 전 준비: 수동으로 확인할 연결 설정 유지
On Demand를 설정하기 전에 같은 네트워크에서 수동 연결이 되는지 확인하세요. 이 안내는 이미 이용 중인 서비스와 구독이 있는 경우를 전제로 합니다. 구독 업데이트가 성공해도 설정 정보를 가져왔다는 뜻일 뿐, 모든 노드의 연결 가능성을 보장하지는 않습니다. 노드 주소, 포트, 프로토콜 매개변수가 기존 설정과 각각 일치하는지 확인하고, 자동 재연결로 설정 오류를 가리지 마세요.
- Home에서 사용 가능 여부를 확인한 노드를 선택하고 On Demand를 잠시 끈 다음 현재 Global Routing 설정을 기록합니다.
- 연결을 수동으로 켜고 현재 설정으로 처리해야 하는 것으로 확인된 대상에 접속한 뒤, 연결 기록에서 실제 적용된 정책을 확인합니다.
- 연결을 끊고 Settings → On Demand로 이동합니다. 먼저 범위가 분명한 네트워크 규칙 하나만 추가해 저장한 뒤 활성화합니다.
- 시스템에서 VPN 설정을 추가하거나 업데이트하라는 메시지가 표시되면 안내에 따라 허용합니다. 그런 다음 시스템 설정에서 VPN 설정 세부 정보를 열어 해당 항목의 Connect On Demand 상태를 확인합니다.
시스템 설정의 메뉴 위치는 OS 인터페이스에 따라 달라질 수 있습니다. 시스템 설정에서 VPN을 검색한 다음 Shadowrocket에 해당하는 설정의 세부 정보를 여세요. 앱 내부 스위치만 확인하지 마세요. 시스템에 저장된 VPN 설정도 주문형 연결 동작에 영향을 줍니다. 시스템 요구 사항과 기기 호환성은 App Store 페이지 표기를 기준으로 확인하세요. Wi-Fi 전용 iPad에서는 셀룰러 네트워크 전환 테스트를 할 수 없습니다.
Wi-Fi SSID: 예외를 먼저, 넓은 조건은 나중에
SSID는 Wi-Fi 네트워크 이름이며 라우터 관리 주소나 노드 이름이 아닙니다. “특정 Wi-Fi에서는 연결을 끊고 다른 Wi-Fi에서는 자동 연결”하려면 먼저 지정한 SSID에 Disconnect 조건을 추가한 다음 범위가 더 넓은 Wi-Fi Connect 조건을 설정하세요. 시스템은 주문형 규칙을 순서대로 평가하므로 넓은 조건을 앞에 두면 뒤에 있는 특정 SSID 조건이 적용되지 않을 수 있습니다.
특정 Wi-Fi 예외
- 경로
- Settings → On Demand
- 인터페이스 조건
- Wi-Fi
- SSID 예시
- HomeNet-5G
- 동작
- Disconnect
- 순서
- 범위가 넓은 Wi-Fi 조건보다 앞에 배치
HomeNet-5G는 네트워크 이름의 예시입니다. 기기에서 실제로 연결하는 SSID로 바꿔 입력하세요.
나머지 네트워크 조건
- 경로
- Settings → On Demand
- 후속 조건
- 다른 Wi-Fi
- 동작
- Connect
- 별도 조건
- Cellular
- 확인 방법
- 네트워크 전환 후 새 요청 전송
이는 조건을 설계하는 예시이지 그대로 붙여 넣을 수 있는 설정 문법이 아닙니다. 앱에서 제공하는 편집 항목을 사용해 저장하세요.
이름을 입력할 때는 대소문자, 공백, 기호를 그대로 유지하세요. 기본적으로 와일드카드가 지원된다고 가정하면 안 됩니다. 예를 들어 HomeNet과 HomeNet-5G는 서로 다른 이름이며, 이름이 같은 두 액세스 포인트에는 하나의 SSID 조건이 모두 적용될 수도 있습니다. SSID는 네트워크 이름을 조건으로 지정할 때만 사용하며, 그 자체로 네트워크의 신뢰성을 확인해 주지는 않습니다. 특정 Wi-Fi에서 연결을 끊을지는 해당 네트워크에서의 실제 접속 필요에 따라 결정하세요.
요약: SSID 조건 하나부터 확인
먼저 지정 SSID 규칙 하나만 남기고 해당 네트워크에 연결할 때와 벗어날 때 각각 한 번씩 테스트하세요. 결과가 예상과 같으면 다른 Wi-Fi와 Cellular 조건을 추가합니다. 이렇게 하면 이름이 일치하지 않는 문제인지 뒤에 추가한 규칙이 예상 동작을 덮어쓴 것인지 쉽게 확인할 수 있습니다.
셀룰러 네트워크: 전환과 연결 복구를 따로 확인
Cellular 조건은 셀룰러 네트워크 인터페이스를 대상으로 하며, “지정된 Wi-Fi에 연결되어 있지 않음”과 같은 뜻이 아닙니다. 특정 SSID에 Disconnect 조건만 설정하고 셀룰러 네트워크 조건을 추가하지 않았다면, 해당 Wi-Fi를 벗어난 뒤의 동작을 그 예외 규칙만으로 예측할 수 없습니다. 자동 연결이 필요하면 해당 Cellular Connect 조건을 추가하고, 앞에 있는 범위가 더 넓은 Disconnect 조건이 이를 가로막지 않는지 확인하세요.
- 대상 Wi-Fi에 연결된 상태에서 Disconnect 조건이 적용되는지 확인하고 시스템 VPN 상태를 기록합니다.
- 시스템 설정에서 Wi-Fi를 끄고 기기가 현재 액세스 포인트와 잠시 연결이 끊긴 것뿐 아니라 실제로 셀룰러 네트워크를 사용하는지 확인합니다.
- 새 웹 페이지를 열거나 앱에서 새 요청을 보내 시스템 VPN이 연결되는지 확인합니다. 그런 다음 Shadowrocket에서 연결 및 요청 기록을 살펴봅니다.
- Wi-Fi를 다시 켜 지정한 SSID에 연결한 뒤, 새 네트워크 평가 결과가 Disconnect 조건과 일치하는지 확인합니다.
네트워크를 전환하면 기존 연결이 끊길 수 있고, 페이지에는 캐시된 내용이 계속 표시될 수도 있습니다. 자동 연결 성공 여부는 페이지가 즉시 새로고침되는지만 보지 말고 새 요청과 시스템 VPN 상태를 확인하세요. VPN은 연결됐는데 접속이 안 된다면 Connect 조건을 더 추가하기보다 셀룰러 네트워크에서 노드에 연결할 수 있는지, DNS가 정상인지, 현재 Config에서 대상 규칙이 어떻게 설정됐는지 확인하세요.
도메인 트리거: 연결 평가와 DOMAIN-SUFFIX 구분
도메인 기반 트리거의 핵심은 시스템의 연결 평가입니다. Config에 도메인을 입력한다고 터널이 자동으로 연결되는 것은 아닙니다. 시스템의 On Demand Evaluate Connection 기능은 도메인 및 DNS 확인 조건에 따라 연결을 시도할지 결정할 수 있습니다. Connect If Needed도 “접속할 때마다 무조건 연결”을 뜻하지 않습니다. 현재 On Demand 편집기에서 제공하는 도메인 평가 옵션을 기준으로 설정하고, Config의 DOMAIN-SUFFIX 행을 네트워크 조건에 붙여 넣지 마세요.
| 항목 | 처리 단계 | 확인할 내용 |
|---|---|---|
| On Demand 도메인 평가 | 연결이 필요한지 결정 | 도메인 조건, DNS 확인 결과 및 연결 동작 |
| DOMAIN-SUFFIX | 연결 후 트래픽 매칭 | 도메인 접미사 및 정책 이름 |
| IP-CIDR | 연결 후 IP 주소 매칭 | 대상 IP가 지정된 네트워크 대역에 포함되는지 |
| FINAL | 앞선 규칙과 일치하지 않을 때 | 기본 정책이 예상대로 적용되는지 |
예를 들어 Config의 DOMAIN-SUFFIX,example.com,PROXY는 도메인 접미사를 기준으로 트래픽을 분기하는 조건이지 On Demand를 자동으로 시작하는 명령이 아닙니다. 여기서 example.com은 규칙 구조를 설명하기 위한 예시이며, PROXY도 현재 설정에서 유효해야 합니다. 도메인 트리거를 테스트할 때는 경로나 쿼리 매개변수가 붙은 전체 웹 주소가 아니라 도메인을 입력하세요.
- 먼저 일치하는 조건 확인: 앞쪽 네트워크 조건이 이미 Connect라면 터널이 먼저 연결됐을 수 있습니다. 이 상태에서는 뒤에 있는 도메인 평가가 실제로 트리거됐는지 확인할 수 없습니다.
- DNS 확인 경로 점검: DNS 캐시 또는 앱 자체의 암호화 DNS 사용으로 인해 테스트가 예상한 시스템 DNS 평가 경로를 거치지 않을 수 있습니다.
- 연결 유지 주기 확인: 대상 웹 페이지를 닫아도 VPN 연결이 즉시 끊기는 것은 아닙니다. 도메인 평가는 브라우저 탭을 열고 닫는 동작과 동일하지 않습니다.
현재 편집기에서 필요한 도메인 평가 옵션을 제공하지 않는다면 확인 가능한 Wi-Fi 및 Cellular 조건을 먼저 사용하세요. 이름이 같은 Config 규칙을 도메인 연결 조건인 것처럼 사용하면 안 됩니다. 테스트할 때는 도메인 조건 또는 네트워크 조건 중 한 번에 하나만 변경하고 기존 설정을 기록해 두세요. 두 가지 방식이 동시에 바뀌면 결과를 특정 규칙 하나의 영향으로 판단하기 어렵습니다.
우선순위와 자주 발생하는 설정 오류: 증상별 확인
On Demand 순서와 Config 규칙 순서는 서로 다른 계층입니다. 전자는 연결 동작을, 후자는 트래픽 정책을 제어합니다. FINAL을 맨 아래로 옮겨도 SSID 조건은 수정되지 않으며, SSID 순서를 바꿔도 대상 도메인에 잘못된 정책이 적용되는 문제는 해결되지 않습니다. 문제를 확인할 때는 먼저 시스템이 터널을 연결했는지, 그다음 요청이 어떤 규칙과 일치했는지 확인하세요.
Home에서 연결을 껐는데 잠시 후 다시 연결되는 이유는 무엇인가요?
Settings → On Demand에서 자동 연결이 계속 활성화되어 있는지 확인하세요. 자동 동작을 일시 중지하려면 먼저 On Demand를 끄고 시스템 VPN 설정의 Connect On Demand 상태도 확인한 다음 수동으로 연결을 끊습니다. Home의 스위치만 조작하는 것으로 주문형 조건이 비활성화되지는 않습니다.
특정 Wi-Fi에 Disconnect를 설정했는데도 연결되는 이유는 무엇인가요?
먼저 시스템의 Wi-Fi 세부 정보에서 실제 SSID를 확인한 다음 규칙 순서를 살펴보세요. 특정 SSID 조건을 범위가 넓은 Wi-Fi Connect 조건보다 앞에 배치하고 저장한 뒤 해당 네트워크에 다시 연결해 새 요청을 보내고 상태를 확인합니다.
셀룰러 네트워크에서는 자동 연결되지만 웹 페이지가 열리지 않는 이유는 무엇인가요?
먼저 On Demand를 잠시 끄고 같은 셀룰러 네트워크에서 수동 연결을 테스트하세요. 수동 연결도 실패한다면 Home으로 돌아가 선택한 노드를 확인한 뒤 프로토콜 매개변수, DNS, Global Routing을 점검하세요. 기본 연결 문제를 해결한 다음 자동 조건을 다시 활성화합니다.
Config에 도메인 규칙을 설정했는데 접속해도 자동 연결되지 않는 이유는 무엇인가요?
DOMAIN-SUFFIX는 트래픽 분기만 처리합니다. Settings → On Demand에서 적용할 수 있는 연결 조건이 있는지 확인하세요. 도메인 평가를 사용한다면 앞선 네트워크 규칙, 시스템 DNS 확인 경로, 캐시도 점검해야 합니다. Config 규칙과 일치한다고 해서 시스템 연결 평가까지 대신할 수는 없습니다.
설정을 마친 뒤에는 반복해서 확인할 수 있도록 현재 네트워크, SSID 또는 Cellular, 일치한 주문형 조건, 시스템 VPN 상태, 새 요청에 실제 적용된 정책을 기록하세요. 필요한 정보만 남기고 구독 주소, 인증 정보, 전체 연결 매개변수는 공개하지 마세요. 한 번에 한 항목만 변경한 뒤 같은 방식으로 다시 확인하면 예외 조건을 여러 개 동시에 추가하는 것보다 문제를 쉽게 찾을 수 있습니다.
- 특정 Wi-Fi: 연결 후 Disconnect를 확인하고, 네트워크를 벗어난 뒤 다음으로 적용될 조건을 확인합니다.
- 다른 Wi-Fi: Connect 조건이 현재 네트워크에 실제로 적용되는지 확인하고, 필요한 경우 먼저 웹 인증을 완료합니다.
- Cellular: 인터페이스가 전환됐는지 확인하고 새 요청으로 연결 및 트래픽 전송을 테스트합니다.
- 도메인 평가: 범위가 넓은 Connect 조건의 영향을 분리한 다음 DNS 확인 및 트리거 결과를 점검합니다.