공식 매뉴얼 · 첫 연결

Shadowrocket 사용법

먼저 기존 연결 정보를 Home에 추가한 다음, 요청을 규칙에 따라 처리할지, 모두 프록시로 보낼지, 직접 접속할지 선택합니다. 스위치를 켠 후 서버 테스트와 실제 접속을 각각 확인하세요. 스위치 상태만으로 연결을 검증했다고 판단해서는 안 됩니다.

시작하기 전에: Shadowrocket이 설치되어 있고 본인의 구독 링크 또는 서버 정보가 있는지 확인하세요. iPhone / iPad 버전은 App Store 제품 페이지에서 받을 수 있으며, $2.99 일회성 결제입니다. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. Mac / Windows / Android / Linux 버전은 무료이며 앱 다운로드 페이지에서 설치할 수 있습니다. 이 가이드는 iPhone / iPad 인터페이스를 기준으로 설명합니다.

앱의 일회성 구매는 회선 요금제와 다릅니다. 이 사이트는 노드와 구독을 제공하거나 판매 또는 추천하지 않습니다. 구독 링크에는 접속 정보가 포함될 수 있으므로 앱에만 입력하고, 전체 링크를 공개 페이지에 올리거나 문제 해결 기록에 붙여 넣지 마세요.

01 / 가져오기

Add Server 또는 Subscribe: 기존 연결 정보 가져오기

Shadowrocket을 열고 하단의 Home으로 이동한 다음 오른쪽 위의 더하기 버튼을 눌러 Add Server로 들어갑니다. 서버 매개변수만 있는 경우 단일 서버로 추가하고, 서버 목록을 동기화하는 구독 링크를 받은 경우 Subscribe를 사용합니다. 두 방법 중 하나만 선택하면 됩니다. 같은 연결 정보를 가져오려고 두 방법을 모두 사용할 필요는 없습니다.

Add Server에서 단일 서버 입력하기

먼저 기존 매개변수와 일치하는 프로토콜을 선택한 다음 서버 주소, 포트 및 해당 프로토콜에서 요구하는 인증 정보를 입력합니다. 프로토콜마다 표시되는 항목이 다르므로 한 프로토콜의 인증 정보를 다른 프로토콜에 그대로 입력하면 안 됩니다. 매개변수에 전송 방식이나 TLS 설정이 따로 지정되어 있다면 원본 정보와 일치시켜야 합니다. 주소와 포트를 따로 입력할 때 두 값을 콜론과 함께 주소 항목에 붙여 넣지 마세요. 저장하기 전에 복사 과정에서 공백, 줄바꿈 또는 따옴표가 추가되지 않았는지 확인하세요.

저장한 다음 Home으로 돌아와 SERVER 목록에서 추가한 항목을 찾습니다. 이름이 비슷한 기존 항목이 있으면 먼저 내용을 확인해 주소와 프로토콜이 이번에 추가한 정보와 일치하는지 확인한 뒤 선택하세요. 항목이 표시된다는 것은 정보가 저장되었다는 뜻일 뿐, 원격 서버에 연결할 수 있는지 확인된 것은 아닙니다.

Subscribe에서 기존 구독 가져오기

Add Server의 유형 선택 메뉴에서 Subscribe를 선택하고, 전체 구독 링크를 링크 입력란에 붙여 넣은 뒤 저장합니다. 링크에 쿼리 매개변수가 포함되어 있으면 그대로 유지하세요. 도메인만 복사하거나 단일 서버 항목에 서버 주소로 입력하지 마세요. Home으로 돌아가 가져오기가 끝날 때까지 기다린 다음 구독 아래에 선택할 서버 항목이 나타났는지 확인합니다. 구독 이름이 추가되었는지만 확인해서는 안 됩니다. 같은 구독이 이미 있으면 같은 이름의 항목을 다시 만들 필요 없이 기존 항목을 먼저 새로고침하세요.

어떤 방법을 사용하든 다음 단계로 진행하기 전에 Home에서 테스트할 서버를 선택해야 합니다. 이후 Global Routing을 바꾸거나 접속을 확인할 때 이 선택을 유지하면 테스트 결과가 달라졌을 때 모드가 바뀐 것인지 서버 자체에 문제가 있는지 쉽게 판단할 수 있습니다.

02 / 라우팅

Global Routing: 트래픽 처리 방식 선택

Home에서 Global Routing을 누르고 현재 확인하려는 목적에 맞는 모드를 선택합니다. 여기서는 요청의 처리 방식만 정하며, 방금 저장한 서버 매개변수는 바뀌지 않습니다. 프록시 경로를 처음 확인할 때는 규칙에 따른 조건을 줄이기 위해 Proxy를 임시로 사용할 수 있습니다. 평소에 요청별로 각기 다른 정책을 적용하려면 Config를 사용하세요. Direct는 비교용으로 쓸 수 있지만 프록시 서버가 작동한다는 근거는 되지 않습니다.

