공식 안내 · 기능 및 설정

Shadowrocket
기능 및 주요 설정

Global Routing에서 트래픽 처리 방식을 확인한 다음 규칙, 서버 및 연결 조건을 점검합니다. 이 안내는 iPhone 또는 iPad에서 이미 보유한 구독 정보나 서버 정보를 사용하는 경우를 전제로 합니다. 용도, 위치, 설정 방법과 주의사항 순서로 설명합니다.

  • Config / Proxy / Direct
  • 규칙과 정책
  • On Demand
  • DNS 및 진단
App Store에서 다운로드 초기 설정 단계 보기

Shadowrocket은 Apple 플랫폼용 유료 상용 앱이며, App Store에서만 받을 수 있습니다. 시스템 요구 사항은 App Store 페이지를 확인하세요.

트래픽 처리 설정

Global Routing: Config, Proxy, Direct

무엇인가요: Global Routing은 클라이언트가 연결 경로를 선택하는 방식을 결정합니다. Config, Proxy, Direct는 각각 화면의 Config, Proxy, Direct에 해당합니다. 이는 라우팅 방식이며 서버를 구분하거나 서버에서 사용하는 프로토콜을 나타내는 항목이 아닙니다.

위치: Home에서 Global Routing을 열어 현재 선택된 항목을 확인합니다. 여기서 Config는 라우팅 모드이며, 하단의 같은 이름인 Config 페이지는 구성 파일을 관리하는 곳입니다. 서로 관련은 있지만 진입 위치는 다릅니다.

먼저 목적에 맞는 모드를 선택한 다음 연결 결과를 확인하세요.
화면 항목 처리 방식 사용 예 확인할 사항
Config
구성		 현재 적용된 구성의 규칙에 따라 정책을 선택합니다. 도메인, 주소 또는 지역 조건에 따라 평소 트래픽을 분류할 때 사용합니다. 선택된 구성 파일과 규칙 순서를 확인하세요.
Proxy
프록시		 트래픽을 프록시 모드로 처리하도록 선택한 프록시에 전달합니다. 규칙 라우팅과 프록시 연결 결과를 일시적으로 비교할 때 사용합니다. 현재 서버에 연결할 수 있는지 확인하세요. 이 결과만으로 각 규칙이 올바른지는 판단할 수 없습니다.
Direct
직접 연결		 트래픽을 직접 연결로 처리합니다. 현재 네트워크에서 직접 접속한 결과와 비교할 때 사용합니다. 직접 연결 결과는 프록시 서버의 연결 상태를 나타내지 않습니다.

설정 방법: 완성된 라우팅 구성이 있다면 먼저 Config 페이지에서 사용할 파일을 확인한 다음 Global Routing을 Config로 설정합니다. 문제를 확인하려면 Proxy 또는 Direct로 잠시 전환해 같은 대상으로 비교 테스트할 수 있습니다. 테스트가 끝나면 원래 설정으로 되돌리세요.

주의사항: 모드를 바꾸면 라우팅 처리 방식만 달라지며 서버 주소, 인증 정보 또는 DNS 매개변수가 추가되지는 않습니다. 어떤 사이트가 Proxy에서는 열리지만 Config에서는 열리지 않는다면, 모든 서버를 다시 가져오기보다 규칙 일치 여부와 적용 정책을 확인하세요. Direct 모드로 바꿔도 시스템의 VPN 구성이 해제되는 것은 아닙니다. 연결을 끊으려면 Home의 연결 스위치를 확인하세요.

구성 파일 및 규칙 일치 방식

규칙 라우팅: 일치 조건과 처리 정책

무엇인가요: 규칙은 일치 유형, 조건 및 정책으로 구성됩니다. 일치 조건은 요청이 어떤 유형인지 판단하고, 정책은 조건에 맞은 요청을 어떻게 처리할지 결정합니다. PROXY는 프록시를 통해 처리하고, DIRECT는 직접 연결하며, REJECT는 요청을 거부합니다. 구성에서 사용자 지정 정책 이름을 참조하는 경우 해당 정책의 정의도 확인해야 합니다.

