공식 매뉴얼 · 최초 설정

Shadowrocket 사용 가이드
구독 가져오기 및 연결 확인

추가, 모드 선택, 연결, 확인, 문제 해결 순서로 진행합니다. 재현 가능한 연결을 먼저 확인한 뒤 규칙과 주문형 연결 설정을 조정합니다.

STEP 01 / ADD SERVER

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

먼저 보유한 정보의 종류를 확인합니다. Host, Port, Password 등의 필드가 포함된 정보는 단일 서버 정보이고, 여러 서버 정보를 갱신할 수 있는 주소는 구독 링크입니다. 링크 길이만으로 둘을 구분할 수 없으며, 서비스 제공업체의 로그인 페이지 주소를 구독 주소로 사용해서도 안 됩니다. 기존 서비스 제공업체가 제공한 구성 안내에서 가져오기 유형을 확인한 다음 Shadowrocket에서 작업하세요.

단일 서버: Type 및 필드 확인

Home을 열고 오른쪽 위 추가 메뉴 또는 목록의 Add Server를 탭합니다. 화면이 열리면 먼저 Type을 탭하고 기존 서버와 동일한 프로토콜을 선택한 뒤 Host, Port 및 필요한 인증 필드를 하나씩 입력합니다. 오른쪽 공식 스크린샷에는 Password와 Method가 포함된 양식이 표시됩니다. Type에 따라 필드가 달라지므로 스크린샷과 맞추기 위해 프로토콜을 변경하지 마세요.

Host에는 보통 서버 도메인이나 IP 주소만 입력하며 웹 페이지 경로는 포함하지 않습니다. Port에는 서비스 제공업체가 안내한 포트 번호를 입력합니다. 비밀번호의 대소문자, Method 및 프로토콜에 필요한 TLS, 서버 이름 등의 매개변수를 일치시켜야 합니다. 제공되지 않은 필드가 있으면 다른 사람의 구성을 참고해 추측하지 말고 서비스 제공업체의 안내를 확인하세요. 입력을 마친 뒤 화면의 저장 또는 완료 버튼을 사용하고 Home으로 돌아와 SERVER 그룹에 새 항목이 표시되는지 확인합니다.

구독: Subscribe를 선택한 뒤 저장

구독 링크를 보유하고 있다면 Add Server의 Type에서 Subscribe를 선택하고 전체 주소를 해당 URL 필드에 붙여넣은 뒤 저장합니다. 복사할 때 주소 끝의 모든 매개변수를 포함하고 앞뒤 공백과 의도치 않은 줄바꿈은 제거하되, 물음표 뒤의 내용을 임의로 삭제하지 마세요. 구독 주소에는 인증 정보가 포함될 수 있으므로 전체 주소를 공개 스크린샷이나 문제 해결 기록에 붙여넣지 마세요.

저장한 뒤 Home으로 돌아와 구독 내용이 불러와질 때까지 기다립니다. 갱신하려면 해당 구독 항목의 업데이트 기능을 사용합니다. 구독 그룹 이름만 저장된 것이 아니라 그 아래에 실제 서버가 표시되는지 확인하세요. 목록이 계속 비어 있다면 연결 스위치를 반복해서 켜기보다 일반적인 실패 원인으로 이동해 주소를 확인하세요. 선택할 서버가 없을 때 모드를 전환해도 구독 내용이 채워지지 않습니다.

기존 구성이 QR 코드로 제공된 경우 Add Server에서 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 접근을 허용한 다음 인식된 내용을 확인하고 저장합니다. Import from Cloud JSON은 해당 형식의 구성에 사용하며, 임의의 구독 주소를 가져오는 일반적인 메뉴가 아닙니다. 완료한 뒤 항목 하나를 선택하고 다음 단계에서 Global Routing을 설정합니다.

Shadowrocket Add Server 화면에 표시된 Type, Host, Port, Password, Method 및 Scan QR Code 메뉴
Add Server: 먼저 Type을 선택하고 해당 프로토콜에 필요한 필드를 입력합니다.

STEP 02 / GLOBAL ROUTING

Global Routing 모드 선택

서버는 연결할 대상을 결정하고 Global Routing은 요청 처리 방식을 결정하므로 각각 확인해야 합니다. Home으로 돌아와 Global Routing을 탭하고 현재 선택된 항목을 확인합니다. 세 가지 모드는 Config / Proxy / Direct입니다. 여기서는 라우팅 방식을 선택하며 서버 연결 테스트를 실행하는 것이 아닙니다. 특정 모드를 선택한다고 서버 매개변수가 자동으로 수정되는 것도 아닙니다.

