공식 매뉴얼 · 빠른 시작

Shadowrocket구독 가져오기 및 연결 단계

“추가 → 모드 선택 → 연결 → 확인” 순서로 첫 설정을 진행합니다. 각 단계의 결과를 확인한 뒤 다음 단계로 넘어가세요. 문제가 발생해도 모든 설정을 다시 바꿀 필요는 없습니다.

읽는 순서: 구독 링크가 있으면 Subscribe부터 시작합니다. 단일 서버 매개변수만 있으면 Add Server를 확인하고, 가져오기를 마쳤다면 Global Routing으로 이동하세요.

STEP 01 · 기존 정보 추가

Subscribe 가져오기 및 Add Server

먼저 보유한 정보가 구독 링크인지 단일 서버 연결 매개변수인지 구분합니다. 구독은 보통 서비스 제공업체가 관리하는 서버 모음이며, 업데이트에 따라 목록이 달라질 수 있습니다. 단일 서버 정보는 항목별로 저장해야 합니다. 같은 작업을 두 방식으로 반복하지 마세요. 동일 서버의 기록이 여러 개 생기면 나중에 테스트할 때 구분하기 어렵습니다.

Subscribe로 구독 링크 가져오기

Home으로 이동해 Add Server 또는 오른쪽 위의 추가 버튼을 눌러 Add Server 페이지를 엽니다. Type을 누르고 Subscribe를 선택한 뒤 URL에 서비스 제공업체에서 받은 전체 링크를 붙여 넣습니다. Remark에는 구분하기 쉬운 이름을 입력합니다. 계정 비밀번호는 입력하지 않아도 됩니다. 확인한 다음 페이지의 저장 버튼으로 Home에 돌아와 구독 가져오기가 완료될 때까지 기다립니다.

링크는 처음부터 끝까지 빠짐없이 복사하고, 특히 쿼리 매개변수의 문자를 주의하세요. 서비스 제공업체의 웹페이지 주소나 안내 문구, 줄바꿈을 URL에 함께 붙여 넣지 마세요. 아래는 형식 예시일 뿐 연결에 사용할 수 없으며 브라우저에서 열 필요도 없습니다.

https://example.com/sub?token=xxxx

저장한 뒤 SERVER 그룹에서 구독 아래에 서버 기록이 표시되는지 확인합니다. 구독 이름만 있고 서버가 없다면 가져오기가 완료된 것이 아닙니다. 먼저 가져오기 오류가 표시되는지 확인한 다음 서비스 제공업체에 링크의 유효성과 필요한 구독 형식을 문의하세요. 링크를 성공적으로 가져오기 전에는 Global Routing을 반복해서 바꾸지 마세요. 라우팅 모드로 구독 다운로드 문제를 해결할 수 없습니다.

Add Server로 단일 서버 입력하기

단일 서버 매개변수를 받았다면 Type에서 제공된 정보와 일치하는 프로토콜을 선택하고 Host, Port 및 해당 프로토콜에 필요한 인증 정보를 입력합니다. 스크린샷의 Password와 Method는 현재 선택한 유형에 해당합니다. VMess, VLESS 또는 Trojan으로 전환하면 입력 항목이 달라질 수 있습니다. 스크린샷과 입력 양식을 맞추려고 프로토콜을 변경하지 마세요. 주소, 포트, 비밀번호 및 기타 매개변수는 서비스 제공업체가 제공한 정보를 따라야 합니다.

입력이 끝나면 다시 확인합니다. Host에 안내 문구가 섞이지 않았는지, Port가 서버에서 받은 포트와 일치하는지, 비밀번호 앞뒤에 공백이 없는지 살펴보세요. 정보에 TLS, 서버 이름 또는 전송 매개변수가 포함되어 있다면 원래 값대로 입력합니다. 필수 항목이 빠졌다면 값을 추측해 저장하지 말고 먼저 정보를 확인하세요.

Scan QR Code로 추가

