Shadowrocket 공식 매뉴얼

Shadowrocket 사용법

서버 추가, Global Routing 선택, 연결 및 확인 방법을 안내합니다. 다시 확인할 수 있는 순서에 따라 첫 사용을 진행합니다.

이 페이지에서는 첫 사용에 필요한 경로만 설명합니다. 스크린샷은 화면 위치를 확인하기 위한 것으로, 기기별 항목 배열은 시스템과 앱 화면에 따라 달라질 수 있으므로 실제 표시를 기준으로 하세요. 각 설정의 자세한 의미는 Settings 설정 상세 설명에서 확인할 수 있습니다.

01 / ADD SERVER · SUBSCRIBE

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

먼저 Shadowrocket의 Home을 열고 SERVER 그룹에서 Add Server를 찾습니다. 사용할 경로는 보유한 정보의 형태에 따라 다릅니다. 주소, 포트, 인증 정보가 있으면 수동으로 추가하고, 서버 목록을 가져올 수 있는 완전한 구독 링크가 있으면 Subscribe를 사용합니다. 두 방법을 동시에 진행할 필요는 없습니다. 구독 링크를 단일 서버의 Host 항목에 입력하지 마세요.

Add Server에서 수동으로 입력하기

Add Server에 들어가면 먼저 Type을 열고 본인의 서버 정보에 맞는 프로토콜을 선택한 다음 필요한 항목을 입력합니다. Type에 따라 입력 항목이 달라지므로 스크린샷에 맞춰 먼저 입력한 후 프로토콜을 변경하지 마세요. 그림의 Host, Port, Password, Method는 위치를 확인하기 위한 예시이며 모든 프로토콜이 같은 항목을 사용하는 것은 아닙니다. 정보에 다른 인증 또는 전송 매개변수가 있다면 해당 Type에서 실제로 표시되는 항목을 기준으로 입력하세요.

Host에는 서버 주소를 입력하고 브라우저 주소의 경로는 덧붙이지 마세요. Port에는 안내받은 포트를 입력합니다. Password, Method 등은 각 항목을 주의해서 확인하세요. 특히 복사한 값에 공백이나 줄바꿈이 포함되지 않았는지, 대소문자가 맞는지 확인합니다. 정보에 TLS, Server Name 또는 전송 설정이 있다면 해당 옵션을 펼쳐 점검해야 합니다. 주소와 포트가 같다고 설정이 완전한 것은 아닙니다. 암호화 방식을 임의로 추측하거나 인증 정보를 생략하지 마세요.

입력한 뒤 화면의 저장 기능을 사용하고 Home으로 돌아가 SERVER 그룹을 확인합니다. 항목이 보인다는 것은 정보가 저장되었다는 뜻일 뿐, 서버 연결이 가능하다는 뜻은 아닙니다. 먼저 예상한 이름과 주소가 맞는지 확인한 뒤 해당 항목을 선택해 다음 테스트 대상을 명확히 지정합니다.

Subscribe로 링크 가져오기

구독 링크가 있다면 Add Server의 Type에서 Subscribe를 선택하고 화면 안내에 따라 전체 링크를 입력한 뒤 저장합니다. 목록을 가져올 때까지 기다리세요. 여기에는 본인의 구독 주소가 필요하며 서비스 계정 로그인 페이지 주소를 입력하는 것이 아닙니다. 붙여넣은 뒤 링크의 앞뒤에 안내 문구, 따옴표 또는 채팅 메시지의 줄바꿈이 섞이지 않았는지 확인하세요. 구독 주소에는 접근 자격 정보가 포함될 수 있으므로 전체 내용을 공개 게시물이나 스크린샷에 올리지 마세요.

Home으로 돌아와 구독 그룹에 예상한 서버 항목이 나타나는지 확인합니다. 그룹 이름만 있고 항목이 없다면 새로 고침이 완료되었는지 확인한 다음 링크가 유효한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 점검하세요. 같은 그룹을 반복해서 새로 만드는 것은 가져오기 실패를 해결하는 방법이 아닙니다. Subscribe는 서버 정보를 업데이트하며, 규칙 파일도 가져왔다는 뜻은 아닙니다.

