OFFICIAL MANUAL / QUICKSTART

Shadowrocket
가져오기 및 연결 튜토리얼

5단계로 기본 연결을 완료하세요. 입력 정보를 확인하고 모드를 선택한 다음 연결 후 작동을 검증합니다. iPhone과 iPad에서 처음 사용하는 경우에 적합합니다.

공식 매뉴얼의 시작 절차입니다. 작업과 확인에 약 10분을 준비하세요. 규칙 문법과 체계적인 진단 방법은 문제 해결 매뉴얼을 참고하세요.

STEP 01 / IMPORT

서버 추가/기존 구독 가져오기

먼저 보유한 정보의 종류를 확인한 뒤 가져오기 방법을 선택하세요. 구독 주소는 일반적으로 갱신 가능한 서버 목록을 가져오는 데 사용하고, 단일 공유 링크는 하나의 서버 정보를 담고 있습니다. 직접 입력하는 서버 정보는 주소, 포트, 프로토콜, 인증 항목 등으로 구성됩니다. 세 가지는 서로 다릅니다. 주소가 특정 형식으로 시작한다는 이유만으로 아무 입력란에나 넣어서는 안 됩니다. 정보의 종류가 불분명하면 원본 안내를 확인하고, 프로토콜을 이것저것 바꿔 가며 가져오기를 시도하지 마세요.

Subscribe로 기존 구독 가져오기

  1. Shadowrocket을 열고 Home에서 오른쪽 위 더하기 버튼을 눌러 Add Server로 이동합니다. Type을 열어 Subscribe를 선택한 다음 본인의 구독 주소를 입력하세요.
  2. 구독을 알아보기 쉬운 이름으로 지정하고, 주소에 누락된 문자가 없으며 앞뒤 공백이나 복사 과정에서 들어간 줄바꿈이 없는지 확인하세요. 구독 주소에는 인증 정보가 포함될 수 있으므로 전체를 붙여넣고, 물음표 뒤의 내용을 임의로 삭제하지 마세요.
  3. 저장한 뒤 Home으로 돌아가 구독 정보를 가져올 때까지 기다립니다. 정상적으로 완료되면 목록에 구독 그룹과 서버가 표시됩니다. 구독 이름만 보이고 서버가 없다면 연결 스위치를 바로 켜지 말고 가져오기 실패 안내가 있는지 먼저 확인하세요.

Config 페이지에서는 구성 파일을 관리합니다. 구성 파일에는 규칙, DNS, 정책 등이 포함될 수 있으며 서버 구독과는 다릅니다. 처음 작업할 때는 추가하려는 정보가 어떤 종류인지 확인하세요. 서버 구독만 보유한 경우 위의 Add Server → Subscribe 경로로 가져오고, 이를 규칙 구성 파일로 사용하지 마세요. 완성된 구성을 보유한 사용자도 구성이 활성화되어 있는지와 서버 목록을 가져왔는지 각각 확인해야 합니다.

Add Server에서 서버 정보 입력

직접 입력할 서버 정보가 있다면 Add Server에서 Type을 원본 정보에 지정된 프로토콜로 설정하고 주소, 포트, 인증 정보를 차례대로 입력하세요. 프로토콜에 따라 입력 항목이 달라집니다. 암호화 방식, 전송 설정, TLS, 서버 이름은 원본 정보와 일치해야 합니다. 기본값이 있다는 이유로 항목을 생략할 수 있다고 판단하거나, 이해하지 못한 항목에 임의의 값을 넣지 마세요. 입력을 마치면 저장하고 Home으로 돌아가 이름과 서버가 표시되는지 확인합니다.

단일 공유 링크를 보유한 경우 복사한 뒤 앱에 가져오기 안내가 표시되는지 확인하고, 완료 전에 해석된 프로토콜과 주소를 점검하세요. QR 코드는 Scan QR Code를 사용할 수 있습니다. QR 코드에도 민감한 연결 정보가 포함될 수 있으므로 공개하지 마세요. 어떤 방법으로 가져오든 선택 가능한 서버 항목이 생성되어야 합니다. 이름이 표시되는 것은 가져오기 완료의 단서일 뿐, 설정이나 서비스가 정상이라는 증거는 아닙니다.

