공식 매뉴얼 · 시작 가이드

Shadowrocket 사용법

기존 정보를 가져온 다음 Global Routing을 선택하고, 마지막으로 연결과 요청을 확인합니다. 다섯 가지 질문에 따라 진행하면 모든 설정을 한꺼번에 바꾸지 않아도 됩니다.

진행 순서: 구독 링크가 있으면 Subscribe를 사용하고, 개별 서버 정보가 있으면 직접 추가합니다. 두 방법 중 하나를 완료한 뒤 동일한 연결 확인 단계로 넘어가면 됩니다.

Q1 / IMPORT

서버 정보는 어디에 입력하나요?

Home에서 Add Server를 엽니다. 구독과 직접 추가는 서로 다른 입력 방식입니다.

먼저 보유한 정보의 유형을 확인한 다음 Add Server로 이동합니다. 서버 목록을 업데이트하는 데 사용하는 주소는 구독 링크입니다. Host, Port, Password 등의 항목만 있는 정보는 프로토콜에 맞춰 직접 입력해야 합니다. 구독 링크를 Host에 입력하거나 단일 서버 공유 내용을 구독 주소로 사용하지 마세요. 정보의 용도가 불분명하면 본인의 서비스 제공업체에 형식을 문의해 관련 없는 Type을 반복해서 시도하지 않도록 합니다.

기존 구독: Subscribe 선택

Shadowrocket을 열고 Home 하단의 SERVER 영역에서 Add Server를 찾거나 화면의 추가 메뉴를 통해 Add Server로 이동합니다. Type을 열고 목록에서 Subscribe를 선택한 뒤 본인의 전체 구독 링크를 해당 URL 항목에 입력합니다. 구독 주소에는 인증 정보가 포함될 수 있으므로 복사할 때 매개변수를 빠짐없이 유지하고, 앞뒤 공백이나 줄바꿈, 채팅 문구가 섞이지 않게 합니다.

  1. 주소가 본인의 서비스 제공업체에서 받은 것인지, 계정 관리 페이지가 아닌 구독 주소인지 확인합니다.
  2. 화면 안내에 따라 구독을 저장합니다. Home으로 돌아간 후 결과가 표시될 때까지 기다리고, 필요한 경우 해당 구독 항목의 업데이트 기능을 사용합니다.
  3. 반환된 그룹을 펼쳐 선택 가능한 서버 항목이 있는지 확인합니다. 구독 이름만 있고 실제 항목이 없다면 먼저 업데이트 문제를 해결해야 합니다.

구독을 가져오면 원격 콘텐츠를 읽어오며, 앱의 모든 설정이 한꺼번에 교체되는 것은 아닙니다. 가져온 뒤 SERVER 목록이 제대로 표시되는지 확인하고 다음 단계로 진행합니다. 주소 업데이트에 실패하더라도 앱을 바로 다시 구매하지 마세요. 링크가 유효한지, 기본 네트워크를 사용할 수 있는지, 본인의 서비스가 계속 이용 가능한지 먼저 확인합니다.

단일 서버 정보: Type에 맞게 입력

Home에서 다시 Add Server로 이동해 원본 정보와 일치하는 Type을 선택한 다음 항목을 하나씩 입력합니다. 화면에 Host, Port, Password, Method가 표시된다면 Host에는 서버 주소, Port에는 제공된 포트, Password와 Method에는 각각 인증 정보와 암호화 방식을 입력합니다. Type마다 표시되는 항목이 다르므로 한 프로토콜의 필드 순서를 다른 프로토콜에 그대로 적용하면 안 됩니다.

저장 전에 대소문자, 포트 및 인증 정보를 한 글자씩 확인합니다. 정보에 TLS, SNI 또는 전송 설정이 따로 지정되어 있다면 원본 안내에 따라 입력합니다. 시험 삼아 프로토콜이나 암호화 방식을 임의로 바꾸지 마세요. 정보가 QR 코드로 제공되면 Scan QR Code를 사용할 수 있습니다. Import from Cloud JSON은 별도의 가져오기 방법이므로 보유한 정보가 해당 형식일 때만 사용합니다. 이 안내를 진행하기 위해 추가로 설정할 필요는 없습니다.