위치: Config 페이지에서 현재 구성 파일을 확인한 다음 규칙 편집 화면이나 파일의 [Rule] 섹션에서 규칙을 살펴봅니다. 이 규칙을 라우팅에 적용하려면 Global Routing을 Config로 설정해야 합니다.

DOMAIN MATCH

도메인 조건

DOMAIN은 전체 도메인과 일치합니다. DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인에 일치합니다. DOMAIN-KEYWORD는 도메인에 지정한 문자열이 포함되어 있는지 확인합니다. 뒤의 두 규칙은 적용 범위가 다르므로 이름이 비슷하다는 이유만으로 서로 바꾸어 사용하지 마세요.

ADDRESS MATCH

주소 조건

IP-CIDR과 IP-CIDR6은 각각 IPv4 및 IPv6 주소 대역을 지정합니다. GEOIP는 주소의 지역 데이터에 따라 일치 여부를 판단합니다. 도메인 요청이 주소 조건에 적용되는지는 DNS 조회 결과와 구성 옵션에도 영향을 받습니다.

설정 방법: 먼저 현재 파일을 백업한 다음 대상에 맞는 범위가 명확한 규칙을 추가하세요. 구체적인 조건을 넓은 조건보다 앞에 두고, 앞선 규칙에 처리되지 않은 요청의 경로는 마지막에 FINAL로 지정합니다. 아래의 example.com은 문법을 보여 주기 위한 예시이며 연결 서비스를 의미하지 않습니다.

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

주의사항: 규칙은 위에서 아래 순서로 확인하며, 일치하면 일반적으로 이후 규칙은 더 이상 검사하지 않습니다. 적용 범위가 넓은 조건을 앞에 두면 뒤에 있는 구체적인 규칙이 적용되지 않을 수 있습니다. FINAL은 기본 처리 규칙이지, 모든 경로를 다시 시도하는 항목이 아닙니다. 수정 후 파일이 저장되었는지, 해당 구성이 선택되었는지 확인하고 실제 요청으로 결과를 점검하세요. 일치 범위에 관한 자세한 설명은 규칙 키워드와 일치 순서를 참고하세요.

연결 정보 관리

구독 및 서버: 추가, 업데이트, 선택

무엇인가요: 개별 서버 항목에는 주소, 포트, 프로토콜 및 인증 정보 등의 연결 매개변수가 저장됩니다. 구독은 여러 서버 항목을 불러오고 업데이트하는 데 사용됩니다. 구독 관리와 규칙 구성은 별개이므로 서버를 가져왔다고 해서 규칙 라우팅까지 설정된 것은 아닙니다.

위치: Home의 SERVER 영역에서 기존 서버를 확인하고 선택할 수 있습니다. 정보를 직접 입력하려면 Add Server를 사용하고, 기존 구독을 가져오려면 추가 메뉴에서 Subscribe를 선택합니다. 보유한 QR 코드는 Scan QR Code로 읽을 수 있습니다. 가져오기 전에 구성 정보가 본인이 이미 보유한 출처에서 온 것인지 확인하세요.

설정 방법: 서버를 직접 추가할 때는 서버 측과 동일한 프로토콜을 선택하고 주소, 포트, 인증 정보를 차례로 입력합니다. TLS, 전송 방식 또는 기타 추가 매개변수는 보유한 서버 정보에 맞게 설정하세요. 값을 추측해 가며 반복적으로 테스트하지 마세요. 구독을 가져온 뒤에는 예상한 그룹이 표시되는지 확인하고, 서버 하나를 선택해 테스트한 후 연결을 켜세요.

구독을 업데이트하기 전에 구독으로 관리되는 항목과 직접 추가한 항목을 구분하세요. 구독에서 생성된 항목은 업데이트 과정에서 교체되거나 삭제될 수 있으므로 직접 수정하기 전에 필요한 정보를 보관하세요. 구독 이름이 같더라도 포함된 서버의 프로토콜이나 매개변수가 모두 동일한 것은 아닙니다.

