공식 매뉴얼 · 설정

Shadowrocket
기능 및 주요 설정

먼저 요청이 어떤 경로로 처리되는지와 연결이 언제 시작되는지 구분한 다음, 서버, DNS, 통계를 확인합니다. 한 번에 한 종류의 설정만 변경하고 되돌릴 수 있도록 기존 설정을 보관하세요.

  • Config / Proxy / Direct
  • On Demand
  • Data
  • Settings
01 · 요청 경로

Global Routing: Config, Proxy, Direct

Global Routing은 요청에 적용할 라우팅 방식을 결정하며, 서버의 유효 여부를 확인하는 기능은 아닙니다. Home → Global Routing에서 Config, Proxy 또는 Direct를 선택한 다음 Home으로 돌아와 연결 상태를 확인하세요.

모드 요청 처리 방식 사용 시점 우선 확인 항목
Config 현재 활성화된 구성의 규칙과 정책에 따라 경로를 결정합니다. 일상적인 사용에서 도메인, 주소 또는 기타 조건에 따라 트래픽을 분기할 때 구성이 활성화되어 있는지, 규칙 순서와 최종 정책은 올바른지
Proxy 일반적으로 요청을 현재 선택한 프록시 서버로 전달합니다. 다만 시스템과 앱이 처리하는 범위는 별도로 확인해야 합니다. 서버 연결을 임시로 확인하거나 트래픽 분기 규칙을 비교할 때 서버 매개변수, 선택한 서버, 네트워크 연결 가능 여부
Direct 요청을 선택한 프록시 서버를 거치지 않고 현재 네트워크에서 대상에 직접 접속합니다. 현재 네트워크의 접속 기준을 확인하거나 Direct 연결 결과를 임시로 점검할 때 현재 네트워크에서 대상에 접속할 수 있는지, DNS가 정상인지

선택 방법: 평소에는 Config, 문제 해결에는 비교 테스트

기존 구성이 준비되어 있다면 먼저 Config를 선택하고 Config 페이지에서 실제로 활성화된 파일을 확인하세요. 서버를 확인해야 할 때는 Proxy로 잠시 전환해 같은 대상을 다시 테스트할 수 있습니다. Proxy에서는 연결되지만 Config에서는 연결되지 않는다면, 서버 매개변수를 바로 변경하기보다 규칙의 매칭 결과와 정책 대상부터 확인하세요. 테스트를 마친 뒤에는 평소 사용하는 모드로 되돌려 임시 문제 해결 설정을 계속 사용하지 않도록 합니다.

Direct는 연결을 끄는 것과 같은 의미가 아닙니다. 클라이언트가 시스템 VPN 구성을 연결된 상태로 유지하면서 요청은 Direct 경로로 처리할 수 있습니다. 현재 연결을 완전히 중단하려면 Home으로 돌아가 연결 스위치를 끄세요. 이후 On Demand가 다시 연결을 시작한다면 해당 조건도 확인해야 합니다. 모드, 연결 상태, 트리거 조건은 서로 다른 항목이므로 상태 막대 아이콘만 보고 요청이 반드시 프록시를 거친다고 판단할 수 없습니다.

02 · 매칭 조건

규칙 분기: 조건 매칭과 정책 적용

규칙은 요청별로 적용할 정책을 결정하며, Config에서 현재 활성화된 구성에 설정합니다.일반적으로 각 규칙은 규칙 유형, 매칭 값, 정책으로 구성됩니다. 자주 쓰이는 정책에는 DIRECT, PROXY, REJECT가 있으며, 구성에 정의된 정책 그룹을 지정할 수도 있습니다. 정책 그룹 이름은 프로토콜명이 아니므로 규칙에 사용하기 전에 해당 대상이 실제로 존재하는지 확인하세요.

DOMAIN은 전체 도메인, DOMAIN-SUFFIX는 도메인 접미사, DOMAIN-KEYWORD는 도메인에 포함된 키워드를 기준으로 매칭합니다. IP-CIDR과 IP-CIDR6은 각각 IP 주소 범위를 지정하며, GEOIP는 IP 주소의 지역 정보에 따라 매칭합니다. USER-AGENT는 클라이언트가 해당 요청 정보를 가져올 수 있어야 하며 모든 트래픽에 적용되는 것은 아닙니다. 범용 앱 식별 방식으로 간주해서는 안 됩니다.

설정 방법: 구체적인 조건을 먼저 두고 FINAL을 확인

