공식 매뉴얼 · 시작 가이드

Shadowrocket 사용법

기존 설정 추가 → Global Routing 선택 → 연결 및 확인

iPhone과 iPad에서 다섯 단계에 따라 연결 상태를 확인합니다. 먼저 설정을 단순하게 유지하고, 이후 규칙과 온디맨드 연결을 하나씩 조정하세요.

이미지는 App Store 공식 스크린샷으로, 화면과 입력 항목을 확인하는 데 사용됩니다. 실제 화면은 기기에 표시되는 내용과 다를 수 있습니다. 아래 두 가지 추가 방법 중 하나를 선택하면 되며, 같은 정보를 중복 입력할 필요는 없습니다.

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

추가가 완료되면 Home으로 돌아왔을 때 SERVER 그룹에 선택 가능한 항목이 표시됩니다. 항목이 보인다는 것은 정보가 저장되었다는 뜻일 뿐, 인증 정보가 올바르거나 연결되었다는 뜻은 아닙니다. 먼저 가지고 있는 자료가 전체 구독 주소인지, 단일 서버의 프로토콜 및 매개변수인지 확인한 뒤 알맞은 방법을 선택하세요.

기존 서버 정보가 있는 경우: 항목별로 입력

Home에서 Add Server를 누르면 추가 화면이 열립니다. 먼저 Type을 열어 자료에 명시된 프로토콜 유형을 선택하세요. Type에 따라 입력 항목이 달라지므로 서버 이름이나 주소만 보고 추측해서는 안 됩니다. 스크린샷의 Host, Port, Password, Method는 해당 화면에 표시된 Type의 항목입니다. 다른 Type을 선택했다면 실제 화면에 표시되는 항목에 맞춰 입력하세요.

Host에는 일반적으로 제공받은 도메인이나 IP 주소를 입력합니다. 전체 구독 링크를 여기에 붙여 넣지 마세요. Port에는 해당 포트를 입력하고, 복사한 값에 공백이 포함되지 않았는지 확인하세요. Password와 Method는 제공받은 정보와 정확히 일치해야 합니다. 흔히 보이는 옵션이라는 이유로 임의로 바꾸지 마세요. 다른 인증 또는 전송 매개변수가 있다면 그것도 하나씩 확인하고, 정보가 부족하면 임의의 값을 반복해서 시도하는 대신 서비스 제공업체에 문의하세요.

화면 아래의 Scan QR Code를 사용하면 본인이 보유한 호환 QR 코드를 읽을 수 있습니다. 시스템에서 카메라 권한을 요청하면 실제 스캔 필요에 따라 허용 여부를 결정하세요. 스캔한 뒤에도 Type과 서버 항목을 확인해야 합니다. QR 코드가 읽혔다고 해서 그 안의 매개변수가 여전히 유효하다는 뜻은 아닙니다. Import from Cloud JSON은 별도의 가져오기 방법이며 Subscribe와는 다릅니다. 일반 구독 주소만 있다면 이 메뉴를 사용할 필요가 없습니다.

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

Add Server의 Type에서 Subscribe를 선택하고, 해당 주소 입력란에 본인의 전체 구독 링크를 붙여 넣은 다음 알아보기 쉬운 메모를 입력하고 저장하세요. 주소의 경로와 쿼리 매개변수를 그대로 유지하세요. 도메인만 복사하거나 브라우저 페이지 제목을 주소로 입력하지 마세요. 구독 링크에는 개인 인증 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요.

저장한 뒤 내용이 불러와질 때까지 기다린 다음 Home으로 돌아가 구독 그룹과 서버 항목을 확인하세요. 그룹은 표시되지만 서버가 없다면 주소가 온전한지, 현재 네트워크에서 읽을 수 있는지, 서비스가 유효한지 먼저 확인하세요. 같은 그룹을 여러 개 만들지 마세요. 구독은 일반적으로 서버 정보 그룹을 관리하고, Config는 구성 파일과 규칙을 관리합니다. 두 작업은 서로 다릅니다.