QR 코드가 있다면 Scan QR Code를 사용하고 저장 전에 인식된 유형과 항목을 확인하세요. Import from Cloud JSON은 해당 형식의 데이터를 위한 기능이며 임의의 웹 링크를 가져오는 범용 메뉴가 아닙니다. 추가 방법 중 하나를 마쳤다면 다른 가져오기 메뉴를 모두 시도하지 말고 다음 단계에서 트래픽 처리 방식을 선택하세요.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method와 Scan QR Code 및 Import from Cloud JSON 메뉴가 표시됩니다
Add Server 확인: 먼저 Type을 선택한 뒤 해당 항목을 입력합니다. 스크린샷의 항목 구성은 모든 프로토콜에 적용되지 않습니다.
02 / GLOBAL ROUTING · CONFIG

Global Routing 방식 선택

서버가 Home에 표시되면 Global Routing을 열어 이번에 트래픽을 처리할 방식을 선택합니다. 여기에는 세 가지 방식인 설정(Config), 프록시(Proxy), 직접 연결(Direct)이 있습니다. 서버 선택과 방식 선택은 서로 다른 작업입니다. 서버 선택은 프록시 대상을 정하고, 방식 선택은 요청의 목적지를 결정하는 방법에 영향을 줍니다. 문제를 점검하기 전에 현재 선택을 기억하세요. 모드를 한 번 바꾸는 것만으로도 테스트 조건이 달라질 수 있습니다.

설정(Config): 현재 규칙에 따라 처리

일상적으로 규칙에 따라 트래픽을 분할할 때는 설정(Config)을 사용합니다. Config에 들어가 현재 사용하는 설정 파일을 확인한 다음 Rule을 살펴봅니다. 규칙은 매칭 조건과 그에 따른 처리 방식을 정합니다. 예를 들어 특정 도메인을 PROXY로 보낼지 DIRECT로 보낼지 결정합니다. 구독 목록에 서버가 있다고 해서 본인의 용도에 맞는 규칙이 있거나 방금 가져온 파일이 현재 설정으로 선택되었다는 뜻은 아닙니다.

오른쪽 공식 스크린샷은 설정 편집 화면을 보여줍니다. General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 서로 다른 내용을 구성하고 Add Rule은 규칙 추가에 사용합니다. 처음 사용할 때 각 영역을 모두 수정할 필요는 없으며 연결을 위해 모든 기능을 켤 필요도 없습니다. 먼저 설정 파일과 Rule의 위치를 확인하세요. 편집하려면 기존에 사용하던 설정을 덮어쓰지 않도록 원본을 저장해 두세요.

아래 한 줄은 규칙 구조를 이해하기 위한 예시이며 기존 파일을 그대로 대체할 수 있는 완전한 설정이 아닙니다. example.com과 하위 도메인을 접미사로 매칭해 PROXY로 처리한다는 의미입니다. PROXY 사용 가능 여부는 선택한 서버와 해당 설정에 따라 달라집니다.

DOMAIN-SUFFIX,example.com,PROXY

프록시(Proxy)와 직접 연결(Direct): 명확한 비교에 사용

프록시(Proxy)는 전체 처리 방향을 선택한 프록시 경로로 전환하므로 첫 연결 시 “선택한 서버가 실제 요청을 처리할 수 있는가”를 확인할 때 적합합니다. 모든 요청이 성공한다는 뜻은 아니며 서버 정보 오류를 해결하지도 않습니다. 비교를 위해 잠시 사용한다면 원래 방식을 기록하고 테스트 후 복원하세요. 특정 사이트를 열기 위해 이해하지 못한 선택을 계속 유지하지 마세요.

직접 연결(Direct)은 요청을 직접 연결 경로로 처리해 기기의 로컬 네트워크와 프록시 경로를 비교할 때 사용할 수 있습니다. Direct로 특정 페이지에 접속할 수 있어도 현재 로컬 네트워크에서 해당 페이지에 도달할 수 있다는 의미일 뿐, 프록시가 작동한다는 뜻은 아닙니다. 반대로 프록시 테스트가 정상이어도 모든 규칙이 올바른 것은 아닙니다. 규칙 우선순위, 기본 처리 방식, DNS 연동은 설정 상세 설명을 참고하세요. 이번에는 하나의 방식을 선택한 뒤 Home으로 돌아가 연결하면 됩니다.

