Shadowrocket 공식 매뉴얼 · 시작 가이드

Shadowrocket 사용법:
가져오기·연결·확인

기존 설정을 앱에 가져온 뒤 Global Routing을 선택하고 연결을 켭니다. 마지막으로 실제 요청을 통해 결과를 확인하세요. 아래 다섯 단계를 따르고, 어느 한 단계가 완료되지 않으면 모든 Settings를 한꺼번에 바꾸지 말고 해당 단계부터 확인합니다.

진행 순서: 정보 준비 → 항목 저장 → 정책 선택 → 연결 → 확인. 스크린샷은 화면을 찾는 데 참고하세요. 항목 배치와 선택 가능한 옵션은 현재 앱에 표시되는 내용이 기준입니다.

단계 01 / 입력 및 저장

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

먼저 보유한 정보가 구독 링크인지 서버 매개변수인지 확인하세요. 두 입력 방식 중 하나만 사용하면 되며, 중복으로 추가할 필요는 없습니다.

Shadowrocket을 열고 Home으로 이동한 다음 SERVER 그룹 근처에서 Add Server를 찾습니다. 화면의 추가 버튼을 이용해 같은 편집 화면으로 이동할 수도 있습니다. 입력하기 전에 Type을 확인하세요. Type에 따라 표시되는 항목이 달라지므로 양식이 짧다는 이유만으로 프로토콜을 임의로 선택하면 안 됩니다. 구독 링크는 항목 목록을 가져오는 주소입니다. 개별 서버 정보에는 보통 프로토콜, 주소, 포트와 해당 인증 매개변수가 포함되며, 두 정보의 용도는 다릅니다.

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

Add Server의 Type에서 Subscribe를 선택하고 본인이 보유한 전체 구독 링크를 URL에 입력합니다. 붙여넣은 뒤 앞뒤에 공백이나 줄바꿈이 있는지, 주소 일부만 복사되지는 않았는지 확인하세요. 링크의 쿼리 매개변수도 주소의 일부이므로 짧게 만들려고 삭제하지 마세요. 메모를 사용하면 설정 출처를 구분할 수 있지만, 메모는 기기에서 식별하기 위한 정보일 뿐 잘못된 링크를 수정해 주지는 않습니다. 확인 후 현재 화면의 저장 또는 완료 버튼을 누르고 Home으로 돌아와 목록을 가져올 때까지 기다립니다.

저장 성공과 목록 가져오기는 별개의 작업입니다. 돌아온 뒤 구독 이름만 보이는 것이 아니라 실제 서버 항목이 표시되는지 확인하세요. 목록이 비어 있거나 가져오기 실패 메시지가 나오면 먼저 네트워크에서 구독 주소에 접속할 수 있는지, 링크가 아직 유효한지 확인한 뒤 기존 서비스 제공업체에 구독 상태를 문의합니다. 이때 연결 스위치를 반복해서 켜도 누락된 항목이 채워지지는 않습니다. 구독 내용이 바뀌면 해당 구독의 업데이트 기능으로 다시 가져올 수 있습니다. 업데이트 전에 필요한 로컬 메모를 보존하고, 삭제된 이전 항목이 선택되어 있지 않은지 확인하세요.

개별 서버 정보가 있는 경우: 해당 항목을 하나씩 입력

서버 매개변수를 보유한 경우 자료와 일치하는 프로토콜을 Type에서 선택한 뒤 Host, Port 등을 입력합니다. Host에는 서버 도메인이나 주소를 입력하며 전체 구독 링크를 넣으면 안 됩니다. Port에는 제공된 포트 번호를 입력합니다. 예를 들어 Shadowsocks를 사용하는 경우 Password와 Method가 서버 측 설정과 일치해야 합니다. 다른 프로토콜은 인증, TLS 또는 전송 항목이 다를 수 있으므로 원본 자료에 맞춰 하나씩 입력하세요. 한 프로토콜의 매개변수를 다른 프로토콜 양식에 적용하면 안 됩니다.

