OFFICIAL MANUAL / FIRST CONNECTION

Shadowrocket 사용법: 가져오기와 첫 연결

다섯 단계로 기존 정보 가져오기, Global Routing 선택, 연결 권한 승인, 결과 확인을 진행합니다. 먼저 확인 가능한 기본 연결을 설정한 다음 규칙과 자동 연결 설정을 조정하세요.

iPhone / iPad 5단계 안내 공식 가이드

처음 설정한다면 순서대로 읽어보세요. 가져오기를 마친 사용자는 아래 목차에서 모드 선택이나 확인 단계로 이동할 수 있습니다. 복잡한 문제가 발생하면 문제 해결 가이드를 참고하세요.

STEP 01 / INPUT

Add Server: 서버 추가 및 Subscribe 가져오기

Shadowrocket을 열고 Home으로 이동한 뒤 SERVER 그룹 근처에서 Add Server를 찾습니다. 먼저 보유한 정보의 종류를 확인하세요. 구독 링크는 여러 서버를 가져와 관리하는 데 사용하고, 단일 서버 정보는 해당 프로토콜을 선택해 각 항목을 입력해야 합니다. 두 입력 방식은 다릅니다. 전체 구독 주소를 Host에 입력하거나 서버 주소를 Subscribe 주소로 입력하면 안 됩니다.

구독 링크가 있다면: Subscribe 선택

  1. Add Server를 열고 Type 선택 목록에서 Subscribe를 선택합니다. 구독 주소 입력란에 본인의 전체 링크를 붙여 넣고 알아보기 쉬운 이름을 입력하세요.
  2. 붙여 넣은 주소가 처음부터 끝까지 온전한지 확인하세요. 특히 앞뒤 부분, 쿼리 매개변수, 실수로 포함된 공백이나 줄바꿈에 유의하세요. 구독 주소에는 계정 정보가 포함될 수 있으므로 문제 해결을 위해 공개하지 마세요.
  3. 저장한 뒤 Home으로 돌아가 구독 정보가 불러와질 때까지 기다리거나 구독 항목에서 제공하는 업데이트 기능을 사용하세요. SERVER에 구독 이름만 보이는 것이 아니라 실제 서버 항목이 나타났는지 확인합니다.

구독 업데이트가 성공했다는 것은 클라이언트가 해석 가능한 데이터를 가져왔다는 뜻일 뿐, 모든 항목에 연결할 수 있다는 뜻은 아닙니다. 목록에서 본인이 이용 권한을 가진 항목 하나를 선택하고 프로토콜과 주소가 예상한 정보와 일치하는지 확인한 뒤 다음 단계로 진행하세요. 목록이 비어 있다면 구독 상태와 주소의 유효성을 먼저 확인하세요. 같은 구독을 계속 반복해서 추가하지 마세요. 중복 항목이 생기면 이후 선택과 문제 해결이 더 어려워집니다.

단일 서버 정보가 있다면: Type에 맞게 입력

주소, 포트, 인증 매개변수를 보유한 경우 Add Server의 Type에서 해당 정보의 프로토콜을 선택합니다. 선택한 프로토콜에 따라 입력 항목이 달라집니다. 화면의 Host, Port, Password, Method는 해당 화면에 표시되는 항목의 예시이며, 모든 프로토콜에 공통으로 필요한 목록은 아닙니다. 일반적으로 Host에는 서버 도메인이나 IP 주소를, Port에는 포트 번호를 입력합니다. Password, Method 및 기타 인증·전송 매개변수는 기존 정보와 일치해야 합니다.

VLESS, Trojan, WireGuard 등의 프로토콜은 각 프로토콜에 필요한 식별 정보, 암호화 또는 Peer 매개변수도 확인하세요. 다른 프로토콜의 입력 항목을 기준으로 추측하지 마세요. 기존 정보에 TLS, SNI, 전송 경로 등의 설정이 포함되어 있다면 각 항목에 맞게 입력해야 합니다. 확인하기 어려운 매개변수는 임의로 관련 옵션을 끄지 말고 원본 설정 안내에서 확인하세요.

