공식 매뉴얼 / 빠른 시작
Shadowrocket 빠른 시작
기존 구독 가져오기 → Global Routing → 연결 및 확인
다섯 단계를 순서대로 진행하세요. 먼저 입력 정보를 확인하고 연결 결과를 점검합니다. 문제가 생기면 해당 단계로 돌아가 확인하면 되며, 모든 설정을 처음부터 다시 할 필요는 없습니다.
- 01 추가
- 02 라우팅
- 03 연결
- 04 확인
- 05 문제 해결
단계 01 / 연결 정보 입력
Add Server에서 추가 및 가져오기
구독 가져오기와 직접 추가 중 보유한 정보 유형에 맞는 방법을 선택하세요. 저장 후 항목이 표시되면 다음 단계로 진행합니다.
구독 링크가 있는 경우: Subscribe 선택
Shadowrocket의 Home을 열고 SERVER 영역에서 Add Server를 찾거나 화면의 추가 버튼을 사용합니다. Add Server에서 Type을 누르고 Subscribe를 선택한 다음 URL 입력란에 본인의 전체 구독 링크를 붙여 넣습니다. Type에 따라 입력란이 달라지므로 먼저 Type을 선택한 뒤 내용을 입력하세요. 구독 주소를 단일 서버의 Host 입력란에 잘못 넣는 일을 방지할 수 있습니다.
붙여 넣은 뒤 링크의 시작부터 끝까지 확인하세요. 링크는 보유한 서비스 설정에서 가져와야 하며, 쿼리 매개변수가 빠지거나 안내 문구, 공백 또는 줄바꿈이 섞여서는 안 됩니다. 구독 링크에는 이용 자격을 확인하는 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하고 공개 게시물이나 스크린샷에 노출하지 마세요. 알아보기 쉬운 이름을 입력한 뒤 화면의 저장 기능을 사용해 Home으로 돌아갑니다. 업데이트 안내가 표시되면 안내에 따라 구독 내용을 가져오세요.
가져온 뒤 SERVER에서 구독 그룹과 서버 항목이 표시되는지 확인하세요. 그룹 이름이 보여도 내용이 성공적으로 가져와졌다는 뜻은 아닐 수 있습니다. 목록이 비어 있다면 먼저 링크가 온전한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지, 구독이 유효한지 확인하세요. 구독 내용 가져오기와 연결 모드는 별개의 단계이므로 이때 Global Routing을 반복해서 변경하지 마세요.
개별 서버 정보가 있는 경우: Type에 맞게 입력
서버 매개변수 정보를 보유한 경우 Add Server의 Type에서 자료와 일치하는 프로토콜(예: Shadowsocks, VMess, VLESS, Trojan 또는 WireGuard)을 선택한 뒤 해당 유형에 필요한 항목을 입력합니다. 공식 스크린샷에는 Host, Port, Password, Method 등이 표시되지만 모든 프로토콜에서 사용하는 것은 아닙니다. Host에는 서버 호스트 이름이나 IP를, Port에는 포트 번호를 입력하세요. 경로가 포함된 전체 웹 주소를 Host로 입력하지 마세요.
인증 정보, 암호화 방식 및 전송 매개변수는 원래 자료와 하나씩 대조해야 합니다. TLS를 사용하는 구성에서는 서버 이름과 인증서 관련 항목도 일치해야 합니다. 테스트를 통과시키려고 검증 요구 사항을 임의로 낮추지 마세요. 자료가 QR 코드만 제공하는 경우 Scan QR Code를 사용한 뒤 Type과 주요 항목을 확인하세요. Import from Cloud JSON은 별도의 가져오기 방법이며 일반 구독 링크와 같지 않습니다. 해당 형식의 자료가 있는 경우에만 사용하세요.
저장한 뒤 Home으로 돌아가 항목이 중복되지 않았는지, 프로토콜과 이름을 알아보기 쉬운지 확인합니다. 가져오기는 연결 정보를 앱에 저장하는 과정일 뿐, 연결이 완료되거나 서버가 사용 가능하다는 뜻은 아닙니다. 테스트할 항목 하나를 정하고 다음 단계에서 어떤 라우팅 모드로 사용할지 확인하세요.
단계 02 / 요청 처리 방식 선택
Global Routing의 세 가지 모드
Config, Proxy, Direct는 요청 처리 방식을 결정합니다. 서버 항목과 Config 구성 파일은 서로 다른 것입니다.
Home으로 돌아가 Global Routing을 엽니다. 서버가 선택되어 있는지만 보지 말고 현재 목적에 맞는 모드를 선택하세요. Config는 현재 구성 파일의 규칙에 따라 요청을 처리합니다. Proxy는 일반적인 요청을 선택한 프록시 서버를 통해 처리하므로 규칙의 영향을 분리해 확인할 때 적합합니다. Direct는 선택한 프록시 서버를 거치지 않습니다. 모드를 바꿔도 서버 매개변수가 자동으로 채워지지는 않습니다.
처음 사용하는 경우 확인된 구성 파일이 있다면 Config를 선택할 수 있습니다. 방금 추가한 서버가 요청을 정상적으로 전달하는지만 확인하려면 먼저 Proxy로 제한된 테스트를 진행하세요. Direct는 로컬 네트워크의 기본 접속 상태를 확인할 때 적합하며 프록시 서버 자체를 검증하는 데는 적합하지 않습니다. 모드를 바꾼 뒤 Home으로 돌아와 Global Routing 옆에 표시된 이름을 확인해 실제로 선택됐는지 점검하세요.
Config를 사용하기 전에 현재 구성을 확인하세요
하단의 Config를 열어 현재 사용 중인 구성을 확인한 다음 내용을 열어 General과 Rule을 살펴봅니다. 공식 스크린샷에는 Hosts, URL Rewrite, HTTPS Decryption 섹션도 표시되지만 기본 연결을 위해 이 기능들을 하나씩 켤 필요는 없습니다. 특히 인증서와 콘텐츠 처리에 관한 항목은 첫 연결 절차에 포함되지 않습니다. 기능을 이해한 뒤 별도로 설정하세요.
Rule의 규칙은 순서대로 적용됩니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 도메인 접미사로 일치 여부를 확인해 해당 정책으로 처리한다는 뜻이고, FINAL,DIRECT는 앞선 규칙과 일치하지 않은 요청을 DIRECT로 보냅니다. 여기의 규칙은 문법을 설명하기 위한 예시이며, 이 가이드를 따라 하려고 구성에 추가할 필요는 없습니다. 실제 요청이 프록시를 거치는지는 현재 파일, 규칙 순서 및 정책 대상에 따라 달라집니다.
구독은 보통 서버 항목을 제공하는 용도이며, 트래픽 분기 규칙이 포함된 전체 구성과 같은 의미가 아닙니다. 구독만 가져오고 Config 내용을 확인하지 않았다면 모든 앱의 트래픽이 기대한 대로 분기된다고 가정해서는 안 됩니다. 익숙하지 않은 규칙을 여러 개 동시에 가져와 설정을 보완하려고 하지 마세요. 어느 항목이 결과를 바꿨는지 확인하기 어려워집니다.
이번 단계에서는 Global Routing 모드를 확인하고 Config가 참조하는 파일을 확인하는 두 가지 작업만 진행합니다. 연결에 성공한 뒤 세부 설정을 조정하고 싶다면 Settings 설정 가이드를 읽어보세요. 규칙 적용과 가져오기 방식의 차이는 FAQ에서 확인할 수 있습니다. 완료되면 Home으로 돌아가 연결을 시작하세요.
단계 03 / 시스템 연결 설정
Home에서 서버 선택 및 연결
먼저 항목을 선택하고 Global Routing을 확인한 다음 상단 스위치를 켭니다. 시스템 권한 승인과 서버 인증은 서로 다른 절차입니다.
Home으로 돌아가 SERVER에서 이번에 사용할 서버를 선택합니다. 그룹이 여러 개라면 해당 그룹을 펼친 다음 선택 표시가 목표 항목에 있는지 확인하세요. 목록 위치만 보고 판단하지 마세요. 구독을 업데이트하면 항목 순서가 바뀔 수 있습니다. 이어서 Global Routing을 다시 확인하고 앞 단계의 테스트 목적에 맞는 모드인지 살펴보세요.
Home 상단 스위치를 켭니다. 연결 전 공식 스크린샷에는 Not Connected 상태가 표시됩니다. 처음 연결할 때 시스템에서 VPN 구성 추가를 요청할 수 있습니다. 이는 앱이 시스템 네트워크 확장 기능을 통해 트래픽을 처리하도록 허용하는 절차이며 원격 서버 비밀번호를 입력하는 곳이 아닙니다. 시스템 안내를 읽고 현재 작업이 Shadowrocket에서 시작됐는지 확인한 뒤 기기의 요구 사항에 따라 인증을 완료하세요. 권한 요청을 취소하면 앱이 정상적으로 연결되지 않을 수 있습니다.
승인한 뒤 Shadowrocket으로 돌아가 상단 상태가 바뀔 때까지 기다립니다. 상태가 바뀌는 동안 스위치를 연속해서 켰다 끄지 마세요. 곧바로 연결이 끊기면 스위치를 켜둔 채 성공으로 간주하지 말고 먼저 안내 내용을 확인하세요. 시스템에 VPN 표시가 나타나면 관련 네트워크 연결이 설정됐다는 뜻일 뿐, 선택한 서버와 도메인 확인, 트래픽 분기 규칙이 모두 정상이라는 증거는 아닙니다. 실제 접속은 다음 단계에서 확인해야 합니다.
연결 후에는 안정적인 테스트 조건을 유지하세요
첫 테스트에서는 현재 네트워크를 유지하고 Wi-Fi, 셀룰러 네트워크 및 여러 서버를 동시에 바꾸지 마세요. 기기에 다른 VPN 연결도 설정되어 있다면 이번에 테스트할 연결이 실제로 활성화되어 있는지 확인해 서로 다른 구성의 결과가 섞이지 않도록 하세요. 네트워크 제한, 서버 상태 및 인증 매개변수가 결과에 영향을 줄 수 있습니다. 여러 번 재시도하는 것만으로는 원인을 구분하기 어렵습니다.
iPad에서도 Home, SERVER, Global Routing, 상단 스위치 순서로 확인하세요. 화면 배치는 달라도 절차는 같습니다. 연결에 성공한 뒤 테스트할 앱으로 전환할 수 있지만, 먼저 여러 규칙을 한꺼번에 변경하지 마세요. 이후 서버 매개변수나 연결에 영향을 주는 설정을 바꿨다면 화면 안내에 따라 다시 연결한 뒤 재확인하세요. 이전 연결의 결과로 새 설정을 판단하지 않도록 주의해야 합니다.
사용을 마치려면 Home으로 돌아가 상단 스위치를 끄면 됩니다. 끈 뒤 자동으로 다시 연결된다면 모든 정보를 바로 삭제하지 말고, 먼저 발생 당시의 네트워크 조건을 기록한 뒤 On Demand를 확인하세요. 이제 확인 단계에서 스위치가 켜져 있는 상태와 요청이 예상대로 처리되는 상태를 각각 점검합니다.
단계 04 / 결과를 단계별로 확인
Connectivity Test와 실제 접속
테스트 결과, 시스템 연결 상태, 페이지 접속 및 규칙 적용은 각각 다른 질문에 답합니다. 순서대로 확인하세요.
먼저 Home으로 돌아가 Connectivity Test에서 항목의 테스트 결과를 확인합니다. 테스트 방식에 따라 결과의 의미가 달라집니다. 서버 포트에 연결할 수 있어도 인증, TLS 또는 후속 요청이 정상적으로 완료된다는 뜻은 아닙니다. 특정 테스트가 실패했다고 실제 접속이 모두 실패한다고 단정할 수도 없습니다. 하나의 수치를 전체 연결 경로에 대한 결론으로 간주하지 말고, 수치의 크기만으로 현재 작업에 적합한 서버인지 판단하지 마세요.
그런 다음 사용 권한이 있는 필요한 페이지를 열고 대상 하나를 먼저 확인합니다. 주요 콘텐츠가 로드될 때까지 기다린 뒤 페이지 내에서 일반적인 작업을 시도하세요. 페이지는 열리지만 이미지, 로그인 또는 API 요청이 실패한다면 어느 부분에서 문제가 생겼는지 기록합니다. 한 페이지가 여러 도메인을 사용할 수 있고, Config에서는 각 도메인에 서로 다른 규칙이 적용될 수도 있습니다. 캐시된 페이지를 반복해서 새로 고치는 것만으로 새 설정이 적용됐다고 확인할 수는 없습니다.
세 가지 항목으로 문제 구분하기
- 연결이 유지되는가: Home으로 돌아가 스위치와 연결 상태가 끊기지 않았는지 확인합니다. 연결이 끊겼다면 먼저 권한, 서버 매개변수 및 네트워크를 점검하고 Rule은 나중에 확인하세요.
- 선택한 서버가 사용되는가: 현재 모드가 Direct라면 페이지가 열려도 프록시 서버가 정상이라는 증거가 되지 않습니다. Proxy로 전환해 비교 테스트를 한 뒤 필요에 따라 Config로 되돌리세요.
- 규칙이 예상대로 적용되는가: Config에서 현재 Rule과 관련 연결 기록을 함께 확인해 대상 요청을 살펴봅니다. 특정 페이지가 열렸다고 해서 다른 도메인이나 모든 앱에도 같은 정책이 적용된다고 볼 수는 없습니다.
추가로 확인할 필요가 있다면 Data에서 트래픽 변화를 보거나 진단 기록으로 요청 처리 상태를 살펴볼 수 있습니다. 트래픽 변화는 참고 정보일 뿐입니다. 백그라운드 앱도 네트워크를 사용할 수 있으므로 데이터가 증가했다고 방금 테스트한 페이지가 목표 서버를 거쳤다는 뜻은 아닙니다. 재현하기 쉽도록 대상 도메인, 테스트 시각 및 당시 Global Routing 설정을 함께 기록하세요.
Proxy 테스트는 성공하지만 Config에서 실패한다면 규칙, 정책 및 DNS 설정을 먼저 확인하세요. 두 모드에서 모두 실패한다면 서버 정보와 네트워크를 먼저 점검합니다. 확인이 끝나면 장기간 사용할 모드로 되돌린 뒤 간단히 다시 테스트하세요. 복잡한 트래픽 분기 문제는 연결 및 트래픽 분기 FAQ를 참고할 수 있습니다. 처음 시작할 때 모든 고급 기능을 한꺼번에 다룰 필요는 없습니다.
단계 05 / 최소한의 변경으로 문제 해결
Settings 및 자주 발생하는 문제
한 번에 한 가지 조건만 바꾸고 기존 값을 기록한 뒤 다시 테스트하세요. 먼저 실패 단계부터 파악한 다음 해당 설정을 확인합니다.
가져오기 실패 또는 서버 목록이 비어 있음
단계 01로 돌아가 구독 링크가 온전한지, Subscribe를 선택했는지, 현재 네트워크에서 구독 내용을 가져올 수 있는지 다시 확인하세요. 링크 만료, 로그인 페이지 반환 또는 지원되지 않는 형식의 콘텐츠 반환으로 목록이 만들어지지 않을 수 있습니다. 구독 주소를 일반 서버의 Host로 입력하지 마세요. 직접 추가했다면 원본 자료와 Type, Host, Port, 인증 및 전송 항목을 대조하고, 특히 붙여 넣을 때 공백이나 문자가 빠지지 않았는지 확인하세요.
원본 자료를 제공한 곳에 문의해야 한다면 실패 단계와 표시된 안내만 설명하고, 필요한 경우 민감한 정보를 가린 항목 스크린샷을 제출하세요. 전체 구독 URL, 비밀번호 또는 개인 키를 공개된 곳에 올리지 마세요. 항목을 삭제하고 다시 만들기 전에 원본 정보를 다시 받을 수 있는지 확인하세요. 그렇지 않으면 유일하게 보관해 둔 연결 정보가 사라질 수 있습니다.
테스트 실패 또는 연결 후 접속 불가
먼저 기기 자체의 기본 네트워크 연결을 확인한 다음 대상 항목을 점검하세요. Settings에서 Test Method를 열어 현재 Connectivity Test가 어떤 방식으로 확인하는지 살펴보세요. 테스트 방식을 바꾸면 확인 기준만 달라질 뿐 잘못된 매개변수가 수정되지는 않습니다. 네트워크를 바꾼 뒤 결과가 달라진다면 네트워크 차이를 기록하세요. 서버 설정을 동시에 변경하면 문제가 어느 쪽에서 비롯됐는지 판단하기 어렵습니다.
시스템 연결은 유지되지만 실제 페이지가 열리지 않는다면 단계 04에 따라 Proxy와 Config를 비교하세요. Proxy는 성공하고 Config는 실패한다면 현재 Config의 규칙 대상, DNS 및 관련 설정을 점검합니다. 인증서 또는 서버 이름 관련 오류가 나타나면 원본 자료와 TLS 매개변수를 대조하세요. 검증 건너뛰기를 일반적인 해결 방법으로 사용하지 마세요. TCP, UDP 또는 특정 전송에 관한 세부 사항은 문제 범위를 좁힌 뒤 하나씩 확인하세요.
자동 연결 문제 및 진단 기록
Settings에서 On Demand를 찾아 네트워크 조건에 따라 연결이 시작되도록 설정되어 있는지 확인하세요. 이는 Home 스위치를 직접 켜는 것과 다른 제어 방식입니다. 예기치 않은 재연결을 조사하는 경우 원래 설정을 먼저 기록한 뒤 관련 자동 연결 조건을 잠시 중지해 비교할 수 있습니다. Today Widget은 빠른 실행 기능이며 Home에서 연결 상태를 확인하는 절차를 대신하지 않습니다.
추가 단서가 필요하면 Diagnostics와 사용 가능한 로그를 확인하고 오류 유형, 당시 모드 및 네트워크 조건을 기록하세요. 로그에는 도메인, 주소 및 연결 식별 정보가 포함될 수 있으므로 공유 전에 민감한 내용을 가리세요. 정보 수집을 위해 불필요한 상세 기록을 장기간 보관하지 마세요. Proxy, TCP, UDP 등 여러 설정을 한꺼번에 변경하지 마세요. 이 항목들은 범용 연결 복구 스위치가 아닙니다.
변경을 하나 마칠 때마다 Home으로 돌아가 필요에 따라 다시 연결한 뒤 같은 대상을 재확인하세요. 계속 실패하면 문제를 '가져오기', '연결 설정', '서버 접속' 또는 '규칙 처리'로 분류하고 해당 안내를 FAQ에서 확인하세요. DNS, On Demand, 테스트 방식 및 로그 설정을 자세히 알아보려면 Settings 설정 가이드를 읽어보세요. 가져오기, 모드, 연결 및 실제 접속을 모두 확인하면 이 페이지의 첫 시작 절차가 완료됩니다.
