공식 안내서 첫 설정 절차

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

iPad와 iPhone에서 사용할 수 있습니다. ‘추가 → 모드 선택 → 연결 → 확인 → 문제 해결’ 순서로 처음 설정을 마치세요. 먼저 연결 하나가 정상 작동하는지 확인한 다음 규칙과 자동 연결 조건을 조정합니다.

공식 스크린샷은 화면과 입력 항목을 식별하는 데 참고하세요. 실제 화면은 기기에 표시된 내용을 기준으로 합니다. 스크린샷의 서버 항목은 입력용 연결 정보가 아니므로, 작업할 때는 본인 정보를 사용하고 이미지의 내용을 그대로 옮기지 마세요.

01 / ADD SERVER · SUBSCRIBE

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

두 방법 중 하나를 선택하세요. 구독을 가져오면 서버 항목 여러 개가 추가되고, 직접 추가하면 서버 하나를 저장합니다.

Shadowrocket을 열고 Home으로 이동한 뒤 아래쪽에서 SERVER 그룹과 Add Server를 찾습니다. 먼저 보유한 정보의 유형을 확인하세요. 서버 여러 대의 정보를 갱신할 수 있는 전체 주소는 구독 링크입니다. 프로토콜, 서버 주소, 포트, 인증 매개변수로 구성된 정보는 직접 추가할 때 사용합니다. 둘 다 텍스트 형태라는 이유만으로 서로 바꿔 사용할 수는 없습니다. 가져오기에 실패하면 저장을 반복하기 전에 정보 유형부터 확인하세요.

구독이 있는 경우: Subscribe 선택

Add Server를 탭하고 추가 화면에서 Type을 탭한 뒤 Subscribe를 선택합니다. 해당 주소 입력란에 보유한 구독 주소 전체를 붙여 넣습니다. 메모 항목이 있으면 알아보기 쉬운 이름을 입력할 수 있습니다. 주소를 붙여 넣은 뒤 처음과 끝이 온전한지 확인하고, 특히 메신저에서 복사할 때 공백, 줄바꿈, 설명 문구가 함께 들어가지 않았는지 살펴보세요. 주소의 매개변수는 인증에 사용될 수 있으므로 임의로 삭제하지 말고, 전체 주소를 공개된 곳에 공유하지 마세요.

저장한 뒤 Home으로 돌아가 구독 내용이 불러와질 때까지 기다립니다. SERVER에 해당 그룹과 서버 항목이 표시되는지 확인하세요. 구독 이름만 저장했다고 해서 내용까지 정상적으로 가져온 것은 아닙니다. 목록이 비어 있다면 현재 네트워크에서 구독 주소에 접속할 수 있는지, 주소가 유효한지 먼저 확인하세요. 새로고침이 필요하면 해당 구독 항목의 작업 메뉴에서 업데이트하면 됩니다. 이름이 같은 구독을 여러 개 만들 필요는 없습니다.

서버 정보가 있는 경우: Type에 맞게 입력

직접 추가하려면 Add Server의 Type에서 보유 정보와 일치하는 프로토콜을 선택하고 Host, Port 및 해당 프로토콜에 필요한 인증 정보를 입력합니다. 스크린샷의 Password와 Method는 해당 유형의 입력 항목 예시입니다. 프로토콜을 바꾸면 항목도 달라지므로 본인 서버 정보를 기준으로 입력하세요. Host에는 보통 호스트 이름이나 IP만 입력하며 전체 웹 주소를 넣지 않습니다. 포트와 비밀번호는 대소문자와 각 문자를 하나씩 확인하세요.

QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. Import from Cloud JSON은 해당 메뉴의 형식과 일치하는 기존 정보에만 사용합니다. 저장한 뒤 SERVER로 돌아가 이름, 유형, 주소가 서로 일치하는지 확인하세요. 다음 단계에서 Global Routing을 선택하기 전에 식별하기 쉬운 테스트 항목 하나를 유지하세요. 실패 원인을 파악하기 어려워지지 않도록 프로토콜, 구독, 규칙을 동시에 변경하지 마세요.

Shadowrocket Add Server 공식 스크린샷: Type, Host, Port, Password, Method 및 가져오기 메뉴 표시
Add Server: 먼저 Type을 선택하고 해당 항목을 입력하세요. 구독을 가져올 때는 Subscribe를 선택합니다.

02 / GLOBAL ROUTING · CONFIG

Global Routing 모드 선택

서버는 사용할 연결 대상을 정하고, Global Routing은 트래픽 처리 방식을 정합니다.

