공식 가이드 · 시작하기

Shadowrocket
가져오기 및 연결 방법

먼저 보유한 정보를 추가하고 Global Routing을 선택하세요. 연결한 뒤에는 스위치 상태만 보지 말고 실제 요청으로 확인하세요.

Add Server Global Routing Connectivity Test

이번 설정 순서

  1. 추가Add Server
  2. 모드 선택Global Routing
  3. 연결 및 테스트Home → Connectivity Test

iPhone / iPad에서 사용할 수 있습니다. 스크린샷은 화면 위치를 확인하기 위한 참고 자료이며, 실제 입력 항목은 현재 앱에 표시되는 내용을 따르세요.

SERVER 항목 준비

Add Server: 서버 추가 또는 구독 가져오기

Shadowrocket을 열고 Home으로 이동한 뒤 아래쪽 SERVER 그룹에서 Add Server를 눌러 추가 화면을 엽니다. 먼저 보유한 정보의 유형을 확인하세요. 서버 목록을 가져오는 데 사용하는 서비스 제공자의 전체 링크는 일반적으로 구독으로 가져옵니다. 주소, 포트, 비밀번호 및 프로토콜 매개변수가 포함된 정보는 서버 한 대의 항목으로 입력합니다. 두 방법 중 하나만 선택하면 됩니다. 구독 주소를 서버의 Host 항목에 입력하지 마세요.

구독 링크가 있다면 먼저 Subscribe 선택

Add Server에서 Type을 누르고 Subscribe를 선택한 다음 본인의 전체 구독 링크를 해당 URL 입력란에 붙여 넣습니다. 저장하기 전에 링크의 시작과 끝, 쿼리 매개변수가 온전한지 확인하세요. 복사할 때 공백, 줄바꿈, 한글 문장부호가 포함되지 않았는지도 살펴보세요. 구독 링크에는 계정 정보가 포함될 수 있으므로 본인 기기에서만 사용하고, 전체 링크가 보이는 스크린샷이나 게시물을 공개하지 마세요.

저장한 뒤 Home으로 돌아와 구독에서 서버 항목을 가져왔는지 확인합니다. 구독 기록만 있고 선택할 서버가 없다면 구독을 업데이트해야 하는지, 업데이트 오류가 있는지 먼저 확인하세요. 곧바로 연결 스위치를 켜고 반복해서 시도하지 마세요. 구독 이름은 항목을 식별하는 라벨일 뿐이므로 이름을 바꿔도 링크 오류는 해결되지 않습니다. 내용을 가져올 수 있는지는 주소, 서비스 상태, 현재 네트워크에 따라 달라집니다.

서버 정보가 있다면 프로토콜에 맞춰 항목별로 입력

서버 한 대의 매개변수를 받았다면 Type에서 정보에 적힌 프로토콜을 선택한 후 해당 항목을 입력합니다. 공식 스크린샷에 표시된 Host / Port / Password / Method는 입력 위치를 확인하기 위한 참고 자료입니다. Type마다 필요한 매개변수가 다르므로 한 프로토콜의 항목을 다른 프로토콜에 그대로 적용할 수 없습니다. Host에는 일반적으로 호스트 이름이나 주소를 입력하며 웹 경로를 임의로 덧붙이지 않습니다. Port, Password, Method도 원본 정보와 하나씩 대조하세요.

QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. 가져온 뒤에도 프로토콜과 입력 항목을 확인하세요. Import from Cloud JSON은 별도의 가져오기 경로이며 Subscribe와는 다릅니다. 해당 경로에 사용할 수 있는 정보라는 점이 명확할 때만 이용하세요. 저장한 뒤 SERVER에 항목이 표시되면 다음 단계로 넘어갑니다. 구독, 서버, 구성 파일의 차이는 용어집에서 확인할 수 있습니다. 처음 연결할 때 모든 프로토콜 매개변수를 미리 알아야 하는 것은 아닙니다.