서버 QR 코드가 있다면 Scan QR Code로 읽고, 시스템에서 요청할 때 카메라 권한을 허용합니다. 스캔한 뒤에도 인식된 Type, Host, Port를 확인하고 서버 기록을 저장하세요. QR 코드에는 전체 인증 정보가 포함될 수 있으므로 공개적으로 공유하지 않는 것이 좋습니다. Import from Cloud JSON은 다른 가져오기 방법입니다. 형식이 일치하는 정보를 보유한 경우에만 사용하고, 일반 구독 URL을 임의로 입력하지 마세요.

이 단계의 완료 기준: Home의 SERVER 그룹에 선택 가능한 서버가 표시됩니다. 다음으로 트래픽 처리 방식을 확인한 뒤 연결 스위치를 켭니다.

Shadowrocket의 Add Server 페이지. Type, Host, Port, Password, Method 및 Scan QR Code 등의 항목이 표시됩니다
Add Server: Type에 따라 필요한 항목을 입력합니다. 스크린샷의 항목이 모든 프로토콜에 동일하게 필요한 것은 아닙니다.

STEP 02 · 트래픽 처리 방식 확인

Global Routing의 세 가지 모드

Global Routing은 요청을 처리할 방식을 정하고, 서버 목록은 프록시 요청에 사용할 서버를 정합니다. 두 설정은 서로 다릅니다. Home으로 돌아가 Global Routing을 눌러 현재 선택을 확인합니다. 평소 규칙에 따라 트래픽을 분기하려면 구성(Config)을 사용하고 Config에서 현재 구성 파일도 확인하세요.

구성(Config): 규칙에 따라 판단

구성(Config)은 현재 구성 파일에 따라 요청을 처리합니다. Config로 이동해 예상한 파일을 사용 중인지 확인한 다음 내용을 살펴봅니다. 공식 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 서로 다른 설정 구역입니다. 처음 사용하는 경우에는 Rule을 중점적으로 확인하세요. 연결을 완료하기 위해 다른 구역을 함께 변경하거나 HTTPS Decryption을 활성화할 필요는 없습니다.

Rule의 규칙은 보통 순서대로 일치 여부를 확인하고, 일치하면 해당 정책을 실행합니다. 아래 예시는 example.com과 하위 도메인에 PROXY를 적용하고 마지막 줄에서 앞서 일치하지 않은 요청을 처리합니다. 문법 설명용 조각이며 기존 전체 구성 파일을 그대로 대체할 수 없습니다. 실제 구성에는 해당 정책과 기타 필수 내용도 필요합니다.

DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY

PROXY, DIRECT, REJECT는 서로 다른 처리 정책을 뜻하며 서버 주소가 아닙니다. 규칙을 추가할 때 대상 정책이 구성 파일에 유효하게 정의되어 있는지, 규칙 위치가 적절한지 확인하세요. Add Rule로 규칙을 추가해도 해당 요청을 이미 처리하는 규칙 뒤에 놓이면 일치할 기회가 없을 수 있습니다. 기존 규칙을 먼저 파악한 뒤 필요한 범위만 최소한으로 수정하세요.

프록시(Proxy)와 직접 연결(Direct): 비교 확인에 사용

프록시(Proxy)는 이 모드에 따라 요청을 프록시로 처리하며, 선택한 서버가 사용 가능한지 임시로 확인할 때 적합합니다. 직접 연결(Direct)은 직접 연결 상태를 비교하기 위한 것으로, 프록시를 통과했다는 뜻은 아닙니다. Proxy에서 접속은 정상인데 Config에서 특정 페이지만 문제가 있다면 서버를 바로 삭제하지 말고 규칙과 정책을 먼저 확인하세요. 테스트가 끝나면 평소 필요한 모드로 돌아가 임시 선택을 잊지 않도록 합니다.

