Shadowrocket · 공식 매뉴얼

Shadowrocket 사용 가이드

서버 또는 구독을 추가하고 Global Routing을 선택한 뒤 연결 및 분기 결과를 확인합니다.

01 / Server

서버 추가 또는 구독 가져오기

먼저 보유한 정보가 어떤 종류인지 확인합니다. 프로토콜, 주소, 포트 및 인증 정보가 있다면 서버를 직접 추가합니다. 서비스 제공업체에서 서버 목록 동기화용 구독 링크를 받았다면 Subscribe를 사용합니다. 브라우저에서 열리는 링크라고 해서 모두 구독 주소인 것은 아닙니다. 링크를 열었을 때 계정 로그인 페이지나 서비스 안내 페이지가 표시되면 본인의 서비스 제공업체에 링크 유형을 확인하세요.

서버 정보가 있는 경우: Add Server 사용

Home을 열고 SERVER 그룹에서 Add Server를 찾습니다. 먼저 Type을 눌러 제공된 정보에 표시된 프로토콜을 선택한 다음 화면에 나타나는 필드를 입력합니다. Host에는 서버 호스트 이름이나 주소를 입력하고, Port는 별도로 입력합니다. 주소와 포트를 Host에 함께 붙여 넣지 마세요. Password, Method 등의 필드가 표시되는지는 Type에 따라 다릅니다. 보유한 서버 정보를 기준으로 입력하고 다른 프로토콜의 매개변수를 적용하지 마세요.

단일 서버의 QR 코드가 있다면 Add Server 하단의 Scan QR Code로 읽은 다음 인식된 프로토콜, 이름 및 주소를 확인할 수 있습니다. Import from Cloud JSON은 별도의 가져오기 기능이므로 Subscribe 대신 사용하지 마세요. 저장하기 전에 복사한 내용의 앞뒤에 공백이나 줄바꿈이 추가되지 않았는지 확인합니다. 서버 정보에 매개변수가 포함되어 있다면 임의로 일부를 삭제하지 마세요.

구독 링크가 있는 경우: Subscribe 사용

Add Server에서 Type을 열고 Subscribe를 선택한 다음 전체 구독 링크를 해당 주소 입력란에 넣고 저장합니다. Home으로 돌아와 목록이 업데이트될 때까지 기다립니다. 저장 후 구독 출처만 표시되고 서버 항목이 보이지 않으면 먼저 해당 구독의 업데이트 결과를 확인하세요. 구독 주소에는 접근 인증 정보가 포함될 수 있으므로 전체 링크를 공개 댓글에 붙여 넣지 마세요. 주소 입력란이나 QR 코드가 함께 보이는 화면도 공유하지 마세요.

이 단계의 완료 기준은 Home의 SERVER 그룹에 선택할 수 있는 서버 항목이 하나 이상 표시되는 것입니다. 항목이 보인다는 것은 정보가 클라이언트에 저장되었다는 뜻일 뿐, 서버 연결 가능 여부를 확인한 것은 아닙니다. 다음 단계에서 트래픽 처리 방식을 설정한 뒤 연결을 테스트합니다.

Shadowrocket Add Server 화면에 표시된 Type, Host, Port, Password 및 Method 필드
Add Server에서 Type을 먼저 선택한 다음 해당 유형에 필요한 필드를 확인합니다. 하단에서 Scan QR Code를 찾을 수 있습니다.

02 / Routing

Global Routing 모드 선택

Home에서 Global Routing을 찾아 눌러 세 가지 옵션을 확인합니다. 모드를 선택하기 전에 이번에 확인하려는 항목을 정하세요. 일반적인 사용에서는 특정 규칙이 적용되는지 확인해야 하는 경우가 많고, 서버에 처음 연결할 때는 대상에 접속할 수 있는지만 확인하면 될 수 있습니다. 두 목적에 같은 모드를 사용할 필요는 없습니다.

구성(Config)
현재 구성의 규칙에 따라 요청을 처리합니다. 대상별로 PROXY, DIRECT 또는 REJECT를 적용할 때 적합합니다. 테스트 결과는 현재 활성화된 구성과 규칙 순서에 따라 달라집니다.
프록시(Proxy)
선택한 서버를 통해 트래픽을 처리합니다. 처음 연결할 때 프록시 경로를 확인하는 데 사용할 수 있어 규칙 선택과 서버 연결 상태를 분리해 테스트할 수 있습니다. 테스트가 끝나면 평소 사용하는 모드로 되돌립니다.
직접 연결(Direct)
트래픽이 선택한 프록시 서버를 거치지 않습니다. 같은 네트워크에서 비교하는 데 적합합니다. 페이지가 열리더라도 프록시 서버를 사용할 수 있다는 뜻은 아닙니다.