Shadowrocket Add Server 공식 스크린샷: Type, Host, Port, Password, Method 및 하단의 가져오기 메뉴
Add Server: 먼저 Type을 확인한 다음 해당 항목을 입력하세요. 그림은 항목 위치를 확인하기 위한 참고 자료이며, Subscribe를 선택한 뒤의 화면은 앱에 표시되는 내용을 따르세요.

다음 단계로 넘어가기 전: Home의 SERVER 그룹에 선택할 수 있는 서버가 표시되는지 확인하세요. 아직 내용을 가져오지 못한 구독 이름만 있는 상태여서는 안 됩니다.

요청 처리 방식 확인

Global Routing: Config, Proxy, Direct

서버를 추가한 뒤 Home으로 돌아가 Global Routing을 눌러 현재 설정을 확인합니다. 여기서는 요청 처리 방식을 정합니다. 서버를 추가하거나 누락된 서버 매개변수를 채우는 기능은 아닙니다. 처음 설정할 때는 먼저 무엇을 확인할지 정하세요. 기존 서버가 작동하는지 확인할 것인지, 구성 파일의 규칙에 따라 트래픽이 분기되는지 확인할 것인지에 따라 결과를 살펴보는 방법이 다릅니다.

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

Config는 현재 활성화된 구성 파일에 따라 요청 처리 방식을 결정합니다. Config로 이동해 사용 중인 파일을 확인한 뒤 내용을 엽니다. 공식 스크린샷의 General / Rule / Hosts / URL Rewrite / HTTPS Decryption은 구성 편집 화면의 각 섹션이며, 시작할 때 모든 항목을 수정할 필요는 없습니다. 우선 Rule의 규칙과 순서를 확인하고 구성 파일의 출처와 용도를 파악하세요. 처음 연결하기 위해 다른 기능을 임의로 켜지 마세요.

규칙은 일반적으로 순서대로 적용됩니다. 앞쪽 규칙이 요청을 DIRECT 또는 PROXY로 먼저 처리할 수 있으며, 마지막의 FINAL은 앞선 규칙에 해당하지 않는 요청을 처리합니다. 따라서 Config를 선택했다고 해서 모든 요청이 선택한 서버를 거치는 것은 아닙니다. 서버 구독과 구성 파일은 서로 다른 자료입니다. Subscribe로 서버 목록을 가져와도 해당 서버에 맞는 규칙 구성으로 자동 전환되는 것은 아닙니다.

Proxy와 Direct: 처리 방식 비교

Proxy는 선택한 서버를 통해 요청을 처리합니다. 문제를 점검할 때 비교 기준으로 잠시 사용하면 서버 문제와 구성 규칙 문제를 구분하는 데 도움이 됩니다. 잘못된 주소, 비밀번호 또는 프로토콜 설정을 해결해 주지는 않습니다. Direct는 직접 연결하는 방식입니다. 이 상태에서 웹 페이지가 열린다고 해서 서버가 정상적으로 확인된 것은 아닙니다. 처리 방식을 바꾼 뒤 Home으로 돌아가 Global Routing에 예상한 선택이 표시되는지 확인하세요.

구성 규칙의 의미가 확실하지 않다면 원본 파일을 보관한 뒤 비교하면서 한 번에 조건 하나만 변경하세요. 구성 파일 변경, 규칙 편집, 서버 전환을 동시에 하면 실패 원인을 파악하기 어렵습니다. 규칙 키워드의 자세한 의미는 용어집에서, 모드 선택과 트래픽 분기에 관한 일반적인 질문은 자주 묻는 질문에서 확인할 수 있습니다. 처리 방식을 확인한 다음 시스템 권한을 허용하고 연결하세요.

Shadowrocket Config 공식 스크린샷: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config: 구성 파일 편집 섹션을 보여 주는 화면입니다. Global Routing의 처리 방식은 Home에서 선택하며 이 섹션에서 전환하지 않습니다.

다음 단계로 넘어가기 전: 현재 설정이 Config, Proxy, Direct 중 무엇인지 설명할 수 있고, 서버와 규칙 중 무엇을 확인할지도 알고 있어야 합니다.