주의사항: 구독 URL에는 접근 자격 증명이 포함될 수 있으므로 공개 스크린샷이나 게시물, 진단 메시지에 붙여 넣지 마세요. 가져오기에 실패하면 먼저 링크가 완전한지, 불필요한 공백이 포함되어 있지 않은지 확인한 다음 현재 네트워크에서 내용을 불러올 수 있는지 점검하세요. 가져오기에 성공했다는 것은 클라이언트가 서버 항목을 읽었다는 뜻일 뿐, 모든 서버에 연결할 수 있다는 의미는 아닙니다.

클라이언트 일회성 구매 ≠ 연결 서비스 요금제. Shadowrocket을 구매하면 클라이언트 사용 권한을 얻으며 연결 서비스는 포함되지 않습니다. 이 사이트는 노드나 구독을 제공하거나 판매 또는 추천하지 않습니다. 안내 내용은 사용자가 이미 보유한 구독 또는 서버 정보를 사용하는 것을 전제로 합니다.

프로토콜 항목을 알아보려면 프로토콜 참고를, 처음 추가하고 연결하는 전체 단계는 사용 안내를 확인하세요.

연결 실행 조건

On Demand: 조건에 따른 연결

무엇인가요: On Demand는 미리 설정한 조건에 따라 VPN 연결 실행을 관리합니다. 연결 시점을 정하는 기능이며, 연결 후의 라우팅 방식은 Global Routing과 구성 규칙에서 정합니다. On Demand를 켜도 라우팅 설정이 자동으로 수정되지는 않습니다.

위치: Settings에서 On Demand를 열어 설정 가능한 조건을 확인하세요. 실제로 사용할 수 있는 조건과 표시 위치는 앱 내 화면을 기준으로 확인해야 합니다. 설정 과정에서 시스템의 VPN 구성 상태도 확인해야 할 수 있습니다.

설정 방법: 먼저 자동 연결의 영향을 끄고 수동으로 연결해 사이트에 접속되는지 확인합니다. 서버와 구성이 모두 정상적으로 작동하는 것을 확인한 뒤 필요한 네트워크 조건을 설정하고, 한 번에 하나씩만 변경하세요. 대상 네트워크로 전환한 후 시스템 VPN 상태, Home의 연결 상태와 실제 접속 결과를 각각 확인해 의도한 대로 작동하는지 점검합니다.

주의사항: On Demand는 서버 장애를 복구하는 기능이 아니며 네트워크 전환 시 기존 세션이 모두 유지된다고 보장하지 않습니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 스위치를 반복해서 조작하기보다 On Demand 조건과 시스템 VPN 설정을 먼저 확인하세요. 연결 문제를 진단할 때는 기존 조건을 기록하고 자동 연결을 잠시 해제한 뒤 수동 테스트를 마치고 원래 설정을 복원합니다.

사용 기록 및 통계 범위

Data: 트래픽 확인과 통계 해석

무엇인가요: Data에는 클라이언트가 기록한 트래픽 사용량이 표시되며, 일정 시간 동안 업로드와 다운로드가 어떻게 변했는지 확인할 수 있습니다. 문제를 파악하는 참고 정보일 뿐, 대역폭 테스트나 서버 측 과금 내역은 아닙니다.

위치: 하단의 Data 페이지에서 현재 표시 중인 통계 항목과 시간 범위를 먼저 확인한 다음 수치를 살펴보세요. 집계 기준이나 시간대, 기기가 다른 결과를 그대로 합산하거나 비교하지 마세요.

설정 방법: 특정 작업을 관찰하려면 현재 통계와 시간을 먼저 기록하고, 반복 가능한 방식으로 접속한 뒤 Data로 돌아와 변화를 비교하세요. 페이지에 통계를 지우는 기능이 있다면 필요한 기록을 먼저 저장하세요. 통계 삭제를 서버 상태 새로고침으로 오해하지 마세요.