이 단계가 끝나면 테스트할 항목 하나만 남겨 두면 됩니다. 익숙하지 않은 프로토콜이나 항목은 먼저 용어집에서 확인하세요. 여러 구성 그룹을 더 체계적으로 관리하려면 전체 사용 설명서를 참고하세요.

Shadowrocket Add Server 공식 스크린샷: Type, Host, Port, Password, Method 및 화면 하단의 가져오기 메뉴
Add Server: Type을 먼저 선택한 다음 해당 유형에 맞는 항목을 확인하세요.
다음 단계 전 확인Home의 SERVER에 선택 가능한 항목이 있고, 어떤 자료에서 가져온 항목인지 확인할 수 있습니다.

Global Routing: Config, Proxy 또는 Direct 선택

서버를 추가한 뒤 Home으로 돌아가 Global Routing을 누르세요. 여기서는 트래픽 처리 방식을 정하고, SERVER에서 선택한 항목은 프록시 연결에 필요한 정보를 제공합니다. 서버를 선택했더라도 Direct가 설정되어 있으면 해당 서버의 프록시 연결이 정상인지 확인할 수 없습니다. 두 설정을 함께 확인해야 합니다.

세 가지 방식의 사용 상황

  • Config: 현재 구성 파일의 규칙에 따라 트래픽을 처리합니다. 대상에 따라 적용되는 정책이 다를 수 있으므로 방문할 때마다 선택한 서버를 사용하는 것은 아닙니다.
  • Proxy: 트래픽을 프록시 방식으로 처리합니다. 문제 해결 시 구성 규칙의 영향을 줄이는 데 유용하지만, 기존 서버 매개변수가 올바르고 서비스가 사용 가능해야 합니다.
  • Direct: 트래픽을 직접 연결 방식으로 처리합니다. 기존 네트워크 접속과 비교할 때 사용할 수 있지만, 프록시 서버의 작동 여부를 확인하는 방법은 아닙니다.

이미 사용 목적이 분명한 구성 파일이 있다면 먼저 규칙을 확인한 다음 Config를 선택하는 것이 일반적입니다. 방금 추가한 서버로 연결할 수 있는지 확인하려면 잠시 Proxy를 선택해 비교할 수 있습니다. 확인을 마친 뒤에는 원래 필요한 방식으로 되돌리세요. 문제 해결을 위해 임시로 선택한 방식을 모든 상황에 맞는 고정 설정으로 여기지 마세요.

Config를 사용하기 전에 현재 구성 확인

Config로 이동해 현재 선택된 구성 파일을 확인한 다음 내용을 살펴보세요. 공식 스크린샷에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션과 Add Rule 메뉴가 표시됩니다. 입문 단계에서는 Rule만 살펴보면 됩니다. 방문하려는 대상에 어떤 정책이 적용되는지 확인하고, 첫 연결을 위해 다른 섹션의 기능을 활성화할 필요는 없습니다.

Rule의 규칙은 위에서 아래 순서로 적용되며, 일치하는 규칙을 찾으면 해당 정책을 사용합니다. DIRECT는 직접 연결, PROXY는 프록시 처리, REJECT는 연결 거부를 뜻합니다. FINAL은 앞선 규칙과 일치하지 않은 트래픽을 처리합니다. 아래는 문법을 이해하기 위한 예시일 뿐, 완성된 구성 파일이 아니며 기존 내용을 그대로 덮어쓸 필요도 없습니다:

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

이 예시에서는 example.com과 그 하위 도메인에 해당하는 요청에 PROXY를 적용하고, 나머지 규칙에 일치하지 않은 트래픽은 FINAL을 통해 DIRECT로 처리합니다. 실제 결과는 전체 규칙의 순서와 현재 구성에 따라 달라집니다. 편집하기 전에 기존 구성을 보존해 필요한 설정이 삭제되지 않도록 하세요. 규칙 작성과 일치 처리에 관한 자세한 내용은 전체 사용 설명서에서 확인할 수 있습니다. 이 페이지에서는 먼저 연결 과정을 마무리합니다.

