공식 가이드 · 첫 연결

Shadowrocket 시작 가이드

기존 구독을 가져온 뒤 규칙 분기를 확인하는 순서로 첫 연결을 완료하세요.

STEP 01

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

Shadowrocket을 열고 하단의 Home으로 이동한 다음 오른쪽 위의 더하기 버튼을 눌러 Add Server를 엽니다. 먼저 보유한 정보를 구분하세요. 구독 링크는 여러 서버를 동기화하는 데 사용하고, 단일 서버 정보에는 프로토콜, 주소, 포트 및 관련 인증 정보가 포함됩니다. 아래에서 정보 유형에 맞는 방법 하나를 선택하면 됩니다. 먼저 구독을 가져온 뒤 항목별로 직접 입력할 필요는 없습니다.

구독 링크가 있는 경우: Subscribe 선택

Type을 누르고 Subscribe를 선택한 뒤, 서비스 제공자에게서 받은 전체 링크를 URL에 붙여 넣습니다. 링크에 물음표와 그 뒤의 매개변수가 있으면 모두 포함해야 합니다. 앞부분의 도메인만 복사하면 구독 내용을 가져오지 못하는 경우가 많습니다. 저장한 뒤 Home으로 돌아가 구독이 동기화될 때까지 기다린 다음 해당 그룹을 펼쳐 항목을 확인합니다. 저장 직후 목록이 비어 있으면 그룹 메뉴에서 수동으로 한 번 업데이트한 뒤 결과에 따라 문제를 확인하세요.

단일 서버 정보가 있는 경우: 프로토콜에 맞게 입력

Type에서 서비스 제공자가 표시한 프로토콜을 선택합니다. 예를 들어 Shadowsocks 또는 Trojan을 선택할 수 있습니다. 주소는 Host에, 포트는 Port에 입력합니다. 양식에 Password, Method 또는 다른 항목이 표시되면 보유한 정보에 맞춰 입력하세요. Host는 구독 링크가 아니며, 주소 뒤에 포트를 덧붙일 필요도 없습니다. Type을 바꾸면 입력 항목이 달라지므로 한 프로토콜의 정보를 다른 프로토콜에 적용하지 마세요. 서비스 제공자가 QR 코드도 제공했다면 Add Server에서 Scan QR Code를 사용해 가져온 다음, 읽어 온 프로토콜과 주소가 같은 서버에 해당하는지 확인하세요.

저장한 뒤 Home으로 돌아가 SERVER 영역에서 새 항목을 찾아 이번에 사용할 서버를 선택합니다. 목록에 항목이 표시된다는 것은 정보가 저장되었다는 뜻일 뿐입니다. 항목을 선택해야 다음 단계에서 분기 규칙이 프록시를 사용할 때 연결 대상이 지정됩니다. 상단 스위치는 끈 상태로 두고 Global Routing을 확인하세요.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method 및 Scan QR Code 항목 표시
Add Server: Type을 선택한 뒤 해당 프로토콜에 표시되는 항목을 입력합니다.

STEP 02

Global Routing 모드 선택

Home에서 Global Routing을 누르고 이번 작업에 맞는 모드를 선택합니다. 여기서 설정하는 것은 클라이언트가 요청을 처리하는 방식이며, 선택한 서버나 연결 스위치는 변경되지 않습니다. 처음 규칙에 따라 트래픽을 분기하려면 Config를 선택하세요. 문제가 규칙 때문인지 회선 때문인지 구분해야 할 때는 나머지 두 모드로 잠시 바꾸어 비교하면 됩니다.

구성(Config)
현재 활성화된 구성 파일에 따라 요청을 매칭합니다. 규칙에서 지정한 PROXY, DIRECT, REJECT 등의 결과에 따라 요청이 프록시를 사용하거나 직접 연결되거나 거부됩니다.
프록시(Proxy)
클라이언트가 처리하는 요청을 프록시로 보냅니다. 같은 주소에 현재 서버로 접속할 수 있는지 확인하는 데 임시로 사용할 수 있습니다. 테스트가 끝나면 평소에 사용할 모드로 다시 전환하세요.
직접 연결(Direct)
클라이언트가 처리하는 요청을 직접 연결합니다. 같은 주소에 접속할 때 비교 기준으로 사용할 수 있습니다. 이 모드를 선택해도 상단 스위치가 꺼지는 것은 아닙니다.

