공식 가이드 · 첫 설정

Shadowrocket 사용법

기존 구독을 준비하고 추가, 트래픽 분기, 연결, 확인을 차례로 진행합니다. 먼저 연결을 안정적으로 설정한 다음 규칙과 자동 연결 조건을 조정하세요.

서버 항목이 이미 있으면 02단계부터 시작하세요. 스위치가 켜져 있는데 접속에 문제가 있다면 04, 05단계를 확인하세요.

STEP 01 / IMPORT

서버 추가 및 구독 가져오기

Shadowrocket을 열고 Home 화면에 머뭅니다. 아래 SERVER 그룹에 서버가 표시됩니다. 항목이 없다면 먼저 Add Server를 누릅니다. 추가 화면에서 첫 번째 Type 항목을 선택하면 이후 입력할 필드가 정해집니다. 구독 링크와 개별 서버 매개변수는 서로 다른 입력 방식입니다. 구독 주소를 Host에 입력하거나 서버 주소를 구독 링크로 제출하지 마세요.

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

구독 URL이 있다면 Type에서 Subscribe를 선택한 다음 전체 링크를 URL에 입력합니다. 링크는 서비스 제공업체에서 받으세요. 복사할 때 물음표 뒤의 내용을 포함한 전체 문자열을 유지하고, 앞뒤에 붙은 공백이나 줄바꿈은 제거합니다. 알아보기 쉬운 이름을 입력하고 저장한 뒤 클라이언트가 구독 정보를 가져올 때까지 기다립니다. Home으로 돌아와 해당 그룹과 서버 항목이 표시되는지 확인합니다.

구독은 업데이트할 수 있는 서버 목록이며 Config의 규칙 파일과는 다릅니다. 목록에 항목이 나타나면 이번에 가져오기가 완료되었다는 뜻일 뿐, 모든 항목의 연결 가능 여부까지 보장하지는 않습니다. 저장 후 그룹이 비어 있다면 링크가 완전한지, 아직 유효한지, 현재 네트워크에서 내용을 가져올 수 있는지 먼저 확인하세요. 문제를 확인하기 위해 같은 그룹을 반복해서 추가하지 마세요. 구독 링크에는 접속 정보가 포함될 수 있으므로 다른 사람에게 문제를 설명할 때 전체 링크를 그대로 공개하지 마세요.

서버 매개변수가 있는 경우: Type에 맞춰 입력

직접 추가할 때는 먼저 서비스 제공업체가 안내한 프로토콜에 맞게 Type을 변경한 뒤 Host와 Port를 입력합니다. 화면에는 Password와 Method가 포함된 추가 양식이 표시되어 있지만, 프로토콜을 바꾸면 실제 입력 항목도 달라집니다. Shadowsocks는 Method와 Password를 확인합니다. VMess와 VLESS는 UUID 및 전송 관련 매개변수를 확인합니다. TLS를 사용하는 경우 해당 서버 이름 등의 설정도 확인하세요. 포트 번호만 보고 프로토콜을 추측하거나 안내받지 않은 매개변수를 임의의 일반적인 값으로 채우지 마세요.

QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. Import from Cloud JSON은 해당 형식의 설정을 가져올 때 쓰며, 모든 구독 URL을 가져오는 일반 버튼은 아닙니다. 저장한 뒤 Home으로 돌아와 이름, 프로토콜, 그룹이 예상과 일치하는지 확인합니다. 이 단계에서는 아직 스위치를 켜지 말고, 다음 단계에서 Global Routing을 먼저 확인해 이후 테스트의 기준을 정하세요.

Shadowrocket Add Server 공식 화면. Type, Host, Port, Password, Method 및 하단 가져오기 항목이 표시됩니다
Add Server: 먼저 Type을 선택한 다음 보유한 정보에 맞춰 입력합니다. 프로토콜에 따라 입력 항목이 달라집니다.

STEP 02 / ROUTING

Global Routing 선택

Home으로 돌아와 Global Routing을 눌러 현재 모드를 확인합니다. 여기서는 연결에 적용할 정책을 선택하며 서버 매개변수를 보완하지는 않습니다. 세 가지 모드는 Config, Proxy, Direct입니다. 연결 테스트 전에 현재 선택을 확인하면 규칙에 따른 직접 연결을 서버가 작동하지 않는 것으로 오해하지 않을 수 있습니다.

Config: 규칙에 따라 연결 경로 결정

