Shadowrocket 사용 가이드

Shadowrocket을 열고 Home으로 이동합니다. 보유한 정보가 서버 목록을 갱신하는 구독 링크인지, 프로토콜·주소·포트·인증 정보가 포함된 개별 서버 정보인지 먼저 확인하세요. 두 정보는 입력 위치가 다릅니다. 구독 링크 전체를 Host에 붙여 넣거나 서버 주소를 Subscribe 링크로 입력하지 마세요.

기존 구독 링크가 있다면 Subscribe 사용

Home에서 Add Server를 누르거나 해당 추가 메뉴로 이동합니다. 추가 화면에서 Type을 누르고 Subscribe를 선택한 다음, 본인의 구독 링크 전체를 URL 필드에 입력하고 저장하세요. 복사할 때 앞뒤에 공백이나 줄바꿈, 설명 문구가 섞이지 않았는지 확인합니다. 링크의 쿼리 매개변수도 내용의 일부이므로 직접 삭제하거나 수정하지 마세요. 알아보기 쉬운 이름을 메모로 입력해도 연결 매개변수에는 영향을 주지 않습니다.

저장하고 구독 정보 가져오기가 완료되면 Home으로 돌아가 SERVER 그룹에 서버 항목이 표시되는지 확인합니다. 구독 이름과 실제 서버 이름은 다를 수 있으므로 목록을 펼치거나 항목을 확인한 뒤 선택하세요. 구독 기록만 보이고 선택 가능한 서버가 없다면 가져오기가 완료됐는지, 링크가 유효한지, 현재 네트워크에서 구독 주소에 접근할 수 있는지 먼저 확인합니다. 같은 구독을 반복해서 추가해도 원본 주소 문제는 해결되지 않는 경우가 많습니다.

기존 서버 정보가 있다면 Type에 맞춰 입력

Add Server로 이동한 뒤 본인이 가진 정보에 맞는 Type을 선택합니다. 프로토콜마다 필요한 필드가 다릅니다. 스크린샷의 Host, Port, Password, Method는 해당 예시 유형에 사용되는 필드이므로 모든 프로토콜에 그대로 적용할 수 없습니다. Host에는 서버 호스트 이름이나 주소를, Port에는 제공된 포트를 입력하세요. 인증 정보, 암호화 방식, TLS 관련 필드는 원본 정보와 하나씩 대조하고 대소문자와 특수문자도 동일하게 입력합니다.

해당 QR 코드가 있다면 Scan QR Code로 인식한 뒤 각 필드를 확인할 수 있습니다. Import from Cloud JSON은 해당 형식의 기존 자료에만 사용하며, 임의의 웹 주소를 입력하는 기능이 아닙니다. 저장한 뒤 Home으로 돌아가 사용할 서버를 선택하세요. 이름은 메모일 뿐이며, 항목을 선택해야 이후 프록시 요청에 사용할 대상이 정해집니다. 이 단계가 끝나면 구분할 수 있고 정보가 빠짐없이 입력된 서버 항목이 있어야 합니다. 다음 단계에서 어떤 요청을 해당 서버로 보낼지 결정합니다.

구독 링크에는 접근 자격 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요. 전체 링크나 QR 코드, 인증 정보가 보이는 스크린샷을 공개된 곳에 올리지 마세요. 구독 갱신은 주로 서버 목록을 갱신하며 트래픽 분기 규칙까지 함께 설치하는 것은 아닙니다. Config 설정은 별도로 확인해야 합니다.

서버가 Home에 표시되면 Global Routing을 엽니다. 여기서는 요청 처리 방식을 결정하며 서버 정보를 다시 입력하는 곳이 아닙니다. 기본 모드는 Config, Proxy, Direct 세 가지입니다. 처음 설정할 때는 목적부터 명확히 하세요. 선택한 서버가 작동하는지 확인하려는 것인지, 기존 구성을 이용해 트래픽을 분기하려는 것인지에 따라 점검 방법이 달라집니다.

Config: 현재 구성에 따라 트래픽 분기

규칙에 따라 트래픽을 분기하려면 Config를 사용합니다. Config로 이동해 사용할 구성 파일이 선택되어 있는지 확인하고 규칙 내용을 살펴보세요. 구독은 서버를 제공하고 구성 파일은 요청 처리 규칙을 정의하므로 서로 대체할 수 없습니다. Subscribe만 가져온 뒤 Config를 선택했다고 해서 규칙이 원하는 대로 설정된 것은 아닙니다.

