RULE-BASED ROUTING · APP STORE

Shadowrocket규칙 라이브러리 및 사용 가이드

iOS / iPadOS용 규칙 기반 프록시 클라이언트로, App Store에서 정품을 한 번 구매하면 됩니다. 이 공식 가이드에서는 기존 구성 가져오기, 규칙 분기 및 연결 확인 방법을 설명합니다.

RuleOn DemandVLESS
default.conf

DOMAIN-SUFFIX,example.com,PROXY

01 / RULE REFERENCE

규칙, 연결 및 구성의 관계

먼저 '어디에 연결할지'와 '어떤 요청이 해당 연결을 사용할지'를 구분하세요. 서버 항목에는 연결 매개변수가 저장되고, Config에는 트래픽 분기 로직이 저장되며, Global Routing은 현재 사용할 처리 방식을 결정합니다. 변경 전에 어느 설정 단계인지 확인하면 규칙 문제를 프로토콜 오류로 오해하거나 정상 작동하는 서버 설정을 반복해서 바꾸는 일을 줄일 수 있습니다.

Rule: 먼저 매칭한 뒤 처리

Config에서 Rule의 순서를 확인하세요. 요청은 위에서 아래로 매칭되며, 조건에 일치하면 해당 정책으로 처리됩니다. 구체적인 도메인 조건을 더 포괄적인 조건보다 앞에 두고, 마지막에는 FINAL을 기본 처리로 사용하세요. 오른쪽 예시는 도메인 접미사, 지리적 주소 조건 및 최종 정책을 보여줄 뿐, 모든 네트워크에 적합한 완성된 구성은 아닙니다. PROXY를 사용하려면 연결 가능한 프록시 대상이 있어야 하며, DIRECT도 현재 네트워크에서 대상에 접속할 수 있어야 합니다. 변경 후에는 연결 기록에서 실제로 적용된 규칙을 확인하세요. 상단의 연결 스위치만 확인해서는 안 됩니다.

default.conf
  1. DOMAIN-SUFFIX,example.com,PROXY
  2. GEOIP,CN,DIRECT
  3. FINAL,PROXY

Global Routing:Config / Proxy / Direct

Config, Proxy, Direct는 각각 구성에 따른 분기, 프록시, 직접 연결 방식에 해당합니다. Config는 현재 구성을 기준으로 트래픽을 분기하고, Proxy는 일반적인 요청을 선택한 프록시로 전달하며, Direct는 직접 연결합니다. 문제를 진단할 때는 먼저 기존 선택 항목을 기록한 뒤 한 가지만 임시로 바꿔 비교하세요. Global Routing의 Proxy와 규칙의 PROXY를 혼동하지 마세요. 전자는 현재 실행 방식을, 후자는 규칙 매칭 후 적용되는 정책 키워드를 뜻합니다.

Proxy로 전환했을 때는 접속되지만 Config에서는 문제가 생긴다면 먼저 규칙, 정책 참조 및 이름 확인 경로를 살펴보세요. 두 방식 모두 실패하면 서버 매개변수와 네트워크 상태를 확인하세요. 연결 방식을 바꾸면 원인을 좁히는 데 도움이 되지만, 잘못된 인증 정보를 고치거나 대상에 반드시 접속할 수 있게 해주지는 않습니다. 테스트가 끝나면 원래 설정으로 되돌려 임시 진단 상태가 계속 사용되지 않도록 하세요.

Global Routing 및 설정 안내 보기 →

요청 하나부터 규칙 확인하기

처음부터 구성 전체를 교체하지 마세요. 반복해서 접속을 시도할 수 있는 대상을 하나 정하고 문제가 발생한 네트워크, 실행 방식 및 선택한 서버를 기록한 다음 어떤 규칙에 매칭되는지 확인하세요. DOMAIN은 특정 도메인, DOMAIN-SUFFIX는 도메인 접미사 범위, IP-CIDR은 IP 주소 범위를 대상으로 합니다. 조건이 다르면 확인되는 매칭 결과도 달라질 수 있습니다.

