공식 매뉴얼 Home → Connect

Shadowrocket 사용법

기존 구독을 바탕으로 서버 추가, 모드 선택, 연결 및 확인을 차례로 진행합니다. 먼저 연결을 한 번 완료한 뒤 규칙과 자동 연결 설정을 조정하세요.

시작 전: 앱과 연결 정보는 각각 준비해야 합니다

이 가이드는 iPhone / iPad 화면을 기준으로 설명합니다. 먼저 Shadowrocket을 설치하세요. iPhone / iPad는 App Store에서 $2.99 일회성 결제로 구매할 수 있습니다. Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 다운로드 페이지에서 무료로 설치할 수 있습니다. 최초 설치 시 시스템 허용 절차는 설치 안내를 확인하세요. iPhone / iPad의 시스템 요구 사항은 App Store 페이지에 표시된 내용을 따릅니다.

또한 본인의 구독 링크나 서버 정보가 있는지 확인하세요. 관련 정보는 서비스 제공업체에서 받을 수 있습니다. 이 사이트는 서버나 구독을 제공·판매·추천하지 않습니다. 클라이언트 일회성 구매 ≠ 연결 서비스 요금제이며, 앱을 설치해도 사용할 수 있는 서버가 자동으로 생성되지는 않습니다.

순서대로 진행하면 됩니다. 이미 가져오기를 마쳤다면 Global Routing부터 시작할 수 있습니다. 스크린샷은 화면 영역을 확인하기 위한 것으로, 실제 항목은 선택한 Type과 앱 화면에 따라 다를 수 있습니다.

STEP 01 / IMPORT

서버 추가 / 구독 가져오기

Shadowrocket을 연 뒤 먼저 Home 화면에 머뭅니다. 상단 스위치를 바로 켤 필요는 없습니다. 화면 아래의 SERVER 그룹에서 서버를 선택할 수 있습니다. 사용할 항목이 없다면 Add Server로 이동하세요. 가지고 있는 정보가 여러 서버를 업데이트하는 구독 링크인지, 단일 서버 공유 링크인지, 아니면 항목별로 입력해야 하는 매개변수인지 먼저 확인합니다. 정보 유형에 따라 입력 위치가 다를 수 있으므로 링크 모양이 비슷하다는 이유만으로 같은 필드에 입력하지 마세요.

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

Add Server에서 Type을 열고 Subscribe를 선택한 다음 전체 구독 링크를 URL에 입력합니다. 링크는 서비스 제공업체에서 받아야 합니다. 붙여넣을 때 시작 부분, 경로 및 쿼리 매개변수를 그대로 유지하고, 대화 메시지의 설명이나 줄바꿈, 끝의 문장 부호를 함께 넣지 마세요. 메모 필드가 있다면 “일상 연결”처럼 알아보기 쉬운 이름을 적을 수 있습니다. 메모는 기기에서 항목을 구별하기 위한 것이며 링크 오류를 수정하지는 않습니다.

확인 후 저장하고 구독 다운로드가 끝날 때까지 기다린 다음 Home으로 돌아와 SERVER를 확인합니다. 성공 여부는 구독 기록이 저장되었는지가 아니라 해당 서버 항목이 표시되는지로 판단합니다. 구독 이름만 보이고 서버가 없다면 먼저 네트워크에서 구독 주소에 접속할 수 있는지 확인하고, 링크가 만료되었는지 또는 서비스 제공업체가 지원하는 형식인지 살펴봅니다. 목록을 채우려고 같은 링크를 반복해서 추가하지 마세요. 중복 항목은 나중에 선택하고 문제를 해결하기 어렵게 만듭니다.

서버 매개변수가 있는 경우: Type에 맞춰 직접 입력