목록을 준비했다면 다음으로 트래픽 처리 방식을 정한 뒤 연결을 켭니다.

STEP 02 / GLOBAL ROUTING

Global Routing 세 가지 모드 선택

Home에서 Global Routing을 열고 Config, Proxy 또는 Direct를 선택할 수 있습니다. 여기서 설정하는 것은 전체 라우팅 모드이며 서버 프로토콜이 아닙니다. 잘못된 연결 정보를 바로잡아 주지도 않습니다. 처음 테스트할 때 선택한 모드를 기억해 두세요. 그렇지 않으면 웹페이지가 열려도 프록시 연결에 성공한 것인지 Direct 경로를 사용한 것인지 판단하기 어렵습니다.

모드처리 방식시작할 때의 용도
Config현재 활성화된 구성의 규칙과 정책에 따라 처리합니다.구성을 확인한 뒤 라우팅 결과를 점검합니다.
Proxy선택한 프록시 서버를 통해 연결합니다. 실제 동작은 앱과 시스템 설정의 영향을 받을 수 있습니다.첫 테스트를 간소화하고 프록시 경로가 작동하는지 확인합니다.
Direct현재 프록시 서버를 거치지 않고 대상에 직접 연결합니다.기본 네트워크를 점검하고 문제 해결을 위한 비교 기준으로 사용합니다.

가져온 서버가 작동하는지만 확인하려는 경우 Proxy를 선택하고 Home에서 테스트할 서버를 지정하세요. 규칙 매칭에 따른 변수를 일시적으로 줄일 수 있습니다. 테스트 후 일상적으로 사용할 모드를 결정하세요. Proxy 모드에서 웹페이지가 열린다고 해서 구성 규칙까지 올바르다는 뜻은 아닙니다. 두 모드는 서로 다른 항목을 확인하므로 따로 검증해야 합니다.

Config를 사용하기 전에 Config로 이동해 사용할 구성 파일이 활성화되어 있는지 확인하세요. 파일을 목록에 저장하기만 한 상태와 활성화된 상태는 다릅니다. 규칙은 보통 순서대로 매칭되며, 매칭 결과에 따라 연결에 적용할 정책이 결정됩니다. 서버를 가져온다고 해서 개인 용도에 맞는 라우팅 규칙이 자동으로 생성되는 것은 아니므로 서버 이름만 보고 특정 웹사이트가 프록시를 사용한다고 판단할 수 없습니다. 처음에는 규칙, DNS, 정책 그룹을 한꺼번에 수정하지 말고 검증 가능한 연결 경로부터 설정하세요.

Direct는 연결 스위치를 켜고 끈 상태의 기본 접속을 비교하는 데 사용할 수 있지만, 서버가 작동한다는 증거는 아닙니다. 대상 웹페이지가 Direct에서도 열리는 경우 모드를 바꾼 뒤에도 열렸다는 사실만으로 프록시가 적용됐다고 볼 수 없습니다. Home으로 돌아가 현재 Global Routing 모드와 선택한 서버를 다시 확인하세요. 모드와 서버를 모두 확인한 다음 연결을 승인합니다.

이 단계의 확인 사항: 현재 모드가 Config, Proxy, Direct 중 무엇인지 설명할 수 있어야 합니다. Config를 사용한다면 활성화된 구성 파일이 무엇인지, Proxy를 사용한다면 선택한 서버가 무엇인지 확인하세요.

STEP 03 / CONNECT

스위치를 켜고 연결 권한 승인

