OFFICIAL MANUAL / GETTING STARTED

Shadowrocket 시작하기

추가, 모드 선택, 연결, 확인, 문제 해결까지 5단계로 처음 사용하는 방법을 안내합니다. 먼저 확인 가능한 연결을 만든 뒤 규칙과 자동 연결 설정을 차례로 조정하세요.

아래 안내는 주로 iPhone과 iPad를 기준으로 합니다. 필요한 정보를 미리 준비한 다음 순서대로 진행하세요. 처음부터 모든 설정을 익힐 필요는 없습니다. 공식 스크린샷은 화면과 항목을 찾기 위한 참고 자료이며, 실제 레이아웃은 기기와 앱 업데이트에 따라 달라질 수 있습니다. 현재 클라이언트에 표시되는 영어 인터페이스 용어를 기준으로 확인하세요. 스크린샷의 입력 항목 조합이 모든 프로토콜에 공통으로 필요한 고정 양식이라고 생각하지 마세요.

‘서버 정보’, ‘구독 주소’, ‘규칙 설정 파일’은 서로 구분해야 합니다. 서버 정보는 연결에 필요한 주소와 인증 정보를 설명하고, 구독은 서버 항목을 일괄 가져오고 업데이트하는 데 사용합니다. Config의 설정 파일은 트래픽 분기 등의 동작을 결정합니다. 구독에서 서버를 가져왔다고 해서 현재 사용하기에 적절한 규칙 설정까지 선택된 것은 아닙니다.

STEP 01 / ADD SERVER

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

보유한 정보에 맞는 가져오기 방법을 선택하고 저장한 뒤 SERVER 항목을 확인하세요.

Add Server에 직접 입력하기

Shadowrocket을 열고 Home으로 이동한 다음 SERVER 영역에서 Add Server를 찾습니다. 현재 화면에서 상단 추가 버튼을 사용하는 경우 해당 버튼으로 추가 화면을 열어도 됩니다. 먼저 Type을 누르고 보유한 정보에 맞는 프로토콜 유형을 선택한 뒤 나머지 항목을 입력하세요. Type에 따라 표시되는 인증 및 전송 옵션이 달라지므로 익숙해 보이는 항목이라고 무조건 선택하지 마세요.

Host에는 서버 호스트 이름이나 IP 주소를, Port에는 포트 번호를 입력합니다. Password, Method 등 인증 항목은 선택한 Type에 따라 표시 여부가 달라집니다. 예를 들어 Shadowsocks를 사용한다면 Method와 Password가 서버 설정과 일치해야 합니다. 다른 프로토콜은 각 프로토콜에 맞는 제공 정보를 확인하세요. 전체 공유 링크를 Host에 붙여 넣거나 호스트 이름만 받는 항목에 웹페이지 경로를 덧붙이지 마세요.

자료에 TLS, 서버 이름, 전송 경로 등의 매개변수가 있다면 현재 양식의 해당 항목에 각각 입력하세요. 연결 주소와 인증서 검증에 사용하는 이름은 서로 다를 수 있으므로, 두 항목을 같아 보이게 하려고 임의로 수정하지 마세요. 항목의 의미가 불분명하다면 기존 서비스의 설정 안내를 다시 확인하세요. 값을 반복해서 추측하거나 인증서 검증을 끄고 연결을 시도하는 것은 권장하지 않습니다.

Subscribe로 구독 가져오기

보유한 정보가 구독 링크라면 Add Server의 Type에서 Subscribe를 선택하고 전체 구독 주소를 URL에 입력하세요. 알아보기 쉬운 메모를 추가한 뒤 저장하고 가져오기가 완료될 때까지 기다릴 수 있습니다. 복사할 때 링크의 시작과 끝, 쿼리 매개변수가 모두 포함되었는지 확인하세요. 메신저나 문서에서 공백이나 줄바꿈이 삽입되었거나 실제 주소 대신 표시 문구만 복사하지 않았는지도 살펴보세요.