입력값을 확인할 때는 숫자와 문자의 혼동, 암호 앞뒤의 공백, TLS 관련 이름이 원본 설정과 일치하는지 특히 주의하세요. 제공되지 않은 항목이 있다면 해당 프로토콜에 필수인지 먼저 확인하고, 온라인의 다른 예시를 보고 값을 추측하지 마세요. 화면 아래의 Scan QR Code로 본인이 사용할 권한이 있는 설정 QR 코드를 읽을 수 있습니다. Import from Cloud JSON은 해당 형식의 데이터를 위한 기능이며, 임의의 텍스트를 사용 가능한 설정으로 바꾸는 범용 입력란이 아닙니다. 처음 사용하는 경우 오류를 찾기 쉽도록 한 가지 가져오기 방법만 사용하세요.

저장한 뒤 Home으로 돌아와 SERVER에 알아볼 수 있는 항목이 표시되는지 확인하고 이번에 사용할 서버를 선택합니다. 구독에 여러 항목이 포함될 수 있으므로 가져오기가 끝났다고 해서 올바른 항목이 자동으로 선택되는 것은 아닙니다. 이 단계에서는 서버 하나가 선택되어 있어야 합니다. 다음 단계에서 어떤 요청에 해당 서버를 사용할지 정합니다. Subscribe와 Config의 차이는 용어 빠른 안내에서 확인할 수 있습니다.

Shadowrocket Add Server 공식 화면: Type, Host, Port, Password, Method 및 가져오기 기능 표시
Add Server: 먼저 Type을 선택한 뒤 해당 유형에 맞는 매개변수를 입력합니다.

단계 02 / 요청 경로 선택

Global Routing:세 가지 모드 선택

서버 추가는 “어디에 연결할지”를 정하고, Global Routing은 “요청을 어떻게 처리할지”를 정합니다. 이 두 가지를 먼저 이해한 뒤 연결을 켜세요.

Home으로 돌아와 Global Routing을 열고 Config, Proxy, Direct를 확인합니다. 여기서 선택하는 항목은 요청을 처리하는 전반적인 방식이지 서버 프로토콜이나 구독 유형이 아닙니다. 전환한 뒤 Home으로 돌아와 현재 표시된 이름을 확인하세요. 이미 선택했다고 생각했지만 실제로는 이전 모드가 유지되는 상황을 방지할 수 있습니다.

Config: 현재 설정 파일의 규칙에 따라 처리

Config는 현재 설정 파일의 규칙에 따라 DIRECT, PROXY 또는 설정된 다른 정책을 요청에 적용합니다. 사용하기 전에 Config에서 현재 적용 중인 파일을 확인하고 그 안의 Rule을 살펴보세요. 파일 이름만 보고 내용을 판단하지 말고, 목록에 파일이 있다는 사실만으로 현재 적용 중이라고 생각하지 마세요. 규칙에서 특정 정책이나 서버를 참조한다면 현재 설정에 해당 항목이 있는지도 확인해야 합니다.

스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 설정 파일의 서로 다른 섹션입니다. 처음 연결할 때 모든 섹션을 수정할 필요는 없으며, 연결을 위해 관련 기능을 전부 켤 필요도 없습니다. 본인이 이해하고 사용할 권한이 있는 설정을 먼저 사용하고 원본 사본을 보관하세요. 기본 요청이 처리되는지 확인한 다음 필요한 규칙을 하나씩 추가합니다. Add Rule은 규칙 추가 기능이지 서버 추가 기능이 아닙니다. 서버 항목은 Home에서 관리합니다.

규칙 순서는 결과에 영향을 줍니다. 대상 요청이 먼저 DIRECT에 일치하면 뒤에 있는 더 구체적인 PROXY 규칙까지 확인하지 않을 수 있습니다. 따라서 “서버를 선택했는데 웹사이트가 여전히 직접 연결된다”고 해서 서버 저장에 실패했다고 단정할 수는 없습니다. Config의 규칙 매칭 결과일 수도 있습니다. 여기서는 선택 방법과 확인 방법을 먼저 익히세요. 규칙 키워드와 자세한 설정 설명은 Settings 및 규칙 안내에서 확인할 수 있습니다. 처음 연결하는 동안 복잡한 설정을 동시에 변경하지 마세요.

Proxy: 선택한 서버의 프록시 경로 확인

Proxy에서는 일반적으로 해당 모드의 영향을 받는 요청을 프록시 경로로 처리하므로, 규칙 선택에 따른 변수를 잠시 제외할 수 있습니다. “현재 분할 규칙에 의존하지 않을 때 선택한 서버로 대상에 접속할 수 있는가?”라는 제한된 질문을 확인하기에 적합합니다. 모든 문제를 해결하는 스위치가 아니며 잘못된 암호, 포트 또는 TLS 항목을 자동으로 수정하지도 않습니다. 비교를 마친 뒤 평소 규칙에 따라 분할해야 한다면 Config로 돌아가 규칙을 확인하세요.

