• 공식 매뉴얼 · 시작 안내
  • 추가 → 모드 선택 → 연결 → 확인

Shadowrocket 사용법

보유한 구독이나 서버 정보로 처음 연결하는 방법을 안내합니다. 먼저 기본 연결 절차를 완료한 뒤 규칙과 자동 연결을 설정하세요.

권장 순서대로 읽으며 단계별로 확인하세요. 스크린샷은 App Store 공식 이미지입니다. 실제 화면은 기기에 설치된 앱을 기준으로 하며, 항목은 선택한 Type에 따라 달라집니다.

단계 01 · 연결 항목 준비

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

구독 링크와 개별 서버 정보는 서로 다른 입력 방식입니다. 보유한 정보에 맞는 방법을 선택하세요.

Shadowrocket을 열고 Home에서 Add Server 또는 추가 메뉴를 찾습니다. 먼저 보유한 정보의 종류를 확인하세요. 구독 링크는 여러 서버 항목을 가져오는 데 사용하고, 개별 서버 정보는 프로토콜과 연결 항목을 직접 입력해야 합니다. 구독 링크 전체를 Host에 붙여 넣거나 서버 도메인을 구독 주소로 착각하지 마세요.

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

Add Server에서 Type을 열고 Subscribe를 선택한 다음 해당 URL 항목에 보유한 구독 링크 전체를 붙여 넣습니다. 필요하면 알아보기 쉬운 메모를 입력합니다. 붙여 넣은 뒤 앞뒤 공백이나 줄바꿈이 없는지, 메신저에서 링크가 잘리지 않았는지 확인하세요. 링크의 경로와 매개변수는 하나의 주소를 구성하므로 임의로 줄이거나 수정하지 마세요.

저장한 뒤 Home으로 돌아가 항목이 불러와질 때까지 기다립니다. 업데이트가 필요하면 해당 구독의 업데이트 기능을 사용하세요. 목록에 선택 가능한 서버 항목이 표시되는지 확인해야 합니다. 구독 이름만 추가된 것으로는 충분하지 않습니다. 업데이트 후에도 목록이 비어 있다면 이 단계에서 링크와 구독 상태를 확인하세요. 연결 스위치를 반복해서 켜고 끌 필요는 없습니다. 구독의 유효 기간, 응답 내용과 이용 권한은 기존 서비스 정보를 제공한 곳에서 확인하세요.

개별 서버 정보가 있는 경우: 항목을 하나씩 입력

서버를 직접 추가할 때는 먼저 보유한 정보와 일치하는 프로토콜을 Type에서 선택한 뒤 Host, Port 및 필요한 인증 항목을 입력합니다. 예를 들어 Shadowsocks를 선택하면 Password, Method 등의 항목이 표시됩니다. 다른 프로토콜은 입력 항목이 다를 수 있으므로 같은 매개변수 구성을 그대로 적용하지 마세요. 일반적으로 Host에는 호스트 이름이나 IP 주소를, Port에는 포트 번호를 입력합니다. 그 밖의 항목은 보유한 서버 안내를 따르세요.

가져올 수 있는 QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. Import from Cloud JSON은 해당 기능의 형식에 맞는 콘텐츠에만 사용할 수 있으며, 모든 링크를 가져오는 일반 기능은 아닙니다. 가져온 뒤에도 항목을 열어 프로토콜, 주소, 포트와 인증 정보를 확인하세요. 저장하고 Home으로 돌아온 다음 SERVER 그룹에서 사용할 항목을 선택하고 다음 단계로 진행합니다.

Shadowrocket Add Server 화면: Type, Host, Port, Password, Method 항목과 Scan QR Code 및 Import from Cloud JSON 메뉴
Add Server: 먼저 Type을 선택한 뒤 해당 프로토콜에 필요한 항목을 확인합니다. 화면에 표시된 항목이 모든 프로토콜에 공통으로 적용되는 것은 아닙니다.
단계 02 · 요청 경로 선택

Global Routing: 사용할 연결 모드 선택