Scan QR Code를 사용하면 본인이 보유한 설정의 QR 코드를 스캔할 수 있습니다. 사용할 때는 시스템 안내에 따라 카메라 권한을 처리하고, 인식 후 내용을 다시 확인하세요. Import from Cloud JSON은 해당 형식의 데이터를 가져오는 기능이며 일반 구독 입력 기능과는 다릅니다. 저장한 뒤 Home으로 돌아가 서버 항목이 있는지, 정보를 다시 열어 확인할 수 있는지 살펴본 다음 Global Routing으로 이동하세요.

Shadowrocket 공식 Add Server 화면: Type, Host, Port, Password, Method 및 가져오기 메뉴 표시
Add Server: 먼저 Type을 선택한 다음 보유한 정보에 맞춰 입력합니다. Type에 따라 항목이 달라질 수 있습니다.

STEP 02 / ROUTING

Global Routing: 연결 방식 선택

서버를 추가한 뒤 Home으로 돌아가 Global Routing을 엽니다. 이 설정은 요청을 현재 설정이나 연결 정책에 따라 처리하는 방식을 결정하며, 연결을 켰는지 여부와는 별개의 항목입니다. 처음 설정한다면 규칙에 따라 트래픽을 분리할지, 선택한 서버의 연결을 임시로 확인할지 먼저 정하세요. 특정 옵션의 이름만 보고 모든 상황에 적합하다고 판단하지 마세요.

방식의미 및 사용 전 확인 사항
Config(설정)현재 활성 설정의 규칙과 요청을 대조하고, 일치하는 규칙에 따라 해당 정책으로 처리합니다. 먼저 설정 내용과 설정이 참조하는 대상을 확인해야 합니다.
Proxy(프록시)요청을 프록시 방식으로 처리합니다. 기본 연결을 확인할 때 규칙의 영향을 줄이는 데 활용할 수 있습니다. 실제 처리 범위는 앱과 시스템의 제약을 받습니다.
Direct(직접 연결)요청을 직접 연결 방식으로 처리합니다. 프록시 연결이 필요한 대상은 스위치가 켜져 있다는 이유만으로 동일한 결과를 얻지 못합니다.

Config 사용 전 활성 설정 확인

하단의 Config 페이지로 이동해 현재 선택된 구성 파일을 확인합니다. 서버 구독과 구성 파일은 역할이 다릅니다. 전자는 주로 연결 항목을 제공하고, 후자는 규칙과 관련 설정을 결정합니다. 서버 구독을 가져왔다고 해서 원하는 규칙 설정이 자동으로 대체되거나 활성화되는 것은 아닙니다. 편집해야 한다면 먼저 원본 파일을 복사해 보관한 뒤 설정을 확인하세요. 첫 연결을 위해 익숙하지 않은 규칙을 한꺼번에 많이 추가하지 마세요.

공식 스크린샷에는 설정 편집 화면의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션과 Add Rule 메뉴가 표시되어 있습니다. 이 가이드에서는 트래픽 분리와 관련된 Rule 및 정책 대상만 확인하면 됩니다. 첫 연결을 위해 다른 섹션을 수정하거나 HTTPS Decryption을 활성화할 필요는 없습니다.

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

위 내용은 규칙 문법을 읽기 위한 예시이며 기존 설정을 그대로 덮어쓰라는 뜻이 아닙니다. 첫 번째 줄은 도메인 접미사를 기준으로 일치시켜 PROXY로 전달하고, 두 번째 줄은 GEOIP 조건에 따라 DIRECT로 전달하며, 마지막 줄은 앞선 규칙에 일치하지 않을 때 적용되는 기본 규칙입니다. 일반적으로 규칙은 순서대로 판정되며, 정책 이름은 현재 설정 환경에서 유효해야 합니다. 각 정책의 정의를 확인하지 않고 한 줄만 복사하지 마세요.