주의사항: 백그라운드 앱, 시스템 요청 및 연결 재시도도 트래픽을 발생시킬 수 있습니다. 클라이언트와 서버의 통계는 집계 범위, 시작 및 종료 시각, 프로토콜 오버헤드 계산 방식이 다를 수 있습니다. 따라서 수치가 서로 다르다고 해서 어느 한쪽에 문제가 있다고 단정할 수는 없습니다. 규칙이 일치했는지 확인하려면 연결 기록과 대상 요청을 함께 살펴보고, 트래픽 증가만으로 라우팅 정책을 추측하지 마세요.

Settings 주요 항목

DNS, 테스트 방식, 빠른 실행 및 동기화

Settings에는 앱 설정과 관련 도구가 모여 있습니다. 일부 동작은 현재 구성 파일에 따라 달라질 수 있으므로 변경하기 전에 앱 설정과 파일 매개변수를 구분하세요. 아래 항목은 앱에서 실제로 표시되는 옵션을 기준으로 하며, 모두 한꺼번에 활성화할 필요는 없습니다.

DNS: 도메인 조회와 라우팅

무엇이며 어디에 있나요: DNS는 도메인을 주소로 변환합니다. 관련 옵션은 Settings의 DNS에서 확인할 수 있으며, 현재 구성 파일의 [General] 섹션에도 DNS 매개변수가 들어 있을 수 있습니다. 설정을 열기 전에 사용 중인 구성 파일을 기록해 파일 설정이 조회 동작에 미치는 영향을 놓치지 않도록 하세요.

설정 및 주의사항: 보유한 네트워크 및 구성 요구 사항에 맞게 조회 매개변수를 입력하고, 한 번에 하나씩만 변경한 뒤 같은 도메인으로 다시 테스트하세요. 서버 테스트에 성공했는데 웹페이지가 열리지 않는 경우에도 DNS 조회 실패, 적절하지 않은 조회 결과 또는 이후 연결 실패가 원인일 수 있습니다. 한 번의 테스트 수치만 보고 모든 DNS 설정을 바꾸지 마세요. 문제가 조회 단계인지 연결 단계인지 먼저 확인하고, 자세한 내용은 DNS 조회 실패 문제 해결을 참고하세요.

Test Method: 테스트 항목 확인

무엇이며 어디에 있나요: Test Method는 연결 테스트에 사용할 방식을 선택하는 항목이며 Settings에서 확인할 수 있습니다. Home의 Connectivity Test를 사용하면 테스트를 실행합니다. 테스트 방식에 따라 확인되는 연결 단계가 다를 수 있습니다.

설정 및 주의사항: 서버를 비교할 때는 테스트 방식, 대상 및 현재 네트워크를 고정하고 결과를 반복해서 확인하세요. 방식이 다른 테스트의 수치를 한데 모아 같은 기준으로 판단하지 마세요. 테스트 성공이 모든 사이트에 접속할 수 있다는 뜻은 아니며, 테스트 시간은 실제 다운로드 속도와도 다릅니다. 테스트만 실패하고 실제 접속은 정상이라면 테스트 대상과 방식을 먼저 확인하세요.

Today Widget: 빠른 실행

무엇이며 어디에 있나요: Today Widget에서는 관련 정보를 빠르게 보거나 작업을 설정할 수 있습니다. Settings에서 해당 옵션을 확인하세요. 시스템의 해당 위치에 위젯을 추가할 수 있는지는 기기에서 제공하는 위젯 추가 화면을 기준으로 확인해야 합니다.

설정 및 주의사항: 먼저 앱에서 서버를 선택하고 연결이 정상인지 확인한 다음 시스템에서 제공하는 위젯 편집 방법에 따라 추가하세요. 빠른 실행을 사용한 뒤에는 Home에서 실제 상태를 확인합니다. 위젯 표시가 갱신되기까지 시간이 걸릴 수 있으므로 특정 시점의 문구만으로 연결 상태를 모두 판단하지 마세요. 위젯이 아직 가져오지 않은 서버 정보를 대신 추가해 주지는 않습니다.

iCloud: 동기화 대상 및 덮어쓰기 방향 확인

무엇이며 어디에 있나요: iCloud 관련 기능은 앱에서 지원하는 범위 내에서 데이터를 저장하거나 동기화합니다. Settings에서 관련 항목을 확인하고 시스템에서 Shadowrocket의 iCloud 사용을 허용했는지도 점검하세요. 동기화 기능과 App Store 구매 항목 복원은 서로 다른 방식입니다.