Shadowrocket의 Config 설정 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 영역과 Add Rule이 포함되어 있습니다
Config 편집 화면에서는 설정 내용을 확인할 수 있습니다. Global Routing 방식 선택 메뉴는 Home에 있습니다.
03 / HOME · CONNECTION

Home으로 돌아가 연결 스위치 켜기

Home으로 돌아와 연결 전에 다음을 확인합니다. SERVER에서 테스트할 서버가 선택되어 있는지, Global Routing이 이전 단계에서 선택한 방식과 일치하는지, 현재 Wi-Fi 또는 셀룰러 네트워크를 사용할 수 있는지 확인하세요. 기기에서 다른 VPN 연결이 실행 중이라면 시스템 설정에서 상태를 먼저 살펴보세요. 두 연결 간 전환을 Shadowrocket 서버 오류로 잘못 판단하지 않도록 주의합니다.

확인한 후 Home 상단의 스위치를 켭니다. 처음 연결할 때 iPhone / iPad에 VPN 구성 추가를 위한 시스템 권한 안내가 표시될 수 있습니다. 방금 Shadowrocket에서 직접 시작한 요청인지 확인한 다음 시스템 안내에 따라 승인하고 필요한 경우 기기 인증을 완료합니다. 이 단계는 기기에 네트워크 확장에 필요한 구성을 설정하는 것이며 서버 Password를 입력하는 것이 아닙니다. 두 종류의 자격 정보를 혼동하지 마세요.

권한을 승인한 뒤 앱으로 돌아와 상단 상태가 Not Connected에서 바뀌었는지, 연결 스위치가 켜진 상태로 유지되는지 확인합니다. 시스템마다 VPN 상태가 표시되는 위치가 다를 수 있으므로 Home의 상태와 실제 접속 결과를 함께 확인하세요. 특정 위치의 아이콘만 찾지 마세요. 권한 승인 후 연결이 시작되지 않았다면 스위치 상태를 확인하고 한 번 조작하면 됩니다.

스위치를 켠 직후 다시 꺼지면 현재 화면에서 오류 메시지를 확인한 다음 시스템 VPN 권한과 선택한 설정을 점검합니다. 빠르게 반복해서 스위치를 전환하면 로그에 여러 연결 과정이 섞여 최초 실패 원인을 판단하기 어려워집니다. 이때 DNS를 급히 변경하거나 서버를 모두 다시 추가하지 마세요. 먼저 “켜자마자 종료”라는 현상을 기록하고 마지막 단계의 해당 점검 방법을 따르세요.

연결 스위치가 안정적으로 켜져 있어도 설정이 모두 완료된 것은 아닙니다. 이는 주로 기기의 연결 과정이 실행 중이라는 뜻입니다. 서버를 사용할 수 있는지, 도메인이 해석되는지, 규칙이 적용되는지는 다음 단계에서 각각 확인해야 합니다. 이어지는 Connectivity Test와 실제 접속이 동일한 조건에서 이루어지도록 서버, 네트워크, 방식을 그대로 유지하세요.

Shadowrocket의 Home 화면. 상단에 Not Connected 스위치가 있고 아래에 Global Routing, Connectivity Test, SERVER 그룹 및 Add Server가 표시됩니다
Home에서 연결 전 서버, Global Routing, 상단 스위치를 함께 확인합니다.
04 / CONNECTIVITY TEST · DATA

테스트 결과와 실제 요청을 각각 확인

연결한 뒤 먼저 Home에서 Connectivity Test를 실행하고 현재 테스트가 끝날 때까지 기다립니다. 결과는 사용한 테스트 방식에 따라 해석해야 합니다. 응답이 확인되면 해당 테스트 대상과 경로에서 응답이 있었다는 뜻이지만 모든 웹사이트, 프로토콜, 앱을 사용할 수 있다는 뜻은 아닙니다. timeout이 표시되어도 바로 서버를 삭제하지 마세요. 테스트 대상, 특정 트래픽을 처리하는 네트워크 방식, 테스트 방식 자체가 결과에 영향을 줄 수 있습니다.

