Shadowrocket 빠른 시작

Shadowrocket을 열고 Home으로 이동한 다음 SERVER 그룹에서 Add Server를 선택하거나 화면의 추가 메뉴를 사용합니다. 먼저 정보의 종류를 확인하세요. 구독 링크는 여러 항목을 가져오고 업데이트할 때 사용합니다. 단일 공유 링크에는 보통 서버 하나의 매개변수가 들어 있습니다. 수동 입력 정보는 프로토콜, 주소, 포트, 인증 정보로 나뉘어 제공됩니다. 구독 주소를 Host에 입력하지 말고, 링크 길이만으로 종류를 판단하지 마세요.

기존 구독 링크: Subscribe 사용

Add Server에서 Type을 열고 Subscribe를 선택한 다음 기존 구독 주소 전체를 해당 URL 항목에 입력합니다. 알아보기 쉬운 이름을 메모로 적을 수 있습니다. 용도나 정보 출처를 표시하되 인증 정보는 메모에 적지 마세요. 붙여넣은 주소 앞뒤에 공백, 줄바꿈, 따옴표가 들어갔는지 확인하고, 복사 과정에서 끝부분의 매개변수가 누락되지 않았는지도 살펴봅니다. 확인 후 저장하고 Home으로 돌아와 구독 정보가 로드될 때까지 기다립니다.

저장되었다고 해서 내용까지 정상적으로 가져온 것은 아닙니다. 목록으로 돌아갔을 때 구독 그룹이나 그 안의 서버 항목이 표시되는지 확인하세요. 그룹 이름만 있고 선택할 항목이 없다면 구독을 업데이트한 뒤 오류 메시지가 표시되는지 확인합니다. 구독 업데이트는 항목 정보를 다시 가져오는 작업이며, 포함된 모든 서버의 연결을 보장하지는 않습니다. 구독이 만료되었거나 권한이 변경되었거나 내용이 비어 있다면 기존 서비스 제공자가 안내한 정보를 확인하세요.

기존 서버 정보: Type과 입력 항목 확인

직접 입력할 때는 먼저 Type에서 보유한 정보와 일치하는 프로토콜을 선택한 다음 Host, Port 및 해당 인증 항목을 입력합니다. 스크린샷에는 Password, Method 등이 표시되어 있지만 Type에 따라 입력 항목은 다르므로 같은 항목을 모든 프로토콜에 적용하면 안 됩니다. Host에는 보통 도메인이나 IP 주소를 입력하며 웹 경로는 포함하지 않습니다. Port는 기존 정보를 그대로 입력하세요. Password, UUID 등의 인증 값은 대소문자와 기호를 바꾸지 말고 빠짐없이 입력해야 합니다.

사용 가능한 QR 코드가 있다면 Scan QR Code로 읽은 뒤 해석된 유형과 주소를 확인할 수 있습니다. Import from Cloud JSON은 해당 형식의 데이터를 가져오는 기능이며, 일반 구독 주소를 붙여넣는 메뉴가 아닙니다. 어떤 방법으로 가져오든 저장 전에 기존 정보와 프로토콜이 일치하는지 확인하세요. 형식을 인식하지 못하면 Type을 계속 바꿔 시험하기보다 먼저 해당 정보의 용도를 확인하세요.

서버 항목을 선택한 다음 Home으로 돌아가 Global Routing을 엽니다. 여기서는 세 가지 모드인 Config, Proxy, Direct를 구분해야 합니다. 모드를 바꿔도 서버 정보가 자동으로 채워지거나 만료된 구독이 복구되지는 않습니다. 처음 설정할 때는 현재 어떤 모드를 사용하는지 명확히 확인하세요. 그래야 이후 연결과 문제 점검을 일관되게 진행할 수 있습니다.

Config: 현재 구성에 따라 요청 처리

Config는 현재 선택된 구성 파일과 규칙에 따라 요청을 처리합니다. 하단의 Config 페이지에서 파일이 선택되어 있는지 확인하고 해당 구성을 열어 Rule 내용을 살펴보세요. 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 구성의 각 섹션입니다. 빠른 시작 단계에서 모든 항목을 수정할 필요는 없습니다. 특히 연결을 위해 현재 용도와 관계없는 기능까지 동시에 켜지 마세요.

구독 항목을 가져왔다고 해서 트래픽 분할 규칙까지 선택된 것은 아닙니다. 서버 목록과 구성 파일은 별도로 관리됩니다. 서버 목록에는 연결 정보가 있고, 구성 파일은 규칙 적용 방식을 정합니다. Config를 사용하기 전에 현재 파일이 실제로 존재하는지, 규칙의 정책이 사용 가능한 서버나 정책 설정과 연결되어 있는지 확인하세요. 트래픽 분할 구성을 아직 준비하지 않았다면 먼저 Proxy로 기본 연결을 확인한 뒤 Config로 돌아오세요.