정보를 입력한 다음에는 DNS를 바꾸거나 고급 옵션을 켜기보다 Global Routing이 요청을 처리하는 방식을 확인합니다. 이를 통해 “서버 자체를 사용할 수 없는 경우”와 “규칙이 다른 정책을 선택한 경우”를 구분할 수 있습니다.

Shadowrocket Add Server 공식 화면. Type, Host, Port, Password, Method와 Scan QR Code, Import from Cloud JSON 표시
Add Server: Type을 먼저 선택한 다음 보유한 정보에 맞는 항목을 입력합니다.
Q2 / ROUTING

Global Routing에서 어떤 모드를 선택하나요?

일상적인 규칙 기반 처리는 Config를 사용하고, Proxy와 Direct는 비교 확인에 활용할 수 있습니다.

Global Routing은 요청을 처리할 방식을 정하며 서버 정보를 보완하는 기능은 아닙니다. Home으로 돌아가 Global Routing을 열고 현재 선택된 항목을 확인합니다. Config, Proxy, Direct는 각각 설정에 따른 라우팅, 프록시 경로 사용, 직접 연결을 의미합니다. 모드를 선택한 뒤 Home으로 돌아가 다음 작업을 진행합니다. 모드 이름과 Config 하단 페이지를 혼동하지 마세요. 전자는 처리 방식을 선택하고 후자는 구성 파일을 관리합니다.

모드시작 단계에서의 사용판단 시 유의점
Config신뢰할 수 있는 설정이 있다면 규칙 라우팅을 확인합니다.현재 설정 내용과 매칭 순서에 따라 결과가 달라집니다.
Proxy선택한 프록시 연결을 별도로 확인할 때 사용합니다.연결 가능성을 보장하지 않으므로 실제 요청을 확인해야 합니다.
Direct기본 네트워크와 비교할 때 사용합니다.페이지가 열려도 선택한 프록시를 거쳤다는 뜻은 아닙니다.

Config: 현재 설정부터 확인

Config로 전환해 현재 사용 중인 구성 파일을 확인한 다음 보기 또는 편집 화면으로 이동합니다. 공식 화면의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 서로 다른 설정 구간입니다. 처음 사용하는 경우 위치만 확인하고 각 항목을 모두 열거나 변경할 필요는 없습니다. Rule에서 규칙을 확인할 수 있으며 Add Rule은 규칙을 추가할 때 사용합니다. 구독의 서버 목록과 이곳의 규칙 파일은 용도가 다릅니다. 서버 목록을 업데이트해도 규칙 파일이 원하는 방식으로 설정되는 것은 아닙니다.

규칙은 보통 순서대로 매칭되며 먼저 일치한 조건이 적용할 정책을 결정합니다. 더 구체적인 도메인 조건은 적절한 위치에 배치해야 하며, FINAL은 앞선 조건과 일치하지 않은 요청을 처리합니다. 아래는 규칙 문법의 예시일 뿐, 기존 설정을 통째로 덮어쓰라는 권장 목록이 아닙니다. PROXY가 유효한 정책으로 작동하는지는 현재 설정의 정의를 확인해야 합니다.

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

DIRECT는 직접 연결, REJECT는 요청 거부를 의미하며, PROXY는 설정에 정의된 프록시 정책을 가리킵니다. 도메인과 일치하는 규칙이 없으면 요청은 다음 조건으로 넘어갈 수 있습니다. 따라서 “목록에 도메인을 적었다”는 사실만으로 “실제로 해당 규칙이 적용된다”고 단정할 수 없습니다. 문제를 확인할 때 규칙 위치, 정책 이름과 요청 기록을 함께 살펴보고 한 줄의 텍스트만 확인하지 마세요.

설명을 이해할 수 있는 설정만 유지

설정 내용을 아직 확인하지 못했다면 Proxy로 등록된 서버를 먼저 확인한 다음 Config로 돌아가 차이를 살펴볼 수 있습니다. 규칙 추가, Hosts 수정, HTTPS Decryption 활성화를 동시에 하지 마세요. 여러 변수를 한꺼번에 바꾸면 어느 단계에서 변화가 발생했는지 판단하기 어렵습니다. 비교를 마친 후 일상적인 사용에 맞는 모드로 복원합니다. 구성 파일 관리와 규칙에 대한 자세한 내용은 이 페이지의 문제 해결 단계에서 먼저 상황을 확인한 뒤 해당 주제의 공식 매뉴얼을 참고하세요.

