공식 가이드 · 기본 사용법

Shadowrocket 사용법

기존 정보를 가져오고 처리 방식을 선택한 다음 연결 상태를 확인합니다.
먼저 수동 연결을 한 번 완료한 뒤 규칙과 자동 연결 조건을 조정하세요.

권장 순서: 처음 사용하는 경우 1단계부터 진행하세요. 가져오기는 완료했지만 접속되지 않는다면 결과 확인과 오류 점검으로 바로 이동할 수 있습니다. 화면 이미지는 App Store의 공식 스크린샷이며, 표시되는 항목은 선택한 Type과 앱 화면에 따라 달라질 수 있습니다. 실제 기기에 표시되는 화면을 기준으로 확인하세요.

단계 01 · 연결 항목 준비

Add Server: 서버 추가 또는 구독 가져오기

Shadowrocket을 열고 먼저 Home 화면으로 이동합니다. 상단 연결 스위치는 아직 켜지 마세요. 아래의 SERVER 그룹에서 서버 항목을 확인할 수 있습니다. Add Server를 열고 보유한 정보에 따라 진행하세요. 구독 링크 전체가 있다면 Subscribe를 사용하고, 서버 주소와 포트 및 인증 정보가 있다면 해당 프로토콜에 맞춰 직접 입력합니다. 두 방법 중 하나만 선택하면 됩니다. 같은 정보를 중복으로 추가할 필요는 없습니다.

구독 링크가 있는 경우: Subscribe 선택

Add Server에서 Type을 열고 Subscribe를 선택한 다음, 서비스 제공업체에서 받은 구독 링크 전체를 URL 항목에 입력합니다. 복사할 때 링크의 모든 내용이 포함되어야 하며, 안내 문구가 섞이거나 앞뒤에 공백과 줄바꿈이 들어가지 않도록 하세요. 구독 링크에는 개인 인증 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하고 공개 게시판에 올리거나 관계없는 사람에게 보내지 마세요.

확인한 뒤 저장하고 Home으로 돌아가 구독 내용이 불러와질 때까지 기다립니다. 구독 그룹과 서버 항목이 표시되어야 정보가 목록에 추가된 것입니다. 구독 이름만 보이고 항목이 없다면 구독 업데이트가 성공했는지 확인하세요. 구독 내용이 변경된 경우 해당 그룹의 업데이트 기능으로 다시 가져올 수 있습니다. 구체적인 메뉴 위치는 현재 화면을 기준으로 확인하세요. 새로고침에 실패하면 링크 유효성과 기본 네트워크부터 점검하고, 같은 이름의 구독을 반복해서 추가하지 마세요.

서버 설정 정보가 있는 경우: Type 선택 후 항목 입력

서버를 직접 추가할 때는 제공받은 정보에 따라 Type을 먼저 선택합니다. 예를 들어 Shadowsocks, VMess, VLESS, Trojan 등을 선택한 뒤 해당 유형에 표시되는 항목을 입력하세요. Host에는 서버 도메인이나 주소를, Port에는 해당 포트를 입력합니다. Password, Method 또는 기타 인증·전송 설정이 필요하면 제공된 정보와 동일하게 각 항목을 입력하세요. 스크린샷에 특정 항목이 보인다고 해서 모든 프로토콜에 그 항목이 필요한 것은 아닙니다.

Host에는 일반적으로 웹페이지 주소를 입력하지 않습니다. 경로가 포함된 구독 링크 전체를 붙여 넣어서도 안 됩니다. 포트 번호를 임의로 추측하지 마세요. TLS, 서버 이름, 전송 경로와 같은 추가 설정은 보유한 정보와 일치해야 합니다. 설정값을 모르면 서비스 제공업체에 확인하고, 연결을 시도하려고 검증 기능을 임의로 끄지 마세요. 본인 소유의 QR 코드가 있다면 Scan QR Code로 입력할 수 있습니다. 입력 후에도 Type과 주요 설정값을 확인하세요. Import from Cloud JSON은 해당 형식의 데이터에만 사용하는 기능이며 모든 링크를 가져오는 공통 메뉴가 아닙니다.