현재는 서버 연결이 정상적으로 설정되는지만 확인하려면 Proxy를 선택해 테스트 범위를 좁힌 다음, 기본 연결을 확인하고 Config로 돌아가 트래픽 분리 결과를 점검하세요. 연결 방식을 바꾼 뒤 Home으로 돌아가 Global Routing에 표시된 값을 다시 확인합니다. 규칙 우선순위와 세부 일치 기준은 자주 묻는 질문에서 확인하세요. 이 단계에서 서버, 규칙, DNS를 동시에 바꾸지 마세요.

Shadowrocket 공식 Config 설정 편집 화면: General, Rule, Hosts 등의 섹션과 Add Rule 표시
Config: 구성 내용과 Global Routing 선택을 함께 확인하세요. 이 화면은 설정 편집 위치를 보여줍니다.

STEP 03 / CONNECT

Home: 서버를 선택하고 연결하기

Home으로 돌아와 SERVER 그룹을 확인하고 사용할 서버를 선택합니다. 선택 표시가 원하는 항목에 있는지 확인하세요. 구독에 이름이 비슷한 항목이 있다면 세부 정보를 열어 주소나 메모를 확인해 잘못 선택하지 않도록 합니다. 이어서 Global Routing을 다시 확인하세요. Config를 선택한 경우 앞 단계에서 확인한 파일이 활성 설정인지 확인하고, Proxy를 선택한 경우 현재 서버 정보가 저장되었는지 확인합니다.

  1. Home 상단에서 연결 스위치를 찾습니다. 연결되지 않은 경우 Not Connected 상태가 표시되며, 스위치를 눌러 연결을 시작합니다.
  2. 처음 사용하면서 VPN 구성 추가를 요청하는 시스템 알림이 나타나면, 방금 연 Shadowrocket에서 보낸 요청인지 확인한 뒤 시스템 안내에 따라 승인하세요. 기기 암호나 본인 확인을 요청할 수 있으며, 시스템 화면에서 진행해야 합니다.
  3. Home으로 돌아가 상태가 바뀌는지 기다립니다. 스위치가 바로 꺼지거나 시스템 요청이 완료되지 않으면 먼저 권한 문제를 해결하세요. 스위치를 빠르게 여러 번 켰다 끄지 마세요.

VPN 구성 권한은 앱이 시스템에서 제공하는 네트워크 기능을 통해 트래픽을 처리하도록 허용합니다. 서버 비밀번호가 확인되었거나 구독이 여전히 유효하다는 뜻은 아닙니다. 스위치가 계속 켜져 있어도 실제 요청 테스트를 대신할 수 없습니다. 시스템 연결이 설정되었는지와 대상에 정상적으로 접속할 수 있는지를 각각 확인하고, 다음 단계에서 네트워크 결과를 점검하세요.

다른 VPN 연결이 있거나 기기 관리 정책이 적용된 경우 구성 충돌이나 권한 제한이 생길 수 있습니다. 기기에서 현재 사용 중인 연결과 관리 상태를 먼저 확인하세요. 회사나 학교에서 관리하는 기기라면 관리 지침을 따르고, 정체를 알 수 없는 구성을 삭제하지 마세요. 이전에 시스템 요청을 거부했다면 앱으로 돌아가 다시 시도하고 시스템의 해당 VPN 설정을 확인하세요. 설정 위치는 시스템 화면에 따라 다를 수 있습니다.

iPad에서는 가로 화면이나 분할 화면 사용 여부에 따라 페이지 배치가 달라질 수 있습니다. Home, SERVER, Global Routing, 상단 스위치를 기준으로 조작 위치를 찾으세요. 첫 연결은 동일한 Wi-Fi 또는 셀룰러 네트워크에서 테스트하고, 연결 문제와 네트워크 변경의 영향을 구분할 수 있도록 테스트 중에는 네트워크 환경을 바꾸지 않는 것이 좋습니다.

Shadowrocket 공식 Home 화면: 상단에 Not Connected, 아래에 Global Routing, Connectivity Test, SERVER 그룹 표시
Home: SERVER에서 선택한 항목과 Global Routing을 먼저 확인한 뒤 상단 연결 스위치를 조작하세요.

STEP 04 / CHECK

Connectivity Test: 연결 결과 확인