Host, Port, Password처럼 개별 항목을 받았다면 Add Server에서 올바른 Type을 선택한 후 해당 유형에 필요한 내용을 입력합니다. Host에는 서버 도메인이나 IP를, Port에는 해당 포트를 입력하고 Password는 대소문자와 기호를 그대로 유지합니다. Method 등의 항목은 해당 프로토콜에서 필요할 때만 입력하세요. 다른 프로토콜의 스크린샷을 보고 모든 항목을 채우지 마세요. Type을 선택한 뒤 표시되는 항목만 확인하면 됩니다.

예를 들어 Shadowsocks의 Method는 서버 설정과 일치해야 합니다. Trojan의 TLS 및 서버 이름 설정도 보유한 정보에 맞춰 확인해야 합니다. 주소, 비밀번호 또는 서버 이름이 불분명하면 임의로 바꿔 입력하지 말고 서비스 제공업체에 문의하세요. 스크린샷은 Add Server의 구성을 보여주는 것이며, 모든 Type이 같은 항목을 사용한다는 뜻은 아닙니다. 저장 후 SERVER로 돌아와 메모와 대상 서버를 확인하고 다음 단계에서 트래픽 경로를 선택합니다.

공유 링크 또는 QR 코드가 있는 경우: 가져온 뒤에도 확인

단일 서버 공유 링크를 받았다면 앱의 클립보드 가져오기 기능을 사용할 수 있습니다. QR 코드는 Scan QR Code에서 읽고 시스템 안내에 따라 카메라 접근을 허용합니다. 가져오기 전에 출처와 내용이 본인의 서버 정보인지 확인하고, 가져온 뒤 항목을 열어 Type, Host 및 Port를 확인합니다. Import from Cloud JSON은 별도 지정 형식용 메뉴이므로 임의의 구독 주소를 입력하는 공용 필드로 사용하면 안 됩니다.

구독 링크에는 접근 정보가 포함될 수 있고 QR 코드에도 전체 비밀번호가 들어 있을 수 있습니다. 공개 댓글에 올리거나 문제 해결용 스크린샷에 그대로 포함하지 마세요. 구독 업데이트, 여러 구독 정리 및 공유 링크 항목에 대한 자세한 설명은 구독 및 서버 관리 매뉴얼을 참조하세요. 여기서는 유효성을 확인한 정보 한 세트로 다음 단계로 진행합니다.

Shadowrocket Add Server 화면. Type, Host, Port, Password, Method 및 Scan QR Code 메뉴 표시
Add Server: 먼저 Type을 정하고 해당 항목을 입력합니다. Subscribe와 단일 서버 매개변수 입력은 용도가 다릅니다.

STEP 02 / ROUTING

Global Routing 모드 선택

서버가 표시되면 Home으로 돌아와 Global Routing을 엽니다. 이 설정은 요청을 처리하는 방식을 정하며 구독을 다운로드하거나 서버 매개변수를 보완하지는 않습니다. 세 가지 모드는 Config, Proxy, Direct입니다. 이 단계를 먼저 이해하면 연결을 켜기 전에 “서버를 선택했다”는 것과 “모든 요청이 서버를 통과한다”는 것을 혼동하지 않을 수 있습니다.

Config: 현재 규칙에 따라 경로 결정

Config는 현재 선택한 구성의 규칙을 사용합니다. Config에 들어가면 구성 파일을 확인하고 선택하거나 편집할 수 있습니다. 편집 화면의 General, Rule, Hosts 등의 섹션은 각각 용도가 있으며, Rule에서는 규칙 내용을 확인합니다. 일상적으로 사용하기 전에 사용할 파일이 선택되어 있는지 확인하세요. 파일을 다운로드했어도 다른 구성을 사용 중일 수 있습니다. 처음 사용할 때는 DNS, Rewrite 및 HTTPS Decryption을 한꺼번에 변경하지 말고 설명할 수 있는 기본 규칙을 유지하세요.