항목을 추가하는 것은 서버 정보를 입력한 단계일 뿐입니다. 요청을 처리하는 방식은 모드와 현재 구성에 따라 달라집니다.

Home으로 돌아가 Global Routing을 엽니다. 세 가지 모드는 Config, Proxy, Direct입니다. 선택하기 전에 규칙에 따라 평소처럼 사용할지, 선택한 서버를 확인할지, 아니면 직접 연결을 일시적으로 점검할지 정하세요. 서버 목록에 항목이 있다는 이유만으로 모든 요청이 해당 서버를 거친다고 생각하지 마세요.

Config: 현재 규칙에 따라 요청 처리

Config를 선택하면 요청이 현재 구성에 설정된 규칙에 따라 처리됩니다. 하단의 Config 페이지에서 실제로 활성화된 구성 파일을 확인합니다. 규칙을 살펴보려면 해당 파일의 편집 화면을 열고 Rule을 찾으세요. Home의 Global Routing과 이 화면은 서로 관련은 있지만 역할이 다릅니다. 전자는 구성 내용을 관리하고, 후자는 그 구성에 따라 실행할지 결정합니다.

규칙은 대체로 위에서 아래 순서로 확인되며, 일치하는 규칙의 정책이 적용됩니다. DIRECT는 직접 연결, PROXY는 프록시 정책, REJECT는 요청 거부를 의미합니다. FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. 따라서 Config에서 직접 연결 요청이 발생해도 반드시 오류는 아닙니다. 먼저 어떤 규칙에 일치했는지 확인하세요. 처음 사용할 때 General, Hosts, URL Rewrite 또는 HTTPS Decryption을 한꺼번에 수정할 필요는 없습니다. 기본 연결에 필수적인 단계가 아닙니다.

Proxy와 Direct: 요청 경로를 명확히 구분

Proxy는 프록시 경로를 사용합니다. 문제를 점검할 때 규칙에 따른 변수를 일시적으로 줄이는 데 쓸 수 있지만, 유효한 서버 정보가 있어야 합니다. 이 모드로 바꿔도 주소, 인증 정보 또는 서버 상태가 수정되지는 않습니다. Direct는 직접 연결 경로를 사용하므로 현재 네트워크에서 대상에 접속할 수 있는지 확인할 때 적합합니다. 선택한 프록시 서버가 정상이라는 증거로 사용할 수는 없습니다.

기존 구성 안내에서 Config를 사용하도록 지정했다면 해당 안내를 따르세요. 규칙이 문제의 원인인지 확인하려면 Proxy로 잠시 전환해 같은 대상을 비교한 뒤 원래 모드로 복구할 수 있습니다. 규칙을 수정하기 전에 기존 구성을 보관하세요. 이 안내에서는 복잡한 규칙을 새로 만들 필요가 없습니다. DOMAIN-SUFFIX, GEOIP 및 FINAL에 대한 자세한 내용은 규칙 분기와 문제 해결 FAQ를 확인하세요.

Shadowrocket Config 구성 파일 편집 화면: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config 편집 화면에서는 구성 내용을 확인합니다. Global Routing 모드 선택은 Home에 있으며 이 편집 화면에서 변경하지 않습니다.
단계 03 · 시스템 연결 설정

Home: 연결 스위치를 켜고 VPN 권한 허용

먼저 서버와 Global Routing을 확인한 뒤 상단 스위치를 조작하세요.

Home으로 돌아가 SERVER에서 사용할 서버가 선택되어 있는지 확인한 다음 Global Routing에 원하는 모드가 표시되는지 살펴봅니다. 앞 단계에서 정보를 가져오기만 하고 항목을 선택하지 않았다면 먼저 선택하세요. 구독 목록이 비어 있다면 1단계로 돌아가세요. 상단 스위치는 구독 업데이트 기능이 아닙니다.

화면 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에 VPN 구성을 추가할지 묻는 권한 안내가 표시될 수 있습니다. 앱이 시스템 네트워크 연결을 설정하는 데 필요한 권한입니다. 현재 작업에 따른 안내인지 확인하고 시스템 요청에 따라 허용한 뒤 기기 인증을 완료하고 Shadowrocket으로 돌아옵니다. 이 시스템 안내를 서버의 Password와 혼동하지 마세요. 기기 인증과 서버 인증은 별개의 절차입니다.