Direct: 직접 연결과 비교

Direct는 직접 연결 경로입니다. 이 모드에서는 선택한 서버를 통해 요청이 프록시 처리될 것으로 기대하면 안 됩니다. 직접 연결과 프록시 결과를 비교할 때는 동일한 대상 주소를 유지한 채 모드만 바꾸고 다시 요청하세요. 한 번에 조건 하나만 변경해야 차이가 발생한 원인을 파악할 수 있습니다. 모드를 선택한 뒤 현재 모드와 서버 이름을 기록하세요. 다음 단계의 연결과 확인은 이 상태를 기준으로 진행합니다.

Shadowrocket Config 설정 파일의 공식 편집 화면: General, Rule, Hosts 및 Add Rule 표시
Config: 규칙은 현재 설정 파일에서 가져옵니다. Add Rule과 Home의 Add Server는 용도가 다릅니다.

단계 03 / 기기에서 연결 설정

Home:연결을 켜고 권한 허용

먼저 서버와 모드를 확인한 다음 상단 스위치를 조작하세요. 시스템 권한은 앱이 네트워크 연결을 설정하도록 허용하는 절차이며, 원격 접속 성공을 확인하는 단계는 아닙니다.

Home으로 돌아와 SERVER에서 선택한 항목을 확인하고 Global Routing이 방금 선택한 Config, Proxy 또는 Direct인지 확인합니다. 구독을 업데이트했다면 선택 항목이 여전히 존재하는지도 다시 확인하세요. 처음 테스트할 때는 네트워크 상태를 가능한 한 안정적으로 유지합니다. 연결을 켜는 동시에 Wi-Fi를 바꾸거나 설정을 수정하거나 구독을 업데이트하면 결과가 바뀐 원인을 파악하기 어려울 수 있습니다.

Home 상단의 연결 스위치를 켭니다. 처음 연결을 설정할 때 시스템에서 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 안내를 읽고 현재 실행 중인 앱이 Shadowrocket인지 확인한 뒤 시스템 안내에 따라 허용하고 기기 인증을 완료하세요. 이 권한은 앱이 기기에서 해당 네트워크 연결을 설정하도록 허용합니다. 앱 구매, 구독 링크 입력, 서버 암호 확인과는 별개의 단계이며 서로 대체할 수 없습니다.

이전에 권한 요청을 취소했다면 앱으로 돌아와 다시 시도하고 시스템 안내가 다시 표시되는지 확인하세요. 권한을 얻기 위해 기기 인증과 무관한 계정 정보를 제공하지 마세요. 조직에서 관리하는 기기는 VPN 구성 추가가 제한될 수 있으므로 기기 관리 정책에 따라 처리하고 기존 구성을 계속 삭제하지 마세요. 시스템 설정 경로는 OS 버전에 따라 달라질 수 있으니 기기에 실제로 표시되는 안내를 따르세요.

권한 설정을 완료한 뒤 Home으로 돌아와 연결 상태가 바뀔 때까지 기다립니다. 공식 스크린샷의 Not Connected는 촬영 당시 연결되지 않았다는 뜻이며, 앱을 계속 이 상태로 두라는 의미가 아닙니다. 실제 조작 후에는 스위치가 켜진 상태로 유지되는지, 연결됨으로 상태가 바뀌는지 확인하세요. 스위치가 바로 꺼지거나 연결이 계속되지 않으면 이 페이지의 자주 발생하는 문제에서 권한과 매개변수를 먼저 확인하세요. 연결 실패를 규칙 오류로 단정하지 마세요.

연결 상태가 표시되면 기기의 연결 절차가 해당 상태에 도달했다는 뜻일 뿐, 특정 웹사이트 요청이 PROXY로 처리되었거나 원격 서비스가 사용 가능하다는 증거는 아닙니다. 시스템에 VPN 표시가 나타나도 각 요청에 적용된 최종 정책을 알 수는 없습니다. 다음 단계에서 Connectivity Test, 실제 접속 및 요청 기록을 함께 확인하세요. 처음 확인을 마치기 전에는 On Demand 같은 자동화 설정을 추가하지 마세요.

