공식 가이드 / 설정 참고

Shadowrocket 기능 및 설정

먼저 Home에서 트래픽 처리 방식을 확인한 다음 Config의 규칙을 점검하세요. 자동 연결을 설정하거나 문제를 해결하려면 Settings를 조정하세요. 아래 설명은 iPhone / iPad 화면을 기준으로 합니다.

Global Routing

Home에서 라우팅 모드 선택

연결 스위치와 라우팅 모드는 별개의 설정입니다. 연결 스위치는 Shadowrocket이 트래픽을 처리할지 결정하고, Global Routing은 처리할 트래픽의 방식을 정합니다. Home에서 Global Routing을 열고 Config, Proxy 또는 Direct를 선택하세요. 처음 설정한다면 먼저 Proxy로 서버가 트래픽을 전달하는지 확인한 뒤 Config로 전환해 실제 규칙을 점검할 수 있습니다.

Global Routing의 세 가지 모드
화면 옵션 트래픽 처리 방식 사용 시점
Config(구성) 현재 구성에 설정된 규칙과 정책에 따라 처리합니다. 일상적인 라우팅에 사용합니다. 예를 들어 로컬 네트워크 서비스는 직접 연결하고, 지정한 다른 요청은 프록시를 사용하도록 설정할 수 있습니다.
Proxy(프록시) 처리 대상 트래픽을 현재 선택된 프록시 서버로 보냅니다. 규칙 매칭의 영향을 잠시 제외하고 서버의 트래픽 전달을 확인할 때 사용합니다.
Direct(직접 연결) 처리 대상 트래픽이 프록시 서버를 거치지 않고 목적지에 직접 연결됩니다. 현재 네트워크에서 직접 연결되는지 비교할 때 사용합니다.

문제를 확인할 때는 네트워크, 서버, 테스트 대상을 그대로 두고 한 번에 하나씩만 변경하세요. Proxy는 되지만 Config가 안 될 경우, 먼저 원하는 구성이 활성화되어 있는지 확인한 다음 앞선 규칙이 먼저 매칭되는지 살펴보세요. Direct도 실패하면 현재 네트워크에서 해당 목적지에 접속할 수 있는지 확인하세요. Direct는 연결을 끄는 기능이 아닙니다. Shadowrocket이 트래픽을 처리하지 않을 때의 결과를 비교하려면 Home에서 연결 스위치를 끈 뒤 테스트하세요.

규칙 기반 라우팅

Config에서 매칭 조건과 처리 정책 수정

각 규칙은 매칭 조건과 처리 정책으로 구성됩니다. Config에서 현재 활성화된 구성을 확인하고, 복원할 수 있도록 원본을 보관한 뒤 해당 구성의 Rule을 수정하세요. 저장한 후 Home으로 돌아가 Global Routing에서 Config가 선택되어 있는지 확인하세요. 다른 구성을 편집했다면 저장만으로는 적용되지 않습니다.

  • 도메인 기준: DOMAIN은 지정된 호스트명을 매칭합니다. DOMAIN-SUFFIX는 도메인과 하위 도메인을 매칭하고, DOMAIN-KEYWORD는 도메인에 포함된 지정 문자열을 매칭합니다. 특정 호스트 하나에만 적용하려면 DOMAIN을 우선 사용해 다른 도메인까지 잘못 매칭되지 않도록 하세요.
  • IP 주소 기준: IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 대역을 매칭합니다. GEOIP는 도메인 접미사나 기기의 위치가 아니라 대상 IP의 지리적 분류를 기준으로 매칭합니다. 같은 도메인도 서로 다른 주소로 확인될 수 있으므로 IP 기준 매칭 결과가 달라질 수 있습니다.
  • 요청 특성 및 기본 처리 기준: USER-AGENT는 요청에서 식별할 수 있는 User-Agent에 의존하므로 모든 연결에 적용할 일반 조건으로는 적합하지 않습니다. FINAL은 앞선 규칙에 매칭되지 않은 요청을 처리하므로 규칙 목록의 마지막에 두세요.

자주 사용하는 정책은 PROXY, DIRECT, REJECT이며 각각 프록시 전달, 직접 연결, 요청 거부를 뜻합니다. 규칙은 보통 순서대로 매칭되며 먼저 일치한 항목이 트래픽 경로를 결정합니다. 구체적인 예외는 포괄적인 규칙보다 앞에 배치하세요. 그렇지 않으면 뒤에 있는 예외 규칙이 올바르게 작성되어도 적용되지 않을 수 있습니다.

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

이 예시에서는 status.example.com이 먼저 직접 연결 규칙에 매칭되고, example.com과 다른 하위 도메인은 프록시를 사용하며, 매칭되지 않은 요청은 직접 연결됩니다. 규칙 순서를 설명하기 위한 예시이며 전체 구성은 아닙니다. 확인할 때는 새 요청을 보내 예외 대상과 일반 대상을 각각 열어 보세요. 여전히 문제가 있으면 규칙 문법과 매칭 순서를 참고해 범위를 단계적으로 좁히세요.