Shadowrocket Config 구성 파일 편집 공식 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config: 구성 파일의 Rule과 Home의 Global Routing을 함께 확인합니다.
Q3 / CONNECT

VPN 연결은 어떻게 켜나요?

서버를 선택한 뒤 Home 상단의 스위치를 켭니다. 처음 연결할 때는 시스템 권한 안내를 처리해야 합니다.

Home에서 실제 서버를 선택한 다음 상단의 Not Connected에 해당하는 스위치를 켭니다.먼저 SERVER에서 방금 확인한 항목이 선택되었는지 확인합니다. 구독 그룹 이름만 선택된 상태여서는 안 됩니다. Global Routing이 앞서 준비한 테스트 모드인지도 확인합니다. 화면의 Not Connected는 캡처 당시 연결되지 않은 상태를 나타내며 직접 입력할 설정값이 아닙니다.

  1. Home으로 돌아가 SERVER 목록에서 테스트할 서버를 선택합니다. 정보가 많다면 매개변수를 확인한 항목 하나만 선택합니다.
  2. Home 상단의 연결 스위치를 켜고 VPN 설정 추가를 묻는 시스템 안내가 표시되는지 확인합니다.
  3. 안내에 표시된 앱이 Shadowrocket인지 확인한 뒤 추가를 허용합니다. 시스템 요구에 따라 기기 인증을 마치고 앱으로 돌아갑니다.
  4. 연결 상태가 유지되는지 확인합니다. 스위치가 바로 원래 상태로 돌아오면 안내 문구를 기록하고 빠르게 반복해서 켜고 끄지 마세요.

VPN 설정 추가 허용은 기기에서 VPN 연결을 만들기 위한 시스템 절차입니다. 구독이나 인증 정보를 만들어 주는 기능은 아닙니다. 처음 안내에서 취소를 눌렀다면 연결 스위치를 다시 켜고 실제로 표시되는 안내에 따라 진행하면 됩니다. 안내가 다시 나타나지 않으면 시스템 설정의 VPN 관리 화면에서 구성 상태를 확인합니다. 기기 관리 정책으로 제한된 경우 기기 관리자에게 권한을 문의해야 합니다. 서버 암호를 바꿔 시스템 권한 문제를 해결할 수는 없습니다.

먼저 수동 연결로 기준 상태 확인

첫 테스트에서는 연결을 수동으로 켜고 끄며 On Demand를 서둘러 활성화하지 않는 것이 좋습니다. On Demand는 설정한 조건에 따라 연결을 시작하며, 기본 연결을 확인한 뒤 설정하는 기능입니다. 조건을 이해하지 못한 상태에서 사용하면 수동으로 연결을 끈 후에도 다시 연결되어 스위치 오류로 오해할 수 있습니다. 다른 VPN 연결을 사용 중이라면 실제로 활성화된 구성을 확인해 해당 연결의 상태를 Shadowrocket의 결과로 착각하지 않도록 합니다.

이 단계의 완료 기준은 시스템이 구성을 허용하고 앱에 연결이 설정된 것으로 표시되는 것입니다. 다만 이는 기기의 연결 절차가 완료되었다는 뜻일 뿐 원격 서버를 사용할 수 있다는 증거는 아닙니다. 다음 단계에서 실제 요청을 확인합니다. 연결이 유지되지 않으면 문제 해결로 이동해 권한과 항목 매개변수를 먼저 확인합니다.

Shadowrocket Home 공식 화면. 상단에 Not Connected 스위치, 중앙에 Global Routing과 Connectivity Test, 하단에 SERVER와 Add Server 표시
Home: SERVER와 Global Routing을 확인한 뒤 상단 연결 스위치를 조작합니다.
Q4 / VERIFY

연결이 적용되었는지 어떻게 확인하나요?

시스템 상태, Connectivity Test, 실제 접속을 각각 확인합니다. 하나의 결과만으로 전체를 판단하지 마세요.