Home으로 돌아와 상단에 Not Connected가 계속 표시되는지, 연결 스위치와 상태가 연결된 채 유지되는지 확인합니다. 켠 직후 연결이 끊기면 앱이나 시스템에 표시된 안내를 기록한 다음 VPN 구성 권한과 기존 서버 정보를 확인하세요. 스위치를 빠르게 반복해서 켜고 끄면 문제 발생 순서를 파악하기 어렵습니다. 한 번 조작한 뒤 상태가 안정될 때까지 기다리세요.

iPad에서는 화면 공간과 시스템 안내 배치가 스크린샷과 다를 수 있지만 조작 순서는 항목 선택, 모드 확인, 연결, 권한 허용으로 같습니다. 시스템에 VPN 상태가 표시되면 관련 연결이 설정되었다는 뜻일 뿐, 원격 서버의 사용 가능 여부나 모든 앱 요청이 프록시를 거치는지까지 증명하지는 않습니다. 현재 설정을 그대로 두고 다음 단계에서 확인합니다.

Shadowrocket Home 화면: 상단의 Not Connected 스위치와 Global Routing, Connectivity Test, SERVER 그룹 및 Add Server 표시
Home: 연결 스위치, Global Routing, Connectivity Test는 서로 다른 확인 항목이며 서로 대신할 수 없습니다.
단계 04 · 실제 요청 확인

Connectivity Test: 테스트 후 실제 사용 환경 확인

연결 상태, 테스트 결과, 실제 접속을 나누어 확인해야 문제가 발생한 단계를 파악할 수 있습니다.

Home에서 Connectivity Test를 찾아 실행하고 먼저 결과가 표시되는지 확인합니다. 테스트 실패는 추가 점검이 필요하다는 단서이지 모든 요청이 반드시 실패한다는 뜻은 아닙니다. 테스트 성공도 현재 테스트 조건에서 응답을 받았다는 의미일 뿐, 실제 사용 확인을 대신하지 않습니다. 테스트 방식이나 대상은 평소 앱 사용 환경과 다를 수 있으므로 한 번의 결과만으로 전체 구성을 다시 만들지 마세요.

이어서 실제로 사용할 앱이나 페이지를 열고 페이지를 새로고침하거나 앞서 실패한 작업을 다시 실행해 새 요청을 보냅니다. 캐시된 콘텐츠만 보면 이번 네트워크 요청이 성공했는지 확인할 수 없습니다. 특정 대상에서만 문제가 발생하면 작업 내용과 시간을 기록하세요. 모든 대상에서 실패한다면 전체 연결과 서버 정보를 다시 확인합니다.

Config를 사용할 때는 현재 구성에 따라 요청이 어떤 경로를 거쳐야 하는지도 확인해야 합니다. 앱에서 확인 가능한 요청 기록에 DIRECT가 표시되면 먼저 해당 규칙이 의도한 결과인지 확인하세요. REJECT가 표시되면 잘못 차단하는 규칙이 있는지 점검합니다. 비교가 필요하면 잠시 Proxy로 바꿔 같은 요청을 다시 보낸 뒤 원래 모드로 복구하세요. Config와 Proxy의 결과 차이는 규칙을 점검할 근거이지, 모든 규칙을 삭제할 이유는 아닙니다.

  1. 연결 상태: Home에서 연결이 설정되어 있고 스위치가 저절로 꺼지지 않습니다.
  2. 테스트 결과 확인: Connectivity Test 결과와 사용한 테스트 방식을 기록합니다.
  3. 실제 요청 확인: 대상 페이지나 앱에서 새로운 네트워크 작업을 완료할 수 있습니다.
  4. 경로 확인: Global Routing과 규칙에 따라 정해진 경로가 사용 목적에 맞습니다.