Home으로 돌아가 정보가 확인된 서버를 선택한 다음 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. 방금 직접 시작한 작업에 대한 안내인지 확인한 뒤 시스템 안내에 따라 승인하세요. 기기 인증이 필요할 수도 있습니다. 이 단계는 기기에서 앱이 해당 네트워크 연결 구성을 만들도록 허용하는 절차이며, 구매 안내가 아니고 서버 정보의 유효성을 확인해 주지도 않습니다.

  1. 현재 선택 항목을 먼저 확인하세요. 구독 그룹만 펼쳐 놓고 실제 서버는 선택하지 않았을 수 있습니다. 서버 여러 개를 비교할 때는 한 번에 하나씩 테스트하고 이름을 기록하세요.
  2. 연결 스위치를 켠 뒤 필요에 따라 시스템 권한 요청을 처리하세요. 이전에 권한 요청을 취소했다면 앱에서 연결을 다시 시작하고 안내가 다시 표시되는지 확인하세요. 앱을 먼저 삭제할 필요는 없습니다.
  3. 권한 승인이 끝나면 Home으로 돌아가 스위치가 계속 켜져 있는지, 앱에 연결 관련 상태가 표시되는지 확인하세요. 상태가 안정되기 전에 스위치를 연이어 반복해서 전환하지 마세요.

시스템의 VPN 상태는 해당 연결 구성이 사용 중임을 나타낼 뿐, 원격 서버에 도달할 수 있거나 모든 웹사이트가 로드된다는 뜻은 아닙니다. 일부 설정 오류는 실제 요청을 보낼 때만 드러납니다. 따라서 이 단계의 목표는 ‘앱이 기기에서 연결 상태를 설정할 수 있음’을 확인하는 것입니다. 다음 단계에서 테스트 결과와 실제 접속을 함께 확인해야 하며, 상태 표시만 보고 작업을 끝내지 마세요.

스위치가 바로 꺼지면 먼저 시스템 안내를 놓쳤거나 취소했는지 확인한 다음, 기기에서 다른 VPN 구성을 사용 중인지 점검하세요. 회사나 학교에서 관리하는 기기는 관리 정책의 제한을 받을 수 있으므로 해당 기기 관리 지침을 따르고, 알 수 없는 시스템 구성을 삭제하지 마세요. iPad와 iPhone은 화면 크기에 따라 레이아웃이 다를 수 있습니다. 특정 화면 위치를 무작정 누르기보다 Home, 서버 선택 항목, 연결 스위치를 기준으로 조작 위치를 찾으세요.

첫 검증 중에는 현재 네트워크를 그대로 유지하고 On Demand도 활성화하거나 변경하지 않는 것이 좋습니다. 주문형 연결은 이후 자동 연결 동작에 영향을 줄 수 있으므로 여러 설정을 동시에 바꾸면 자동 재연결을 스위치 오류로 오해하기 쉽습니다. 이미 On Demand를 설정했다면 먼저 상태를 기록하세요. 테스트를 마친 뒤 연결이 자동으로 다시 시작되면 같은 스위치를 반복해서 끄지 말고 해당 설정을 먼저 확인하세요.

이 단계의 확인 사항: 본인이 직접 권한을 승인했고 연결 스위치가 예상한 상태로 유지되는지 확인하세요. 시스템 VPN 표시만으로 원격 연결이 성공했다고 판단하지 마세요.

STEP 04 / VALIDATE

Connectivity Test 및 실제 접속 확인

연결을 켠 뒤 Connectivity Test를 실행해 선택한 서버의 결과를 확인하세요. 테스트 결과는 문제를 파악하는 단서가 됩니다. 시간 초과가 발생하면 서버와 기본 네트워크를 먼저 확인하고, 응답이 있다면 해당 테스트에서 결과를 받은 것입니다. 그러나 테스트 대상과 방식은 실제 웹페이지 요청과 완전히 같지 않습니다. 응답 시간이 표시된다고 웹페이지가 정상이라는 뜻은 아니며, 모든 프로토콜 기능이 검증된 것도 아닙니다. 숫자의 크기만으로 현재 용도에 적합한 연결인지 판단하지 마세요.