공식 스크린샷의 구성 편집 화면은 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 항목으로 구성되어 있습니다. 기본 사용법을 익힐 때는 Rule과 해당 규칙이 참조하는 정책을 우선 확인하세요. 연결을 위해 다른 항목을 하나씩 모두 켤 필요는 없습니다. Add Rule은 규칙을 추가하는 기능입니다. 기존 구성을 사용 중이라면 먼저 현재 규칙 순서와 최종 처리 방식을 확인한 뒤 수정 여부를 결정하세요. 일반적인 연결 문제를 해결하는 과정에서 HTTPS Decryption을 임의로 변경하지 마세요.

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

위 내용은 규칙을 읽는 방법을 보여주는 예시일 뿐, 완성된 구성 파일이 아니며 그대로 붙여 넣을 필요도 없습니다. DOMAIN-SUFFIX 예시는 해당 도메인에 일치하는 요청을 PROXY로 처리하고, GEOIP 예시는 조건에 맞는 주소를 DIRECT로 처리하며, FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. 규칙은 대개 순서대로 적용되므로 앞쪽의 범위가 넓은 규칙이 뒤쪽의 세부 규칙보다 먼저 일치할 수 있습니다. 실제 동작은 전체 구성과 정책 정의에 따라서도 달라집니다.

Proxy와 Direct: 테스트 목적을 구분

Proxy는 해당 모드에서 처리되는 요청을 선택한 프록시 서버로 전달합니다. 이를 통해 서버 자체가 작동하지 않는 문제와 구성의 트래픽 분기가 예상과 다른 문제를 구분할 수 있습니다. Direct는 직접 연결하므로 프록시 연결을 확인하는 용도로 사용할 수 없습니다. 비교를 위해 Proxy로 잠시 전환해 테스트한 뒤, 규칙 분기가 목적이었다면 Config로 복원하고 규칙을 확인하세요. 한 번 연결됐다는 사실만으로 최종 구성이 올바르다고 판단하지 마세요.

이 단계에서는 현재 모드, 선택한 구성, 서버가 서로 일치하는지만 확인하면 됩니다. 구성 파일 출처, 복잡한 규칙, 변경 사항 복원 방법은 문제 해결에서 확인할 수 있습니다. 구입이나 계정 관련 내용은 App Store 구입 안내를 참고하세요. 첫 연결 과정에서 이 항목들을 한꺼번에 처리할 필요는 없습니다.

Home으로 돌아가 SERVER에서 선택한 서버를 확인하고 Global Routing이 방금 정한 모드인지 살펴봅니다. Config를 사용할 예정이라면 지정한 구성이 활성화되어 있는지도 확인하세요. 두 항목을 확인한 다음 화면 상단의 연결 스위치를 켭니다. 연결 전에는 상단에 Not Connected가 표시될 수 있습니다. 연결 과정이 시작됐는지 확인하려면 먼저 스위치와 상태 영역을 살펴보세요.

처음 연결할 때 시스템에서 VPN 구성 추가 안내가 표시될 수 있습니다. 이는 Shadowrocket이 시스템 네트워크 연결을 설정하는 데 필요한 권한으로, 앱을 다시 구입하거나 서버 비밀번호를 재설정하는 절차가 아닙니다. 안내 내용을 읽고 요청 주체를 확인한 다음 허용하세요. 시스템 요구에 따라 기기 인증을 완료하고 Shadowrocket으로 돌아와 상태가 바뀌는지 기다립니다. 이전에 권한 요청을 취소했다면 스위치를 다시 켜 시스템에서 필요한 절차를 다시 시작하도록 할 수 있습니다.

연결이 설정되면 시스템에 VPN 표시가 나타날 수 있습니다. 기기와 표시 위치에 따라 다를 수 있으므로 상태 막대에 표시되는 문구만으로 성공 여부를 판단하지 마세요. Home으로 돌아가 연결 상태가 안정적인지 확인하고, 다음 단계에서 실제 요청이 처리되는지도 점검하는 것이 중요합니다. 연결 스위치가 켜져 있다는 것은 기기의 로컬 연결이 작동 중이라는 뜻이지, 원격 서버 인증과 DNS 조회, 모든 대상 웹사이트가 정상임을 보장하지는 않습니다.

스위치를 켠 직후 다시 꺼지면 시스템 안내나 앱 오류를 먼저 기록하고, 다른 VPN 구성이 사용 중인지, 기기 관리 제한이 있는지, 권한 설정이 완료됐는지 확인하세요. 스위치를 빠르게 반복해서 켜고 끄거나 처음부터 모든 시스템 네트워크 설정을 삭제하지 마세요. 시스템 설정의 VPN 및 기기 관리 관련 항목에서 VPN 구성을 확인할 수 있습니다. 해당 항목을 찾지 못하거나 다시 설정해야 한다면 문제 해결의 VPN 권한 안내를 따라 단계별로 진행하세요.

