Shadowrocket 사용 가이드
기존 정보 가져오기 → Global Routing → 연결 승인 → 적용 여부 확인. 먼저 재현 가능한 연결을 완료한 뒤 규칙과 설정을 조정합니다.
현재 막힌 단계로 바로 이동할 수 있습니다. 처음 조작한다면 순서대로 진행하고 기존 설정은 잠시 유지하세요. 서버, 규칙, DNS를 동시에 변경하면 문제 원인을 판단하기 어렵습니다.
01 / IMPORT
서버 추가 및 Subscribe
먼저 보유한 정보의 종류를 확인합니다. 구독 링크는 보통 항목을 한 번에 가져와 업데이트하는 데 사용하고, 개별 서버 정보에는 프로토콜, 주소, 포트 및 인증 매개변수가 포함됩니다. 둘 중 한 가지 방법을 선택하면 되며 같은 서버 정보를 반복해서 추가할 필요는 없습니다. Shadowrocket을 열고 Home으로 이동한 다음 Add Server를 선택합니다. 페이지의 필드는 Type에 따라 달라집니다. 스크린샷의 필드는 표시된 유형에 해당하며 모든 프로토콜이 같은 매개변수를 사용한다는 뜻은 아닙니다.
기존 구독 링크가 있는 경우
Add Server에서 Type을 열고 Subscribe를 선택한 뒤 본인의 전체 구독 링크를 URL에 입력합니다. 알아보기 쉬운 메모를 적고 저장합니다. 복사할 때는 링크의 시작과 끝, 쿼리 매개변수를 특히 주의해서 확인하세요. 메시지의 설명 문구, 공백 또는 줄바꿈이 함께 들어가지 않도록 합니다. 구독 링크에 접근 자격 정보가 포함될 수 있으므로 전체 링크를 공개 스크린샷에 넣거나 관계없는 페이지로 보내지 마세요.
저장 후 읽기가 완료되면 Home으로 돌아가 구독 그룹과 서버 항목을 확인합니다. 그룹만 표시되고 선택할 항목이 없다면 먼저 구독을 제대로 읽었는지 확인하고, 해당 그룹에서 제공하는 업데이트 기능으로 다시 시도합니다. 곧바로 수동 입력으로 바꾸지 마세요. 업데이트 실패와 서버 연결 실패는 서로 다른 단계의 문제입니다. 전자는 링크 내용이나 현재 네트워크에서 읽을 수 없는 문제일 수 있고, 후자는 서버 매개변수를 점검해야 합니다. 구체적인 업데이트 메뉴는 현재 앱 인터페이스를 기준으로 확인하세요.
개별 서버 정보가 있는 경우
수동으로 추가할 때는 자료에 맞는 Type을 먼저 선택한 뒤 Host, Port 및 해당 프로토콜에서 요구하는 인증 정보를 입력합니다. Host에는 도메인 또는 주소를 입력하며 전체 웹페이지 링크를 호스트 이름으로 사용할 수 없습니다. Port는 원본 정보를 그대로 입력하고 프로토콜 이름만 보고 추측하지 마세요. 화면에 Password나 Method가 표시되면 이 값도 기존 자료와 일치해야 합니다. VLESS, VMess, Trojan 등을 사용할 때는 해당 인증, 전송 및 TLS 설정도 확인해야 하며 스크린샷에 나온 필드 조합을 그대로 적용할 수는 없습니다.
보유한 정보가 QR 코드라면 Scan QR Code를 사용하고 필요한 카메라 접근을 허용한 뒤 스캔합니다. Import from Cloud JSON은 해당 형식의 자료를 위한 기능이며 임의의 구독 링크를 가져오는 범용 메뉴가 아닙니다. 어떤 방법을 사용하든 저장 후 Home으로 돌아가 SERVER 그룹에서 대상 항목을 선택하고 선택 표시를 확인하세요. 항목이 보인다는 것은 가져오기가 완료되었다는 뜻일 뿐, 연결을 사용할 수 있다는 의미는 아닙니다. 다음 단계에서 요청 처리 방식을 선택한 뒤 연결 스위치를 켭니다.
02 / ROUTING
선택 Global Routing
Home으로 돌아가 Global Routing을 엽니다. 여기에서 요청을 규칙에 따라 처리할지, 일괄적으로 프록시를 사용할지, 직접 연결할지를 정합니다. SERVER에서 선택한 서버와는 별개의 설정입니다. 세 가지 모드의 차이를 먼저 이해한 뒤 현재 목적에 맞는 모드를 선택하면 “서버를 선택했는데 왜 일부 요청은 여전히 직접 연결될까?”와 같은 오해를 줄일 수 있습니다.
Config는 현재 활성화된 구성의 규칙에 따라 요청을 처리합니다. 규칙에 따라 서로 다른 대상에 PROXY, DIRECT 또는 기타 설정된 정책을 적용할 수 있으므로 모든 페이지가 프록시를 사용해야 하는 것은 아닙니다. Proxy는 일반 요청을 현재 프록시 경로로 보내는 모드로, 규칙 분기에 따른 변수를 일시적으로 줄일 때 적합합니다. 다만 로컬 네트워크와 시스템 동작에는 각각의 제한이 있으므로 모든 시스템 트래픽을 반드시 처리한다고 이해해서는 안 됩니다. Direct는 직접 접속할 때 사용하며, 선택한 서버를 사용할 수 있는지 확인하는 용도로는 적합하지 않습니다.
Config와 규칙의 관계
일상적으로 규칙을 사용하려면 Config를 선택한 다음 하단의 Config로 이동해 현재 활성화된 구성 파일을 확인합니다. 해당 파일을 열면 General, Rule, Hosts 등의 섹션을 볼 수 있습니다. 스크린샷은 구성 편집 화면을 보여주는 것으로, 처음부터 각 항목을 수정하라는 뜻은 아닙니다. Add Rule은 규칙을 추가하는 기능입니다. 먼저 올바른 파일을 선택했는지 확인한 뒤 편집이 필요한지 판단하세요. 파일이 존재해도 활성화되지 않았다면 해당 규칙이 적용 중이라는 뜻은 아닙니다.
규칙은 일반적으로 위에서 아래 순서로 일치 여부를 확인하며, 먼저 일치한 규칙이 요청 처리 방식을 결정합니다. 예를 들어 아래 코드는 예시 도메인을 PROXY로 보내고, 일치하지 않는 요청에는 FINAL을 적용합니다. 순서를 설명하기 위한 예시이며 기존 구성을 덮어쓰라는 의미는 아닙니다. 실제 구성은 이름이 지정된 정책을 참조할 수도 있으므로 수정 전에 원본 파일을 보관하세요. 규칙을 이해하지 못했다면 처음 연결을 완료하기 위해 전체 내용을 삭제하지 마세요.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
서버 정보로 연결을 설정할 수 있는지만 확인하려면 Proxy를 잠시 선택하고 기존 모드를 기록한 뒤, 확인 후 Config로 복원합니다. Proxy에서는 접속되지만 Config에서는 접속되지 않는다면 서버를 다시 구매하거나 구독을 반복해서 가져오기보다 규칙과 구성 선택을 확인해야 합니다. 규칙 키워드와 모드 차이에 대한 자세한 설명은 자주 묻는 질문을 참고하세요. 모드를 선택한 뒤 Home으로 돌아가 연결을 시작합니다.
03 / CONNECT
연결 스위치 및 권한 승인
이제 Home으로 돌아가 두 가지를 순서대로 확인합니다. SERVER에서 대상 항목이 선택되어 있고, Global Routing에 방금 결정한 모드가 표시되어야 합니다. 서버 이름은 메모일 뿐이므로 이름만으로 프로토콜과 매개변수가 올바른지 판단할 수 없습니다. 비슷한 항목이 여러 개라면 상세 정보를 열어 확인한 뒤 Home으로 돌아와 선택하세요. 두 설정을 그대로 유지하고 화면 상단의 연결 스위치를 켭니다.
처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. Shadowrocket의 스위치를 직접 켜서 나타난 안내인지 확인한 다음 허용하고 기기에서 요구하는 인증을 완료하세요. 이 단계는 기기에 연결에 필요한 시스템 구성을 생성하는 과정입니다. 구독 계정에 로그인하는 것이 아니며 서버 비밀번호를 입력할 필요도 없습니다. 안내를 취소했다면 앱으로 돌아가 스위치를 다시 켜 권한 절차를 확인하면 됩니다. 기존 서버 정보를 먼저 삭제할 필요는 없습니다.
권한을 승인한 뒤 앱으로 돌아와 상단 상태가 여전히 Not Connected인지, 스위치가 계속 켜져 있는지 확인합니다. 스위치를 켜자마자 꺼진다면 시스템 구성이나 다른 VPN 연결과의 충돌을 먼저 확인하세요. 스위치는 켜져 있지만 웹페이지에 접속할 수 없다면 다음 단계에서 서버와 요청 분기를 확인합니다. 두 증상은 점검 방향이 다릅니다. 스위치를 빠르게 반복해서 켜고 끄면 상태를 관찰하기 어렵고 진단 기록에서 최초 실패 지점을 찾기도 힘들어집니다.
첫 연결에서는 변수를 줄이세요
처음 확인할 때는 기기에서 실행 중인 다른 VPN 연결을 잠시 중지하고, 먼저 현재 Wi-Fi처럼 한 가지 네트워크를 고정해 테스트하는 것이 좋습니다. 셀룰러 네트워크와 비교하려면 현재 결과를 기록한 뒤 네트워크를 전환해 다시 테스트하세요. 한 번의 시도에서 네트워크, 서버, 모드를 동시에 바꾸지 마세요. 나중에 접속되더라도 어떤 변경이 효과가 있었는지 판단하기 어렵습니다.
시스템에 연결 상태가 표시되거나 스위치가 켜져 있다는 사실만으로 연결 기능이 시작되었음을 알 수 있을 뿐, 구독에 포함된 모든 서버를 사용할 수 있거나 모든 도메인이 예상한 규칙과 일치한다는 뜻은 아닙니다. 이 단계에서는 On Demand를 변경하지 마세요. 먼저 수동 연결이 제대로 작동하는지 확인한 뒤 자동 연결 조건을 고려합니다. 현재 서버와 모드를 유지한 채 테스트 결과, 실제 접속, 요청 경로를 각각 확인하세요.
04 / VERIFY
연결이 적용되었는지 확인
확인은 “테스트를 완료할 수 있는지”와 “실제 요청이 예상대로 처리되는지”의 두 단계로 나눠야 합니다. 먼저 Home에서 Connectivity Test를 누르고 이번 테스트가 끝날 때까지 기다린 뒤 대상 항목의 결과를 확인합니다. 테스트 방식, 대상 및 현재 네트워크에 따라 결과가 달라집니다. 테스트 성공은 다음 점검을 위한 근거일 뿐 모든 앱이 정상 작동한다는 뜻은 아니며, 테스트 실패가 모든 서버의 사용 불가를 의미하지도 않습니다.
그다음 브라우저를 열고 현재 모드에서 어떻게 처리되어야 하는지 알고 있는 익숙한 페이지에 접속합니다. 이전에 캐시된 내용만 보지 말고 페이지를 새로고침하거나 새 페이지를 여세요. Config를 사용한다면 기존 규칙에 따라 다른 정책이 적용될 대상을 골라 비교합니다. Proxy를 사용한다면 선택한 서버를 통해 실제로 접속되는지 확인합니다. 로컬 네트워크만으로 접속 가능한 페이지를 프록시가 적용되었다는 유일한 증거로 삼지 마세요.
결과를 정책과 대조하기
실제 접속이 예상과 다르면 앱에서 제공하는 요청 기록이나 진단 정보를 확인하고, 방금 테스트한 대상 도메인의 요청을 찾아 어떤 정책이 적용되었는지 확인합니다. DIRECT가 적용되었다면 먼저 규칙을 살펴보세요. 서버 인증 정보를 먼저 바꿀 필요는 없습니다. PROXY가 적용된 뒤 실패했다면 서버, 전송 또는 이름 해석 과정을 추가로 확인합니다. 일부 앱은 이미 설정된 연결을 재사용할 수 있으므로 구성을 변경한 뒤 새 요청을 발생시켜야 합니다. 이전 연결의 결과를 새 구성의 결과로 오해하지 마세요.
현재 네트워크, 선택한 서버, Global Routing 모드, 실제 접속 결과의 네 가지 정보를 간단히 기록해 두는 것이 좋습니다. 반복 가능한 접속을 한 번 완료한 뒤 일상적으로 사용할 Config로 되돌리고 같은 대상을 다시 확인합니다. Config로 바꾼 뒤 결과가 달라지면 구성과 규칙 순서를 계속 점검해야 합니다. 여기까지 마치면 첫 연결의 기본 절차가 완료됩니다. 이 정보를 보관하면 나중에 문제가 생겼을 때 비교 기준으로 사용할 수 있습니다.
연결을 확인하려고 HTTPS Decryption을 임의로 켜거나 추가 인증서를 설치하거나 DNS를 일괄 변경하지 마세요. 일반적인 가져오기와 연결 절차에서는 설정 페이지의 모든 항목을 켤 필요가 없습니다. 현재 증상과 직접 관련된 설정만 다루고, 복잡한 이름 해석이나 규칙 경로 문제는 문제 해결 매뉴얼에서 추가로 확인하세요.
05 / CHECK
일반적인 문제 지점 점검 순서
문제가 생기면 먼저 어느 단계에서 멈췄는지 확인합니다. 가져오기 전인지, 항목은 표시되지만 연결이 실패하는지, 시스템 스위치가 켜진 상태를 유지하지 못하는지, 연결 후 일부 요청만 실패하는지를 구분하세요. 아래 순서는 처음 사용할 때 흔히 발생하는 문제를 다룹니다. 각 항목을 확인한 뒤 앞서 테스트한 동일한 페이지에 다시 접속합니다. 개선되지 않았을 때 다음 단계로 넘어가고 모든 설정을 한꺼번에 바꾸지 마세요.
가져오기에 실패했거나 SERVER에 항목이 없음
Add Server로 돌아가 Type과 정보 형식이 일치하는지 확인합니다. 구독은 Subscribe를 사용하고 개별 서버 정보는 해당 프로토콜에 맞게 입력해야 합니다. 구독 링크가 완전하고 유효한지, 현재 네트워크에서 읽을 수 있는지도 확인하세요. 서비스가 로그인 페이지, 안내 페이지 또는 오류 내용을 반환한다면 링크를 저장해도 사용할 수 있는 항목을 가져올 수 없습니다. 서비스 제공자에게 정보를 확인할 때는 필요한 내용만 전달하고, 자격 정보가 포함된 전체 링크는 공개하지 마세요.
스위치는 정상이나 서버 테스트가 실패함
먼저 방금 가져온 항목을 선택했는지 확인한 다음 Host, Port, 인증 정보, Method, TLS 및 전송 매개변수를 점검합니다. 프로토콜 유형이 같다고 매개변수까지 공통으로 사용할 수 있는 것은 아닙니다. 특히 한 유형의 비밀번호나 암호화 방식을 다른 유형에 그대로 입력하지 마세요. 정보가 올바른지 확인한 뒤 나머지 설정을 그대로 유지하고 다른 네트워크에서 다시 테스트할 수 있습니다. 구독에서 특정 항목만 실패한다면 우선 문제 범위를 해당 항목으로 좁혀 보세요.
스위치가 꺼지거나 자동으로 다시 연결됨
스위치가 꺼지면 시스템에서 VPN 구성 권한이 완료되었는지, 다른 연결이 사용 중인지 먼저 확인합니다. 연결을 껐는데도 자동으로 다시 연결된다면 Settings에서 On Demand와 해당 조건을 확인하고, 필요한 경우 기능을 잠시 끈 다음 수동으로 다시 테스트합니다. On Demand는 연결 시점을 제어할 뿐 잘못된 서버 매개변수를 수정하지 않습니다. 수동 연결이 안정적으로 작동하는지 확인한 뒤 자동 연결 조건을 하나씩 다시 설정하세요.
테스트와 웹페이지 결과가 서로 다름
Settings에서 Test Method를 확인해 테스트가 어떤 방식으로 진행되는지 살펴보세요. 서로 다른 테스트 방식의 결과를 같은 기준으로 바로 비교하지 마세요. 테스트는 완료되지만 특정 도메인에만 접속할 수 없다면 현재 Config에서 어떤 규칙이 적용되었는지, 도메인 이름이 어떻게 해석되었는지, 대상 서비스에 문제가 있는지 확인합니다. Proxy로 잠시 비교한 뒤 기존 모드로 복원하면 규칙 문제와 서버 문제를 구분하는 데 도움이 됩니다. 다만 구성을 확인하지 않고 계속 우회하는 방법은 아닙니다.
추가 확인이 필요하다면 Diagnostics를 사용하고 문제 발생 전후의 필요한 기록을 보관하세요. 기록을 공유하기 전에 구독 자격 정보, 비밀번호 및 개인 네트워크 정보를 삭제합니다. 그래도 해결되지 않으면 증상에 따라 문제 해결을 참고하거나 자주 묻는 질문에서 구독 업데이트, 구성 선택 및 시스템 권한 관련 내용을 확인하세요. 이 가이드는 최소한의 사용 절차를 안내하므로 Proxy, TCP, UDP 설정을 모두 조정할 필요는 없습니다.