Shadowrocket 공식 매뉴얼 · 설정 가이드
Shadowrocket 기능 및 주요 설정
먼저 Global Routing에서 모드를 선택한 다음 구성, 서버, 테스트 결과를 확인하세요. 이 페이지는 iPhone / iPad 화면을 기준으로 설명합니다. 다른 플랫폼의 메뉴와 옵션은 해당 클라이언트에서 확인하세요.
Global Routing: 구성, 프록시, 직접 연결
Home에서 Global Routing을 열어 모드를 선택합니다. 이 설정은 연결의 트래픽 라우팅 방식을 결정합니다. SERVER에서 서버를 선택해도 Global Routing이 자동으로 Proxy로 바뀌지는 않습니다. 테스트할 때는 현재 모드와 선택한 서버를 기록한 뒤 같은 대상을 기준으로 비교하세요.
| 모드 | 연결 방식 | 사용 시점 |
|---|---|---|
| 구성(Config) | 현재 적용 중인 구성의 규칙을 매칭하고, 일치하는 정책에 따라 연결을 처리합니다. | 평소 목적지별로 트래픽을 라우팅하거나 특정 규칙의 적용 여부를 확인할 때 |
| 프록시(Proxy) | 프록시를 통해 연결하며, Config의 라우팅 규칙에 따라 정책을 각각 선택하지 않습니다. | 선택한 서버로 같은 대상에 접속할 수 있는지 확인해 구성의 규칙이 문제인지 판단할 때 |
| 직접 연결(Direct) | 선택한 프록시 서버를 거치지 않고 연결합니다. | 현재 네트워크의 직접 연결 상태를 기준으로 삼아 네트워크 자체의 문제와 프록시 경로의 문제를 구분할 때 |
Direct를 선택해도 Home의 연결 스위치가 꺼지는 것은 아닙니다. 앱이 연결을 처리하기 전후의 차이를 비교하려면 연결을 끈 상태에서도 별도로 테스트하세요. 모드를 바꾼 뒤에는 새 요청을 보내야 합니다. 이미 연결된 세션이나 캐시된 페이지를 새 테스트 결과로 오인하지 마세요. Proxy에서는 정상인데 Config에서 문제가 생기면 서버를 바로 바꾸기보다 실제 적용 중인 구성과 규칙 순서를 먼저 확인하세요.
Config: 규칙 유형, 정책, 우선순위
규칙은 대상의 특징과 처리 정책을 함께 지정합니다. Config에서 현재 활성화된 구성을 찾아 원본을 먼저 보관한 뒤 규칙을 추가하거나 수정하세요. DOMAIN은 지정한 도메인을 매칭합니다. DOMAIN-SUFFIX는 도메인 접미사를 매칭하므로 기본 도메인과 하위 도메인에 같은 정책을 적용할 때 적합합니다. DOMAIN-KEYWORD는 도메인에 포함된 키워드로 매칭합니다. 범위가 넓어 다른 도메인까지 함께 매칭될 수 있으므로 특정 대상 하나만 처리하는 경우에는 적합하지 않습니다.
IP-CIDR은 IPv4 주소 대역을, IP-CIDR6은 IPv6 주소 대역을 매칭합니다. GEOIP는 대상 IP의 지리적 위치를 기준으로 매칭하며 접속한 사용자의 위치를 뜻하지 않습니다. 도메인 해석 결과는 네트워크나 시간에 따라 달라질 수 있습니다. 주소 기반 규칙을 확인할 때 한 번 테스트해 얻은 주소가 계속 같다고 가정하지 마세요.
PROXY는 연결을 프록시로 처리하고, DIRECT는 직접 연결하며, REJECT는 연결을 거부합니다. 다음은 규칙 작성 형식의 예시입니다. 지정한 도메인은 PROXY로 처리하고, 매칭되지 않은 나머지 대상은 FINAL,DIRECT로 처리합니다. 완전한 구성 파일이 아니며 서버 정보도 포함하지 않습니다.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
Subscribe 및 SERVER: 가져오기, 선택, 업데이트
구독 주소가 있다면 Home의 추가 메뉴에서 Add Server를 열고 유형으로 Subscribe를 선택한 뒤 주소를 입력하세요. 개별 서버 정보가 있다면 Add Server에서 정보에 명시된 프로토콜(예: Shadowsocks, VLESS, Trojan)을 선택하고 주소, 포트, 해당 프로토콜에 필요한 항목을 입력하세요. 정보가 QR 코드로 제공된 경우 Scan QR Code로 인식할 수 있습니다. 저장하기 전에 인식된 유형과 대상을 확인하세요. 구독 주소와 서버 인증 정보는 비밀번호처럼 안전하게 보관하고 공개 스크린샷이나 문제 해결 기록에 포함하지 마세요.
저장한 뒤 Home의 SERVER 목록에 항목이 표시되는지 확인하고 테스트할 서버를 선택한 다음 Connectivity Test를 실행하세요. 구독을 업데이트하면 항목 이름이 바뀌거나 삭제되거나 매개변수가 변경될 수 있습니다. 이전 이름만 보고 같은 서버가 선택되었다고 판단하지 마세요. 업데이트에 실패하면 먼저 붙여넣은 내용이 완전한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 확인한 다음 기존 정보가 여전히 유효한지 살펴보세요. 업데이트는 성공했지만 테스트 하나만 실패했다면 구독 전체를 삭제하고 다시 가져오기보다 해당 서버를 따로 점검하세요.
클라이언트와 연결에 필요한 정보는 별도로 제공됩니다. 클라이언트 일회성 구매 ≠ 연결 서비스 요금제입니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 사용할 정보가 없다면 먼저 사용 가이드에서 입력 항목과 절차를 확인하세요.
On Demand: 조건에 따른 연결
On Demand는 조건이 충족될 때 시스템이 VPN 연결을 시작하도록 설정합니다. 연결 시점을 결정하는 기능이며 연결 후 트래픽을 어떻게 처리할지는 Global Routing이 정합니다. 먼저 Home에서 수동으로 연결해 정상 작동하는지 확인한 다음 Settings에서 On Demand를 열고 화면에 표시되는 조건을 설정하세요. 처음에는 특정 유형의 네트워크로 전환하는 조건 하나만 추가하고 Home으로 돌아왔을 때 연결 상태를 확인하세요. 그다음 해당 네트워크에서 나가거나 원래 네트워크로 돌아올 때의 동작을 테스트하세요.
수동으로 연결을 끊은 뒤 다시 자동 연결된다면 현재 네트워크가 여전히 트리거 조건에 해당하는지 먼저 확인하세요. 자동 연결이 원인인지 확인하려면 On Demand를 잠시 끄고 같은 동작을 다시 테스트하세요. 테스트가 끝나면 필요한 설정을 복원하세요. 수동 연결부터 실패한다면 자동 연결 조건과 라우팅 규칙을 동시에 바꾸지 말고 VPN 구성 권한, 네트워크, 서버를 먼저 점검하세요.
Data: 트래픽 통계 확인
Data에서 클라이언트가 기록한 업로드와 다운로드 트래픽을 확인할 수 있습니다. 서버별 또는 앱별 보기 기능이 있다면 먼저 현재 보기와 통계 범위를 확인한 뒤 수치를 해석하세요. 서버별 보기는 해당 서버에 할당된 트래픽 기록을, 앱별 보기는 현재 화면에서 앱에 귀속되는 기록을 보여줍니다. 두 보기의 분류 기준은 다르므로 한 항목의 수치를 다른 보기의 특정 행과 바로 대응시키면 안 됩니다. 클라이언트에 표시되는 수치는 통신사나 서비스 제공업체의 요금 산정 기준과도 다를 수 있습니다.
특정 접속 문제를 확인할 때는 먼저 작업 전 수치를 기록하고 요청을 다시 보낸 뒤 변화량을 확인하세요. 누적 총량만 보지 마세요. 백그라운드 동기화, 재시도, 리소스 캐시가 결과에 영향을 줄 수 있습니다. 통계를 초기화하려면 비교에 필요한 수치를 먼저 보관하고 현재 작업이 어느 범위까지 지우는지 확인하세요. 통계를 지워도 Global Routing이나 서버 선택은 바뀌지 않으며 서비스 제공업체의 사용량 집계도 초기화되지 않습니다.
Settings: DNS, 테스트, 동기화, 진단
DNS
DNS는 도메인 이름을 주소로 변환합니다. 먼저 Settings에서 DNS 관련 옵션을 확인한 다음 Config에서 별도의 DNS 설정이 적용되어 있는지 살펴보세요. 시스템 기본 DNS가 정상이라면 그대로 두면 됩니다. 사용자 지정 DNS나 DNS over HTTPS를 비교해야 한다면 한 번에 설정 하나만 바꾸고 기존 값을 기록한 뒤 같은 도메인에 다시 요청하세요. 웹사이트가 열리지 않는다고 해서 반드시 DNS 문제인 것은 아닙니다. 도메인이 해석되어도 연결이 성립하지 않을 수 있으므로 라우팅 정책과 프록시 경로도 확인하세요.
Test Method
Test Method는 Connectivity Test의 테스트 방식을 정합니다. Settings에서 테스트 방식을 확인한 뒤 Home으로 돌아가 테스트를 실행하세요. 두 서버를 비교할 때는 테스트 방식, 대상, 네트워크를 가능한 한 동일하게 유지하세요. 방식이나 대상이 달라졌다면 결과 수치를 직접 비교하기 어렵습니다. 테스트 한 번의 성공은 해당 탐색에서 응답을 받았다는 뜻일 뿐, 다른 웹사이트나 프로토콜 또는 장시간 전송도 정상이라는 의미는 아닙니다. 특정 사이트에 문제가 있다면 해당 사이트에 직접 접속해 확인하세요.
Today Widget
Today Widget은 시스템 위젯 관련 설정입니다. Settings에서 사용할 수 있는 옵션을 확인한 다음 기기의 시스템 위젯 화면에 해당 항목이 있는지 살펴보세요. 추가할 수 있다면 Home에 표시된 상태와 위젯에서 사용할 수 있는 동작이 일치하는지 확인하세요. 상태가 바로 갱신되지 않으면 위젯만 보고 연결 여부를 판단하지 말고 Shadowrocket을 열어 실제 연결 상태를 확인하세요.
iCloud 동기화
Settings에서 iCloud 동기화 옵션을 확인하고 시스템에서 Shadowrocket의 iCloud 사용이 허용되어 있는지, 두 기기가 같은 iCloud 계정을 사용하는지 점검하세요. 동기화를 켜기 전에 중요한 구성의 로컬 복사본을 보관하세요. 켠 뒤에는 다른 기기에서 실제로 나타난 항목, 선택한 서버, 활성화된 구성을 확인하세요. 정보 동기화와 시스템 VPN 권한은 별개입니다. 다른 기기에 구성이 표시되더라도 해당 기기에서 연결 권한과 테스트 결과를 따로 확인해야 합니다.
Diagnostics
Diagnostics는 현재 문제를 점검하기 위한 정보를 수집합니다. Settings에서 Diagnostics를 열기 전에 문제가 발생한 네트워크, Global Routing 모드, 재현 여부를 기록하세요. 그런 다음 한 번 더 테스트해 결과와 증상을 비교하세요. 진단 정보를 공유해야 한다면 구독 주소, 서버 인증 정보, 공개해서는 안 되는 접속 기록을 먼저 제거하세요. 증상별로 계속 확인하려면 문제 해결 가이드를 참조하세요.