연결 설정 여부, 서버 응답 여부, 요청에 올바른 정책이 적용되었는지는 서로 다른 문제입니다.먼저 연결을 끈 상태에서 Wi-Fi 또는 셀룰러 네트워크가 작동하는지 확인한 다음 Shadowrocket 연결을 켜고 평소 사용하는 웹 페이지에 접속합니다. 기본 네트워크의 로그인 인증을 완료하지 않았거나 기기 자체가 인터넷에 연결되지 않았다면 먼저 해당 문제를 해결한 뒤 앱을 확인합니다.

항목을 테스트한 뒤 실제 요청 확인

Home에서 Connectivity Test를 실행해 현재 서버의 테스트 결과를 확인합니다. 테스트 방법은 Settings의 Test Method 등의 설정에 영향을 받습니다. 테스트를 완료했다고 모든 웹사이트와 앱에 접속할 수 있는 것은 아니며, 테스트 실패만으로 구독 주소가 유효하지 않다고 단정할 수도 없습니다. 테스트 후 모든 매개변수를 즉시 바꾸지 말고 동일한 서버의 테스트 결과와 실제 접속 상태를 함께 살펴봅니다.

이어서 익숙한 페이지를 열고 캐시된 화면만 표시되는 것이 아니라 로딩이 완료되는지 확인합니다. 새 요청을 확인해야 한다면 페이지를 다시 불러온 다음 Data에서 해당 동작의 기록을 살펴봅니다. 앱에 표시되는 내용을 기준으로 대상 도메인과 확인 가능한 정책 정보를 확인합니다. 기록에 특정 필드가 표시되지 않는다면 연결 아이콘만으로 구체적인 규칙이 적용되었다고 추측하지 마세요.

모드를 비교해 범위 좁히기

Proxy에서는 접속되지만 Config에서 실패한다면 서버를 바로 삭제하지 말고 현재 설정과 Rule을 먼저 확인합니다. Direct에서는 접속되지만 Proxy에서 실패한다면 선택한 서버와 서비스 상태를 확인합니다. 매번 조건 하나만 바꾸고 서버, 대상 페이지 및 네트워크 환경을 최대한 동일하게 유지해야 테스트 결과를 비교할 수 있습니다.

  • 시스템 단계: 연결 스위치가 유지되고 시스템 VPN 구성이 해당 상태로 표시됩니다.
  • 연결 단계: 선택한 서버 테스트가 완료되거나 실제 요청이 서버를 통해 처리됩니다.
  • 규칙 단계: Config의 요청 기록이 예상한 정책과 일치합니다.

브라우저에 표시되는 외부 IP 주소는 해당 요청만 반영하며 모든 앱이 같은 경로를 사용한다는 뜻은 아닙니다. 도메인마다 다른 규칙이 적용될 수 있고 한 페이지에서 여러 리소스를 요청할 수도 있습니다. 이미지나 특정 기능만 실패한다면 해당 대상의 기록을 유지해 다음 단계에서 확인합니다. 일부 실패를 “전부 연결할 수 없음”으로 일반화하지 마세요.

Q5 / DIAGNOSE

연결 실패는 어느 단계부터 확인하나요?

발생한 단계에 따라 확인하고 원래 설정을 유지한 채 조건을 하나씩 변경합니다.

먼저 실패한 단계를 찾고 관련 설정을 확인합니다. Settings의 Language, Test Method, On Demand, Diagnostics, Proxy, TCP, UDP는 각각 용도가 다르므로 문제 해결을 위해 모두 변경할 필요는 없습니다. 현재 설정을 복사하거나 원래 값을 기록한 뒤 목적에 맞게 확인합니다. 내보낸 구성에도 인증 정보가 포함될 수 있으므로 본인이 안전하게 보관해야 합니다.

구독 업데이트 실패: 링크와 기본 네트워크 확인

Subscribe를 저장한 뒤 실제 항목이 표시되지 않는다면 전체 URL이 잘렸는지, 계정 페이지를 잘못 복사했는지, 링크가 아직 유효한지 확인합니다. 연결을 끈 상태에서 기기가 인터넷에 정상적으로 접속되는지 확인한 다음 다시 한 번 업데이트하고 구체적인 오류를 기록합니다. 인증 또는 서비스 상태에 관한 문제는 본인의 서비스 제공업체에 문의하세요. 인증 정보가 포함된 전체 링크를 공개 질문 게시판에 올리지 말고, 구독을 가져오지 않은 상태를 Global Routing 변경으로 감추려 하지 마세요.