구성의 규칙은 일반적으로 위에서 아래 순서로 매칭되며, 먼저 일치한 규칙이 처리 방식을 결정합니다. 특정 도메인에 대한 규칙을 추가할 때는 그보다 앞에 더 넓은 조건이 있는지 확인하세요. FINAL은 앞선 규칙에 일치하지 않는 요청을 처리하며, 보통 규칙 목록의 마지막에 둡니다. 편집 전에 사본을 저장하고, 활성화한 뒤 명확한 대상 하나에만 접속해 연결 기록으로 결과를 확인하세요.

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

위 예시는 문법 설명용이며 완전한 구성을 대체해 바로 사용할 수 있는 파일이 아닙니다. 첫 번째 규칙은 도메인 접미사에 따라 PROXY를 적용하고, 두 번째 규칙은 지정한 사설 IP 범위에 DIRECT를 적용하며, 마지막 규칙은 나머지 요청을 처리합니다. 실제 LAN 접속에는 시스템 라우팅, 네트워크 권한, 구성 옵션도 영향을 줄 수 있습니다. 규칙 결과가 예상과 다르면 먼저 매칭 기록을 확인한 다음, DNS 확인 단계나 주소 매칭 조건의 영향인지 살펴보세요.

구성 파일을 업데이트하면 규칙 내용도 달라질 수 있습니다. 원격 구성 업데이트 후 동작이 바뀌었다면 파일명만 보지 말고 업데이트 전후의 규칙 순서, 정책 이름, DNS 설정을 비교하세요. 필드와 프로토콜 매개변수는 프로토콜 참고 자료에서 확인할 수 있습니다. 처음 연결을 설정한다면 사용 안내를 따라 단계별로 진행하세요.

03 · 연결 정보

Subscribe와 SERVER: 업데이트 출처와 현재 선택 확인

서버는 개별 연결 정보이고, 구독은 해당 정보를 업데이트하는 출처입니다.이 절은 사용자가 이미 본인 구독 또는 서버 정보를 가지고 있다는 전제로 설명합니다. Home의 SERVER 목록에서 서버를 확인하세요. 직접 입력하려면 Add Server로 이동해 Type을 선택한 다음 서비스 제공자가 안내한 주소, 포트, 인증 및 전송 매개변수를 입력합니다. 기존 구독을 가져오려면 Add Server에서 Subscribe를 선택하고 본인의 구독 주소를 입력해 저장한 뒤 목록이 불러와질 때까지 기다리세요.

설정 방법: 유형을 확인한 다음 매개변수 점검

Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2는 필요한 필드가 서로 다릅니다. 주소와 포트만 입력했다고 구성이 완성된 것은 아닙니다. 인증 방식, TLS, 서버 이름, 전송 설정도 확인하세요. QR Code나 공유 링크가 있다면 해당 가져오기 메뉴를 사용할 수 있지만, 가져온 후 Type과 주요 필드가 원본 정보와 일치하는지 다시 확인해야 합니다.

구독 업데이트에 성공했다는 것은 정보가 가져와져 파싱되었다는 뜻일 뿐, 목록에 있는 모든 서버에 현재 연결할 수 있다는 의미는 아닙니다. 업데이트 후 SERVER로 돌아가 항목 수와 이름, 현재 선택된 항목을 확인한 다음 Connectivity Test와 실제 접속 테스트를 진행하세요. 예상한 항목이 보이지 않으면 구독 주소가 완전하고 유효한지, 현재 네트워크에서 해당 주소에 접속할 수 있는지 먼저 확인하세요. 출처를 확인하는 대신 Global Routing을 반복해서 변경하지 마세요.

주의 사항: 구독과 Config를 혼동하지 않기

Subscribe는 주로 서버 정보를 관리하며, Config에는 라우팅, DNS 및 기타 동작 설정도 포함될 수 있습니다. 링크 모양만 보고 두 기능을 서로 대체할 수는 없습니다. 구독을 업데이트하면 구독이 관리하는 항목이 덮어써질 수 있으므로 직접 수정하기 전에 변경 내용을 기록해 두세요. 구독이나 서버를 삭제하기 전에는 현재 구성의 정책에서 해당 항목을 참조하는지 확인해야 합니다. 이름은 남아 있어도 실제 연결 대상이 더 이상 유효하지 않을 수 있습니다.

