공식 매뉴얼 · 첫 설정

Shadowrocket 사용법

기존 연결 정보를 이용해 가져오기, 모드 선택, 연결 및 확인을 차례대로 진행합니다.

이 페이지는 iPhone과 iPad에서의 사용 방법을 중심으로 설명합니다. 스크린샷은 App Store 공식 자료이며, 실제 메뉴 위치와 사용 가능한 옵션은 앱에 표시되는 내용을 기준으로 확인하세요. 처음에는 연결 하나가 정상 작동하는지 확인한 뒤 규칙과 자동 연결 설정을 조정하는 것이 좋습니다.

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

입력하려는 정보가 개별 서버 매개변수인지, 목록 업데이트용 구독 URL인지 먼저 확인하세요.

Shadowrocket을 열고 Home으로 이동한 다음 SERVER 그룹 근처에서 Add Server를 선택합니다. 페이지의 추가 메뉴를 이용해도 됩니다. 상단 연결 스위치는 아직 켜지 마세요. 우선 연결 정보를 정확히 저장해야 합니다. 단일 공유 링크, 구독 URL, 구성 파일은 용도가 다르므로 모두 같은 메뉴로 가져올 수 있는 것은 아닙니다.

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

Add Server를 열고 먼저 Type을 선택합니다. Type은 보유한 정보의 프로토콜과 일치해야 합니다. 예를 들어 Shadowsocks, VMess, VLESS 또는 Trojan 중에서 선택하며, 이름이 비슷하다는 이유만으로 추측해서는 안 됩니다. 선택한 프로토콜에 따라 입력 항목이 표시됩니다. 원본 정보에 맞춰 Host, Port 및 해당 프로토콜의 인증 정보를 입력하세요. 스크린샷은 Password와 Method가 있는 양식의 한 예이며, 모든 Type에서 같은 항목을 사용하는 것은 아닙니다.

항목을 하나씩 확인하세요. Host에는 자료에 명시된 서버 주소만 입력하고 전체 웹 주소를 넣지 마세요. Port는 원래 값 그대로 입력합니다. Password, Method 및 프로토콜에 따라 표시되는 전송·보안 설정도 원본 정보와 일치해야 합니다. 제공되지 않은 선택 항목은 우선 기본값을 유지하고, 다른 프로토콜의 예시를 섞어 입력하지 마세요. 입력을 마치면 저장한 뒤 Home으로 돌아가 SERVER에 새 항목이 표시되는지 확인합니다.

구독 URL이 있는 경우: Subscribe 선택

서버 목록을 업데이트하는 구독 URL이 있다면 Add Server에서 Type으로 Subscribe를 선택한 뒤 해당 URL 항목에 전체 주소를 입력합니다. 확인 후 저장하고 불러오기가 완료될 때까지 기다리세요. 주소의 모든 쿼리 매개변수를 유지하고, 복사할 때 앞뒤가 잘리지 않았는지와 불필요한 공백이 섞이지 않았는지 확인합니다. 구독 URL에는 접근 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하고 공개 게시물이나 스크린샷에 노출하지 마세요. 서버 구독은 서버 목록을 가져오거나 업데이트하는 기능이며 Config의 규칙 설정 파일과는 다릅니다.

정보가 QR 코드로 제공되었다면 Scan QR Code로 인식할 수 있습니다. 해당 형식의 콘텐츠를 보유한 경우에만 Import from Cloud JSON을 사용하세요. 인식 후에도 Type과 주요 항목을 확인해야 합니다. 텍스트가 읽혔다고 해서 매개변수가 올바른 것은 아닙니다. 가져오기가 끝나면 목록에 항목이 실제로 표시되는지 확인하고 테스트할 서버를 선택하세요. 목록이 비어 있다면 연결 스위치를 계속 조작하기보다 문제 해결에서 주소와 가져오기 결과를 확인하세요.

Shadowrocket Add Server 화면: Type, Host, Port, Password, Method 및 하단 가져오기 메뉴
Add Server: 먼저 Type을 선택한 다음 해당 프로토콜에 맞는 항목을 입력합니다. 그림의 입력 항목이 모든 프로토콜에 적용되는 것은 아닙니다.

02 Global Routing 선택

서버는 연결 대상지를 정하고, Global Routing은 요청을 처리할 방식을 결정합니다.