Shadowrocket Config 공식 스크린샷: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션 및 Add Rule
Config에서 구성 내용을 확인하고, Global Routing 방식은 Home에서 선택하세요.
다음 단계 전 확인현재 선택된 방식이 Config, Proxy, Direct 중 무엇인지 설명할 수 있습니다.

Home: 항목을 선택하고 연결 켜기

Home으로 돌아가 먼저 SERVER 그룹에서 사용할 서버를 선택한 다음 Global Routing을 확인하세요. 처음에는 항목 하나만 테스트하는 것이 좋습니다. On Demand, 테스트 방식, 여러 구성 파일을 동시에 조정하지 마세요. 그래야 문제가 생겼을 때 원인을 쉽게 파악할 수 있습니다.

Home 상단에서 연결 스위치를 찾으세요. 공식 스크린샷의 Not Connected는 아직 연결되지 않았다는 뜻입니다. 서버와 연결 방식을 확인한 뒤 옆의 스위치를 켜세요. 처음 연결할 때 시스템에서 VPN 구성을 추가할지 물을 수 있습니다. 이 안내는 Shadowrocket이 기기의 네트워크 트래픽을 처리하는 데 필요한 시스템 구성을 만들기 위한 것입니다. 앱을 다시 구매하거나 구독 비밀번호를 입력하라는 뜻은 아닙니다.

안내가 현재 작업에서 나온 것인지 확인한 뒤 시스템 화면에 따라 허용 및 인증을 완료하고 Shadowrocket으로 돌아오세요. 암호나 다른 인증을 요구하는지는 시스템의 실제 안내를 따르세요. 기기 잠금 암호를 Add Server의 Password에 입력하면 안 됩니다. 시스템 인증과 서버 인증은 서로 다른 정보입니다.

이전에 시스템 안내를 취소했다면 앱으로 돌아가 연결을 다시 시도하고 권한 화면이 다시 나타나는지 확인하세요. 기기가 조직에서 관리되거나 다른 VPN 연결을 사용 중이라면 기기 자체의 사용 제한과 현재 연결 상태를 먼저 확인하세요. 용도를 알 수 없는 시스템 구성을 반복해서 삭제하지 마세요. 안내에 표시된 내용을 기록해 두면 스위치를 계속 켰다 끄는 것보다 문제를 파악하는 데 도움이 됩니다.

권한을 허용한 뒤 Home 상단의 상태가 Not Connected에서 바뀌는지, 스위치가 곧바로 다시 꺼지지 않는지 확인하세요. 시스템 VPN 연결은 확인 과정의 첫 단계일 뿐입니다. 서버 인증, 대상에 대한 접속 가능 여부, 규칙 처리도 이어서 확인해야 합니다. 상태가 바뀌면 현재 설정을 유지한 채 확인 단계로 넘어가고 항목을 한꺼번에 수정하지 마세요.

수동 테스트를 마치려면 Home으로 돌아가 연결 스위치를 끄세요. 이후 다시 자동으로 연결된다면 Settings에서 On Demand가 켜져 있는지와 실행 조건을 확인하세요. 자동 재연결이 곧바로 스위치 고장을 뜻하는 것은 아닙니다.

Shadowrocket Home 공식 스크린샷: Not Connected 스위치, Global Routing, Connectivity Test, SERVER 및 Add Server
Home: 선택한 서버와 Global Routing을 확인한 뒤 상단 스위치를 켜세요.
다음 단계 전 확인시스템 VPN 안내를 처리했고 연결 스위치와 상단 상태의 실제 변화를 확인했습니다.

Connectivity Test: 연결 작동 여부 확인