구성(Config)을 선택한 뒤 하단의 Config 탭을 눌러 현재 활성화된 파일을 확인합니다. 이름이 같은 두 항목의 차이에 유의하세요. Global Routing의 Config는 규칙에 따라 처리할지를 정하고, 하단의 Config는 실제로 읽을 구성 파일을 관리합니다. 파일 목록에 구성이 여러 개 있으면 현재 활성화된 파일을 기준으로 확인하세요. 파일 이름이나 마지막 편집 시간만 보지 마세요.

현재 구성의 세부 정보를 열어 Rule에서 매칭 조건과 해당 정책을 확인할 수 있습니다. 규칙은 일반적으로 순서대로 검사됩니다. 앞선 규칙이 이미 매칭되었다면 마지막의 FINAL은 결과를 덮어쓰지 않습니다. 첫 연결을 위해 Add Rule을 누를 필요는 없습니다. PROXY를 사용할 것으로 예상되는 주소 하나와 DIRECT를 사용할 것으로 예상되는 주소 하나를 확인해 두고, 네 번째 단계에서 비교하세요. 구성에 어떤 규칙이 있는지 아직 불확실하다면 먼저 프록시(Proxy)로 연결 테스트를 한 뒤 구성(Config)으로 돌아가 분기 규칙을 확인하세요.

Shadowrocket의 Config 파일 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config 파일 편집 화면: Rule에서 규칙을 확인할 수 있으며 첫 연결을 위해 새 규칙을 추가할 필요는 없습니다.

STEP 03

Home에서 연결 스위치 켜기

Home으로 돌아가 먼저 SERVER에서 선택한 항목이 맞는지 확인하고, Global Routing 행에 방금 선택한 모드가 표시되는지 확인합니다. 그런 다음 상단의 Not Connected 옆 스위치를 누릅니다. 처음 켤 때 시스템에서 VPN 구성을 추가하라는 안내가 표시될 수 있습니다. 안내가 Shadowrocket에서 시작된 것인지 확인한 뒤 추가를 허용하고 기기 안내에 따라 인증을 완료하세요.

Home으로 돌아가 상단 상태가 Not Connected에서 Connected로 바뀔 때까지 기다립니다. 스위치가 꺼진 상태라면 방금 시스템 작업이 완료되었는지 확인한 뒤 다시 시도하세요. 스위치를 연속해서 누르면 시스템이 아직 처리 중인지, 방금 켠 연결을 다시 껐는지 구분하기 어렵습니다. 기기에서 다른 VPN이 실행 중이라면 해당 구성을 임의로 삭제하지 마세요. 허용되는 경우 현재 연결을 먼저 종료한 다음 Shadowrocket에서 다시 시도하세요. 조직에서 관리하는 기기라면 관리자에게 먼저 제한 사항을 확인하세요.

Connected는 클라이언트 연결이 시작되었다는 뜻이지, 선택한 서버가 테스트를 통과했다거나 모든 웹페이지가 프록시를 거친다는 뜻은 아닙니다. 특히 구성(Config) 모드에서는 일부 요청이 직접 연결되는 것이 예상된 결과일 수 있습니다. 첫 확인은 수동 스위치로 진행하고 On Demand는 아직 조정하지 마세요. 네트워크를 바꾸거나 앱을 백그라운드에서 다시 열 때 연결 상태가 이번 조작으로 바뀐 것인지 더 쉽게 구분할 수 있습니다.

이제 현재 네트워크와 서버를 그대로 유지한 채 앱에서 먼저 테스트하고 브라우저에서 확인합니다. 스위치를 켠 직후 Not Connected로 돌아간다면 규칙을 바꾸기 전에 다섯 번째 단계의 시스템 권한 및 스위치 문제 해결로 바로 이동하세요.

Shadowrocket의 Home 화면. Not Connected 스위치, Global Routing, Connectivity Test, SERVER 그룹 및 Add Server 표시
Home: 상단에서 연결 스위치를 확인하고, 아래에서 Global Routing을 확인하거나 Connectivity Test를 실행할 수 있습니다.

STEP 04

Connectivity Test와 웹페이지로 확인

Home에서 Connectivity Test를 누르고 테스트가 완료될 때까지 기다린 다음, 이번에 선택한 서버의 결과를 확인합니다. 테스트 성공은 현재 네트워크에서 해당 서버가 이번 탐색에 응답했다는 뜻입니다. 소요 시간이 표시되더라도 대상 웹페이지가 반드시 열린다고 판단할 수는 없습니다. 테스트에 실패하면 어떤 서버를 대상으로 했는지 먼저 확인하고 기기의 네트워크가 작동하는지도 점검하세요. 한 번 시간 초과가 발생했다고 구성을 바로 다시 작성하지 마세요.