구독 및 서버

Home에서 SERVER 목록 관리

SERVER 목록에는 선택 가능한 서버가 저장됩니다. 이미 단일 서버의 접속 정보를 가지고 있다면 직접 추가할 수 있습니다. Home에서 Add Server를 열고 서비스 제공업체가 지정한 프로토콜을 선택한 다음 주소, 포트, 인증 정보를 입력해 저장하세요. 프로토콜마다 입력 항목이 다릅니다. 익숙하지 않은 항목은 서비스 제공업체가 안내한 정보를 확인하고, 한 프로토콜의 설정을 다른 프로토콜에 그대로 적용하지 마세요.

구독을 이용하면 여러 서버를 가져와 업데이트할 수 있습니다. 구독 주소는 이용 중인 서비스 제공업체에서 받으세요. Add Server에서 Subscribe를 선택해 이미 보유한 구독 주소를 입력하고 저장한 다음 SERVER로 돌아가 해당 항목이 표시되는지 확인하세요. 구독을 갱신하거나 주소를 변경한 뒤에는 해당 구독 그룹을 업데이트하고 현재 선택된 서버도 다시 확인하세요. 기존 항목이 교체될 수 있으므로 목록에 항목이 남아 있다는 사실만으로 현재 사용 중인 서버가 유효하다고 볼 수는 없습니다.

‘구독이 업데이트되는지’, ‘서버가 Connectivity Test를 통과하는지’, ‘목표 서비스에 접속할 수 있는지’를 각각 확인하세요. 구독 업데이트 성공은 클라이언트가 목록을 가져왔다는 뜻일 뿐, 목록의 모든 서버에 접속할 수 있다는 의미는 아닙니다. 테스트를 통과해도 현재 규칙이 해당 요청을 그 서버로 보내는 것은 아닙니다. 다른 사람에게 도움을 요청할 때는 프로토콜 이름과 오류가 발생한 단계를 설명하고, 전체 구독 주소나 인증 정보 또는 해당 내용이 포함된 스크린샷은 공유하지 마세요.

On Demand

Settings에서 연결 시작 조건 관리

On Demand는 조건이 충족될 때 시스템이 VPN 연결을 자동으로 시작할지 결정합니다. Global Routing을 대체하지 않으며 Config를 Proxy로 자동 전환하지도 않습니다. 먼저 Home에서 수동으로 연결하고 시스템 VPN 설정 권한이 준비되었는지 확인하세요. 그런 다음 Settings에서 On Demand를 켜고 화면에 제공되는 네트워크 조건에 따라 자동 연결 범위를 설정하세요.

처음 설정할 때는 조건을 하나씩만 확인하세요. 예를 들어 특정 Wi‑Fi 네트워크에 연결하면 자동 연결되는지 확인하려면 네트워크 이름이 조건과 일치하는지 확인한 뒤 해당 네트워크에서 나갔다가 다시 연결하고 Home에서 연결 상태를 확인하세요. 이 조건이 제대로 작동한 다음 다른 조건을 추가하세요. 호텔이나 공용 Wi‑Fi에서 웹 인증이 필요하다면 먼저 인증을 완료한 뒤 자동 연결을 테스트하세요. 인증 전후에는 네트워크 연결 상태가 다를 수 있습니다.

수동으로 연결을 끊었는데 다시 연결된다면 Home의 스위치를 반복해서 끄기보다 현재 네트워크가 On Demand 조건을 계속 충족하는지 먼저 확인하세요. 문제를 점검할 때 On Demand를 잠시 비활성화하고 같은 대상을 수동으로 테스트할 수 있습니다. 수동 연결도 실패하면 네트워크, 서버, 라우팅 설정을 먼저 확인하고 수동 연결이 정상적으로 작동한 뒤 자동 연결을 다시 켜세요.

Data 트래픽 통계

기준값을 기록한 뒤 업로드 및 다운로드 비교

Data에서는 클라이언트가 기록한 트래픽을 확인할 수 있습니다. Data를 열고 먼저 통계 범위, 기간, 단위를 확인한 다음 업로드와 다운로드를 비교하세요. 한 번의 작업을 확인하려면 현재 수치를 기록하고, 제어 가능한 소량의 요청을 한 번 보낸 뒤 같은 화면으로 돌아와 증가량을 확인하세요. 테스트 중에는 동영상 재생이나 파일 다운로드를 피하세요. 백그라운드 활동도 같은 시간대의 통계에 포함될 수 있습니다.