구독 주소와 공유 링크에는 접근 인증 정보가 포함될 수 있으므로 문제 해결 중 전체 내용을 공개하지 마세요. 앱은 일회성 구매이며, 회선 요금제와는 별개입니다. Shadowrocket 구매 내역과 사용자가 이미 보유한 연결 정보도 각각 따로 관리됩니다. 이 사이트는 서버나 구독을 제공·판매·추천하지 않습니다. 앱을 받을 수 있는 유일한 경로는 App Store입니다. 구매 전에 정품 확인 안내를 참고하세요.

04 · 연결 트리거

On Demand: 조건에 따른 연결, 규칙 분기와는 별개

On Demand는 조건이 충족될 때 시스템 VPN 연결을 시작하고, Global Routing은 연결 후 요청이 사용할 경로를 결정합니다.Settings → On Demand에서 전체 스위치와 설정된 조건을 확인하세요. 기기마다 표시되는 선택 항목은 현재 앱 화면을 기준으로 합니다. 먼저 Home에서 수동으로 연결해 구성이 정상 작동하는지 확인한 다음 On Demand를 활성화하면 서버 문제를 자동 연결 조건 문제로 오해하지 않을 수 있습니다.

설정 방법: 한 가지 상황부터 시작

자동 연결이 필요한 네트워크 상황을 먼저 정한 다음 해당 조건을 설정하세요. 서로 겹치는 조건을 한꺼번에 여러 개 추가하지 마세요. 저장 후 관련 네트워크로 한 번 전환하고 Home에서 연결 상태를 확인한 뒤 고정된 대상에 접속해 보세요. 테스트에 사용한 Wi-Fi 또는 셀룰러 네트워크, Global Routing 모드, 서버를 기록해 두면 자동 연결 트리거와 요청 분기가 각각 예상대로 작동하는지 판단할 수 있습니다.

수동으로 연결을 끈 뒤 다시 연결된다면 On Demand의 트리거 조건이 충족되었는지 먼저 확인하세요. 스위치 조작이 실패했다는 뜻은 아닐 수 있습니다. 자동 연결을 잠시 중지하려면 On Demand 설정을 먼저 조정한 다음 Home에서 연결을 끄세요. 네트워크가 바뀔 때 연결이 복구되는 시점은 시스템 스케줄링, 네트워크 품질, 서버 상태에 따라 달라집니다. 이 기능을 켜도 연결이 항상 유지되는 것은 아니며, 모든 백그라운드 요청이 즉시 완료되는 것도 아닙니다.

05 · 사용 기록

Data: 통계 범위를 확인하고 트래픽 변화를 해석

Data는 클라이언트에 기록된 트래픽과 관련 통계를 확인하는 기능이며, 서비스 제공자의 계정 과금 내역은 아닙니다.Data에 들어가면 먼저 현재 화면에 표시된 통계 범위, 시간 범위, 분류를 확인한 다음 업로드와 다운로드를 비교하세요. 초기화 기능이 있다면 초기화 전에 현재 수치를 기록해 초기화 후 값과 누적 기록을 혼동하지 않도록 합니다.

사용 방법: 같은 시간 범위끼리 비교

트래픽 증가를 확인할 때는 먼저 대용량 파일 전송과 백그라운드 동기화를 중지하고 기준값을 기록한 다음, 명확한 작업을 한 번 수행해 변화를 살펴보세요. 특정 요청이 Direct로 처리되는지 확인하려면 Global Routing, 규칙 매칭, 연결 기록을 함께 확인해야 합니다. 전체 트래픽이 늘었다는 사실만으로 결론을 내릴 수 없습니다. 특정 분류가 통계에 포함되는지와 각 항목의 의미는 Data 화면에 표시된 설명을 기준으로 확인하세요.

클라이언트, 시스템 네트워크 통계, 서비스 제공자 통계는 측정 시간, 프로토콜 오버헤드, 계산 기준이 서로 달라 수치가 다를 수 있습니다. 차이가 있다고 해서 곧바로 이상이 있는 것은 아닙니다. Data에서는 구독 만료일이나 잔여 사용량도 확인할 수 없습니다. 해당 정보는 사용자가 기존에 이용 중인 서비스의 계정 내역에서 확인하세요. 트래픽이 비정상적으로 증가했다면 테스트 전후의 활동과 요청을 살펴보고 백그라운드 다운로드 및 동기화 작업을 하나씩 제외해 보세요.

06 · 일상 설정