구성(Config)을 선택했다면 하단의 Config 페이지로 이동해 어떤 파일이 활성화되어 있는지 확인합니다. Home의 Config는 규칙에 따라 트래픽을 처리하겠다는 의미입니다. 하단의 Config는 구성 파일을 확인하고 편집하는 메뉴이므로 두 기능은 같은 스위치가 아닙니다. 오른쪽 이미지는 파일 편집 화면으로, Rule과 Add Rule을 찾을 때 사용합니다. Global Routing 모드 선택 메뉴가 아닙니다.

처음 사용할 때는 기존 구성으로 먼저 확인하고, 규칙 추가와 DNS 변경 및 서버 교체를 한꺼번에 진행하지 마세요. 대상 트래픽이 예상한 경로를 따르지 않는다면 Rule을 확인합니다. 일반적으로 먼저 일치하는 해당 규칙이 정책을 결정하고, FINAL은 앞선 규칙과 일치하지 않은 요청을 처리합니다. 조건의 범위가 넓은 규칙을 앞쪽에 두면 뒤쪽의 더 구체적인 규칙이 적용되지 않을 수 있습니다. 편집 전에는 원래 구성을 보관해 쉽게 복원할 수 있도록 합니다. 규칙 작성 방법은 전체 사용 매뉴얼에서 확인하세요.

Shadowrocket Config 파일 편집 화면에 표시된 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule
Config 파일 편집 화면입니다. 규칙 내용과 순서를 확인하려면 Rule부터 살펴봅니다.

03 / Connection

Home에서 연결 시작

Home으로 돌아와 SERVER 그룹에서 테스트할 항목 하나를 선택한 다음 Global Routing에 방금 선택한 모드가 표시되는지 확인합니다. 구독을 가져온 후 이름이 비슷한 항목이 여러 개 나타날 수 있으므로 첫 테스트에서는 하나를 고정해 사용하세요. 그렇지 않으면 네트워크나 모드를 전환한 뒤 어떤 항목이 변화를 일으켰는지 판단하기 어렵습니다.

두 항목을 확인한 다음 Home 상단의 Not Connected 옆 스위치를 켭니다. 처음 활성화할 때 시스템에서 VPN 구성을 추가하라는 안내가 표시될 수 있습니다. 이는 시스템이 Shadowrocket에서 해당 네트워크 트래픽을 처리하도록 허용하는 단계입니다. 안내가 방금 연 Shadowrocket에서 표시된 것인지 확인한 다음 시스템 안내에 따라 권한을 허용하고, 완료되면 Home으로 돌아와 스위치 상태가 안정될 때까지 기다립니다. 안내를 취소했다면 Home으로 돌아와 연결을 다시 시작할 수 있습니다.

스위치를 켠 직후 다시 연결 해제 상태가 되면 먼저 화면에 표시된 안내를 기록하고 스위치를 연속해서 누르지 마세요. 기기에서 다른 VPN 구성을 사용 중이거나 조직에서 관리하는 기기라면 연결 충돌이나 시스템 정책 제한이 있는지 확인합니다. 테스트를 위해 조직에서 제공한 구성을 제거하지 마세요. 관리되는 기기의 권한 문제는 기기 관리자에게 확인해야 합니다.

Home에 연결됨으로 표시되어도 클라이언트가 연결에 필요한 시스템 채널을 시작했다는 의미일 뿐, 특정 웹사이트의 트래픽이 PROXY를 사용한다는 뜻은 아닙니다. 다음 단계에서 현재 서버와 네트워크를 유지한 채 서버 테스트 결과와 실제 접속 결과를 각각 확인합니다.

Shadowrocket Home 화면에 표시된 Not Connected 스위치, Global Routing, Connectivity Test 및 SERVER 그룹
Home에서 SERVER 항목을 선택하고 Global Routing을 확인한 다음 상단 스위치를 켭니다.

04 / Verification

연결 및 규칙 적용 확인

서버를 먼저 테스트한 뒤 대상 웹페이지 열기

같은 Wi-Fi 또는 Cellular 네트워크를 유지한 상태에서 Home의 Connectivity Test를 실행하고 선택한 서버가 결과를 반환하는지 확인합니다. 테스트가 실패하면 시간 초과인지 다른 안내인지 기록하고, 한 번의 결과만으로 항목을 삭제하지 마세요. 테스트에 성공하더라도 현재 테스트 방식에서 응답을 받았다는 의미일 뿐, 모든 웹사이트와 앱 또는 프로토콜을 사용할 수 있다는 뜻은 아닙니다.

그다음 브라우저에서 평소 사용하고 정상 여부를 확인할 수 있는 웹페이지를 다시 불러옵니다. 연결 전에 이미 열어 둔 탭만 확인하지 마세요. 캐시나 이전에 생성된 연결 때문에 기존 페이지가 계속 보일 수 있습니다. 새 탭을 열고 직접 새로고침해 페이지 내용이 실제로 다시 불러와지는지 확인하세요.

두 대상을 사용해 Config 분기 확인