저장한 뒤 Home으로 돌아와 SERVER 그룹에서 사용할 서버를 선택하고, 선택 표시가 해당 항목 옆에 있는지 확인합니다. 이름은 항목을 구분하기 위한 것이며 프로토콜이나 서비스 상태를 뜻하지 않습니다. 처음 테스트할 때는 한 항목을 고정해 사용하고 여러 조건을 동시에 바꾸지 마세요. 다음 단계에서 트래픽 처리 방식을 선택합니다.

Shadowrocket 공식 Add Server 화면: Type, Host, Port, Password, Method 및 하단의 가져오기 메뉴 표시
Add Server: 먼저 Type을 선택한 뒤 해당 유형에 필요한 항목을 확인하세요. 스크린샷은 여러 조합 중 하나를 보여줍니다.
단계 02 · 트래픽 처리 방식 선택

Global Routing: Config, Proxy 또는 Direct 선택

서버 항목은 연결할 대상을 정하고, Global Routing은 트래픽 처리 방식을 정합니다. Home으로 돌아가 Global Routing을 열고 목적에 따라 Config, Proxy 또는 Direct를 선택하세요. 이 세 가지는 서로 다른 서버가 아니며 구독 내용도 변경하지 않습니다. 선택하기 전에 서버 연결을 확인하려는 것인지, 규칙을 적용해 평소처럼 사용하려는 것인지 먼저 정하세요.

Config: 현재 구성의 규칙에 따라 처리

Config는 현재 선택된 구성의 규칙에 따라 트래픽 처리 방식을 정합니다. 도메인, 주소 또는 기타 조건에 따라 트래픽을 분리하려면 이 모드를 사용하되, 실제 활성화된 구성을 먼저 확인해야 합니다. 하단의 Config 페이지를 열어 현재 선택된 구성을 찾아 내용을 확인하세요. 기존 구성의 출처나 규칙을 모른다면 파일 이름만 보고 사용하지 말고, 먼저 내용을 확인하세요.

오른쪽 스크린샷은 Config의 구성 편집 화면이며 Global Routing 선택 메뉴가 아닙니다. General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 서로 다른 구성 항목이고 Add Rule은 규칙을 추가하는 기능입니다. 입문 단계에서는 이 항목들을 수정할 필요가 없으며, 일반적인 연결을 위해 HTTPS Decryption을 켜거나 인증서를 설치할 필요도 없습니다.

구독과 구성은 서로 다른 기능입니다. 서버 구독은 주로 연결 항목을 가져오는 데 사용하고, 구성은 규칙과 관련 설정을 정의합니다. 구독 링크를 규칙 파일 주소로 사용하지 마세요. 완성된 구성이 있다면 참조하는 정책이 현재 선택한 서버와 맞는지 먼저 확인하세요. 규칙이 존재하지 않는 정책을 지정하면 연결 스위치가 켜져 있어도 일부 요청이 예상대로 처리되지 않을 수 있습니다.

Proxy와 Direct: 용도를 정해 비교할 때 사용

Proxy는 클라이언트가 처리하는 트래픽을 선택한 프록시 서버로 보냅니다. 점검 중 규칙 분기로 인한 변수를 잠시 줄이는 데 사용할 수 있지만, 모든 대상에 정상 접속할 수 있다는 뜻은 아닙니다. Direct는 트래픽을 직접 연결 방식으로 처리하므로 현재 기본 네트워크의 결과와 비교할 때 사용할 수 있습니다. Direct를 선택해도 서버 설정 오류가 해결되는 것은 아니며, 프록시 서버가 사용 가능하다는 증거도 되지 않습니다.

처음 규칙을 적용해 사용할 때는 Config를 선택하고 현재 구성을 확인하세요. 규칙 문제와 서버 연결 문제를 구분하려면 원래 선택을 기록한 뒤 Proxy로 잠시 전환해 같은 대상을 테스트하고, 완료 후 원래 설정으로 되돌릴 수 있습니다. 문제가 생길 때마다 서버를 바꾸고 규칙을 수정하며 모드까지 동시에 전환하지 마세요. 규칙 일치 방식은 기능 및 설정에서 자세히 확인할 수 있으며, 자주 묻는 모드 관련 질문은 문제 해결을 참고하세요.