일상적으로 규칙에 따라 트래픽을 분기하려면 Config를 선택합니다. 그런 다음 하단의 Config를 열어 사용할 설정 파일이 선택되어 있는지 확인합니다. 파일 목록에 보이는 것만으로 선택된 것은 아닙니다. 파일을 열면 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 구역을 확인할 수 있습니다. 첫 연결에서는 기존 Rule과 정책이 서로 맞는지만 살펴보면 됩니다. 기본 연결을 위해 모든 구역을 조정하거나 HTTPS Decryption을 켤 필요는 없습니다.

Rule은 보통 위에서 아래 순서로 일치 여부를 확인하며, 먼저 일치한 규칙이 해당 연결에 적용될 정책을 결정합니다. DOMAIN-SUFFIX는 도메인 접미사를 기준으로 일치시키고, IP-CIDR은 주소 범위를 일치시킬 수 있습니다. FINAL은 앞선 규칙에 일치하지 않는 경우에 사용합니다. PROXY와 DIRECT는 각각 프록시와 직접 연결 경로를 뜻합니다. Add Rule을 사용하기 전에 기존 규칙의 위치와 정책 이름을 확인하세요. 범위가 넓은 규칙을 앞에 두면 뒤의 구체적인 규칙에 먼저 적용될 수 있습니다.

Proxy와 Direct: 연결 경로 구분

Proxy는 클라이언트가 처리하는 연결을 선택한 프록시 경로로 보냅니다. 문제를 점검할 때 규칙 차이로 인한 영향을 줄이는 데 쓸 수 있지만, 사용할 수 없는 서버를 자동으로 복구하지는 않습니다. Direct는 직접 연결 경로를 사용합니다. 이를 프록시 서버가 작동한다는 근거로 삼아서는 안 됩니다. 현재 네트워크에서 접속할 수 있는 웹사이트라면 Direct를 선택해도 정상적으로 열릴 수 있습니다.

이번에는 기존 설정으로 Config를 선택하고 현재 모드를 기억해 둡니다. 비교를 위해 Proxy로 잠시 전환했다면 테스트가 끝난 뒤 원래 설정으로 되돌리세요. 규칙의 유효성은 실제 연결 기록을 함께 살펴봐야 판단할 수 있습니다. Config 파일이 있다는 이유만으로 트래픽 분기가 올바르다고 단정하지 마세요. 다음으로 Home으로 돌아가 기본 서버를 선택하고 연결합니다.

Shadowrocket Config 공식 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시됩니다
Config: 선택된 파일의 Rule을 확인합니다. 설정 편집 화면과 Home의 Global Routing 선택은 서로 다른 위치에서 수행합니다.

STEP 03 / CONNECT

기본 서버 선택 및 연결 시작

Home으로 돌아와 SERVER 그룹에서 사용할 서버를 선택합니다. 선택된 항목에는 점 표시가 나타납니다. 이를 확인해 기본 서버를 지정하세요. 목록에서 가장 위에 있는 항목을 기준으로 삼지 마세요. 항목 상세 화면에 들어가는 것과 항목을 선택하는 것은 다릅니다. 매개변수를 확인한 다음 목록으로 돌아와 테스트할 서버에 점 표시가 있는지 확인합니다.

기본 서버를 정한 뒤 Home 상단의 스위치를 켭니다. 처음 활성화할 때 시스템에서 VPN 구성을 추가하도록 허용할지 묻습니다. 요청을 보낸 앱이 Shadowrocket인지 확인한 뒤 허용하고, 시스템 안내에 따라 기기 인증을 완료합니다. 이 권한은 클라이언트가 해당 네트워크 트래픽을 처리하도록 합니다. 서버를 새로 만들거나 만료된 구독을 다시 활성화하지는 않습니다.

권한을 허용한 뒤 Shadowrocket으로 돌아와 상단에 Not Connected가 계속 표시되는지 확인합니다. 스위치가 바로 꺼지면 DNS를 변경하기 전에 시스템 권한 또는 구성 생성 실패부터 확인하세요. 연결 상태가 설정되었다면 다음 단계에서 테스트합니다. 시스템의 VPN 표시는 관련 연결이 활성화되었다는 뜻일 뿐, 원격 서버, DNS, 대상 웹사이트가 모두 정상이라는 보장은 아닙니다.

첫 확인을 진행하는 동안에는 복잡한 On Demand 조건을 설정하거나 네트워크를 처리하는 여러 VPN 구성을 동시에 활성화하지 않는 편이 좋습니다. 먼저 수동 연결 결과를 안정적으로 확인한 뒤 자동화 조건을 하나씩 추가하세요. 다른 서버로 바꿔야 한다면 현재 선택 항목과 테스트 결과를 기록해 두고, 서버를 바꾼 뒤 같은 테스트를 반복합니다. 대상 웹사이트, 네트워크, 서버를 동시에 바꾸면 결과를 비교하기 어렵습니다.