구성(Config)을 선택했다면 현재 규칙에서 익숙한 대상 두 개를 찾습니다. 하나는 PROXY를 사용하고 다른 하나는 DIRECT를 사용하도록 예상되는 대상으로 선택합니다. 각각 다시 접속하고 화면에 관련 기록이 있다면 Diagnostics에서 요청 도메인과 실제 정책을 비교합니다. 두 웹페이지가 모두 열린다는 사실만으로는 접속 가능 여부만 알 수 있습니다. 경로가 다른지는 정책 기록으로 확인하세요. 입력한 도메인이 다른 주소로 이동하는지 확인하고, 페이지의 이미지나 다른 리소스 요청을 기본 페이지 요청과 혼동하지 마세요.

서버 문제와 규칙 문제를 구분하려면 같은 대상을 대상으로 Proxy로 잠시 전환해 다시 테스트할 수 있습니다. 서버, 네트워크 및 대상은 그대로 유지하세요. Proxy에서는 사용할 수 있지만 Config에서는 실패한다면 활성화된 구성 파일과 규칙 일치를 먼저 확인합니다. 두 모드에서 모두 실패한다면 서버 정보와 네트워크를 다시 확인합니다. 기본 네트워크를 확인하려면 Direct를 비교 테스트에 사용할 수 있습니다. 테스트가 끝나면 평소 사용하는 모드로 복원합니다.

Data를 열어 접속 전후의 트래픽 변화량을 비교할 수도 있습니다. 클라이언트를 통과한 트래픽이 있는지 확인하는 데 적합하지만 트래픽 증가만으로 특정 규칙이 적용되었다고 단정할 수는 없습니다. 테스트 시의 모드, 선택한 서버 및 결과를 기록해 두면 문제가 생겼을 때 같은 조건으로 재현할 수 있습니다.

05 / Diagnostics

증상별로 문제 해결

가장 먼저 실패한 단계부터 확인합니다. 목록에 선택할 서버가 없다면 가져오기부터 처리하고, 서버를 선택했는데 스위치가 켜지지 않는다면 시스템 권한을 확인합니다. 연결이 설정된 뒤에야 웹페이지 접속과 규칙 기록으로 분기 상태를 판단할 수 있습니다.

구독을 저장했지만 SERVER에 선택할 항목이 없음

구독 항목으로 돌아가 주소가 완전한지 확인합니다. 특히 복사할 때 누락되기 쉬운 쿼리 매개변수를 확인하세요. 로그인 페이지 링크가 아니라 서비스 제공업체가 클라이언트용으로 제공한 주소인지 확인합니다. 기존 구성을 정상적으로 사용할 수 있다면 먼저 보관하고, 한 번의 업데이트 실패를 해결하기 위해 전체 구성을 삭제하지 마세요. 같은 구독에서 빈 내용이나 업데이트 오류가 여러 차례 반환된다면 오류 안내를 기록하고 본인의 서비스 제공업체에 주소가 유효한지 확인합니다.

연결이 시작되지 않거나 시작 직후 끊김

먼저 첫 연결 시 표시되는 VPN 구성 안내를 처리했는지 확인하고, Shadowrocket 연결을 해제한 상태에서 현재 네트워크로 평소 사용하는 직접 연결 사이트에 정상적으로 접속할 수 있는지 확인합니다. Wi-Fi 로그인 절차가 필요하다면 먼저 네트워크 안내에 따라 로그인한 뒤 Home으로 돌아와 테스트합니다. 수동으로 연결을 끊은 뒤 시간이 지나 다시 자동 연결된다면 Settings에서 On Demand가 활성화되어 있는지와 관련 트리거 조건을 확인합니다. 자동 재연결과 수동 연결 실패는 서로 다른 증상이므로 따로 판단해야 합니다.

연결됨으로 표시되지만 테스트 또는 웹페이지 접속 실패

먼저 Type, Host, Port 및 인증 필드를 비교한 뒤 같은 메뉴에서 Connectivity Test를 다시 실행합니다. Settings에서 Test Method를 확인하고 현재 테스트 방식을 기록하세요. 서로 다른 방식의 결과는 직접 비교할 수 없습니다. 테스트는 성공했지만 일부 도메인에서만 실패한다면 Diagnostics에서 도메인 해석 오류와 정책 적용 오류를 먼저 구분합니다. 해석 오류가 발생하면 현재 구성의 DNS 설정을 확인합니다. 요청에 예상하지 않은 정책이 적용되면 Config로 돌아가 Rule과 FINAL을 확인하고 DNS와 규칙을 동시에 변경하지 마세요.

한 번에 한 항목만 변경하고 같은 대상으로 다시 테스트하세요. 원인을 찾지 못했다면 FAQ에서 해당 증상을 확인할 수 있습니다. 문제 해결 기록을 남길 때는 기기 유형, 연결 방식, 모드 및 오류 안내만 기록하고 서버 주소, 인증 정보, 구독 링크와 QR 코드는 먼저 가리세요.

Shadowrocket Settings 화면에 표시된 Test Method, On Demand, Diagnostics, Proxy, TCP 및 UDP
Settings의 Test Method, On Demand 및 Diagnostics에서 각각 테스트, 자동 연결 및 진단 정보를 확인합니다.