설정 및 주의사항: 먼저 현재 기기의 중요한 구성을 보관한 뒤 동기화 대상과 업로드 또는 복원 작업에 관한 앱 내 안내를 읽으세요. 다른 기기에서 데이터를 불러오기 전에 현재 내용과 수정 시간을 확인해 오래된 데이터가 사용 중인 구성을 덮어쓰지 않도록 주의합니다. 앱 구매 기록만으로 서버 인증 정보가 자동으로 복원되지는 않습니다. 동기화 후에도 선택된 서버, 구성 파일 및 라우팅 모드를 각각 확인하세요.

Diagnostics: 연결 실패 원인 확인

무엇이며 어디에 있나요: Diagnostics는 문제 해결을 위한 도구이며 Settings에서 찾을 수 있습니다. 원인을 파악하는 데 필요한 정보를 제공하지만, 한 가지 결과만으로 모든 연결 단계가 정상이라고 판단할 수는 없습니다.

설정 및 주의사항: 진단을 실행하기 전에 실패한 대상, 현재 네트워크, 라우팅 모드 및 재현 단계를 기록하세요. 이번 실패와 관련된 결과를 저장하고 여러 설정을 변경한 뒤의 무관한 정보가 섞이지 않도록 합니다. 기록을 공유하기 전에는 구독 주소의 접근 자격 증명, 비밀번호, 인증 정보 및 기타 개인정보를 가리세요. 진단 결과는 DNS, 서버 연결 및 규칙 일치 여부와 각각 비교해야 하며, 해당 점검을 대신할 수 없습니다.

설정 변경 전후 점검 목록

한 번에 한 가지 항목만 변경

문제를 해결할 때는 먼저 반복 가능한 기준 상태를 마련하세요. 현재 네트워크, 선택된 서버, 구성 파일과 Global Routing을 기록한 다음 명확한 대상 하나에 접속합니다. 그래야 설정 변경으로 결과가 달라졌는지, 단순한 네트워크 변동인지 구분할 수 있습니다.

  1. 연결 정보가 정확한지 확인하세요. 서버 주소, 포트, 프로토콜 및 인증 정보가 이미 보유한 구성에서 가져온 것인지 확인하고, 입력 누락과 복사 오류를 먼저 점검합니다.
  2. 연결 및 테스트를 확인하세요. 수동으로 연결한 뒤 Connectivity Test를 실행하고 Test Method도 함께 기록하세요. 단일 수치만 따로 보관하지 마세요.
  3. 라우팅 모드를 확인하세요. Config를 사용하는 경우 현재 파일과 규칙을 확인하세요. 비교를 위해 다른 모드를 잠시 사용했다면 원래 설정으로 되돌립니다.
  4. DNS 조회 단계를 확인하세요. 연결은 되었지만 도메인으로 접속할 수 없다면 DNS 결과와 이후 연결을 각각 확인하세요. 모든 실패를 서버 문제로 단정하지 마세요.
  5. 자동 기능을 다시 켜세요. 수동 조작으로 안정적으로 작동하는 것을 확인한 뒤 On Demand와 빠른 실행을 복원하고 네트워크 전환 후 상태를 확인합니다.

구성 파일을 편집하기 전에는 복구할 수 있는 사본을 보관하세요. 구독 업데이트, 구성 수정, DNS 변경 및 네트워크 전환은 가능한 한 따로 진행합니다. 여러 설정을 한꺼번에 바꾸면 접속이 복구되더라도 어떤 변경이 효과가 있었는지 파악하기 어렵습니다.

초기 설정은 사용 안내를 따라 진행하세요. 프로토콜 항목과 선택 방법은 프로토콜 참고를, 구매 및 복원과 App Store 정보를 확인하는 방법은 App Store 정품 확인 안내를 참고하세요. 개발자는 Shadow Launch Technology Limited이며 앱 ID는 932747118입니다.

Shadowrocket App Store 다운로드