이어서 브라우저를 열고 익숙하며 접속 권한이 있는 웹페이지를 방문해 실제 콘텐츠가 로드되는지 확인하세요. 브라우저 캐시에 저장된 이전 페이지가 아닌지 확인하려면 페이지를 새로 고치고 다른 웹사이트도 테스트할 수 있습니다. 한 사이트만 확인하면 해당 사이트의 장애를 전체 연결 오류로 오해할 수 있습니다. 나중에 의미 있는 비교를 할 수 있도록 현재 네트워크, 선택한 서버, Global Routing 모드도 기록하세요.

  1. 기본 네트워크 확인. 연결이 끊겨도 괜찮은 상황에서 Shadowrocket을 끄고, 직접 접속이 가능해야 하는 웹페이지가 계속 로드되는지 확인하세요. 기본 네트워크에 문제가 있다면 먼저 Wi-Fi 로그인, 신호 또는 셀룰러 데이터 권한 등을 점검합니다.
  2. 프록시 경로 확인. 앱으로 돌아가 서버와 Proxy 모드가 선택되어 있는지 확인하고 연결을 다시 켠 뒤 대상에 접속하세요. 신뢰할 수 있는 별도의 출구 정보 확인 방법이 있다면 추가 근거로 활용할 수 있습니다. 웹페이지가 열리는지만으로 경로가 확인되는 것은 아닙니다.
  3. 규칙 경로 확인. 라우팅 규칙을 확인해야 한다면 Config로 전환해 요청을 다시 보내고, 앱에서 확인할 수 있는 연결 기록을 통해 적용된 정책을 점검하세요. 결론을 내릴 때 네트워크 변경이 영향을 주지 않도록 전환 전후의 테스트 조건을 기록해 두세요.

Proxy에서는 정상인데 Config에서 문제가 발생하면 서버를 바로 바꾸기보다 활성화된 구성과 매칭 정책을 먼저 확인하세요. 모든 모드에서 같은 웹페이지가 열리지 않는다면 웹사이트 자체, 기본 네트워크, DNS 문제도 고려해야 합니다. 브라우저에 이미 열린 연결이 모드 전환 후 확인 결과에 영향을 줄 수 있으므로 필요하면 관련 페이지를 닫고 다시 접속하세요. 한 번에 조건 하나만 바꿔야 어떤 단계에서 달라졌는지 알 수 있습니다.

검증을 마치면 실제로 사용할 Global Routing 모드를 선택해 두세요. 테스트용 Proxy를 계속 기본값으로 사용할 필요는 없으며, Config는 규칙이 예상대로 작동할 때 의미가 있습니다. 일상적으로 사용하기 전에 자주 쓰는 앱에서도 확인하세요. 웹페이지 테스트만으로는 각 앱의 연결 요구 사항을 모두 확인할 수 없습니다. 규칙 키워드와 DNS에 대한 자세한 내용은 용어집에서, 문제가 계속될 때의 점검 방법은 문제 해결 매뉴얼에서 확인하세요.

이 단계의 확인 사항: 테스트 결과와 실제 웹페이지 로드를 모두 확인하고 현재 모드를 명확히 파악하세요. Config를 사용한다면 스위치가 켜져 있는지만 확인하지 말고 규칙이 예상대로 작동하는지 확인해야 합니다.

STEP 05 / CHECKPOINTS

문제가 발생한 단계별로 한 번에 한 항목씩 확인

문제가 생기면 마지막으로 확인을 마친 단계부터 되짚어 보세요. 정보를 가져오지 못했는지, 스위치가 켜진 상태를 유지하지 못하는지, 테스트가 시간 초과되는지, 테스트 결과는 있지만 웹페이지가 열리지 않는지 구분합니다. 각 현상은 서로 다른 단계와 관련이 있습니다. 바로 앱을 다시 설치하거나 여러 설정을 한꺼번에 바꾸면 기존 상태가 사라져 원인을 찾기 어려워집니다. 기존 정보와 구성 이름을 먼저 저장하고 아래 순서대로 범위를 좁힌 뒤 추가 진단이 필요한지 판단하세요.

