공식 핸드북 · 처음 사용하기

Shadowrocket 빠른 시작 구독 가져오기와 첫 연결

화면 순서에 따라 다섯 단계를 진행하세요. 먼저 Home에 서버 정보를 준비하고, Global Routing을 선택한 다음 연결을 켜고, 마지막으로 요청을 확인합니다. 먼저 같은 조건에서 재현 가능한 연결을 완료한 뒤 세부 설정을 조정하세요.

정보를 확인한 뒤 저장 서버를 선택한 뒤 연결 한 번에 한 항목만 변경

STEP 01 · Home → Add Server

서버 추가 또는 Subscribe 가져오기

구독 링크, 개별 서버 매개변수, QR 코드는 서로 다른 형식의 정보입니다. 먼저 보유한 정보가 무엇인지 확인한 다음 해당하는 메뉴를 선택하세요.

Shadowrocket을 열고 Home으로 이동한 다음 서버 영역에서 Add Server를 찾아 여세요. 추가 화면에서 Type을 선택하면 입력해야 할 항목이 결정됩니다. 구독 주소를 개별 서버의 Host에 입력하거나 주소 모양만 보고 프로토콜을 추측하지 마세요. 먼저 서비스 제공업체의 안내에서 업데이트 가능한 구독 링크인지, 개별 서버의 전체 연결 매개변수인지 확인하세요. 두 방식 모두 Home에 항목을 추가하지만 이후 업데이트 및 확인 방법은 다릅니다.

구독 링크가 있는 경우: Subscribe 사용

Add Server에서 Type을 열고 Subscribe를 선택한 뒤 서비스 제공업체에서 받은 전체 구독 링크를 URL에 붙여 넣으세요. 메모 항목이 있으면 출처를 알아보기 쉬운 이름을 입력할 수 있습니다. 붙여 넣은 뒤 주소의 처음과 끝을 확인하고, 메시지에 포함된 설명 문구나 공백, 줄바꿈이 섞이지 않았는지 살펴보세요. 주소의 쿼리 매개변수는 임의로 삭제하지 마세요. 서비스 제공업체가 구독을 식별하는 데 필요한 정보일 수 있습니다.

확인한 뒤 저장하고 Home으로 돌아와 구독 정보를 불러올 때까지 기다린 다음 해당 그룹에 서버 항목이 표시되는지 확인하세요. 구독 항목을 저장했다고 해서 사용할 수 있는 서버까지 불러온 것은 아닙니다. 그룹이 비어 있거나 오류가 표시되면 링크가 온전한지, 구독이 유효한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 먼저 확인하세요. 같은 링크를 반복해서 추가하지 마세요. 하나만 남겨 두고 서비스 제공업체의 안내에 따라 다시 불러와 중복 그룹이 생기지 않도록 하세요.

개별 서버 매개변수가 있는 경우: Type에 맞춰 입력

서버 주소, 포트, 비밀번호, 프로토콜 정보를 받았다면 Type에서 실제 프로토콜을 선택한 뒤 Host, Port와 해당 유형에서 요구하는 인증 정보를 입력하세요. 스크린샷에는 Password와 Method가 있는 추가 화면이 표시되지만 Type에 따라 입력 항목은 다릅니다. Shadowsocks, VMess, VLESS, Trojan, WireGuard 등의 유형에 필요한 정보는 서비스 제공업체가 제공한 매개변수와 앱의 현재 화면을 기준으로 확인하세요. 한 유형의 입력 항목을 다른 유형에 그대로 적용하면 안 됩니다.

입력할 때 주소에 공백이 들어가지 않았는지, 포트를 잘못 옮겨 적지 않았는지, 비밀번호의 대소문자가 유지되었는지 확인하세요. 추가 전송 또는 보안 매개변수가 필요하다면 해당 값도 빠짐없이 확인합니다. 항목의 의미가 불분명하면 저장하기 전에 서비스 제공업체에 문의하세요. 임의로 매개변수를 추가하면 항목이 완성된 것처럼 보여도 연결되지 않을 수 있습니다.