Config: 현재 규칙 사용

일상적으로 규칙에 따라 트래픽을 분기하려면 Config를 선택합니다. 앱은 현재 구성의 규칙에 따라 요청을 처리합니다. 규칙의 PROXY, DIRECT, REJECT는 각각 프록시, 직접 연결, 거부 정책을 의미합니다. 하단의 Config를 열어 실제로 선택된 구성 파일을 확인합니다. 파일을 열면 공식 스크린샷에 표시된 General, Rule, Hosts 등의 섹션을 볼 수 있습니다. 구독을 가져오면 서버 항목은 갱신되지만 여기에서 구성 파일이 전환되는 것은 아닙니다.

서비스 제공업체가 사용 목적에 맞는 완성된 구성을 제공했다면 안내에 따라 내용을 확인하고 선택하세요. 최초 연결 전에 DNS, Rule 및 기타 고급 설정을 동시에 변경하지 마세요. 일반적으로 구성의 구체적인 규칙은 기본 규칙보다 앞에 배치해야 합니다. 아래 조각은 일치 순서를 설명하기 위한 예시일 뿐, 전체 구성 파일로 붙여넣을 내용이 아닙니다.

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

Proxy 및 Direct: 비교에 사용

Proxy는 일반적으로 해당 모드에서 처리되는 요청을 선택한 프록시로 보내며, Config의 규칙과 관련된 문제인지 임시로 확인할 때 사용할 수 있습니다. Direct는 직접 연결 경로를 사용하므로 로컬 네트워크가 작동하는지 비교할 때 적합합니다. 어느 쪽도 항상 더 빠른 고정 옵션은 아닙니다. 접속 결과는 대상 서비스, 서버 상태, 현재 네트워크에 따라 달라집니다. Direct에서 페이지가 열린다고 해서 프록시 서버가 작동 중이라고 판단하지 마세요.

이 가이드에서는 현재 구성을 명확히 보존하고 Config를 일상적인 시작점으로 사용할 것을 권장합니다. 나중에 Proxy와 Config를 비교할 경우 이 항목만 변경하고 동일한 테스트를 반복한 뒤 원래 모드로 복원하세요. 규칙 일치, FINAL 및 DNS에 대한 자세한 점검은 문제 해결 매뉴얼을 참조하세요. 이제 Home으로 돌아와 서버를 선택하고 연결합니다.

Shadowrocket Config 구성 파일 편집 화면에 표시된 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule
Config 파일 편집 화면에서는 규칙 내용을 관리합니다. Global Routing 모드 선택은 Home에 있습니다.

STEP 03 / CONNECT

항목을 선택하고 연결 스위치 켜기

Home으로 돌아와 SERVER 그룹에서 사용할 서버를 탭하고 선택 표시가 대상 항목에 있는지 확인합니다. 구독에 서버가 여러 개 포함될 수 있으므로 항목을 추가하거나 갱신한 뒤에는 실제 선택 항목을 다시 확인해야 합니다. 첫 테스트에서는 항목 하나만 선택하세요. 테스트 중 여러 항목을 연이어 바꾸면 결과가 서버 변경 때문인지 설정 변경 때문인지 구분하기 어렵습니다.

Global Routing이 방금 선택한 모드인지 확인한 다음 Home 상단의 연결 스위치를 켭니다. 공식 스크린샷에는 연결 전의 Not Connected 상태가 표시되어 있습니다. 처음 연결할 때 시스템에서 VPN 구성 추가를 허용할지 물을 수 있습니다. 요청한 앱이 Shadowrocket인지 확인하고 시스템 안내에 따라 승인한 뒤, 필요하면 기기 암호 또는 시스템 인증을 사용해 권한을 완료합니다. 권한을 거부하면 앱이 해당 구성에 따라 시스템 연결을 설정할 수 없습니다.

승인 후 Home으로 돌아와 스위치와 연결 상태가 유지되는지 확인합니다. 시스템 상태 영역의 VPN 표시는 시스템 연결 상태를 확인하는 데 도움이 될 수 있지만, 기기, 표시 영역, 시스템 버전에 따라 표현 방식이 다를 수 있습니다. 특정 위치에 아이콘이 있는지 여부만으로 모든 요청의 경로를 판단할 수는 없습니다. VPN 구성이 활성화되어도 원격 서버에 반드시 접속할 수 있는 것은 아니므로 다음 단계에서 실제로 확인해야 합니다.