REJECT는 규칙에 매칭된 요청을 차단하지만, 도메인 단위 판정만으로는 같은 도메인에서 제공되는 서로 다른 용도의 콘텐츠를 구분할 수 없습니다. 페이지 본문은 정상인데 이미지, 로그인 또는 미디어에 문제가 있다면 관련 리소스가 잘못 차단되지 않았는지 확인하세요. USER-AGENT는 요청에 식별 가능한 정보가 있는지에 따라 달라지므로 모든 암호화 트래픽이 이 필드로 매칭된다고 가정해서는 안 됩니다. 규칙을 구체적으로 작성할수록 영향 범위를 파악하고 변경을 되돌리기 쉽습니다.

증상별 문제 해결 가이드 보기 →

02 / DEVICE & STORE

iPhone·iPad 구매 안내

Shadowrocket은 Apple 플랫폼용 유료 클라이언트이며 App Store에서만 구매할 수 있습니다. 구매 전에 실제 사용할 기기에서 제품 페이지를 열어 현재 스토어에서 확인할 수 있는지, 가격과 호환성을 확인하세요. 시스템 요구 사항과 구매 호환성은 App Store 페이지에 표시된 내용을 기준으로 확인하세요. 검색 결과에 나온 이름만으로 제품을 판단하거나, 가이드의 예시를 구매 후 기본 구성으로 간주하지 마세요.

iPhone

App Store에서 구매 및 설치를 마친 뒤 Home을 열어 기존 서버 또는 구독을 가져오는 방법을 확인하세요. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 메시지가 표시될 수 있습니다. 시스템 안내를 읽고 Shadowrocket에서 요청한 것인지 확인한 다음 허용하세요. 이 권한은 시스템 네트워크 연결을 설정하기 위한 것으로, 서버 매개변수가 검증됐다는 뜻은 아닙니다.

먼저 안정적인 네트워크에서 가져오기, 항목 선택 및 테스트를 마친 다음 네트워크를 바꿨을 때의 동작을 확인하는 것이 좋습니다. 스위치를 켤 수는 있지만 접속이 되지 않는다면 연결 스위치를 반복해서 누르기보다 Global Routing, 선택한 항목 및 Config를 확인하세요.

iPhone 구매 및 첫 실행 안내 보기 →

iPad

같은 Apple ID의 구매 내역에서 앱을 찾아 다시 다운로드할 수 있습니다. 구매 호환성은 App Store 페이지에 표시된 내용을 기준으로 확인하세요. 다운로드 후에도 iPad에 저장된 서버 항목과 현재 구성을 확인해야 합니다. 앱 복원과 구성 복원은 별개의 작업이므로 아이콘이 나타났다고 해서 모든 연결 정보가 이전됐다고 간주해서는 안 됩니다.

화면이 넓어지면 목록과 상세 정보가 표시되는 위치가 달라질 수 있지만 Home, Config, Settings에서 확인할 사항은 같습니다. iCloud로 자료를 동기화했다면 연결 테스트 전에 선택된 항목, 정책 참조 및 현재 실행 방식을 하나씩 확인하세요.

iPad 구매 항목 및 구성 안내 보기 →

먼저 제품 페이지를 확인한 뒤 구매하세요

버튼을 누르면 Shadowrocket의 App Store 제품 페이지가 열립니다. 현재 가격, 호환성 및 구매 관련 안내는 스토어에 표시된 내용을 기준으로 확인하세요. 제품 페이지가 보이지 않으면 기기 문제로 단정하지 말고 계정의 스토어와 제품 이용 가능 여부를 먼저 확인하세요.

구매 방법 보기 →
App Store에서Shadowrocket 다운로드
일회성 구매 앱 ID 932747118 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요

설치 후 확인 순서

첫째, 사용자가 보유한 구독 또는 서버 정보를 준비하고 Subscribe, Scan QR Code, 수동 Add Server 중 어떤 방법을 사용할지 정하세요. 둘째, 가져온 뒤 사용할 항목을 선택하고 Type과 필수 매개변수를 확인하세요. 셋째, Global Routing과 현재 Config를 확인한 다음 연결을 설정하고 실제 대상에 접속해 보세요. 각 단계에서 한 가지 설정만 다루면 '내용을 가져오지 못함', '항목 매개변수가 맞지 않음', '규칙이 매칭되지 않음'을 구분할 수 있습니다.

