공식 매뉴얼 · 첫 연결 절차
Shadowrocket 빠른 시작
구독 가져오기, 연결 및 확인
이 페이지는 iPhone·iPad 화면을 기준으로 설명합니다. 기존 정보를 정확히 가져온 뒤 Global Routing을 선택하고, 실제 접속으로 결과를 확인합니다. 처음 조작할 때는 다섯 단계를 순서대로 진행하면 됩니다. 모든 설정을 한꺼번에 변경할 필요는 없습니다.
- 01 정보 가져오기
- 02 모드 선택
- 03 연결 승인
- 04 결과 확인
- 05 실패 원인 찾기
구독 링크가 전체 복사되는지 확인하거나, 서버 정보에 프로토콜 유형, 주소, 포트와 필요한 인증 필드가 포함되어 있는지 확인합니다. 구독 링크에는 개인 접근 정보가 포함될 수 있으므로 공개 댓글, 스크린샷 또는 채팅방에 올리지 마세요. 기존 구성이 있다면 이 페이지의 절차를 진행하기 전에 원래 구성을 저장하는 것이 좋습니다. 문제가 생겼을 때 이전 상태로 복원하면 알 수 없는 설정을 연속해서 시도하는 것보다 원인을 파악하기 쉽습니다.
아래 이미지는 App Store 공식 스크린샷으로, Home, Add Server, Config 및 Settings의 위치를 확인하는 데 사용됩니다. 앱 업데이트에 따라 화면 배치가 달라질 수 있으므로 실제 조작 시에는 기기에 표시되는 영어 인터페이스 용어와 필드를 기준으로 하세요. 자세한 구성 관리는 구독 관리 매뉴얼에서 확인하세요. 이 페이지에서는 첫 연결에 필요한 최소 절차만 다룹니다.
STEP 01 / IMPORT
Add Server: 서버 추가 또는 구독 가져오기
Shadowrocket을 열고 Home으로 이동합니다. 처음 실행하면 SERVER 그룹에 사용할 수 있는 항목이 없을 수 있습니다. 연결 정보가 아직 추가되지 않은 상태입니다. Add Server를 찾아 추가 화면으로 이동한 뒤, 현재 보유한 정보가 구독 링크인지, 단일 서버 공유 링크인지, 직접 입력해야 하는 필드인지 확인하고 해당 방식을 선택합니다. 서로 다른 정보를 모두 Host 주소로 입력하지 마세요.
기존 구독: Subscribe 선택
Add Server의 Type에서 Subscribe를 선택하고 전체 구독 링크를 URL 필드에 붙여 넣습니다. 붙여 넣은 뒤 앞뒤와 중간의 쿼리 매개변수를 확인해 설명 문구, 줄바꿈 또는 공백이 함께 들어가지 않았는지 점검합니다. 메모에는 “개인 구독”처럼 알아보기 쉬운 이름을 사용할 수 있습니다. 이름은 관리용일 뿐 실제 링크를 대신하지 않습니다. 확인 후 저장하고 앱이 구독을 읽을 때까지 기다린 다음 Home으로 돌아가 해당 그룹과 서버 항목을 확인합니다.
구독 정보를 저장했다고 해서 서버 목록을 반드시 정상적으로 가져온 것은 아닙니다. 그룹이 비어 있거나 읽기 실패가 표시되면 링크가 완전한지, 현재 네트워크에서 해당 주소에 접근할 수 있는지, 링크가 아직 유효한지 먼저 확인합니다. 읽기 문제를 해결하려고 같은 구독을 반복해서 추가하지 마세요. 목록이 복구된 뒤 중복 항목이 생길 수 있습니다. 구독 업데이트와 그룹 정리에 관한 자세한 내용은 Subscribe 관리 섹션을 참고하세요.
기존 서버 정보: 필드를 하나씩 확인
직접 추가할 때는 먼저 Type을 선택한 뒤 해당 유형에 필요한 필드를 입력합니다. Host에는 서버 주소, Port에는 포트를 입력합니다. Password, Method 등의 필드는 사용자가 보유한 정보에 맞춰 그대로 입력합니다. 프로토콜마다 요구 사항이 다르므로 스크린샷에 표시된 필드가 모든 프로토콜의 공통 필수 항목은 아닙니다. 프로토콜 이름이 비슷하다는 이유로 유형을 바꾸거나 전체 공유 링크를 Host에 붙여 넣지 마세요. 경로, 전송 방식 또는 다른 매개변수가 포함된 정보도 각각 정확히 맞춰 입력해야 합니다.
기존 QR 코드가 있다면 Scan QR Code로 읽을 수 있습니다. 스캔한 뒤에도 해석된 Type과 서버 주소를 확인하세요. 클립보드에 지원되는 공유 링크가 있다면 앱에서 제공하는 가져오기 안내를 사용할 수 있으며, 저장 전에 결과를 확인합니다. Import from Cloud JSON은 별도의 가져오기 방법입니다. 일반 구독 링크나 임의의 텍스트를 해당 파일 형식으로 취급하지 마세요. 필드의 의미가 불분명하면 인증 매개변수를 추측하지 말고 용어집을 먼저 확인하세요.
가져오기를 마치면 Home으로 돌아가 SERVER 목록에서 사용할 서버를 선택하고 선택 표시가 해당 항목에 있는지 확인합니다. 이 단계에서는 연결 정보를 준비했을 뿐, 트래픽 처리 방식이나 연결은 아직 설정하지 않았습니다. 다음 단계에서 Global Routing을 확인해 연결 후 모드와 사용 목적이 달라지는 상황을 방지합니다.
STEP 02 / ROUTING
Global Routing: 트래픽 처리 모드 선택
서버가 목록에 나타나면 Home으로 돌아와 Global Routing을 엽니다. 여기서 선택하는 것은 트래픽 처리 방식이며, 서버 프로토콜이나 시스템 연결 권한이 아닙니다. 세 가지 모드는 Config, Proxy, Direct입니다. 현재 목적에 맞는 모드를 선택한 다음 연결하세요. 모드 변경이 모든 문제를 해결하는 일반적인 방법은 아닙니다.
Config: 현재 구성의 규칙에 따라 처리
일상적인 규칙 기반 분기가 필요하면 Config를 사용합니다. 앱은 현재 적용된 구성의 규칙에 따라 대상 요청을 처리하며, 일치하는 정책은 DIRECT, PROXY 또는 REJECT일 수 있습니다. 따라서 연결이 켜져 있어도 모든 요청이 선택한 서버를 통과하는 것은 아닙니다. Config에 들어가 현재 사용할 구성이 선택되어 있는지 확인합니다. 목록에서 파일을 보기만 하는 것으로 해당 구성이 적용됐는지 확인할 수는 없습니다.
공식 스크린샷에는 Config 편집 페이지의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션이 표시됩니다. 첫 연결 시 각 섹션을 수정할 필요는 없으며 구독을 가져오려고 모든 기능을 활성화할 필요도 없습니다. 구독은 주로 서버 목록을 가져오고 업데이트하는 기능이며, Config는 규칙 등 구성 내용을 결정합니다. 두 설정은 서로 다릅니다. 기존 구성이 사용 목적에 맞으면 내용을 유지하고 정상 접속을 확인한 뒤 세부 조정을 진행하세요.
Proxy 및 Direct: 명확한 경로 확인
Proxy는 해당 모드에서 트래픽을 선택한 프록시를 통해 처리합니다. 서버 경로를 비교할 때 사용할 수 있습니다. 서버 측이 정상임을 보장하지 않으며 프로토콜 매개변수 오류를 해결하지도 않습니다. Direct는 선택한 프록시 서버를 통하지 않고 직접 연결합니다. 기존 프록시 서버의 작동 여부를 확인하려는 경우 Direct 상태에서 웹페이지를 방문해도 해당 서버가 정상이라는 것을 증명할 수 없습니다.
현재 선택한 모드를 기억해 두세요. 확인된 구성이 있으면 먼저 Config를 사용합니다. “서버 문제”와 “규칙 문제”를 구분해야 한다면 Proxy로 잠시 비교한 뒤 원래 모드로 되돌릴 수 있습니다. 규칙을 바꾸면서 서버와 모드도 동시에 변경하면 결과의 원인을 파악하기 어렵습니다. 규칙 일치 순서와 각 정책의 의미는 공식 구독 관리 매뉴얼과 규칙 용어집에서 확인할 수 있습니다. 모드를 확인한 뒤 Home으로 돌아가 연결을 시작합니다.
STEP 03 / CONNECT
Home: 스위치를 켜고 시스템 권한 확인
Home으로 돌아와 두 가지를 확인합니다. SERVER에서 올바른 서버를 선택했는지, Global Routing이 앞 단계에서 정한 모드인지 확인합니다. 확인한 뒤 화면 상단의 연결 스위치를 켭니다. 공식 스크린샷의 Not Connected는 아직 연결되지 않은 상태를 의미합니다. 서버가 목록에 있거나 테스트 결과가 표시된다는 이유만으로 연결이 시작된 것은 아닙니다.
처음 연결할 때 시스템에서 VPN 구성을 추가할지 확인하는 창이 표시될 수 있습니다. 앱이 시스템 네트워크 연결을 설정하는 데 필요한 권한 절차입니다. 요청한 앱이 Shadowrocket인지 확인하고 안내를 읽은 뒤 시스템 지시에 따라 승인합니다. 기기에 따라 잠금 화면 암호 입력이나 인증이 필요할 수 있습니다. 완료한 뒤 앱으로 돌아와 연결 상태가 바뀌었는지 확인합니다. 시스템 권한과 서버 계정 인증은 서로 다릅니다. 서버 Password를 기기 잠금 화면 암호 입력란에 넣지 마세요.
이전에 권한 요청을 취소했다면 스위치가 켜진 상태로 유지되지 않을 수 있습니다. 이 경우 구독을 다시 가져오는 대신 연결을 다시 시작하고 시스템 안내에 따라 처리합니다. 기기에 다른 VPN 연결이 있거나 기기 관리 정책이 제한하는 경우에도 연결에 영향을 줄 수 있습니다. 먼저 시스템 설정에서 현재 VPN 상태를 확인하고 동시에 실행할 필요가 없는 연결을 종료합니다. 회사나 학교에서 관리하는 기기는 관리 정책을 따르고 관리 프로파일을 임의로 삭제하지 마세요.
스위치를 켠 뒤 잠시 기다리며 바로 연결이 끊어지는지 확인합니다. 연결이 유지되면 다음 단계로 넘어갑니다. 바로 끊긴다면 표시되는 오류나 당시 상태를 기록하고 이 페이지의 문제 점검을 확인합니다. 스위치를 빠르게 반복해서 켜고 끄지 마세요. 시스템에 표시되는 VPN 상태는 관련 연결 상태만 나타내며 모든 대상 요청이 성공했거나 Config의 모든 규칙이 예상대로 작동한다는 뜻은 아닙니다.
첫 연결을 설정하는 동안 네트워크를 바꾸거나 Type을 수정하거나 규칙을 편집하지 마세요. 조건을 일정하게 유지해야 이후 결과의 원인을 파악하기 쉽습니다. 사용을 마치려면 Home으로 돌아가 스위치를 끄고 연결이 중단됐는지 확인합니다. On Demand를 활성화한 적이 있다면 조건에 따라 다시 연결될 수 있습니다. 자동 재연결을 스위치 오류로 오해하지 않도록 첫 점검 단계에서 현재 설정을 확인하세요.
STEP 04 / VERIFY
Connectivity Test: 연결과 실제 접속 확인
연결 상태가 유지되면 Home에서 Connectivity Test를 사용합니다. 이 기능은 해당 테스트 대상에 연결되는지 확인하며 결과는 테스트 방법, 현재 네트워크와 대상의 응답에 따라 달라집니다. 테스트 성공은 참고 자료일 뿐 모든 웹사이트, 앱 또는 프로토콜이 사용 가능하다는 뜻은 아닙니다. 테스트가 실패하더라도 대상이 응답할 수 있는지 함께 살펴야 하며, 한 번의 결과만으로 구독 전체가 무효라고 판단할 수 없습니다.
- 현재 조건을 유지합니다.선택한 서버와 Global Routing 모드를 기록하고 Connectivity Test를 한 번 실행해 결과가 반환되는지, 시간 초과가 표시되는지 확인합니다. 테스트 중에는 구독을 업데이트하거나 서버를 바꾸지 마세요.
- 실제 페이지를 엽니다.브라우저로 이동해 평소 정상적으로 제공되는 익숙한 페이지에 접속합니다. 이미 캐시된 내용만 확인하지 말고 새 페이지를 열거나 새로고침합니다. 기존 페이지가 표시된다고 해서 새 연결 요청이 성공했다는 뜻은 아닙니다.
- 예상 경로와 비교합니다.Config 모드에서는 일부 대상이 규칙에 따라 직접 연결되는 것이 정상일 수 있습니다. 특정 대상이 프록시를 거치는지 확인하려면 앱에서 볼 수 있는 연결 기록과 일치한 정책을 함께 확인합니다. 페이지가 열리는지만으로 판단하지 마세요.
테스트 결과가 반환되는데 실제 페이지가 로드되지 않으면 먼저 문제가 한 대상에서만 발생하는지 확인한 다음 대상 요청의 규칙과 DNS 상태를 점검합니다. 페이지에 정상적으로 접속되지만 테스트가 계속 실패한다면 Test Method와 테스트 대상을 확인하세요. 모든 구성을 바로 삭제하지 마세요. 지연 시간은 해당 테스트 조건에서의 응답을 나타내며 파일 다운로드 속도와 같지 않습니다. 지연 시간만으로 장시간 연결의 안정성을 판단할 수도 없습니다.
첫 확인은 “스위치가 유지되고, 실제 요청이 완료되며, 라우팅이 예상과 일치하는지”를 기준으로 마칩니다. 특정 수치를 얻으려고 계속 정렬하거나 전환할 필요는 없습니다. 확인이 끝나면 현재 정상 작동하는 설정을 유지한 채 필요한 기능을 하나씩 조정합니다. On Demand나 복잡한 규칙을 추가하려면 먼저 구독 관리 매뉴얼을 읽고, 설정을 한 번에 하나씩 변경한 뒤 이 단계의 확인을 다시 수행합니다.
STEP 05 / DIAGNOSE
Settings: 실패 단계에 따라 하나씩 점검
문제가 생기면 막연히 “연결할 수 없음”이라고 하기보다 어느 단계에서 실패했는지 구분하는 것이 도움이 됩니다. 현재 구성을 유지하고 다음 순서로 확인하세요. 각 항목을 확인한 뒤 관련 단계만 다시 수행합니다. 앱 재설치, 목록 삭제, 네트워크 변경을 동시에 하면 원인을 찾는 데 필요한 단서가 사라질 수 있습니다.
가져온 뒤 항목이 없음: 입력 정보와 업데이트 확인
가져온 정보가 구독 링크인지 단일 서버 공유 링크인지 먼저 확인한 다음 Type과 입력 위치를 점검합니다. 구독 목록이 비어 있다면 URL이 완전하고 불필요한 공백이 없는지 확인하고 업데이트 시 오류가 반환되는지 살펴봅니다. 서버 정보는 사용자가 기존에 보유한 구독에 따라 달라지므로 앱이 누락된 필드를 임의로 채울 수는 없습니다. 구독 주소에 인증 정보가 있다면 링크를 공개하지 마세요. 정보의 유효성을 확인해야 하는 경우 기존 정보 관리 경로를 통해 확인합니다.
스위치가 유지되지 않음: 권한과 시스템 상태 확인
첫 VPN 권한 승인이 완료됐는지 확인한 다음 시스템의 현재 VPN 상태와 기기 관리 제한 여부를 살펴봅니다. 스위치를 켜자마자 꺼지면 Method를 바꾸거나 규칙을 추가하기 전에 앱에 표시되는 오류를 기록합니다. 앱에서 연결을 실제로 시작할 수 있어야 서버 네트워크 경로를 테스트할 수 있습니다. 앱이나 기기를 재시작해 복구를 시도할 수는 있지만 구체적인 오류 확인을 대신하지는 않습니다.
연결됐지만 접속이 되지 않음: 서버와 규칙 확인
서버 정보를 직접 입력했다면 Type, Host, Port와 인증 필드를 대조합니다. 서버를 가져온 경우에는 현재 선택한 항목이 여전히 유효한지 확인합니다. 같은 네트워크에서 잠시 Proxy를 사용해 비교한 뒤 원래 모드로 되돌릴 수 있습니다. Proxy는 정상이고 Config에서 문제가 발생한다면 현재 구성, 대상에 일치한 정책과 DNS를 중점적으로 확인합니다. 두 모드 모두 실패하면 가능한 경우 Wi-Fi와 셀룰러 네트워크를 한 번 전환해 로컬 네트워크의 영향을 구분합니다. 네트워크 전환으로 데이터 요금이 발생할 수 있으니 기기 설정을 먼저 확인하세요.
일부 상황에서만 실패: 테스트 방법과 기록 확인
Settings에서 Test Method, On Demand, Diagnostics, Proxy, TCP, UDP 등의 설정을 볼 수 있습니다. 현재 테스트에 Test Method가 적합한지 먼저 확인하고 한 번의 실패만으로 TCP 및 UDP 관련 옵션을 동시에 변경하지 마세요. 특정 앱이나 대상에서만 문제가 생기면 발생 조건, 사용한 모드와 대상 범위를 기록합니다. On Demand에 따른 자동 연결 동작도 별도로 확인해 수동 연결 문제와 혼동하지 않도록 합니다.
추가로 원인을 파악해야 한다면 Diagnostics에서 관련 기록을 확인하거나 수집합니다. 기록을 공유하기 전에 구독 URL, 서버 주소, 암호 또는 다른 개인 정보가 포함되어 있는지 확인하고 문제 재현에 필요한 부분만 남깁니다. 다른 문제는 분류별로 질문과 답변 및 문제 해결을 확인하세요. 여러 구독의 업데이트, 중복 항목, 백업과 복원은 구독 관리 매뉴얼을 참고하세요. 점검을 마치면 임시 변경 사항을 되돌리고 연결과 확인 단계를 다시 수행해 전체 과정을 점검합니다.