공식 매뉴얼 / 빠른 시작
Shadowrocket 구독 가져오기와규칙 설정
항목 추가, 모드 선택, 연결, 확인, 문제 해결 순으로 진행합니다. 처음 설정할 때는 확인 가능한 연결을 하나 먼저 만든 다음 트래픽 분할 규칙을 조정하세요. 모든 설정을 한꺼번에 바꿀 필요는 없습니다.
스크린샷은 App Store의 공식 이미지로, 화면에 표시되는 항목명을 확인하는 데 활용할 수 있습니다. 실제 항목은 Type, 기기 및 앱 화면에 따라 다를 수 있으므로 현재 앱에 표시되는 내용을 기준으로 하세요. 스크린샷의 연결 매개변수를 그대로 복사하지 마세요.
STEP 01 / IMPORT
Add Server: 서버 추가 또는 구독 가져오기
먼저 보유한 정보가 구독 링크인지 단일 서버 매개변수인지 확인하세요. 구독 링크를 사용하면 서버 항목을 가져오고 업데이트할 수 있습니다. 서버 매개변수를 직접 입력할 때는 각 항목을 따로 작성해야 합니다. 두 입력 방식은 서로 다르므로 구독 주소 전체를 서버의 Host에 입력하면 안 됩니다. Shadowrocket을 열고 Home으로 이동한 뒤 SERVER 그룹에서 Add Server를 선택하거나 화면의 추가 항목을 눌러 편집 화면으로 이동합니다.
기존 구독 링크가 있는 경우: Subscribe 선택
Add Server에서 Type을 누르고 Subscribe를 선택한 다음, 본인의 구독 링크 전체를 해당 유형의 주소 입력란에 입력합니다. 알아보기 쉬운 이름을 지정할 수 있지만 이름에 계정 비밀번호를 적지는 마세요. 붙여넣은 주소의 시작과 끝이 모두 온전한지, 설명 문구나 공백, 줄바꿈이 섞이지 않았는지 확인한 뒤 저장하고 Home으로 돌아가 가져오기가 완료될 때까지 기다립니다.
가져오기가 완료되면 SERVER 목록에 구독에서 가져온 서버 항목이나 해당 그룹이 표시됩니다. 예상한 이름이 보이는지 확인하세요. 구독 이름만 보이고 서버 항목이 없다면 연결 준비가 완료된 것이 아닙니다. 가져오기에 실패했다는 메시지가 표시되면 먼저 주소가 유효한지, 현재 네트워크에서 해당 주소에 접속할 수 있는지 확인한 뒤 응답 내용이 Shadowrocket에 맞는지 살펴보세요. 같은 구독을 반복해서 추가하지 마세요. 나중에 항목을 선택할 때 혼동하기 쉽습니다.
기존 서버 매개변수가 있는 경우: Type에 맞춰 항목별로 입력
서버를 직접 추가할 때는 보유한 정보에 맞는 Type을 선택한 다음 Host, Port 및 해당 유형에 필요한 인증 정보를 입력합니다. Password나 Method 항목이 표시되는지는 선택한 유형에 따라 다릅니다. 편집 화면을 스크린샷과 똑같이 보이게 하려고 프로토콜을 바꾸지 마세요. 일반적으로 Host에는 서버 도메인이나 IP 주소를 입력하며 웹 페이지 경로는 추가하지 않습니다. 포트도 서버 측 설정과 일치해야 합니다.
가져오기용 QR 코드가 있다면 Add Server 화면에서 Scan QR Code를 사용할 수 있습니다. 인식한 뒤에도 입력 항목을 확인하세요. Import from Cloud JSON은 별도의 가져오기 기능이며, 해당 방식에 맞는 데이터가 있을 때만 사용합니다. Subscribe와는 다른 기능입니다. 가져오기를 사용하면 직접 입력할 항목을 줄일 수 있지만 원격 서버를 현재 사용할 수 있다는 뜻은 아닙니다.
저장한 뒤 SERVER로 돌아가 테스트할 항목을 선택하고, 선택 표시가 예상한 항목에 있는지 확인합니다. 목록에 같은 이름의 항목이 여러 개라면 다음 단계로 넘어가기 전에 그룹과 서버 정보를 대조하세요. 구독 링크에 접속 정보가 포함될 수 있으므로 문제를 해결할 때 주소 전체나 QR 코드를 공개하지 마세요. 구독과 구성 파일의 차이를 더 알아보려면 사용 매뉴얼을 참고하세요.
STEP 02 / ROUTING
Global Routing: Config, Proxy 또는 Direct 선택
서버가 있다고 해서 모든 요청이 어디로 전달될지 정해진 것은 아닙니다. Home으로 돌아가 Global Routing을 눌러 현재 모드를 확인하세요. 자주 사용하는 모드는 Config, Proxy, Direct입니다. 모드는 요청이 어떤 경로를 따를지 결정하며, 서버 목록에서 선택한 항목은 프록시가 필요한 요청에 사용할 연결을 정합니다. 두 항목을 각각 확인해야 합니다.
Config: 현재 구성에 따라 요청 처리
Config를 선택하면 현재 구성의 규칙과 정책에 따라 요청이 처리됩니다. 사용하기 전에 Config로 이동해 사용할 구성 파일이 목록에 가져오기만 된 것이 아니라 실제로 선택되어 있는지 확인하세요. 공식 스크린샷에는 General, Rule, Hosts 등의 구역이 있는 구성 편집 화면이 표시됩니다. 처음 사용할 때 모든 구역을 수정할 필요는 없으며, 일반적인 연결을 위해 HTTPS Decryption을 켤 필요도 없습니다.
구독은 일반적으로 서버 목록을 담당하고 구성 파일은 규칙 등의 설정을 담당합니다. 따라서 구독을 성공적으로 가져와도 트래픽 분할 규칙이 적용되었다는 뜻은 아닙니다. Rule에서 규칙을 살펴볼 때는 일치 조건, 규칙 순서, 대상 정책을 함께 확인하세요. 아래는 규칙을 읽는 순서를 설명하기 위한 예시이며, 그대로 붙여넣을 전체 구성은 아닙니다. 실제 구성에서 참조하는 정책 이름은 반드시 존재해야 합니다.
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY이 예시는 먼저 도메인 접미사를 확인한 다음 GEOIP 조건을 확인하며, 앞선 규칙에 일치하지 않는 경우에만 FINAL로 처리합니다. example.com은 문법 설명용일 뿐 서버 주소가 아니며 연결 정보로 사용해서는 안 됩니다. 규칙을 아직 이해하기 어렵다면 기존 구성을 그대로 두고 아래 모드를 사용해 비교하세요. 첫 테스트에서 여러 규칙을 동시에 추가하거나 삭제하지 마세요.
Proxy와 Direct: 명확한 비교 테스트
Proxy는 일반 요청을 프록시 경로로 처리해 규칙 분할이 문제의 원인인지 확인하는 데 도움이 됩니다. 속도를 보장하는 기능은 아니며 실제 동작은 관련 설정과 네트워크 환경에 따라 달라집니다. Direct는 선택한 원격 프록시 서버를 거치지 않고 로컬 네트워크 경로를 사용하므로 기본 네트워크 상태를 확인하는 데 적합합니다. Direct에서 대상에 접속할 수 있더라도 프록시 서버가 정상이라는 뜻은 아닙니다.
처음 문제를 확인할 때는 Proxy를 선택해 서버 연결로 접속할 수 있는지 확인한 다음 Config로 돌아가 평소 사용하는 트래픽 분할을 점검할 수 있습니다. 모드를 바꿀 때마다 Home으로 돌아가 Global Routing에 표시된 값을 확인하세요. 테스트가 끝나면 필요한 모드로 되돌립니다. 규칙 순서와 정책 참조에 관한 자세한 설명은 사용 매뉴얼에서 확인할 수 있으며, 이 페이지에서는 먼저 연결 하나를 완료합니다.
STEP 03 / CONNECT
Home: 스위치를 켜고 연결 권한 승인하기
먼저 서버와 모드를 확인한 뒤 상단 스위치를 켜세요. Home으로 돌아가 SERVER에서 현재 선택된 항목을 확인하고 Global Routing도 살펴봅니다. 상단에 표시되는 Not Connected는 현재 앱 연결이 설정되지 않았다는 뜻이며 서버 항목에 반드시 문제가 있다는 의미는 아닙니다. 정보 추가와 실제 연결 시작은 별개의 작업입니다.
상단 연결 스위치를 켭니다. 처음 연결을 시작할 때 시스템에서 VPN 구성 추가를 허용할지 물을 수 있습니다. 시스템 팝업을 읽고 현재 작업으로 인해 발생한 요청인지 확인한 다음 허용하세요. 기기 인증을 요구하면 화면 안내에 따라 완료합니다. 이 권한을 사용하면 Shadowrocket이 시스템 수준에서 해당 네트워크 트래픽을 처리할 수 있습니다. 서버 매개변수가 자동으로 입력되거나 원격 인증이 성공하는 것은 아닙니다.
권한 승인을 마치면 앱으로 돌아와 스위치와 연결 상태가 유지되는지 확인합니다. 이전에 권한을 거부했다면 다시 연결을 시작할 때 앱과 시스템의 안내에 따르세요. 재시도하기 위해 모든 구독을 먼저 삭제하지 마세요. 기기가 조직에서 관리되거나 관련 권한이 제한된 경우에는 기기 관리 요건을 확인해야 합니다. 모드를 반복해서 바꾸는 것만으로 해결할 수는 없습니다.
연결 스위치가 켜진 상태를 유지하면 다른 설정은 당분간 바꾸지 말고 다음 단계에서 확인합니다. 시스템의 연결 표시는 해당 네트워크 구성이 실행 중임을 나타낼 뿐, 모든 웹사이트에 예상한 경로로 접속된다는 뜻은 아닙니다. 스위치가 곧바로 꺼지거나 권한 승인이 완료되지 않거나 오류가 표시되면 메시지 원문과 발생한 작업 단계를 기록한 뒤 5단계에서 유형별로 점검하세요.
처음 테스트 결과를 명확하게 판단하려면 하나의 로컬 네트워크 환경을 유지하고 스위치를 켜는 동시에 Wi-Fi와 셀룰러 네트워크를 전환하지 않는 것이 좋습니다. 서버, 모드, 구성 파일을 한꺼번에 바꾸지 마세요. 연결에 성공하면 어떤 설정 조합이 작동했는지 파악할 수 있습니다. 이후 평소 사용할 Config 모드로 되돌린 다음 다시 확인하세요.
STEP 04 / VERIFY
Connectivity Test: 테스트 결과와 실제 접속 확인
테스트 결과, 실제 접속, 현재 모드를 함께 확인해야 연결을 제대로 검증할 수 있습니다. 먼저 Home에서 Connectivity Test를 실행해 사용하려는 서버의 테스트 결과를 확인합니다. 테스트 수치는 현재 테스트 방식으로 얻은 한 번의 결과일 뿐 다운로드 속도가 아니며 모든 대상에 접속할 수 있음을 보장하지 않습니다. 시간 초과가 표시되어도 테스트 방식과 실제 연결 상태를 함께 살펴야 합니다. 하나의 수치만 보고 모든 매개변수를 바꾸지 마세요.
그런 다음 브라우저나 대상 앱을 열어 현재 구성에서 처리될 것으로 예상하는 페이지에 접속하고 로딩이 완료될 때까지 기다립니다. 캐시된 내용만 보지 않도록 새 페이지를 열거나 요청을 새로고침하세요. 현재 선택한 서버, Global Routing 모드, 사용 중인 네트워크와 실제 현상을 기록합니다. 전혀 로드되지 않는지, 일부 내용만 실패하는지, 열리지만 속도가 느린지 구분하세요. 다음에 규칙, 서버, 로컬 네트워크 중 무엇을 확인할지 판단하는 데 도움이 됩니다.
Shadowrocket으로 돌아가 Data에서 확인할 수 있는 트래픽이나 활동 기록을 살펴봅니다. 데이터 변화는 앱이 요청을 처리하고 있음을 확인하는 데 도움이 될 수 있지만, 총량이 늘었다고 해서 특정 대상이 지정된 정책과 일치했다는 뜻은 아닙니다. 현재 화면에서 요청 세부 정보를 확인할 수 있다면 대상, 규칙, 정책 정보를 함께 대조하세요. 상태 표시줄 아이콘이나 외부 주소 확인 결과 하나만을 유일한 근거로 삼지 마세요.
Proxy에서는 접속되지만 Config에서 같은 대상에 접속되지 않는다면 서버를 바로 다시 만들기보다 현재 구성 파일, 규칙 순서, 대상 정책, 관련 DNS 설정을 먼저 확인하세요. 반대로 두 모드에서 모두 실패한다면 매개변수는 그대로 둔 채 연결을 끄고 로컬 네트워크를 확인한 다음, 이미 보유한 다른 서버 항목으로 비교 테스트를 진행할 수 있습니다.
속도가 느린 경우에는 첫 로딩 지연, 지속적인 데이터 전송, 간헐적 끊김을 구분하세요. 이 현상을 모두 지연 문제로 묶어 판단하지 마세요. 증상별 점검 방법은 문제 해결에서 확인할 수 있습니다. 여기서는 처음 사용할 때 자주 발생하는 실패 단계를 계속 살펴봅니다.
STEP 05 / CHECK
Settings: 실패한 단계에 맞춰 확인하고 한 번에 하나씩 변경
먼저 어느 단계에서 실패했는지 확인한 뒤 관련 설정을 선택하세요. Settings의 옵션은 처음 연결할 때 모두 조정해야 하는 항목이 아닙니다. 스크린샷에 표시된 Test Method, On Demand, Diagnostics는 각각 용도가 다르며, 스위치 하나를 바꾸는 것으로 모든 문제를 해결할 수는 없습니다. 시작하기 전에 현재 서버와 모드, 오류 메시지 원문을 기록해 원래 상태로 되돌릴 수 있도록 하세요.
구독에 항목이 없음: 가져오기 단계부터 확인
예상한 항목이 SERVER에 없다면 구독 항목으로 돌아가 전체 주소와 유효 상태를 확인합니다. 현재 로컬 네트워크에서 구독을 가져올 수 있는지 확인한 뒤 응답 형식이 호환되는지도 살펴보세요. 이전에 정상적으로 사용했더라도 링크의 접근 권한이나 내용이 달라졌을 수 있습니다. 이런 경우 본인이 이용 중인 서비스 제공자에게 확인해야 합니다. 서버 항목이 없는 문제를 Global Routing 선택 오류로 판단하지 마세요.
목록에는 항목이 있지만 연결되지 않음: 매개변수와 권한 확인
선택한 항목의 편집 화면을 열어 Type, Host, Port와 인증 정보를 하나씩 대조합니다. 복사할 때 공백이 섞이거나 문자가 빠지지 않았는지, 전송 옵션이 서버 요구 사항과 일치하는지 특히 주의하세요. 오류가 확인된 항목만 수정하고 저장한 뒤 해당 항목을 다시 선택해 테스트합니다. 상단 스위치가 켜진 상태를 유지하지 못하면 규칙을 조정하기 전에 시스템 권한과 앱 안내부터 확인하세요.
테스트 시간 초과 또는 결과 불일치: Test Method 확인
Settings에서 Test Method를 확인해 현재 결과가 어떤 테스트 방식으로 나온 것인지 파악한 뒤, 본인이 보유한 서버를 같은 방식으로 비교하세요. 일부 테스트가 실패해도 실제 접속이 된다면 테스트 조건부터 살펴봐야 합니다. 테스트 수치만으로 연결 전체를 판단하지 마세요. 실제 접속도 실패한다면 앱 설정은 그대로 둔 채 Wi-Fi와 셀룰러 네트워크를 각각 확인하고, 한 번에 한 조건만 바꾸세요.
연결 상태가 자동으로 바뀜: On Demand 확인
수동으로 연결을 껐는데 다시 켜지거나 네트워크 전환 시 연결 상태가 바뀐다면 On Demand와 관련 조건이 활성화되어 있는지 확인하세요. 이 기능은 조건에 따라 연결을 관리할 뿐 잘못된 서버 비밀번호나 만료된 구독을 해결하지 않습니다. 명확한 수동 테스트 기준을 마련하려면 기존 조건을 기록한 다음 관련 자동 동작을 잠시 끌 수 있습니다. 테스트를 마친 뒤에는 본인의 사용 방식에 맞게 복원하세요.
일부 대상에만 접속되지 않음: Config에서 규칙 확인
대부분의 대상에는 접속되지만 특정 대상만 실패한다면 Proxy와 Config의 결과를 비교하고 현재 활성화된 구성 파일을 확인하세요. 특정 대상 하나를 테스트하기 위해 모든 DNS 및 전송 설정을 바꾸거나 HTTPS Decryption을 함부로 켜지 마세요. 추가 기록이 필요하면 Diagnostics에서 제공하는 진단 기능을 확인할 수 있습니다. 기록을 공유하기 전에는 구독 주소, 비밀번호, 인증 항목 및 개인 요청 정보를 가리세요.
원인을 찾지 못했다면 실패한 단계, 오류 메시지 원문, 모드, 네트워크 환경, 이미 진행한 비교 테스트 하나를 정리하면 계속 점검할 수 있습니다. 전체 구성을 공개할 필요는 없습니다. 증상에 따라 문제 해결을 참고하고, Config, Data 또는 일상적인 관리에 관한 전반적인 안내는 전체 사용 매뉴얼에서 확인하세요. 문제가 해결되면 평소 사용하는 모드로 돌아가 4단계 확인을 다시 진행해 반복해서 활용할 수 있는 점검 순서를 만듭니다.