Shadowrocket Home 공식 화면: Not Connected 연결 스위치, Global Routing, Connectivity Test 및 SERVER 그룹 표시
Home: 상단 스위치로 연결을 제어합니다. Global Routing과 서버 선택은 각각 확인해야 합니다.

단계 04 / 실제 요청 확인

Connectivity Test:적용 여부 확인

“연결할 수 있는지”, “대상에 접속할 수 있는지”, “요청이 예상대로 분할되는지”를 각각 확인하세요. 세 가지 판단에는 서로 다른 근거가 필요합니다.

Home에서 Connectivity Test를 실행해 앱이 반환한 결과를 확인합니다. 테스트 결과는 현재 Test Method, 테스트 대상과 네트워크 상태에 따라 달라지며 해당 조건에서 실행한 한 번의 결과만 보여줍니다. 특정 항목에 테스트 결과가 있다고 해서 모든 웹사이트에 접속할 수 있다는 뜻은 아닙니다. 테스트 시간이 초과되어도 인증 매개변수가 잘못되었다고 단정할 수 없습니다. 테스트 대상에 접속할 수 없거나 현재 네트워크에서 특정 탐색 방식이 제한되는 경우에도 결과가 달라질 수 있습니다. 먼저 결과를 기록하고 실제 접속을 확인하세요. 숫자 하나만 보고 설정이 올바른지 판단하지 마세요.

브라우저를 열고 본인이 이용 권한을 가진, 예상 경로가 분명한 페이지에 접속해 내용이 새로 표시되는지 확인합니다. 새로 요청을 보내는 페이지를 선택하는 것이 좋습니다. 기존 페이지는 캐시에서 불러오거나 이전 연결을 계속 사용할 수 있습니다. 두 모드를 비교할 때는 대상과 네트워크를 그대로 유지하고 모드를 전환할 때마다 페이지를 새로고침하세요. 서버와 대상을 동시에 바꾸면 성공하더라도 어떤 변경이 영향을 주었는지 판단하기 어렵습니다.

Config를 사용하는 경우 앱에서 제공하는 요청 기록이나 Log 관련 정보를 추가로 확인해 대상 도메인, 일치한 규칙, 최종 정책을 점검합니다. 프록시로 처리하려는 대상은 해당 프록시 정책에 일치해야 하고, 직접 연결하려는 대상은 이에 맞는 결과가 표시되어야 합니다. 페이지가 열린다는 사실만으로 규칙 분할이 올바르다고 볼 수 없으며, 설정 파일에 규칙이 적혀 있다는 사실만으로 해당 요청에 실제 적용되었다고 볼 수도 없습니다. 자세한 기록 확인 방법과 DNS 점검은 Log 설정 안내 및 DNS 설정 안내를 참고하세요.

Proxy에서는 접속되지만 Config에서 실패한다면 현재 설정 파일, 규칙 순서, 정책 참조 및 도메인 확인 경로를 먼저 살펴보세요. 두 모드 모두 실패한다면 서버 자체, 매개변수와 현재 네트워크를 확인합니다. Direct에서 접속할 수 있다면 대상의 원래 접속 가능성도 함께 고려하세요. 그것만으로 프록시가 적용되었다고 결론 내리면 안 됩니다. 테스트 대상은 한두 개로 제한하고, 여러 항목을 연속으로 전환하는 대신 명확하게 비교하세요.

완료 후 재현 가능한 기준을 기록해 두세요. 사용한 서버, Global Routing 모드, 현재 설정 파일, 대상 주소와 실제 결과가 포함됩니다. 이후 On Demand를 켜거나 DNS를 조정하거나 Rule을 변경할 때 이 조건으로 다시 테스트할 수 있습니다. 처음 사용한다면 여기까지 확인하고 마쳐도 됩니다. 설정을 빠짐없이 갖추기 위해 모든 기능을 켤 필요는 없습니다. 용어가 궁금하면 용어 빠른 안내를 확인하세요.

단계 05 / 단계별 문제 확인

Settings 및 문제 해결:한 번에 변수 하나만 변경

가장 먼저 실패한 단계부터 확인하세요. 가져오기, 연결, DNS 확인과 트래픽 분할은 서로 다른 단계입니다. 모든 설정을 바로 초기화하지 마세요.

목록이 비어 있음: 구독 가져오기부터 확인