항목은 표시되지만 연결 실패: 정보 재확인

해당 항목의 편집 화면을 열고 원본 정보를 기준으로 Type, Host, Port 및 인증 항목을 확인한 다음 프로토콜에 필요한 전송 매개변수도 확인합니다. 구독으로 관리되는 항목은 먼저 업데이트한 뒤 테스트합니다. 직접 수정한 내용이 다음 업데이트에서 덮어써질 수 있습니다. 같은 네트워크에서 모든 항목이 실패한다면 사용 권한이 있는 다른 네트워크에서 비교해 봅니다. 한 항목만 실패한다면 해당 항목과 원격 서비스 상태를 집중적으로 확인합니다.

스위치가 바로 꺼짐: 권한과 시스템 안내 확인

시스템에서 VPN 설정 추가를 허용했는지, 다른 VPN 구성이 현재 사용 중인지 확인합니다. 앱이나 시스템에 표시된 오류 문구를 기록한 다음 Settings에서 Diagnostics가 제공하는 진단 정보를 확인합니다. 진단 정보에는 도메인, 주소 및 요청 기록이 포함될 수 있으므로 관련 지원 담당자에게 전달하기 전에 민감한 내용을 가립니다. 시스템 권한 실패와 서버 인증 실패는 서로 다른 단계입니다. Method를 반복해서 바꾸는 것으로 권한 문제를 대신 해결할 수 없습니다.

VPN 연결 후 웹 페이지가 열리지 않음: 모드와 요청 확인

Global Routing으로 돌아가 이 페이지의 확인 절차에 따라 Config와 Proxy를 각각 비교합니다. Config에서만 실패한다면 Rule 순서, 정책 참조 및 최종 처리 규칙을 확인합니다. 모든 프록시 요청이 실패한다면 서버를 우선 확인합니다. 도메인 관련 요청에 문제가 있다면 표시되는 기록을 바탕으로 이름 해석 설정을 확인합니다. 페이지 오류가 나타났다고 바로 Hosts를 모두 지우고 DNS를 바꾸거나 구성을 초기화하지 마세요. 비교 기준을 잃게 됩니다.

테스트와 앱 동작 결과가 다름: Test Method 확인

Settings에서 Test Method를 확인해 현재 테스트가 어떤 연결 조건을 측정하는지 파악합니다. 일부 서비스는 UDP에 의존하므로 일반 웹 페이지가 열린다고 관련 서비스까지 사용할 수 있는 것은 아닙니다. 마찬가지로 특정 테스트에 실패해도 TCP 웹 요청이 모두 실패한다는 뜻은 아닙니다. 서버 기능, 현재 설정 및 실제 서비스에 맞춰 Proxy, TCP, UDP 관련 옵션을 각각 확인하고 사용 중인 프로토콜과 관계없는 매개변수를 그대로 적용하지 마세요.

연결을 끈 뒤 다시 자동 연결됨: On Demand 확인

수동으로 연결을 껐는데 다시 연결된다면 Settings의 On Demand가 활성화되어 있는지, 현재 조건이 연결을 다시 시작하는지 확인합니다. 자동 연결을 일시 중지한 뒤 수동으로 테스트하면 자동 연결 동작과 네트워크 문제를 구분하는 데 도움이 됩니다. 기본 연결이 안정된 후 본인에게 필요한 조건으로 On Demand를 다시 설정합니다. 시작 단계의 테스트에 아직 이해하지 못한 자동화 설정을 유지할 필요는 없습니다.

원인을 찾기 어렵다면 “어느 단계에서 실패했는지, 어떤 모드를 사용했는지, 오류 문구, 특정 서버 하나에만 영향을 주는지, 네트워크 변경 후에도 같은지”를 정리합니다. 계정 또는 스토어에서 앱을 받는 문제는 앱 이용 가이드에서 확인하고, 설치 경로를 다시 확인해야 한다면 앱 다운로드 페이지로 이동합니다. 처음부터 모든 항목을 삭제하거나 앱을 제거하면 비교에 필요한 정보를 잃을 수 있습니다.

Shadowrocket Settings 공식 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 실패 단계에 맞는 항목을 선택하고 원래 값을 기록한 뒤 하나씩 비교합니다.