이 단계의 완료 기준: 현재 선택이 구성(Config), 프록시(Proxy), 직접 연결(Direct) 중 무엇인지 설명할 수 있고 Config에서 사용하는 파일도 알고 있어야 합니다. 규칙에 대한 자세한 설명은 Rule 분기 안내를 참고하세요. 복잡한 문제가 있으면 문제 해결로 이동하고, 이 페이지에서는 첫 연결을 계속 진행합니다.

Shadowrocket의 Config 구성 파일 편집 페이지. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시됩니다
Config: 구성 내용을 확인하는 화면입니다. Global Routing 모드 선택은 이 구성 편집 페이지가 아닌 Home에 있습니다.

STEP 03 · 연결 및 시스템 승인

Home에서 서버 선택 및 연결

Home으로 돌아가 SERVER 그룹에서 기존 서버 하나를 선택하고 선택 표시가 원하는 기록에 있는지 확인합니다. 구독 그룹이 여러 개라면 그룹 이름을 먼저 확인해 이전에 가져온 오래된 기록을 선택하지 않도록 합니다. 첫 테스트에서는 서버 하나만 사용하고 자주 바꾸지 마세요. 그래야 테스트 결과를 특정 설정과 연결해 확인하기 쉽습니다.

Global Routing을 다시 확인한 뒤 Home 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성 추가를 허용할지 묻습니다. 안내를 읽고 허용한 다음 기기 요구에 따라 암호 또는 인증을 완료하세요. 이 단계는 시스템에 연결에 필요한 구성을 만드는 과정이며 서버를 가져오거나 구독 정보를 자동으로 채우지는 않습니다.

승인한 뒤 Shadowrocket으로 돌아와 상단에 Not Connected가 계속 표시되는지, 스위치가 켜진 상태로 유지되는지 확인합니다. 연결되지 않는다면 권한 또는 구성 오류 안내가 있는지 먼저 살펴보고, 시스템 상태 표시줄의 VPN 표시만으로 판단하지 마세요. 이전에 승인을 거부했다면 연결을 다시 시작해 시스템 안내를 완료합니다. 안내가 다시 표시되지 않는다면 시스템 설정의 VPN 항목에서 구성 상태를 확인할 수 있습니다.

기기에서 터널을 설정 중인 다른 네트워크 도구가 있다면 해당 연결을 먼저 종료한 뒤 Shadowrocket만 테스트하세요. 회사나 학교에서 관리하는 기기는 VPN 구성이 제한될 수 있습니다. 관리 제한이 발생하면 기기 관리자에게 문의하고 시스템 관리 항목을 반복해서 삭제하지 마세요. 기존 VPN 구성을 삭제하기 전에는 어떤 서비스에 속하는지 확인해야 합니다.

연결 스위치가 켜져 있다는 것은 시스템 연결 절차가 진행되었다는 뜻일 뿐, 선택한 서버가 사용 가능하다는 의미는 아닙니다. 연결 상태, 서버 도달 가능성, 대상 페이지 접속 여부는 각각 확인해야 합니다. 다음 단계에서 Connectivity Test를 사용하고 실제 접속으로 확인하세요. “스위치가 켜졌다”는 상태에서 멈추지 마세요.

이 단계의 완료 기준: 서버를 선택하고 필요한 승인을 완료했으며 Home의 연결 상태가 연결 안 됨으로 표시되지 않아야 합니다. 스위치가 바로 꺼진다면 이 페이지의 문제 해결을 확인하세요.

Shadowrocket의 Home 페이지. 상단에 Not Connected, Global Routing, Connectivity Test가 표시되고 아래에 SERVER 그룹과 Add Server가 있습니다
Home: 연결 스위치, Global Routing 및 Connectivity Test의 위치를 확인합니다. 스크린샷의 Not Connected는 화면에 표시된 상태이며 현재 작업 결과가 아닙니다.

STEP 04 · 실제 결과 확인

Connectivity Test 및 작동 확인