추가를 마친 뒤 Home으로 돌아가 Global Routing을 탭합니다. 처음 설정할 때는 Config, Proxy, Direct 세 가지 모드를 구분해야 합니다. 서버의 프로토콜 유형이나 구독 세 가지를 뜻하는 것이 아닙니다. 같은 서버라도 모드에 따라 처리하는 요청 범위가 달라질 수 있습니다.

  • Config: 현재 활성화된 구성의 규칙에 따라 처리 정책을 선택합니다. 요청에 따라 PROXY, DIRECT 또는 REJECT가 적용될 수 있으며, 실제 결과는 규칙의 조건과 순서에 따라 달라집니다.
  • Proxy: 이 모드에서 처리하는 트래픽에 선택한 프록시를 사용합니다. 라우팅 규칙에 문제가 있는지 잠시 확인할 때 유용합니다. 모든 시스템 요청이 반드시 같은 연결을 통과한다고 이해해서는 안 됩니다.
  • Direct: 직접 연결할 때 사용합니다. 연결 스위치가 켜져 있어도 Direct를 선택하면 선택한 서버를 통해 요청을 전달한다는 뜻은 아닙니다.

규칙 기반 라우팅을 사용하려면 먼저 하단의 Config로 이동해 어떤 구성이 활성화되어 있는지 확인하고 규칙을 살펴보세요. 서버 구독과 구성 파일은 역할이 다릅니다. 구독은 주로 서버 정보를 관리하고, 구성 파일은 공통 매개변수, 규칙, 관련 설정을 정의합니다. 구독을 가져오는 데 성공했다고 해서 필요한 라우팅 구성이 활성화된 것은 아닙니다.

공식 스크린샷의 구성 편집 화면은 General, Rule, Hosts, URL Rewrite 등의 영역으로 구성되며, Add Rule에서 규칙을 추가합니다. 처음 연결할 때 이 영역을 하나씩 수정할 필요는 없으며, 기본 연결을 위해 HTTPS Decryption을 활성화할 필요도 없습니다. 기존 구성은 우선 그대로 두세요. 편집해야 한다면 먼저 사본을 저장해 문제 해결 과정이 장기 설정에 반영되지 않도록 하세요.

Rule을 확인할 때는 구체적인 조건이 포괄적인 조건보다 앞에 있는지, 마지막의 FINAL이 어떤 정책을 가리키는지 살펴보세요. PROXY는 프록시 정책으로 처리, DIRECT는 직접 연결, REJECT는 거부를 뜻합니다. 규칙에서 사용자 지정 정책 이름을 참조한다면 해당 정책이 실제로 있는지도 확인해야 합니다. 문법과 규칙 우선순위는 규칙 및 구성 참고에서 확인하세요. 여기서는 먼저 모드를 선택하고 전체 구성을 다시 작성하는 작업은 진행하지 않습니다.

기존 규칙을 바로 판단하기 어렵다면 현재 모드를 기록한 뒤 잠시 Proxy를 선택해 연결을 테스트할 수 있습니다. 서버가 작동하는 것을 확인한 다음 Config로 돌아가 규칙을 점검하세요. 이렇게 하면 ‘서버 자체의 문제’와 ‘규칙에 따라 요청이 다른 정책으로 전달되는 문제’를 구분할 수 있습니다. 모드를 선택한 뒤 Home으로 돌아가 다음 단계에서 연결 스위치를 켭니다.

Shadowrocket Config 공식 스크린샷: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config: 현재 활성 구성과 Rule을 확인하고, Home에서 Global Routing 모드를 선택합니다.

03 / HOME · VPN

서버를 선택하고 연결 스위치 켜기

현재 선택 항목을 먼저 확인한 다음 시스템의 VPN 구성 승인 요청에 응답하세요.

Home으로 돌아가 SERVER 그룹에서 사용할 서버를 탭하고 선택 표시가 올바른 항목에 있는지 확인합니다. 구독을 방금 업데이트했다면 목록의 이름, 순서 또는 사용 가능한 항목이 달라졌을 수 있으므로 현재 선택을 다시 확인하세요. 이어서 Global Routing이 앞 단계에서 선택한 모드로 유지되어 있는지 살펴봅니다. Direct 상태에서 프록시 연결을 테스트하고 있다고 오해하지 않도록 주의하세요.