iPad의 넓은 화면에서는 목록과 세부 정보가 동시에 표시될 수 있지만 사용 순서는 같습니다. 서버를 선택하고 Global Routing을 확인한 뒤 연결을 켭니다. 다른 기기에서 앱을 사용할 수 있더라도 이 기기에 동일한 구독과 구성이 설정되어 있다는 뜻은 아니므로 현재 기기에서 항목별로 확인하세요. 권한 설정을 완료한 뒤 현재 선택을 유지한 채 다음 단계에서 결과를 확인합니다. 이때 규칙을 변경하거나 서버를 바꾸지 마세요.

문제 해결은 앞 단계의 기본 조건부터 확인합니다. 먼저 연결을 끄고 현재 Wi-Fi 또는 셀룰러 네트워크에서 일반적인 웹 접근이 가능한지 확인하세요. 로그인이 필요한 네트워크라면 로그인도 마쳐야 합니다. 그런 다음 다시 연결해 문제를 재현합니다. 기본 네트워크가 작동하지 않는 상태에서는 규칙, 비밀번호, 테스트 방법을 바꿔도 변수가 늘어날 뿐이며 네트워크 접속 문제를 해결하지 못합니다.

목록이 비어 있음, 테스트 실패, 연결 후 페이지가 열리지 않음

구독을 갱신한 뒤 목록이 비어 있다면 본인 구독 링크가 온전한지, 서비스가 여전히 유효한지, 갱신 중 오류가 표시됐는지 확인하세요. 구독 갱신 실패와 서버 연결 실패를 혼동하지 마세요. 서버 항목은 있는데 테스트에 실패한다면 선택한 항목의 Host, Port, 프로토콜 및 인증 정보를 확인합니다. 추가 TLS 매개변수가 필요한 연결도 기존 정보와 하나씩 대조하세요. 오류를 피하려고 인증서 검증을 끄지 마세요.

연결 상태로 표시되는데 페이지가 열리지 않는다면 먼저 Direct를 잘못 선택하지 않았는지 확인하고, Config에서 사용 중인 파일과 정책이 실제로 존재하는지도 살펴봅니다. 특정 대상만 문제가 있다면 관련 규칙과 DNS 설정을 확인하세요. 모든 대상에 문제가 있다면 서버 인증, 기본 네트워크, VPN 상태를 점검합니다. 문제 범위를 구분한 뒤 수정하면 관련 없는 설정을 건드릴 가능성을 줄일 수 있습니다.

Test Method, On Demand 및 Diagnostics

Settings에서 Test Method, On Demand, Diagnostics 등의 메뉴를 확인할 수 있습니다. Test Method에 따라 테스트 결과의 의미가 달라질 수 있으므로 서버 두 개나 결과 두 건을 비교하기 전에 같은 테스트 방식과 네트워크 조건을 사용했는지 확인하세요. 한 번의 응답 속도로 장기적인 사용 가능성을 판단하거나 테스트 방식 차이로 생긴 결과를 서버 상태 변화로 오해하지 마세요.

수동으로 연결을 끈 뒤 다시 연결되는 동작이 나타난다면 On Demand 조건이 작동 중인지 확인하세요. 처음 설정할 때는 현재 상태를 기록해 두고, 필요하다고 판단되는 경우 On Demand 동작을 잠시 중지해 수동 연결을 확인한 뒤 복원할 수 있습니다. Proxy, TCP, UDP 등의 설정은 영향을 충분히 이해한 뒤 조정하세요. 기본 연결을 확인하려고 모든 설정을 하나씩 변경할 필요는 없습니다. Language는 화면 표시 언어만 바꾸며 서버 정보 문제를 해결하지 않습니다.

Diagnostics는 문제 원인을 파악하는 데 도움이 되는 정보를 수집할 수 있습니다. 오류 유형, 권한 설정 단계와 연결 단계 중 문제가 발생한 시점, 선택한 모드, 현재 네트워크를 기록하세요. 기록을 공유하기 전에는 구독 주소, 인증 정보, 개인적으로 방문한 대상을 가리세요. 전체 구성을 그대로 공개하지 마세요. 설정을 변경했다면 확인 가능한 상태로 되돌린 다음 테스트해 알 수 없는 상태에서 변경을 계속 쌓지 않도록 합니다.

원인을 찾지 못했다면 문제 해결에서 ‘첫 실행 및 VPN 권한’, ‘구독 및 서버 가져오기’, ‘규칙 분기 및 문제 해결’을 차례로 확인하세요. 기본 절차는 다음과 같이 정리할 수 있습니다. 기존 정보를 가져오고 서버를 선택한 다음 Global Routing과 구성을 확인하고 VPN 권한을 허용한 뒤 실제 요청으로 결과를 확인합니다. 이후 설정을 변경할 때도 이 순서에 따라 항목별로 점검하세요.