공식 매뉴얼 / 처음 사용하기
Shadowrocket 사용법
구독 가져오기 및 연결 확인
어디서 시작하면 될까요? 보유한 연결 정보를 앱에 추가하고 Global Routing을 선택한 다음 연결합니다. 마지막으로 실제 접속으로 결과를 확인하세요. 이 페이지에서는 기본 사용 절차를 안내하며, 규칙에 관한 자세한 내용은 규칙 매뉴얼에서 확인할 수 있습니다.
스크린샷은 어떻게 참고하나요? 아래에서는 App Store 공식 스크린샷으로 화면의 위치를 설명합니다. 실제 옵션은 기기에 표시되는 내용을 기준으로 확인하세요. 스크린샷에 나온 서버 정보는 그대로 입력할 값이 아닙니다.
STEP 01 / ADD SERVER
서버 추가 또는 구독 가져오기
연결 정보를 받았다면 어디를 눌러야 할까요? 먼저 Home으로 이동해 Add Server를 찾습니다. 보유한 정보에 따라 추가 방법을 선택하세요. 구독 링크 전체가 있다면 Subscribe로 가져오고, 서버 정보가 따로 있다면 해당 Type을 선택해 직접 입력합니다. 두 방법 모두 서버를 Home의 SERVER 목록에 표시하는 것이 목적이므로 같은 정보를 반복해서 추가할 필요는 없습니다.
구독 링크가 있는 경우: Subscribe 선택
기존 구독은 어떻게 추가하나요? Add Server로 이동해 Type에서 Subscribe를 선택한 다음 구독 주소 입력란에 본인의 링크 전체를 붙여넣고 저장한 뒤 내용이 로드될 때까지 기다립니다. 원본 자료에서 직접 복사하고, 앞뒤에 공백이나 줄바꿈, 메시지의 문장부호가 섞이지 않았는지 확인하세요. 링크의 쿼리 매개변수도 주소의 일부인 경우가 많습니다. 도메인만 남기거나 길어 보이는 문자를 임의로 삭제하거나 수정하지 마세요.
저장한 뒤 무엇을 확인해야 하나요? Home으로 돌아가 구독에 해당하는 서버가 목록에 표시되는지 확인합니다. 구독 항목만 보이고 서버가 없다면 가져오기 또는 업데이트 오류를 확인한 뒤 주소가 완전한지, 현재 네트워크에서 구독 서버에 접속할 수 있는지, 기존 서비스가 유효한지 살펴보세요. 구독이 성공적으로 로드됐다는 것은 목록을 가져왔다는 뜻일 뿐, 목록의 모든 서버가 연결된다는 의미는 아닙니다. 다음 단계에서 Connectivity Test를 진행하세요.
서버 정보를 직접 입력하는 경우: Type을 선택한 뒤 입력
직접 추가할 때 어떤 항목부터 입력하나요? 먼저 보유한 정보와 일치하는 Type을 선택한 뒤 화면에 따라 Host, Port와 해당 프로토콜의 인증 정보를 입력합니다. 공식 스크린샷에는 Password, Method 등의 항목이 있지만 Type에 따라 입력란 구성이 다릅니다. 한 프로토콜의 입력 양식을 모든 프로토콜에 공통으로 적용할 수는 없습니다. Host에는 보통 서버 도메인이나 주소를, Port에는 해당 포트 번호를 입력합니다. 비밀번호, UUID, TLS 및 전송 매개변수는 보유한 정보와 하나씩 대조하세요.
QR 코드가 있다면 어떻게 하나요? 페이지 하단의 Scan QR Code로 본인이 보유한 서버 QR 코드를 읽을 수 있습니다. 가져온 뒤에도 Type, Host, Port를 확인하세요. Import from Cloud JSON은 해당 형식의 자료를 가져오는 기능이며, 임의의 구독 주소를 붙여넣는 대체 경로가 아닙니다. 자료 형식을 판단하기 어렵다면 원본 안내를 확인하고 Type을 임의로 바꿔가며 맞추려 하지 마세요.
이 단계가 끝났는지 어떻게 확인하나요? 저장한 뒤 Home으로 돌아가 SERVER 목록에서 사용할 서버를 선택하고 현재 선택이 해당 서버를 가리키는지 확인합니다. 구독 주소와 QR 코드에는 접속 정보가 포함될 수 있으므로 공개적으로 공유하지 마세요. 각 항목의 의미는 용어집에서 확인할 수 있습니다. 업데이트 실패나 내용이 비어 있는 문제가 있다면 문제 해결을 참고하세요. 목록을 준비했다면 다음 단계에서 트래픽 처리 방식을 선택합니다.
STEP 02 / GLOBAL ROUTING
Global Routing 모드 선택
서버를 추가하면 모든 요청의 경로가 정해지나요? 그렇지 않습니다. Home으로 돌아가 Global Routing을 열고 현재 Config/Proxy/Direct 중 무엇을 사용하는지 확인하세요. 서버 선택은 사용할 수 있는 프록시 연결 대상을 정하고, Global Routing은 전반적인 처리 방식을 정합니다. 서버가 선택됐는지만 확인하지 말고 두 항목을 함께 살펴보세요.
Config: 현재 설정에 따라 트래픽 분기
Config는 언제 선택하나요? 요청마다 규칙을 적용해 처리 방식을 나누려는 경우에 사용합니다. 현재 활성화된 설정의 규칙에 따라 DIRECT, PROXY, REJECT 등의 정책이 적용됩니다. Config 페이지를 열어 어떤 설정을 사용 중인지 확인한 뒤 내용을 살펴보세요. 공식 스크린샷에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Add Rule 메뉴가 표시됩니다. 처음 연결하는 단계에서는 Rule을 우선 확인하고, 모든 섹션을 한꺼번에 수정할 필요는 없습니다.
규칙은 결과에 어떤 영향을 주나요? 일반적으로 규칙은 위에서부터 순서대로 일치 여부를 확인하고, 일치하면 해당 규칙의 정책을 적용합니다. 아래는 구조를 설명하기 위한 예시 두 가지입니다. example.com과 그 하위 도메인은 첫 번째 규칙에 일치하고, 다른 규칙에 일치하지 않는 요청은 FINAL로 처리됩니다. 이 예시는 모든 사용자에게 적합한 완성형 설정이 아니며, 정상 작동 중인 규칙을 그대로 대체해서도 안 됩니다.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECTProxy 및 Direct: 연결 경로를 구분할 때
Proxy는 언제 사용하나요? 프록시 경로로 접속할 수 있는지 확인하려면 Proxy를 임시로 선택해 테스트할 수 있습니다. Direct는 언제 사용하나요? 현재 네트워크에서 직접 접속할 때의 동작을 확인하려면 Direct로 전환해 비교하세요. 서버를 선택했다고 Direct가 자동으로 프록시 연결로 바뀌지는 않습니다. 마찬가지로 Proxy로 전환해도 잘못된 비밀번호나 연결할 수 없는 서버가 해결되지는 않습니다.
처음 사용할 때 어떤 모드를 유지해야 하나요? 신뢰할 수 있는 설정을 보유하고 규칙에 따라 트래픽을 분기하려면 Config를 선택하세요. 연결 문제를 진단하는 중이라면 기존 선택을 기록한 뒤 임시로 전환해 비교합니다. 테스트가 끝나면 용도에 맞는 모드로 되돌리세요. 규칙 순서, 정책, FINAL에 관한 자세한 설명은 규칙 매뉴얼에서 확인할 수 있습니다. 이 페이지에서는 설정 파일의 전체 구조를 다루지 않습니다. 모드를 확인한 뒤 Home으로 돌아가 연결을 켤 준비를 하세요.
STEP 03 / CONNECT
Home 상단의 연결 스위치 켜기
이제 연결해도 될까요? 먼저 Home에서 마지막으로 확인하세요. SERVER에서 사용할 서버가 선택되어 있고 Global Routing이 앞서 정한 모드로 표시되어야 합니다. 확인한 뒤 화면 상단의 연결 스위치를 켭니다. 공식 스크린샷의 Not Connected는 촬영 당시 연결되지 않았다는 뜻입니다. 서버 이름을 찾거나 입력하라는 의미가 아니므로, 실제 조작 시에는 본인 기기의 상태 변화를 확인하세요.
처음 시스템 팝업이 나타나면 어떻게 하나요? Shadowrocket이 연결을 설정하려면 VPN 구성을 추가해야 하며, 처음 사용할 때 시스템 권한 요청이 표시될 수 있습니다. 안내가 Shadowrocket에 대한 요청인지 확인한 다음 시스템 화면에서 추가를 허용하고 기기에서 요구하는 인증을 완료하세요. 이는 기기의 네트워크 구성 권한 요청이지 구독 비밀번호를 입력하라는 뜻이 아닙니다. 용도에 맞지 않는 시스템 입력란에 서버 비밀번호를 입력하지 마세요.
권한을 허용한 뒤 어디를 확인하나요? Home으로 돌아가 연결 스위치와 상태 문구가 바뀌었는지 확인합니다. 방금 권한 요청을 취소했다면 연결되지 않은 상태일 수 있으니 스위치를 다시 켜고 안내에 따라 완료하세요. 스위치가 곧바로 꺼지거나 계속 실패한다면 먼저 화면에 표시된 오류를 기록하세요. 권한 요청을 반복해서 실행하지 말고 원인을 파악하기 전에 여러 설정을 한꺼번에 바꾸지 마세요.
VPN 상태가 표시되면 접속에 성공한 건가요? 그렇지 않습니다. 시스템에서 VPN 연결이 설정됐다는 뜻일 뿐, 원격 인증, DNS 조회, 대상 요청이 모두 성공했음을 보장하지 않습니다. Home에 연결됨으로 표시되더라도 다음 단계에서 실제 접속을 확인해야 합니다. 반대로 웹페이지 접속이 한 번 실패했다고 권한 문제라고 단정할 수도 없습니다. 서버나 대상 요청의 처리 경로가 예상과 다를 수 있습니다.
iPad에서는 다른 절차가 필요한가요? 이 페이지의 순서는 iPad에도 동일하게 적용됩니다. 정보를 추가하고 Global Routing을 선택한 다음 스위치를 켜고 결과를 확인하세요. 기기나 앱 화면에 따라 배치가 달라질 수 있지만 동일한 영문 항목을 찾아 진행하면 됩니다. 테스트 중에는 네트워크 환경을 안정적으로 유지하세요. 스위치를 켠 직후 Wi-Fi와 셀룰러 네트워크를 전환하면 설정 문제와 네트워크 변경 중 무엇이 원인인지 구분하기 어렵습니다.
STEP 04 / VERIFY
테스트와 실제 접속으로 결과 확인
제대로 작동하는지 어떻게 판단하나요? 두 단계로 확인하세요. 먼저 서버의 기본 연결 상태를 확인하고, 실제 요청이 예상대로 처리되는지 살펴봅니다. Home에서 Connectivity Test를 실행해 결과를 확인한 뒤 실제로 이용하려는 웹페이지나 앱을 여세요. 테스트 숫자 하나만으로 모든 기능이 정상이라고 판단하지 마세요. 캐시된 페이지가 표시됐다는 이유만으로 새 요청이 원하는 경로를 통과했다고 단정해서도 안 됩니다.
Connectivity Test를 먼저 실행하고 대상 요청을 확인하세요
테스트 성공은 무엇을 의미하나요? 현재 테스트 방식으로 응답을 받았다는 뜻이며 서버를 1차로 점검하는 데 유용합니다. 결과는 Settings의 Test Method, 현재 네트워크, 원격 응답에 영향을 받습니다. 모든 서비스 요청의 접속 속도를 의미하지는 않습니다. 테스트 결과는 있지만 페이지가 열리지 않는다면 서버가 완전히 정상이라고 단정하지 말고 프로토콜 인증, DNS, 규칙을 추가로 확인하세요.
실제 접속은 어떻게 확인하나요? 접속이 필요한 페이지를 선택해 새 요청을 보내고 로드되는지 확인한 다음, 자주 이용하는 다른 대상도 테스트합니다. Config에서는 두 대상에 서로 다른 규칙이 적용될 수 있으므로 결과가 다르다고 해서 반드시 이상이 있는 것은 아닙니다. 연결 기록을 볼 수 있다면 대상, 일치한 규칙, 최종 정책을 확인하세요. 프록시로 접속해야 하는 요청은 PROXY를, 직접 연결해야 하는 요청은 DIRECT를 사용하는지 살펴봅니다.
한 가지 변수만 바꿔 모드 비교
Config에서 실패하면 어떻게 이어서 확인하나요? 같은 서버와 테스트 대상을 유지한 채 Proxy로 임시 전환해 다시 테스트합니다. Proxy에서는 되지만 Config에서 예상대로 작동하지 않는다면 바로 비밀번호를 바꾸기보다 현재 설정과 일치한 규칙을 먼저 확인하세요. Direct에서는 되지만 Proxy에서 실패한다면 프록시 경로와 관련 매개변수를 확인합니다. 비교 결과는 문제 범위를 좁히는 데 도움이 되지만 한 번의 결과만으로 원인을 확정할 수는 없습니다.
이 단계의 완료 기준은 무엇인가요? 연결 상태가 안정적이고 실제로 필요한 페이지에서 새 요청이 정상적으로 처리되며 라우팅 모드가 용도에 맞아야 합니다. 사용 가능한 서버, 설정, Global Routing 조합을 기록해 두면 나중에 문제가 생겼을 때 비교할 수 있습니다. 조건에 따른 자동 연결이 아직 필요하지 않다면 수동 연결을 유지하세요. On Demand는 기본 절차를 확인한 뒤 별도로 설정하면 처음 테스트할 때 자동 연결 동작이 혼란을 주는 것을 피할 수 있습니다.
STEP 05 / DIAGNOSTICS
실패한 단계에 따라 차례로 해결
예상대로 되지 않으면 어디부터 확인하나요? 먼저 가져오기, 테스트, 연결, 실제 접속 중 어느 단계에서 실패했는지 파악한 뒤 아래 순서대로 확인하세요. Settings에서 Test Method, On Demand, Diagnostics 등의 항목을 찾을 수 있습니다. 스크린샷은 설정 이름을 찾는 데 참고하세요. 문제 해결을 위해 모든 항목을 변경하라는 뜻은 아닙니다. 특히 DNS, 규칙, 서버, 테스트 방식을 한꺼번에 바꾸면 어떤 변경이 영향을 줬는지 확인하기 어렵습니다.
가져오기 실패: 정보와 가져오기 과정 확인
구독이 비어 있거나 업데이트에 실패하면 어떻게 하나요? 구독 편집 화면으로 돌아가 주소가 완전한지 확인하고, 실제 구독 주소인지 안내 페이지 주소가 아닌지, 구독이 아직 유효한지 살펴보세요. 내용을 다시 가져오기 전에는 기존에 사용할 수 있는 항목을 보존하세요. 원인을 모른 채 모든 기록을 삭제하지 마세요. 직접 추가에 실패했다면 Add Server로 돌아가 Type이 보유한 정보와 일치하는지 확인하고 Port, 인증 항목, TLS, 전송 매개변수도 살펴보세요. 항목이 모두 채워졌다고 해서 값이 정확한 것은 아닙니다.
테스트 실패: 네트워크와 서버 문제 구분
Connectivity Test에 응답이 없으면 어떻게 하나요? 먼저 Shadowrocket 연결을 끊은 상태에서 기기가 일반적인 네트워크에 접속할 수 있는지 확인한 뒤, 본인이 보유한 다른 서버 정보로도 테스트합니다. 하나의 서버만 실패하면 해당 서버의 정보와 원격 상태를 집중적으로 확인하세요. 모두 실패한다면 현재 네트워크와 테스트 방식을 살펴봅니다. Wi-Fi와 셀룰러 네트워크를 전환해야 한다면 전환할 때마다 같은 테스트를 다시 실행하고 네트워크 조건을 기록하세요. 서로 다른 조건에서 얻은 결과를 한데 섞어 비교하지 마세요.
연결됐지만 접속 실패: 모드, DNS, 규칙 확인
스위치는 켜졌는데 페이지가 열리지 않으면 어떻게 하나요? Home으로 돌아가 Global Routing과 서버 선택을 확인한 뒤 이전 절의 방법에 따라 Proxy와 Config를 비교합니다. 도메인을 확인할 수 없는 것이 주된 문제라면 DNS를 직접 변경한 적이 있는지 확인하고, 여러 설정을 추가하기보다 최근 변경 사항부터 살펴보세요. 일부 대상만 실패한다면 REJECT 규칙에 일치했는지, 더 위에 있는 규칙이 먼저 적용됐는지, 예상과 다른 최종 정책을 사용하는지 확인합니다.
Diagnostics는 어떻게 사용하나요? 현재 증상에 따라 앱에서 제공하는 진단 정보를 확인하고 오류가 발생한 단계, 대상, 당시 네트워크 상태를 함께 살펴보세요. 오류 기록 하나는 당시 해당 요청의 상황만 나타내며 이후의 모든 연결을 설명하지는 않습니다. 기록을 저장하거나 본인이 이용하는 서비스 제공자에게 전달할 때는 구독 주소, 인증 정보, 개인을 식별할 수 있는 내용을 가리고 문제 파악에 필요한 오류와 관련 항목만 남기세요.
자동 연결이 반복됨: On Demand 확인
수동으로 끈 뒤 왜 다시 연결되나요? Settings에서 On Demand가 활성화되어 있는지, 트리거 조건이 현재 네트워크와 일치하는지 확인하세요. 문제를 확인하는 동안 자동 트리거를 잠시 비활성화하고 수동 스위치로 재현할 수 있습니다. 확인이 끝나면 원래 용도에 맞게 다시 설정하세요. 최근 설정을 가져오거나 수정했다면 변경 전후의 차이도 기록합니다. 최근에 정상 작동한 조합으로 되돌린 다음 변경 사항을 하나씩 추가하세요.
계속 실패하면 다음에는 무엇을 해야 하나요? 실패한 단계, 현재 Global Routing, Connectivity Test 결과, 실제 대상에서 나타나는 오류 등 네 가지 정보를 정리하세요. 단순히 “연결되지 않음”이라고 설명하는 것보다 이 정보를 바탕으로 문제 해결을 확인하는 편이 해당 문제를 찾기 쉽습니다. 규칙 우선순위와 설정 구조에 관한 내용은 규칙 매뉴얼을 참고하세요. 특정 항목의 의미만 궁금하다면 용어집을 확인하세요. 공개된 페이지에 구독 정보나 인증 정보를 그대로 붙여넣지 마세요.