QR 코드가 있는 경우: Scan QR Code 사용

서버 QR 코드가 있으면 Scan QR Code를 사용하고, 시스템 메시지가 표시되면 필요한 카메라 접근을 허용하세요. 인식이 완료되어도 저장하기 전에 Type, 주소, 포트를 확인하세요. QR 코드를 인식할 수 있다는 사실만으로 서버를 현재 사용할 수 있다고 볼 수는 없습니다. Import from Cloud JSON은 별도의 가져오기 메뉴이며 일반 구독 링크를 대신 입력하는 곳이 아닙니다. 해당 형식의 정보를 이미 보유하고 있고 용도를 알고 있을 때만 사용하세요.

이 단계의 완료 기준은 Home에서 사용할 서버를 찾을 수 있고, 세부 정보에서 출처를 확인할 수 있는 것입니다. DNS나 다른 Settings를 서둘러 바꾸지 마세요. 다음 단계에서 요청을 처리할 Global Routing 방식을 선택합니다.

Shadowrocket Add Server 화면: Type, Host, Port, Password, Method 및 Scan QR Code 메뉴 표시
Add Server: 먼저 Type을 선택하고 해당 유형에서 필요한 항목을 입력하세요. 스크린샷에 보이는 항목이 모든 프로토콜에 공통으로 적용되는 것은 아닙니다.

STEP 02 · Home → Global Routing

Global Routing 선택 및 Config 확인

서버 추가는 ‘어떤 서버를 사용할지’를 정하고, Global Routing은 ‘요청을 어떤 방식으로 처리할지’를 결정합니다. 두 항목을 각각 확인해야 합니다.

Home으로 돌아가 Global Routing을 여세요. 처음 사용할 때는 세 가지 모드인 Config, Proxy, Direct를 구분하세요. 이 메뉴에서 선택을 바꿔도 서버 매개변수가 자동으로 입력되거나 만료된 구독이 복구되지는 않습니다. 전환하기 전에 현재 선택을 기억해 두면 테스트 후 원래대로 되돌리기 쉽고, 모드 변경을 서버 변경으로 착각하지 않을 수 있습니다.

Config: 현재 구성 파일의 규칙에 따라 처리

Config를 선택하면 현재 활성화된 구성 파일에 따라 요청을 처리합니다. 하단의 Config로 이동해 실제로 활성화된 파일을 확인한 다음 그 안의 Rule을 살펴보세요. 규칙에 따라 요청을 PROXY, DIRECT, REJECT 등의 정책으로 보낼 수 있으므로 같은 연결에서도 사이트별 처리 경로가 다를 수 있습니다. VPN 상태가 표시된다고 해서 모든 요청이 현재 서버를 사용하는 것은 아닙니다.

공식 스크린샷은 구성 파일 편집 화면으로 General, Rule, Hosts, URL Rewrite, HTTPS Decryption, Add Rule을 보여줍니다. 메뉴 위치를 확인하기 위한 참고 자료이며, 처음 사용할 때 각 항목을 모두 켜야 한다는 뜻은 아닙니다. 기존 구성의 구조를 유지하세요. 특히 연결 테스트를 한 번 하려고 HTTPS Decryption을 변경하지 마세요. 첫 연결 단계에는 필요하지 않습니다.

Proxy: 첫 확인 범위를 좁힐 때 사용

규칙 파일을 아직 준비하지 않았거나 선택한 서버가 요청을 처리할 수 있는지 먼저 확인하고 싶다면 Proxy를 잠시 선택해 테스트할 수 있습니다. 이 모드에서는 Shadowrocket이 처리하는 요청을 Proxy 방식으로 확인하므로 ‘서버 연결이 가능한지’와 ‘특정 규칙이 적용되는지’를 구분하기 쉽습니다. 그렇다고 성공이 보장되는 것은 아니며 기기의 모든 트래픽 경로가 반드시 이 방식으로 처리된다는 의미도 아닙니다. 다음 단계에서 연결과 실제 요청을 테스트해 결과를 확인하세요.