사용할 서버를 확보했다면 Home으로 돌아가 Global Routing을 탭합니다. 이 선택은 SERVER 목록에서 서버를 선택하는 것과 다릅니다. 서버를 선택해도 모든 요청이 해당 서버를 사용하는 것은 아닙니다. 처음에는 세 가지 모드의 차이를 이해한 뒤 확인할 항목을 정하세요. 연결은 되었지만 예상과 다른 결과가 나오는 상황을 구분하는 데 도움이 됩니다.

Config: 현재 설정에 따라 처리

Config은 현재 구성 파일의 규칙에 따라 요청의 목적지를 결정합니다. 일부 요청은 PROXY로, 다른 요청은 DIRECT로 전달될 수 있으며, 특정 연결은 REJECT로 차단될 수도 있습니다. 따라서 Config 사용 중 요청이 직접 연결되더라도 반드시 오류는 아니며, 규칙에 따른 정상 동작일 수 있습니다. 하단의 Config 페이지에서 사용 중인 구성 파일을 확인하세요. 파일을 열어볼 때는 General, Rule, Hosts, URL Rewrite 등의 섹션을 살펴보면 됩니다.

스크린샷은 구성 편집 화면이며, Add Rule은 규칙을 추가하는 메뉴입니다. 처음 연결할 때 많은 규칙을 바로 작성할 필요는 없습니다. 먼저 구성 파일의 출처와 내용을 확인하고 복구 가능한 사본을 저장한 뒤 수정하세요. 용도를 모르는 상태에서 기존 구성을 통째로 덮어쓰지 마세요. 특히 Rule의 매칭 순서와 마지막 FINAL을 확인해야 합니다. 규칙 이름만으로는 실제 요청에 적용될 정책을 판단하기 어렵습니다.

Proxy 및 Direct: 동작 비교에 사용

Proxy는 전체 라우팅을 프록시 모드로 전환하며, 테스트 결과에 규칙 분기가 영향을 주는지 확인할 때 임시로 사용할 수 있습니다. 잘못된 서버 주소, 인증 정보 또는 전송 매개변수를 수정해 주는 기능은 아닙니다. Direct는 직접 연결 모드이며 프록시 서버가 작동하는지 확인하는 데 사용되지 않습니다. 두 모드 모두 현재 네트워크 환경을 고려해 사용하고, 연결 성공률을 높여 주는 고정 스위치로 여기지 마세요.

사용할 규칙 구성이 이미 준비되어 있다면 평소에는 Config를 선택하면 됩니다. 새로 추가한 서버의 사용 가능 여부를 확인하려면 Proxy로 임시 전환해 비교할 수 있습니다. 테스트를 마친 뒤 Global Routing으로 돌아가 필요한 모드를 복원하세요. 규칙 유형, PROXY/DIRECT/REJECT 정책, 첫 번째 일치 규칙의 동작은 규칙 매뉴얼에서 확인할 수 있습니다. 이 페이지에서는 첫 연결을 완료하는 데 집중하며 복잡한 규칙 편집은 다루지 않습니다.

Shadowrocket Config 구성 편집 화면: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션 및 Add Rule 표시
Config 구성 편집 화면입니다. Global Routing은 Home에서 선택하며, 이 그림은 구성 파일 내용을 확인할 때 참고하세요.

03 연결 시작 및 승인 완료

먼저 서버를 선택하고, 시스템 안내를 처리한 다음 앱의 연결 상태를 확인합니다.

Home으로 돌아가 SERVER에서 방금 사용할 항목이 선택되어 있는지 확인한 뒤 Global Routing도 살펴봅니다. 구독에 항목이 여러 개 있다면 처음에는 매개변수가 완전한 서버 하나만 선택해 확인하고 이름을 기록하세요. 여러 항목을 빠르게 연속해서 전환할 필요는 없습니다. 문제가 생겼을 때 같은 연결을 확인하고 있는지, 테스트 조건이 바뀌었는지 파악하기 쉽습니다.

Home 상단의 연결 스위치를 켭니다. 연결되지 않은 상태에서는 Not Connected가 표시될 수 있습니다. 스위치를 눌렀는지만 보지 말고 실제 상태가 바뀌는지 확인하세요. 처음 사용할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 앱이 시스템 네트워크 확장을 통해 연결을 처리하는 데 필요한 승인 절차이며, 구매 확인이나 누락된 서버 정보 입력과는 관계없습니다.