상단의 Not Connected 옆에 있는 연결 스위치를 탭합니다. 처음 연결할 때 시스템에 VPN 구성 추가 확인 창이 표시될 수 있습니다. 안내를 확인하고 허용한 다음 기기에서 요구하는 암호 또는 생체 인증을 완료하세요. 이 단계는 시스템에 네트워크 연결 구성을 등록하는 절차이며, 구독을 가져오거나 서버 인증을 대신하지 않습니다. 승인을 취소했다면 Home으로 돌아와 다시 연결을 시도하고, 처리할 시스템 안내가 남아 있는지 확인하세요.

승인 후 Shadowrocket으로 돌아가 상단의 연결 상태와 스위치가 계속 켜져 있는지 확인합니다. iPad와 iPhone은 화면 너비와 시스템 상태 표시가 다를 수 있지만 확인 순서는 같습니다. 서버 선택, Global Routing 확인, 시스템 승인 완료, 앱 상태 변경 순으로 점검하세요. 상태 막대에 VPN 문구가 표시되지 않는다는 이유만으로 실패라고 판단하지 마세요. 기기와 표시 위치에 따라 표시가 보이지 않을 수 있습니다.

스위치가 바로 꺼진다면 모든 규칙을 급히 변경하지 말고 시스템 승인이나 연결 시작 문제부터 확인하세요. 스위치가 계속 켜져 있으면 다음 단계에서 실제 요청을 확인합니다. 연결 상태는 네트워크 구성이 시작되었음을 나타낼 뿐 서버 인증, 대상 사이트 접속, DNS, 라우팅 결과가 모두 정상임을 보장하지는 않습니다.

Shadowrocket Home 공식 스크린샷: 상단에 Not Connected, Global Routing, Connectivity Test, 하단에 SERVER와 Add Server 표시
Home: SERVER에서 서버 선택, Global Routing 확인, 상단 스위치 순서로 진행합니다.

04 / CONNECTIVITY TEST · DATA

연결 및 라우팅 적용 여부 확인

연결을 켠 뒤 Home에서 Connectivity Test를 실행하고 선택한 서버의 테스트 결과를 확인합니다. 성공은 해당 테스트 방법이 응답을 받았다는 뜻이며, 실패는 추가 점검이 필요하다는 신호입니다. 어느 결과도 실제 접속을 대신하지는 않습니다. 테스트 방법마다 대상과 경로가 다르고, 지연 시간은 모든 앱의 속도를 나타내지 않습니다. 숫자를 낮추기 위해 현재 구성을 자주 바꾸지 마세요.

이어서 Safari를 열고 원래 사용하려던 페이지에 접속해 로딩이 완료될 때까지 기다립니다. 페이지가 이미 열려 있었다면 새로고침하거나 새 페이지를 열어 캐시의 영향을 줄이세요. 먼저 한 곳을 테스트한 뒤 용도가 다른 곳도 확인합니다. ‘연결은 되지만 페이지 로딩이 느림’, ‘특정 페이지만 실패’, ‘모든 페이지가 실패’처럼 구체적으로 기록하면 ‘작동하지 않음’이라는 막연한 설명보다 원인을 찾기 쉽습니다.

Data에서 실제 처리 경로 확인

Config 라우팅을 확인하려면 Shadowrocket의 Data로 돌아가 관련 요청 기록을 확인합니다. 현재 기록 기능을 사용할 수 있다면 요청 도메인, 일치한 규칙, 대상 정책을 함께 살펴 실제 경로를 판단하세요. 프록시를 사용할 것으로 예상한 요청에 DIRECT가 적용되었다면 서버를 바꾸기 전에 규칙과 Global Routing을 확인합니다. PROXY로 전달되었는데도 실패한다면 서버 매개변수, 대상 서비스, 현재 네트워크를 추가로 점검하세요.

확인할 때는 한 번에 하나의 조건만 바꾸세요. 예를 들어 서버와 네트워크를 그대로 둔 채 Config와 Proxy를 비교하거나, 모드를 유지하고 Wi-Fi만 사용 가능한 다른 네트워크로 바꿔 볼 수 있습니다. 변경할 때마다 요청을 다시 보내고 결과를 기록하세요. 이렇게 해야 여러 설정을 동시에 바꾼 뒤 우연히 성공한 결과가 아니라 서로 비교할 수 있는 근거를 얻을 수 있습니다.

결과를 확인한 뒤 장기간 사용할 Global Routing 모드로 되돌립니다. 이후 자동 연결이 필요하면 On Demand를 별도로 설정하세요. 자동 실행 조건과 서버 연결 자체의 문제를 구분하기 쉽도록 먼저 수동 연결 과정을 완전히 확인합니다.

05 / SETTINGS · DIAGNOSTICS