구독 주소에는 보통 접근 정보가 포함되므로 비밀번호처럼 안전하게 보관해야 합니다. 안내를 위해 실제 주소를 제공할 필요는 없습니다. 전체 주소를 공개 댓글, 스크린샷 또는 진단 기록에 올리지 마세요. 구독을 정상적으로 가져온 뒤 Home으로 돌아가 SERVER 그룹에 예상한 항목이 있는지 확인하세요. 구독 이름만 표시되고 서버가 없다면 먼저 업데이트 결과를 확인하고, 같은 구독을 바로 여러 번 추가하지 마세요.

기존 공유 링크나 QR 코드가 있는 경우

개별 공유 링크와 구독은 서로 다른 종류의 정보입니다. 전자는 보통 서버 하나를 설명하고, 후자는 업데이트 가능한 서버 목록을 가져오는 데 사용됩니다. 클라이언트에 해당 링크 가져오기 기능이 있다면 이용하거나, Add Server에서 Scan QR Code를 눌러 본인의 QR 코드를 스캔하세요. 스캔하기 전에 출처를 확인하세요. Import from Cloud JSON은 해당 JSON 자료를 실제로 보유한 경우에만 사용합니다. 모든 링크를 가져오는 범용 기능이 아닙니다.

어떤 방법을 사용하든 마지막에는 Home으로 돌아가 사용할 서버를 선택한 뒤 세부 정보에서 Type, Host, Port를 다시 확인하세요. 항목을 선택했다는 것은 이후 연결에 해당 항목을 사용한다는 뜻이지, 사용 가능하다는 확인은 아닙니다. 이 단계를 마친 다음 Global Routing을 설정하세요. 서버 이름이나 지역 메모만 보고 실제 연결 결과를 판단하지 마세요. 프로토콜 항목의 의미는 프로토콜 참고에서 확인할 수 있습니다.

Shadowrocket Add Server 공식 스크린샷: Type, Host, Port, Password, Method, Scan QR Code, Import from Cloud JSON 표시
Add Server: 먼저 Type을 선택한 뒤 보유한 정보에 맞춰 항목을 입력하세요.

STEP 02 / GLOBAL ROUTING

Global Routing 모드 선택

Config, Proxy, Direct는 요청이 어떤 경로를 사용할지 결정합니다.

서버를 가져온 뒤 Home으로 돌아가 Global Routing을 눌러 현재 선택을 확인하세요. 이 설정은 전체 라우팅 방식을 제어하며 서버 프로토콜 유형을 바꾸는 항목이 아닙니다. 이 설정을 전환해도 서버의 Type이 다른 프로토콜로 바뀌거나 잘못 입력한 인증 정보가 수정되지는 않습니다. 처음 확인할 때는 현재 어떤 모드가 선택되어 있는지 먼저 파악해 모드 차이를 연결 오류로 오해하지 않도록 하세요.

Config: 현재 설정의 규칙 적용

Config는 규칙에 따라 요청을 구분할 때 사용합니다. Config로 이동해 사용할 설정 파일이 현재 활성 항목으로 선택되어 있는지 확인하세요. 설정 파일을 가져오거나 저장하거나 편집 화면을 열기만 해서는 적용되었다고 볼 수 없습니다. 설정 파일의 Rule은 순서대로 일치 여부를 확인하고, 일치하면 PROXY, DIRECT, REJECT 등의 해당 정책을 적용합니다. 요청이 서버를 거치지 않는 것은 클라이언트가 작동하지 않아서가 아니라 DIRECT 규칙이 적용된 결과일 수 있습니다.

현재 규칙이 어느 파일에서 적용되는지 모른다면 규칙을 한꺼번에 많이 추가하지 마세요. 현재 활성 항목을 기록한 다음 관련 Rule과 순서를 확인하세요. 아래 예시는 ‘일치 조건 뒤에 정책이 오는’ 구조를 이해하기 위한 것으로, 완전한 설정 파일이 아닙니다. 처음 연결할 때 기존 파일을 붙여넣어 바꿀 필요도 없습니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

