공식 사용 설명서 · 초기 설정

Shadowrocket 사용 설명서

기존 서버 또는 구독을 클라이언트에 가져온 뒤 라우팅 모드를 선택하고 연결을 켭니다. 마지막으로 서버 테스트와 실제 접속을 각각 확인해 결과가 예상과 일치하는지 살펴봅니다.

01 · 가져오기

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

Shadowrocket을 열고 Home의 SERVER 영역에서 Add Server를 찾습니다. 먼저 보유한 정보를 확인합니다. 서버 주소, 포트, 인증 정보가 하나씩 있다면 수동으로 추가하고, 여러 서버를 업데이트하는 구독 링크를 받았다면 Subscribe를 사용합니다. 둘 중 한 가지 방법을 선택하면 되며, 구독을 가져오기 전에 수동 항목을 만들 필요는 없습니다.

단일 서버 정보가 있는 경우: 먼저 Type 선택

Add Server를 열고 Type을 눌러 정보에 표시된 프로토콜을 선택합니다. 예를 들어 Shadowsocks 또는 Trojan을 선택합니다. 그런 다음 Host와 Port를 확인합니다. 주소와 포트는 각각 해당 항목에 입력하고, 전체 링크를 Host에 붙여 넣지 않습니다. 아래 항목은 Type에 따라 달라집니다. Password 또는 Method가 표시되면 기존 정보를 입력하고, 제공되지 않은 선택 항목에는 다른 기록의 값을 임의로 사용하지 않습니다. 붙여 넣은 뒤 앞뒤 공백을 확인하고, 특히 메시지의 따옴표, 마침표, 줄바꿈이 함께 들어가지 않도록 합니다.

서버 정보를 가져오는 용도로 명확히 제공된 QR 코드가 있다면 Scan QR Code로 스캔할 수 있습니다. 카메라 권한 알림이 표시되면 허용 여부를 결정합니다. 인식된 후에도 Type과 주소를 확인해야 하며, 스캔 성공이 연결 성공을 뜻하지는 않습니다. 해당 클라우드 데이터가 없다면 Import from Cloud JSON을 누를 필요가 없습니다. 확인 후 저장하고 Home으로 돌아가 방금 추가한 항목을 찾습니다.

구독 링크가 있는 경우: Subscribe 사용

Add Server의 Type 목록에서 Subscribe를 선택하고 원본 구독 링크 전체를 입력란에 붙여 넣은 뒤 저장합니다. 링크에 쿼리 매개변수가 있다면 물음표 뒤의 내용을 삭제하지 말고, 메시지 앱에서 생략 표시된 버전을 사용하지 않습니다. Home으로 돌아가 구독 그룹과 서버 항목이 표시되는지 확인합니다. 그룹만 보이고 항목이 없다면 화면에 안내된 업데이트 작업을 실행한 뒤 오류가 표시되는지 확인합니다. 구독 주소에는 접근 정보가 포함될 수 있으므로, 오류가 발생하면 안내 문구만 기록하고 전체 링크를 공개하지 않습니다.

항목이 표시되면 클라이언트가 서버 정보를 받은 것이지만 서버를 사용할 수 있다는 뜻은 아닙니다. 먼저 SERVER에서 이번에 사용할 항목을 선택합니다. 이름이 같은 항목을 여러 개 가져왔다면 그룹과 주소를 기준으로 구분하고, 이름만 보고 잘못 선택하지 않도록 합니다. 다음 단계에서는 어떤 연결을 이 서버로 보낼지 결정합니다.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method 및 QR 코드 스캔 항목이 표시됨
Add Server: 먼저 Type을 선택하고 프로토콜에 따라 달라지는 항목을 입력합니다.
02 · 라우팅

Global Routing에서 라우팅 모드 선택