Direct: 서버 사용 가능 여부를 확인하는 방식이 아닙니다

Direct를 선택하면 해당 요청은 직접 연결 방식으로 처리됩니다. 이때 웹페이지가 정상적으로 열린다고 해서 추가한 서버에 연결할 수 있다는 뜻은 아닙니다. 서버를 선택한 상태에서 Direct를 유지해도 웹페이지 접속만으로 서버를 확인할 수 없습니다. 비교 테스트를 위해 잠시 선택했다면 완료 후 원래 모드로 되돌려 놓으세요.

규칙에 따라 요청을 라우팅하려면 일반적으로 Config로 돌아가 현재 파일의 정책이 용도에 맞는지 확인하세요. 처음 연결할 때 긴 규칙 목록을 작성할 필요는 없습니다. 모드, 파일, 현재 서버가 서로 어떻게 연결되는지 먼저 확인하세요. DNS, On Demand 및 기타 설정에 대한 자세한 내용은 Settings 설정 안내서를 읽어보세요. 이 페이지에서는 연결을 완료하며 전체 구성 관리 방법은 다루지 않습니다.

Shadowrocket Config 구성 파일 편집 화면: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config: 활성화된 파일을 확인한 뒤 Rule을 살펴보세요. 첫 연결을 위해 이미지에 보이는 모든 구간을 수정할 필요는 없습니다.

STEP 03 · Home → SERVER → 연결 스위치

서버를 선택하고 상단 스위치 켜기

먼저 사용할 항목을 선택한 다음 연결하세요. 처음 표시되는 VPN 구성 승인 요청은 시스템 절차이며 구독의 유효성과는 별개로 확인해야 합니다.

Home의 SERVER 목록에서 사용할 항목을 찾아 서버 이름 옆의 원형 표시를 탭해 현재 항목으로 설정하세요. 서버 세부 정보 화면에서 매개변수를 확인하는 것만으로는 현재 서버가 전환되지 않습니다. Home으로 돌아와 선택 표시가 원하는 항목에 있는지 확인하세요. 구독 그룹이 여러 개라면 출처도 확인해 이전 구독의 같은 이름 항목을 잘못 선택하지 않도록 합니다.

이어서 Global Routing이 앞 단계에서 선택한 모드로 유지되고 있는지 확인한 다음 Home 상단의 연결 스위치를 켜세요. 공식 스크린샷에는 연결되지 않은 상태에서 스위치 위치를 확인할 수 있도록 상단에 Not Connected가 표시되어 있습니다. 스크린샷이 기기의 현재 상태를 나타내는 것은 아닙니다. 연결 후에는 실제 화면의 문구와 시스템 상태를 기준으로 확인하세요. 화면의 모든 세부 사항이 스크린샷과 똑같을 필요는 없습니다.

처음 연결할 때 VPN 구성 추가 허용

처음 연결하면 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 메시지에 표시된 앱 이름을 확인한 뒤 시스템 안내에 따라 승인하세요. 기기 암호나 생체 인증을 요청할 수도 있습니다. 이때 사용하는 것은 기기의 시스템 인증이며, 서비스 제공업체의 비밀번호를 시스템 승인 창에 입력하는 것이 아닙니다. 이 단계를 허용하면 앱이 필요한 네트워크 구성을 만들 수 있습니다. 서버 매개변수나 연결 상태가 유효한지 확인하는 절차는 아닙니다.