기본 연결을 확인하기도 전에 많은 규칙, 자동 연결 조건 및 추가 처리 설정을 한꺼번에 적용하지 마세요. 재현 가능한 기본 구성을 먼저 보관한 뒤 필요한 기능을 하나씩 추가하세요. 전체 작업 흐름과 자주 발생하는 문제는 시작 가이드에서 확인할 수 있습니다. 시스템 권한, 연결 시간 초과 또는 이름 확인 문제가 발생하면 문제 해결 가이드의 해당 항목을 따라 확인하세요.

03 / PURCHASE FACTS

정품 확인 및 일회성 구매

Shadowrocket은 상용 비공개 소스 앱입니다. 이 공식 웹사이트와 가이드에서는 App Store에서 확인할 수 있는 제품 정보를 바탕으로 구매 방법을 안내하며, 이름이 비슷하다는 이유만으로 제품을 판단하지 않습니다. 구매 전 개발자, 공식 아이콘 및 앱 ID를 차례로 확인하세요. 설치 후 업데이트와 구매 내역은 App Store에서 관리하고, 연결 정보는 사용자가 실제 구성에 맞게 관리해야 합니다.

Shadowrocket 공식 앱 아이콘

스토어에서 확인할 세 가지 정보

제품명
Shadowrocket
개발자
Shadow Launch Technology Limited
앱 ID
932747118

제품 페이지 URL 끝의 id932747118은 앱 ID입니다. 아이콘, 개발자 및 ID를 함께 확인하세요.

항목별 정품 확인 방법 보기 →

검색 결과만으로 제품을 확인할 수는 없습니다

검색 결과에 이름이나 아이콘이 비슷한 앱이 표시될 수 있습니다. 먼저 제품 상세 페이지를 열어 개발자가 Shadow Launch Technology Limited인지 확인한 다음 이 사이트에 표시된 공식 아이콘 및 제품 페이지의 앱 ID와 대조하세요. 아이콘은 식별에 도움이 되지만 그림만으로 정품을 확인할 수는 없습니다. 개발자 이름과 앱 ID도 함께 확인해야 합니다. 세 가지 정보가 일치하는지 확인한 뒤 가격, 호환성 및 구매 안내를 살펴보세요.

구매 내역에서 앱을 찾았더라도 앱 이름과 제품 정보를 확인하는 것이 좋습니다. 특히 계정에 이름이 비슷한 앱이 여러 개 있는 경우 주의하세요. 스토어 언어, 검색 순서 또는 페이지 배치가 달라져도 확인해야 할 세 가지 정보는 같습니다. 가이드의 단계는 확인 순서를 안내하며, 실제 버튼 위치는 현재 App Store 화면을 기준으로 확인하세요.

스토어 지역 및 계정 상태

현재 스토어에서 제품을 볼 수 있는지는 계정이 연결된 스토어와 제품 이용 가능 여부에 따라 달라집니다. 제품 페이지가 열리지 않거나 검색 결과에 나오지 않는다면 앱을 반복해서 설치하기보다 현재 로그인한 구매 계정과 스토어 상태부터 확인하세요. 스토어에 따라 현지 통화로 가격이 표시됩니다. 이 사이트에 나오는 미국 스토어 가격은 결제 방식 설명을 위한 예시이며, 결제 전에는 기기에 실제 표시되는 금액을 확인하세요.

계정 지역 변경, 결제 수단 또는 구매 제한과 관련한 사항은 App Store에 표시된 최신 안내를 따르세요. 웹페이지가 열린다고 해서 해당 계정으로 반드시 구매할 수 있는 것은 아닙니다. 같은 기기에서의 iCloud 로그인 상태와 App Store 구매 계정을 동일한 것으로 간주해서도 안 됩니다. 구매 항목을 복원할 때는 실제로 구매를 완료한 계정을 확인하세요.

일회성 구매는 클라이언트 사용 권한에 적용됩니다

