Shadowrocket 사용 가이드
기존 자료 가져오기부터 실제 접속 확인까지, 다섯 단계로 처음 연결을 설정합니다. 각 단계의 결과를 확인한 다음 진행하세요.
Add Server 또는 Subscribe로 가져오기
Shadowrocket을 열고 Home의 SERVER 영역에서 Add Server를 찾습니다. 먼저 보유한 자료의 종류를 확인하세요. 구독 주소는 서버 목록을 가져올 때 사용하고, 직접 입력하는 매개변수는 서버 한 대를 추가할 때 사용합니다. QR 코드는 실제로 어떤 자료가 들어 있는지 확인해야 합니다. 세 가지 방법 중 하나만 선택하면 되며, 처음 설정할 때 같은 자료를 반복해서 가져올 필요는 없습니다.
구독 주소가 있으면 Add Server를 열고 Type에서 Subscribe를 선택한 다음 전체 주소를 URL에 붙여넣고 저장합니다. 주소 끝의 쿼리 매개변수를 빠뜨리지 말고 구독 주소를 단일 서버의 Host로 입력하지 마세요. Home으로 돌아와 해당 구독 그룹을 펼치고 선택 가능한 항목이 나타났는지 확인합니다. 저장했는데도 그룹이 비어 있다면 먼저 링크가 완전한지 확인한 뒤 구독이 정상적으로 업데이트되는지 확인하세요.
서버 한 대의 매개변수를 가지고 있다면 올바른 Type을 선택한 다음 해당 프로토콜에 필요한 항목을 입력합니다. 스크린샷의 Shadowsocks를 예로 들면 Host, Port, Password, Method를 각각 확인해야 합니다. 주소와 포트는 구분해서 입력하고 비밀번호 앞뒤에 공백이 들어가지 않도록 하며, 보유한 자료의 Method를 기준으로 설정하세요. 다른 프로토콜은 입력 항목이 다를 수 있으므로 스크린샷을 보고 해당 프로토콜에 필요하지 않은 내용을 입력하지 마세요.
자신의 QR 코드가 있다면 Add Server에서 Scan QR Code를 선택합니다. 인식이 끝나면 가져온 결과를 확인한 뒤 Home으로 돌아갑니다. QR 코드와 구독 주소에는 인증 정보가 포함될 수 있으므로 캡처 화면을 공개하지 마세요. 마지막으로 SERVER에서 확인할 서버를 선택하고 그룹 및 항목 이름을 기억해 둡니다. 다음 단계에서 이름이 같은 항목을 혼동하지 않도록 주의하세요. 자세한 항목 설명은서버 관리 매뉴얼의 Add Server 섹션을 참조하세요.
Global Routing 모드 선택
항목을 선택한 다음 Home으로 돌아와 Global Routing을 엽니다. 서버 선택은 “어느 연결 경로를 사용할지”를 정하고, 라우팅 모드는 “이번 요청에 프록시를 사용할지”를 정합니다. 두 설정은 각각 적용됩니다. 목록에서 항목을 선택했더라도 모든 요청이 해당 항목을 통해 전달되는 것은 아닙니다.
- Config: 현재 구성 파일에 따라 요청을 분류합니다. 어떤 주소는 프록시를 사용하고 어떤 주소는 직접 연결해야 하는지 알고 있을 때 적합합니다. 대상 주소가 앞선 규칙에 일치하지 않으면 마지막
FINAL을 확인해 규칙에 일치하지 않은 요청의 처리 방식을 판단하세요. - Proxy: 클라이언트가 처리하는 요청에 프록시 경로를 사용합니다. 처음 진단할 때 선택한 서버의 연결을 확인하는 용도로 잠시 사용할 수 있습니다. 이를 통해 “서버 자체가 연결되지 않는 문제”와 “구성이 요청을 다른 경로로 보내는 문제”를 구분할 수 있습니다. 확인이 끝나면 평소 사용하던 모드로 돌아가세요.
- Direct: 프록시 서버를 거치지 않고 요청을 보내 현재 네트워크에서 직접 접속한 결과를 확인합니다. Home의 연결 스위치를 끄는 기능이 아니므로 연결을 끊는 용도로 사용할 수 없습니다.
Config를 선택했다면 Config에서 실제로 활성화된 파일을 확인하세요. 규칙을 확인하려면 해당 파일을 열어 Rule을 살펴봅니다. 스크린샷은 구성 파일 편집 화면이며 Global Routing 선택 메뉴가 아닙니다. 파일 이름만 보고 규칙의 동작을 판단하지 말고, 처음 연결할 때 URL Rewrite나 HTTPS Decryption을 변경할 필요도 없습니다.
예를 들어 Rule에서 특정 도메인 접미사가 PROXY를 가리킨다면 실제로 해당 접미사를 사용하는 접속 가능한 페이지를 확인에 사용할 수 있습니다. 우선 서버를 통해 요청을 전달할 수 있는지 확인하려면 Proxy를 사용하고, 연결이 되면 Config로 돌아와 트래픽 분할을 확인하세요. 이번 테스트에 사용할 모드를 정한 뒤 Home으로 돌아와 표시된 값이 업데이트되었는지 확인합니다.
Home의 연결 스위치 켜기
Home에서 먼저 두 가지를 확인합니다. SERVER에서 선택한 항목이 그대로인지, Global Routing에 앞서 정한 모드가 표시되는지 확인합니다. 그런 다음 상단의 Not Connected 옆 스위치를 켭니다. 처음 사용할 때 시스템에서 VPN 구성을 추가하라는 알림이 표시될 수 있습니다. 이 요청이 Shadowrocket에서 시작된 것인지 확인한 뒤 시스템 안내에 따라 승인하세요. 기기 확인이 필요하면 시스템 화면에서 완료합니다.
Home으로 돌아와 스위치가 켜진 상태가 될 때까지 기다립니다. 스위치를 켠 직후 다시 꺼지면 권한 알림이나 오류 메시지가 있는지 먼저 확인하고 계속 누르지 마세요. 시스템 알림을 이전에 취소했다면 다시 켤 때 같은 요청이 표시되는지 확인합니다. 조직에서 관리하는 기기에서 VPN 구성에 제한이 있다면 먼저 기기 관리 요건을 확인하세요. 문제 해결을 위해 기존 구성을 삭제하지 마세요.
기기에서 다른 VPN 구성을 함께 사용하는 경우 테스트 전에 해당 구성이 현재 연결을 점유하는지 확인합니다. 직접 관리할 수 있고 일시적으로 연결을 끊어도 되는 연결만 조정하세요. 로그인해야 하는 무선 네트워크에 방금 연결했다면 먼저 Shadowrocket을 끄고 네트워크 로그인을 완료한 다음 Home으로 돌아와 연결을 켭니다. 이렇게 하면 네트워크가 아직 준비되지 않은 상태를 서버 문제로 오인하는 일을 방지할 수 있습니다.
스위치가 계속 켜져 있으면 클라이언트 연결이 시작된 것입니다. 브라우저에서 대상 페이지에 접속할 수 있다거나 요청이 반드시 프록시를 사용한다는 뜻은 아닙니다. 예를 들어 Config가 대상 요청을 DIRECT로 처리할 수 있습니다. 따라서 이 단계에서는 스위치 상태만 확인하고 선택한 서버와 라우팅 모드를 유지한 채, 다음 단계에서 같은 조건으로 실제 요청을 확인합니다.
Connectivity Test와 실제 접속으로 확인
현재 네트워크, 서버 항목 및 라우팅 모드를 그대로 유지한 상태에서 Home의 Connectivity Test를 누릅니다. 이 테스트는 “현재 테스트 방식으로 항목을 탐지할 수 있는지”를 확인합니다. 지연 시간이 표시되면 이번 탐지에 응답이 있었다는 뜻이지만, 모든 도메인을 해석할 수 있다거나 대상 앱의 요청이 프록시를 사용한다는 의미는 아닙니다. 시간 초과가 발생하면 어떤 항목을 테스트했는지 먼저 확인하고 다른 기록의 결과로 대신 판단하지 마세요.
그런 다음 브라우저를 열어 접속 가능하다고 이미 알고 있는 페이지를 방문합니다. Config를 확인하는 경우 직접 연결되어야 하는 페이지를 하나 더 선택해 비교할 수 있습니다. 이미 열려 있는 탭만 확인하지 말고 페이지를 새로고침하거나 새 요청을 보내세요. 페이지가 계속 표시되는 것은 캐시된 콘텐츠일 수 있습니다. 확인을 위해 낯선 웹사이트에 접속하거나 계정 정보를 입력할 필요는 없습니다.
Shadowrocket으로 돌아와 방금 접속한 시간과 대상 도메인에 해당하는 새 기록을 찾습니다. 현재 화면에 처리 정책이 표시된다면 PROXY인지 DIRECT인지도 확인합니다. 페이지가 열리고 정책도 예상과 일치해야 이번 라우팅 설정이 목적에 맞게 작동했다고 판단할 수 있습니다. 기기에서 특정 페이지에 접속할 수 있는지만 확인하려는 경우 트래픽 카운터 변화를 별도의 성공 조건으로 볼 필요는 없습니다.
두 가지 모드를 비교할 때는 같은 서버와 테스트 페이지를 유지하고 Global Routing만 변경합니다. Proxy에서는 정상이고 Config에서는 실패한다면 먼저 Rule을 확인하세요. 두 모드 모두 실패한다면 서버 매개변수, 기기 네트워크 및 대상 페이지 상태를 확인합니다. 문제가 재현되면 어느 단계에서 오류가 발생했는지 기록한 다음 아래 안내에 따라 진단하세요.
Settings, Diagnostics 및 Data로 진단
가장 먼저 이상이 발생한 단계를 확인합니다. 서버 항목이 나타나지 않으면 가져오기 단계로 돌아가 주소가 완전한지, Type을 올바르게 선택했는지, 구독 그룹이 정상적으로 로드되는지 확인합니다. 라우팅을 바꿔도 가져오기 오류는 해결되지 않습니다. 항목은 있는데 스위치가 켜진 상태를 유지하지 못한다면 먼저 시스템 알림과 기기 권한을 확인합니다. 이 경우 규칙을 변경해도 연결이 시작되지 않는 문제는 해결할 수 없습니다.
스위치는 안정적으로 켜져 있는데 Connectivity Test 결과만 이상하다면 Settings에서 Test Method를 확인합니다. 테스트 방식이 다르면 결과를 직접 비교하기 어려우므로 재테스트할 때는 같은 방식을 사용하세요. 일부 페이지에서만 접속할 수 없다면 Settings에서 Diagnostics를 찾고 접속 기록과 함께 도메인 해석 실패인지, 해석 이후 연결 실패인지 확인합니다. 전자는 DNS를 먼저 확인하고, 후자는 Global Routing, 일치한 규칙, 서버 매개변수 순서로 점검합니다. 구체적인 DNS 관련 증상은 DNS 해석 실패 문제 해결을 참조하세요.
Data에서는 트래픽 통계를 확인할 수 있습니다. 테스트 전후의 통계값을 비교할 수 있지만 기기의 백그라운드 활동도 트래픽을 만들 수 있으므로 카운터 증가만으로 특정 페이지가 PROXY를 사용했다고 판단할 수는 없습니다. 개별 요청을 확인할 때는 시간, 도메인 및 정책을 우선 확인합니다. 무선 네트워크를 바꾸거나 화면을 잠근 뒤 예상과 다른 상태가 된다면 Settings에서 On Demand가 기기의 자동 연결 동작에 영향을 주는지 확인하세요. 이 설정은 개별 도메인이 어떤 규칙에 일치하는지 결정하지 않습니다.
각 테스트에서는 한 번에 한 항목만 변경한 다음 같은 페이지로 다시 확인합니다. 변경해도 해결되지 않으면 해당 항목을 원래대로 되돌린 뒤 다음 항목을 확인해 여러 설정이 겹쳐 변경되지 않도록 합니다. 오류를 기록할 때는 연결 상태, 라우팅 모드 및 민감 정보를 가린 오류 문구만 보관하세요. 구독 주소, 비밀번호, QR 코드 또는 전체 연결 기록은 포함하지 마세요. 여러 구독을 정리하거나 항목을 업데이트하거나 서버 자료를 백업해야 한다면서버 관리 매뉴얼을 참조하세요.