이 예시에서는 example.com으로 끝나는 도메인 요청에 PROXY를 적용하고, 지정된 로컬 네트워크 주소 범위에는 DIRECT를 적용하며, 나머지 요청은 FINAL로 처리합니다. 앞에 있는 규칙이 일치하면 뒤의 규칙이 실행될 기회가 달라질 수 있습니다. 스크린샷에는 General, Hosts, URL Rewrite, HTTPS Decryption 항목도 보이지만, 처음 연결할 때 각 항목을 수정하거나 HTTPS Decryption을 활성화할 필요는 없습니다.

Proxy: 트래픽 분기 변수를 줄여 확인

Proxy는 이 모드에서 처리하는 일반적인 요청을 현재 선택한 프록시 경로로 전달하므로, 서버 사용 가능 여부를 잠시 확인할 때 유용합니다. Config에서 특정 대상에 접속할 수 없지만 Proxy에서는 같은 대상에 접속할 수 있다면 규칙, 정책 또는 관련 이름 확인 설정을 우선 점검하세요. Proxy가 기기의 모든 활동을 예외 없이 처리한다고 보장하는 것은 아니며, 서버 인증 정보나 서비스 상태를 자동으로 바로잡지도 않습니다.

Direct: 선택한 서버를 거치지 않는 연결

Direct는 서버를 거치지 않고 직접 접속할 때 사용합니다. 대상 서비스에 기존 서버를 통한 경로가 필요한 경우 Direct에서 테스트한 성공이나 실패만으로 해당 서버를 평가할 수 없습니다. 기준을 명확히 하려면 현재 모드를 기록한 뒤 Proxy로 잠시 확인하고, 이후 실제 필요한 Config로 돌아가세요. 모드를 바꿀 때마다 새 요청을 실행해 이전 연결 결과를 새 모드의 결과로 오해하지 않도록 하세요.

모드를 정한 뒤 Home으로 돌아가 Global Routing에 원하는 항목이 표시되는지 확인하고 연결을 켜세요. 설정 파일의 항목과 규칙 관리 방법은 기능 및 설정에서 더 살펴볼 수 있습니다. 처음에는 구성이 단순하고 출처가 명확하도록 유지하세요.

Shadowrocket Config 공식 설정 편집 스크린샷: General, Rule, Hosts, URL Rewrite, HTTPS Decryption, Add Rule 표시
Config: 설정 파일 내용을 살펴보고 현재 활성화 여부도 별도로 확인하세요.

STEP 03 / CONNECT

연결 스위치 켜기 및 시스템 승인

서버와 모드를 확인한 뒤 첫 연결 시 표시되는 시스템 안내를 처리하세요.

Home으로 돌아가 SERVER에서 선택된 항목을 확인한 다음 Global Routing을 살펴보세요. 서버를 수정했다면 변경 사항이 저장되었는지 확인하고, Config를 전환했다면 테스트하려는 파일이 실제로 활성화되어 있는지 확인하세요. 두 항목을 모두 확인한 뒤 Home 상단의 연결 스위치를 켭니다. 공식 스크린샷의 Not Connected 상태는 연결 전 상태를 보여주는 것이며, 연결 성공을 증명하지 않습니다.

처음 연결할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 요청할 수 있습니다. 이는 클라이언트가 시스템 네트워크 연결을 설정하는 데 필요한 승인 절차이며 앱을 다시 구매하는 것과는 관계없습니다. 팝업에 표시된 앱 이름과 요청 내용을 읽고, 방금 연결을 시도한 결과로 표시된 안내인지 확인한 뒤 시스템의 안내에 따라 허용하고 인증을 완료하세요. 기기 암호나 시스템에서 지원하는 인증 방식이 필요할 수 있으므로 현재 기기 안내를 따르세요.

실수로 취소를 눌렀더라도 서버를 반복해서 삭제할 필요는 없습니다. Home으로 돌아가 다시 연결을 시도하고 시스템 안내가 다시 표시되는지 확인하세요. 계속 진행할 수 없다면 시스템 설정에서 VPN 구성이 있는지, 기기 관리 제한으로 추가가 차단되었는지 확인합니다. 학교나 회사에서 관리하는 기기는 정책 제한을 받을 수 있으므로 클라이언트 항목을 계속 바꾸기보다 먼저 기기 사용 규칙을 확인하세요.