가져온 뒤 서버가 표시되지 않음: 정보 유형과 가져오기 결과 확인

붙여넣은 것이 구독 주소인지 구성 파일 주소인지 확인하고, 웹페이지 안내 주소를 구독 주소로 잘못 입력하지 않았는지 점검하세요. 원본 링크가 완전한지, 복사 과정에서 공백이 들어갔는지, 앱에 가져오기 실패 안내가 표시되는지도 확인합니다. 브라우저에서 구독 주소를 열어 페이지가 나온다고 해서 가져올 수 있는 서버 목록이 반환된다는 뜻은 아닙니다. 기존 구독의 유효 기간이나 접속 조건은 원래 이용하던 서비스 제공자에게 확인하세요. 공개된 게시판에 전체 주소, QR 코드 또는 인증 정보를 올리지 마세요. 목록이 이미 있다면 문제를 해결하려고 구독을 반복해서 삭제하지 말고 현재 사용할 수 있는 정보를 보존하세요.

스위치가 켜진 상태를 유지하지 못함: 시스템 권한 확인

3단계로 돌아가 VPN 구성 추가에 대한 시스템 안내를 취소했는지, 기기에 다른 VPN 구성이 사용 중인지 확인하세요. 관리 대상 기기는 관리 지침에 따라 처리합니다. 스위치를 끈 뒤 연결이 자동으로 다시 시작되면 On Demand가 활성화되어 있는지 확인해 자동 연결과 수동 스위치 문제를 구분하세요. 이 단계에서는 요청이 서버에 도달했는지 확인되지 않았으므로 DNS를 먼저 바꾸지 말고 기기 자체의 상태부터 점검합니다.

Connectivity Test 시간 초과: 서버와 네트워크 확인

먼저 테스트하려는 서버가 실제로 선택되어 있는지 확인한 다음 주소, 포트, 프로토콜, 인증 정보가 원본과 일치하는지 점검하세요. 구독에서 가져온 항목이라면 기존 정보를 보존하면서 구독을 업데이트해 내용이 바뀌었는지 확인할 수 있습니다. 이후 보유한 다른 서버와 비교하거나, 가능하면 Wi-Fi와 셀룰러 네트워크를 바꿔 테스트하세요. 매번 조건 하나만 변경합니다. 시간 초과만으로 어떤 설정이 잘못됐는지 확정할 수 없으며 한 번의 결과만으로 서비스 상태를 판단할 수도 없습니다.

테스트 결과는 있지만 웹페이지가 열리지 않음: DNS, 규칙, 대상 사이트 구분

먼저 정상적으로 작동하는 다른 웹페이지를 열어 한 사이트만의 문제인지 전반적인 문제인지 확인한 다음 Proxy와 Config를 비교하세요. Config에서만 실패한다면 현재 활성화된 구성과 적용된 정책을 점검합니다. 여러 대상의 주소가 모두 확인되지 않으면 DNS 설정이 변경되었는지 살펴보고 기존 값을 기록한 뒤 한 번에 한 항목만 조정하세요. 출처를 알 수 없는 구성 전체를 그대로 복사해 현재 설정을 덮어쓰지 마세요. 여러 변수가 동시에 바뀝니다. 테스트가 정상적으로 끝났더라도 웹페이지의 도메인 확인, 데이터 전송, 사이트 응답은 각각 실패할 수 있습니다.

위 단계를 거쳐도 원인을 찾지 못했다면 민감한 정보가 없는 기록을 준비하세요. 기기 종류, 현재 네트워크, 선택한 모드, 권한 승인 여부, 오류 안내 원문, 각 항목을 따로 비교하며 확인한 내용을 정리합니다. 서버 암호, 전체 구독 주소, 인증 정보는 기록에 포함하지 마세요. 증상에 따라 문제 해결 매뉴얼을 참고하거나 자주 묻는 질문에서 관련 안내를 확인할 수 있습니다. 모든 설정을 처음부터 다시 할 필요는 없습니다.