이전에 승인을 취소했다면 Home으로 돌아가 연결을 다시 시도하고 시스템 메시지를 확인하세요. 기기가 조직에서 관리되거나 관련 제한이 있다면 기기 관리 규정을 따르고 출처를 알 수 없는 시스템 구성을 삭제하며 문제를 해결하려 하지 마세요. 승인한 뒤 앱으로 돌아와 상단 스위치가 켜진 상태로 유지되는지 확인하세요. 스위치가 곧바로 꺼지면 당시 표시된 메시지를 기록한 다음 아래 문제 해결 단계를 진행하세요.

상태가 바뀐 뒤에는 먼저 환경을 그대로 유지

연결이 설정되면 시스템에 VPN 상태 표시가 나타날 수 있지만 기기와 현재 화면에 따라 표시 방식은 다를 수 있습니다. 연결 상태는 구성이 활성화되었음을 나타낼 뿐, 원격 서버와 모든 대상에 대한 검증이 끝났다는 뜻은 아닙니다. 따라서 상태 표시만 확인하고 작업을 끝내거나 서버, 네트워크, 모드를 연이어 바꾸지 마세요. 현재 조합을 유지한 상태에서 다음 단계로 넘어가 Connectivity Test를 한 번 실행하고 실제 요청도 보내세요.

iPad에서도 Home의 목록, Global Routing, 상단 스위치를 사용해 같은 항목을 확인하세요. 화면 배치는 기기에 따라 다를 수 있습니다. 이 단계에서는 현재 서버, 현재 모드, 연결 스위치가 켜진 상태로 유지되는지 기록해야 합니다. 이 세 가지가 명확하면 테스트에 실패하더라도 처음부터 가져오기를 반복하지 않고 같은 조건으로 문제를 재현할 수 있습니다.

Shadowrocket Home 화면: 상단에 Not Connected 스위치, Global Routing, Connectivity Test가 있고 아래에 SERVER 및 Add Server가 표시됨
Home: SERVER에서 사용할 항목을 선택한 다음 상단 스위치를 사용하세요. Connectivity Test는 연결 후 추가 확인에 사용합니다.

STEP 04 · Home → Connectivity Test

테스트 결과와 실제 요청을 함께 확인

‘연결이 유지되는지’, ‘테스트 결과가 나오는지’, ‘실제 대상이 열리는지’를 각각 확인하세요. 아이콘이나 숫자 하나만으로 판단하지 마세요.

방금 선택한 서버, 네트워크, Global Routing을 그대로 유지한 채 Home에서 Connectivity Test를 탭하세요. 테스트가 완료될 때까지 기다리고 화면에 표시된 결과를 기록하세요. 실패하면 모든 경우를 ‘연결 안 됨’으로 뭉뚱그리지 말고 구체적인 메시지를 기록합니다. 테스트 대상, 현재 라우팅 방식, 네트워크 환경이 결과에 영향을 줄 수 있습니다. 특히 Config에서는 규칙에 따라 테스트 요청이 처리되는 경로를 함께 확인하세요. 테스트가 성공했다고 해서 모든 요청이 Proxy를 통과한다고 판단할 수는 없습니다.

이어서 브라우저를 열고 익숙하며 접속 권한이 있는 웹페이지를 방문하세요. 새로고침하거나 새 페이지를 열어 이전에 캐시된 내용만 확인하는 상황을 피하세요. 제목만 먼저 표시되는 것이 아니라 페이지 본문과 필요한 리소스가 계속 로드되는지 살펴봅니다. 테스트 대상은 정상인데 실제 페이지가 실패하는 경우와 둘 다 실패하는 경우는 서로 다른 증상입니다. 전자는 대상 자체, 규칙 적용, 관련 이름 확인을 살펴볼 필요가 있고, 후자는 네트워크, 현재 서버, 연결 매개변수를 다시 확인해야 합니다.

지연 시간 결과만으로 전체 사용 가능 여부를 판단할 수 없습니다