Settings: DNS, 테스트 방식, 위젯 및 동기화

각 설정은 서로 다른 문제를 다룹니다. 변경 전에 기존 값을 기록하고 한 번에 하나씩만 수정하세요. 메뉴 위치와 사용할 수 있는 옵션은 현재 앱 화면을 기준으로 확인합니다.

DNS

요청 경로와 함께 확인하는 DNS 설정

DNS는 도메인을 IP 주소로 변환합니다. 웹페이지가 열리지 않을 때는 DNS 조회 실패와 서버 연결 실패를 구분해 확인하세요. 먼저 현재 Config에서 적용 중인 DNS 관련 설정을 확인하고 Settings의 관련 옵션도 점검합니다. 구성 파일과 앱 설정이 함께 DNS 동작에 영향을 줄 수 있으므로 한 곳만 바꾼 뒤 모든 요청이 같은 경로로 DNS를 조회한다고 단정해서는 안 됩니다.

설정을 조정하기 전에 기존 값을 저장한 다음 고정된 도메인에 접속하고 Diagnostics 또는 연결 기록에서 결과를 확인하세요. DNS 매개변수는 한 번에 하나만 바꿔 다시 테스트하고, 모드와 서버까지 동시에 변경하지 마세요. DNS 조회에 성공해도 이후 연결까지 성공한다는 뜻은 아닙니다. 대상 주소에 접속할 수 있는지, 규칙 정책이 올바른지, 서버 이름과 TLS 매개변수가 일치하는지도 확인해야 합니다.

Test Method

테스트 방식이 다르면 결과를 직접 비교할 수 없습니다

Test Method는 Connectivity Test에서 사용할 검사 방식을 결정합니다. Settings → Test Method에서 현재 화면에 제공되는 방식을 선택한 다음 Home으로 돌아가 Connectivity Test를 실행하세요. 테스트 대상을 설정할 수 있다면 해당 대상에 안정적으로 접속할 수 있는지 먼저 확인하고, 선택한 방식과 네트워크 환경을 기록하세요.

테스트 성공은 해당 검사 조건에서 응답을 받았다는 뜻이지, 모든 웹사이트나 앱 요청이 정상이라는 뜻은 아닙니다. 서버를 비교할 때는 테스트 방식, 대상, 네트워크를 동일하게 유지한 뒤 실제 접속도 확인하세요. 특정 방식에서는 실패하지만 실제 접속이 된다면 테스트 대상과 검사 방식을 우선 확인하고, 한 번의 결과만으로 서버 정보를 삭제하지 마세요.

Today Widget

위젯은 실시간 상태 화면이 아닙니다

Today Widget은 시스템 위젯에 표시할 빠른 정보나 동작을 설정하는 기능입니다. Settings에서 Today Widget 관련 옵션을 확인한 다음 시스템의 위젯 편집 화면에서 현재 기기에서 지원하는 항목을 추가하세요. 표시할 수 있는 내용과 위치는 앱과 시스템에서 현재 제공하는 화면을 기준으로 합니다.

먼저 Home에서 서버를 선택하고 연결을 확인한 뒤 위젯을 빠른 실행 메뉴로 사용하세요. 시스템이 위젯 새로고침 빈도를 제한할 수 있습니다. 오래된 상태가 표시되면 앱을 열어 확인하고, 새로고침을 강제로 실행하려고 연달아 눌러 전환하지 마세요. 위젯은 Config를 대체하지 않으며 현재 요청이 어떤 규칙과 일치했는지도 단독으로 확인할 수 없습니다.

iCloud

동기화 범위를 확인하고 변경 전 사본 보관

iCloud 관련 기능은 지원되는 기기와 계정 환경에서 앱이 제공하는 정보를 저장하거나 동기화합니다. 먼저 시스템 iCloud의 여유 공간과 앱 접근 권한을 확인한 다음 Settings의 iCloud 관련 옵션을 살펴보세요. 어떤 정보가 동기화되는지는 현재 화면의 안내에 따라 항목별로 확인해야 합니다.

동기화가 모든 구성을 자동으로 복원해 준다고 보장할 수는 없습니다. 중요한 변경 전에는 되돌릴 수 있는 사본을 별도로 저장하고, 새 기기에서 사용하기 전에 Config, 서버 목록, 연결 결과를 항목별로 확인하세요. 동기화되는 정보에 연결 인증 정보가 포함될 수 있으므로 계정 접근과 기기 잠금을 안전하게 관리하세요. 앱 구매 내역은 App Store에서 관리하며 iCloud의 구성 정보와는 별개입니다.