Shadowrocket 공식 Config 편집 화면: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config 편집 화면: 구성 내용을 확인하는 곳입니다. Global Routing 모드 선택은 Home에서 할 수 있습니다.
단계 03 · 수동으로 연결하기

Home: 연결 스위치를 켜고 시스템 권한 승인

항목 추가와 모드 선택을 마쳤다면 Home으로 돌아와 두 가지를 확인하세요. SERVER 그룹에서 테스트할 서버가 선택되어 있는지, Global Routing에 방금 정한 옵션이 표시되는지 확인합니다. 비교를 위해 Direct를 임시 선택했다면 연결 전에 이번 목적에 맞는 모드로 되돌리세요. 먼저 현재 Wi-Fi 또는 셀룰러 네트워크가 정상적으로 작동하는지 확인한 다음 상단 연결 스위치를 켭니다.

처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 이는 iPhone 또는 iPad에서 관련 네트워크 연결을 관리하기 위한 시스템 권한 요청이며 구독 로그인 화면이 아닙니다. 안내에 표시된 앱 이름과 설명을 읽고 Shadowrocket에서 시작한 작업인지 확인한 뒤 기기에서 요구하는 인증 방식으로 승인하세요. 권한을 취소하면 이번 연결은 진행되지 않습니다. 필요하면 앱에서 다시 요청하면 되며, 이미 가져온 서버 항목을 먼저 삭제할 필요는 없습니다.

승인한 뒤 Home으로 돌아와 상단의 기존 Not Connected 상태가 바뀌었는지, 스위치가 계속 켜져 있는지 확인합니다. 스위치가 켜진 것만으로 설정이 완료됐다고 판단하지 마세요. 시스템 연결 성립, 서버 접속 가능 여부, 대상 페이지가 정상적으로 열리는지는 각각 따로 확인해야 합니다. 일부 설정 오류는 실제 요청을 보낼 때만 나타날 수 있으므로 다음 단계의 테스트도 진행하세요.

스위치가 곧바로 꺼지거나 시스템 권한 안내가 반복해서 표시되거나 화면에 오류가 나타나면 전체 안내 문구를 기록한 뒤 연결을 끄고 점검하세요. 기기의 시스템 설정에서 Shadowrocket에 해당하는 VPN 구성이 있는지, 구성 변경을 제한하는 관리 설정이 적용되어 있는지 확인합니다. 시스템 네트워크 설정을 반복해서 삭제하지 마세요. 저장된 다른 연결에 영향을 줄 수 있으며 잘못된 설정값을 확인하는 방법도 아닙니다.

이번에는 수동 연결 상태를 유지하고 On Demand 설정은 서두르지 마세요. 자동 연결 조건은 수동 연결이 안정적으로 작동한 뒤 설정해야 합니다. 그렇지 않으면 조건이 연결을 시작했는지와 서버가 정상적으로 작동하는지를 구분하기 어려워집니다. 연결을 끊으려면 Home으로 돌아가 상단 스위치를 끈 다음 설정을 수정하거나 기본 네트워크와 비교하세요.

Shadowrocket 공식 Home 화면: 상단에 Not Connected 스위치, Global Routing, Connectivity Test가 있고 아래에 SERVER 그룹과 Add Server가 표시됩니다.
Home: 연결 스위치, Global Routing, Connectivity Test가 한 화면에 있습니다. 스크린샷의 Not Connected는 연결되지 않은 상태를 뜻합니다.
단계 04 · 단계별로 확인

Connectivity Test: 테스트 후 실제 접속 확인

연결이 성립하면 Home에서 Connectivity Test를 실행해 먼저 점검합니다. 결과는 현재 테스트 방식과 대상에 따라 달라집니다. 해당 테스트에 응답이 왔는지 확인하는 데 도움이 되지만 모든 앱과 웹사이트가 정상적으로 작동한다는 뜻은 아닙니다. 테스트 방식이 다르면 수치를 직접 비교하기도 어렵습니다. 문제를 점검할 때는 같은 방식과 같은 네트워크 환경을 유지하세요.

그런 다음 실제로 사용하려는 페이지나 앱을 열어 요청이 끝까지 처리되는지 확인합니다. 첫 화면에 캐시된 내용이 표시되는지만 보지 마세요. 페이지를 새로고침하거나 이전에 열지 않았던 페이지를 방문하고 이미지, 로그인, 후속 요청이 정상적으로 작동하는지도 확인할 수 있습니다. 특정 대상에서만 실패한다면 해당 대상과 발생 시간을 먼저 기록하고 전체 연결이 실패했다고 단정하지 마세요.