Home에 선택할 서버가 표시되지 않으면 Subscribe의 URL이 완전한지, 구독 요청에서 오류가 발생했는지, 본인이 보유한 구독을 계속 사용할 수 있는지 확인하세요. 가져오기가 끝난 뒤 서버를 선택합니다. 구독 가져오기 실패와 개별 서버 연결 실패는 나누어 확인해야 합니다. 서버의 Host와 구독 URL을 서로 바꾸어 입력하지 말고 인증 정보가 포함된 링크를 공개된 곳에 올리지 마세요. 정보가 유효한지는 기존 서비스 제공업체에 문의해야 하며 앱 구매 내역으로 이를 확인할 수는 없습니다.

항목은 있지만 접속 실패: Type과 인증 항목 확인

해당 항목의 편집 화면을 열고 원본 자료와 Type, Host, Port 및 인증 항목을 하나씩 대조합니다. 해당 프로토콜에 필요한 전송 및 TLS 매개변수도 확인하세요. 불일치가 확인된 항목만 바꾸고 저장한 뒤 같은 대상으로 다시 테스트합니다. 인증서 확인을 해제하는 방법을 일반적인 문제 해결책으로 사용하지 마세요. 인증서 이름, 시스템 시간과 설정 자료를 각각 확인해야 합니다. 모든 항목이 일치하는데도 실패한다면 현재 네트워크와 오류 현상을 기록한 뒤 서버 상태 정보가 필요한지 판단하세요.

연결 스위치가 유지되지 않음: 권한 및 자동 연결 조건 확인

연결이 설정되기 전에 스위치가 저절로 꺼진다면 먼저 시스템에서 VPN 구성을 추가할 수 있는지, 활성화된 다른 네트워크 구성이 현재 연결에 영향을 주는지 확인하세요. Settings의 On Demand는 조건에 따라 연결을 시작하는 기능이지, 잘못된 서버 매개변수를 수정하는 기능이 아닙니다. 이미 On Demand를 설정했다면 문제를 확인할 때 현재 조건이 자동 연결을 시작하거나 예상과 다르게 작동하게 하는지 먼저 살펴보세요. 기본 수동 연결을 확인한 뒤 실제 필요에 따라 설정하면 됩니다. 자세한 내용은 On Demand 안내를 참고하세요.

테스트와 실제 접속 결과가 다름: 테스트 방식 및 요청 기록 확인

Settings의 Test Method는 테스트 방식에 영향을 줍니다. 결과를 비교할 때는 테스트 방법을 동일하게 유지하세요. 방법을 바꾼 뒤 결과가 달라져도 서버 성능이 바뀌었다고 바로 판단해서는 안 됩니다. 더 자세히 분석하려면 Diagnostics 관련 메뉴를 확인하고 Log의 실제 오류와 함께 살펴보세요. Language나 Today Widget 설정은 인증 실패를 해결하는 데 필요한 단계가 아닙니다. 명확한 근거 없이 Proxy, TCP, UDP의 설정을 여러 개 한꺼번에 바꾸지 마세요.

특정 도메인만 실패하면 해당 요청의 규칙 일치 여부, DNS 결과와 대상 서비스 상태부터 확인하세요. 모든 요청이 실패하면 연결과 매개변수 단계로 돌아갑니다. 특히 Proxy에서는 되지만 Config에서는 안 된다면 구독을 바로 다시 입력하지 말고 설정 차이부터 확인하세요. 변경할 때마다 4단계에서 기록한 기준으로 다시 테스트하고, 개선이 반복해서 확인된 뒤 변경 사항을 유지하세요.

문제 해결 정보를 공유하기 전: 민감한 내용 삭제

실패한 단계, 현재 모드, 사용 프로토콜, 오류 문구와 재현 여부는 기록해도 됩니다. 단, 전체 구독 링크, 암호, 인증 식별 정보 또는 개인 정보가 담긴 설정 파일은 공개하지 마세요. 스크린샷과 로그에도 민감한 내용이 포함될 수 있으므로 공유 전에 하나씩 확인해야 합니다. 계속 설정을 바꾸다 복구 기준을 잃지 않도록 원본 설정 사본을 보관하세요. 상황별 안내는 문제 해결에서 확인하고, Settings 항목을 하나씩 살펴보려면 옵션 안내서를 참고하세요.

Shadowrocket Settings 공식 화면: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 문제에 따라 Test Method, On Demand, Diagnostics를 확인하고 여러 설정을 한꺼번에 바꾸지 마세요.