처리 방식 선택 및 시스템 권한 허용

Home: 연결 스위치 켜기

Home으로 돌아가 SERVER 그룹에서 이번에 사용할 서버를 선택하세요. 구독 그룹 이름만 확인하지 말고 실제 선택된 항목을 확인합니다. 그런 다음 Global Routing도 다시 확인하세요. 두 설정을 함께 살펴봐야 합니다. 서버는 Proxy 요청에 사용할 연결 정보를 정하고, Global Routing은 요청 처리 방식을 정합니다. 목록에 항목이 여러 개라면 실제 선택 상태를 기준으로 판단하고, 목록의 위치만으로 추측하지 마세요.

Home 상단의 스위치를 눌러 연결을 시작합니다. 공식 스크린샷의 Not Connected는 스크린샷 촬영 당시 연결되지 않은 상태를 나타내며, 스위치 위치를 확인하기 위한 참고 자료입니다. 계속 이 상태로 두라는 뜻은 아닙니다. 처음 연결할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 묻는 안내가 표시될 수 있습니다. 안내를 읽고 현재 앱에서 요청한 작업인지 확인한 다음 시스템 절차에 따라 권한을 허용하세요. 기기 인증을 요구하면 시스템 화면에서 진행하고, 기기 비밀번호를 서버 항목에 입력하지 마세요.

권한 허용이 끝나면 Shadowrocket으로 돌아와 상단 스위치와 연결 상태가 유지되는지 확인하세요. 스위치를 켠 직후 다시 꺼진다면 규칙을 더 수정하기 전에 권한, 구성 또는 연결 오류부터 해결하세요. 시스템 안내에서 권한 허용을 취소했다면 다시 연결할 때 안내가 표시되는지 확인합니다. 시스템 설정에 VPN 구성이 이미 있다면 실제로 활성화된 구성이 이번에 테스트할 구성인지도 확인하세요. 다른 연결의 상태를 결과로 착각하지 않도록 주의해야 합니다.

연결 스위치가 켜져 있다는 사실만으로 연결 절차가 해당 상태까지 진행되었음을 알 수 있을 뿐, 모든 대상 요청을 서버가 처리할 수 있다고 단정할 수는 없습니다. 연결한 뒤 바로 다음 단계로 넘어가 Connectivity Test와 실제 접속으로 결과를 확인하세요. 이때는 비교 기준을 유지할 수 있도록 같은 네트워크, 같은 서버, 같은 처리 방식을 사용하고 여러 설정을 연달아 바꾸지 마세요.

Shadowrocket Home 공식 스크린샷: 상단의 Not Connected 스위치와 아래쪽의 Global Routing, Connectivity Test, SERVER, Add Server 표시
Home: 연결 전에 SERVER 선택과 Global Routing을 차례로 확인한 뒤 상단 스위치를 조작하세요. 연결 후에는 Connectivity Test를 실행합니다.

다음 단계로 넘어가기 전: 시스템 권한 허용을 완료하고 Home으로 돌아왔을 때 연결 상태가 바로 해제되지 않는지 확인한 다음 테스트를 시작하세요.

스위치 상태와 실제 결과를 따로 확인

Connectivity Test: 연결 확인

Home에서 Connectivity Test를 누르고 테스트가 끝날 때까지 기다린 뒤 결과를 확인합니다. 이 테스트는 현재 조건에서 연결 상태를 파악할 수 있는 참고 정보를 제공하지만, 모든 웹사이트와 모든 프로토콜 요청의 작동을 보장하지는 않습니다. 서버 목록의 지연 시간 테스트와 실제 대상에 접속하는 것도 완전히 같은 검사가 아닙니다. 테스트에 응답이 있다고 해서 인증 매개변수가 반드시 올바른 것은 아니며, 시간이 초과되면 테스트 방식, 현재 네트워크, 서버 상태를 함께 살펴봐야 합니다.