위 항목을 모두 확인한 뒤 현재 선택을 일상 사용의 기준으로 삼으세요. 일부 항목만 충족됐다면 문제를 막연히 “연결 안 됨”이라고 기록하지 말고 “스위치가 꺼짐”, “테스트 실패, 페이지는 정상 작동”, “Proxy 정상, Config 오류”처럼 구체적으로 적으세요. 이런 기록은 다음 점검 단계를 바로 찾는 데 도움이 되고 불필요한 설정 변경도 줄여줍니다.

단계 05 · 실패 단계 파악

Settings: 순서대로 점검하고 한 번에 하나씩 변경

가장 먼저 실패한 단계부터 확인하세요. 한 번에 변수 하나만 변경하고 원래대로 되돌릴 수 있도록 구성을 보관합니다.

가져온 내용이 비어 있거나 저장 후 선택할 항목이 없는 경우

구독 설정으로 돌아가 Type이 Subscribe인지, URL이 완전한지, 업데이트가 완료됐는지 확인합니다. 응답이 안내 웹 페이지, 로그인 페이지 또는 오류 내용이라면 앱이 이를 유효한 서버 목록으로 가져올 수 없습니다. 기존 구독의 상태를 확인한 뒤 업데이트하세요. 가져오기 오류를 해결하려고 Global Routing을 바꾸지 마세요. 모드는 요청 경로를 처리할 뿐 구독 내용을 보충하지 않습니다.

스위치가 꺼지거나 연결 후 접속할 수 없는 경우

먼저 시스템 권한 문제와 서버 통신 문제를 구분하세요. 스위치가 켜진 상태로 유지되지 않으면 VPN 구성이 허용됐는지, 시스템 제한이나 구체적인 오류가 있는지 확인합니다. 스위치가 유지되지만 접속에 실패한다면 선택한 항목을 점검하세요. Type, Host, Port, 인증 정보를 하나씩 대조하고 특히 입력 과정에서 생긴 공백, Method 불일치, 누락된 프로토콜 매개변수에 주의합니다. 경험만으로 암호화 방식이나 포트를 바꾸지 말고 보유한 서버 정보와 일치시키세요.

테스트 결과와 페이지 접속 결과가 다른 경우

Settings에서 Test Method를 확인해 이번 테스트에 사용한 방식을 살펴봅니다. 테스트 방식마다 확인하는 조건이 다르므로 결과를 단순 비교하기는 어렵습니다. Home으로 돌아가 Global Routing과 현재 구성을 확인하세요. Config에서만 문제가 발생한다면 Rule, FINAL 및 관련 해석 설정을 먼저 점검합니다. DNS 설정은 고려할 사항이 많으므로 여러 DNS 옵션을 동시에 바꿔가며 시도하지 말고 Shadowrocket DNS 설정 및 연결 문제 안내를 먼저 확인하세요.

기본 연결을 확인한 뒤 On Demand 설정

On Demand는 지정한 조건에 따라 연결을 시작하는 기능이며 잘못된 서버 정보를 고치지는 않습니다. 처음 문제를 점검할 때는 수동 스위치를 사용하세요. 자동 연결이 실행되면 앱이 연결 해제 상태를 저장하지 않는다고 오해할 수 있습니다. 기본 연결을 확인한 다음 Settings의 On Demand에서 필요한 조건을 설정하고 실제로 작동하는지 테스트하세요. Proxy, TCP, UDP 등의 설정도 명확한 필요가 있을 때 변경하고 모든 옵션을 한꺼번에 켜지 마세요.

원인을 찾기 어렵다면 Diagnostics에서 확인 가능한 진단 정보를 살펴보고 실패 단계, 당시 모드와 구체적인 오류를 기록하세요. 기록을 공유하기 전에 구독 링크, 인증 정보와 기타 민감한 내용을 삭제합니다. 구매, 시스템 요구 사항 및 구매 항목 복원에 대한 자세한 안내는 App Store 설치 안내를, 연결 및 규칙 관련 내용은 FAQ를 확인하세요.

Shadowrocket Settings 화면: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 설정 표시
Settings: 먼저 Test Method와 Diagnostics를 확인하고, On Demand는 수동 연결 확인을 마친 뒤 설정합니다.