07 · 문제 해결

Diagnostics: 현상을 기록한 다음 설정 변경

Diagnostics는 실행 정보와 진단 단서를 확인하는 메뉴이며 자동 복구 기능이 아닙니다.Settings에서 Diagnostics로 이동해 현재 제공되는 진단 항목을 확인하세요. Home의 연결 상태, Connectivity Test, 관련 기록을 함께 살펴보면 서버 연결, 도메인 조회, 규칙 매칭, 대상 접속 문제를 구분할 수 있습니다. 진단 항목마다 확인할 수 있는 내용이 다르므로 하나의 항목이 통과했다고 전체 검증을 마친 것으로 판단하지 마세요.

확인 방법: 반복할 수 있는 최소 테스트

  1. 현재 네트워크, 선택한 서버, Global Routing 모드, 활성화된 Config를 기록합니다.
  2. 명확한 접속 대상 하나를 정해 테스트를 한 번 실행하고 오류 현상과 관련 기록을 보관합니다.
  3. 예를 들어 Config에서 Proxy로 잠시 전환한 뒤 같은 대상에 접속하는 등 변수를 하나만 변경합니다.
  4. 진단 기록을 비교해 달라진 점을 확인하고, 완료 후 원래 모드로 복원합니다. 필요하면 방금 변경한 설정도 되돌립니다.

같은 서버에서 여러 대상에 모두 접속하지 못한다면 주소, 포트, 인증 정보, 서비스 유효 상태를 먼저 확인하세요. Config 모드에서만 실패한다면 규칙과 정책을 우선 살펴보세요. 도메인 조회에 실패하면 DNS를 별도로 점검합니다. 현재 네트워크의 기본 접속도 불안정하다면 클라이언트 문제를 계속 확인하기 전에 네트워크부터 해결하세요.

설정은 많을수록 좋은 것이 아닙니다. 네트워크와 대상은 고정하고 설정 하나만 변경해 문제를 재현하면 원인을 더 쉽게 찾을 수 있습니다. 그래도 접속할 수 없다면 연결 스위치는 켜져 있지만 인터넷에 접속되지 않을 때 확인할 항목을 참고해 서버, 모드, DNS, 규칙 순서로 점검하세요.

설정 관련 자주 묻는 질문

Direct를 선택했는데 시스템에 VPN 상태가 계속 표시되는 이유는 무엇인가요?

Direct는 Global Routing에서 요청 경로를 선택하는 옵션이며 연결을 끄는 기능은 아닙니다. 현재 연결을 중단하려면 Home에서 스위치를 끄고 On Demand가 다시 연결을 시작하는지도 확인하세요. 프록시를 거쳤는지 판단하려면 모드, 규칙, 연결 기록을 확인해야 합니다. 상태 막대만 보고 판단할 수는 없습니다.

규칙을 변경했는데 적용되지 않으면 무엇부터 확인해야 하나요?

먼저 Global Routing이 Config인지 확인하고 수정한 구성이 현재 활성화된 구성인지 살펴보세요. 다음으로 규칙 순서, 앞에 더 넓은 조건이 있는지, 정책 대상이 유효한지, FINAL이 어떻게 설정되어 있는지 확인합니다. 필요하다면 테스트 연결을 새로 만들어 변경 전에 연결된 기존 요청을 계속 관찰하지 않도록 하세요.

구독 업데이트는 성공했는데 Connectivity Test가 계속 실패하는 이유는 무엇인가요?

구독 가져오기와 서버 연결은 서로 다른 단계입니다. 먼저 현재 선택한 서버의 매개변수와 유효 상태를 확인한 다음 Test Method, 테스트 대상, 현재 네트워크를 점검하세요. 마지막으로 실제 접속 테스트를 실행해 검사 조건에 제한이 있는지 연결 자체에 문제가 있는지 판단합니다.

기기를 바꾸면 구매 내역과 구성이 함께 복원되나요?

구매 내역과 구성 정보는 각각 별도로 관리됩니다. 먼저 App Store에서 기존 구매 내역을 확인한 다음 실제로 사용 중인 동기화 또는 백업 방식에 따라 정보를 복원하세요. 통합 구매 적용 여부와 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 복원한 뒤에는 서버, Config, On Demand 조건도 확인해야 합니다.

App Store에서 다운로드