아래는 규칙 형식 설명이며 기존 구성을 그대로 덮어쓰라는 뜻이 아닙니다. 규칙은 일반적으로 순서대로 일치 여부를 확인하고, 일치한 정책에 따라 요청을 PROXY 또는 DIRECT로 보냅니다. FINAL은 앞서 일치하지 않은 요청을 처리합니다. 현재 구성의 출처와 규칙 순서를 모른다면 먼저 Rule 내용을 확인하세요. 자세한 키워드는 개념 빠른 참조에서 확인할 수 있습니다.

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

Proxy와 Direct: 트래픽 경로 비교

Proxy는 앱이 처리하는 요청을 선택한 프록시 정책으로 보내며 서버의 기본적인 작동 여부를 확인할 때 비교 기준으로 사용할 수 있습니다. Direct는 앱이 처리하는 요청을 대상에 직접 연결합니다. Direct는 상단 연결 스위치를 끄는 기능이 아닙니다. 두 설정은 서로 다른 계층을 제어합니다. 연결을 종료하려면 Direct로 바꾸는 대신 Home으로 돌아가 스위치를 끄세요.

Config에서 특정 페이지가 열리지 않는다면 잠시 Proxy로 전환해 같은 페이지를 테스트할 수 있습니다. Proxy에서는 작동하지만 Config에서는 안 된다면 구성 규칙의 일치 여부, 정책 선택 및 이름 확인 설정을 살펴봅니다. 둘 다 작동하지 않으면 먼저 서버와 로컬 네트워크를 확인하세요. 한 번에 하나의 설정만 변경하고 기존 모드를 기록해 두었다가 테스트가 끝나면 평소 설정으로 되돌려 문제 해결 설정이 기기에 남지 않도록 합니다.

Shadowrocket Config 구성 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config 편집 화면: Rule에서 규칙을 확인하고 편집할 수 있습니다. Global Routing 모드 선택은 이 편집 화면이 아니라 Home에 있습니다.

STEP 03 / CONNECT

항목 선택 후 연결 스위치 켜기

Home으로 돌아와 SERVER 그룹에서 사용할 서버를 누르고 올바른 항목에 선택 표시가 있는지 확인합니다. 구독에 항목이 여러 개라면 메모의 비슷한 문구만 보고 고르지 마세요. 필요한 경우 상세 정보를 열어 주소를 확인합니다. 서버 목록이 표시되는 것은 정보가 가져와졌다는 뜻일 뿐입니다. 연결이 실제로 수립되는지는 이어지는 권한 승인 및 접속 확인으로 판단해야 합니다.

화면 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성 추가를 허용할지 묻는 메시지가 표시될 수 있습니다. 안내를 읽고 Shadowrocket에서 직접 시작한 작업인지 확인한 다음 시스템 요청에 따라 권한과 기기 인증을 완료하세요. 이 권한은 클라이언트가 시스템 네트워크 연결을 설정하는 데 필요하며 구독 유효성과는 별개입니다. 앞서 권한을 취소했다면 앱으로 돌아와 다시 연결을 시작하고 시스템 확인 절차가 다시 표시되는지 살펴봅니다.

권한 설정이 끝나면 Home으로 돌아와 상단 상태가 Not Connected에서 연결됨으로 바뀌는지 확인합니다. 상태가 바뀌는 동안 스위치를 연속해서 켜고 끄지 말고 작업이 끝날 때까지 기다리세요. 스위치가 바로 원래 상태로 돌아간다면 오류 메시지가 표시되었는지 기록한 뒤 아래 문제 해결 절차를 따릅니다. 다른 시스템 VPN 구성이 실행 중이라면 먼저 해당 연결 상태를 확인해 테스트 결과를 현재 설정의 결과로 오인하지 않도록 합니다.

최초 확인 단계에서는 수동 연결을 유지하는 것이 좋습니다. On Demand는 이후 필요에 따라 설정할 수 있지만, 지금 켜면 자동 재연결 조건이 추가되어 “수동으로 연결을 끊었는지” 판단하기 어려워질 수 있습니다. 4단계를 마치고 접속 결과가 예상과 일치하는지 확인한 다음 FAQ의 연결 및 On Demand 설명을 읽고 조건부 자동 연결이 필요한지 결정하세요.

