공식 가이드 · 시작하기
Shadowrocket
구독 가져오기 및 연결 방법
추가, 모드 선택, 연결, 확인, 문제 해결 순서로 진행합니다. 먼저 반복해서 사용할 수 있는 연결을 완료한 다음 규칙과 자동 연결 설정을 조정하세요.
시작 전: 기존 연결 정보 준비
먼저 보유한 자료가 어떤 종류인지 확인합니다. 서버 목록을 업데이트하는 구독 링크인지, 단일 서버의 공유 링크·QR 코드·매개변수 목록인지 구분하세요. 두 자료의 입력 위치는 비슷하지만 용도가 다릅니다. 구독 주소를 Host에 입력하지 말고, 링크가 HTTPS로 시작한다는 이유만으로 구독이라고 판단하지 마세요. 확실하지 않다면 자료 설명을 확인한 뒤 계속 추가합니다.
STEP 01 / ADD
Add Server: 서버 추가 또는 구독 가져오기
이 단계에서는 정보만 입력합니다. Home으로 돌아가 서버 항목이 표시되는지 확인한 다음 연결 모드를 선택합니다.
단일 서버 매개변수를 보유한 경우
Shadowrocket의 Home을 열고 Add Server를 찾아 들어갑니다. 먼저 Type을 누르고 보유한 정보에 맞는 프로토콜을 선택한 다음 Host, Port 및 해당 프로토콜에서 요구하는 인증 정보를 입력합니다. 스크린샷의 Password와 Method는 특정 Type에서 표시되는 항목입니다. 다른 Type을 선택하면 필드가 달라질 수 있으므로 현재 화면과 원래 정보를 대조하세요. 스크린샷의 필드가 모든 프로토콜에 공통으로 필요한 것은 아닙니다.
Host에는 서버 도메인 또는 IP를 입력하며 웹 경로는 덧붙이지 않습니다. Port에는 제공된 포트를 입력합니다. 복사한 내용의 앞뒤 공백과 줄바꿈을 확인하고, 특히 Password 같은 인증 정보에 주의하세요. 자료에 TLS, SNI 또는 전송 설정이 포함되어 있다면 같은 항목에서 하나씩 대조합니다. 프로토콜 이름만 보고 값을 추측하지 마세요. 입력을 마치면 저장하고 Home의 SERVER 그룹에서 새 항목을 확인합니다.
구독 링크를 보유한 경우
Add Server로 다시 들어가 Type에서 Subscribe를 선택하고 전체 구독 링크를 해당 주소 입력란에 붙여 넣습니다. 구분하기 쉬운 메모를 입력한 뒤 저장하세요. 이곳에 필요한 것은 목록을 가져오는 전체 주소이지 개별 서버의 Host가 아닙니다. 구독 주소에는 사용자 정보가 포함될 수 있으므로 공개 스크린샷, 채팅 기록 또는 진단 예시에 넣지 마세요.
저장한 뒤 구독이 처음으로 정보를 가져올 때까지 기다린 다음 Home으로 돌아가 목록을 확인합니다. 구독 그룹은 표시되지만 서버가 없다면 업데이트 결과와 링크의 완전성을 먼저 확인하세요. 같은 구독을 곧바로 다시 추가할 필요는 없습니다. 중복 항목은 이후 선택 및 업데이트 확인을 어렵게 만듭니다. 기존 항목을 수정한 뒤 다시 업데이트하면 문제가 해결됐는지 더 쉽게 확인할 수 있습니다.
QR 코드 또는 공유 링크를 보유한 경우
QR 코드는 Scan QR Code로 읽고 시스템 안내에 따라 카메라 접근을 허용할 수 있습니다. 가져온 뒤에도 항목을 열어 Type, Host, Port 및 인증 정보를 확인하세요. Import from Cloud JSON은 특정 형식의 원격 JSON 자료를 위한 기능이며, 모든 웹페이지나 구독을 가져오는 범용 기능은 아닙니다. 공유 링크와 구독의 차이는 공유 링크와 구독 링크 안내에서 확인할 수 있습니다.
마지막으로 Home에서 실제 사용할 서버를 누르고 선택 표시가 올바른 항목에 있는지 확인합니다. 목록이 있다는 것은 정보가 저장되었다는 뜻일 뿐, 원격 서버가 사용할 수 있는 상태라는 뜻은 아닙니다. 다음 단계에서 Global Routing을 이해할 수 있는 상태로 설정한 뒤 연결을 테스트합니다.
STEP 02 / ROUTE
Global Routing: 세 가지 모드 선택
서버는 연결 대상을 결정하고, Global Routing은 요청이 경로를 선택하는 방식을 결정합니다. 두 항목을 각각 확인해야 합니다.
Home으로 돌아가 Global Routing을 엽니다. 세 가지 모드는 Config / Proxy / Direct입니다. 처음 설정할 때 모드를 자주 바꾸지 마세요. 서버 자체를 확인하려는지, 구성 파일의 규칙을 확인하려는지 먼저 정한 뒤 해당 모드를 선택합니다. 모드를 변경한 뒤에는 대상 페이지를 다시 열어 요청을 보내야 합니다. 이미 로드된 페이지의 결과만으로 판단하지 마세요.
Config: 현재 파일의 규칙에 따라 분기
일상적으로 규칙을 적용하려면 Config를 선택합니다. 그런 다음 Config에서 목록의 파일 이름만 확인하지 말고 현재 실제로 사용하는 구성 파일인지 확인하세요. 구성 편집 화면에는 General, Rule, Hosts 등의 섹션이 있습니다. 이 가이드에서는 Rule의 일치 조건과 정책에만 초점을 맞추며, 처음 연결할 때 모든 섹션을 수정할 필요는 없습니다.
규칙은 순서대로 확인하며, 일반적으로 범위가 넓은 규칙보다 구체적인 규칙을 앞에 둡니다. 아래는 정책의 의미를 설명하는 구문 예시이며, 기존 파일을 그대로 대체할 수 있는 완전한 구성은 아닙니다. 여기의 PROXY는 실제 구성의 정책에 맞춰야 합니다. 기존 파일을 먼저 살펴보고 내용을 이해한 뒤 편집하며, 변경 전에는 원본 파일을 보관하세요.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-SUFFIX,ad.example.com,REJECT
FINAL,PROXY
PROXY는 해당 프록시 정책을 사용한다는 뜻입니다. DIRECT는 직접 연결 경로를 사용하고, REJECT는 요청을 거부합니다. FINAL은 앞선 규칙에 일치하지 않을 때 적용하는 최종 정책입니다. 화면의 Proxy 모드와 규칙 정책 PROXY는 서로 다른 기능입니다. 모드를 선택했다고 Rule이 변경된 것은 아닙니다.
Proxy 및 Direct: 결과 비교에 사용
Proxy는 선택한 서버의 프록시 경로를 확인할 때 사용할 수 있어, 이번 점검에서 일반 규칙 분기의 영향을 줄여 줍니다. 다만 기기의 모든 시스템 트래픽이 반드시 같은 경로를 사용한다는 뜻은 아닙니다. Direct는 로컬 네트워크와 비교할 때 사용하며, 연결 스위치가 켜져 있다고 선택한 서버를 자동으로 사용하는 것은 아닙니다.
Proxy에서 대상 페이지에 접속되지만 Config에서 실패한다면 현재 구성과 일치한 규칙을 확인합니다. Direct에서도 로컬 네트워크 접속이 정상적이지 않다면 먼저 Wi-Fi 또는 셀룰러 네트워크를 복구하세요. 규칙의 의미를 아직 이해하지 못했다면 기존 값을 유지하고, 구성 관리 방법은 초보자부터 고급 사용자까지 보는 공식 가이드에서 확인하세요.
STEP 03 / CONNECT
Home: 연결 스위치 켜기
선택한 항목과 모드를 먼저 확인한 다음 연결을 승인합니다. 시스템 권한과 서버 사용 가능 여부는 별개의 문제입니다.
Home으로 돌아가 SERVER 그룹에서 올바른 항목이 선택되어 있는지 확인한 다음 Global Routing이 앞 단계에서 선택한 모드로 유지되어 있는지 봅니다. 방금 구독을 업데이트했다면 기존 항목이 달라졌을 수 있으므로 이전 선택만 믿고 테스트하지 마세요. 확인한 뒤 상단의 Not Connected 옆에 있는 연결 스위치를 켭니다.
처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 묻습니다. 안내가 이번 Shadowrocket 작업에서 표시되었는지 확인한 뒤 허용하고, 기기의 안내에 따라 암호 또는 생체 인증을 완료합니다. 이 과정은 기기에서 네트워크 사용 권한을 설정하는 것이며 서버 정보를 생성하거나 원격 인증이 완료되었음을 의미하지는 않습니다. 권한을 취소했다면 Home으로 돌아가 스위치를 다시 켜고 시스템 안내를 따릅니다.
권한을 승인한 뒤 Home으로 돌아가 상단 상태가 Not Connected에서 연결 상태로 바뀌는지 확인합니다. 스위치가 바로 꺼지면 먼저 시스템 권한이 완료되었는지 확인하고 현재 서버 항목에 필요한 정보가 모두 있는지 점검합니다. 이때 스위치를 빠르게 반복해서 켜고 끄거나 구독을 다시 만들고 DNS와 모드를 동시에 바꾸지 마세요. 안정적인 상태를 유지해야 실패한 단계를 구분할 수 있습니다.
상태가 안정되면 Home에서 Connectivity Test를 실행합니다. 현재 테스트 설정에 따른 연결 상태를 확인하는 기능이며 모든 웹페이지, 프로토콜 및 분기 경로를 일괄적으로 보장하지는 않습니다. 테스트 결과를 확인한 뒤 다음 단계에서 실제 접속도 검증해야 합니다. 상단 연결 상태만으로 대상 요청이 예상한 프록시 경로를 사용했다고 판단할 수 없습니다.
STEP 04 / VERIFY
적용 여부 확인: 실제 접속과 Data 비교
새로 보낸 요청을 기준으로 대상 페이지와 규칙 결과를 함께 확인합니다. 단일 테스트 값을 전체 결과로 간주하지 마세요.
평소 정상적으로 접속할 수 있는 페이지를 먼저 선택해 기본 네트워크를 확인한 뒤 이번에 확인할 대상 페이지를 엽니다. 필요한 경우 페이지를 새로고침하거나 새 페이지를 열어 브라우저 캐시의 이전 내용이 성공한 요청처럼 보이지 않게 합니다. 기본 네트워크는 작동하지만 대상 페이지에 실패하면 당시 서버, Global Routing 및 증상을 기록한 뒤 Data에서 새로 생성된 요청을 확인합니다.
Data에서 요청 시간과 대상 도메인으로 기록을 찾습니다. 현재 상세 화면에 일치 규칙, 정책 또는 연결 정보가 표시된다면 예상 경로와 비교합니다. Config에서 특정 요청이 DIRECT로 처리되는 것은 규칙의 의도일 수 있으며 연결 스위치가 작동하지 않는다는 뜻은 아닙니다. REJECT가 표시되면 서버를 바로 바꾸기보다 먼저 일치한 규칙을 확인하세요.
대상 요청이 PROXY를 사용해야 한다면 일치한 정책이 올바른지, 해당 정책에서 예상한 서버를 사용하는지 확인합니다. DIRECT를 사용해야 한다면 대상이 원래 로컬 네트워크에서 처리되어야 하는지 비교합니다. 웹페이지에는 여러 도메인이 포함되는 경우가 많습니다. 기본 페이지가 열리지 않는 문제는 리소스 요청 중 하나 때문일 수 있으므로 주소 표시줄의 도메인만 찾지 말고 관련 기록을 확인하세요.
- 서버는 그대로 두고 Proxy와 Config 두 모드를 비교해 동일한 유형의 접속을 다시 시도합니다.
- 모드는 유지합니다. 본인이 보유한 다른 사용 가능한 항목이 있다면 서버를 바꾸어 비교합니다.
- 요청 대상, 모드, 결과 및 일치 정책을 매번 기록해 서로 다른 시간의 결과가 섞이지 않도록 합니다.
Proxy에서는 접속되지만 Config에서는 접속되지 않는다면 먼저 Config에서 규칙과 최종 정책을 확인합니다. 두 모드 모두 실패하지만 Direct에서 기본 접속이 정상이라면 서버 매개변수와 원격 상태를 우선 확인합니다. 규칙이 올바르게 적용되는 것을 확인한 다음 일상 사용에 적합한 Config로 돌아가 다른 경로가 필요한 두 번째 대상도 같은 방식으로 확인합니다.
이 단계의 완료 기준은 특정 지연 시간 값이 아닙니다. 연결 상태가 안정적이고 실제 대상에 접속할 수 있으며, 확인 가능한 요청 경로가 구성의 예상과 일치하는지가 기준입니다. Home, Config, Data의 역할을 더 알아보려면 인터페이스 영어 용어 안내를 확인하세요.
STEP 05 / CHECK
Settings: 실패 단계별 점검
기존 구성을 보존하고 한 번에 한 항목만 변경하세요. 기본 연결을 먼저 확인한 다음 매개변수, 모드 및 규칙을 점검합니다.
가져오기 실패 또는 목록이 비어 있음
먼저 구독 링크의 문자가 누락되지 않았는지, 단일 서버 공유 링크를 Subscribe에 입력하지 않았는지 확인합니다. 현재 네트워크에서 구독 정보를 가져올 수 있는지 확인하고 앱이 표시한 업데이트 결과를 살펴봅니다. 서버 목록이 비어 있다고 해서 클라이언트를 구매하지 않았다는 뜻은 아니며, 같은 항목을 반복해서 추가해도 해결되지 않습니다. 구독 유효성이나 서버 정보가 변경된 경우 본인이 보유한 정보의 출처를 확인하세요.
스위치는 켜졌지만 접속되지 않음
프록시를 사용하지 않을 때 기본 네트워크가 정상인지 확인합니다. 웹페이지 인증이 필요한 Wi-Fi라면 먼저 네트워크 자체의 인증을 완료하세요. 그런 다음 선택한 서버의 Host, Port, 인증 정보 및 전송 설정을 확인하고 복사할 때 생긴 공백에 특히 주의합니다. 특정 서버 항목에서만 문제가 생긴다면 모든 구성을 바꾸지 말고 해당 항목부터 수정하세요.
다음으로 두 번째 단계에 따라 Global Routing을 비교합니다. Config는 실패하지만 Proxy에서 작동한다면 현재 사용 중인 파일, 규칙 순서 및 FINAL을 확인합니다. 두 모드가 모두 실패하면 원격 연결과 인증을 점검합니다. 도메인이 확인되지 않는다면 기존 DNS 설정과 관련 진단 정보를 확인하세요. 원인을 가릴 수 있으므로 낯선 DNS 설정 여러 개를 한꺼번에 붙여 넣지 마세요.
테스트는 실패했지만 웹페이지는 열림
Settings에서 Test Method를 확인합니다. 테스트 방식과 실제 웹페이지 접속 경로는 다를 수 있으므로 Connectivity Test 실패만으로 모든 접속이 실패했다고 단정할 수 없습니다. 반대로 테스트에 성공해도 특정 대상에 접속할 수 있다고 보장되지는 않습니다. 테스트 결과, 실제 페이지 결과 및 Data의 기록을 함께 판단하세요. 필요한 경우 테스트 방식은 그대로 두고 서버나 모드 하나만 비교합니다.
연결을 끈 뒤 다시 연결되거나 일부 요청만 비정상임
Settings에서 On Demand에 현재 네트워크에 맞는 자동 연결 조건이 설정되어 있는지 확인합니다. 수동 비교를 마치려면 기존 설정을 기록한 뒤 관련 조건을 일시적으로 비활성화할 수 있습니다. 확인을 마친 뒤 필요한 설정을 복원하세요. 일부 요청만 비정상이라면 관련 규칙과 전송 요구 사항을 먼저 확인하고 Settings의 Proxy, TCP, UDP 항목을 모두 수정하지 마세요.
추가 정보가 필요하면 Diagnostics를 사용해 앱이 제공하는 결과에 따라 원인을 좁혀갑니다. 스크린샷이나 로그를 공유하기 전에 전체 구독 주소, Password, 인증 정보 및 개인 접속 기록을 삭제하고 필요한 오류 내용만 남깁니다. 다른 문제 해결 방법은 문제 해결을 참조하세요. 스위치가 켜져 있지만 접속되지 않는 경우의 자세한 순서는 연결 후 인터넷에 접속할 수 없을 때의 점검 목록에서 확인할 수 있습니다.
완료 후: 정상 상태 유지
선택한 서버, 현재 구성 및 규칙 결과가 일치하는지 확인한 다음 일상적인 관리를 진행합니다.
검증을 마친 구성을 보관하고, 구독을 업데이트한 뒤 기존 서버가 계속 있는지 확인합니다. 이후 문제가 생기면 같은 대상과 모드로 다시 확인한 다음 정보 확인, 네트워크 변경 또는 규칙 조정 중 무엇이 필요한지 판단합니다. 구독 자동 업데이트와 구성 파일 전체 교체는 같은 작업이 아닙니다. 후자는 DNS, Rule 및 기타 설정을 한꺼번에 변경할 수 있으므로 다시 검증해야 합니다.
이 가이드에서는 처음 사용하는 데 필요한 단계를 마쳤습니다. 권한, Data, Settings 및 장기적인 관리 방법의 관계를 알아보려면 초보자부터 고급 사용자까지 보는 가이드를 계속 읽으세요. 처음 연결할 때 모든 기능을 한꺼번에 설정할 필요는 없습니다.