공식 매뉴얼 · 빠른 시작

Shadowrocket 사용법,가져오기부터 첫 연결 확인까지

추가, 모드 선택, 연결 및 테스트를 순서대로 진행합니다. 먼저 기존 서버 하나의 연결을 확인한 뒤 규칙과 다른 설정을 조정하세요.

단계 01

Add Server와 Subscribe,기존 정보를 Home에 추가하기

먼저 보유한 정보가 구독 링크, 서버 공유 링크, QR 코드, 주소·포트·인증 매개변수 중 무엇인지 확인합니다. 구독은 보통 업데이트할 수 있는 서버 목록이며, 직접 입력하는 정보는 단일 서버에 해당합니다. 입력 방식이 서로 다르므로 구독 링크를 단일 서버의 Host에 입력하지 말고, 링크 모양만 보고 프로토콜을 추측하지 마세요. 항목이 제대로 추가되었는지 먼저 확인할 수 있도록 가져오는 동안에는 연결 스위치를 꺼두세요.

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

Home에서 Add Server를 눌러 추가 화면을 열고, Type에서 Subscribe를 선택한 다음 기존 구독 링크 전체를 URL에 입력합니다. 알아보기 쉬운 이름을 설정한 뒤 화면의 완료 또는 저장 기능을 사용합니다. Home으로 돌아와 구독 정보가 로드될 때까지 기다리고, 해당 그룹에 서버 항목이 표시되는지 확인합니다. 구독 이름만 표시되고 서버가 보이지 않는다면 먼저 로드가 완료되었는지 확인한 뒤 링크가 유효한지 점검하세요.

링크를 복사할 때는 기존 쿼리 매개변수를 그대로 유지하고 앞뒤의 공백, 줄바꿈, 설명 문구가 섞이지 않도록 주의하세요. 구독 링크에는 접근 정보가 포함될 수 있으므로 개인 민감 정보로 취급하고 공개 댓글이나 스크린샷에 올리지 마세요. 로드에 실패해도 같은 링크를 반복해서 추가하지 마세요. 먼저 이용 중인 서비스 제공자에게 링크 상태를 확인한 뒤 다시 업데이트하세요. 그룹 관리와 이후 업데이트 방법은 서버 관리 매뉴얼의 Subscribe 항목을 참고하세요.

기존 서버 하나가 있는 경우: Type에 맞게 항목 입력

Home에서 Add Server를 열고 기존 정보와 일치하는 Type을 선택한 뒤 해당 항목을 입력합니다. 화면에 표시된 항목을 기준으로 Host에는 서버 주소, Port에는 포트, Password에는 인증 정보를 입력하고, 원래 매개변수에 맞춰 Method를 선택합니다. Type에 따라 표시되는 항목이 다를 수 있습니다. VMess, VLESS, Trojan 등의 프로토콜은 인증 및 전송 매개변수를 다른 유형의 입력 방식에 맞춰 작성할 수 없습니다. 항목의 의미를 모르겠다면 값을 추측해 입력하지 말고 용어집을 확인하세요.

기존 정보에 TLS, 전송 방식 또는 다른 추가 매개변수가 포함되어 있다면 각각 확인해야 합니다. 서버 주소와 TLS에서 사용하는 이름은 서로 다른 역할을 할 수 있으므로, 같아 보이게 하려고 모두 동일한 값으로 바꾸지 마세요. 기존 QR 코드가 있다면 Scan QR Code로 읽을 수 있습니다. 카메라 접근을 허용하고 QR 코드 전체를 비춘 뒤, 가져온 후에도 Type과 주요 항목을 확인하세요. Import from Cloud JSON은 해당 형식의 데이터를 위한 기능이며, 임의의 구독 링크를 입력하는 대체 수단이 아닙니다.

완료 기준: Home으로 돌아왔을 때 SERVER 또는 구독 그룹에 선택 가능한 서버가 표시되고, 편집 화면에서 예상한 Type과 매개변수를 확인할 수 있습니다. 여기까지는 정보 입력을 완료한 것이며, 서버 연결 가능성이 확인된 것은 아닙니다. 다음으로 요청에 적용할 Global Routing 동작을 정하세요.