Home으로 돌아가 Global Routing을 누릅니다. 여기서는 연결을 처리하는 방식을 정하며 서버 정보를 가져오지는 않습니다. 명확한 분할 라우팅 구성이 있다면 Config를 선택합니다. 선택한 서버가 일반 접속을 프록시할 수 있는지 잠시 확인하려면 Proxy를 비교에 사용할 수 있습니다. 프록시 서버를 거치지 않고 현재 네트워크에서 접속할 수 있는지 확인하려면 Direct를 기준으로 삼습니다. 비교하기 전에 기존 선택 항목을 기록해 둡니다.

  • Config: 현재 활성화된 구성 파일에 따라 매칭 결과가 정해집니다. 같은 탐색 중에도 메인 사이트 요청과 이미지, 로그인 API 등 다른 도메인 요청의 경로가 다를 수 있습니다. 각 연결에 규칙이 적용된 결과입니다.
  • Proxy: 클라이언트가 처리하는 트래픽을 프록시 모드로 처리하며, 잠시 비교할 때 적합합니다. 이 모드에서 사이트에 접속할 수 있다고 해서 Config에서도 반드시 프록시 규칙과 일치하는 것은 아닙니다.
  • Direct: 클라이언트가 처리하는 연결이 프록시 서버를 거치지 않습니다. Proxy 결과와 비교할 때 사용할 수 있지만 Home 상단 스위치를 끄는 것과는 다릅니다. 연결을 중지하려면 Home으로 돌아가 스위치를 끕니다.

Config 사용 시 현재 적용 중인 파일 확인

Global Routing의 Config는 모드이고, 하단의 Config는 파일을 관리하는 화면입니다. 모드를 설정한 다음 하단의 Config를 열어 예상한 파일이 현재 활성화되어 있는지 확인합니다. 파일을 눌러 편집 화면을 보는 것만으로는 해당 파일이 현재 구성으로 설정된 것이 아닙니다. 먼저 활성 상태를 확인한 뒤 파일의 Rule을 살펴봅니다. 첫 연결을 위해 Hosts 또는 HTTPS Decryption을 변경할 필요는 없습니다.

특정 도메인을 확인하려면 목록 위쪽부터 아래로 살펴보고, 먼저 일치하는 규칙을 확인한 다음 앞선 규칙에 일치하지 않는 연결을 마지막의 FINAL에서 어떻게 처리하는지 확인합니다. 예를 들어 도메인이 뒤쪽의 DOMAIN-SUFFIX와 일치하더라도 그보다 앞선 규칙이 이미 매칭되었다면 뒤쪽 규칙만으로 결과를 판단할 수 없습니다. 초기 설정에서는 규칙을 확인하는 데 집중하고 Add Rule을 누를 필요는 없습니다. 규칙 순서와 동작을 더 알아보려면 Shadowrocket 전체 사용 설명서를 참고하세요.

설정 화면을 나간 뒤 Home의 Global Routing 요약을 다시 확인해 방금 선택한 모드가 표시되는지 살펴봅니다. 이번 연결이 테스트 목적이라면 서버와 구성 파일을 동시에 바꾸지 않습니다. 한 가지 조건을 유지해야 어떤 설정이 결과를 바꿨는지 파악하기 쉽습니다.

Shadowrocket의 Config 파일 편집 화면. General, Rule, Hosts 섹션과 Add Rule이 표시됨
Config: 현재 활성화된 파일에서 Rule을 확인합니다. 연결 테스트를 위해 규칙을 추가할 필요는 없습니다.
03 · 연결

Home 스위치를 켜고 VPN 권한 확인

Home에서 두 항목을 확인합니다. SERVER에서 이번에 사용할 항목과 Global Routing에 표시된 모드입니다. 상단에 Not Connected가 표시되면 옆의 연결 스위치를 누릅니다. 켜기 전에 기기가 현재 Wi‑Fi 또는 셀룰러 네트워크를 정상적으로 사용할 수 있는지 확인하는 것이 좋습니다. 로그인이 필요한 공용 Wi‑Fi라면 먼저 네트워크에 로그인한 다음 연결을 시도합니다.

처음 실행할 때: 시스템 알림에서 요청 출처 확인