연결 사용 가능 여부는 스위치만 보지 말고 테스트 결과, 실제 접속, 트래픽 변화를 함께 확인해야 합니다. 먼저 Home에서 Connectivity Test를 실행하고 완료될 때까지 기다린 뒤 결과를 기록하세요. 테스트에 실패하면 현재 서버와 방식을 유지하고 다음 단계에서 순서대로 점검하세요. 테스트에 성공했더라도 대상 앱에서 실제로 접속되는지 확인해야 합니다.

테스트 결과의 의미와 한계

Connectivity Test는 선택한 테스트 방식과 대상이 당시 어떻게 작동했는지를 보여줍니다. 지연 시간 하나로 모든 웹페이지에 접속할 수 있다고 판단할 수 없으며, 파일 전송 속도로 환산할 수도 없습니다. Test Method가 다른 결과끼리는 직접 비교하기 어렵습니다. 설정 변경이 효과가 있었는지 확인하려면 테스트 방식을 동일하게 유지하고 변경 전후의 결과를 비교하세요.

이어서 평소 사용하는 웹페이지나 앱을 열어 현재 네트워크에서 허용되는 요청을 다시 보내세요. 이미 캐시된 페이지만 확인하지 마세요. 이전에 불러온 내용이 보인다고 해서 새 요청까지 완료된 것은 아닐 수 있습니다. 처음에는 확인할 대상을 하나 정해 새 콘텐츠가 로드되는지 살펴본 뒤 테스트 범위를 넓히세요.

접속 결과를 현재 방식과 함께 확인

Config를 사용한다면 테스트 대상이 어떤 규칙과 일치해야 하는지 먼저 확인하세요. 대상이 DIRECT와 일치하면 웹페이지가 정상적으로 열려도 프록시 서버가 작동한다고 판단할 수 없습니다. 대상이 REJECT와 일치하면 접속 실패가 구성에서 예상된 동작일 수 있습니다. 규칙 문제와 서버 문제를 구분하려면 잠시 Proxy로 변경해 같은 네트워크와 서버에서 요청을 다시 보낸 다음 원래 설정으로 되돌리세요.

Data를 열어 트래픽 변화를 살펴보면 요청이 발생했는지 확인하는 데 도움이 됩니다. 다만 기기의 백그라운드 작업도 트래픽을 발생시킬 수 있으므로 총량이 늘었다는 사실만으로 특정 웹페이지에 예상한 정책이 적용되었다고 볼 수는 없습니다. 작업 시간, 접속 대상, 트래픽 변화를 함께 살펴보는 편이 누적 수치만 보는 것보다 정확합니다.

마지막으로 이번에 정상 작동한 조합을 기록하세요: 선택한 서버, Global Routing 방식, 현재 구성, 테스트 네트워크. 한 번 검증에 성공한 뒤 필요한 설정을 하나씩 추가하세요. 특정 대상만 실패한다면 모든 구성을 바로 바꾸지 말고 해당 대상에 적용되는 규칙과 접속 가능 여부를 먼저 확인하세요. 모든 접속이 실패한다면 다음 단계로 넘어가 기본 네트워크부터 점검하세요.

Settings: 문제 발생 지점에 따라 점검

점검할 때는 한 번에 조건 하나만 변경하고, 변경 후 같은 방법으로 다시 확인하세요. 먼저 문제가 어느 단계에서 발생하는지 판단합니다. 구독 내용을 불러올 수 없는지, 스위치가 유지되지 않는지, 테스트가 실패하는지, 특정 웹페이지에서만 문제가 생기는지에 따라 점검 순서가 다릅니다. 원인을 파악하지 않고 반복해서 재설치하는 것은 적절한 해결 방법이 아닙니다.

구독에 항목이 없거나 서버 정보가 불완전한 경우