연결 스위치가 켜진 상태에서 Home의 Connectivity Test를 실행합니다. 먼저 선택한 항목이 현재 테스트를 완료할 수 있는지 확인한 다음, 브라우저에서 익숙하고 이용 권한이 있는 페이지에 접속하세요. 테스트 결과가 실제 서비스 요청 결과와 완전히 같은 것은 아닙니다. 테스트가 성공해도 모든 도메인, 전송 방식, 앱 요청이 성공하는 것은 아닙니다.

상태 하나만 보지 말고 세 단계로 확인하세요

  1. 서버 단계: 테스트 대상이 방금 선택한 항목인지 확인합니다. 시간 초과가 발생하면 당시 네트워크, 프로토콜, 결과를 기록하고 규칙은 우선 수정하지 마세요. Test Method가 다르면 결과를 직접 비교하기 어렵습니다.
  2. 요청 단계: 브라우저에서 테스트할 페이지를 열고 새로고침하거나 새 페이지를 열어 콘텐츠가 실제로 로드되는지 확인합니다. 캐시된 페이지가 보이는 것만으로는 새 연결이 적용되었다고 볼 수 없습니다.
  3. 규칙 단계: Config에서 Data의 요청 기록이나 관련 진단 정보를 확인해 실제 도메인, 적용된 규칙, 정책을 확인합니다. 페이지 전체의 외관만 보고 판단하지 말고 개별 요청을 확인하세요.

Proxy에서는 접속되지만 Config에서 실패한다면 서버가 작동하지 않는다고 단정하기보다 먼저 규칙 적용과 정책 참조를 확인하세요. 대상이 DIRECT 또는 REJECT로 처리되는지, 범위가 넓은 DOMAIN-SUFFIX 규칙이 먼저 적용되는지, FINAL이 예상한 정책을 가리키는지 살펴봅니다. 한 항목을 변경한 뒤 요청을 다시 보내야 결과를 변경 사항과 비교할 수 있습니다.

서버 테스트는 정상인데 특정 페이지가 계속 실패한다면 사이트 전체가 열리지 않는지, 이미지 일부만 표시되지 않는지, 특정 기능만 실패하는지 기록하세요. 하나의 페이지에서도 여러 도메인에 요청할 수 있으며, 각 요청에 서로 다른 규칙이 적용될 수 있습니다. 필요하다면 관련 앱을 완전히 종료한 뒤 다시 열어 이전 연결과 캐시의 영향을 줄이세요. 페이지 하나의 문제만으로 전체 설정을 다시 작성하지 마세요.

확인을 마친 뒤 현재 작동하는 설정을 기본 상태로 보관하세요. 이후 규칙, DNS 또는 자동 연결을 조정할 때는 한 번에 한 종류의 설정만 바꾸고 기존 값을 기록하세요. 결과가 나빠져도 확인된 상태로 되돌려 비교할 수 있습니다.

STEP 05 / DIAGNOSE

Settings: 실패 지점별로 확인하기

앞의 네 단계를 거쳐도 예상한 결과를 얻지 못했다면 먼저 어느 단계에서 실패했는지 확인한 뒤 Settings에서 관련 설정을 살펴보세요. 여기에는 Test Method, On Demand, Diagnostics, Proxy, TCP, UDP 등의 항목이 있습니다. 첫 연결을 위해 모두 조정해야 하는 목록은 아닙니다. 기존 기본값이나 설정이 있다면 먼저 그대로 두어 불필요한 변경으로 원래 원인을 가리지 않도록 하세요.

구독에서 서버 항목이 생성되지 않음

구독 항목으로 돌아가 주소가 온전한지, 현재 네트워크에서 주소에 접속할 수 있는지, 구독이 여전히 유효한지 확인하세요. 주소가 웹 페이지, 로그인 안내 또는 오류 내용을 반환한다면 클라이언트가 이를 서버 목록으로 해석하지 못할 수 있습니다. 주소의 용도를 원래 정보 제공자에게 문의할 때는 오류 내용과 발생 시각을 설명하되 전체 링크는 공개하지 마세요. 구독을 업데이트하면 해당 구독이 관리하는 항목이 바뀔 수 있으므로 직접 수정하기 전에 항목의 출처를 확인하세요.