Home 목록에 표시되는 테스트 숫자와 웹페이지가 실제로 로드되는 것은 서로 다른 지표입니다. Settings의 Test Method에 따라 테스트 방식이 달라집니다. 특정 탐색 요청에 응답이 왔다고 해서 인증, 전송, 대상 접속까지 모든 과정이 정상이라는 뜻은 아닙니다. 반대로 탐색 결과가 없다고 해서 모든 실제 요청이 반드시 실패한다고 단정할 수도 없습니다. 먼저 선택된 테스트 방식을 확인하고 Connectivity Test와 브라우저 요청을 함께 살펴보세요. 숫자가 낮다는 이유만으로 현재 항목을 자주 바꾸지 마세요.

비교 테스트에서는 매번 조건 하나만 변경

현재 서버가 문제인지 확인하려면 네트워크, 대상, 라우팅 모드는 그대로 두고 본인이 보유한 다른 서버로만 바꿔 테스트하세요. 규칙이 문제인지 확인하려면 기존 설정을 기록하고 같은 요청을 Proxy로 잠시 다시 테스트한 다음 Config로 되돌리세요. 서버를 바꾸고 DNS를 수정하고 네트워크를 변경하고 규칙까지 다시 작성하지 마세요. 결과가 달라져도 무엇이 영향을 주었는지 알 수 없습니다.

확인을 마친 뒤 임시 테스트 설정을 평소 사용할 설정으로 되돌리세요. 한 번의 성공은 당시 조건에서 요청이 처리되었다는 뜻일 뿐, 이후 모든 접속이 같은 결과를 보장하지는 않습니다. 연결 상태, Connectivity Test, 실제 페이지가 모두 예상대로 작동하면 첫 사용을 마칠 수 있습니다. 결과가 서로 다르면 다음 절의 증상별 순서에 따라 원인을 확인하세요. 이미 가져온 내용을 전부 삭제하고 처음부터 다시 시작할 필요는 없습니다.

STEP 05 · Settings → Test Method / On Demand / Diagnostics

실패 증상에 따라 설정 확인

먼저 어느 단계에서 실패했는지 확인한 다음 Settings를 살펴보세요. 처음 문제를 해결할 때 Proxy, TCP, UDP 옵션을 모두 동시에 변경할 필요는 없습니다.

가져온 뒤 항목이 보이지 않음: 입력값과 불러오기 상태 확인

Home으로 돌아가 가져온 정보의 출처를 확인하세요. 구독 그룹이 비어 있으면 Subscribe의 URL이 완전한지, 링크가 여전히 유효한지, 불러올 때 어떤 오류가 표시되었는지 확인합니다. 직접 추가한 항목은 저장되지만 연결되지 않는다면 세부 정보로 돌아가 Type과 필수 입력 항목을 다시 확인하세요. 저장 성공은 앱이 입력 형식을 받아들였다는 뜻일 뿐 서비스 제공업체 쪽 상태까지 확인해 주지는 않습니다. 우선 보유한 정보를 점검하고 가져오기와 관계없는 설정부터 바꾸지 마세요.

스위치가 켜진 상태로 유지되지 않음: 승인 여부와 메시지 확인

연결 스위치가 즉시 꺼지면 시스템의 VPN 구성 승인이 완료되었는지 확인하고 앱이나 시스템에 표시된 문구를 기록하세요. 현재 서버가 제대로 선택되었는지, 필수 설정이 빠지지 않았는지도 확인합니다. 여러 옵션을 변경했다면 기억에 의존해 계속 시도하기보다 명확히 기록해 둔 원래 값을 복구하세요. 기기 관리 제한과 서버에 접속할 수 없는 문제는 서로 다르므로 표시된 메시지에 따라 구분해야 합니다. 앱을 반복해서 재설치해도 이러한 확인을 대신할 수 없으며 기존 설정을 추적하기가 더 어려워질 수 있습니다.

연결되지만 테스트 실패: 테스트 방식과 현재 서버 확인