스위치를 켠 직후 다시 꺼지면 시스템 알림이 표시되었는지 먼저 기록하고, 시스템 VPN 설정에 현재 구성이 있는지, 다른 VPN 연결이 사용 중인지 확인합니다. 권한 요청을 계속 반복하거나 모든 구성을 바로 삭제하지 마세요. 조직에서 관리하는 기기는 VPN 구성이 제한될 수 있으므로 기기 관리 규정을 따르고 제한을 우회하려고 하지 마세요.

첫 테스트 중에는 네트워크 환경을 그대로 유지하세요. 연결 중에 Wi-Fi와 셀룰러 네트워크를 동시에 전환하지 말고 On Demand도 조정하지 마세요. 연결을 중지하려면 Home으로 돌아와 스위치를 끕니다. 이후 연결이 다시 시작된다면 Settings에서 On Demand 조건을 확인하세요. 다음 단계의 결과를 비교할 수 있도록 “같은 네트워크, 같은 항목, 같은 모드”를 기준으로 유지합니다.

Shadowrocket Home 화면 상단의 Not Connected 스위치, Global Routing, Connectivity Test와 아래쪽 SERVER 및 Add Server
Home: 선택한 서버와 Global Routing을 확인한 다음 상단 연결 스위치를 조작합니다.

STEP 04 / VERIFY

연결 및 규칙 적용 여부 확인

먼저 Home에서 Connectivity Test를 탭하고 테스트가 끝날 때까지 기다린 뒤 선택한 서버의 결과를 확인합니다. 테스트 실패 또는 시간 초과는 현재 테스트에서 예상한 통신을 완료하지 못했다는 뜻이므로 네트워크와 서버를 먼저 확인해야 합니다. 결과가 표시되면 해당 테스트 방식이 응답을 받은 것입니다. 모든 웹사이트, 모든 프로토콜 또는 모든 앱 요청을 사용할 수 있다는 뜻은 아니며 Config의 모든 규칙이 예상대로 적용되었음을 단독으로 증명하지도 않습니다.

실제 요청으로 다시 확인

연결을 유지한 상태에서 브라우저로 평소 익숙하고 내용이 명확한 페이지를 연 다음, 실제로 사용하려는 대상 페이지도 확인합니다. 이미 저장된 캐시를 새 요청의 성공으로 오인하지 않도록 새 페이지를 여세요. 특정 앱만 이상하다면 브라우저 접속 결과와 비교하고 바로 전체 연결 문제로 단정하지 마세요. 앱의 로그인 상태나 원격 서비스의 장애도 화면 표시 결과에 영향을 줄 수 있습니다.

트래픽 분기를 확인하려면 클라이언트에서 사용할 수 있는 연결 또는 진단 기록을 열고 대상 도메인, 일치한 규칙 및 실행 정책을 함께 확인합니다. Data의 트래픽 변화는 요청이 클라이언트를 통과했는지 파악하는 보조 단서가 될 수 있지만, 트래픽이 증가했다고 해서 대상이 반드시 PROXY를 사용했다는 뜻은 아닙니다. 실제 정책과 함께 확인해야 합니다. 로컬 네트워크 요청이 규칙에 따라 DIRECT로 처리되는 경우 직접 연결 결과 자체는 오류가 아닙니다.

한 번에 하나의 변수만 비교

Proxy에서는 접속되지만 Config에서는 실패한다면 서버를 그대로 두고 현재 Config의 규칙과 DNS를 우선 확인합니다. 둘 다 실패하면 서버 매개변수, 서비스 유효 상태 및 현재 네트워크를 먼저 확인합니다. Direct에서도 일반 페이지에 접속할 수 없다면 로컬 네트워크를 복구한 뒤 프록시를 다시 테스트합니다. 비교 결과는 문제 범위를 좁히기 위한 것이며 특정 설정이 반드시 잘못되었다고 단정할 근거는 아닙니다.

이번에 사용한 네트워크 유형, 서버 표시 이름, Global Routing 모드 및 구체적인 실패 현상만 기록하세요. 전체 구독 주소, 비밀번호 또는 인증 매개변수는 기록하지 마세요. 자주 사용하는 페이지와 예상한 트래픽 분기가 모두 작동하는지 확인한 뒤 On Demand 등의 일상 설정을 하나씩 복원합니다. 각 항목을 복원할 때마다 다시 테스트하면 조건 변경으로 인한 영향을 파악하기 쉽습니다.