Config
현재 구성의 규칙에 따라 요청을 처리합니다. 먼저 하단의 Config로 이동해 목록에 파일이 있는지만 확인하지 말고 실제 사용할 구성이 활성화되어 있는지 확인하세요. 특정 도메인을 테스트할 때는 먼저 일치할 수 있는 규칙을 앞에서부터 확인합니다. 해당 규칙이 없다면 기본 정책을 지정하는 FINAL을 확인하세요.
Proxy
클라이언트가 처리하는 요청을 프록시로 보내며 현재 구성에 따라 요청별로 일상적인 라우팅을 하지 않습니다. 선택한 서버로 실제 접속이 가능한지 확인할 때 적합합니다. 테스트에 성공한 뒤 Config로 되돌리면 두 모드의 요청 경로가 다를 수 있으므로 대표 페이지를 다시 테스트하세요.
Direct
선택한 프록시 서버를 거치지 않고 목적지 주소에 직접 접속합니다. 페이지가 열리지 않을 때 현재 Wi‑Fi 또는 셀룰러 네트워크의 기본 접속 상태를 확인하는 데 사용할 수 있습니다. Direct 접속에 성공해도 이번 요청이 직접 접속되었다는 뜻일 뿐, 라우팅 규칙이 올바르다는 뜻은 아닙니다.

선택한 후 Home으로 돌아와 Global Routing 항목의 현재 값을 확인하세요. 하단의 Config는 구성 파일을 관리하는 메뉴이고, Global Routing의 Config는 규칙에 따라 트래픽을 처리하는 모드입니다. 구성 파일 목록을 열기만 해서는 트래픽 처리 방식이 바뀌지 않습니다.

03 / 연결

Home: 연결 스위치 켜기

Home에서 현재 서버와 Global Routing을 확인한 다음 연결 스위치를 켭니다. 처음 켤 때 시스템에서 VPN 구성 추가 요청이 표시될 수 있습니다. 이는 Shadowrocket이 선택한 방식으로 기기 트래픽을 처리하기 위한 것입니다. 방금 수행한 작업으로 요청이 표시되었는지 확인하고 시스템 팝업에서 ‘허용’을 누른 다음 안내에 따라 기기 인증을 완료하세요. 이미 권한을 승인했다면 팝업이 다시 표시되지 않을 수 있습니다.

완료되면 Home으로 돌아와 잠시 기다린 후에도 스위치가 켜진 상태로 유지되는지 확인합니다. 스위치가 바로 꺼지면 반복해서 누르거나 구독을 즉시 삭제하지 마세요. 확인하지 않은 시스템 팝업이 있는지, 또는 기기에서 다른 VPN 연결이 실행 중인지 확인하세요. 회사나 학교에서 관리하는 기기라면 네트워크 구성을 변경할 수 있는지 먼저 확인하고, 관리 프로파일을 임의로 제거하지 마세요. 스위치가 계속 꺼지면 흔한 실패 지점에서 권한과 연결 상태를 확인하세요.

스위치가 켜진 상태로 유지되면 시스템 연결이 설정된 것입니다. 하지만 서버가 응답한다거나 모든 웹사이트에 접속할 수 있다거나 모든 규칙이 예상한 정책과 일치한다는 뜻은 아닙니다. 현재 네트워크, 서버 및 모드를 그대로 둔 채 다음 단계에서 확인하세요. 이전에 On Demand를 설정했다면 네트워크를 바꿀 때 자동 재연결되는지 살펴보세요. 서로 다른 조건에서 나온 결과를 같은 테스트 결과로 혼동할 수 있습니다.

04 / 확인

Connectivity Test: 서버 및 실제 접속 확인

먼저 Home에서 Connectivity Test를 찾아 실행하고 결과가 갱신될 때까지 기다린 뒤, 방금 선택한 서버의 테스트 결과가 표시되는지 확인합니다. 응답 시간은 해당 시점의 테스트 조건만 나타내며 실제 접속 속도와 같지 않습니다. 한 번의 시간 초과만으로 서버를 장기간 사용할 수 없다고 판단해서는 안 됩니다. 응답 여부 또는 시간 초과 여부만 기록하고 서버 주소, 인증 항목 또는 구독 링크를 공유하지 마세요.

다음으로 브라우저를 열고 이전에 접속할 수 있었던 페이지를 새로고침합니다. 이미 열려 있는 탭만 확인하지 마세요. 탭에 연결하기 전에 불러온 내용이 계속 표시될 수 있습니다. 테스트 전후로 같은 네트워크와 같은 주소를 사용하세요. Proxy로 테스트하고 페이지가 정상적으로 새로고침되면 이번 실제 접속은 성공한 것입니다. Connectivity Test에 응답이 있지만 페이지가 로드되지 않으면 두 결과를 모순으로 보지 말고 대상 사이트, 도메인 확인 또는 현재 요청 경로를 따로 점검하세요.