Shadowrocket Home 화면. 상단에 Not Connected 스위치, Global Routing 및 Connectivity Test가 있고 아래에 SERVER와 Add Server가 표시됨
Home: 먼저 SERVER에서 항목을 선택한 다음 상단 스위치를 조작합니다. Global Routing 및 Connectivity Test도 이 화면에 있습니다.

STEP 04 / VERIFY

연결 확인, 스위치 상태만 보지 않기

스위치가 연결 상태를 유지하면 먼저 Home에서 Connectivity Test를 실행하고 선택한 항목의 테스트 결과를 확인합니다. 테스트 결과는 해당 테스트 방식에서의 연결 상태만 보여 줍니다. 모든 웹사이트의 작동이나 실제 다운로드 속도를 보장하지는 않습니다. 특정 테스트 방식에 응답이 없더라도 서버를 바로 삭제하지 말고 실제 접속 결과와 함께 판단하세요.

  1. 일반적인 접속을 확인합니다. 브라우저를 열어 평소 접속 가능한 페이지를 방문하고 기기에서 콘텐츠가 정상적으로 표시되는지 확인합니다. 일반 페이지도 열리지 않으면 규칙 문제를 살펴보기 전에 Wi-Fi 또는 셀룰러 네트워크에 로그인이 필요한지 확인하세요.
  2. 프록시를 거쳐야 하는 대상을 확인합니다. 프록시 연결이 필요한 것으로 알고 있고 서비스가 정상 작동하는 대상 하나를 선택해 페이지를 새로고침한 뒤 로딩을 기다립니다. Config에서 일반 페이지는 Direct로 접속될 수 있으므로 일반 페이지가 열리는 것만으로 프록시 경로가 작동한다고 판단할 수 없습니다.
  3. 필요하면 모드를 비교합니다. 같은 서버, 같은 네트워크 및 같은 대상을 유지한 채 Proxy와 Config를 잠시 전환합니다. 모드만 바꿔야 서버와 네트워크까지 함께 변경했을 때 원인을 구분하기 어렵지 않습니다.
  4. 평소 설정으로 되돌립니다. 테스트가 끝나면 장기간 사용할 모드로 돌아갑니다. 연결을 끊으려면 Home 상단 스위치를 끄고 상태 변화를 확인하세요. Direct를 연결 종료로 사용하지 마세요.

브라우저는 정상인데 특정 앱만 작동하지 않는다면 앱 자체의 서비스 상태, 연결 캐시 및 실제 요청 대상을 확인하세요. 해당 앱의 현재 작업을 종료한 다음 다시 열어 시도할 수 있지만 Shadowrocket을 먼저 재설치할 필요는 없습니다. 인증서 경고가 표시되어도 HTTPS Decryption을 켜서 “고쳐 보려” 하지 마세요. 최초 연결 확인에는 이 설정이 필요하지 않습니다.

이 단계가 끝나면 “가져오기 성공”, “시스템 연결 수립” 및 “대상 접속 성공”을 구분할 수 있습니다. 이후 문제가 생기면 단순히 “연결이 안 된다”고 설명하기보다 어느 단계에서 실패했는지 먼저 확인하는 편이 원인을 좁히기 쉽습니다.

STEP 05 / TROUBLESHOOT

자주 발생하는 문제와 확인 순서

문제를 해결할 때는 현재 구성을 유지하고 처음부터 목록을 지우지 마세요. 아래 항목을 차례대로 확인하고 하나를 수정할 때마다 Home으로 돌아와 다시 테스트합니다. 이렇게 하면 수정 효과를 확인할 수 있으며 개선되지 않았을 때 이전 값으로 되돌리기도 쉽습니다. 서비스 제공업체가 제공한 매개변수와 화면이 맞지 않으면 누락된 항목을 메모나 비밀번호 칸에 임의로 넣지 말고 먼저 Type을 확인하세요.

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