Settings로 이동해 Test Method를 찾아 현재 방법을 먼저 기록한 다음, 해당 방법이 확인 중인 테스트 결과와 어떤 관계인지 살펴보세요. 이어서 Home으로 돌아와 같은 대상을 다시 테스트합니다. 실제 요청도 모두 실패한다면 서비스 제공업체에서 받은 매개변수, 서버 상태, 현재 네트워크 조건을 확인하세요. 본인이 보유한 다른 서버로 비교할 수 있지만 테스트 방식을 바꾼 뒤 숫자가 표시되었다는 이유만으로 모든 요청이 해결되었다고 판단하지 마세요.

일부 대상만 실패: Config에서 요청 경로 확인

연결이 유지되고 일부 페이지가 정상이라면 먼저 Global Routing과 현재 Config를 확인하세요. 문제가 있는 대상에 DIRECT, PROXY, REJECT 중 어떤 규칙이 적용되었는지, 예상한 구성 파일이 처리하고 있는지 살펴봅니다. DNS와 규칙이 모두 영향을 줄 수 있지만 대상 하나 때문에 구성 파일 전체를 바로 교체하지 마세요. 원래 파일은 보존하고 원인을 설명할 수 있는 범위에서 한 곳만 변경한 뒤 같은 대상을 다시 테스트하세요. DNS와 구성의 관계를 더 알아보려면 설정 안내서를 읽어보세요.

수동 테스트 중 상태가 다시 바뀜: On Demand 확인

Settings에서 On Demand를 확인하세요. 네트워크 조건에 따라 연결을 시작하도록 설정했다면 수동 테스트 중 예상과 다른 연결 변화가 발생할 수 있습니다. 기존 조건을 먼저 기록하세요. 문제를 분리하기 위해 잠시 비활성화했다면 테스트가 끝난 뒤 원래 설정으로 되돌립니다. 현재 조건을 이해하지 못한 상태에서 여러 트리거 규칙을 새로 만들지 마세요. 이 튜토리얼은 먼저 명확한 수동 연결을 확인하는 것이 목표입니다. On Demand의 장기 설정은 기본 연결을 확인한 뒤 진행하세요.

원인 파악이 더 필요함: Diagnostics 사용 및 정보 보호

원인을 구분하기 어렵다면 Settings의 Diagnostics를 확인하고 문제 발생 시각, 대상, 증상을 바탕으로 진단 정보를 살펴보세요. 기록은 문제를 재현하는 데 필요한 만큼만 남기고 모든 내용을 공개할 필요는 없습니다. 구독 주소, 인증 정보, 서버 식별자, 접속 기록에는 민감한 정보가 포함될 수 있으므로 진단 내용을 보내기 전에 불필요한 정보를 가리세요. Proxy, TCP, UDP 등의 옵션은 용도를 이해한 뒤 조정하세요. 스위치를 반복해서 켜고 끄는 것은 지속적인 해결책이 아닙니다.

문제 확인을 마쳤다면 Connectivity Test와 실제 요청 확인으로 돌아가 같은 조건으로 한 번 더 테스트하세요. 정상 결과를 반복해서 확인한 뒤 평소 사용할 Global Routing 및 On Demand 설정을 복원합니다. 기존 구독이나 서버 매개변수가 원인이라면 확인한 증상을 서비스 제공업체에 문의하세요. 작업 순서를 잊은 것뿐이라면 이 페이지의 해당 단계부터 다시 진행하면 됩니다. 클라이언트 앱을 다시 구매할 필요는 없습니다.

Shadowrocket Settings 화면: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 먼저 Test Method, On Demand, Diagnostics를 확인하고 다른 옵션은 구체적인 문제에 따라 하나씩 살펴보세요.
첫 사용 완료 확인

Home에 서버가 있고 현재 선택 항목을 확인할 수 있음; Global Routing이 용도에 맞음; 연결 스위치가 켜진 상태로 유지됨; Connectivity Test와 실제 요청을 함께 확인함; 임시 변경 사항을 복구하거나 기록함.

Settings 설정 안내서 계속 읽기 →