현재 연결을 끄고 기기의 기존 네트워크가 정상적으로 작동하는지 확인한 다음 구독 주소가 온전한지 점검하세요. 주소를 읽지 못하는 문제와 서버 연결 실패는 다릅니다. 전자는 사용 가능한 항목을 아직 가져오지 못했을 수 있고, 후자는 항목이 있는 상태에서 연결에 문제가 생긴 경우입니다. 직접 추가한 항목은 상세 정보를 다시 열어 Type, Host, Port, 인증 매개변수를 확인하세요. 특히 복사할 때 공백이나 줄바꿈이 들어가거나 내용이 누락되지 않았는지 살펴보세요. 서비스 상태와 이용 조건은 본인의 서비스 제공업체에 확인하세요.

스위치가 꺼지거나 모든 실제 요청이 실패하는 경우

시스템 VPN 구성 권한을 완료했는지 확인하고 명확한 오류 안내가 표시되는지 살펴본 다음 올바른 서버가 선택되었는지 확인하세요. 기존 자료와 인증 정보를 대조하고, 문제 해결을 위해 보안 관련 설정을 임의로 낮추지 마세요. Wi-Fi와 셀룰러 네트워크를 비교하려면 두 네트워크에서 같은 항목과 방식을 사용하고 해당 네트워크의 이용 조건을 확인하세요. 네트워크를 바꾼 뒤 결과가 다르더라도 네트워크 경로를 더 살펴볼 필요가 있다는 뜻일 뿐, 특정 매개변수가 원인이라고 단정할 수는 없습니다.

테스트 결과와 실제 접속 결과가 다른 경우

Settings로 이동해 Test Method를 찾고 기존 선택 항목을 먼저 기록하세요. 테스트 방식에 따라 확인 대상과 결과의 의미가 다를 수 있으므로 실제 요청과 함께 판단해야 합니다. 더 낮은 수치를 얻기 위해 방법을 계속 바꾸지 마세요. Proxy에서는 접속되지만 Config에서는 실패한다면 서버 비밀번호를 바로 다시 입력하기보다 Config에서 Rule의 일치 순서, 대상 정책, FINAL을 먼저 확인하세요.

연결을 끈 뒤 자동으로 다시 연결되거나 추가 진단이 필요한 경우

Settings에서 On Demand를 확인하세요. 온디맨드 연결 조건이 설정되어 있으면 네트워크 변경이나 관련 요청으로 연결이 다시 시작될 수 있습니다. 수동 테스트를 명확하게 진행하려면 기존 조건을 기록한 뒤 잠시 온디맨드 연결을 중지하고, 테스트가 끝나면 원래 목적에 맞게 복원하세요. 여러 자동화 조건을 동시에 수정하면 어떤 조건이 작동했는지 파악하기 어렵습니다.

추가 단서가 필요하면 Settings의 Diagnostics를 확인하세요. 실패 시각, 당시 네트워크, 선택한 서버, Global Routing 및 오류 문구를 기록하세요. 진단 기록에는 도메인, 주소 또는 인증 정보가 포함될 수 있습니다. 다른 사람에게 문제를 설명하기 전에 민감한 내용을 확인하고 가리세요. 전체 구독 주소, 비밀번호, QR 코드를 공개적으로 보내지 마세요.

Settings에는 Proxy, TCP, UDP 등의 항목도 표시되지만, 입문 단계에서 하나씩 변경할 필요는 없습니다. 해결할 문제가 무엇인지 확인한 뒤 관련 설정만 조정하세요. 구성 관리, Data 확인 및 문제 해결 절차는 전체 사용 설명서에서, 용어 설명은 용어집에서 확인할 수 있습니다.

Shadowrocket Settings 공식 스크린샷: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP
Settings: 구체적인 문제에 맞춰 Test Method, On Demand, Diagnostics를 확인하세요.
완료 후 보관실제로 확인을 마친 설정과 변경 전 구성 기록을 보관하고, 이후에는 한 번에 한 항목씩만 조정하세요.