확인할 때는 다음 세 가지를 구분하세요. 첫째, 시스템 연결이 유지되는가? 둘째, 선택한 서버가 현재 요청에 응답하는가? 셋째, Config의 규칙이 해당 요청을 의도한 정책으로 보내는가? 연결이 유지되는 것은 첫 번째 항목만 확인해 줍니다. Connectivity Test도 보통 특정 테스트 조건만 확인합니다. 특정 요청이 의도한 규칙과 일치하는지 확인하려면 앱에서 제공하는 연결 또는 진단 정보를 함께 살펴보세요. 웹페이지가 열리는지만으로 판단할 수 없습니다.

Config에서 접속이 실패하면 원래 설정을 기록한 뒤 Proxy를 사용해 같은 대상을 한 번 비교해 볼 수 있습니다. Proxy에서는 되지만 Config에서는 안 된다면 구성, 규칙 순서, 정책 참조를 중점적으로 확인하세요. 두 모드 모두 실패한다면 서버 설정값, 서비스 상태, 현재 네트워크를 점검합니다. Direct 결과는 기본 네트워크에서 해당 대상이 어떻게 작동하는지 확인하는 데 쓰며, 이를 근거로 프록시 연결의 보안성이나 완전성을 판단해서는 안 됩니다.

테스트를 통과하면 평소 사용할 모드로 되돌린 뒤 실제 대상에 다시 접속해 확인하세요. Wi-Fi에서 셀룰러 네트워크로 바꾼 경우에도 다시 테스트해야 합니다. 한 번 성공했다고 해서 모든 네트워크 환경에서 같은 결과가 보장되지는 않습니다. 테스트 방식, 규칙 세부 사항, 특정 대상의 오류에 관한 설명은 문제 해결에서 확인할 수 있습니다. 처음 사용할 때 모든 고급 옵션을 수정할 필요는 없습니다.

단계 05 · 증상에 따라 원인 좁히기

Settings: 자주 발생하는 오류 점검

문제가 발생하면 기존 항목과 구성을 유지하고 연결을 끈 다음 아래 순서대로 확인하세요. 한 번 가져오기에 실패했다고 앱 설치 오류인 것은 아니며, 테스트가 한 번 시간 초과됐다고 모든 서버를 사용할 수 없는 것도 아닙니다. 반복해서 재설치하기보다 가져오기, 권한 승인, 연결, 규칙 중 어느 단계에서 문제가 생겼는지 확인하는 편이 효과적입니다.

구독은 저장했지만 SERVER에 사용할 항목이 없음

추가할 때 서버의 Host에 구독 주소를 입력한 것이 아니라 Subscribe를 선택했는지 먼저 확인하세요. 링크 전체가 원본 정보와 일치하는지, 만료되거나 변경되지는 않았는지, 현재 네트워크에서 구독 요청이 처리되는지 점검합니다. 일부 구독은 유효한 서비스 상태여야 내용을 받을 수 있습니다. 이 점은 서비스 제공업체에 확인하세요. 이 사이트에서는 구독 계정을 조회하거나 대체 링크를 제공할 수 없습니다.

가져온 항목이 있지만 일부 내용이 불완전해 보인다면 먼저 가져온 내용이 선택한 방식에 맞는지 확인하세요. 알 수 없는 설정값을 임의로 조합해 항목을 채우지 마세요. 오류 안내만 기록해 두고 다른 사람에게 설명할 때는 전체 구독 링크를 공개하지 마세요. 특히 링크 끝부분에 포함된 인증 정보와 쿼리 매개변수에 주의하세요.

서버는 선택할 수 있지만 연결 후 접속되지 않음

원본 정보와 비교해 Type, Host, Port, 인증 정보, 추가 전송 설정을 하나씩 확인하세요. 직접 입력하면 공백, 대소문자, 비슷한 문자를 잘못 입력하기 쉽습니다. 복사할 때는 안내 문구의 괄호까지 함께 들어가지 않았는지 확인하세요. 인증서 또는 TLS 오류가 발생하면 서버 이름, 기기 날짜와 시간, 서버 요구 사항부터 점검합니다. 검증 기능을 끄는 것을 일반적인 해결책으로 삼지 마세요.