Shadowrocket 공식 Add Server 화면. Type, Host, Port, Password, Method 및 Scan QR Code 메뉴가 표시됩니다
Add Server: 먼저 Type을 선택한 다음 보유한 정보에 맞게 항목을 입력합니다. 항목은 유형에 따라 달라집니다.
단계 02

Global Routing의 세 가지 모드,요청 처리 방식을 먼저 정하기

Home으로 돌아와 Global Routing을 엽니다. 처음 사용할 때는 Config, Proxy, Direct의 차이를 먼저 확인하세요. 여기서는 전체 라우팅 동작을 정하며 서버 프로토콜을 선택하는 것이 아닙니다. Global Routing을 바꿔도 서버 매개변수가 자동으로 입력되거나 사용할 수 없는 서버가 정상화되지는 않습니다. 현재 선택된 옵션을 기록한 뒤 변경하면 테스트 후 원래 동작으로 정확히 되돌릴 수 있습니다.

  • Config: 현재 활성화된 구성 파일과 규칙에 따라 요청을 처리합니다. 요청마다 PROXY, DIRECT 또는 REJECT 등 서로 다른 동작이 적용될 수 있으며, 모두 같은 경로를 사용하는 것은 아닙니다.
  • Proxy: 요청 전체를 프록시 라우팅으로 처리하는 모드입니다. 처음에 규칙의 영향을 분리해 확인할 때 선택한 서버를 테스트할 수 있지만, 서버 정보와 연결 조건이 유효해야 합니다.
  • Direct: 대상에 직접 연결하는 모드입니다. 이 상태에서 웹사이트가 열려도 선택한 프록시 서버의 연결이 확인된 것은 아닙니다.

새로 가져온 서버를 먼저 확인하려는 경우에는 잠시 Proxy를 선택하고 연결 테스트를 마친 뒤 Config로 돌아가 분할 라우팅을 확인할 수 있습니다. 이는 문제를 점검하는 순서일 뿐, 한 가지 모드를 계속 사용해야 한다는 뜻은 아닙니다. 메뉴에 Scene이 표시되더라도 이번 첫 연결 과정에서는 별도로 설정할 필요가 없습니다. 기본 연결을 확인한 뒤 실제 사용 목적에 따라 관련 안내를 살펴보세요.

Config 사용 전 구성 파일 확인

Config를 사용할 예정이라면 Config로 이동해 현재 선택된 구성 파일을 확인하고 규칙 내용을 살펴보세요. 공식 스크린샷은 구성 파일 편집 화면을 보여줍니다. General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 각각 서로 다른 설정을 관리합니다. 이 화면은 Home의 Global Routing 메뉴가 아닙니다. Add Rule이 보인다고 해서 연결 전에 반드시 규칙을 추가해야 하는 것은 아닙니다.

처음 설정할 때 모든 섹션을 수정할 필요는 없으며, 연결을 위해 HTTPS Decryption을 활성화할 필요도 없습니다. 먼저 기존 Rule의 일치 조건과 동작을 살펴보고, 특히 어떤 규칙에도 일치하지 않는 요청의 최종 처리 방식을 확인하세요. 규칙 순서에 따라 적용 결과가 달라집니다. 범위가 넓은 규칙을 앞에 두면 뒤의 세부 규칙이 요청을 처리하지 못할 수 있습니다. DOMAIN-SUFFIX, IP-CIDR, FINAL 등의 키워드는 용어집에서 의미를 확인할 수 있습니다.

완료 기준: Home으로 돌아와 현재 Config, Proxy, Direct 중 어떤 모드가 선택되었는지 명확히 알 수 있어야 합니다. Config를 선택했다면 현재 사용하는 구성 파일도 확인하세요. 확인을 마친 다음 서버를 선택하고 연결을 켜면, 규칙을 변경하는 동시에 연결 결과를 판단하는 일을 피할 수 있습니다.