Proxy와 Direct: 연결 경로 지정

Proxy는 해당 모드에서 처리할 수 있는 요청을 선택한 프록시 경로로 전달합니다. 처음 연결할 때 서버로 실제 접속할 수 있는지 확인하는 데 적합합니다. 문제를 점검할 때 비교 기준으로 사용할 수 있지만, 모든 앱과 프로토콜, 네트워크 요청이 반드시 같은 결과를 보장하는 것은 아닙니다. Direct는 요청을 직접 연결 경로로 처리하므로 기기의 기존 네트워크가 정상인지 비교할 때 사용할 수 있습니다. 이 모드에서 연결 스위치를 켜도 선택한 프록시 서버를 사용하고 있다는 뜻은 아닙니다.

Config 규칙의 간단한 예시는 다음과 같습니다. example.com과 그 하위 도메인에만 PROXY를 적용하고, 나머지 일치하지 않는 요청은 FINAL,DIRECT로 처리합니다. example.com은 설명을 위한 도메인이며 서버 주소가 아닙니다. 이 예시는 연결 경로를 설명하기 위한 것으로, 처음 설정할 때 구성 파일 전체를 바꾸라는 뜻은 아닙니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

규칙은 위에서 아래로 확인하며 일치하는 항목이 있으면 지정된 정책을 적용하므로 FINAL은 구체적인 규칙 뒤에 두어야 합니다. Rule에서 Add Rule을 사용하려면 먼저 기존 구성을 보관한 뒤 현재 테스트에 필요한 규칙만 추가하세요. 전체 문법과 정책 연결 방법은 시스템 튜토리얼의 Config 및 규칙 안내를 참고하세요. 이 페이지에서는 계속해서 연결을 확인합니다.

Home으로 돌아가 두 항목을 다시 확인합니다. SERVER 그룹에서 선택한 항목이 방금 테스트할 서버인지, Global Routing이 예상한 Config, Proxy 또는 Direct로 설정되어 있는지 살펴보세요. 구독을 업데이트하면 목록 항목이 달라질 수 있으므로 이전 기억만으로 현재 선택을 판단하지 마세요. 처음 연결할 때는 결과를 비교하기 쉽도록 현재 Wi-Fi 또는 셀룰러 네트워크를 그대로 유지하세요.

Connectivity Test를 먼저 실행해 현재 테스트 방법에 따른 연결 결과를 확인할 수 있습니다. 테스트에 실패하면 연결 스위치를 반복해서 켜고 끄지 마세요. 항목으로 돌아가 정보가 빠짐없이 입력되었는지 확인하고 마지막 섹션의 안내에 따라 점검합니다. 응답이 있으면 Home 상단의 연결 스위치를 켭니다. Connectivity Test 결과는 해당 테스트 방식에만 적용됩니다. 한 번의 테스트만으로 모든 웹사이트, DNS 조회 또는 앱 요청이 정상이라고 단정할 수 없습니다.

첫 연결: 시스템 VPN 구성 안내 확인

처음 연결을 시작하면 Shadowrocket이 VPN 구성을 추가하도록 허용할지 시스템에서 물을 수 있습니다. 앱이 시스템 네트워크 연결을 설정하기 위해 필요한 권한입니다. 안내에 표시된 앱 이름을 확인한 뒤 허용하고 기기에서 요구하는 인증을 완료하세요. 이 인증은 기기의 시스템 절차이며 앱에 구독 비밀번호를 입력하는 과정이 아닙니다. 기기 잠금 해제 정보도 다른 사람에게 알려줄 필요가 없습니다.

권한 승인을 마친 뒤 Shadowrocket으로 돌아와 상단 연결 상태가 바뀔 때까지 기다립니다. 방금 권한 요청을 취소했다면 연결이 완료되지 않을 수 있습니다. 스위치를 다시 켜고 실제로 표시되는 안내에 따라 진행하세요. 권한 또는 구성 오류가 표시되면 먼저 안내 내용을 읽고 기기에 관리 제한이 있는지, 다른 VPN 구성이 현재 연결에 영향을 주는지 확인합니다. 관리되는 기기는 해당 관리 정책을 따르고, 정체를 알 수 없는 구성을 함부로 삭제하지 마세요.

연결됨: 현재 테스트 조건 유지

상단 상태가 Not Connected에서 연결 상태로 바뀌면 선택한 서버, 모드, 네트워크를 그대로 유지합니다. 시스템에 VPN 상태가 표시되면 관련 연결 구성이 활성화된 것입니다. 하지만 대상 웹사이트의 요청이 반드시 프록시를 거쳤다거나 서버가 모든 대상에 접속할 수 있다는 뜻은 아닙니다. 다음 단계에서 새 요청을 보내 현재 모드에 맞게 처리되는지 확인해야 합니다.