기본 설정값이 일치하면 같은 네트워크와 모드에서 본인이 보유한 다른 서버 항목도 테스트해 보세요. 한 항목만 실패한다면 해당 항목의 서비스 상태를 우선 확인합니다. 다른 네트워크로 바꿨을 때 결과가 달라진다면 네트워크 환경을 중점적으로 살펴보세요. UDP를 사용하는 연결은 네트워크에서 관련 트래픽을 허용하는지 확인해야 합니다. 서버 이름만으로 사용 가능 여부를 판단해서는 안 됩니다.

테스트 결과는 있지만 특정 페이지나 앱에 문제가 있음

Settings를 열고 Test Method를 확인해 앞서 실행한 테스트가 무엇을 점검했는지 파악하세요. 테스트 응답은 실제 서비스 요청 전체를 대신하지 않습니다. 특정 대상의 오류에는 DNS, 규칙 선택, 대상 서비스 상태, 앱 자체의 캐시가 영향을 줄 수도 있습니다. Global Routing으로 돌아가 모드별 결과를 기록해 비교한 뒤 Config의 Rule을 점검할지 결정하세요. 적용 범위가 지나치게 넓은 규칙을 한 번에 여러 개 추가하지 마세요.

추가 단서가 필요하면 Settings에서 Diagnostics를 확인할 수 있습니다. 실패 당시의 모드, 네트워크, 조작 단계, 오류 문구를 기록하세요. 진단 내용을 공유하기 전에 서버 주소, 비밀번호, 인증 정보, 구독 주소, 개인 접속 기록이 포함되어 있는지 확인하고 불필요한 민감 정보는 삭제합니다. 스크린샷도 공개하기 전에 내용을 확인하세요. 설정 화면이라는 이유만으로 공개해도 안전한 것은 아닙니다.

수동 연결을 확인한 뒤 On Demand 설정

On Demand는 조건에 따라 연결을 시작하는 기능이지 서버의 사용 가능성을 높이는 스위치가 아닙니다. 처음 사용하는 경우 수동 연결과 규칙 확인을 마친 뒤 설정하고, 각 연결 조건을 하나씩 확인하세요. Settings의 Proxy, TCP, UDP 등의 항목도 ‘완벽하게 설정’하기 위해 모두 변경할 필요는 없습니다. 특정 설정이 문제와 관련 있다고 확인된 경우에만 기존 값을 기록하고 하나씩 조정하세요.

위 항목을 확인한 뒤에도 문제가 계속되면 문제 해결에서 증상에 맞는 내용을 찾아보세요. 구매, App Store 국가 또는 지역, 구입 항목 복원 문제는 연결 오류와 별개이므로 App Store에서 받는 방법을 확인하세요. 재현 가능한 단계와 정확한 안내 문구를 남기면 ‘작동하지 않음’처럼 막연하게 설명하는 것보다 다음 점검 항목을 찾기 쉽습니다.

Shadowrocket 공식 Settings 화면: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP, UDP 표시
Settings: 먼저 Test Method를 확인하고 필요하면 Diagnostics를 살펴보세요. On Demand는 수동 연결 확인을 마친 뒤 설정하세요.

완료 후 다음 세 가지를 기록하세요

현재 선택된 서버, Global Routing 모드, 실제 사용 중인 Config를 확인하세요. 이후 구독을 업데이트하거나 구성을 변경할 때는 기존 상태를 기록하고 같은 대상으로 다시 확인합니다. 구독 인증 정보와 서버 로그인 정보는 안전하게 보관하고, 앱 구매 기록과 연결 구성은 별도로 관리하세요.

이 가이드는 확인 가능한 연결을 한 번 완료하는 데까지 안내합니다. 평소 사용 중 규칙을 추가하거나 자동 연결을 설정하고 테스트 방식을 바꿀 때는 명확한 목적을 정하세요. 스크린샷과 완전히 똑같이 만들기 위해 정상 작동 중인 설정을 바꿀 필요는 없습니다.

기능 및 설정 더 알아보기 →