승인이 완료되면 Home으로 돌아가 상태가 업데이트될 때까지 기다리세요. 시스템에 VPN 연결이 설정되었다고 표시되면 기기에서 클라이언트 네트워크 확장까지의 연결 절차가 시작된 것입니다. 원격 서버 인증까지 성공했거나 모든 대상 서비스에 접속할 수 있다는 뜻은 아닙니다. 따라서 연결 스위치가 켜져 있는 것은 다음 확인 단계의 시작일 뿐, 전체 절차가 끝났다는 의미는 아닙니다.

스위치가 곧바로 꺼진다면 오류 안내와 발생 시점을 기록하세요. 시스템 승인 전인지, 승인 후인지, 아니면 접속을 시작할 때인지 확인합니다. 이때는 연결 설정 문제부터 해결하고 DNS, Rule, 서버 매개변수를 동시에 바꾸지 마세요. 스위치가 켜져 있는데도 접속할 수 없다면 현재 상태를 유지하고 다음 단계에서 테스트 결과와 실제 요청 결과를 구분해 확인하세요.

iPad에서도 서버 선택, Global Routing 확인, 스위치 켜기, 시스템 승인, 접속 확인 순서로 진행합니다. 화면 크기에 따라 버튼 위치는 다를 수 있으므로 Home과 해당 화면의 용어를 기준으로 찾으세요. 처음 연결이 성공하기 전에는 On Demand를 설정하지 않아도 됩니다. 수동 연결이 안정적으로 재현된 뒤 자동 연결 조건을 설정하는 것을 고려하세요.

Shadowrocket Home 공식 스크린샷: Not Connected 연결 스위치, Global Routing, Connectivity Test, SERVER, Add Server 표시
Home: Global Routing과 SERVER를 확인한 다음 상단 연결 스위치를 조작하세요.

STEP 04 / VERIFY

테스트 결과와 실제 접속 확인

숫자 하나만 보지 말고 서버 응답, 연결 상태, 대상 요청을 각각 확인하세요.

먼저 Connectivity Test 실행

Home에서 Connectivity Test를 누르고 결과가 표시될 때까지 기다리세요. 이 테스트는 현재 네트워크 상태에서 연결을 가늠하는 참고 자료입니다. 구체적인 측정 방식은 Settings의 Test Method 등의 설정에 따라 달라집니다. 결과를 비교할 때는 가능한 한 같은 네트워크와 같은 테스트 방법을 사용하세요. 조건이 다르면 숫자 변화가 서버 성능이 아닌 테스트 조건 차이에서 비롯되었을 수 있습니다.

테스트에서 응답이나 지연 시간이 표시되면 해당 테스트 단계에서 결과를 얻었다는 뜻이지, 실제 서비스 요청도 반드시 완료된다는 뜻은 아닙니다. 지연 시간이 낮아도 파일 전송이 빠르다는 보장은 없습니다. 실제 속도는 사용 가능한 대역폭, 서버 부하, 대상 서비스, 전송 조건에 따라서도 달라집니다. 반대로 한 번 시간 초과가 발생했다고 전체 연결을 사용할 수 없다고 단정하지 말고 테스트 방식과 실제 접속 결과를 함께 확인하세요.

실제 요청도 실행하기

연결을 켠 상태에서 실제로 사용할 권한이 있는 서비스를 열고 페이지를 새로고침하거나 새 작업을 실행하세요. 텍스트 페이지나 명확한 새로고침 동작처럼 결과를 쉽게 확인할 수 있는 것을 선택하고, 이미 로드된 이미지에만 의존하지 마세요. 앱이 기존 연결을 유지한다면 해당 화면을 닫았다가 다시 열어 테스트하여 캐시된 내용이 새 네트워크 요청인 것처럼 보이지 않게 하세요.