먼저 Home에서 Connectivity Test를 실행해 이번 테스트가 완료되는지 확인합니다. 테스트 결과는 현재 테스트 방법과 대상에 따른 도달 가능성을 보여줄 뿐, 모든 웹사이트에 접속할 수 있다는 뜻은 아니며 특정 수치만으로 실제 브라우징 속도를 판단할 수도 없습니다. 테스트가 시간 초과되면 사용 중인 서버, Global Routing 및 네트워크 환경을 기록하고 다른 조건은 유지한 채 비교하세요.

그런 다음 브라우저로 전환해 평소 사용하며 접근 권한이 있는 페이지를 열고 본문, 이미지 및 필요한 기능이 정상인지 확인합니다. 이미 캐시된 페이지 하나만 여는 것으로는 현재 연결을 확인하기 어렵습니다. 페이지를 새로고침하거나 정상적으로 이용할 수 있는 다른 페이지를 열어 다시 테스트하세요. 브라우저에서는 작동하지만 특정 앱에서는 작동하지 않는다면 해당 앱, 대상 도메인 및 규칙으로 문제 범위를 좁히세요. 전체 연결이 실패했다고 바로 판단하지 마세요.

“접속 가능”과 “예상대로 분기”를 따로 확인

구성(Config)을 사용하는 경우 페이지가 정상적으로 열려도 DIRECT 규칙이 적용된 것일 수 있습니다. 분기를 확인하려면 현재 Config에서 해당 도메인에 적용되는 규칙과 앱의 연결 기록을 함께 살펴 실제 정책을 확인하고 선택한 서버도 점검합니다. 모든 요청이 프록시를 통과한다는 것을 증명하려고 정상 작동 중인 직접 연결 규칙을 모두 삭제하지 마세요. 분기에서는 서로 다른 요청이 서로 다른 경로를 사용할 수 있습니다.

Config에서 결과가 비정상적이면 프록시(Proxy)로 잠시 전환한 뒤 동일한 서버와 테스트 대상을 사용해 다시 확인할 수 있습니다. Proxy에서는 정상이고 Config에서 문제가 발생한다면 규칙 일치, 정책 참조 및 관련 구성을 확인하는 것이 좋습니다. 두 모드 모두 문제가 있다면 서버 매개변수와 기본 네트워크부터 점검하세요. 직접 연결(Direct)로 전환하면 기본 접속 상태를 비교할 수 있습니다. 비교가 끝나면 원래 모드로 되돌립니다.

이 단계의 완료 기준: 실제 접속이 예상대로 작동하고 현재 요청에 규칙 또는 임시 프록시 모드 중 무엇이 적용되는지 설명할 수 있어야 합니다. 완료 후 정상 설정을 유지하세요. 문제 해결을 위해 임시로 바꾼 모드, 테스트 방법 또는 규칙을 불분명한 상태로 남겨두지 마세요.

STEP 05 · 실패한 단계에 따라 문제 해결

일반적인 오류와 Settings 확인

가장 먼저 실패한 단계부터 확인합니다. 구독을 가져오지 못했다면 구독 문제부터 해결하고, 스위치가 켜진 상태로 유지되지 않으면 승인 문제부터 살펴보세요. 일부 페이지에서만 문제가 있다면 규칙과 대상을 확인합니다. 아래 절차는 처음 설정할 때 자주 발생하는 문제를 다룹니다. 지속적인 DNS 오류, 배터리 소모 또는 업데이트 이후 문제가 발생했다면 문제 해결 전체 안내에서 계속 확인하세요.

구독은 저장했지만 SERVER에 기록이 없음

구독 편집 화면으로 돌아가 URL을 확인하고 매개변수가 빠지거나 공백이 섞이지 않았는지, 서비스 제공업체의 웹페이지 주소를 복사하지 않았는지 살펴보세요. 기기의 현재 네트워크가 정상적으로 작동하는지도 확인합니다. 구독 가져오기 실패와 서버 연결 실패는 서로 다른 단계입니다. 전자의 문제를 임의로 Host나 Port를 바꿔 해결하려고 하지 마세요. 링크가 만료되었거나 응답 형식이 맞지 않으면 서비스 제공업체에서 유효한 링크를 받은 뒤 다시 업데이트합니다. 전체 URL을 공개하지 마세요.

