Shadowrocket 사용 가이드:
가져오기, 라우팅 및 연결 확인
한 번의 연결 과정을 순서대로 진행합니다. 사용할 서버 항목을 준비하고 Global Routing을 선택한 뒤 실제 접속 결과를 확인합니다. 처음에는 연결 하나만 완료하고 여러 구성을 동시에 변경하지 마세요.
STEP 01 / INPUT
Add Server: 서버 추가 또는 구독 가져오기
먼저 보유한 정보가 서버 주소, 포트, 인증 매개변수인지, 여러 항목을 가져오는 구독 링크인지 확인합니다. 두 정보의 가져오기 방법은 다릅니다. 구독 주소를 Host에 입력하거나 일반 웹 주소를 구독 주소로 사용하면 안 됩니다. 정보가 완전하지 않다면 Type을 반복해서 바꾸기보다 원래 서비스 제공업체에 확인하세요.
서버 항목 직접 입력
- Shadowrocket을 열고 Home의 SERVER 영역에서 Add Server를 찾아 추가 화면으로 이동합니다. 먼저 Type을 누르고 Shadowsocks 또는 Trojan 등 정보에 표시된 프로토콜을 선택합니다. 선택한 프로토콜에 맞는 입력란이 표시됩니다.
- 정보에 따라 Host와 Port를 입력한 다음 Password와 해당 프로토콜에 필요한 매개변수를 입력합니다. Host에는 보통 도메인 또는 IP 주소를 입력하고, Port에는 숫자를 입력합니다. 경로가 포함된 웹 링크 전체를 Host에 입력하지 마세요.
- 선택한 프로토콜에 Method가 표시되면 서버 측 설정과 일치해야 합니다. TLS, SNI 또는 기타 전송 매개변수도 원본 정보와 항목별로 대조하세요. 테스트를 통과시키려고 인증서 검증을 임의로 끄지 마세요.
- 입력 내용을 확인한 뒤 화면의 저장 기능을 사용하고 Home으로 돌아갑니다. SERVER 아래에 추가한 항목이 표시되는지 확인하고, 연결에 사용할 서버를 선택합니다.
오른쪽 공식 스크린샷에는 Type, Host, Port, Password, Method가 있는 Add Server 화면이 표시되어 있습니다. 모든 프로토콜에 같은 입력란이 나타나는 것은 아닙니다. 현재 선택한 Type과 보유한 서버 정보를 기준으로 입력하세요. 이름 메모는 용도를 구분하는 데 도움이 되지만 주소, 포트 또는 인증 오류를 해결해 주지는 않습니다.
Subscribe로 기존 구독 가져오기
전체 구독 링크가 있다면 Add Server의 Type에서 Subscribe를 선택하고 해당 URL 입력란에 붙여 넣은 다음 저장하고 Home으로 돌아갑니다. 복사할 때 물음표 뒤의 매개변수를 포함해 전체 주소를 유지하세요. 주소 앞뒤에 공백, 줄바꿈 또는 한글 문장 부호가 추가되지 않았는지도 확인합니다. 구독 주소에는 개인 접근 정보가 포함될 수 있으므로 공개 게시판에 붙여 넣거나 스크린샷에 노출하지 마세요.
저장 후 정보 가져오기가 완료될 때까지 기다린 다음 Home에서 해당 그룹과 항목을 확인합니다. 그룹 이름만 있고 서버 항목이 없다면 구독 업데이트가 성공했는지 먼저 확인하세요. 주소를 저장한 것만으로 연결 가능한 서버가 확보된 것은 아닙니다. 기존 구독을 업데이트하려면 해당 그룹의 업데이트 기능을 사용하면 됩니다. 같은 주소로 그룹을 반복해서 추가하지 마세요. 여러 구독을 정리하는 방법은 FAQ의 구독 및 서버 가져오기 안내를 참고하세요.
Add Server 하단에는 Scan QR Code와 Import from Cloud JSON도 표시됩니다. 해당 QR 코드나 요건에 맞는 정보가 있는 경우에만 사용하세요. 스캔 전에 출처를 확인하고, 가져온 뒤에도 프로토콜과 주소를 확인합니다. 이 단계의 완료 기준은 Home에 매개변수가 완전하고 선택 가능한 서버 항목이 있는 것입니다. 이름만 표시되는 것으로는 충분하지 않습니다.
STEP 02 / ROUTING
Global Routing: 구성, 프록시 또는 직접 연결 선택
서버 항목을 준비한 뒤 Home으로 돌아가 Global Routing을 엽니다. 이 설정은 연결이 수립된 후 적용할 라우팅 방식을 결정합니다. 서버 선택은 “프록시가 필요할 때 어떤 항목을 사용할지”를 정하고, Global Routing은 “각 연결을 어떤 방식으로 보낼지”를 정합니다. 두 항목을 각각 확인해야 합니다.
- 구성(Config): 현재 구성 파일의 규칙에 따라 경로를 결정합니다. 요청별로 PROXY, DIRECT 또는 이미 정의된 다른 정책을 적용할 수 있습니다. 일상적인 규칙 라우팅에 사용하는 방식이지만, 구성 내용을 먼저 확인해야 합니다.
- 프록시(Proxy): 클라이언트가 처리하는 연결에 프록시 경로를 사용합니다. 문제 해결 중 서버가 작동하는지 비교할 때 유용합니다. 모든 앱, 프로토콜 또는 대상에 접속할 수 있다고 보장하지는 않습니다.
- 직접 연결(Direct): 클라이언트가 처리하는 연결에 직접 연결 경로를 사용하며, 로컬 네트워크의 접속 상태를 비교할 때 이용할 수 있습니다. 스위치가 켜져 있어도 현재 요청이 선택한 서버를 거친다는 뜻은 아닙니다.
구성(Config)을 사용하기 전에 Config 확인
구성(Config)을 선택했다면 하단의 Config로 이동해 현재 실제로 사용 중인 구성을 확인합니다. 해당 파일을 열고 Rule 섹션을 확인하세요. 공식 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 구성 편집의 각 섹션이며, Add Rule은 규칙을 추가하는 메뉴입니다. 처음에는 기존 규칙의 의미를 파악하는 데 집중하세요. 모든 섹션을 하나씩 수정하거나 일반 연결에 HTTPS Decryption을 추가로 활성화할 필요는 없습니다.
아래 두 줄은 규칙 문법을 이해하기 위한 예시이며 기존 구성을 그대로 덮어쓰라는 의미가 아닙니다. 첫 번째 줄은 지정된 도메인 접미사에 프록시 경로를 적용하고, 두 번째 줄은 앞의 규칙에 일치하지 않을 때 프록시 경로를 사용합니다. 규칙은 위에서 아래로 일치 여부를 확인하므로 순서가 결과에 영향을 줍니다. 각 줄의 의미는 전체 구성과 함께 판단해야 합니다.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
신뢰할 수 있는 구성이 없거나 기존 규칙을 아직 이해하지 못했다면, 먼저 프록시(Proxy)를 사용해 보유한 서버 하나의 연결을 확인한 다음 구성(Config)으로 돌아가 라우팅을 점검할 수 있습니다. 프록시로 전환한 뒤 접속된다는 이유만으로 문제가 모두 해결됐다고 판단하지 마세요. 서버는 작동하지만 기존 규칙, 정책 선택 또는 DNS 설정을 추가로 확인해야 할 수 있습니다. 구성 항목에 대한 자세한 내용은 규칙 라우팅 및 문제 해결 FAQ를 참고하세요. 이 페이지에서는 반복 가능한 연결 과정을 먼저 완료합니다.
STEP 03 / CONNECT
Home: 스위치를 켜고 연결 상태 확인
라우팅 방식을 선택한 뒤 Home으로 돌아가 SERVER에서 선택한 항목을 다시 확인합니다. 구독 업데이트, 항목 삭제 또는 그룹 전환 후에는 실제 선택 항목이 이전과 달라질 수 있습니다. 목록 맨 위의 이름만 보고 판단하지 마세요. 다른 서버로 전환할 계획이라면 나중에 같은 조건으로 비교할 수 있도록 기존 항목을 기록해 둡니다.
- Home 상단의 연결 스위치를 찾습니다. 연결 전에는 Not Connected가 표시됩니다. 스위치를 눌러 연결을 시작합니다.
- 처음 사용할 때 시스템에서 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 시스템 안내를 읽고 방금 연 Shadowrocket에서 요청한 작업인지 확인한 뒤 추가를 허용합니다. 안내에 따라 기기 암호를 입력하거나 기기 인증을 완료합니다.
- Home으로 돌아가 상태가 바뀔 때까지 기다립니다. 스위치가 켜진 상태로 유지되는지 확인하고, 켜자마자 자동으로 꺼지지 않는지 살펴봅니다. Not Connected가 계속 표시되면 접속 테스트를 중단하고 이 페이지의 실패 원인 확인으로 이동합니다.
VPN 구성 추가를 허용하는 것은 클라이언트가 시스템의 네트워크 기능을 사용해 연결을 처리하도록 승인하는 것입니다. 구독에 포함된 서버가 사용 가능한지 검증하는 과정은 아닙니다. 스위치가 계속 켜져 있어도 모든 대상에 접속할 수 있다는 뜻은 아닙니다. 이 단계에서는 시스템 연결 상태만 확인합니다. 의도한 대로 작동하는지는 다음 단계에서 웹 페이지 접속과 경로를 확인해야 합니다.
기기에 다른 VPN 연결이 있거나 회사에서 관리하는 네트워크 구성이 있다면, 현재 사용 중인 연결과 기기 관리 요건을 먼저 확인하세요. 서로 충돌할 수 있는 연결을 동시에 실행해 테스트하지 말고, 용도를 모르는 관리 구성을 삭제하지 마세요. 시스템 권한 안내를 취소했다면 Home으로 돌아가 다시 시도해 안내가 표시되는지 확인합니다. 계속 실패하면 시스템의 VPN 구성 상태를 확인하세요.
처음 연결을 확인하는 동안에는 On Demand 상태를 변경하지 말고, 기존에 활성화되어 있었는지 기록해 둡니다. 자동 연결 조건을 이해하지 못한 채 On Demand를 수정하면 네트워크를 전환할 때 스위치가 다시 켜져 문제 해결이 어려워질 수 있습니다. 테스트를 마치고 수동 연결이 안정적인 것을 확인한 뒤 필요에 따라 연결 설정을 결정하세요.
STEP 04 / CHECK
Connectivity Test: 테스트 결과와 실제 접속 구분
스위치가 켜진 상태로 유지되면 먼저 Home에서 Connectivity Test로 기존 항목을 확인한 다음 브라우저에서 평소 접속 가능한 것으로 확인된 페이지를 엽니다. 전자는 테스트 조건에서의 연결 상태를 파악하는 데 도움이 되고, 후자는 실제 요청이 완료되는지 확인합니다. 두 결과를 함께 살펴보세요. 지연 시간이 낮더라도 웹 페이지 주소 확인, TLS 협상, 데이터 전송 또는 다른 앱의 접속이 정상이라고 단정할 수는 없습니다.
- 기준 결과 기록.현재 로컬 네트워크, 선택한 서버, Global Routing 방식을 기록하고 동일한 페이지에 접속합니다. 결과에 영향을 준 조건을 파악하기 어려워지므로 Wi-Fi와 셀룰러 네트워크를 전환하면서 서버까지 바꾸지 마세요.
- 실제 경로 확인.라우팅을 확인해야 한다면 클라이언트에서 사용할 수 있는 연결 기록 또는 Data 관련 화면에서 해당 요청을 찾아 일치한 규칙과 실제 경로를 확인합니다. 누적 트래픽이 증가한 것만으로 특정 요청이 프록시를 사용했다고 볼 수는 없습니다.
- 한 번에 하나의 조건만 변경.구성(Config)에서 실패한다면 같은 서버를 유지한 채 프록시(Proxy)로 임시 전환해 다시 접속합니다. 로컬 네트워크 자체의 상태를 확인하려면 직접 연결(Direct)과 비교합니다. 매번 결과를 기록하고 테스트 후에는 사용할 예정인 방식으로 되돌립니다.
프록시(Proxy)에서는 접속되지만 구성(Config)에서는 실패한다면 현재 구성의 일치 규칙, 실제 정책 및 DNS 관련 설정을 우선 확인합니다. 두 방식 모두 실패한다면 서버 매개변수와 로컬 네트워크를 확인하세요. 브라우저는 정상인데 앱 하나만 실패한다면 해당 앱의 연결 방식, 캐시 또는 프로토콜 요건과 관련된 문제일 수 있습니다. 앱을 다시 열어 같은 작업을 반복하고, 구성을 바로 초기화하지 마세요.
확인의 기준은 특정 아이콘이 표시되는지 또는 모든 테스트 항목에 지연 시간이 나오는지가 아닙니다. 목표 작업을 안정적으로 반복할 수 있고, 사용 경로가 예상과 일치해야 합니다. 평소 사용하는 네트워크로 돌아가 같은 검사를 다시 할 수 있습니다. 결과가 달라진다면 “어떤 네트워크에서, 어떤 방식으로, 어떤 항목이 실패했는지”를 기록하세요. 단순히 “연결이 안 된다”고 설명하는 것보다 정확하게 문제를 확인할 수 있습니다.
STEP 05 / DIAGNOSE
Settings: 전부 초기화하지 말고 실패 단계별로 확인
문제 해결은 가장 먼저 실패한 단계부터 시작합니다. 항목을 가져오지 못했다면 가져오기 문제를 해결하고, 항목은 있지만 연결이 수립되지 않는다면 서버 정보를 확인합니다. 연결은 안정적이지만 접속 결과가 예상과 다를 때 규칙을 확인합니다. 문제를 단계별로 나누면 구독을 가져오지 못한 상태에서 DNS를 반복 조정하거나 시스템 권한을 취소한 상태에서 비밀번호를 계속 바꾸는 일을 방지할 수 있습니다.
가져온 뒤 항목이 없거나 구독 업데이트에 실패함
먼저 전체 구독 주소를 다시 확인하고, 주소가 유효하며 매개변수가 빠지지 않았는지 살펴봅니다. 현재 네트워크에서 구독 주소가 있는 서버에 접속할 수 있는지도 확인하세요. 구독 가져오기와 서버 연결은 별개의 과정입니다. 기존 항목은 연결되더라도 구독 서버에 일시적으로 접속할 수 없을 수 있으며, 반대로 항목을 업데이트할 수 있어도 각각의 서버가 사용 가능하다는 뜻은 아닙니다. 같은 구독을 연이어 추가하지 말고 기존 그룹을 유지한 채 업데이트 중 표시된 오류를 확인하세요.
항목은 있지만 테스트에 실패하거나 스위치가 유지되지 않음
직접 입력한 항목은 Type, Host, Port, Password와 프로토콜별 Method, TLS 또는 전송 설정을 중점적으로 확인합니다. 매개변수를 복사할 때 대소문자와 앞뒤 공백에 유의하세요. 시스템 시간이 크게 잘못된 경우 인증서 관련 연결에 영향을 줄 수도 있습니다. 스위치가 유지되지 않으면 시스템 VPN 권한과 다른 활성 연결을 먼저 확인합니다. 스위치가 켜진 채 유지되지만 서버 테스트에 실패한다면 서버 정보와 접속 가능 여부를 중점적으로 살펴보세요.
테스트 결과는 있지만 웹 페이지나 앱이 열리지 않음
Settings에서 Test Method를 확인하고 현재 테스트 방식을 파악한 뒤 Connectivity Test 결과를 해석합니다. 테스트 방식마다 확인 범위가 다릅니다. 앞 단계의 방법에 따라 구성(Config)과 프록시(Proxy)를 비교하세요. 규칙 방식에서만 실패한다면 일치한 규칙을 확인합니다. 특정 앱에서만 실패한다면 앱에서 수행한 작업과 실패 현상을 기록하고, 앱 하나의 문제를 전체 연결 문제로 단정하지 마세요.
네트워크 전환 후 자동 연결되거나 추가 진단이 필요함
Settings에서 기존 On Demand 설정을 확인하고 현재 네트워크 조건에 맞는 자동 연결이 작동하는지 살펴봅니다. 수동으로 비교하려면 기존 설정을 기록한 뒤 잠시 비활성화하고 테스트가 끝나면 복원합니다. Settings에는 Diagnostics, Proxy, TCP, UDP 등의 항목도 있습니다. 이름에 네트워크 관련 내용이 있다고 해서 모두 변경하지 마세요. 오류 메시지나 정보가 특정 항목을 명확히 가리키는 경우에만 조정합니다.
Diagnostics 또는 연결 기록을 이용해 추가로 확인해야 한다면 문제를 한 번 재현한 뒤 해당 작업과 관련된 내용만 보관합니다. 공유하기 전에 전체 구독 주소, 인증 매개변수, 서버 비밀번호와 개인을 식별할 수 있는 정보를 숨기세요. 유용한 문제 설명에는 실패 단계, Global Routing 방식, 네트워크 유형 및 이미 수행한 개별 비교가 포함됩니다. 매개변수 자체를 공개할 필요는 없습니다.
문제를 계속 확인하기 어렵다면 FAQ에서 해당 항목을 찾아보세요. App Store 다운로드, 스토어 지역, 기기 변경 또는 구매 복원과 관련된 문제는 설치 가이드를 참고하세요. 이 문제들은 앱 설치 과정에 해당하므로 Add Server나 Config를 수정해 해결할 필요가 없습니다. 문제 해결을 마친 뒤 임시 테스트 항목을 삭제하고, 사용할 Global Routing 방식으로 복원한 다음 일반 네트워크에서 접속이 반복해서 되는지 확인하세요.