iPhone 또는 iPad에 VPN 구성 추가를 묻는 시스템 알림이 표시되면 방금 스위치를 켠 작업으로 인해 나타난 알림인지 확인한 다음 시스템 안내에 따라 허용합니다. 기기에 따라 생체 인증 또는 잠금 암호로 확인해야 할 수 있습니다. 승인은 시스템 알림에서 진행하며, 서버 정보와 기기 잠금 암호는 서로 다른 정보입니다. 처음 VPN 구성을 허용하는 것은 클라이언트가 연결을 생성하도록 시스템 권한을 부여하는 것이며, 구독을 검증하거나 Global Routing 선택을 변경하지 않습니다.

방금 허용하지 않기로 선택해 Home으로 돌아왔을 때 스위치가 켜진 상태를 유지하지 못한다면 다시 연결을 시도해 시스템 알림을 표시할 수 있습니다. 알림이 계속 나타나지 않으면 시스템 설정에서 VPN을 검색해 기존 구성이 있는지, 회사 또는 학교의 기기 관리 정책이 변경을 제한하는지 확인합니다. 관리되는 기기라면 관리자에게 문의하고, 구분할 수 없는 구성이나 기기 관리 항목을 삭제하지 않습니다.

승인한 뒤 Home으로 돌아가 상태가 전환될 때까지 기다립니다. 스위치가 켜진 상태를 유지하면 클라이언트가 연결을 시작한 것입니다. 선택한 서버에 도달할 수 있는지, 특정 웹사이트가 프록시를 사용하는지까지 증명하는 것은 아닙니다. 스위치를 켜자마자 다시 꺼진다면 안내 문구와 당시 네트워크 유형을 기록하고 실패 단계별 문제 해결을 진행합니다. 스위치를 반복해서 켜고 끌 필요는 없습니다. 상태가 안정되면 다음 단계에서 확인합니다.

Shadowrocket의 Home 화면. 상단에 Not Connected와 스위치가 있고 아래에 Global Routing, Connectivity Test, SERVER가 표시됨
Home: 상단 스위치, 라우팅 요약, 테스트 항목이 한 화면에 있습니다.
04 · 확인

Connectivity Test와 실제 접속 결과 비교

세 단계로 확인합니다. 스위치가 켜진 상태를 유지하는지, 선택한 서버가 이번 테스트를 통과하는지, 대상 사이트에 예상대로 접속되는지 살펴봅니다. 앞 단계가 통과되어야 다음 단계를 확인할 수 있지만, 앞 단계의 결과를 뒤 단계의 결과로 대신할 수는 없습니다.

  1. 테스트 대상을 확인합니다. Home에서 선택된 서버를 확인한 뒤 Connectivity Test를 누르고 이번 테스트가 끝날 때까지 기다립니다. 해당 항목의 결과를 확인합니다. 다른 항목에 남아 있는 수치를 현재 항목의 결과로 보지 않습니다. 테스트 응답은 현재 네트워크와 테스트 조건에서 응답을 받은 것을 뜻합니다. 실제 다운로드 속도는 아니며 모든 대상에 접속할 수 있음을 보장하지 않습니다.
  2. 실제로 사용할 사이트를 엽니다. 브라우저에서 평소 접속할 수 있는 사이트를 열고 페이지를 새로고침해 이전 탭에 캐시된 내용만 표시된 것은 아닌지 확인합니다. 평소 Config를 사용한다면 현재 규칙으로 처리 방식을 판단할 수 있는 사이트도 선택해 실제 동작을 확인합니다. 평소 Direct로 접속되는 페이지 하나만 열어서는 연결이 Direct인지 프록시를 거치는지 구분할 수 없습니다.
  3. 결과가 다르면 한 가지 조건만 비교합니다. 같은 네트워크, 같은 서버, 같은 대상 주소를 유지하고 필요한 경우에만 Config, Proxy 또는 Direct로 잠시 전환해 매번 같은 방식으로 다시 시도합니다. Proxy에서는 접속되지만 Config에서는 되지 않으면 현재 파일과 규칙 순서를 확인합니다. Direct에서도 평소 접속 가능한 페이지가 열리지 않으면 현재 네트워크 또는 대상 사이트를 먼저 확인합니다. 테스트가 끝나면 평소 사용할 모드로 복원합니다.