연결 스위치가 꺼지거나 시스템에서 권한 문제를 안내함

먼저 Home으로 돌아가 한 번 다시 시도하면서 시스템이 VPN 구성 추가 승인을 기다리는지 확인합니다. 그런 다음 시스템 VPN 설정에 충돌이나 기기 관리 제한이 있는지 살펴보세요. 실수로 권한을 거부했다면 승인 절차를 다시 진행하면 됩니다. 처음부터 앱을 다시 설치할 필요는 없습니다. 재설치가 꼭 필요하다면 문제 해결 중 서버 정보와 구성을 잃지 않도록 먼저 안전하게 보관하세요.

스위치는 켜졌지만 Connectivity Test가 시간 초과됨

현재 선택한 서버가 여전히 유효한지 확인한 다음 원본 정보와 Type, Host, Port, 인증 및 TLS 매개변수를 비교합니다. 그런 다음 서버는 그대로 두고 정상적으로 작동하는 다른 기본 네트워크를 사용해 네트워크 환경과 서버 자체 중 어디에 문제가 있는지 구분합니다. Settings의 Test Method는 테스트 방식에 영향을 주므로 서로 다른 방식의 결과를 직접 비교해서는 안 됩니다. 테스트 실패 여부는 실제 접속 결과와 함께 판단하세요.

일부 페이지만 비정상이거나 규칙이 예상대로 적용되지 않음

먼저 Global Routing이 실제로 구성(Config)인지 확인한 다음 현재 구성 파일을 확인합니다. 대상이 더 앞에 있는 DOMAIN, DOMAIN-SUFFIX, IP-CIDR 등의 규칙에 의해 처리되는지와 최종 정책을 살펴보세요. 페이지의 주요 텍스트는 정상인데 일부 리소스만 실패한다면 해당 리소스가 다른 도메인을 사용할 수 있습니다. 연결 기록을 바탕으로 찾아보세요. 브라우저 주소 표시줄의 도메인 하나만 보고 모든 요청을 판단하지 마세요.

On Demand 및 Diagnostics 확인 방법

Settings의 On Demand는 설정한 조건에 따라 연결을 시작합니다. 수동 연결이 정상인지 확인하기 전에는 트리거 조건을 단순하게 유지하고 기본 테스트 대신 자동 연결에 의존하지 마세요. 예상치 않게 자동 재연결된다면 On Demand 조건을 확인합니다. Diagnostics는 추가 단서를 수집하는 데 사용할 수 있지만 Proxy, TCP, UDP 등의 설정을 보고 하나씩 무작정 바꾸지 마세요. 원래 값을 유지하고 확인된 증상에 필요한 설정만 조정합니다.

서비스 제공업체에 문제를 설명할 때는 실패한 단계, 오류 안내 및 이미 진행한 비교 테스트를 전달하면 됩니다. 진단 기록, QR 코드 및 구독 URL에는 서버 주소, 인증 정보 또는 개인 접속 기록이 포함될 수 있으므로 공유 전에 민감한 내용을 숨기세요. 전체 인증 정보가 담긴 스크린샷을 공개적인 문의 자료로 올리지 마세요.

문제 해결을 마친 뒤: Global Routing을 평소 사용하는 모드로 복원하고 작동 확인을 다시 진행합니다. 문제가 계속되면 재현 가능한 최소 조건을 기록하고 상세 문서에서 증상에 따라 계속 확인하세요. 가져오기 단계부터 전부 다시 진행할 필요는 없습니다.

Shadowrocket의 Settings 페이지. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP가 표시됩니다
Settings: 문제를 확인할 때는 Test Method, On Demand 및 Diagnostics를 중점적으로 살펴보세요. 모든 설정을 동시에 조정할 필요는 없습니다.