먼저 구독 다운로드 과정을 확인하세요. URL이 완전한지, 단일 서버 공유 링크를 Subscribe에 잘못 넣지 않았는지, 복사할 때 공백이나 문장 부호가 포함되지 않았는지 살펴봅니다. 그다음 로컬 네트워크에서 구독 요청을 완료할 수 있는지, 서비스 제공업체가 링크를 변경했는지 확인합니다. 구독 업데이트 실패가 기존 항목을 즉시 사용할 수 없게 만들지는 않을 수 있습니다. 확인 가능한 기존 정보는 먼저 유지하세요. 정리와 업데이트 방법은 서버 관리 매뉴얼을 참조하세요.

스위치가 원래대로 돌아가거나 연결되지 않음

먼저 시스템의 VPN 구성 추가 권한을 완료했는지 확인한 다음 Home에서 유효한 항목을 선택했는지 살펴봅니다. 앱에 표시된 구체적인 메시지를 기록하고 기기에서 다른 VPN 구성이 작동 중인지 확인하세요. 이 단계에서는 Rule을 반복해서 수정할 필요가 없습니다. 시스템 연결 자체가 수립되지 않았다면 규칙 조정으로 권한 오류를 설명하기 어렵습니다.

연결은 되었지만 테스트 시간 초과 또는 대상에 접속할 수 없음

먼저 연결을 끄고 로컬 네트워크가 작동하는지 확인한 뒤 다시 연결해 Host, Port, 인증 항목 및 TLS 관련 매개변수를 살펴봅니다. Connectivity Test 결과는 Test Method에도 영향을 받습니다. Settings에서 현재 방식을 확인한 뒤 브라우저 접속 결과와 함께 판단하세요. 테스트에 응답이 있어도 특정 페이지가 실패한다면 연결 전체가 정상이라고 단정할 수 없습니다. 반대로 테스트에 응답이 없지만 페이지에 접속할 수 있다면 테스트 방식도 계속 확인해야 합니다.

Proxy에서는 되지만 Config에서는 되지 않음

이런 비교 결과라면 현재 구성을 확인하는 편이 좋습니다. Config에서 올바른 파일을 선택했는지, Rule의 일치 순서가 예상과 맞는지, 대상 요청이 다른 정책으로 배정되었는지 살펴봅니다. 모든 DIRECT를 PROXY로 바꾸지 말고 먼저 구체적인 대상과 일치한 경로를 파악하세요. 규칙 키워드와 정책 의미는 개념 빠른 참조에서 확인하고, 자세한 구성 정리는 기본 연결이 안정된 뒤 진행합니다.

진단 기록을 남겨야 하는 경우

Settings의 Diagnostics에서 문제를 더 자세히 확인할 수 있습니다. 당시 네트워크 유형, Global Routing 모드, 선택한 서버 메모 및 실패 증상을 기록하고 필요하면 관련 오류 부분만 캡처하세요. 기록을 보낼 때 전체 구독 URL, Password, QR 코드 및 기타 인증 정보를 가립니다. 문제 설명에는 서버 정보 전체를 공개할 필요가 없습니다. 더 자세한 문제 목록은 FAQ를 참조하세요.

가져오기, 연결 및 실제 접속을 모두 확인했다면 우선 현재 설정을 유지하세요. 이후 On Demand, 구성 백업 및 구독 업데이트를 하나씩 익히고 설정을 바꿀 때마다 이전 상태로 되돌릴 수 있도록 기록합니다. 그러면 나중에 변화가 생겨도 새 설정이 원인인지 기존 연결 조건이 달라진 것인지 파악할 수 있습니다.

Shadowrocket Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 문제 해결 시 Test Method와 Diagnostics를 확인합니다. 수동 연결을 확인한 뒤 On Demand를 설정하세요.