05 · 문제 해결

실패 단계에 따라 권한, 서버, 설정 확인

예상한 결과를 처음 얻지 못한 단계로 돌아갑니다. 앱을 다시 설치하거나 구성을 지울 필요는 없습니다. 스위치가 켜지지 않으면 권한을 먼저 확인하고, 스위치는 켜져 있지만 테스트 응답이 없으면 선택한 서버를 확인합니다. 테스트 결과는 있지만 접속에 문제가 있으면 라우팅과 대상 사이트를 살펴봅니다. 한 번에 한 항목만 변경하고 Home으로 돌아가 앞 절에서 확인한 동일한 항목을 다시 검사합니다.

스위치가 꺼지거나, 끈 뒤 연결이 다시 나타나는 경우

스위치가 꺼지면 먼저 시스템 VPN 승인이 완료되었는지 확인한 다음 기기에서 사용 중인 다른 VPN이 있는지 살펴봅니다. 개인 기기에서 다른 연결을 잠시 끊어도 괜찮은지 확인했다면 연결을 끊고 다시 시도할 수 있습니다. 구성을 바로 삭제하지 않습니다. 반대로 수동으로 끈 뒤 네트워크를 변경했을 때 다시 연결된다면 Settings에서 On Demand에 조건이 설정되어 있는지 확인합니다. 문제를 확인하는 동안 직접 설정한 주문형 연결을 잠시 비활성화하고, 확인 후 원래 사용 목적에 맞게 복원할 수 있습니다.

가져온 뒤 항목이 없거나 테스트 응답이 계속 없는 경우

구독 그룹이 비어 있다면 구독 항목으로 돌아가 원본 링크가 온전한지 확인하고, 업데이트할 때 기기 자체가 네트워크에 연결되어 있는지 확인합니다. 업데이트 오류가 표시되면 기존 서비스 제공자에게 링크 상태를 확인합니다. 수동으로 추가한 항목에 테스트 응답이 계속 없다면 해당 항목으로 돌아가 Type, Host, Port, 인증 정보를 하나씩 확인합니다. 인증 정보를 임의로 변경해 해결하려고 하지 않습니다. 같은 그룹의 다른 항목은 같은 조건에서 통과하는데 특정 항목만 실패하면 해당 항목을 먼저 확인합니다. 같은 네트워크에서 모든 항목이 실패하면 사용 가능한 것으로 확인된 다른 네트워크와 비교합니다.

Settings에서 Test Method를 확인하고 테스트 결과를 비교할 때는 가능한 한 같은 방법을 사용합니다. 테스트 방식이 다르면 결과도 달라질 수 있으므로 표시된 수치를 그대로 비교할 수 없습니다. 문제를 계속 추적해야 한다면 Diagnostics에서 재현 시간대와 관련된 정보를 확인합니다. 문제 해결 자료를 공유하기 전에 구독 링크, 비밀번호, 계정, 공개하면 안 되는 주소를 가립니다.

테스트 결과는 있지만 일부 페이지가 열리지 않는 경우

먼저 문제가 특정 도메인이나 페이지 일부에서만 발생하는지 확인합니다. 페이지는 열리지만 로그인이나 이미지가 실패한다면 메인 페이지와 실패한 리소스의 도메인이 다를 수 있습니다. Config로 돌아가 현재 파일에서 먼저 일치하는 규칙이 있는지 확인한 다음 FINAL을 살펴봅니다. 문제가 보인다고 모든 연결을 프록시로 변경하지 않습니다. 원래 설정으로 돌아온 뒤 문제가 해결되면 기존 구성을 유지하고 어떤 변경이 결과에 영향을 주었는지 기록합니다. 규칙 세부 사항, Data, 일상적인 관리 방법은 전체 사용 설명서에서 확인할 수 있습니다.

Shadowrocket의 Settings 화면. Test Method, On Demand, Diagnostics 및 기타 설정 항목이 표시됨
Settings: 증상에 따라 Test Method, On Demand 또는 Diagnostics를 확인합니다.