Shadowrocket 공식 Config 구성 파일 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시됩니다
Config: 구성 파일 섹션과 Rule을 확인하는 화면입니다. Global Routing 모드는 Home으로 돌아가 선택하세요.
단계 03

Home에서 기본 서버를 선택하고,스위치를 켜 권한 설정 완료하기

Home의 SERVER 또는 구독 그룹에서 이번에 사용할 서버를 선택하고 항목 옆에 선택 표시가 있는지 확인합니다. 항목을 선택하는 것과 편집 화면을 여는 것은 다릅니다. 편집 화면에서 매개변수를 살펴보는 것만으로 해당 서버가 현재 사용 항목으로 선택되는 것은 아닙니다. 목록으로 돌아와 DOT 선택 표시를 확인한 다음, Global Routing도 다시 살펴보고 앞 단계에서 정한 테스트 계획과 일치하는지 확인하세요.

목록에 구독 그룹이 여러 개 있다면 먼저 사용할 그룹을 펼친 뒤 출처와 용도를 구분할 수 있는 서버를 선택합니다. 첫 연결에서는 여러 서버를 동시에 테스트하거나 항목을 계속 바꾸지 마세요. 사용할 서버 하나를 명확히 선택해야 이후 Connectivity Test 결과를 해당 서버와 연결해 판단할 수 있습니다. 방금 구독을 업데이트했다면 기존에 선택했던 항목이 목록에 그대로 있는지도 확인하세요.

최초 VPN 구성 권한 허용

Home 상단의 연결 스위치를 누릅니다. 처음 연결할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 시스템 안내를 읽고 직접 시작한 작업인지 확인한 뒤 안내에 따라 허용하고, 기기에서 요구하는 인증을 완료하세요. 이 권한은 앱이 해당 네트워크 연결 구성을 만들 수 있도록 허용하는 것이며, 원격 서버의 사용 가능성을 확인하거나 구독을 생성하고 인증 매개변수를 입력해 주지는 않습니다.

방금 권한 요청을 취소했다면 Home으로 돌아와 스위치를 다시 직접 켜고, 표시되는 시스템 안내에 따르세요. 스위치가 즉시 꺼지더라도 빠르게 반복해서 누르지 마세요. 앱이나 시스템에 표시된 안내를 확인해 권한 설정이 완료되었는지 살펴보세요. 기기 관리 정책으로 설정을 변경할 수 없다면 서버 비밀번호를 계속 바꾸기보다 먼저 기기 관리 요구 사항을 확인해야 합니다.

권한 설정을 마치면 Home으로 돌아와 화면 상단의 상태가 Not Connected에서 바뀌었는지, 스위치가 계속 켜져 있는지 확인합니다. 시스템 상태 막대나 제어 센터에 VPN 상태가 표시될 수 있지만, 위치는 기기와 시스템 화면에 따라 다릅니다. 아이콘 표시 여부만으로 성공을 판단하지 말고 연결 스위치, 앱 안내, 다음 단계의 실제 테스트를 함께 확인하세요.

완료 기준: 사용할 서버가 명확히 선택되어 있고, 시스템 권한 설정이 완료되었으며, 연결 스위치가 켜진 상태로 유지되어야 합니다. 스위치는 켜져 있는데 웹사이트에 접속할 수 없다면 구성을 바로 삭제하지 마세요. 연결이 설정된 상태와 대상에 접근할 수 있는 상태는 서로 다른 점검 단계입니다. 다음으로 Connectivity Test와 실제 접속을 각각 확인하세요.

Shadowrocket 공식 Home 화면. 상단의 Not Connected 스위치, Global Routing, Connectivity Test, SERVER 및 Add Server가 표시됩니다
Home: 서버 선택, Global Routing, 연결 스위치 순서로 확인한 뒤 Connectivity Test를 실행하세요.
단계 04

Connectivity Test와 실제 접속,연결 작동 여부를 각각 확인하기