팝업에 표시된 앱 이름을 확인한 뒤 시스템 안내에 따라 허용하고 기기 인증을 완료하세요. 이전에 승인을 취소했다면 앱으로 돌아가 다시 연결을 시작하고 시스템 화면의 안내를 따릅니다. 팝업을 건너뛰려고 관계없는 시스템 설정을 변경하지 마세요. 시스템 화면의 문구와 인증 방식은 기기 설정에 따라 다를 수 있으므로 현재 화면의 안내를 기준으로 진행하세요.

완료 후 Home으로 돌아가 연결 상태가 유지되는지 확인합니다. 시스템에서 VPN 구성 추가를 허용한 것과 원격 서버에 접속할 수 있는지는 별개의 확인 항목입니다. 시스템에 연결됨으로 표시되어도 서버 인증 실패, 대상에 연결할 수 없는 문제, 예상과 다른 규칙 동작 등이 있을 수 있습니다. 다음 단계에서 실제 요청을 확인해야 하며 시스템 표시만으로 결론을 내리지 마세요.

첫 설정 중에는 직접 제어할 수 있는 연결 방식을 유지하세요. 자동 연결 설정을 켜 둔 상태에서 테스트 중 수동으로 끈 뒤 자동으로 다시 켜지면 스위치가 작동하지 않는 것처럼 보일 수 있습니다. On Demand의 동작은 Settings에서 확인할 수 있습니다. 작동 조건을 이해하기 전에는 첫 연결을 위해 이를 추가로 켤 필요가 없습니다. 현재 선택을 유지하고 아래 확인 단계로 진행하세요.

Shadowrocket Home 화면: 상단에 Not Connected, Global Routing, Connectivity Test가 표시되고 아래에 SERVER 그룹과 Add Server가 보이는 화면
Home: 연결 스위치, Global Routing, Connectivity Test, SERVER 목록은 각각 다른 항목을 확인합니다.

04 연결 및 트래픽 분기 결과 확인

앱 상태 → 테스트 결과 → 실제 접속 순서로 확인하세요.

연결을 켠 뒤 Home에서 Connectivity Test를 실행해 확인합니다. 테스트 결과는 현재 테스트 방식에서의 연결 상태를 보여줄 뿐, 모든 웹사이트·프로토콜·요청이 성공한다는 뜻은 아닙니다. 시간 초과가 발생해도 구독이 만료되었다고 단정할 수 없습니다. 테스트 방식과 대상, 현재 네트워크 상태가 결과에 영향을 줄 수 있습니다. 먼저 이번 결과를 기록한 뒤 실제 접속을 확인하세요.

브라우저를 열어 원래 정상적으로 열리며 이번 확인 목적에 맞는 페이지를 방문하세요. 새 페이지를 열거나 다시 로드해 캐시된 콘텐츠를 새 연결의 성공으로 오해하지 않도록 합니다. 페이지가 완전히 로드되는지 확인한 뒤 세부 리소스나 기능도 살펴보세요. 페이지에 텍스트가 표시되어도 이미지, 동영상 또는 다른 요청이 같은 경로를 사용한다고 볼 수는 없습니다.

Config를 사용 중이라면 현재 구성에서 어떤 규칙이 일치해야 하는지 확인하고 대상 요청이 PROXY와 DIRECT 중 어디로 전달될지 살펴보세요. 페이지가 열렸다는 이유만으로 프록시가 적용되었다고 판단할 수는 없습니다. 원래 DIRECT로 연결되는 대상일 수도 있습니다. 선택한 서버 자체를 확인하려면 Proxy로 임시 전환한 뒤 같은 서버와 대상을 유지해 다시 요청하세요. 테스트가 끝나면 Config로 복원합니다.

비교할 때는 한 번에 하나의 조건만 바꾸세요. 예를 들어 서버는 그대로 두고 Global Routing만 전환하거나, 모드는 유지한 채 본인이 보유한 서버 중 하나만 바꿉니다. 서버 변경, 구성 수정, 네트워크 전환을 동시에 하면 성공이나 실패의 원인을 파악하기 어렵습니다. Wi-Fi와 셀룰러 데이터를 비교할 때도 각각의 결과를 기록하고, 서로 다른 조건의 테스트를 한데 묶지 마세요.

