공식 매뉴얼 · 첫 연결
Shadowrocket 사용 가이드: 구독 가져오기와 첫 연결
보유한 서버 정보를 Shadowrocket에 올바르게 입력한 다음 트래픽 경로를 선택하고, 연결을 켜서 결과를 확인합니다. 아래 다섯 단계는 재확인 가능한 연결을 완료하기 위한 것으로, 처음부터 모든 설정을 변경할 필요는 없습니다.
준비 사항: 앱 설치 및 본인의 연결 정보먼저 Shadowrocket을 설치해야 합니다. iPhone / iPad에서는 App Store에서 다운로드하고, 컴퓨터와 Android에서는 다운로드 페이지에서 무료로 설치할 수 있습니다. iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제이며, Mac / Windows / Android / Linux 버전은 무료입니다. iPhone / iPad의 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요.
이 가이드는 iPhone / iPad 화면을 기준으로 설명합니다. 시작하기 전에 본인의 구독 링크나 서버 정보가 있는지 확인하세요. 구독은 서비스 제공업체에서 받아야 하며, 이 사이트는 서버나 구독 서비스를 제공하지 않습니다. 앱을 한 번 구매하는 것과 회선 요금제는 별개입니다. 앱을 설치해도 사용할 수 있는 서버가 자동으로 제공되지는 않습니다.
현재 구성과 서비스 제공업체가 제공한 원래 매개변수를 먼저 보관하고, 기존 항목을 서둘러 삭제하지 마세요. 처음에는 명확한 서버 하나 또는 용도를 알고 있는 구독 하나만 사용하고 네트워크도 그대로 유지하는 것이 좋습니다. 문제가 생겼을 때 정보 가져오기, 서버 연결, 규칙 선택 중 어느 단계에서 차이가 발생했는지 구분할 수 있습니다.
서버 추가 또는 기존 구독 가져오기
받은 정보가 단일 서버 정보인지, 서버 구독 링크인지, 구성 파일 링크인지 먼저 구분합니다. 모두 텍스트나 URL 형태일 수 있지만 가져온 뒤 표시되는 위치와 용도는 다릅니다. 서버 정보는 연결할 대상을 결정하고, 구성 파일은 주로 요청 처리 방식을 결정합니다. 링크가 HTTPS로 시작한다고 해서 무조건 Config에 넣어야 하는 것은 아닙니다.
단일 서버: Home에서 Add Server 열기
Shadowrocket의 Home을 열고 오른쪽 위의 추가 버튼을 눌러 Add Server로 이동합니다. 먼저 Type에서 서비스 제공업체가 지정한 프로토콜을 선택한 다음, 원래 제공된 정보에 따라 주소, 포트와 해당 인증 필드를 입력합니다. Shadowsocks, VMess, VLESS, Trojan 등은 프로토콜마다 입력 필드가 다르므로 한 프로토콜의 비밀번호나 식별자를 다른 프로토콜의 양식에 입력하면 안 됩니다.
주소와 포트만 확인하지 말고 각 항목을 원본과 하나씩 대조합니다. 서비스 제공업체가 TLS, Server Name, 전송 방식 또는 경로를 제공했다면 해당 값도 안내에 따라 입력해야 합니다. 서버 표시 이름으로 이런 값을 추측할 수는 없습니다. 저장한 뒤 Home으로 돌아와 SERVER 영역에 항목이 추가되었는지 확인하고 사용할 서버를 선택합니다. 이름은 항목을 구별하기 위한 메모일 뿐, 매개변수가 올바른지 판단하는 기준은 아닙니다.
서버 구독: Add Server에서 Subscribe 선택
서버 구독 링크를 받았다면 Add Server의 Type에서 Subscribe를 선택하고 전체 링크를 URL에 입력한 뒤 알아보기 쉬운 메모를 설정하고 저장합니다. 구독 링크는 서비스 제공업체에서 받아야 합니다. 복사할 때 설명 문구, 줄바꿈, 앞뒤 따옴표가 들어가지 않도록 하고 물음표 뒤의 매개변수를 임의로 삭제하지 마세요.
가져오고 내용을 불러온 뒤 Home으로 돌아가 SERVER 목록에 해당 그룹과 서버가 표시되는지 확인합니다. 구독 항목을 저장했다고 해서 서버 정보를 성공적으로 가져온 것은 아닙니다. 목록이 여전히 비어 있으면 다음 연결 단계로 넘어가기 전에 구독을 정상적으로 불러왔는지 확인합니다. 기존 구독을 업데이트할 때는 다시 추가할 필요가 없습니다. 원래 구독의 업데이트 기능을 찾아 같은 항목이 중복되어 잘못 선택되는 일을 방지하세요.
Config의 Subscribe: 구성 파일 구독용
규칙 구성 파일 링크를 받았다면 Config로 이동해 Subscribe 관련 메뉴에서 구성 파일 구독을 추가하거나 관리합니다. 가져온 뒤 파일을 사용할 수 있는지, 실제로 어떤 구성이 활성화되었는지 확인하세요. 서버 구독과 구성 파일 구독은 서로 대체할 수 없습니다. Home에 서버가 있다고 해서 Config에서 규칙이 선택된 것은 아니며, Config에 파일이 있다고 해서 Home에 사용 가능한 서버가 있는 것도 아닙니다.
QR 코드나 단일 프로토콜 링크를 받은 경우 앱에서 제공하는 QR 스캔 또는 클립보드 가져오기를 이용할 수 있습니다. 출처가 명확하고 본인이 보유한 정보만 처리하세요. 구독 URL에는 접근 자격 증명이 포함될 수 있으므로 전체 링크, QR 코드, 인증 필드를 공개 페이지에 게시하지 마세요. 가져오기 경로를 더 구분하려면 Subscribe, Add Server, QR 스캔 및 클립보드 가져오기 안내를 참고하세요. SERVER에 선택 가능한 항목이 있는지 확인한 뒤 다음 단계로 이동합니다.
Global Routing 선택: Config / Proxy / Direct
Home으로 돌아와 Global Routing을 눌러 이번 연결에서 사용할 방식을 먼저 결정합니다. 이 설정은 요청의 처리 방향을 제어하며 서버 매개변수와는 무관하고, 만료된 구독을 복구하지도 않습니다. 처음 사용할 때는 “어떤 서버를 선택할지”와 “요청을 어떤 방식으로 처리할지”를 따로 확인하세요. 한 항목만 변경하고 연결 조건 전체가 바뀌었다고 판단하지 않도록 합니다.
| 방식 | 처리 방법 | 처음 사용할 때 확인할 사항 |
|---|---|---|
| Config | 현재 활성화된 구성의 규칙에 따라 정책을 결정합니다. | Config에서 활성 구성을 확인하고 규칙이 예상과 일치하는지 확인합니다. |
| Proxy | 요청을 프록시 경로로 처리하며 선택한 서버의 연결을 확인할 때 사용합니다. | Home에서 현재 선택한 서버를 확인합니다. 구성 규칙이 적용되었다는 뜻은 아닙니다. |
| Direct | 요청을 직접 연결 경로로 처리합니다. | 비교 기준을 마련할 때 적합하며 프록시 서버의 사용 가능 여부를 확인하는 용도는 아닙니다. |
적합한 규칙 구성이 있고 도메인이나 주소별로 트래픽을 분기하려면 Config를 선택한 다음 Config에서 현재 활성화된 파일을 확인합니다. 파일이 목록에 보인다는 사실만으로 실제 사용 중이라고 판단할 수는 없습니다. 규칙이 올바른지 아직 확신할 수 없다면 원래 방식을 기록해 둔 뒤 Proxy를 임시로 선택해 서버를 테스트합니다. 기본 연결을 확인한 뒤 Config로 돌아가 같은 대상의 접속 결과를 비교합니다.
Direct는 현재 네트워크의 직접 접속 상태를 비교할 때 주로 사용합니다. Direct로 전환한 뒤 웹 페이지가 열려도 이전에 선택한 서버가 복구되었다는 뜻은 아니며, 연결 스위치가 반드시 꺼졌다는 뜻도 아닙니다. 비교를 마친 뒤에는 필요한 방식으로 돌아가 Home에 표시된 Global Routing 값을 다시 확인합니다.
처음에는 방식만 변경하고 규칙은 그대로 두기구성 파일은 먼저 원본 그대로 유지합니다. Proxy는 정상인데 Config에서 문제가 발생하면 모든 서버 매개변수를 다시 입력하기보다 활성 구성과 규칙 일치 결과부터 확인합니다. 규칙 키워드, 정책, 일치 순서는 규칙 및 구성 참고 자료를 확인하세요.
이 페이지에서는 새 규칙을 만들 필요가 없습니다. 현재 방식, 선택한 서버, 활성 구성이라는 세 가지 조건을 먼저 확인한 뒤 연결을 켜야 이후 결과를 비교할 수 있습니다.
Home에서 연결 스위치를 켜고 VPN 구성 허용
Home의 SERVER 영역에서 앞서 확인한 서버를 선택하고 Global Routing 값을 확인한 다음, 페이지 상단의 연결 스위치를 켭니다. 처음 연결하기 전에는 Not Connected가 표시될 수 있습니다. 조작 후에는 상태가 바뀌는지 확인하고 스위치를 연속해서 여러 번 누르지 마세요. 반복해서 스위치를 켜고 끄면 진행 중인 연결이 중단되고 시스템 승인 안내와 앱 상태가 뒤섞여 판단하기 어려워집니다.
처음 표시되는 시스템 승인 안내 처리
처음 사용할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용하라는 안내가 표시됩니다. 해당 앱에 대한 안내인지 확인하고 허용을 선택한 다음, 시스템 요구에 따라 기기 암호나 생체 인증으로 확인합니다. 이 단계는 기기에서 연결을 위한 시스템 구성을 설정하는 절차이며, 서버를 추가하거나 서비스 제공업체가 제공한 구독 내용을 수정하지 않습니다. 이전에 요청을 거부했다면 앱으로 돌아가 연결을 다시 시작한 뒤 시스템 안내에 따라 진행합니다.
승인이 끝나면 Shadowrocket으로 돌아와 상단 스위치와 연결 상태를 확인합니다. 시스템 설정에 VPN 구성이 있다는 사실은 구성이 만들어졌다는 뜻일 뿐, 서버 접속 가능 여부, 인증 성공 여부, 웹 페이지 접속 상태를 보장하지 않습니다. 시스템에 VPN 연결됨이라고 표시되더라도 다음 단계에서 실제 요청을 확인해야 합니다.
스위치가 바로 꺼지거나 상태가 바뀌지 않는 경우
먼저 Home에서 서버를 실제로 선택했는지 확인합니다. 구독 항목만 추가하고 서버를 선택하지 않은 상태일 수 있습니다. 이어서 시스템 승인이 완료되었는지, 다른 VPN 연결이나 기기 관리 정책이 현재 연결에 영향을 주는지 확인합니다. 용도를 알 수 없는 시스템 구성을 바로 삭제하지 마세요. 관리되는 기기는 기기 관리 요구 사항을 따라야 합니다.
처음 문제를 확인할 때는 On Demand를 활성화하지 않아도 됩니다. On Demand는 조건에 따라 연결을 시작하는 기능이며 수동 연결에 필요한 설정은 아닙니다. 자동 연결과 수동 스위치를 함께 사용하면 “왜 끈 뒤에 다시 연결되는지” 파악하기 어려워집니다. 이미 On Demand를 활성화했다면 기존 설정을 기록한 뒤 자동 연결을 잠시 끄고 수동으로 테스트합니다.
스위치가 켜진 상태를 유지하고 앱 상태가 업데이트되면 확인 단계로 이동합니다. 아직 서버를 바꾸거나 DNS를 조정하지 말고, 현재 조건에서 어떤 요청이 실제로 처리되는지 먼저 확인하세요.
Connectivity Test와 실제 접속으로 작동 확인
연결이 작동하는지 세 단계로 확인합니다. 시스템 연결이 설정되었는지, 선택한 서버가 테스트를 완료할 수 있는지, 대상 요청이 예상대로 처리되는지 살펴봅니다. 어느 한 단계의 성공도 다른 단계의 확인을 대신할 수 없습니다. 네트워크를 바꾸기 전에 현재 Wi-Fi 또는 셀룰러 네트워크에서 전체 점검을 마쳐 테스트 조건이 계속 달라지지 않도록 합니다.
먼저 Connectivity Test를 실행한 뒤 실제 요청 보내기
Home에서 Connectivity Test를 실행해 선택한 서버의 테스트 결과를 확인합니다. 테스트 방식마다 점검하는 단계가 다를 수 있으므로 응답은 해당 테스트의 결과만 보여줄 뿐, 모든 웹 페이지와 앱이 작동한다고 보장하지 않습니다. 목록에 표시된 응답 시간 한 번만 보고 서버를 연속으로 바꾸지 마세요. 현재 선택한 항목과 방금 테스트한 항목이 같은지 먼저 확인합니다.
다음으로 브라우저를 열어 평소 사용할 수 있다고 확인한 HTTPS 페이지에 접속한 다음 한 번 새로고침합니다. 페이지가 캐시되어 있다면 이전 내용이 표시되어도 새로운 네트워크 요청이 발생했다고 볼 수 없습니다. 페이지에서 아직 열지 않은 링크를 여는 등 정상적인 네트워크 작업을 추가로 확인할 수 있지만, 출처가 불분명한 테스트 페이지 하나만으로 판단하지 마세요.
Config에서는 실제 적용된 정책도 확인
규칙에 따른 트래픽 분기를 확인하려면 Config에서 예상 정책을 알고 있는 대상에 접속합니다. 그런 다음 앱의 Data 또는 연결 기록 관련 화면으로 돌아가 대상 도메인과 요청 시간을 기준으로 해당 기록을 찾아 실제 적용된 정책을 확인합니다. 웹 페이지가 열린다는 이유만으로 프록시를 통했다고 단정할 수는 없습니다. DIRECT 경로에서도 페이지가 정상적으로 표시될 수 있습니다.
결과가 예상과 다르면 같은 대상, 같은 서버, 같은 네트워크를 유지한 채 Proxy로 잠시 전환해 다시 테스트합니다. Proxy는 정상이고 Config에서 문제가 발생하면 규칙과 구성을 먼저 확인합니다. 둘 다 실패하면 서버, 인증, 현재 네트워크를 우선 점검합니다. 테스트가 끝나면 필요한 방식으로 복원하고 임시 문제 해결 설정을 일상 설정으로 남겨 두지 마세요.
- Home 상단의 연결 상태가 바뀌었고, 현재 서버가 사용하려는 항목과 일치합니다.
- Connectivity Test 결과를 확인하고 실제 웹 페이지 접속 결과와 따로 기록했습니다.
- 현재 Global Routing 방식이 명확하며, Config를 사용하는 경우 활성 구성을 확인했습니다.
- 트래픽 분기를 확인해야 한다면 시스템 VPN 표시만 보지 않고 대상 요청 기록을 확인했습니다.
위 항목을 확인하면 첫 연결의 기준을 다시 점검할 수 있습니다. 이후 규칙, DNS 또는 On Demand를 변경할 때는 한 번에 한 종류의 설정만 바꾸고 같은 점검을 반복하면 어떤 변경이 결과에 영향을 주었는지 파악할 수 있습니다.
일반적인 실패 원인: 문제가 발생한 단계부터 확인
문제가 발생하면 가장 먼저 실패한 단계부터 확인합니다. 재설치, DNS 변경, 서버 교체, 규칙 변경을 한꺼번에 하지 마세요. 현재 네트워크, 서버, Global Routing 방식과 문제가 발생한 구체적인 작업을 기록합니다. 막연히 “연결이 안 됨”이라고 설명하는 것보다 “구독 저장 후 목록이 비어 있음”이라고 설명하는 편이 원인을 좁히기 쉽습니다.
가져온 뒤 SERVER가 비어 있거나 구독이 업데이트되지 않는 경우
가져오기 단계로 돌아가 서버 구독 경로를 사용했는지 구성 파일 경로를 사용했는지 확인합니다. 링크가 잘리거나 공백이 들어갔거나 매개변수가 빠지지 않았는지 확인한 뒤 현재 네트워크에서 구독을 불러올 수 있는지 확인합니다. 가져오기 실패와 프록시 연결 실패는 서로 다른 문제입니다. 기존 서버가 계속 작동하더라도 구독 업데이트 주소에 접속할 수 있다고 단정할 수는 없습니다.
주소가 로그인 페이지를 반환하거나 만료를 알리거나 예상한 내용을 표시하지 않으면 서비스 제공업체에 링크 상태와 형식을 확인합니다. 인증 매개변수를 임의로 조합하지 마세요. 문제 해결 기록을 남길 때는 오류 안내만 기록하면 됩니다. 공개 스크린샷에는 전체 URL, QR 코드, 비밀번호 및 기타 인증 정보를 가리세요.
연결 스위치가 켜진 상태를 유지하지 못하거나 서버 테스트에 실패하는 경우
먼저 시스템 승인 및 연결 단계를 확인한 다음 서버 주소, 포트, 인증, 전송 매개변수를 대조합니다. 특히 메모 이름과 실제 주소를 구분하고 프로토콜 유형을 올바르게 선택했는지 확인합니다. 가능한 경우 다른 정상 네트워크에서도 같은 테스트를 합니다. 네트워크를 바꾼 뒤 결과가 다르다면 네트워크 조건이 영향을 주었다는 뜻일 뿐, 어느 쪽에서 장애가 발생했는지 바로 확정할 수는 없습니다.
같은 구독에서 가져온 서버 여러 개가 동시에 실패한다면 서비스 상태와 인증이 유효한지도 확인합니다. 한 항목만 실패하면 먼저 해당 항목의 매개변수나 사용 가능 상태를 점검합니다. TLS, Server Name, 경로를 무작위로 변경하지 마세요. 이 값은 서버 요구 사항과 일치해야 합니다.
테스트에는 응답이 있지만 웹 페이지가 열리지 않는 경우
먼저 특정 대상 페이지만 문제가 있는지 확인한 뒤 Proxy와 Config의 결과를 비교합니다. 일부 도메인만 실패한다면 해당 요청 기록, 실제 정책, DNS 확인 결과를 점검합니다. DNS는 도메인을 주소로 변환합니다. DNS를 바꿔도 잘못된 서버 비밀번호가 해결되지는 않으므로 모든 접속 실패를 DNS 문제로 돌려서는 안 됩니다.
비교를 위해 시스템 DNS를 일단 유지하고 기존 설정을 기록한 뒤 조정합니다. 시스템 DNS, 사용자 지정 DNS, DNS over HTTPS를 비교하려면 DNS 설정 및 확인 문제 해결 안내를 참고하세요. 이번 점검에서는 DNS 설정 하나만 변경한 뒤 같은 대상에 다시 접속해 변경 효과를 확인합니다.
Proxy는 정상이지만 Config 결과가 예상과 다른 경우
Config에서 활성 구성을 확인한 다음 대상 요청에 어떤 규칙이 적용되었는지 살펴봅니다. 규칙은 보통 순서대로 일치 여부를 확인합니다. 더 포괄적인 규칙이 구체적인 규칙보다 앞에 있으면 먼저 처리 결과를 결정할 수 있습니다. FINAL은 앞선 규칙과 일치하지 않는 경우의 최종 정책을 담당합니다. REJECT와 일치했는지도 확인하고 모든 실패를 서버 연결 끊김으로 판단하지 마세요.
첫 연결 가이드에서는 여기까지 가볍게 점검하면 됩니다. 전체 파일을 바로 다시 작성할 필요는 없습니다. General, Rule, Host, URL Rewrite의 구조와 DOMAIN-SUFFIX, IP-CIDR, PROXY, DIRECT, REJECT의 구체적인 의미는 Shadowrocket 규칙 및 구성 참고 자료에서 확인하세요. 테스트 기준을 다시 설정해야 하면 이 가이드의 Global Routing 단계로 돌아가 동일한 조건으로 다시 테스트합니다.
문제 해결을 마치면 평소 설정으로 복원사용할 Global Routing 방식으로 돌아가 선택된 서버와 활성 구성을 확인한 뒤 On Demand를 복원할지 결정합니다. 문제를 재현하는 데 필요한 오류 설명은 보관하고 임시로 변경한 매개변수는 남기지 마세요. 원인을 확인하기 전에는 계속 사용할 수 있는 기존 구성을 삭제하지 마세요.