이번 수동 테스트 중에는 On Demand를 추가로 조정하지 마세요. On Demand는 이후 연결이 자동으로 설정되는 방식에 영향을 주며 서버 정보를 가져오는 단계와는 관계가 없습니다. 연결을 끈 뒤 앱이 다시 자동 연결된다면 스위치가 고장 났다고 단정하지 말고 기존 On Demand 설정을 확인하세요.

구독은 저장됐지만 서버 항목이 없음

먼저 Type이 Subscribe인지, 주소가 온전한지, 업데이트 중 명확한 오류가 표시되었는지 확인합니다. 이 단계의 문제는 구독 내용을 가져오는 과정에서 발생한 것이므로 아직 서버 연결 상태를 판단할 수 없습니다. 기기의 기본 네트워크가 정상적으로 작동하는지 확인한 뒤 기존 구독이 유효한지 살펴보세요. 삭제와 재추가를 반복하는 것만으로 업데이트 성공을 확인할 수는 없습니다. 인증 매개변수가 포함된 전체 주소를 공개 페이지에 붙여넣지 마세요.

Connectivity Test 실패 또는 결과가 일치하지 않음

Settings에서 Test Method를 열고 현재 방법을 먼저 기록한 뒤 테스트 결과를 해석하세요. 테스트 방법마다 확인하는 내용이 다르므로 서로 다른 방법의 결과를 같은 지연 시간이나 사용 가능성 지표로 비교하면 안 됩니다. 해당 항목을 다시 테스트하고 Host, Port, 프로토콜 유형, 인증 값을 확인하세요. 사용할 수 있는 다른 항목이 있다면 모드와 테스트 대상을 유지한 채 서버만 바꿔 비교할 수 있습니다. 특정 항목에서만 실패하면 먼저 해당 항목의 정보를 확인하세요.

연결은 됐지만 페이지가 열리지 않음

먼저 Global Routing을 확인합니다. Direct라면 선택한 프록시 서버가 Proxy 모드처럼 요청을 처리하지 않습니다. Config라면 현재 구성 파일과 규칙 정책을 확인하세요. 다음으로 Proxy를 비교 기준으로 사용해 Config에서만 문제가 발생하는지 살펴봅니다. 모드를 바꿔도 계속 실패한다면 여러 설정을 한꺼번에 바꾸지 말고 도메인 조회, 서버 상태, 대상 자체의 이용 가능 여부를 확인하세요.

DNS 문제는 기존 설정부터 살펴보고 시스템의 이름 해석 방식이나 구성에 있는 DNS 항목을 기록합니다. 확인되지 않은 주소를 한꺼번에 여러 개 입력하며 테스트하지 마세요. 일부 도메인만 실패하고 다른 요청은 정상이라면 Data의 새 요청과 실제 오류 내용을 함께 확인해 범위를 좁힙니다. 이름 해석과 규칙의 연결 방식은 시스템 튜토리얼을 참고하세요. 설정을 변경한 뒤에는 같은 대상으로 새 요청을 보내야 합니다. 이전 테스트 수치만 새로고침해서는 안 됩니다.

수동 스위치와 연결 동작이 일치하지 않음

Settings에서 On Demand에 자동 연결 조건이 설정되어 있는지 확인합니다. 네트워크가 바뀌거나 조건이 충족될 때 연결 동작에 영향을 줄 수 있으므로 수동으로 끈 뒤 다시 연결된다면 해당 조건부터 살펴보세요. 처음 문제를 확인할 때는 자동 동작과 수동 테스트를 따로 기록해 어떤 조작이 연결을 시작했는지 확인한 뒤 설정 변경 여부를 결정합니다. 원인을 찾지 못한 문제를 해결하려고 Proxy, TCP, UDP 등 여러 섹션을 동시에 바꾸지 마세요.

원인을 찾기 어려운 경우: Diagnostics 정보 정리

필요하면 Settings의 Diagnostics에서 사용할 수 있는 진단 항목을 확인합니다. 문제가 발생한 네트워크 유형, 선택한 서버, Global Routing, Test Method, 재현 가능한 조작 순서를 먼저 기록한 뒤 관련 정보를 수집하세요. 진단 파일에서 민감한 정보가 모두 자동으로 숨겨진다고 단정하지 마세요. 관련 지원 담당자에게 보내기 전에 구독 주소, 비밀번호, 인증 매개변수 및 공개할 필요가 없는 접속 기록을 확인하고 삭제합니다.

기존 서비스 제공자에게 서버 상태를 문의해야 한다면 해당 항목과 관련된 오류 설명만 보내고 민감한 값은 먼저 삭제하세요. 앱 받기, 구매 복원, 기기 호환성에 관한 내용은 앱 받기 안내를 확인하세요. 기본 연결을 복구한 뒤 접속 확인으로 돌아가 다시 테스트하고 사용할 수 있는 구성을 보관합니다. 이후 설정을 조정할 때 이 구성을 비교 기준으로 사용하면 처음부터 다시 시작할 필요가 없습니다.