Shadowrocket은 일회성 구매 방식이며 미국 스토어 가격은 $2.99입니다. 실제 가격은 App Store 페이지를 확인하세요. 클라이언트 구매 ≠ 연결 서비스 요금제. 앱을 구매한 뒤에도 사용자가 자신의 구독 또는 서버 정보를 보유해야 합니다. 클라이언트는 연결 매개변수를 읽고 규칙을 적용해 요청을 처리하며, 앱을 구매해도 Home에 사용할 수 있는 서버가 자동으로 추가되지는 않습니다.

이 사이트는 서버나 구독을 제공, 판매 또는 추천하지 않습니다. 이 가이드에서는 사용자가 이미 보유한 자료를 가져오는 방법, 항목이 올바르게 대응하는지 확인하는 방법 및 오류 원인을 찾는 방법만 설명합니다. 원격 인증 정보가 만료됐거나 서버가 중단됐거나 서비스 권한이 변경되어 연결이 실패한다면 기존 서비스의 정보와 상태를 확인하세요. 클라이언트를 다시 구매해도 해결되지 않습니다.

구매 항목과 자료 복원은 따로 처리하세요

기기를 바꾸거나 앱을 다시 설치한 뒤에는 원래 구매 계정으로 App Store의 구매 항목을 열어 Shadowrocket을 찾고 제품 정보를 확인한 다음 다시 다운로드하세요. 버튼에 여전히 가격이 표시된다면 다시 결제하기 전에 구매 계정, 스토어 및 구매 내역을 확인하세요. iPhone과 iPad에서의 구매 적용 범위 및 가족 공유 가능 여부는 App Store 페이지에 표시된 내용을 기준으로 확인하세요.

앱을 다시 다운로드해도 서버 항목과 Config가 복원되는 것은 아닙니다. 기기를 옮기기 전에 필요한 백업을 보관하고, 이전 후에는 iCloud 동기화 결과와 현재 선택된 구성 및 서버를 확인하세요. 자료가 모두 있는지 확인하고 연결 테스트를 마친 뒤 이전 기기의 관련 내용을 정리하세요. 구매 항목을 찾는 방법은 구매 항목 복원 안내를 확인하세요.

업데이트 후에는 기존 사용 경로부터 확인하세요

앱 업데이트는 App Store에서 관리하며 버전 정보와 업데이트 내역은 제품 페이지에서 확인하세요. 업데이트 전에 작동하는 구성을 보관하고, 업데이트 후에는 이전에 정상 작동했던 접속 절차를 다시 따라 서버 선택, Global Routing 및 Config가 예상대로인지 확인하세요. 일부 대상에서만 문제가 발생한다면 먼저 규칙 매칭과 이름 확인 결과를 비교하세요. 모든 요청이 동시에 실패한다면 시스템 네트워크, 연결 권한 및 기존 서버 상태를 확인하세요.

문제가 발생했을 때 간단히 기록해 두면 여러 설정을 동시에 바꾸는 것보다 원인을 파악하기 쉽습니다. 사용한 네트워크, 실행 방식, 특정 대상에서만 실패했는지 여부 및 테스트 결과 등을 기록할 수 있지만 비밀번호, 개인 키 또는 전체 구독 링크는 포함하지 마세요. 진단 정보를 제출하기 전에 스크린샷과 텍스트에 민감한 항목이 있는지 확인하세요. 문제가 해결되면 임시로 추가한 테스트 규칙과 로그 설정을 되돌려 구성을 관리하기 쉽게 유지하세요.

구매, 복원 및 사용 관련 자주 묻는 질문 보기 →

04 / TECHNICAL NOTES

기술 노트: 결제, 프로토콜 및 규칙의 범위

아래 노트에서는 구매 전 비용 확인, 기존 WireGuard 구성의 매개변수 확인, REJECT 규칙의 영향 범위를 각각 다룹니다. 실제 문제에 맞춰 읽을 내용을 선택하세요. 비용 문제는 스토어 정보를, 연결 문제는 프로토콜 항목을, 특정 페이지의 문제는 규칙을 확인하면 됩니다. 설정 단계를 나누어 살펴봐야 문제 해결에 필요한 근거를 명확하게 유지할 수 있습니다.