Data의 통계 범위, 측정 방식, 시간대는 서비스 제공업체의 청구 내역과 다를 수 있으므로 서버 이용 잔량을 확인하는 데 직접 사용할 수 없습니다. 수치가 변하지 않는다면 연결이 계속 켜져 있는지, 요청이 캐시에서 처리된 것은 아닌지, 현재 화면의 통계 범위에 해당 연결이 포함되는지 확인하세요. 통계를 지우기 전에 작업이 적용되는 범위를 확인하세요. 설정 변경 전후를 비교하려면 기존 수치와 테스트 시간을 기록해 두는 것이 총량이 나온 스크린샷만 남기는 것보다 유용합니다.

Settings 주요 항목

DNS 확인, 테스트, 빠른 실행, 동기화 구분하기

DNS: 어떤 구성이 이름 해석을 결정하는지 확인

DNS는 호스트명을 IP 주소로 변환합니다. DNS 문제가 서버 연결 실패처럼 보일 때도 있습니다. 일부 도메인만 접속되지 않는다면 Config에서 현재 구성의 DNS 관련 설정을 확인하세요. 구성의 [General]에 dns-server가 있다면 수정 전에 기존 값을 기록해 두세요. 한 번에 설정 하나만 변경하고 연결을 다시 만든 뒤 같은 도메인으로 새 요청을 보내 확인하세요. 로컬 네트워크 서비스 이름을 원래 로컬 DNS에서 확인하고 있었다면 다른 DNS로 무작정 바꿀 경우 해당 이름이 해석되지 않을 수 있습니다.

Test Method: 테스트 조건부터 통일

Test Method는 Connectivity Test가 연결 결과를 판정하는 방식을 결정합니다. Settings에서 현재 Test Method를 확인하고 문제 점검 목적에 맞는 방식을 선택한 다음 Home으로 돌아가 Connectivity Test를 실행하세요. 테스트 대상도 변경할 수 있다면 변경 전후에 같은 대상을 사용하세요. 한 번의 시간 초과는 테스트 대상이나 현재 네트워크 때문일 수 있고, 한 번의 성공이 다른 사이트에도 접속할 수 있음을 뜻하지는 않습니다. 실제 서비스 접속을 확인하려면 문제가 발생한 대상도 테스트해야 합니다.

Today Widget: 빠른 실행의 동작 범위 확인

Today Widget은 빠른 실행 기능이며 별도의 라우팅 모드가 아닙니다. Settings에 Today Widget 설정이 있다면 클라이언트에서 해당 설정을 확인한 다음 시스템의 위젯 관리 화면에서 추가할 수 있는지 확인하세요. 추가한 뒤 연결 동작을 한 번 실행하고 Home으로 돌아가 최종 연결 상태와 현재 Global Routing을 확인하세요. 시스템에 해당 위젯이 표시되지 않으면 Home에서 계속 조작하면 됩니다. 이를 위해 규칙이나 서버를 변경할 필요는 없습니다.

iCloud 동기화: 기기 간 사용 전 동기화 범위 확인

Settings에서 iCloud 관련 옵션을 확인해 어떤 항목을 동기화할 수 있는지 살펴보고 두 기기가 같은 iCloud 계정으로 로그인되어 있는지 확인하세요. 먼저 인증 정보가 없는 설정을 하나 변경해 동기화를 테스트한 다음 다른 기기에서 실제로 활성화된 구성을 확인할 수 있습니다. 동기화를 완전한 백업으로 여기거나 시스템 VPN 권한 및 현재 연결 상태까지 함께 복사된다고 가정하지 마세요. 기기를 바꾼 뒤에는 항목별로 다시 확인해야 합니다.

Diagnostics: 재현 가능한 문제 기록

시간 초과나 연결 끊김이 반복되면 발생 시각, 네트워크 종류, Global Routing 모드, 실패 범위를 먼저 기록하세요. Settings에서 Diagnostics를 제공한다면 문제가 재현되는 동안 진단 정보를 확인하고 Home의 연결 상태 및 Connectivity Test 결과와 비교하세요. 각 테스트 조건은 가능한 한 동일하게 유지하세요. 기록을 공유하기 전에는 서버 주소, 구독 링크, 인증 정보와 불필요한 접속 기록을 삭제하고 문제 파악에 필요한 정보만 남기세요.

클라이언트 다운로드 및 관련 가이드

iPhone / iPad 버전은 App Store 제품 페이지에서 $2.99에 한 번 구매할 수 있으며, 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료입니다. 설치 파일과 각 운영체제에서 처음 실행할 때의 허용 안내는 클라이언트 다운로드에서 확인하세요. 설치 파일은 본 사이트의 /dl/에서 제공합니다.

첫 연결 설정을 마치지 않았다면 빠른 시작을 먼저 확인하세요. 단계별로 권한, 연결, 일상적인 관리 항목을 다시 살펴보려면 전체 사용 가이드를 참고하세요. 구체적인 오류 메시지가 표시되면 문제 해결에서 확인할 수 있습니다.