Home의 연결 스위치를 켜둔 상태에서 Connectivity Test를 누르고 결과가 나올 때까지 기다립니다. 테스트 중에는 서버나 Global Routing을 바꾸지 마세요. 조건이 달라지면 전후 결과를 비교하기 어려울 수 있습니다. 테스트 성공은 해당 테스트에서 확인한 경로가 필요한 작업을 수행했다는 뜻이지, 모든 웹사이트와 프로토콜, 앱이 반드시 작동한다는 뜻은 아닙니다. 테스트가 실패했다면 테스트 방식과 실제 접속 결과를 함께 살펴보세요.

그다음 실제로 사용해야 하는 웹사이트나 앱을 열어 다시 접속해 보세요. 이미 캐시된 콘텐츠만 확인하지 말고 페이지를 새로고침하거나 해당 서비스에서 아직 불러오지 않은 콘텐츠를 여는 것이 좋습니다. 먼저 확인할 대상을 하나 정해 테스트한 뒤 다른 대상도 살펴보세요. 특정 서비스 하나만 실패한다면 해당 대상, 관련 규칙 또는 서비스 자체로 문제 범위를 좁히고 모든 서버를 다시 가져오지는 마세요.

테스트 결과를 현재 모드에 맞춰 해석하기

Direct를 사용 중일 때 접속 성공은 직접 연결 경로가 작동한다는 뜻일 뿐, 프록시 서버를 확인한 것은 아닙니다. Config를 사용 중이라면 대상 요청이 DIRECT, PROXY 또는 REJECT 규칙에 일치할 수 있습니다. 따라서 “웹페이지가 열렸다”는 것과 “해당 웹페이지가 선택한 서버를 거쳤다”는 것은 같은 의미가 아닙니다. 분할 라우팅을 확인하려면 Data에 표시되는 연결 기록에서 대상과 처리 결과를 확인하세요. 실제 화면에 나타나는 정보를 기준으로 판단해야 합니다.

일시적으로 Proxy로 전환했을 때 같은 대상에 접속되지만 Config에서는 실패한다면 인증 정보를 계속 바꾸기보다 현재 구성 파일과 규칙을 먼저 확인하세요. 두 모드에서 모두 실패하면 다음 단계에 따라 서버와 기기 네트워크를 점검합니다. 한 번에 조건 하나만 변경한 뒤 Connectivity Test와 동일한 대상 접속을 다시 확인해야 어떤 변화가 영향을 주었는지 알 수 있습니다.

목록의 지연 시간 테스트와 Home의 Connectivity Test는 서로 다른 기능입니다. 지연 시간 결과는 Test Method와 당시 네트워크 상태에 따라 달라지므로, 숫자 하나만 보고 해당 서버가 모든 요청에 적합하다고 판단하지 마세요. 정상적으로 확인을 마쳤다면 스위치가 켜진 상태를 유지하고, 테스트 결과를 해석할 수 있으며, 대상 접속이 현재 Global Routing과 규칙에 맞게 작동해야 합니다.

완료 기준: 앱 연결 상태, 테스트 결과, 대상에 대한 실제 접속을 서로 다른 단계로 구분할 수 있어야 합니다. 세 가지가 모두 예상대로라면 첫 연결 절차를 마쳐도 됩니다. 나중에 구독을 정리하거나 업데이트 또는 백업을 진행할 때는 서버 관리 매뉴얼을 참고하세요. 지금 모든 설정을 한꺼번에 조정할 필요는 없습니다.

단계 05

연결 실패는 단계별로 점검하고,한 번에 조건 하나만 변경하기

문제가 발생하면 현재 서버, Global Routing, 사용 중인 네트워크, 그리고 “스위치가 켜진 상태로 유지되지 않음”, “테스트 실패”, “특정 대상에만 접속 실패” 중 어떤 현상인지 먼저 기록하세요. 현상에 따라 점검할 위치가 다릅니다. 기존 설정을 유지한 채 아래 순서대로 원인을 좁혀가세요. 처음부터 앱을 삭제하거나 모든 구독을 지우면 문제를 판단하는 데 필요한 정보를 함께 잃을 수 있습니다.

먼저 기기 네트워크와 서버 선택 확인