그런 다음 브라우저를 열고 두 번째 단계에서 구성 파일을 바탕으로 골라 둔 두 주소에 접속합니다. 먼저 PROXY를 사용할 것으로 예상되는 주소를 열고, 이어서 DIRECT를 사용할 것으로 예상되는 주소를 엽니다. 같은 전체 주소를 사용해 새로고침하고 다른 도메인으로 이동하는지 살펴보세요. 이동한 뒤 발생하는 요청은 새 도메인을 기준으로 별도 매칭됩니다. 웹페이지에 포함된 다른 도메인의 이미지와 스크립트도 다른 정책을 따를 수 있으므로, “페이지가 열렸다”는 것은 접속 결과만 보여 줄 뿐 페이지의 모든 트래픽이 프록시를 거쳤다는 증거는 아닙니다.

결과가 예상과 다르면 네트워크, 서버, 테스트 주소를 고정한 다음 Global Routing만 한 번에 하나씩 바꿉니다. 같은 주소가 프록시(Proxy)에서는 열리지만 구성(Config)에서는 열리지 않는다면 현재 구성, 대상 도메인 및 규칙 순서를 먼저 확인하세요. 프록시(Proxy)와 직접 연결(Direct) 모두 실패한다면 URL, 현재 네트워크 및 대상 사이트의 상태를 먼저 점검하세요. 현상만으로 규칙 오류라고 단정할 수는 없습니다.

STEP 05

증상에 따라 문제 범위 좁히기

구독을 저장했지만 목록이 비어 있음

먼저 Home에서 구독 그룹을 펼쳐 접힌 상태가 아닌지 확인합니다. 그래도 비어 있다면 구독 항목으로 돌아가 Type이 Subscribe인지, 링크의 시작과 끝 및 쿼리 매개변수가 모두 포함되었는지 확인한 뒤 수동으로 한 번 업데이트합니다. 링크가 만료되었거나 접근이 거부되었다는 안내가 나오면 서비스 제공자에게 구독 상태를 확인하세요. 전체 링크를 공개된 곳에 붙여 넣지 마세요. 링크에 포함된 매개변수만으로도 구독에 접근할 수 있습니다.

스위치를 켜자마자 원래대로 돌아가거나 연결이 끊긴 뒤 자동으로 다시 연결됨

스위치가 바로 돌아가면 먼저 시스템의 VPN 구성 권한을 허용했는지, 다른 VPN이 연결을 사용 중인지 확인합니다. 연결을 끊은 뒤 자동으로 다시 연결된다면 하단의 Settings에서 On Demand를 열고 현재 네트워크가 설정된 조건에 해당하는지 확인하세요. 수동 스위치를 확인하려면 On Demand를 잠시 끄고 같은 네트워크에서 다시 시도합니다. 원인을 확인한 뒤 실제 필요한 설정으로 복구하세요.

Connected로 표시되지만 요청에 실패함

여러 서버의 테스트 결과가 모두 이상하다면 먼저 Settings에서 Test Method를 확인하고 전후 테스트에 같은 방법을 사용했는지 확인한 다음 Home으로 돌아가 다시 테스트합니다. 일부 서버만 실패한다면 해당 서버의 프로토콜, 주소, 포트 및 인증 정보를 다시 확인하세요. 구성(Config)으로 전환했을 때만 실패한다면 해당 도메인이 더 앞선 규칙에 매칭되는지, 또는 앞선 규칙에 매칭되지 않아 FINAL로 이동하는지 확인하세요.

문제를 더 확인하려면 Settings에서 Diagnostics를 열어 진단 정보를 확인할 수 있습니다. 재현에 필요한 네트워크 유형, 사용 모드, 실패 단계 및 오류 안내만 기록하세요. 다른 사람에게 문의하기 전에 서버 인증 정보와 구독 링크를 가리세요. 분기 키워드, 권한 안내 및 기타 증상은 자주 묻는 질문에서 확인하고, 스토어 지역, 정품 확인 및 기기 변경 후 복원은 정품 가이드를 참조하세요.

Shadowrocket의 Settings 화면. Test Method, On Demand, Diagnostics, Proxy, TCP 및 UDP 설정 항목 표시
Settings: 증상에 따라 Test Method, On Demand 또는 Diagnostics를 확인하고 한 번에 한 항목만 변경하세요.