공식 가이드 · 첫 사용
Shadowrocket 사용 가이드
기존 구독 가져오기 → Global Routing → 연결 권한 승인 → 실제 확인
다섯 단계로 기본 연결을 완료한 뒤 확인 결과에 따라 구성을 조정합니다. 먼저 기본 설정을 유지하고 현재 단계에 필요한 항목만 변경하세요. 여러 옵션을 한꺼번에 바꾸면 원인을 찾기 어렵습니다.
- 구독 또는 단일 서버 정보 중 하나 준비
- 연결 전에 로컬 네트워크 사용 가능 여부 확인
- 한 번에 하나씩 변경한 뒤 다시 확인
단계 01 · 연결 정보 가져오기
Add Server 추가 및 구독 가져오기
구독 링크와 단일 서버 매개변수는 서로 다른 정보 형식입니다. 먼저 가지고 있는 정보가 무엇인지 확인한 다음 해당 항목을 선택하세요. 두 방법을 모두 진행할 필요는 없습니다.
기존 구독 링크 사용
Shadowrocket을 열고 Home에서 Add Server를 누릅니다. 일부 화면에서는 상단의 추가 버튼으로도 이동할 수 있습니다. Add Server에서 Type을 누르고 Subscribe를 선택한 다음 기존 구독 링크 전체를 해당 URL 필드에 붙여 넣습니다. 링크는 서비스 제공자에게서 확인하세요. 서비스 제공자의 웹사이트 로그인 페이지, 주문 페이지 또는 안내 페이지 주소를 구독 주소로 사용하지 마세요.
붙여 넣은 다음 링크의 시작과 끝을 확인하고, 복사 과정에서 공백, 줄 바꿈, 따옴표 또는 생략 기호가 들어갔는지 살펴봅니다. 구독 주소에서 물음표 뒤의 내용은 인증에 쓰일 수 있으므로 겉모양만 보고 임의로 삭제하면 안 됩니다. 알아보기 쉬운 메모를 입력하고 저장한 뒤 앱이 구독을 읽을 때까지 기다립니다. 그런 다음 Home으로 돌아가 서버 항목이 목록에 표시되는지 확인하고 테스트할 서버를 선택합니다.
처음 가져온 뒤에는 같은 링크를 연속해서 반복 추가하지 마세요. 목록이 바뀌지 않았다면 먼저 읽기 실패 알림이 표시되는지 확인합니다. 서버 항목이 이미 표시되어 있다면 서버를 선택하고 다음 단계로 진행하면 됩니다. 구독 새로고침은 서버 정보를 다시 가져오는 작업입니다. 프록시 연결이 이미 설정되었거나 구성 파일의 규칙이 활성화되었다는 뜻은 아닙니다.
단일 서버 정보 사용
주소, 포트, 인증 정보와 프로토콜 매개변수를 받은 경우 Add Server의 Type에서 안내된 프로토콜을 선택한 다음 항목별로 입력합니다. Host에는 서버 도메인 또는 IP 주소를 입력하고, Port에는 연결 포트를 입력합니다. 선택한 프로토콜에 Password, Method 또는 다른 인증 필드가 필요한 경우 제공된 정보를 그대로 입력합니다. 프로토콜마다 표시되는 필드가 다르므로 한 프로토콜의 매개변수를 다른 프로토콜에 억지로 적용하지 마세요.
화면에 표시된 Password와 Method는 해당 페이지의 프로토콜에서 볼 수 있는 필드 예시이며, 모든 유형에 필요한 것은 아닙니다. 정보에 TLS, SNI, 전송 방식 또는 경로가 포함되어 있다면 함께 확인하세요. 주소와 포트만 보고 임의로 값을 추측하지 마세요. 매개변수가 누락된 경우 서비스 제공자에게 전체 정보를 확인하는 편이 앱 설정을 반복해서 바꾸는 것보다 원인을 찾기 쉽습니다.
정보가 QR 코드라면 Scan QR Code로 읽고 시스템 안내에 따라 필요한 권한을 허용할 수 있습니다. Import from Cloud JSON은 해당 JSON 정보를 가져오는 기능이며 일반 구독 링크를 가져오는 범용 대안은 아닙니다. 어떤 방법으로 가져오든 저장하기 전에 인식된 유형, 주소와 포트를 확인하세요. 완료되면 Home으로 돌아가 SERVER 목록에 대상 항목이 있는지 확인한 뒤 모드를 선택합니다.
단계 02 · 요청 처리 방식 선택
Global Routing의 세 가지 모드
모드를 선택하기 전에 “어떤 서버를 사용할지”와 “어떤 요청을 프록시로 보낼지”를 구분하세요. 서버 선택은 전자에, 모드와 구성은 후자에 영향을 줍니다.
Home에서 Global Routing을 누르고 현재 선택된 모드를 확인합니다. 여기서는 구성(Config) / 프록시(Proxy) / 직접 연결(Direct)로 이해하면 됩니다. 이 모드는 요청 처리 방식을 제어하며 서로 다른 서버 세 그룹을 뜻하지 않습니다. 모드를 전환한 뒤에는 Home으로 돌아가 선택 항목이 바뀌었는지 다시 확인하세요. 설정을 변경했다고 생각했지만 실제로는 이전 설정이 유지되는 상황을 방지할 수 있습니다.
구성(Config): 현재 규칙에 따라 처리
일상적인 규칙 기반 라우팅에는 Config를 사용합니다. 앱은 현재 활성화된 구성의 규칙에 따라 각 요청을 해당 정책으로 보냅니다. 따라서 Config를 선택하기 전에 Config 페이지에서 사용할 구성 파일이 활성화되어 있는지 확인해야 합니다. 서버 목록만 있다고 해서 본인에게 적합한 규칙 파일이 준비된 것은 아닙니다. 구독과 구성 파일의 역할은 서로 다르며, 구독을 가져와도 현재 규칙이 자동으로 교체되는 것은 아닙니다.
공식 스크린샷에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션이 표시된 구성 파일 편집 페이지가 나옵니다. 첫 연결에서 각 섹션을 수정할 필요는 없으며, 일반적인 연결을 위해 추가 복호화 기능을 켤 필요도 없습니다. Rule을 열거나 Add Rule을 사용하는 경우 규칙 조건과 순서를 먼저 이해하세요. 범위가 넓은 규칙이 뒤에 있는 구체적인 규칙보다 먼저 적용되는 상황을 방지할 수 있습니다.
예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 도메인 접미사로 일치하는 항목을 지정된 정책으로 보내는 규칙입니다. 이는 구문 설명일 뿐 그대로 복사해 사용할 완성된 구성이 아닙니다. 요청이 DIRECT로 처리되더라도 반드시 연결 실패를 뜻하지는 않습니다. 현재 규칙의 정상적인 결과일 수 있습니다. 규칙 유형, 정책 참조 및 일치 순서는 프록시 모드 및 규칙 안내에서 자세히 확인하세요.
프록시(Proxy)와 직접 연결(Direct): 비교 테스트
Proxy는 선택한 서버의 프록시 연결을 확인할 때 사용할 수 있으며 이번 테스트에서 규칙 기반 분기의 영향을 줄여 줍니다. 다만 실제 웹사이트 접속 확인을 대신하지는 않으며, 기기의 모든 유형의 트래픽을 일괄 처리할 수 있다는 뜻도 아닙니다. Direct는 직접 연결 상태를 비교해 로컬 네트워크가 원래 작동하는지 확인할 때 사용합니다. 프록시가 적용되었다는 증거로 사용하지 마세요.
구성이 올바른지 아직 확실하지 않다면 먼저 Proxy를 선택해 기본 연결을 테스트하고, 서버가 작동하면 Config로 다시 전환할 수 있습니다. 전환할 때마다 현재 선택을 기록하고 같은 접속 대상을 이용해 결과를 비교하세요. 다음 단계에서는 테스트할 모드를 유지하고 Home으로 돌아가 연결 스위치를 켭니다.
단계 03 · 연결 설정
Home 스위치 및 첫 권한 승인
정보 가져오기와 연결 설정은 별개의 단계입니다. 먼저 서버를 선택하고 Global Routing을 확인한 다음 상단 스위치를 켭니다.
Home으로 돌아가 SERVER 그룹에서 사용할 서버를 선택합니다. 목록에 항목이 여러 개라면 구독 그룹 이름만 보지 말고 실제 서버가 선택되어 있는지 확인하세요. 이어서 Global Routing이 앞 단계에서 정한 항목인지 확인한 뒤 상단에서 Not Connected 상태인 연결 스위치를 누릅니다.
처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 묻습니다. 사용 중인 Shadowrocket에서 시작한 작업인지 확인한 뒤 시스템 안내에 따라 허용하고 기기 암호 또는 다른 인증 절차를 완료하세요. 권한 승인은 시스템 절차이며 앱에서 서버를 새로 추가하는 작업이 아니고 구독 링크를 다시 붙여 넣을 필요도 없습니다. 완료되면 Shadowrocket으로 돌아와 연결 상태가 유지되는지 확인하세요. 스위치를 연속해서 여러 번 켜고 끄지 마세요.
첫 권한 요청을 취소했다면 앱으로 돌아와 스위치를 다시 켜고 표시되는 안내에 따라 승인할 수 있습니다. 학교나 직장에서 관리하는 기기라면 시스템 정책에 따라 VPN 구성이 제한될 수 있으므로 해당 기기에서 이런 연결을 사용할 수 있는지 먼저 확인하세요. 잘 모르는 기기 관리 항목을 반복해서 삭제하지 마세요. 다른 VPN 연결이 이미 설정되어 있다면 테스트 전에 현재 연결을 끊어 시스템이 연결을 전환할 때 혼동이 생기지 않도록 합니다.
스위치가 켜져 있으면 앱의 연결 절차가 시작되었거나 연결이 설정되었다는 뜻이지만, 대상 웹사이트에 반드시 접속할 수 있다는 의미는 아닙니다. 서버가 작동하지 않거나 인증 매개변수가 잘못되었거나 DNS 확인에 문제가 있거나 구성 정책이 예상과 다르면 “스위치는 켜져 있지만 페이지가 열리지 않는” 현상이 생길 수 있습니다. 권한 승인이 끝난 다음에는 실제 접속을 확인해야 합니다.
첫 테스트에서는 현재 Wi-Fi 또는 셀룰러 네트워크를 유지하고 네트워크, 서버, 모드를 동시에 바꾸지 마세요. 다른 서버를 테스트하려면 먼저 기존 결과를 기록한 다음 서버를 전환하고 같은 점검을 반복합니다. 그래야 어떤 항목 때문에 결과가 달라졌는지 파악할 수 있으며, “가끔 작동한다”는 모호한 결론을 피할 수 있습니다.
단계 04 · 실제 요청 확인
Connectivity Test 및 접속 확인
연결 테스트, 실제 페이지와 규칙 결과를 함께 확인하세요. 한 가지 수치나 상단 상태만으로 결론을 내리면 안 됩니다.
먼저 테스트한 다음 같은 대상에 접속
Home에서 Connectivity Test를 실행해 현재 서버가 선택된 테스트를 완료할 수 있는지 확인합니다. 테스트 결과는 해당 테스트 방식의 응답을 보여 주며 웹페이지 다운로드 속도와 같지 않고 모든 웹사이트나 앱에 접속할 수 있다는 보장도 아닙니다. 시간 초과가 발생하면 먼저 테스트 방식과 현재 네트워크를 기록하세요. 모든 서버가 작동하지 않는다고 바로 판단하지 마세요.
그다음 브라우저를 열고 정상 작동이 확인된 HTTPS 페이지에 접속해 제목이나 캐시된 내용만 표시되는 것이 아니라 페이지가 실제로 로드되는지 확인합니다. 페이지를 새로고침하거나 브라우저 새 탭을 사용해 이전 캐시로 인한 영향을 줄일 수 있습니다. 특정 앱에서만 문제가 생기면 전체 구성을 재설정하기 전에 브라우저에서 비슷한 대상에 접속해 비교하세요.
Config에서 규칙 처리 결과 확인
Config를 사용할 때는 Data에서 확인 가능한 요청 기록을 열어 대상 도메인, 적용된 규칙과 정책 정보를 대조합니다. 버전에 따라 표시 위치가 조금 다를 수 있으므로 현재 화면을 기준으로 확인하세요. 직접 연결되어야 하는 요청이 DIRECT로 처리되는 것은 정상입니다. 프록시를 사용해야 하는 요청이 직접 연결 정책에 해당하는 경우 현재 구성이 활성화되어 있는지, 앞선 규칙이 해당 요청을 먼저 처리하는지 확인해야 합니다.
Proxy로 전환하면 같은 대상에 접속되지만 Config에서 실패하는 경우 서버를 다시 가져오기보다 구성과 규칙을 먼저 확인하세요. 반대로 두 모드 모두 실패한다면 서버 매개변수, 로컬 네트워크 및 서버 상태를 먼저 점검합니다. 비교할 때 서버와 네트워크를 그대로 유지하고 모드 하나만 바꾸어야 결과를 신뢰할 수 있습니다.
한 차례 확인이 끝나면 일상적으로 사용할 모드인 Config로 되돌린 뒤 대상에 다시 접속해 결과를 확인하세요. “네트워크 유형, 서버 메모, 모드, 증상”만 기록하면 됩니다. 문제를 공유하기 위해 전체 구독 링크, 인증 필드 또는 해당 정보가 포함된 스크린샷을 공개하지 마세요. 결과가 예상과 다르면 아래의 증상별 점검을 계속 진행합니다.
단계 05 · 작동 중인 설정을 유지하며 문제 해결
일반적인 실패 원인 확인 순서
가져오기, 권한 승인, 서버 연결, 규칙 처리 중 어디에서 실패했는지 먼저 확인한 다음 해당 단계만 점검합니다.
구독을 저장했지만 서버가 표시되지 않음
해당 구독 항목으로 돌아가 Type이 Subscribe인지, 링크가 완전한지, 현재 네트워크에서 구독 서비스에 접속할 수 있는지 확인합니다. 일반 웹페이지 링크는 구독을 가져오는 데 사용할 수 없으며 인증 매개변수가 누락되어도 잘못된 내용이 반환될 수 있습니다. 전체 링크를 공개된 커뮤니티 페이지에 붙여 넣지 마세요. 링크가 유효한지 확인해야 한다면 서비스 제공자에게 링크 상태와 반환 형식을 확인하세요.
이전에 업데이트되다가 갑자기 실패했다면 같은 네트워크에서 한 번 더 시도한 뒤 사용할 수 있는 다른 네트워크와 비교합니다. 기존 항목을 유지하면 차이를 확인하기 쉽습니다. 원인을 파악하기 전에 반복해서 삭제하고 다시 만들지 마세요. 가져오기에 성공한 뒤에도 서버를 선택하고 연결을 켜야 합니다. 새로고침만으로는 다음 단계가 완료되지 않습니다.
스위치가 켜지지 않거나 켜진 뒤 다시 꺼짐
먼저 시스템 권한 승인이 완료되었는지 확인한 다음 기기에 연결 제한이 있는지 또는 다른 VPN을 사용 중인지 살펴봅니다. 시스템 안내가 명확하게 표시되면 스위치를 반복해서 누르기보다 안내 문구를 기록하는 편이 유용합니다. 첫 권한 승인이 끝나기 전에 DNS나 규칙을 변경하지 마세요. 이런 변경은 대개 권한 단계의 문제를 해결하지 못합니다.
스위치는 켜졌지만 테스트 시간 초과
서버 유형, 주소, 포트와 인증 필드를 차례로 확인한 다음 TLS 또는 전송 매개변수를 점검합니다. 같은 네트워크에서 기존의 다른 서버를 테스트하면 특정 서버 문제인지 로컬 네트워크 문제인지 구분하는 데 도움이 됩니다. 네트워크를 전환한 뒤 결과가 달라지면 네트워크 환경을 추가로 확인하세요. 같은 서버가 서로 다른 네트워크에서 모두 실패하면 서비스 제공자에게 서버 상태를 확인합니다.
Settings에서는 관련 항목만 확인
Settings로 이동해 Test Method를 확인하고 현재 Connectivity Test에서 사용하는 테스트 방식을 살펴봅니다. 특정 테스트는 시간 초과되지만 실제 웹페이지는 열릴 수 있습니다. 테스트 결과만으로 연결을 사용할 수 없다고 판단하지 마세요. Diagnostics에서 진단 정보를 추가로 확인할 수 있습니다. 기록을 공유하기 전에는 서버 주소, 인증 정보와 구독 내용을 가리세요.
처음 수동 연결이 아직 안정되지 않았다면 복잡한 On Demand 조건을 설정하지 마세요. 이미 활성화된 경우 문제 해결 중에는 자동 작동의 영향을 줄이도록 잠시 끄고, 연결이 안정된 뒤 다시 설정해 별도로 확인할 수 있습니다. 스크린샷의 Proxy, TCP, UDP는 설정 그룹이며 문제 해결을 위해 모두 변경해야 한다는 뜻이 아닙니다. 무작정 바꾸면 새로운 변수가 늘어납니다.
연결은 되지만 일부 요청이 계속 실패
먼저 같은 대상에 대해 Proxy와 Config의 결과를 비교합니다. Config에서만 문제가 발생하면 적용된 규칙과 정책을 확인합니다. 두 모드 모두에서 문제가 생기면 DNS, 프로토콜과 대상 서비스 상태를 확인합니다. 대상 하나에서 실패했다고 모든 서버를 삭제하거나 앱을 재설치하지 마세요. DNS, 속도, 배터리 소모 및 업데이트 후 발생한 문제에 대한 단계별 점검은 문제 해결 가이드를 참고하세요. 기본 단계를 다시 확인하려면 이 가이드의 추가 및 가져오기 단계로 돌아가면 됩니다.
이제 다시 확인할 수 있는 기본 사용 절차는 정보 저장, 서버 선택, 모드 확인, 권한 승인, 테스트와 실제 접속으로 이루어집니다. 이후 구독이나 서버를 변경할 때도 같은 순서를 따르면 됩니다. 확인 결과가 특정 설정을 원인으로 가리킬 때만 해당 항목을 추가로 조정하세요.