그다음 브라우저를 열어 익숙하고 접속이 허용된 페이지를 다시 방문합니다. 캐시된 콘텐츠를 방금 완료한 네트워크 접속으로 오인하지 않도록 새 페이지를 열거나 다시 로드하세요. 페이지의 이미지, 텍스트, 추가 로딩 콘텐츠가 모두 정상적으로 표시되는지 확인합니다. 페이지 제목만 나타난 것으로 전체 요청 경로가 정상이라고 판단하기는 어렵습니다. 확인 도중 구독 새로 고침, 서버 전환, 설정 변경을 동시에 하지 마세요. 결과를 특정 변경 사항과 연결하기 어려워집니다.

라우팅을 확인해야 한다면 Data 또는 현재 화면에 표시되는 연결 기록을 확인해 이번 요청의 대상과 처리 방향을 살펴봅니다. 카운터가 증가해도 트래픽이 예상한 PROXY를 거쳤다는 것을 단독으로 증명하지는 않습니다. 기록에서 해당 규칙과 정책을 확인할 수 있다면 대상 도메인, 매칭 조건, 최종 처리 방식을 함께 살펴보세요. 관련 기록이 없다면 먼저 브라우저에서 새 요청을 실제로 보냈는지 확인합니다.

관찰된 현상다음 점검 항목
스위치가 켜진 상태로 유지되고 페이지가 정상적으로 로드됨Global Routing이 실제 용도에 맞는지 확인한 뒤 일상적으로 사용하는 앱을 테스트합니다.
Connectivity Test는 응답하지만 페이지가 열리지 않음도메인 해석, 규칙 경로, 브라우저 오류를 확인하고 가져오기를 반복하지 않습니다.
Config에서만 실패함현재 설정 파일과 Rule을 비교해 요청이 다른 경로로 전달되지 않는지 확인합니다.
로컬 네트워크를 전환한 뒤 결과가 달라짐Wi-Fi와 셀룰러 네트워크의 차이를 기록한 뒤 프로토콜에 필요한 전송 경로에 도달할 수 있는지 확인합니다.

비교 테스트에서는 한 번에 조건 하나만 변경합니다. 예를 들어 서버를 고정한 상태에서 설정(Config)과 프록시(Proxy)를 비교합니다. Config에서만 실패한다면 Password를 다시 입력하기보다 규칙을 먼저 살펴보세요. 또는 방식을 고정하고 Wi-Fi와 셀룰러 네트워크를 비교합니다. 한쪽 네트워크에서만 실패하면 네트워크 차이를 먼저 기록합니다. 테스트가 끝나면 일상적으로 사용할 방식으로 복구하고 다시 접속해 확인하세요. 문제 해결을 위한 임시 상태가 장기 설정으로 남지 않도록 합니다.

05 / SETTINGS · DIAGNOSTICS

실패 현상에 따라 설정 점검

확인에 실패했다면 먼저 문제를 분류합니다. 정보를 가져오지 못했는지, 서버 테스트가 시간 초과되었는지, 스위치는 켜졌지만 웹 페이지가 열리지 않는지, 아니면 일정 시간 후 연결이 끊기는지 확인하세요. 현상에 따라 점검을 시작할 위치가 다릅니다. 모든 옵션을 한꺼번에 초기화하기보다 현재 표시된 오류와 방금 진행한 작업을 기록하는 편이 원인 파악에 도움이 됩니다. 모든 실패를 DNS 탓으로 돌리지 마세요.

가져오기에 실패한 경우: 원본 정보부터 확인

수동으로 추가한 뒤 예상한 항목이 없다면 Add Server로 돌아가 저장했는지, Type이 올바른지, 필수 항목을 모두 입력했는지 확인합니다. Subscribe에서 서버 목록을 가져오지 못하면 완전한 구독 주소를 붙여넣었는지, 현재 네트워크에서 접속할 수 있는지 확인하세요. 구독이 유효한지는 본인의 서비스 정보나 서비스 제공자의 안내를 통해 확인합니다. 링크에는 서비스에 접근할 수 있는 인증 정보가 포함될 수 있으므로 공개 페이지에 올려 대신 테스트해 달라고 요청하지 마세요.