스위치가 켜지지 않거나 켜진 직후 꺼짐

시스템 VPN 구성 요청이 완료되었는지 확인한 다음, 기존 연결과 충돌하는지 또는 기기 관리 정책의 제한을 받는지 점검하세요. 서버 시간 초과와 시스템 권한 승인 실패는 서로 다른 문제입니다. 권한 승인이 끝나지 않은 상태에서 Host나 Port를 반복해서 바꿔도 스위치 문제는 해결되지 않습니다. 시스템 업데이트나 설정 변경 후 문제가 시작되었다면 앱을 다시 열고 표시되는 안내를 기록한 뒤 문제 해결 가이드의 권한 승인 절차를 따르세요.

스위치는 켜져 있지만 Connectivity Test에서 시간 초과 발생

Host, Port, 인증 매개변수, 프로토콜 Type, 전송 설정을 차례로 확인하세요. 특히 대소문자, 복사 과정에서 포함된 공백, TLS 관련 항목을 주의해서 살펴봅니다. 인증서 확인에 영향을 줄 수 있으므로 기기의 날짜와 시간이 정확한지도 확인하세요. 여건이 된다면 본인이 이용 권한을 가진 다른 네트워크에서도 비교하되, 매번 같은 서버 항목과 테스트 방법을 사용하세요. 특정 항목만 실패한다면 해당 항목의 원본 매개변수와 서비스 상태를 먼저 확인하세요.

Config에서만 실패하거나 일부 도메인에서 문제가 발생함

먼저 규칙을 확인하고 다음으로 도메인 이름 확인을 점검하세요. 활성 설정을 올바르게 선택했는지, 정책 이름이 유효한 대상과 연결되는지, REJECT가 필요한 요청을 잘못 차단하지 않는지 확인합니다. 도메인 요청과 IP 주소를 직접 사용하는 테스트의 결과가 다르면 DNS가 관련되었을 수도 있고, 대상이 도메인이나 TLS 설정을 요구할 수도 있습니다. 한 번의 현상만으로 원인을 단정하지 마세요. 현재 설정의 DNS 항목이 네트워크 및 연결 방식에 맞는지 확인하고, 낯선 주소를 임의로 입력해 문제를 해결하려 하지 마세요.

테스트 방식과 자동 연결이 결과 확인에 미치는 영향

Test Method는 관련 테스트에 사용할 방법을 결정하며, 결과는 서버와 네트워크 조건에 따라 달라질 수 있습니다. 비교 전에는 테스트 방법을 통일하고, 특정 테스트의 실패를 모든 통신의 실패로 간주하지 마세요. On Demand는 시스템 조건에 따른 자동 연결을 관리하며 각 요청의 규칙 정책을 정하지 않습니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 On Demand에 설정된 조건을 확인하세요. 이를 Global Routing의 대체 옵션으로 취급하지 마세요.

더 자세한 근거가 필요하다면 현재 문제에 적합한 Diagnostics 기능을 사용하고 실패 단계, 테스트 방법, 네트워크 유형, 오류 문구를 기록하세요. 기록을 공유하기 전에는 구독 정보, 서버 인증 정보, 개인을 식별할 수 있는 데이터를 가리세요. 이 가이드는 조작 방법과 진단 절차를 설명하며 연결 정보를 수집하지 않습니다.

이 단계까지 진행해도 문제를 찾지 못했다면 모든 항목을 반복해서 가져오거나 다시 만들 필요는 없습니다. 가장 최근에 재현된 증상을 보관하고 문제 해결 가이드에서 증상에 따라 계속 확인하세요. 구매, 구매 항목 복원, 일반적인 화면 설명은 자주 묻는 질문을 참고하세요. 평소에는 확인을 마친 설정을 유지하고 실제 필요에 따라 항목별로 조정하세요.

Shadowrocket 공식 Settings 화면: Language, Test Method, On Demand, Diagnostics, Proxy, TCP, UDP 표시
Settings: 실패가 발생한 위치에 따라 관련 항목을 확인하세요. 기존 값을 먼저 기록한 뒤 한 항목씩 비교하세요.