연결을 잠시 끄고 기기 네트워크 자체로 직접 접속할 수 있는 서비스가 열리는지 확인합니다. 기본 네트워크에 먼저 접속 인증이 필요하다면 해당 절차부터 완료하세요. 그런 다음 Home으로 돌아와 예상한 서버가 선택되어 있는지 확인합니다. 이름이 같은 이전 항목이나 다른 구독 그룹의 서버가 선택되지 않았는지 살펴보세요. 연결을 다시 켠 뒤 테스트합니다. Wi-Fi와 셀룰러 네트워크를 전환할 때는 데이터 사용량에 유의하고, 다른 설정은 그대로 둔 채 특정 네트워크에서만 문제가 발생하는지 확인하세요.

다음으로 구독 유효성과 프로토콜 매개변수 확인

구독 가져오기 실패와 서버 연결 실패는 서로 다른 문제입니다. 전자는 링크가 완전한지, 로드 결과와 이용 중인 서비스 상태가 어떤지 확인하세요. 후자는 Add Server에서 해당 항목의 편집 화면을 열고 Type, Host, Port, 인증 정보와 기존 자료에 명시된 전송 및 TLS 매개변수를 하나씩 확인합니다. 대소문자, 불필요한 공백, 누락된 항목도 연결에 영향을 줄 수 있으므로 다른 프로토콜의 매개변수 형식을 대신 사용하지 마세요. 구독에서 생성된 항목을 장기간 수정해야 한다면 업데이트로 수동 변경 사항이 덮어써지는지 먼저 확인하세요. 자세한 내용은 서버 관리 매뉴얼을 참고하세요.

마지막으로 시스템 시간, 규칙 및 테스트 설정 확인

TLS 연결을 사용하는 경우 기기의 날짜, 시간, 시간대가 정확한지 확인하고 필요한 경우 시스템의 자동 설정을 사용하세요. Proxy에서는 연결되지만 Config에서 연결되지 않는다면 Config로 돌아가 규칙 순서, 대상 일치 동작, 최종 처리 방식을 확인합니다. 특정 대상에서만 실패한다면 원격 서비스 자체가 정상인지도 확인해, 서비스 문제를 클라이언트 매개변수 오류로 오해하지 않도록 하세요.

Settings에서 Test Method, Diagnostics 등의 메뉴를 확인할 수 있습니다. 테스트 방식을 확인한 뒤 같은 방식으로 다시 비교하세요. 전후 설정이 다른데 결과만 직접 비교하면 안 됩니다. Diagnostics 정보는 원인 파악을 돕기 위한 자료이며, 모든 기록을 오류로 단정하지 마세요. 저장하거나 이용 중인 서비스 제공자에게 문의하기 전에 구독 링크, 서버 주소, 인증 정보 등 민감한 내용은 가리세요.

첫 연결을 확인하기 전까지는 On Demand와 같은 자동 동작 설정을 그대로 두고, 먼저 Home의 수동 스위치로 기본 연결 절차를 확인하는 것이 좋습니다. 이후 On Demand를 조정할 때는 네트워크 전환과 연결 시작 동작을 따로 확인해 자동 재연결을 수동 스위치가 작동하지 않은 것으로 착각하지 않도록 하세요. 테스트를 마치면 평소 사용할 Global Routing으로 되돌리고 대상 접속도 다시 확인합니다.

완료 기준: 문제가 기기 네트워크, 권한, 서버 매개변수, 규칙 또는 대상 서비스 중 어느 단계에 있는지 파악했거나, 반복해서 재현할 수 있는 실패 현상을 확인해야 합니다. 여러 구독의 관리, 업데이트, 정렬 또는 백업이 필요하다면 서버 관리 매뉴얼을 확인하세요. 화면 용어의 의미만 궁금하다면 용어집을 참고하면 됩니다. 용어 하나를 이해하기 위해 클라이언트를 전부 다시 설정할 필요는 없습니다.

Shadowrocket 공식 Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP가 표시됩니다
Settings: 문제를 점검할 때 Test Method와 Diagnostics를 확인하고, 자동 연결 설정은 기본 연결 확인 후 조정하세요.