Config에서 라우팅을 확인하려면 구성에 따라 DIRECT로 연결될 것으로 예상되는 도메인 하나와 프록시 정책을 사용할 것으로 예상되는 도메인 하나를 골라 각각 새로고침합니다. 클라이언트 진단 기록을 확인할 수 있다면 도메인과 요청 시간을 기준으로 실제 적용된 정책을 확인하세요. 페이지가 열린다는 사실만으로 지정한 규칙이 적용되었다고 단정할 수 없습니다. 웹페이지가 다른 도메인에도 요청을 보낼 수 있으므로 주소 표시줄의 기본 도메인만 보지 말고 개별 요청을 확인해야 합니다.

완료 기준:연결 스위치가 켜진 상태로 유지되고, 선택한 서버가 테스트 조건에서 응답하며, 실제 페이지를 새로고침할 수 있어야 합니다. 라우팅 확인이 목적이라면 대표 요청에 예상한 정책이 적용되는지도 확인합니다. 비교가 끝나면 Global Routing을 평소 사용할 모드로 되돌리고 테스트 페이지에 다시 접속하세요.

05 / 문제 해결

흔한 실패 지점: 가장 먼저 실패한 단계 찾기

문제가 처음 나타난 위치가 어디인지 확인하세요. 목록에 항목이 없거나, 스위치가 켜진 상태로 유지되지 않거나, Connectivity Test가 시간 초과되거나, 특정 페이지만 로드되지 않을 수 있습니다. 가장 먼저 실패한 지점부터 해결하고 네트워크, 서버, 구성을 한꺼번에 바꾸지 마세요. 한 항목을 바꿀 때마다 같은 테스트를 반복하세요. 그렇지 않으면 접속이 복구되더라도 어떤 변경이 효과가 있었는지 알기 어렵습니다.

구독은 저장했지만 선택할 서버가 표시되지 않음

Home으로 돌아와 구독 정보를 가져와 펼쳤는지 확인하고 기존 구독을 한 번 업데이트합니다. 항목이 없다면 기기가 현재 네트워크에 연결되어 있는지, 링크가 빠짐없이 복사되었는지, 만료되지 않았는지, Subscribe에 사용하는 링크가 맞는지 확인하세요. 단일 서버를 저장한 뒤 찾을 수 없다면 같은 매개변수를 Subscribe에 다시 붙여 넣지 말고 Add Server로 돌아가 필수 항목을 확인하세요. 수정한 후 SERVER 목록에 선택 가능한 항목이 있는지 확인하고 트래픽 처리 방식 단계로 돌아가세요.

스위치가 꺼지거나 예상한 권한 요청이 표시되지 않음

먼저 시스템 팝업에서 거부를 눌렀는지 또는 다른 VPN이 연결되어 있는지 확인하세요. 기기의 ‘설정 → 일반 → VPN 및 기기 관리’에서 VPN 상태를 확인합니다. 시스템 메뉴는 버전에 따라 조금 다를 수 있으므로 설정에서 VPN을 검색해도 됩니다. 충돌이 없는 것을 확인한 후 Shadowrocket으로 돌아와 다시 켜세요. 관리 대상 기기에서 설정을 변경할 수 없다면 기기 관리자에게 제한 사항을 확인하세요. 시스템 문제를 해결하려고 앱 데이터를 지우지 마세요.

스위치는 켜지지만 서버 테스트가 계속 시간 초과됨

먼저 연결을 끄고 현재 네트워크에서 자주 사용하는 페이지에 정상적으로 접속할 수 있는지 확인합니다. 공용 Wi‑Fi 로그인 절차를 완료하지 않는 등 기본 접속부터 실패한다면 네트워크를 복구한 뒤 다시 테스트하세요. 기본 네트워크가 정상이라면 서버 프로토콜, 주소, 포트 및 관련 설정을 확인합니다. 사용할 수 있는 다른 항목이 있다면 같은 네트워크에서 서버만 바꿔 비교하고 나머지 설정은 그대로 둡니다. 이렇게 하면 문제 범위를 좁힐 수 있지만 한 번의 비교만으로 서버 측 문제라고 단정할 수는 없습니다.

Proxy 테스트는 통과하지만 Config 모드에서 특정 페이지가 실패함

같은 네트워크에서 같은 페이지를 Proxy와 Config로 각각 다시 테스트합니다. Config에서만 문제가 생기면 현재 활성화된 파일을 먼저 확인한 뒤 문제가 발생한 도메인과 더 앞에 있는 규칙이 일치하는지 살펴봅니다. 일치하는 규칙이 없다면 FINAL을 확인하세요. 하나의 페이지가 별도 도메인에서 이미지를 불러오거나 로그인 요청을 보낼 수 있습니다. 본문은 표시되지만 일부 내용이 실패한다면 이러한 요청을 각각 확인하고 기본 도메인에 적용된 정책만 보고 구성 전체를 바꾸지 마세요.

문제 해결 기록에는 실패한 단계, 현재 모드, Wi‑Fi 또는 셀룰러 네트워크 사용 여부, 문제가 재현되는지만 남기면 됩니다. 시스템 버전, 스토어에서 앱이 보이는지 여부 또는 새 기기에서 복원하는 문제는 다운로드 가이드를 확인하세요. 구매 또는 설치 문제를 해결하기 위해 구독을 다시 가져올 필요는 없습니다.