공식 가이드 · 사용 안내
Shadowrocket 사용 가이드 구독 가져오기 및 연결 확인
“정보 준비 → 가져오기 → 라우팅 선택 → 연결 → 확인” 순서로 진행합니다. 먼저 서버 하나로 전체 과정을 확인한 뒤 구독과 규칙을 정리하면 여러 설정을 동시에 바꾸는 일을 피할 수 있습니다.
처음 사용하는 경우 첫 단계부터 진행하는 것을 권장합니다. 목록은 있지만 접속할 수 없다면 먼저 네 번째 단계에서 증상을 확인한 뒤 다섯 번째 단계에 따라 원인을 찾으세요. 기존 설정은 당장 삭제하지 마세요.
STEP 01 / IMPORT
서버 추가 또는 기존 구독 가져오기
먼저 가지고 있는 정보가 서버 목록을 업데이트하는 구독 링크인지, 서버 주소와 포트 및 인증 매개변수인지 확인합니다. 두 정보는 입력 위치가 다르므로 구독 링크를 서버 주소란에 직접 입력하면 안 됩니다. Shadowrocket을 열고 Home으로 이동해 기존 목록을 확인합니다. 같은 출처의 그룹이 이미 있다면 중복 항목이 생기지 않도록 기존 그룹을 업데이트할지 먼저 확인하세요.
기존 구독 링크: Add Server에서 Subscribe 선택
Home 오른쪽 위의 추가 버튼을 누른 다음 Add Server로 이동합니다. Type 선택 항목을 열어 Subscribe를 선택하고 전체 구독 링크를 URL란에 붙여 넣습니다. 알아보기 쉬운 이름을 입력하고 저장한 뒤 Home으로 돌아와 구독 내용이 로드될 때까지 기다립니다. 이름은 항목을 구분하기 위한 것이며 구독의 연결 매개변수를 변경하지 않습니다.
붙여 넣기 전에 링크가 완전한지 확인하세요. 특히 끝부분의 매개변수가 메신저에서 줄바꿈되거나 잘리지 않았는지, 공백이 붙지 않았는지 살펴봅니다. 구독 주소에는 개인 액세스 인증 정보가 포함되는 경우가 많으므로 도메인이 같다는 이유만으로 두 링크가 같다고 판단할 수 없습니다. 링크를 다시 받아야 한다면 본인의 서비스 제공자에게 전체 링크를 요청하세요. 다른 사람이 제공한 매개변수를 조합하거나 출처가 불분명한 웹페이지에 링크를 입력하지 마세요.
Home으로 돌아오면 그룹과 서버 항목이 표시되어야 합니다. 그룹 이름만 보이고 내용이 없다면 먼저 업데이트 실패 안내가 있는지 확인한 다음 현재 네트워크에서 구독 내용을 가져올 수 있는지 확인하세요. 구독 업데이트 실패와 특정 서버 연결 실패는 서로 다른 단계의 문제입니다. 전자는 목록을 가져오지 못한 것이고, 후자는 매개변수가 있는 상태에서 연결을 설정하지 못한 것이므로 이후 점검 과정에서 혼동하지 마세요.
단일 서버 정보가 있는 경우: Type 및 매개변수 확인
단일 서버 정보를 가지고 있다면 Add Server에서 시작하되 Type은 Subscribe가 아니라 정보에 해당하는 프로토콜을 선택합니다. 원래 제공된 정보에 따라 서버 주소, 포트 및 인증 정보를 입력합니다. 프로토콜마다 표시되는 필드가 다를 수 있습니다. 비밀번호, 암호화 방식 또는 기타 연결 매개변수는 실제 서버 설정을 따르며, 다른 가이드의 예시 값으로 대체하면 안 됩니다.
추가 전송 및 TLS 관련 옵션은 정보에서 명시적으로 요구하는 경우에만 입력합니다. 도메인, 경로 및 기타 필드는 대소문자를 구분할 수 있으며, 항목 하나가 빠져도 연결에 실패할 수 있습니다. 가져올 수 있는 QR 코드가 있다면 앱에서 제공하는 Scan QR Code를 사용할 수 있습니다. 가져온 뒤에도 항목을 열어 프로토콜과 주소가 예상한 내용인지 확인하세요. QR 코드는 정보를 담는 수단일 뿐 서버의 유효성을 증명하지 않습니다.
저장한 뒤 Home으로 돌아와 사용할 서버를 눌러 현재 선택된 서버로 설정되었는지 확인합니다. 테스트 대상을 하나로 명확히 정하고 매번 테스트 전에 임의로 전환하지 마세요. 이 단계에서 완료된 것은 “연결 정보를 앱에 추가”한 것입니다. 트래픽 처리 방식을 선택하고 시스템 연결을 설정해야 합니다.
STEP 02 / GLOBAL ROUTING
Global Routing 모드 선택
Home에서 Global Routing을 엽니다. 이 설정은 트래픽을 처리하는 방식을 결정하며 현재 선택된 서버와는 별개의 설정입니다. 처음 사용하는 경우 현재 선택 항목을 확인한 뒤 목적에 따라 Config / Proxy / Direct를 선택합니다. 선택 후 Home으로 돌아오고, 옵션 화면에 머물러 실제 적용 상태를 놓치지 않도록 하세요.
Config: 현재 설정의 규칙에 따라 처리
Config는 현재 사용 중인 설정에 따라 요청의 경로를 결정합니다. 규칙에 따라 일부 요청은 PROXY로, 다른 요청은 DIRECT로 전달되거나 REJECT 처리될 수 있습니다. 따라서 서버를 선택했다고 해서 모든 요청이 그 서버를 거치는 것은 아닙니다. 현재 환경에 적합한 신뢰할 수 있는 설정이 있다면 먼저 Config로 이동해 어떤 설정이 활성화되어 있는지 확인한 다음 Global Routing에서 Config를 선택합니다.
구독과 설정을 혼동하지 마세요. Subscribe는 주로 서버 정보를 가져오고 업데이트하는 기능이며, Config에는 규칙 등의 설정이 포함됩니다. 구독을 가져왔다고 해서 필요한 분할 라우팅 규칙까지 가져온 것은 아닙니다. 처음 확인할 때는 DOMAIN-SUFFIX, GEOIP 또는 FINAL을 바로 편집할 필요가 없습니다. 현재 설정과 용도를 먼저 확인하고, 복잡한 규칙 문제는 분할 라우팅 관련 자주 묻는 질문을 참고하세요.
Proxy: 프록시 연결 비교 확인
규칙이 일치하지 않는 것인지 현재 서버를 사용할 수 없는 것인지 확실하지 않다면 Proxy를 잠시 선택하고 같은 서버와 테스트 페이지를 유지한 채 비교 테스트를 할 수 있습니다. Proxy 모드로 트래픽을 처리하는 테스트이며 모든 시스템 트래픽이 반드시 같은 경로를 거친다고 판단해서는 안 됩니다. Proxy에서는 접속되지만 Config에서는 실패한다면 구독을 바로 삭제하기보다 현재 설정, 매칭 정책 및 이름 확인을 중점적으로 살펴보세요.
Direct: 직접 접속 경로 확인
Direct는 트래픽을 직접 연결 방식으로 처리하며 프록시 서버의 유효성을 확인하는 데 적합하지 않습니다. 기본 네트워크 확인의 일부로 사용할 수 있지만 시스템 연결을 끄는 것과 완전히 같은 작업은 아닙니다. 테스트가 끝나면 Global Routing에서 필요한 모드로 되돌리고 현재 설정을 기록해 두세요. 이후 각 테스트가 Config, Proxy, Direct 중 어떤 모드에서 진행되었는지 명확히 해야 합니다.
STEP 03 / CONNECT
연결 스위치를 켜고 시스템 권한 부여
Home으로 돌아가 서버 선택과 현재 Global Routing 항목을 차례로 확인한 다음 상단의 연결 스위치를 켭니다. 처음 연결을 설정할 때 시스템에서 VPN 설정 추가 권한을 요청할 수 있습니다. Shadowrocket에서 직접 연결을 시작한 직후 나타난 안내인지 확인한 다음 허용하고 기기의 안내에 따라 암호 또는 생체 인증을 완료합니다. 여기서 허용하는 것은 시스템 네트워크 연결을 설정하는 데 필요한 구성이지, 서버의 누락된 매개변수를 자동으로 채우는 작업이 아닙니다.
안내에서 취소를 선택했다면 앱이 연결을 계속 진행하지 못할 수 있습니다. Home으로 돌아가 다시 시도하면서 권한 창이 다시 표시되는지 확인하세요. 계속 진행할 수 없다면 시스템의 Settings에서 VPN 관련 설정과 상태를 확인합니다. 시스템 버전에 따라 메뉴 이름이 다를 수 있으므로 기기에 실제로 표시되는 내용을 기준으로 하세요. 문제 해결을 위해 업무용 또는 학교 관리 네트워크 설정을 임의로 삭제하지 마세요. 관리 기기라면 먼저 관련 제한을 확인해야 합니다.
권한 부여를 마치고 앱으로 돌아와 스위치가 켜진 상태를 유지하는지, 시스템에 VPN 연결이 설정된 것으로 표시되는지 확인합니다. 스위치가 바로 꺼지면 앱 안내를 기록한 다음 권한 상태와 현재 서버 정보를 확인하세요. 빠르게 반복해서 누르지 마세요. 기기에 다른 VPN 연결이 있다면 전환 중 이전 상태를 이번 작업의 결과로 오인하지 않도록 현재 연결을 어떤 항목이 관리하는지 확인합니다.
연결 스위치가 켜진 상태를 유지하는 것은 연결 과정이 다음 단계에 들어갔다는 뜻일 뿐, 대상 웹사이트에 접속할 수 있다는 증거는 아닙니다. 서버 인증, 도메인 확인, 원격 서버의 가용성 및 규칙 처리에 문제가 있을 수 있으므로 다음 단계에서 실제 접속을 확인해야 합니다. 이때는 먼저 On Demand 같은 자동 연결 옵션을 조정하지 마세요. 수동 연결 절차가 안정된 뒤 자동화를 검토하면 점검 변수를 줄일 수 있습니다.
STEP 04 / VERIFY
Connectivity Test 및 실제 접속 확인
먼저 앱에서 Connectivity Test를 사용해 현재 서버의 테스트 결과를 확인합니다. 테스트 결과는 특정 방법과 대상의 응답을 나타내므로 초기 단서로 사용할 수 있지만 모든 웹사이트, 앱 또는 전송 방식이 정상 작동한다는 뜻은 아닙니다. 응답이 있더라도 대상 페이지에 접속해 확인해야 합니다. 응답이 없을 때도 실제 접속과 오류 안내를 함께 살펴보세요. 단일 결과만 보고 모든 설정을 변경하면 안 됩니다.
연결을 유지한 상태에서 브라우저를 열고 내용이 정상인지 알아볼 수 있는 익숙한 페이지에 접속합니다. 필요하면 새로고침하거나 새 페이지를 열어 이전 캐시의 영향을 줄입니다. 먼저 페이지가 로드되는지 확인하고 로그인, 이미지 또는 기타 필요한 내용이 정상인지 살펴봅니다. 브라우저에 저장된 페이지를 확인하기만 하면 네트워크가 끊겨도 일부 내용이 보일 수 있으므로 연결 성공의 근거로 삼을 수 없습니다.
다음으로 용도가 다른 페이지를 하나 더 열어 비교합니다. 현재 네트워크가 Wi-Fi인지 셀룰러인지, Global Routing 옵션, 현재 서버 및 접속 증상을 기록하세요. 두 페이지의 결과가 다르더라도 바로 클라이언트 전체의 문제로 단정하지 마세요. 규칙 경로가 다르거나 대상 웹사이트의 상태, DNS 또는 원격 연결 조건이 다를 수 있습니다.
규칙이 예상대로 작동하는지 판단하려면 앱에서 제공하는 연결 기록이나 진단 정보를 확인하고 대상 도메인에 해당하는 처리 정책을 찾습니다. Config에서 DIRECT로 표시되어도 반드시 오류인 것은 아니며 규칙의 예상 용도에 따라 판단해야 합니다. PROXY를 사용해야 하는 요청이 실제로 다른 정책을 따르는 경우에만 해당 설정을 확인하세요. Data의 트래픽 변화를 참고할 수 있지만 특정 페이지가 지정된 서버를 거쳤다는 것을 단독으로 증명하지는 않습니다.
Proxy 또는 Direct로 잠시 변경했다면 필요한 Config로 되돌린 다음 같은 페이지를 다시 확인합니다. 대상 라우팅 모드에서도 정상 결과가 재현되어야 이번 절차가 완료된 것입니다. 결과가 다르면 기존 설정과 테스트 기록을 보존하고 다음 단계에서 항목별로 점검하세요. 원인을 찾는 대신 반복해서 재설치하지 마세요.
STEP 05 / TROUBLESHOOT
일반적인 문제를 순서대로 점검
문제를 점검할 때는 한 번에 조건 하나만 바꾸고 네 번째 단계의 동일한 테스트를 반복합니다. 먼저 문제가 “구독을 로드할 수 없음”, “연결 스위치가 유지되지 않음”, “연결되었지만 모든 페이지 접속 실패” 또는 “일부 페이지만 접속 실패” 중 어디에 해당하는지 기록합니다. 네 가지 증상은 서로 다른 단계와 관련이 있습니다. 증상을 구분하면 서버, 설정, DNS를 한꺼번에 바꾸는 것보다 유효한 해결책을 찾기 쉽습니다.
기본 네트워크 확인 후 구독 내용 점검
Shadowrocket 연결을 끄고 현재 네트워크에서 평소 직접 접속할 수 있는 페이지가 열리는지 확인합니다. 공용 Wi-Fi는 먼저 네트워크 로그인이 필요할 수 있습니다. 기본 네트워크를 사용할 수 없다면 네트워크 문제부터 해결하세요. 그런 다음 앱으로 돌아가 보유한 구독을 업데이트합니다. 업데이트에 실패하면 링크의 완전성, 서비스 상태 및 표시된 안내를 확인합니다. 업데이트는 성공했지만 항목이 없다면 본인의 서비스 제공자에게 링크 내용과 유효 상태를 확인하세요.
같은 링크를 계속 다시 추가해 문제를 해결하려고 하지 마세요. 목록만 더 구분하기 어려워집니다. 기존 항목이 계속 표시된다고 업데이트 성공의 증거로 간주해서도 안 됩니다. 이전 목록이 그대로 남아 있을 수 있습니다. 문제를 전달할 때는 오류 안내와 발생 단계를 설명하고, 구독 링크의 개인 매개변수는 공개 화면이나 메시지에 포함하지 마세요.
연결 실패: 매개변수와 시스템 권한 확인
Home에 서버가 표시되지만 연결에 실패한다면 해당 항목을 열어 Type, 주소, 포트, 인증 정보 및 제공된 자료에서 요구하는 추가 필드를 하나씩 비교합니다. 명백히 일치하지 않는 항목부터 수정하고 모든 옵션을 무작정 바꾸지 마세요. 수동 입력 중 매개변수 누락, 만료된 가져오기 정보, 기기의 시스템 권한 미완료 등은 모두 연결 실패로 나타날 수 있지만 해결 방법은 다릅니다.
같은 서버가 특정 네트워크에서만 실패한다면 가능할 때 Wi-Fi와 셀룰러를 전환해 비교합니다. 다른 설정은 그대로 유지해 서버 변경으로 생긴 차이를 네트워크 차이로 오해하지 않도록 하세요. 원격 서버의 작동 여부, 계정 유효성 및 연결 제한은 본인의 서비스 제공자나 서버 관리자에게 확인해야 합니다.
일부 페이지 실패: Config, DNS 및 테스트 조건 확인
Proxy에서는 사용할 수 있지만 Config에서 실패한다면 먼저 Config에서 어떤 파일이 활성화되어 있는지 확인한 다음 대상 요청에 적용되는 정책을 점검합니다. 변경 전에 기존 설정을 보존하세요. 한 번에 관련 설정 하나만 바꾸고 테스트 결과를 기록합니다. 도메인 접속은 실패하지만 다른 요청에는 응답이 있다면 DNS가 점검 항목 중 하나일 수 있습니다. 그러나 이 증상만으로 원인을 확정할 수는 없으며 출처가 불분명한 설정 전체를 그대로 적용해서도 안 됩니다.
단일 웹사이트만 실패한다면 웹사이트 자체의 서비스 상태나 접속 요건도 고려해야 합니다. 같은 페이지를 테스트할 때는 가능한 한 동일한 브라우저와 네트워크 조건을 사용합니다. 로그인이 필요한 페이지에서는 계정 문제와 네트워크 오류를 구분하세요. 오류 안내는 단서가 될 수 있지만, 단순히 “열리지 않음”만으로 어느 단계에서 문제가 발생했는지 판단하기는 어렵습니다.
민감 정보를 가려 상황을 정리한 뒤 문제 확인
여전히 원인을 찾을 수 없다면 기기 시스템, 현재 Global Routing 모드, 프로토콜 유형, 기본 네트워크 작동 여부, Connectivity Test 결과 및 구체적인 오류 문구를 정리합니다. 변경한 설정을 설명할 수 있지만 전체 구독 주소, 비밀번호 또는 QR 코드는 포함하지 마세요. 연결 문제 관련 자주 묻는 질문에서 증상에 따라 계속 확인하세요. App Store 이용, 기기 복원 또는 스토어 지역을 확인해야 한다면 설치 및 이용 안내를 참고하세요. 설치 문제와 연결 문제를 한 가지 문제로 혼동하지 마세요.
완료 후 기록할 세 가지 정보
현재 선택된 서버, Global Routing 모드 및 Config 파일 이름을 확인합니다. 다음에 접속 상태가 달라지면 이 세 가지 정보와 현재 네트워크를 먼저 비교한 뒤 구독을 업데이트할지 결정하세요. 설정을 조정하거나 기기를 옮기기 전에 기존 설정을 보존합니다. 자세한 문제는 자주 묻는 질문에서 확인하세요.
첫 단계로 돌아가 다시 확인