시스템 권한 요청에서 취소를 선택했다면 Home으로 돌아와 스위치를 다시 조작하고 시스템 안내를 확인하세요. 기기가 관리 정책의 제한을 받는 경우 기기에서 허용된 VPN 설정을 확인해야 합니다. 기본 연결이 설정되면 네트워크를 바꾸지 말고 Connectivity Test와 실제 접속을 함께 확인합니다.

Shadowrocket Home 공식 화면. Not Connected 스위치, Global Routing, Connectivity Test, SERVER 그룹 및 Add Server가 표시됩니다
Home: 먼저 서버의 점 표시를 확인한 다음 상단 스위치를 켜고 Connectivity Test를 진행합니다.

STEP 04 / VERIFY

실제 요청으로 적용 확인

Home에서 Connectivity Test를 눌러 클라이언트가 테스트 결과를 반환하는지 확인합니다. 테스트 방식에 따라 결과의 의미가 달라지므로 Test Method가 다르면 수치를 직접 비교할 수 없습니다. 테스트 성공은 해당 탐지 조건에서 응답을 받았다는 뜻이지, 모든 웹사이트에 접속할 수 있다는 뜻은 아닙니다. 표시된 시간도 다운로드 속도가 아니므로 대역폭 수치로 해석하지 마세요.

그런 다음 브라우저를 열어 정상 작동 여부를 알고 있고 로딩 결과를 명확하게 판단할 수 있는 대상에 접속합니다. 여러 페이지를 동시에 열거나 캐시된 페이지가 계속 표시되는지만 확인하지 마세요. 대상 페이지를 한 번 새로고침해 새 요청이 발생하는지 확인한 뒤 Shadowrocket으로 돌아와 상태를 살펴봅니다. 테스트는 성공했는데 특정 웹사이트만 실패한다면 모든 설정을 삭제하는 대신 도메인 확인, 규칙 경로, 웹사이트 자체의 응답을 구분해 점검해야 합니다.

Config를 사용한다면 Data에서 방금 발생한 연결 기록도 확인합니다. 접속 시간을 기준으로 대상 항목을 찾아 도메인 또는 주소, 일치한 규칙, 최종 정책을 확인하세요. 자세한 정보는 현재 화면에 표시된 내용을 기준으로 합니다. 결과가 DIRECT라면 해당 규칙이 직접 연결을 요구하는지 먼저 확인합니다. PROXY를 예상했는데 앞쪽의 광범위한 규칙이 일치했다면 규칙 순서를 조정하는 것이 적절합니다.

트래픽 분기를 확인하려면 직접 연결이 예상되는 대상과 프록시 연결이 예상되는 대상을 각각 방문한 뒤 기록을 확인합니다. 페이지가 열리는지만으로는 두 경로를 구분할 수 없습니다. 같은 대상이 서로 다른 경로에서도 접속될 수 있기 때문입니다. 기록에 요청이 남아 있어도 요청이 최종적으로 성공했다고 단정할 수는 없으므로 실제 페이지 결과와 오류 메시지도 함께 확인합니다.

한 차례 확인을 마친 뒤 로컬 네트워크가 Wi-Fi인지 셀룰러인지, 현재 기본 서버, Global Routing 모드, 실제로 실패한 대상을 기록합니다. 이후에는 한 번에 조건 하나만 변경하세요. 첫 테스트에서 확인할 순서를 더 알아보려면 첫 연결 및 Connectivity Test 안내를 참고하세요. 이번 단계가 모두 정상이라면 기본 설정 과정은 완료된 것입니다.

STEP 05 / DIAGNOSE

단계별로 확인하는 일반적인 실패 원인

문제가 발생하면 현재 설정을 유지하고 어느 단계에서 오류가 났는지 기록합니다. 가져오기 실패, 스위치가 켜진 상태로 유지되지 않는 문제, 테스트 시간 초과, 일부 웹사이트의 이상은 서로 다른 문제이며 확인할 위치도 다릅니다. 아래 순서대로 확인하고 항목을 하나씩 점검할 때마다 같은 대상을 다시 테스트하세요. 서버, DNS, 규칙을 동시에 바꾸는 것보다 원인을 찾기 쉽습니다.

먼저 로컬 네트워크와 입력 내용 확인

