공식 매뉴얼첫 연결

Shadowrocket 사용법

기존 연결 정보를 먼저 가져온 다음 트래픽 라우팅 모드를 선택합니다. 연결을 켠 뒤 실제 접속으로 설정이 적용됐는지 확인합니다.

01 연결 정보 준비

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

Shadowrocket을 열고 Home에서 SERVER 그룹 아래의 Add Server를 찾습니다. 가지고 있는 정보에 따라 한 가지 방법을 선택합니다. 개별 서버의 프로토콜, 주소, 포트가 있다면 직접 추가하고, 서버 목록을 가져오는 구독 링크가 있다면 Subscribe를 사용합니다. 두 정보의 용도는 다릅니다. 구독 링크를 개별 서버의 Host에 입력하면 안 됩니다.

서버 하나만 있는 경우: Type을 선택한 뒤 항목 입력

Add Server에서 먼저 Type을 열고 정보에 표시된 프로토콜을 선택한 다음 Host와 Port를 입력합니다. 프로토콜마다 표시되는 항목이 다릅니다. Password 또는 Method가 보이면 기존 정보를 그대로 입력하고, 다른 서버의 값을 가져와 빈칸을 채우지 마세요. 예를 들어 주소와 포트가 따로 제공되면 해당 항목에 각각 입력하고, 주소 끝에 포트를 중복해서 붙이지 않습니다. 저장하기 전에 주소 앞뒤에 공백이나 줄바꿈이 들어가지 않았는지 확인합니다.

구독 링크가 있는 경우: Subscribe로 가져오기

Add Server의 Type에서 Subscribe를 선택하고 기존의 전체 구독 링크를 주소 항목에 붙여 넣은 다음 저장합니다. 링크를 호스트 이름과 포트로 나누거나 물음표 뒤의 매개변수를 삭제할 필요가 없습니다. Home으로 돌아와 구독 그룹이 로드될 때까지 기다린 뒤 펼쳐서 확인합니다. 링크에 접속 자격 증명이 포함될 수 있으므로 전체 링크를 공개 게시물이나 스크린샷에 올리지 마세요.

다음 단계로 넘어가기 전에: SERVER 아래에서 실제로 선택할 수 있는 서버를 찾아 선택합니다. 직접 설정했다면 항목이 목록에 표시되는지 확인하고, 구독을 설정했다면 그룹에 항목이 있는지 확인합니다. 저장에 성공했다는 것은 정보가 기록됐다는 뜻일 뿐, 서버에 접속할 수 있다는 의미는 아닙니다. 목록이 비어 있다면 연결 스위치를 반복해서 켜고 끄지 말고 5단계를 참고해 가져오기를 확인합니다.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method 항목과 Scan QR Code 및 Import from Cloud JSON 메뉴가 표시됩니다
공식 스크린샷 · Add Server. Type을 먼저 선택한 다음 현재 프로토콜에 해당하는 항목을 입력합니다.
02 트래픽 경로 선택

Global Routing 모드 선택

서버를 선택한 뒤 Home에서 Global Routing을 누르고 현재 작업 목적에 맞는 모드를 선택합니다. 여기서는 트래픽을 처리하는 방식을 정하며, 서버를 선택하는 것이 아닙니다. 예를 들어 SERVER에서 항목을 선택했더라도 직접 연결(Direct)로 전환하면, 목록에서 해당 항목을 선택했다는 이유만으로 일반 접속이 프록시를 사용하지는 않습니다.

구성(Config)
현재 활성화된 구성 파일의 규칙에 따라 요청을 처리합니다. PROXY와 일치하는 요청은 프록시를 사용하고, DIRECT와 일치하는 요청은 직접 연결하며, REJECT와 일치하는 요청은 규칙에 따라 차단합니다. 사용할 수 있는 규칙이 있고 일상적으로 규칙에 따라 사용하려면 이 항목을 선택합니다.
프록시(Proxy)
현재 선택한 서버를 사용해 프록시 경로로 들어오는 트래픽을 처리합니다. 처음 문제를 확인할 때 잠시 이 모드로 전환해 일반 웹페이지에 접속할 수 있는지 확인할 수 있습니다. 확인을 마친 뒤 일상적으로 규칙 분기를 사용하려면 Config로 돌아갑니다.
직접 연결(Direct)
직접 연결 결과를 비교할 때 사용합니다. 예를 들어 같은 웹페이지가 Direct에서는 열리고 Proxy에서는 열리지 않는다면, 규칙을 편집하기 전에 선택한 서버와 테스트 결과를 먼저 확인합니다.

두 가지 Config의 차이: Global Routing의 Config는 모드이고, 하단의 Config는 구성 파일을 관리하는 화면입니다. 규칙을 확인하려면 하단의 Config에서 현재 사용 중인 파일을 찾아 편집 화면을 열고 Rule을 확인합니다. 스크린샷의 Add Rule은 규칙 추가 기능이며 첫 연결 과정에서는 누를 필요가 없습니다. 파일이 여러 개라면 현재 활성화된 파일을 먼저 확인해야 다른 파일의 규칙으로 테스트 결과를 잘못 해석하지 않습니다.