문제가 발생한 단계에 따라 설정 확인

다시 확인할 수 있도록 조건을 기록하고, 한 번에 한 단계씩 점검하세요. 원인을 찾는 대신 앱을 반복해서 재설치하지 마세요.

가져오기에 실패하거나 SERVER 목록이 비어 있음

먼저 Add Server로 돌아가 Type을 확인합니다. 구독 링크에는 Subscribe를 사용하고, 서버 하나의 정보는 해당 프로토콜에 맞게 입력해야 합니다. 주소 전체가 잘리지 않았는지, 현재 네트워크에서 내용을 가져올 수 있는지, 기존 서비스의 이용 기간이 유효한지 확인하세요. 구독 주소에 접속할 수 있는데도 항목이 없다면 응답 내용이 호환되는 구독 데이터인지 확인해야 합니다. 로그인 페이지, 안내 문구, 오류 페이지는 열리기만 한다고 유효한 구독이 되는 것이 아닙니다.

스위치가 켜진 상태로 유지되지 않음

시스템의 VPN 구성 승인을 완료했는지, 현재 다른 VPN 연결이 사용 중인지 확인합니다. 사용 중인 다른 VPN 연결을 먼저 중지한 뒤 Home으로 돌아가 다시 시도하세요. 관리 대상 기기에서 VPN 구성 추가를 제한한다면 기기 관리자에게 정책을 확인하세요. 처음부터 기존 구성을 삭제하지 마세요. 삭제하기 전에 필요한 구독 및 서버 정보를 보유하고 있는지 확인해 정보가 사라지는 일을 방지하세요.

스위치는 켜졌지만 테스트 또는 접속이 실패함

선택한 서버의 Host, Port, 프로토콜, 인증 정보를 먼저 확인합니다. 구독을 사용한다면 한 번 업데이트한 뒤 현재 선택한 항목도 다시 확인하세요. Settings에서 Test Method를 살펴보고 현재 테스트 방법을 이해한 다음 Connectivity Test 결과를 판단합니다. 테스트 하나는 실패했지만 실제 페이지에 접속할 수 있다면, 단일 테스트 결과를 전체 연결 실패로 간주하지 말고 테스트 대상과 방법부터 확인하세요.

Proxy에서는 접속되지만 Config에서 실패한다면 현재 구성의 Rule, FINAL, 정책 참조를 중점적으로 살펴보세요. 두 모드에서 모두 실패하면 서버와 모드를 그대로 두고 사용 가능한 다른 네트워크를 시도해 네트워크 환경과 서버 문제를 구분합니다. 특정 대상만 실패하는 경우에는 대상 서비스 자체의 상태도 고려하세요. 구독을 반복해서 새로고침해도 모든 접속 문제를 해결할 수는 없습니다.

On Demand 및 Diagnostics 확인

On Demand는 조건에 따라 연결을 시작하는 기능입니다. 처음 문제를 진단할 때는 기존 설정을 기록한 뒤 잠시 꺼서 수동 스위치로 문제를 재현해 보세요. 자동 재연결이 켜져 있으면 연결을 끈 직후 다시 켜지는 현상이 판단을 흐릴 수 있습니다. 수동 연결이 안정된 후 On Demand를 복원하고 조건을 하나씩 확인하세요. Settings의 Proxy, TCP, UDP 등의 옵션도 실제 필요에 따라 조정하고, 항목이 보인다는 이유만으로 전부 변경하지 마세요.

원인을 더 자세히 확인하려면 Diagnostics에서 진단 정보를 살펴보고 문제가 발생한 단계, 사용한 네트워크, 선택한 Global Routing 모드, 테스트와 웹페이지 접속 결과를 기록합니다. 기록이나 스크린샷을 공유하기 전에 전체 구독 주소, 비밀번호, 인증 정보, 개인을 식별할 수 있는 내용을 가리세요. 문제를 재현하는 데 필요한 항목과 오류 설명만 남깁니다.

해결되지 않으면 자주 묻는 질문 및 문제 해결에서 증상에 따라 계속 확인하세요. 구성 항목, 규칙 우선순위, 정책의 의미를 알아보려면 규칙 및 구성 참고를 읽어 보세요. 평소에는 보유한 구독을 업데이트하고, 앱 업데이트는 App Store에서 진행합니다. 두 작업은 서로 다릅니다.

Shadowrocket Settings 공식 스크린샷: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 문제 해결 시 Test Method, On Demand, Diagnostics를 먼저 확인하고 나머지 옵션은 근거에 따라 조정하세요.