이어서 실제로 사용할 앱이나 페이지를 열고 새 요청을 한 번 보냅니다. 이미 캐시된 내용만 보지 말고, 같은 페이지를 다시 불러오는 등 명확하고 반복할 수 있는 작업을 선택하세요. 페이지가 제대로 로드되는지, 텍스트만 표시되고 이미지나 후속 요청은 실패하는지 살펴봅니다. 단순히 ‘된다’ 또는 ‘안 된다’고 기록하는 것보다 어떤 대상을 대상으로 어떤 작업을 했고 어떤 결과가 나왔는지 적어 두면 문제를 더 쉽게 파악할 수 있습니다.

Config를 사용한다면 앱에서 확인할 수 있는 요청 기록을 함께 살펴보고 대상 요청에 적용된 규칙과 정책을 확인하세요. DIRECT에 해당하는 요청은 직접 연결되고, PROXY에 해당하는 요청은 해당 Proxy 정책을 사용합니다. 일부 요청이 직접 연결된다는 이유만으로 구성이 작동하지 않는다고 판단하지 마세요. Data의 트래픽 변화는 데이터 전송 여부를 살펴보는 데 참고가 되지만, 트래픽이 늘었다는 사실만으로 특정 대상에 예상한 규칙이 적용됐다고 증명할 수는 없습니다.

원인을 더 분명히 구분하려면 같은 서버와 같은 대상을 유지한 채 Global Routing만 Config에서 Proxy로 바꾸고 다시 테스트하세요. Proxy에서는 정상이고 Config에서는 문제가 생기면 구성 파일과 규칙을 우선 확인합니다. 두 설정에서 모두 실패한다면 서버 매개변수와 네트워크 조건부터 살펴보세요. 비교가 끝나면 원래 필요한 처리 방식으로 되돌려 임시 문제 해결 설정이 평소 설정으로 남지 않게 하세요.

첫 테스트가 통과하면 평소 사용하는 다른 네트워크 환경에서도 연결과 대상 접속을 다시 확인할 수 있습니다. 네트워크를 바꾸기 전과 후의 결과를 각각 기록하고, 한 번 성공했다고 모든 환경에서 결과가 같다고 판단하지 마세요. 선택한 서버, 현재 처리 방식, 테스트 결과, 실제 접속 결과를 서로 연결해 설명할 수 있다면 이 페이지의 기본 검증은 완료된 것입니다. 트래픽 분기를 더 자세히 확인하려면 규칙 기반 트래픽 분기 관련 자주 묻는 질문을 읽어 보세요.

완료 기준: 스위치가 켜진 것만 확인하는 데 그치지 않고 대상 접속을 재현할 수 있으며, 현재 요청에 DIRECT 또는 PROXY가 적용된 이유를 설명할 수 있어야 합니다.

한 번에 한 항목씩 확인

Settings: 일반적인 실패 원인 점검 순서

