Shadowrocket 사용법

Shadowrocket을 열고 Home으로 이동합니다. SERVER 영역에서 Add Server를 찾아 추가 화면으로 들어갑니다. 먼저 Type을 확인하세요. 이후 입력해야 할 항목이 Type에 따라 달라집니다. 구독 링크가 있으면 구독 방식으로 가져오고, 서버 한 대의 정보만 있다면 해당 프로토콜에 맞춰 직접 입력합니다. 처음에는 한 가지 방법만 선택하면 되며 같은 항목을 여러 번 추가할 필요는 없습니다.

기존 구독 링크가 있는 경우: Subscribe 선택

Add Server에서 Type을 열고 Subscribe를 선택합니다. 추가 화면으로 돌아와 구독 링크를 URL 입력란에 붙여 넣으세요. 붙여 넣은 뒤 링크의 시작과 끝이 온전한지 확인하고, 특히 메시지 앱에서 복사할 때 공백이나 줄바꿈, 설명 문구가 함께 들어가지 않았는지 살펴봅니다. 구독을 식별하는 링크 매개변수는 임의로 삭제하거나 수정하지 말고, 화면의 저장 기능을 사용해 Home으로 돌아갑니다.

구독을 가져오려면 네트워크를 통해 구독 내용을 읽어야 합니다. 읽기가 끝날 때까지 기다린 다음 Home의 SERVER에 해당 그룹이나 서버 항목이 나타나는지 확인하세요. 구독 이름만 표시되고 선택할 항목이 없다면 먼저 읽기가 완료됐는지 확인합니다. 주소를 저장했다고 서버 목록까지 가져온 것은 아닙니다. 구독 내용이 업데이트된 뒤에는 해당 구독 항목의 업데이트 기능으로 다시 읽어오고 목록이 바뀌었는지 확인합니다.

기존 서버 정보가 있는 경우: 항목별 입력

서버를 직접 추가할 때는 Type을 서비스 제공자가 안내한 프로토콜과 일치시킨 다음 Host와 Port를 입력합니다. Host에는 보통 서버 도메인이나 IP 주소를 입력하며 웹 경로는 덧붙이지 않습니다. Port에는 해당 포트를 입력합니다. Password, Method 및 기타 인증 항목은 Type에 따라 달라집니다. 스크린샷은 여러 조합 중 하나를 보여 주는 예시이므로 모든 프로토콜에 같은 항목이 필요하다고 판단하지 마세요.

본인이 받은 정보를 항목별로 대조하세요. 이름이 비슷하다는 이유로 값을 추측하거나 구독 링크를 Host에 붙여 넣지 마세요. QR 코드가 있다면 Scan QR Code로 읽은 뒤 각 항목을 확인할 수 있습니다. Import from Cloud JSON은 별도의 자료 입력 방법이므로 받은 자료가 해당 형식에 맞는다고 분명히 확인된 경우에만 사용하세요. 가져온 뒤에는 항목이 나타났는지만 보지 말고 Type, 주소, 인증 정보도 확인해야 합니다.

저장한 뒤 Home으로 돌아가 이번에 테스트할 서버 항목을 선택합니다. 구독 그룹에 서버가 여러 개라면 현재 선택한 항목이 무엇인지 확인해야 이후 테스트 결과를 제대로 판단할 수 있습니다. 구독 주소와 인증 정보에는 접근 자격 증명이 포함될 수 있으므로 도움을 요청하는 글이나 스크린샷에 그대로 공개하지 마세요. 구독과 구성 파일의 차이는 용어집에서 확인할 수 있습니다. 우선 정보가 완전하고 출처가 분명한 항목 하나를 선택한 뒤 모드를 설정합니다.

서버 항목을 저장한 뒤 Home으로 돌아가 Global Routing을 엽니다. 여기서 선택하는 것은 트래픽 처리 방식이며 서버 변경이나 연결 스위치 조작이 아닙니다. 모드는 구성(Config), 프록시(Proxy), 직접 연결(Direct)의 세 가지입니다. 무엇을 확인할지 먼저 정한 다음 모드를 선택하세요. 연결 실패 때 모드를 무작정 바꿔 보는 식으로 사용하지 마세요.

Config 사용 전 구성 파일 확인

용도가 명확한 구성 파일이 있다면 Config에 들어가 현재 어떤 파일을 사용 중인지 확인한 뒤 General, Rule 등의 내용을 살펴봅니다. 편집 화면에서 파일을 열어 봤다고 해서 현재 사용 중인 구성으로 선택된 것은 아닐 수 있으므로 목록으로 돌아가 적용 상태를 확인하세요. 처음 설정할 때 서버를 가져오는 동시에 규칙을 많이 수정하면 연결 문제의 원인을 어느 단계에서 찾아야 할지 판단하기 어려워집니다.