Config를 사용한다면 대상에 예상한 정책이 적용되는지도 확인하세요. Direct로 직접 접속할 수 있는 대상이 정상이라고 해서 PROXY 경로까지 사용 가능하다는 뜻은 아닙니다. REJECT가 적용된 대상의 요청이 차단되어도 서버 오류라고 단정할 수 없습니다. 클라이언트의 연결 기록에서 대상, 규칙, 정책 정보를 확인하고, 과거 기록 하나로 현재 결과를 추측하기보다 같은 요청에 해당하는 기록을 찾으세요.

한 번에 하나씩 비교해 원인 범위 좁히기

실제 결과가 예상과 다르면 현재 네트워크, 서버, Global Routing, 접속 대상을 기록한 뒤 그중 하나만 바꿔 보세요. 예를 들어 서버는 그대로 두고 같은 대상에서 Config와 Proxy 결과를 비교하거나, 모드는 유지한 채 사용 가능한 서버 두 개를 바꿔 비교할 수 있습니다. 한 번의 테스트에서 네트워크 변경, DNS 수정, 구독 업데이트, 규칙 교체를 동시에 하지 마세요. 문제가 해결되어도 원인을 파악하기 어렵습니다.

확인 기준은 연결 상태가 예상과 일치하고, 실제 대상에서 작업이 완료되며, 해당 요청의 경로가 현재 모드와 일치하는 것입니다. 확인을 마친 뒤 평소에 사용할 모드로 돌아가세요. 지연 시간 숫자를 더 낮추려고 이미 검증된 설정을 반복해서 바꿀 필요는 없습니다. 문제가 계속되면 구체적인 증상을 기록해 다음 단계로 진행하세요.

STEP 05 / TROUBLESHOOT

증상에 따라 설정 점검하기

먼저 기본 네트워크를 복구한 다음 가져오기, 인증, 규칙 또는 대상 서비스 중 어느 단계에 문제가 있는지 확인하세요.

기본 네트워크에서 접속할 수 없음

먼저 클라이언트 연결을 끄고 현재 Wi-Fi 또는 셀룰러 네트워크에서 일반적인 접속이 가능한지 확인하세요. 공용 Wi-Fi는 네트워크 로그인 절차를 먼저 완료해야 할 수 있고, 시스템에서 셀룰러 데이터 사용이 제한되어 있을 수도 있습니다. 기본 네트워크가 준비되지 않으면 구독 가져오기, 서버 연결, 대상 접속이 모두 실패할 수 있으므로 이 문제부터 해결하세요. 기본 접속이 가능해지면 Home으로 돌아가 기존 서버와 모드로 다시 시도하세요.

Subscribe 업데이트 실패 또는 항목 없음

구독 URL 전체가 정확한지, 아직 유효한지, 현재 기본 네트워크에서 해당 주소에 접속할 수 있는지 확인하세요. 구독 주소와 계정 관리 페이지 주소는 다를 수 있습니다. 웹 로그인 주소를 복사해도 서버 목록을 가져오지 못하는 경우가 많습니다. 인증 정보가 포함된 주소를 공개 테스트 페이지에 제출하지 마세요. 필요한 경우 기존 서비스의 지원 채널에 주소 상태와 응답 형식만 문의하세요. 기존에 사용할 수 있는 항목은 유지하고 업데이트 결과를 확인한 뒤 중복 항목을 정리하세요.

서버는 표시되지만 인증 또는 핸드셰이크 실패

해당 항목의 편집 화면을 열고 Type, Host, Port, 인증 정보, 전송 매개변수를 하나씩 대조하세요. 직접 입력했다면 대소문자, 앞뒤 공백, 비슷하게 생긴 문자를 특히 주의해서 확인합니다. TLS를 사용하는 항목은 기기의 날짜와 시간, 자료에 지정된 서버 이름도 확인하세요. Password만 바꾼 뒤 나머지 항목이 맞다고 단정하지 말고, Method를 임의로 바꾸거나 인증서 검증을 건너뛰어 매개변수 불일치 문제를 감추지 마세요.