규칙이 올바른지 확실하지 않다면 먼저 Proxy로 대상에 접속한 다음 Config로 돌아와 결과를 비교합니다. 규칙 순서, 기본 정책, 도메인 일치 방식은 프록시 모드에서 확인할 수 있으며, 첫 연결 단계에서 함께 변경할 필요는 없습니다.

Shadowrocket의 Config 파일 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 구역과 Add Rule 메뉴가 표시됩니다
공식 스크린샷 · Config 파일 편집 화면. 여기서는 규칙을 확인하며, 모드를 바꾸려면 Home의 Global Routing으로 돌아갑니다.
03 시스템 연결 설정

Home에서 연결 켜기

Home으로 돌아와 두 위치를 차례로 확인합니다. 첫째, Global Routing 오른쪽에 표시된 모드입니다. 둘째, SERVER 아래에서 현재 선택된 항목입니다. 프록시를 확인하려면 모드가 Proxy이고 서버를 선택한 상태여야 합니다. 기존 규칙을 확인하려면 모드가 Config이고 앞 단계에서 현재 사용 중인 구성 파일을 확인했는지 확인합니다. 두 조건을 확인한 뒤 상단의 Not Connected 옆 스위치를 켭니다.

처음 켜면 시스템에서 VPN 구성을 추가하라는 메시지가 표시될 수 있습니다. 이는 Shadowrocket이 네트워크 터널을 만들기 위해 필요한 시스템 승인으로, Add Server에서 서버를 저장하는 것과는 별개입니다. 방금 실행한 작업 직후에 표시된 메시지이고 앱 이름이 Shadowrocket인지 확인한 다음 시스템 안내에 따라 허용합니다. 기기 인증을 요구하면 인증을 마친 뒤 Home으로 돌아갑니다. 방금 승인을 취소했다면 서버 암호나 포트를 변경하지 말고, 상단 스위치로 연결을 다시 시작해 시스템 요청이 다시 표시되는지 확인합니다.

Home으로 돌아온 후 상단 상태가 전환을 마칠 때까지 기다리고 곧바로 Not Connected로 돌아가지 않는지 확인합니다. 스위치가 원래 상태로 돌아가면 언제 발생했는지 기록합니다. 시스템 안내를 누르기 전인지, 승인 후 돌아왔을 때인지, 연결이 일정 시간 유지된 뒤인지 확인합니다. 앞의 두 경우에는 승인 완료 여부와 다른 VPN이 이미 활성화되어 있는지 먼저 확인합니다. 일정 시간 뒤 끊기는 경우에는 끊기기 전에 무선 네트워크에서 셀룰러 네트워크로 바뀌었는지, 기기가 잠금 화면에서 막 깨어났는지도 확인합니다.

상단에 연결됨으로 표시되면 시스템 연결이 설정됐다는 뜻일 뿐, 모든 요청이 프록시를 사용하거나 선택한 서버가 대상 웹사이트에 접속할 수 있다는 의미는 아닙니다. 선택한 서버와 모드는 그대로 두고 다음 단계에서 테스트합니다. 네트워크를 바꾸고 서버와 모드까지 함께 변경하면 웹페이지가 다시 열리더라도 어떤 변경이 원인이었는지 판단하기 어렵습니다.

Shadowrocket의 Home 화면. 상단에 Not Connected 스위치가 있고 아래에 Global Routing, Connectivity Test, SERVER 그룹의 Add Server가 표시됩니다
공식 스크린샷 · Home. Global Routing과 현재 서버를 먼저 확인한 다음 상단 스위치를 켭니다.
04 결과 비교

연결 및 트래픽 분기 확인

먼저 Home에서 Connectivity Test를 눌러 현재 선택한 항목의 결과를 확인합니다. 정상 결과는 테스트에 사용된 방법과 대상에 그 시점에 접속할 수 있었다는 뜻일 뿐, 브라우저나 다른 앱의 실제 요청을 대신하지 않습니다. 반대로 한 번 시간 초과가 발생했다고 해서 서버를 사용할 수 없는 것은 아닙니다. 테스트 대상에 일시적으로 접속할 수 없어도 실제로 이용할 웹사이트는 정상일 수 있습니다. 결과만 기록하고 한 번의 테스트로 여러 설정을 바로 변경하지 마세요.

그다음 평소 접속할 수 있는 웹페이지를 열고 새로고침하거나 아직 열지 않은 페이지로 이동합니다. 이미 로드된 탭만 보면 브라우저 캐시가 표시될 수 있습니다. 서버 사용 가능 여부를 확인하려면 같은 네트워크와 서버를 유지한 채 Direct와 Proxy에서 같은 대상을 다시 엽니다. 모드를 전환한 뒤 상태가 안정될 때까지 기다렸다가 접속합니다. 진행 중인 다운로드나 이미 연결된 장시간 연결은 이 비교에 적합하지 않습니다.