Rule의 규칙 순서는 매칭 결과에 영향을 주며, 마지막으로 적용되는 규칙이 앞에서 매칭되지 않은 요청의 경로를 결정합니다. 아래는 규칙 문법을 보여 주는 예시일 뿐입니다. 예시 도메인은 PROXY로 보내고 나머지는 FINAL에 따라 DIRECT로 처리한다는 뜻입니다. 이 두 줄을 모든 목적에 적합한 완성된 구성으로 그대로 사용하거나, 이 안내를 따라 하기 위해 현재 구성 파일을 교체하지 마세요.

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

새로 추가한 서버가 작동하는지만 확인하려면 프록시(Proxy)를 선택해 범위를 정한 테스트를 먼저 진행할 수 있습니다. 확인이 끝나면 필요한 구성(Config)으로 돌아가 트래픽 분리가 예상대로 적용되는지 살펴보세요. 직접 연결(Direct)을 선택한 상태에서 웹페이지가 열려도 현재 조건에서 직접 연결이 가능하다는 뜻일 뿐, 방금 추가한 서버가 정상이라는 증거는 아닙니다.

스크린샷의 Hosts, URL Rewrite, HTTPS Decryption은 고급 구성 항목으로, 처음 연결할 때 반드시 설정해야 하는 기능이 아닙니다. 이번에는 기존 값을 유지하고 이해하지 못한 설정을 추가로 켜지 마세요. 규칙 키워드의 의미는 용어집에서, 구성과 DNS에 관한 자세한 내용은 설정 참고에서 확인할 수 있습니다. 모드를 선택한 뒤 Home으로 돌아가 연결을 시작합니다.

Home으로 돌아가 세 가지를 확인합니다. SERVER에서 사용할 서버를 선택했는지, Global Routing이 방금 정한 모드인지, 상단에 Not Connected가 표시되는지 살펴보세요. 서버 항목의 존재, 모드 선택, 연결 스위치 상태는 각각 별개의 조건이며 어느 하나가 나머지를 대신하지 않습니다.

확인한 뒤 상단 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성 추가를 요청할 수 있습니다. 안내를 읽고 요청이 Shadowrocket에서 온 것인지 확인한 다음 시스템 절차에 따라 허용 여부를 결정하고 기기에서 요구하는 인증을 완료하세요. 이 권한은 시스템 네트워크 연결 구성을 만들기 위한 것으로, 구독을 성공적으로 가져왔다는 증거나 원격 서버가 작동한다는 뜻은 아닙니다.

시스템 권한 요청을 취소했다면 앱으로 돌아온 뒤 연결이 되지 않을 수 있습니다. 이때는 올바르게 저장된 서버 정보를 삭제하지 말고 연결을 다시 시작해 시스템 안내가 나타나는지 확인하세요. 기기의 관리 정책에 따라 관련 구성을 추가하거나 활성화할 수 없는 경우에는 먼저 기기 제한 사항을 확인해야 합니다. 클라이언트 항목만 수정해서 해결할 수 있는 문제는 아닙니다.

권한 설정을 마친 뒤 Home으로 돌아와 상단 상태가 Not Connected에서 바뀌었는지, 스위치가 켜져 있는지 확인합니다. 스위치가 곧바로 꺼지면 안내 메시지가 나타났는지 기록하세요. 연결된 것처럼 보인다면 다음 단계에서 실제 요청을 확인합니다. 상태 표시 아이콘이나 스위치 색상만으로 모든 웹사이트에 접속할 수 있다고 판단하지 마세요. 연결 상태와 요청 성공 사이에는 서버, DNS, 규칙 등의 단계가 더 있습니다.

테스트하는 동안에는 On Demand를 동시에 조정하지 마세요. 저장된 조건에 따라 연결 동작이 달라질 수 있어 처음 설정할 때 스위치 상태 변화를 해석하기 어려워집니다. 수동으로 연결을 끈 뒤 다시 연결된다면 스위치를 반복해서 조작하기보다 On Demand가 설정되어 있는지 먼저 확인하세요. 조건에 따른 자동 동작과 시스템 기능은 기본 테스트를 마친 뒤 Settings 설정 참고에서 살펴볼 수 있습니다.

연결을 종료하려면 Home으로 돌아가 상단 스위치를 끄고 상태가 바뀌었는지 확인합니다. 연결을 끄더라도 저장된 구독, 서버 항목, 구성 파일은 삭제되지 않으므로 다음에 현재 선택을 확인한 뒤 다시 사용할 수 있습니다. 우선 연결을 유지하고 실제 요청을 확인합니다.

연결이 실패해도 현재 자료를 그대로 보관하고 구독 삭제, 구성 교체, Settings 초기화를 한꺼번에 진행하지 마세요. 기본 네트워크, 서버, 모드, DNS, 규칙 순서로 확인하고 항목을 하나씩 점검할 때마다 앞 절에서 정한 요청을 다시 테스트합니다. 이 순서는 원인을 좁히기 위한 것이며 특정 설정 하나로 모든 문제를 해결할 수 있다는 뜻은 아닙니다.