테스트 시간 초과: 매개변수와 시간부터 확인

서버에서 계속 timeout이 발생하면 Host, Port, Type, 인증 항목, 전송 매개변수 순서로 하나씩 확인합니다. TLS를 사용한다면 Server Name 등의 항목이 원본 정보와 일치하는지 살펴보고 기기의 시스템 시간이 정확한지도 확인하세요. 시간 차이는 인증서 확인에 영향을 줄 수 있지만 시간을 수정했다고 다른 오류까지 모두 해결되는 것은 아닙니다. 일부 전송 방식은 UDP에 의존하며 네트워크 환경에 따라 테스트 결과가 달라질 수 있습니다. 검증을 임의로 꺼서 매개변수 문제를 덮으려 하지 마세요.

Settings의 Test Method는 테스트 방식과 관련이 있습니다. 현재 방식을 확인한 뒤 테스트 결과를 해석하세요. 목록에 숫자를 표시하려고 Test Method를 계속 전환하지 마세요. 서버 자체와 테스트 대상의 접속 가능 여부가 다르면 테스트 결과와 웹 페이지 사용 경험이 일치하지 않을 수 있습니다. 이 경우 실제 요청과 오류 기록을 확인해 판단을 이어갑니다.

스위치는 켜졌지만 웹 페이지가 실패하는 경우: DNS와 규칙 분리 확인

먼저 Home으로 돌아가 Global Routing을 확인한 다음 Config의 현재 파일을 점검합니다. 프록시(Proxy)는 접속되지만 설정(Config)은 안 된다면 규칙 경로를 우선 확인하세요. 두 방식 모두 실패하지만 테스트에는 응답이 있다면 DNS 해석 관련 기록과 브라우저 오류를 살펴봅니다. DNS를 변경하기 전에 원래 값을 기록하고 한 번에 하나만 변경한 뒤 다시 테스트해 유지할지 결정하세요. 인터넷에서 찾은 주소 한 세트를 모든 DNS 항목에 함께 입력하지 마세요.

자동 연결 또는 연결 해제: On Demand와 시스템 상태 확인

수동으로 연결을 끈 뒤 다시 연결되거나 네트워크 전환 후 상태가 달라지는 경우 Settings에서 On Demand를 열어 네트워크 조건에 따라 연결이 실행되는지 확인합니다. 현재 조건을 이해한 다음 비교를 위해 잠시 비활성화할지 결정하세요. 첫 연결을 위해 On Demand를 미리 켤 필요는 없습니다. 시스템 VPN 상태도 살펴보고 다른 연결 관리 설정이 전환에 관여하지 않는지 확인합니다.

추가로 원인을 확인하려면 Settings의 Diagnostics를 사용해 한 번의 실패 작업에 필요한 정보를 수집합니다. 기록을 공유하기 전에 구독 주소, 서버 인증 항목 및 기타 개인 정보를 삭제하고 오류 유형과 재현 절차만 남기세요. Today Widget, Proxy, TCP, UDP 등은 각각 용도가 있으므로 모두 조정해 일괄적으로 문제를 해결하려 하지 마세요. 자세한 의미는 Settings 설정 상세 설명을 확인하고, 구체적인 문제는 문제 해결에서 찾아보세요.

Shadowrocket의 Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 설정 메뉴가 표시됩니다
Settings에서는 증상에 따라 설정을 확인합니다. 첫 사용 시 항목을 모두 변경할 필요는 없으며 여러 네트워크 옵션을 한꺼번에 바꾸지 마세요.

이 페이지를 마치면 세 가지를 설명할 수 있어야 합니다. Home에서 어떤 서버를 선택했는지, Global Routing에서 어떤 방식을 사용하는지, 실제 페이지가 예상한 경로로 로드되는지 확인하세요. 이후 규칙을 추가하거나 설정을 조정할 때 현재 작동 상태를 비교 기준으로 유지합니다.