공식 매뉴얼 / 시작하기
Shadowrocket 사용법
추가, 모드 선택, 연결, 확인, 문제 해결 순서로 진행합니다. 이 안내에서는 iPhone / iPad 화면을 예로 들어 확인 가능한 연결을 먼저 완료한 뒤 규칙과 Settings를 조정합니다.
스크린샷은 화면과 항목을 식별하기 위한 것이며, 모든 항목을 그대로 입력해야 한다는 뜻은 아닙니다. 실제 항목은 선택한 Type과 앱 화면에 따라 달라집니다. 연결 매개변수는 보유한 서버 정보를 기준으로 입력하세요.
STEP 01 / ADD SERVER
서버 추가 또는 기존 구독 가져오기
받은 정보가 구독 링크인지, 단일 서버 링크인지, 항목별로 입력해야 하는 서버 매개변수인지 먼저 확인합니다.
직접 입력: Home → Add Server
Shadowrocket을 열고 Home 페이지 아래쪽의 SERVER 그룹에서 Add Server를 찾습니다. 화면에 들어간 뒤 먼저 Type을 누르고 서비스 제공업체의 자료에 표시된 프로토콜을 선택한 다음 나머지 항목을 입력합니다. Type에 따라 입력 양식이 달라지므로 비밀번호를 먼저 입력한 뒤 임의로 프로토콜을 바꾸지 말고, 포트 번호만으로 프로토콜을 추측하지 마세요.
스크린샷의 항목을 예로 들면 Host에는 서버 도메인 또는 IP 주소, Port에는 서버 포트, Password에는 해당 비밀번호를 입력하고 Method는 안내받은 암호화 방식에 맞게 선택합니다. Host는 웹페이지 주소 입력란이 아닙니다. 경로가 포함된 구독 링크를 입력하지 마세요. 다른 Type에는 인증 또는 전송 항목이 다르게 표시될 수 있으므로 하나씩 확인하고, 한 프로토콜의 인증 정보를 다른 프로토콜에 사용하지 마세요.
입력이 끝나면 저장하고 Home으로 돌아가 SERVER 아래에 방금 추가한 항목이 표시되는지 확인합니다. 항목이 보인다는 것은 정보가 저장됐다는 뜻일 뿐 서버를 사용할 수 있다는 의미는 아닙니다. 표시된 이름과 주소가 예상한 정보와 일치하는지 먼저 확인하고, 이후 Connectivity Test와 실제 접속으로 검증합니다. 입력 중 공백이나 줄바꿈이 들어갔다면 편집 화면에서 수정하세요.
여러 서버 가져오기: Subscribe
구독 링크를 보유한 경우 Config 페이지에서 Subscribe 항목을 찾아 화면 안내에 따라 전체 링크를 붙여넣고 저장하거나 업데이트합니다. 구독 링크는 여러 서버 정보를 가져오는 데 사용하며, 단일 서버 링크는 하나의 연결 정보만 나타냅니다. 가져온 뒤 Home으로 돌아가 서버 목록에 항목이 표시되는지 확인하고 사용할 서버를 선택합니다.
구독 주소에는 계정 정보가 포함되는 경우가 있으므로 전체 주소를 복사하되, 공개 스크린샷이나 문의 내용에는 노출하지 마세요. 가져오기에 실패하면 클립보드에 링크 외의 설명, 따옴표 또는 줄바꿈이 포함되지 않았는지 먼저 확인합니다. 그런 다음 서비스 제공업체 계정 페이지에서 구독을 활성화해야 하는지 확인하세요. 업데이트만으로 계정 상태가 해결되거나 서비스 제공업체 측 서버 매개변수가 바뀌지는 않습니다.
기존 QR 코드가 있다면 Add Server 페이지에서 Scan QR Code를 선택하고 카메라 권한을 허용한 뒤 보유한 정보를 스캔할 수 있습니다. Import from Cloud JSON은 해당 JSON 데이터 소스를 위한 기능이지 일반 구독 입력란이 아닙니다. 임의의 웹 주소를 여러 입력 경로에 반복해서 넣지 마세요. 형식을 잘 모르겠다면 자료 안내를 확인한 다음 구독 가져오기 4가지 경로를 참고하세요.
이 단계를 마치면 Home에 선택할 서버가 표시되어야 합니다. 다음으로 트래픽 처리 방식을 정합니다. 바로 DNS나 다른 고급 설정을 변경할 필요는 없습니다. 서버 추가와 올바른 Global Routing 선택은 서로 다른 단계입니다.
STEP 02 / GLOBAL ROUTING
Global Routing 모드 선택
서버는 연결에 사용할 정보를 정하고, Global Routing은 요청을 처리할 방식을 정합니다.
Home으로 돌아가 Global Routing을 누르고 현재 목적에 따라 Config, Proxy 또는 Direct를 선택합니다. 이 세 모드는 연결 품질의 등급이나 서로 다른 프로토콜을 의미하지 않습니다. 처음 사용할 때는 먼저 선택 항목을 확인한 뒤 연결을 켜세요. 서버 정보를 올바르게 입력했더라도 모드가 예상과 다르면 결과를 잘못 판단할 수 있습니다.
일반적인 트래픽 분리: Config
Config는 현재 활성화된 구성의 규칙에 따라 요청을 처리합니다. 프록시를 사용할 대상은 해당 정책에 매칭되어야 하고, 로컬에서 직접 접속할 대상은 DIRECT에 매칭될 수 있습니다. Config로 들어가 실제 선택된 구성을 확인하세요. 구성 편집 화면에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 표시됩니다. 이 화면은 구성 파일의 내용이며 서버 구독 목록이 아닙니다.
이 단계에서는 구성이 활성화됐는지 확인하고 Rule이 규칙 매칭을 담당한다는 점을 이해하면 됩니다. 규칙은 일반적으로 위에서 아래 순서로 검사하며 먼저 매칭된 규칙이 실행됩니다. 앞선 규칙에 매칭되지 않은 요청은 FINAL이 처리합니다. 첫 연결을 위해 URL Rewrite나 HTTPS Decryption을 동시에 활성화하지 말고, Add Rule을 서버 추가 경로로 사용하지 마세요. 키워드 의미는 용어집에서, 구체적인 설정은 옵션 매뉴얼에서 확인하세요.
임시 비교: Proxy와 Direct
Proxy는 프록시 경로로 접속할 수 있는지 임시로 확인할 때 사용할 수 있습니다. 모든 앱과 모든 시스템 트래픽이 같은 방식으로 처리된다는 뜻은 아닙니다. Direct는 로컬 네트워크 접속을 확인하는 데 사용할 수 있지만, 이를 통해 프록시 서버의 정상 여부를 확인할 수는 없습니다. 두 모드는 현재 테스트 경로를 명확히 하는 용도입니다. 문제 해결 중 연속으로 전환한 뒤 원래 모드로 되돌리는 것을 잊지 않도록 하세요.
예를 들어 Proxy에서는 특정 대상에 접속되지만 Config에서 실패한다면 서버를 바로 다시 만들기보다 해당 대상에 적용된 규칙과 정책을 먼저 확인하세요. 비교가 끝나면 Config로 되돌리고 예상한 구성이 사용 중인지 다시 확인합니다. 다음으로 Home으로 돌아가 선택한 서버와 모드를 유지한 채 상단 연결 스위치를 켤 준비를 합니다.
STEP 03 / CONNECT
연결을 켜고 VPN 권한 확인
먼저 서버를 선택한 다음 상단 스위치를 켭니다. 시스템 권한을 허용한 뒤 앱의 실제 상태도 확인해야 합니다.
Home의 SERVER 그룹에서 사용할 서버를 선택하고 선택 표시가 올바른 항목에 있는지 확인합니다. 구독 그룹이 여러 개라면 같은 이름의 항목이 어느 그룹에 속하는지 특히 주의하세요. 그런 다음 Global Routing이 방금 선택한 모드인지 확인하고 Not Connected 영역의 상단 연결 스위치를 켭니다.
처음 연결할 때 iPhone / iPad에 VPN 구성을 추가하라는 시스템 안내가 표시될 수 있습니다. Shadowrocket에서 방금 직접 시작한 동작인지 확인한 뒤 허용을 누르고 시스템 요구에 따라 기기 인증을 완료합니다. 이 단계는 시스템이 앱에서 사용할 VPN 구성을 설정하도록 하는 것이며, 서버 정보를 대신 입력하거나 서비스 제공업체 자료가 검증됐음을 뜻하지 않습니다.
권한을 허용한 뒤 Home으로 돌아가 상태가 바뀌는지 확인합니다. 스위치가 즉시 꺼진 상태로 돌아가면 빠르게 반복해서 누르지 마세요. 처리하지 않은 시스템 안내가 있는지 먼저 확인한 다음 시스템 설정의 VPN 구성 상태를 살펴봅니다. 이전에 실수로 거부했다면 앱에서 다시 연결을 시작할 수 있습니다. 시스템 구성을 삭제했다면 권한 설정을 다시 완료해야 합니다. 안내 문구에 대한 자세한 내용은 VPN 구성 안내 설명을 참고하세요.
기기에서 다른 VPN 연결을 사용 중이라면 현재 어떤 연결이 네트워크를 처리하는지 먼저 확인해 다른 연결의 상태를 Shadowrocket의 결과로 착각하지 않도록 합니다. 관리 기기에는 조직에서 적용한 제한이 있을 수 있으므로 기기 관리 요구 사항을 따르고 용도를 알 수 없는 관리 구성을 연결을 위해 삭제하지 마세요.
상단에 연결 상태가 표시되면 현재 설정을 그대로 유지합니다. 시스템 상태 막대의 VPN 표시는 터널 상태만 나타내며 대상 웹페이지에 접속할 수 있다는 사실을 단독으로 증명하지는 않습니다. 다음 단계에서 서버 테스트, 실제 요청 및 규칙 매칭 결과를 함께 확인해야 합니다.
STEP 04 / CONNECTIVITY TEST
연결이 실제로 적용됐는지 확인
테스트 결과, 대상 접속 및 규칙 기록은 서로 다른 질문에 답하므로 각각 구분해 판단해야 합니다.
서버를 테스트한 뒤 실제 대상에 접속
Home에서 Connectivity Test를 실행해 현재 서버가 선택한 테스트를 완료할 수 있는지 확인합니다. 테스트 시간 초과는 추가 문제 해결의 단서가 될 수 있지만, 테스트 성공이 모든 대상에 접속할 수 있다는 뜻은 아닙니다. 테스트 방식, 테스트 대상 및 실제 서비스 요청은 서로 다를 수 있습니다. 테스트 숫자 하나만으로 서비스 제공업체의 상태를 판단하지 말고 테스트 방식을 확인하지 않은 채 여러 항목의 결과를 비교하지 마세요.
연결을 유지한 채 브라우저에서 평소 정상 여부를 확인할 수 있는 페이지를 연 다음 이번에 사용할 대상에도 접속합니다. 이미 로드된 페이지나 캐시된 내용만 보지 말고 새 요청을 보내세요. 브라우저에 이전 결과가 남아 있다면 페이지를 새로고침하고 필요하면 해당 페이지를 닫았다가 다시 엽니다. 모드 변경, 서버 교체, Wi-Fi 전환을 동시에 하지 마세요. 결과가 달라진 원인을 파악하기 어렵습니다.
Config에서 매칭된 정책 확인
Shadowrocket으로 돌아가 Data 또는 현재 화면에서 사용할 수 있는 연결 기록을 확인하고 방금 요청한 대상을 찾아 도메인, 매칭된 규칙 및 최종 정책을 확인합니다. 프록시를 사용하려던 대상이 DIRECT에 매칭됐다면 구성과 규칙 순서를 먼저 확인하세요. 직접 연결을 예상했는데 프록시를 사용한다면 모든 규칙을 삭제하지 말고 대상의 매칭 조건부터 살펴봅니다.
조건을 통제해 비교할 수 있습니다. 현재 모드와 서버를 기록하고 Global Routing만 임시로 바꾼 뒤 동일한 대상을 다시 요청합니다. 차이가 반복해서 확인된다면 원인을 좁힐 수 있습니다. 테스트 후에는 원래 Config로 되돌립니다. 특정 웹페이지에 표시된 외부 IP 주소는 해당 요청의 경로만 반영하며 기기의 모든 트래픽에 같은 정책이 적용된다는 뜻은 아닙니다.
이 단계의 완료 기준은 연결이 유지되고, 대상이 정상적으로 열리며, 기록에 표시된 처리 정책이 예상과 일치하는 것입니다. 세 가지를 모두 확인한 뒤 자동 연결이나 세부 규칙을 살펴보세요. 그중 하나만 문제가 있다면 현재 상태를 유지한 채 다음 단계로 진행하면 됩니다. 앱을 다시 설치하거나 모든 정보를 지울 필요는 없습니다.
STEP 05 / SETTINGS & DIAGNOSTICS
실패 지점에 따라 하나씩 확인
입력 정보와 기본 네트워크를 먼저 확인한 뒤 권한, DNS 및 규칙을 살펴봅니다. Settings를 한꺼번에 변경하지 마세요.
가져오기 실패 또는 테스트 시간 초과
가져온 뒤 항목이 생기지 않았다면 첫 번째 단계로 돌아가 링크 유형, 전체 내용 및 업데이트 결과를 확인합니다. 업데이트는 성공했지만 서버 테스트가 시간 초과되면 먼저 연결을 끊고 로컬 네트워크가 정상인지 확인한 다음 현재 선택한 서버를 점검합니다. 구독에 항목이 표시된다는 것은 정보를 가져왔다는 뜻일 뿐 해당 항목의 서비스가 현재 사용 가능하다는 의미는 아닙니다.
Type, Host, Port, Password, Method와 해당 프로토콜에 필요한 다른 인증 및 전송 매개변수를 하나씩 확인합니다. 대소문자, 앞뒤 공백 및 복사 누락 여부를 점검하세요. 시간 검증이 필요한 연결에 영향을 줄 수 있으므로 시스템 시간도 정확하게 맞춰야 합니다. 문제가 계속되면 보유한 정보와 서비스 상태를 서비스 제공업체에 확인하세요. 전체 순서는 서버 시간 초과 및 연결 실패 해결 순서를 참고하세요.
테스트는 정상이지만 웹페이지가 열리지 않음
먼저 모든 웹페이지가 실패하는지 특정 대상만 실패하는지 확인합니다. 일부 대상만 실패한다면 Data 또는 연결 기록에서 도메인과 매칭 정책을 살펴봅니다. 연결은 되지만 이름 확인에 실패한다면 DNS 관련 설정을 확인하세요. 서버 테스트가 정상이라는 이유로 DNS 문제를 배제하지 말고, 임의의 DNS 주소를 하나씩 바꾸는 방식을 고정 해결책으로 삼지 마세요.
Settings를 열면 Test Method, On Demand, Diagnostics, Proxy, TCP, UDP 등의 설정 그룹이 표시됩니다. Test Method는 테스트 방식에 영향을 주고 Diagnostics는 문제 해결에 필요한 정보를 수집합니다. 이 항목들은 서버 매개변수를 대신하는 스위치가 아닙니다. DNS의 정확한 위치와 항목은 현재 화면을 기준으로 확인하세요. 처음 문제를 점검할 때는 기존 값을 기록하고 확인된 문제에 필요한 설정만 조정합니다. 자세한 내용은 DNS 및 웹페이지 로딩 실패 안내를 참고하세요.
연결 후 끊기거나 꺼도 다시 연결됨
스위치를 켠 직후 꺼진다면 세 번째 단계의 VPN 권한, 시스템 안내 및 현재 연결 기록부터 확인합니다. 직접 연결을 끈 뒤 다시 자동으로 연결되면 On Demand가 설정됐는지 확인하세요. 문제를 해결하는 동안 기존 조건을 기록하고 자동 실행을 잠시 중지한 다음 수동으로 문제를 재현할 수 있습니다. 원인을 확인한 뒤 복원 여부를 결정하면 자동 연결이 테스트 과정을 방해하지 않습니다.
Today Widget은 빠른 조작이나 관련 상태 확인에 사용하는 기능으로, 첫 연결에 필수는 아닙니다. Proxy, TCP, UDP 등의 그룹은 연결 동작을 세부적으로 설정하므로 이 안내에서는 미리 변경하지 않는 것을 권장합니다. 항목의 의미와 기본 동작, 값의 기준을 알아보려면 Settings 옵션 매뉴얼을 읽고 현재 프로토콜과 무관한 설정 조합을 그대로 적용하지 마세요.
진단 정보를 저장할 때는 문제를 설명하는 데 필요한 부분만 남기고 구독 주소, 비밀번호 및 기타 인증 정보를 가립니다. 문제를 설명할 때는 실패가 발생한 단계, 모든 대상이 영향을 받는지, 네트워크를 바꿔도 재현되는지, 가장 최근에 변경한 설정 항목을 포함하세요. 이런 기록이 반복해서 가져오거나 스위치를 켜고 끄는 것보다 원인을 찾는 데 도움이 됩니다.
플랫폼 / 다음 단계
다른 기기와 후속 설정
위 단계는 iPhone / iPad 화면을 예로 들며 다른 플랫폼의 화면 조작을 직접 안내하지는 않습니다. iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제로 이용할 수 있습니다. Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료이며 설치 패키지는 사이트 다운로드 페이지에서 받을 수 있습니다.
연결 확인을 마친 뒤에는 사용 가능한 구성을 먼저 보관하고 규칙과 자동 연결을 살펴보세요. 용어는 용어집에서, Settings는 옵션 매뉴얼에서 확인하세요. 명확한 필요가 있을 때만 추가로 조정합니다.