05 문제 발생 지점별 점검

이상이 처음 나타난 단계부터 시작해 한 번에 한 항목씩 확인하세요.

목록에 항목이 없음: 가져오기 단계 확인

저장 후에도 SERVER가 비어 있다면 서버 구독 URL, 단일 공유 링크, 규칙 구성 파일 주소 중 무엇을 사용했는지 먼저 확인하세요. 입력 정보의 유형과 메뉴가 맞는지 확인한 다음 주소가 완전한지, 불필요한 줄바꿈이 포함되었는지, 가져오는 동안 네트워크를 사용할 수 있었는지 살펴봅니다. 구독 응답 내용, 유효 여부, 접근 제한은 기존 정보를 제공한 곳에 확인해야 합니다. 연결 스위치를 반복해서 눌러도 가져오기 오류는 해결되지 않습니다. 다시 가져오기 전에 원본 정보를 보관해 비교할 수 있도록 하세요.

항목은 있지만 사용할 수 없음: 매개변수와 테스트 방식 확인

수동으로 입력한 항목은 Type, Host, Port, 인증 정보를 하나씩 대조한 다음 해당 프로토콜의 전송 및 보안 설정을 확인하세요. 구독에서 가져온 항목은 먼저 업데이트가 정상적으로 되었는지 확인하고, 의미를 모르는 상태에서 여러 항목을 수정하지 마세요. Settings에서 Test Method를 확인해 현재 테스트 결과가 어떤 방식으로 측정되었는지 살펴봅니다. 테스트 방식이 다르면 결과를 같은 기준의 수치처럼 비교할 수 없으며, 한 번의 결과만으로 모든 연결을 판단해서도 안 됩니다.

연결은 되었지만 접속 결과가 예상과 다름: 모드 및 규칙 확인

먼저 Home에서 Global Routing을 확인하세요. Direct 상태인지, Config의 규칙이 해당 대상을 원래 DIRECT로 전달하도록 설정되어 있는지 살펴봅니다. Proxy에서는 접속되지만 Config로 돌아온 뒤 결과가 예상과 다르다면 같은 서버를 반복해서 가져오기보다 현재 구성, 규칙 순서, 정책 참조를 확인하세요. 두 모드 모두 실패한다면 서버 자체, 현재 네트워크, 대상의 사용 가능 여부를 점검합니다. DNS 관련 문제도 구체적인 오류를 바탕으로 분석해야 합니다. 페이지가 열리지 않는다는 이유만으로 모든 이름 확인 설정을 무작정 바꾸지 마세요.

스위치가 저절로 다시 켜지거나 진단 정보가 불명확함: Settings 확인

수동으로 연결을 끈 뒤 다시 연결이 시작된다면 Settings에서 On Demand가 켜져 있는지, 현재 테스트 목적에 맞는지 확인하세요. 추가 단서가 필요하면 Diagnostics에 실제로 표시되는 진단 항목을 살펴봅니다. 화면에는 Proxy, TCP, UDP 등의 분류가 표시될 수 있지만, 첫 연결을 위해 모두 변경해야 하는 항목은 아닙니다. 문제 해결을 위해 모든 옵션을 하나씩 켜고 끄지 마세요. 현재 증상과 관련된 항목만 조작하고 원래 값을 기록해 복원할 수 있도록 합니다.

진단 내용을 정리할 때는 “어느 단계에서 실패했는지, 어떤 모드를 선택했는지, Connectivity Test 결과는 어땠는지, 실제 대상에 접속할 수 있었는지”를 적으면 “연결이 안 돼요”라고만 하는 것보다 도움이 됩니다. 내용을 공유하기 전에 전체 구독 URL, 비밀번호, 인증 식별 정보, QR 코드를 삭제하세요. 스크린샷에 민감한 정보가 노출되지 않았는지도 확인합니다. 문제를 해결한 뒤에는 확인 단계로 돌아가 같은 조건으로 다시 테스트하세요. 구성 구조, 매칭 우선순위, 규칙 조각을 더 알아보려면 규칙 매뉴얼을 참고하세요.

Shadowrocket Settings 화면: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 항목 표시
Settings: 문제에 따라 Test Method, On Demand 또는 Diagnostics를 확인하세요. 모든 설정을 하나씩 수정할 필요는 없습니다.