앞선 단계에서 문제가 발생했다면 먼저 어느 단계에서 실패했는지 파악하세요. 구독에서 항목을 가져오지 못했는지, 항목은 있지만 연결되지 않는지, 스위치는 켜졌지만 테스트에 실패하는지, 특정 대상에만 문제가 있는지 구분합니다. 단계에 따라 확인할 위치가 다릅니다. 현재 구성과 오류 정보를 보존하고, 원인을 찾는 대신 항목을 반복해서 삭제하거나 재설치하거나 여러 매개변수를 동시에 바꾸지 마세요. 다음 순서에 따라 자료가 완전한지부터 확인한 뒤 연결과 설정을 점검합니다.

  1. 구독 가져오기 실패: 해당 구독으로 돌아가 링크가 온전한지, 접근 정보가 아직 유효한지, 현재 네트워크에서 구독 내용을 가져올 수 있는지 확인하세요. 링크에 접근할 수 있지만 서버가 표시되지 않는다면 응답 내용이 앱에서 인식할 수 있는 구독 형식인지도 확인해야 합니다. 오류 안내가 표시된 웹페이지 내용을 가져오기에 성공한 것으로 판단하지 마세요. 실제 서비스 상태는 본인이 이용 중인 서비스 제공자에게 확인하세요.
  2. 서버 한 대에 연결할 수 없음: 해당 항목의 편집 화면을 다시 열고 Type, Host, Port 및 해당 프로토콜에 필요한 인증, 암호화, 전송 매개변수를 하나씩 대조하세요. 이름이 비슷해도 프로토콜끼리 서로 바꿔 사용할 수 없습니다. 시험 삼아 Method나 다른 항목을 무작위로 바꾸지 마세요. 먼저 입력 내용과 원본 정보가 일치하는지 확인한 뒤 같은 항목으로 테스트하세요.
  3. 테스트 결과와 실제 접속 결과가 다름: Settings에서 Test Method를 확인하고 이번에 사용한 테스트 방식을 기록하세요. 테스트 방식에 따라 결과의 의미가 다르므로 같은 조건에서 비교해야 합니다. 그런 다음 Home으로 돌아가 실제로 선택된 서버와 Global Routing을 확인하세요. 한 항목을 테스트하고 다른 항목을 실제로 사용하고 있는 것은 아닌지 점검합니다.
  4. 연결이 바로 끊기거나 반복해서 시작됨: 시스템 권한 허용이 완료됐는지 확인하고 Settings에서 On Demand에 설정된 실행 조건을 살펴보세요. 수동 연결을 점검할 때 해당 조건이 현재 상태에 영향을 주는지 먼저 확인합니다. 조건에 따라 재연결되는 동작을 상단 스위치가 응답하지 않는 것으로 착각하지 마세요. 기기의 시스템 시간이 정확한지도 확인하고, 필요한 경우 시스템에서 제공하는 자동 설정을 사용하세요.
  5. 특정 네트워크나 대상에서만 실패: 서버와 구성을 그대로 둔 상태에서 본인이 사용할 수 있는 다른 네트워크와 비교하고 같은 대상을 테스트하세요. 네트워크를 바꿀 때만 문제가 생기면 네트워크 차이를 우선 기록하고, 특정 서버에서만 발생하면 해당 항목을 먼저 확인하세요. 필요한 경우 Diagnostics로 원인을 파악할 자료를 수집하세요. 문제와 관련 없는 TCP, UDP 설정을 곧바로 바꾸지 마세요.

진단 정보를 정리할 때는 문제 설명에 필요한 항목 이름, 오류 현상, 작업 순서만 남기세요. 공유하기 전에 전체 구독 링크, 비밀번호 및 기타 인증 정보를 가립니다. 추가 도움을 요청할 때는 실패 단계, 현재 처리 방식, 네트워크 환경, 테스트 방식, 각 항목을 하나씩 비교한 결과를 설명하는 것이 맥락 없는 스크린샷 한 장을 제공하는 것보다 대개 효과적입니다.

항목 하나를 수정한 뒤에는 ‘연결 → Connectivity Test → 실제 접속’ 순서로 다시 확인하세요. 결과가 달라졌을 때만 해당 항목이 문제와 관련 있는지 판단합니다. 원인을 찾지 못했다면 증상에 따라 자주 묻는 질문을 확인하세요. Settings나 프로토콜 항목의 의미를 모르겠다면 먼저 용어집을 읽어 보세요. 문제가 App Store 구매, 앱 표시 여부, 구입 항목 복원 단계에서 발생했다면 연결 매개변수를 더 조정하지 말고 구매 및 설치로 돌아가세요.

Shadowrocket Settings 공식 스크린샷: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 문제 해결을 위해 먼저 Test Method와 On Demand를 확인하세요. Diagnostics는 추가 진단 정보를 파악할 때 사용하며 모든 설정을 하나씩 수정할 필요는 없습니다.

마치기 전 확인: 임시로 변경한 Global Routing을 원래대로 되돌리고, 확인을 마친 서버와 구성을 유지한 상태에서 실제 대상에 예상대로 접속되는지 확인하세요.