Shadowrocket 연결을 먼저 끊고 현재 네트워크에서 일반적인 접속이 가능한지 확인합니다. 공용 Wi-Fi에 로그인해야 한다면 먼저 로그인하세요. 특정 네트워크에서만 실패한다면 다른 네트워크로 한 번 비교해 볼 수 있습니다. 네트워크를 바꾼 뒤 문제가 해결되었다면 기존 네트워크 조건을 더 확인해야 합니다. Config 전체를 바로 다시 작성할 필요는 없습니다.

구독을 업데이트할 수 없다면 전체 링크, 유효 기간, 현재 네트워크에서의 접속 가능 여부를 확인합니다. 구독 업데이트 실패가 기존 항목을 삭제한다는 뜻은 아니며, 기존 항목이 모두 작동하지 않는다는 뜻도 아닙니다. 가져온 뒤 특정 서버를 사용할 수 없다면 해당 서버의 매개변수 화면으로 돌아가 Type, Host, Port, 인증 정보, TLS 및 전송 계층 설정을 차례로 대조합니다. 서비스 제공업체에 문의할 때는 구체적인 오류를 설명하고 링크나 인증 정보를 공개하지 마세요.

서버 문제와 규칙 문제 구분

모든 대상에서 실패한다면 기본 서버를 올바르게 선택했는지 확인하고 보유한 다른 서버 항목으로 비교합니다. Proxy에서는 접속되지만 Config로 되돌린 뒤 실패한다면 Rule의 일치 순서, 지정된 정책, DNS 관련 설정을 확인합니다. 일부 도메인만 문제가 있다면 해당 도메인의 기록부터 확인하세요. 한 대상의 실패만으로 전체 연결이 끊겼다고 판단하지 마세요.

Settings에서 Test Method를 확인해 이전 테스트와 동일한 방식으로 진행할 수 있습니다. 추가 오류 정보가 필요하면 Diagnostics를 사용하세요. 진단 기록에는 도메인, 주소, 설정 세부 정보가 포함될 수 있으므로 공유 전에 개인 정보를 삭제해야 합니다. On Demand는 조건에 따라 연결 동작에 영향을 줍니다. 수동으로 연결을 끊은 뒤 다시 연결되거나 네트워크 변경 후 상태가 달라진다면 관련 조건이 활성화되어 있는지도 확인하세요.

마지막으로 최소 설정으로 재확인

DNS를 변경하기 전에 기존 값을 기록하고, 설정을 한 번에 하나씩 변경한 뒤 새 요청을 보냅니다. 비교를 위해 임시로 변경한 설정은 테스트가 끝나면 되돌려 용도가 불분명한 설정이 남지 않도록 합니다. 기록에는 “어떤 네트워크, 어떤 서버, 어떤 모드, 어떤 대상, 어떤 현상”이 포함되어야 합니다. 그래야 로컬 네트워크, 서버 설정, 규칙 일치 문제를 구분할 수 있습니다.

스토어 지역이나 구매 복원 등 앱 받기 관련 문제는 App Store 이용 안내를 확인하세요. 연결은 되지만 속도가 느리다면 속도 저하의 단계별 점검을 참고하세요. 전체 작업 순서를 다시 확인하려면 같은 구독을 반복해서 가져오는 대신 이 가이드의 01단계부터 진행합니다.

Shadowrocket Settings 공식 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP가 표시됩니다
Settings: 문제를 점검할 때 Test Method, On Demand, Diagnostics를 확인하고 한 번에 한 항목만 변경하세요.

다른 기기의 다운로드 경로

이 페이지의 사용 방법은 iPhone / iPad를 예로 설명합니다. iPhone / iPad 버전은 App Store에서 $2.99에 일회성 결제로 제공됩니다. Mac(Apple 칩 및 Intel) / Windows / Android / Linux 버전은 무료입니다. 컴퓨터 및 Android 설치 파일은 이 사이트의 다운로드 페이지에서 받을 수 있으며, 설치 파일 주소는 사이트의 /dl/ 경로에서 제공합니다.

처음 실행할 때 시스템에서 차단하면 먼저 다운로드 출처를 확인한 다음 설치 허용 안내를 따르세요. macOS에서는 “개인정보 보호 및 보안”, Windows에서는 SmartScreen의 “추가 정보”, Android에서는 “알 수 없는 앱 설치 허용”을 확인하고, Linux에서는 패키지 형식에 맞춰 설치 권한을 처리합니다. 안내를 무시한 채 반복해서 다운로드하지 마세요.

클라이언트 일회성 구매와 서비스 요금제는 별개입니다. 구독 링크와 서버 정보는 이용 중인 서비스 제공업체에서 받으세요.