두 모드 모두 같은 웹페이지를 열 수 있다면 해당 대상에 두 조건 모두 접속할 수 있다는 뜻일 뿐, 페이지 내용만으로 어떤 경로를 사용했는지 판단할 수는 없습니다. 두 모드에서 모두 실패하면 먼저 기기 자체가 평소 이용 가능한 다른 대상에 접속할 수 있는지 확인합니다. Proxy에서만 실패한다면 Home으로 돌아가 서버 테스트 결과를 확인하고 직접 입력한 프로토콜, 포트, 인증 매개변수를 점검합니다. Proxy는 정상이고 Config에서 문제가 발생한다면 서버를 다시 가져올 필요 없이 활성화된 구성 파일을 먼저 확인합니다.

Config를 사용할 때는 기존 규칙 중 PROXY와 DIRECT에 각각 일치할 것으로 예상되는 대상을 골라 새 요청을 보냅니다. 접속한 전체 도메인을 기록하고 웹페이지가 다른 도메인으로 이동했는지, 주 페이지와 페이지에서 불러오는 다른 리소스 중 어느 쪽에서 문제가 발생했는지 확인합니다. 일치한 규칙을 확인해야 한다면 접속 시간과 대상 도메인을 진단 기록과 대조합니다. 테스트가 끝나면 평소 사용할 Global Routing 모드로 복원합니다.

05 증상별 확인

가져오기, 연결 및 규칙 문제 해결

구독은 저장되지만 그룹에 서버가 없음

1단계로 돌아가 Subscribe를 선택했는지 확인하고, 구독 이름이나 서비스 제공업체 웹페이지 주소가 아닌 전체 링크를 붙여 넣었는지 확인합니다. 메신저에서 복사할 때 문장 끝의 구두점이 포함되거나 긴 링크가 중간까지만 복사될 수 있습니다. 현재 기기에서 기본 네트워크가 작동하는지 확인하고 다시 가져온 뒤 목록이 로드될 때까지 기다립니다. 그래도 비어 있다면 기존 서비스 제공업체에 링크가 유효한지, 어떤 형식으로 응답하는지 문의합니다. 자격 증명이 포함된 주소를 공개 테스트 도구에 입력하지 마세요.

스위치가 바로 돌아오거나 연결을 끈 뒤 다시 자동 연결됨

스위치가 바로 돌아오면 처음의 VPN 승인 여부와 시스템 연결 상태를 확인합니다. 기기가 회사나 학교에서 관리된다면 조직에서 제공한 구성을 제거하지 말고 관리자에게 먼저 확인합니다. 수동으로 연결을 끈 뒤 다시 자동 연결되는 문제라면 Settings에서 On Demand가 활성화되어 있는지 확인합니다. 문제를 확인하기 전에 현재 설정을 기록하고, 허용되는 경우에만 On Demand를 잠시 끈 다음 Home 스위치로 수동 테스트를 진행합니다. 결과를 기록한 뒤 필요한 설정을 복원합니다. 처음부터 시스템 구성을 삭제할 필요는 없습니다.

속도 테스트와 실제 접속 결과가 다름

Settings에서 Test Method를 확인하고 현재 테스트 방법을 기록한 다음 Home으로 돌아와 Connectivity Test를 다시 실행합니다. 브라우저로 접속할 수 있지만 테스트가 실패한다면 테스트 대상과 실제 접속 대상을 먼저 구분합니다. 테스트는 성공했지만 웹페이지가 열리지 않는다면 Proxy와 Config를 비교합니다. 테스트 방법, 서버, 네트워크를 동시에 바꾸면 변경 전후 결과를 직접 비교할 수 없습니다.

일부 대상만 예상과 다르게 분기됨

Config에서 현재 적용 중인 파일을 열고 Rule에서 더 앞에 있는 규칙이 해당 도메인과 먼저 일치하는지, 요청이 기본 정책으로 처리되는지 확인합니다. 문제를 재현한 뒤 Settings에서 Diagnostics를 확인하고 접속 시간과 대상 도메인을 기록과 대조합니다. 수정하기 전에 기존 규칙과 위치를 기록하고, 한 번에 한 곳만 변경한 뒤 새 요청으로 다시 테스트합니다. 문제 해결 결과를 공유할 때는 필요한 모드, 시간, 오류 문구만 남기고 서버 주소, 암호, 전체 구독 링크는 가립니다.

연결이 안정적으로 작동한다면 필요에 따라 설정 상세 안내를 참고해 DNS, On Demand, 진단 관련 옵션을 확인합니다. 첫 연결을 완료하기 위해 Settings의 항목을 하나씩 모두 변경할 필요는 없습니다.

Shadowrocket의 Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP, UDP 항목이 나열되어 있습니다
공식 스크린샷 · Settings. 자동 재연결 문제는 On Demand를 확인하고, 테스트 방식과 진단 메뉴도 이 화면에서 찾을 수 있습니다.