먼저 기본 네트워크와 서버 정보 확인

연결을 끄고 기기의 현재 네트워크에서 평소 사용하는 웹페이지를 열 수 있는지 확인합니다. 기본 네트워크가 작동하지 않는다면 먼저 Wi-Fi, 셀룰러 네트워크 또는 현재 네트워크에서 필요한 접속 절차를 확인하세요. 네트워크를 복구한 뒤 Shadowrocket을 다시 열고 같은 서버를 테스트합니다. 네트워크 전환에 따른 변화를 특정 프로토콜 항목의 효과로 착각하지 않도록 합니다.

구독을 읽어오지 못하면 링크가 완전하고 유효한지, 현재 네트워크에서 해당 주소에 접근할 수 있는지 확인합니다. 목록은 나타났지만 연결에 실패한다면 선택한 서버의 Host, Port, Type, 인증 항목을 점검하세요. 구독을 성공적으로 읽었다는 것은 정보를 가져왔다는 뜻일 뿐, 구독에 포함된 모든 서버가 연결된다는 의미는 아닙니다. 서비스 상태나 자료의 유효성은 본인이 이용하는 서비스 제공자에게 확인하세요. 이 사이트는 대체 연결 정보를 제공하지 않습니다.

다음으로 모드, DNS, 규칙 문제 구분

Global Routing이 직접 연결(Direct)로 설정되어 있지 않은지 확인합니다. 프록시(Proxy)는 되지만 구성(Config)은 안 된다면 Config로 돌아가 현재 사용 중인 파일을 확인하고, 대상 요청이 앞선 규칙에 매칭되는지와 FINAL의 경로가 어디로 설정되어 있는지 살펴보세요. 수정하기 전에 기존 구성을 보관하고 차이를 일으키는 규칙을 먼저 찾습니다. 출처가 불분명한 내용으로 전체 규칙을 교체하지 마세요.

도메인 조회 오류가 나타나면 DNS를 변경한 적이 있는지, 현재 네트워크 환경에 맞는 설정인지 확인하세요. 문제 해결을 위해 확인되지 않은 DNS 주소를 임의로 지정하거나 다른 문제를 감추려고 인증서 검증을 끄지 마세요. DNS와 연결 경로는 서로 영향을 줍니다. 세부 항목과 문제 해결 범위는 설정 참고를 확인하세요. 이 페이지에서는 우선 문제가 어느 단계에서 발생하는지 파악합니다.

마지막으로 Settings와 진단 정보 확인

Settings에서 Test Method를 찾아 현재 테스트 방식의 의미를 먼저 확인한 다음 Connectivity Test 결과를 해석하세요. 테스트가 응답하지 않는 것은 테스트 방식 때문일 수 있으므로 실제 요청 결과도 함께 살펴봐야 합니다. 원인을 더 좁혀야 한다면 Diagnostics를 열고 오류가 발생한 시간에 해당하는 정보를 확인합니다. Proxy, TCP, UDP 등의 항목은 구체적인 동작 설정이며 연결 전에 모두 변경해야 하는 스위치가 아닙니다.

연결이 자동으로 켜지거나 꺼진다면 On Demand를 확인하세요. Today Widget 상태만 예상과 다르다면 먼저 Home에서 실제 연결 상태를 확인한 뒤 표시 문제를 살펴봅니다. 한 번에 한 가지 현상만 다루고 위젯 표시, 원격 서버 연결, 규칙 매칭을 하나의 문제로 묶지 마세요. 변경한 설정을 항목별로 원래대로 되돌린 뒤 같은 테스트를 반복합니다.

문제를 정리할 때는 현재 네트워크, 가져오기 방법, Global Routing, 실패한 대상, 표시된 메시지를 구체적으로 기록하세요. 진단 정보를 공유하기 전에 구독 전체 주소, Password, 인증 식별 정보 및 기타 비공개 항목을 가리고 원인 파악에 필요한 오류 내용만 남깁니다. 원본 구성 파일 전체를 공개하지 마세요. 프로토콜 이름과 규칙 키워드가 익숙하지 않다면 먼저 용어집을 확인한 뒤 설정을 계속 변경할지 결정합니다.

문제 해결을 마친 뒤 확인이 끝난 서버와 모드로 되돌리고 유효한 구성은 보존하며 더 이상 필요하지 않은 진단 기록은 끄세요. 기본 연결이 안정된 다음 DNS, On Demand, 구성 관리 방법을 하나씩 살펴보면 됩니다. 자세한 내용은 Settings 항목 참고에서 확인할 수 있으며 처음 연결할 때 모든 항목을 설정할 필요는 없습니다.