STEP 05 / SETTINGS

증상에 따라 일반적인 실패 원인 점검

문제 해결은 로컬 네트워크를 먼저 확인하고 가져온 내용과 서버를 점검한 다음 규칙과 추가 설정을 확인하는 순서로 진행합니다. 한 번에 하나의 항목만 변경하고 동일한 실제 요청을 반복하세요. Settings에 들어가면 공식 스크린샷에 표시된 Test Method, On Demand, Diagnostics 등의 메뉴를 볼 수 있습니다. 테스트가 실패했다고 해서 Proxy, TCP, UDP 등의 설정을 동시에 초기화하지 마세요. 비교 기준으로 삼을 기존 상태가 사라집니다.

구독은 저장됐지만 목록이 비어 있음

먼저 구독 편집 화면으로 돌아와 Type이 Subscribe인지, 링크가 완전한지, 공백이 추가되었는지 확인합니다. 다음으로 주소가 여전히 유효한지, 반환된 내용이 클라이언트에서 인식할 수 있는 구독인지, 로그인 페이지나 오류 메시지는 아닌지 확인합니다. 짧은 시간 동안 연속해서 업데이트하지 마세요. 서비스 제공업체가 갱신 빈도를 제한한다면 안내에 따라 기다립니다. 주소 유효성, 권한 또는 내용 관련 문제는 기존 서비스 제공업체에 확인하고 전체 구독 링크를 공개하지 마세요.

서버는 표시되지만 Connectivity Test 시간 초과

일반적인 직접 연결 페이지가 열리는지 확인한 다음 선택한 서버의 Host, Port 및 인증 정보를 확인합니다. 구독 항목은 한 번 정상적으로 갱신하고, 수동으로 입력한 항목은 원본 정보와 하나씩 대조합니다. Settings의 Test Method는 테스트 동작과 결과의 비교 가능성에 영향을 주므로 서버를 비교할 때 동일한 테스트 방식을 유지하세요. 특정 테스트에 응답이 없더라도 브라우저의 실제 접속 결과를 함께 확인해야 합니다. 하나의 테스트 값만으로 전체 연결 상태를 판단할 수는 없습니다.

스위치는 켜져 있지만 일부 페이지가 열리지 않음

먼저 현재 모드가 Direct가 아닌지 확인한 뒤 앞 절의 방법에 따라 Proxy와 Config를 비교합니다. Config에서만 실패한다면 잘못된 구성 파일을 선택했는지, 대상 도메인이 REJECT 또는 적절하지 않은 DIRECT 규칙과 일치했는지 확인합니다. 도메인 확인에 문제가 있다면 규칙 순서만 변경하지 말고 DNS도 확인해야 합니다. 일반 연결 문제를 해결하기 위해 HTTPS Decryption 또는 URL Rewrite를 활성화하거나 변경하지 마세요. 이는 최초 연결에 필요한 단계가 아닙니다.

스위치 상태가 반복해서 바뀌거나 네트워크 전환 후 문제가 발생함

시스템 VPN 권한과 다른 연결의 사용 여부를 확인한 다음 Settings에서 On Demand에 자동 연결 조건이 설정되어 있는지 확인합니다. Wi-Fi 또는 셀룰러 네트워크 중 한 환경에서만 문제가 발생하면 각각의 결과를 기록하고 서버와 네트워크를 동시에 변경하지 마세요. iPad에서도 같은 순서로 확인합니다. 가로 화면에서는 메뉴 위치가 달라질 수 있지만 Home, Config, Settings의 메뉴 이름을 기준으로 찾으면 됩니다.

추가 분석이 필요하면 Diagnostics에서 확인 가능한 기록을 살펴봅니다. 기록을 공유하기 전에 구독 주소의 인증 정보, 서버 인증 정보 및 기타 개인 데이터를 삭제하고 오류 현상, 발생 조건 및 이미 시도한 단계만 남기세요. DNS, 배터리 소모, 업데이트 후 문제 및 iPad 전용 절차는 Shadowrocket 문제 해결을 참조하세요. 최초 작업 순서만 다시 확인하려면 전체 설정을 지우지 말고 추가 및 가져오기로 돌아가 단계별로 점검합니다.

Shadowrocket Settings 화면에 표시된 Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP
Settings: 문제 해결 시 Test Method, On Demand 및 Diagnostics를 확인하고 한 번에 하나씩만 조정합니다.
Shadowrocket 모든 플랫폼 다운로드