Proxy에서는 되지만 Config에서 일부 대상 실패

현재 활성화된 Config, 규칙 순서, 적용 정책을 먼저 확인하세요. 실패한 대상의 요청 기록을 찾아 앞선 규칙이 DIRECT, REJECT 또는 예상과 다른 정책을 적용했는지 살펴봅니다. 도메인과 주소 확인 과정에 차이가 있다면 실제 기록을 바탕으로 점검하고 처음부터 모든 DNS 설정을 교체하지 마세요. 한 항목을 수정해 효과를 확인한 뒤에만 유지하고, 나머지 시험 변경 사항은 되돌려 설명하기 어려운 설정이 쌓이지 않게 하세요.

Connectivity Test와 실제 사용 결과가 다름

Settings에서 Test Method를 확인하고 현재 비교 목적에 적합한 방식을 사용하고 있는지 살펴보세요. 테스트 대상과 실제 서비스 대상이 다르면 결과도 달라질 수 있습니다. 특정 테스트에 서버 응답이 느리다고 모든 실제 요청이 느린 것은 아닙니다. 텍스트 페이지는 정상인데 특정 서비스만 실패한다면 해당 서비스의 연결 유형, 대상 상태, 필요한 전송 기능으로 점검 범위를 좁히세요. Settings의 Proxy, TCP, UDP는 관련 설정 항목이며, 시험 삼아 모두 변경해서는 안 됩니다.

연결이 자동으로 켜지거나 꺼짐

Settings에서 On Demand가 설정되어 있는지 확인하세요. On Demand는 조건에 따라 연결을 시작하는 기능이지 네트워크를 빠르게 만드는 설정이 아닙니다. 처음 문제를 점검할 때는 현재 조건을 기록한 뒤 자동 연결을 잠시 끄고 Home에서 수동으로 연결해 재현 가능한 테스트를 진행할 수 있습니다. 테스트가 끝나면 필요한 조건을 다시 설정하세요. 기기에 다른 VPN 구성이 활성화되어 있다면 실제로 어떤 구성이 적용 중인지도 확인해 잘못된 연결 상태에서 결과를 관찰하지 않도록 하세요.

Diagnostics 수집 시 정보 보호

문제를 더 자세히 파악해야 한다면 Settings에서 Diagnostics 관련 기능을 확인할 수 있습니다. ‘작동하지 않음’이라고만 설명하기보다 발생 시간, 현재 네트워크 유형, 선택한 모드, 오류 원문, 재현 가능 여부를 기록하면 도움이 됩니다. 진단 정보를 공유하기 전에 구독 주소의 인증 정보, 서버 비밀번호, 인증 식별자와 기타 개인정보를 가리세요. 오류 유형과 필요한 맥락만 남기고 민감한 설정 전체를 공개하지 마세요.

문제 해결 후 확인 단계로 돌아가기

설정을 한 가지 변경할 때마다 연결을 다시 시도하고 실제 접속도 확인하세요. 문제가 서버 상태나 기존 구독 권한에 있다면 클라이언트의 로컬 설정 변경으로 서버 측 문제를 해결할 수 없습니다. 기존 서비스의 지원 채널에 확인하세요. 한 대상만 이상하다면 대상 자체가 일시적으로 사용할 수 없는 상태인지도 고려하세요. 전체 설정을 다시 만들 필요는 없습니다.

처음 사용하는 과정은 여기서 마무리하면 됩니다. 확인을 마친 서버 하나를 유지하고, 현재 Global Routing과 사용 중인 Config를 파악하며, 연결을 수동으로 중지하는 방법을 알아두세요. 더 알아보려면 프로토콜 참고와 기능 및 설정을 읽어보세요. 전체 순서를 다시 확인하려면 이 페이지의 추가 및 가져오기 단계로 돌아가세요.

Shadowrocket Settings 공식 스크린샷: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP, UDP 표시
Settings: 여러 항목을 한꺼번에 변경하지 말고 Test Method, On Demand 또는 Diagnostics를 문제에 맞게 확인하세요.