Shadowrocket 시작 가이드
구독 가져오기, 모드 선택, 첫 연결까지. 다섯 단계를 따라 사용 가능한 경로를 먼저 확인한 다음 규칙을 조정합니다.
이 페이지에서는 처음 사용할 때 필요한 작업을 설명합니다. 구성 항목과 규칙 적용 순서는 구성 항목 참고를 확인하세요.
서버 및 구독 추가
먼저 기존 정보를 앱에 저장합니다. 가져오기에 성공했다는 것은 항목이 추가되었다는 뜻일 뿐, 연결 가능 여부는 이후에 확인해야 합니다.
Home에서 Add Server 열기
Shadowrocket을 열고 Home 화면으로 이동합니다. SERVER 그룹 아래의 Add Server를 찾아 누르면 추가 화면이 열립니다. 먼저 준비한 자료가 구독 링크인지, 단일 서버 공유 정보인지, 직접 입력해야 하는 연결 매개변수인지 확인합니다. 세 가지 자료의 용도는 서로 다릅니다. 구독 주소를 서버의 Host 항목에 입력하거나 단일 공유 정보를 구성 파일로 가져오지 마세요.
정보가 본인이 이용하는 서비스 제공업체에서 온 것이라면, 먼저 함께 제공된 설명을 읽고 프로토콜, 유효 상태 및 추가 매개변수가 필요한지 확인합니다. 구독 링크에는 일반적으로 접근 인증 정보가 포함되므로 전체를 복사하고, 메신저에서 공백이나 줄바꿈이 추가되지 않았는지 확인합니다. 링크를 공개 페이지에 제출하거나 형식을 확인하기 위해 출처를 알 수 없는 웹사이트에 붙여넣지 마세요.
기존 구독: Subscribe 사용
Add Server에서 Type을 누르고 Subscribe를 선택한 다음, 본인의 전체 구독 링크를 해당 URL 항목에 입력합니다. 메모 항목이 있다면 알아보기 쉬운 이름을 적을 수 있습니다. 링크 끝부분이 누락되지 않았는지 확인하고 저장한 뒤 앱이 내용을 가져올 때까지 기다립니다. 완료되면 Home으로 돌아가 구독 그룹과 그 안의 서버 항목이 나타나는지 확인합니다. 그룹 이름만 있고 항목이 없다면 연결 스위치를 계속 켜고 끄지 말고 먼저 구독이 정상적으로 해석되었는지 확인하세요.
구독 업데이트는 원래 주소에서 서버 목록을 다시 가져오는 기능이며 서비스 유효 기간을 연장하지 않습니다. 처음 가져오기에 실패하면 먼저 기기에서 인터넷에 접속할 수 있는지 확인한 다음 링크가 만료되었거나 복사 중 잘리지 않았는지 살펴봅니다. 동일한 구독을 여러 개 만들면 나중에 잘못된 그룹을 선택할 수 있으므로 중복 추가하지 마세요. 업데이트 방법과 오류 원인은 구독 업데이트 안내에서 확인할 수 있습니다.
직접 입력하거나 기존 QR 코드 스캔
서버 매개변수를 받았다면 Type에서 정보에 맞는 프로토콜을 선택한 뒤 Host, Port와 해당 프로토콜에 필요한 Password, Method 또는 기타 항목을 입력합니다. Type에 따라 표시되는 항목은 다릅니다. 스크린샷에 나온 항목이 모든 프로토콜에 공통으로 필요한 목록은 아닙니다. 서버 이름만 보고 프로토콜을 추측하거나 포트, 암호화 방식, 전송 매개변수를 임의로 변경하지 마세요.
기존 QR 코드가 있다면 Scan QR Code를 사용해 읽고 시스템 안내에 따라 카메라 접근을 허용합니다. 정보를 읽은 다음 인식된 유형과 주소를 확인하고 저장합니다. Import from Cloud JSON은 별도의 가져오기 기능입니다. 자료에서 해당 형식을 명시한 경우에만 선택하고, 일반 구독 주소를 모든 항목에 차례로 입력해 보지 마세요. 저장한 뒤 Home으로 돌아와 SERVER에서 사용할 항목을 선택하고 다음 단계에서 모드를 선택합니다.
Global Routing 선택
서버는 프록시 연결에 사용할 항목을 정하고, Global Routing은 요청 처리 방식을 정합니다. 두 가지를 각각 확인해야 합니다.
자주 쓰는 세 가지 모드 구분
Home으로 돌아와 Global Routing을 누르고 Config, Proxy, Direct 세 가지 모드를 확인합니다. Config는 현재 적용된 구성의 규칙에 따라 트래픽을 분기합니다. Proxy는 요청이 프록시 경로를 사용하도록 하며, 처음 선택한 서버를 확인할 때 유용합니다. Direct는 직접 연결하는 모드이므로 프록시 출구가 작동하는지 확인하는 데 사용할 수 없습니다. 모드를 바꿔도 잘못된 서버 암호가 수정되거나 구성 파일이 자동으로 완성되지는 않습니다.
처음 설정할 때 용도가 분명한 구성 파일이 있다면 Config를 선택하고 현재 선택된 구성을 확인합니다. 서버를 사용할 수 있는지만 확인하려면 Proxy를 잠시 선택해 접속 결과를 비교한 다음 평소 필요한 모드로 되돌립니다. 현재 모드를 모르는 상태에서 서버와 규칙을 동시에 변경하지 마세요. 접속이 복구되더라도 어떤 변경이 영향을 주었는지 판단하기 어렵습니다.
Config에서 현재 구성 확인
Config로 이동해 사용할 구성 파일을 찾고 현재 선택된 구성이 맞는지 확인한 다음 그 안의 Rule을 살펴봅니다. 공식 스크린샷에는 구성 편집 화면의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 구역이 표시됩니다. 각 구역의 용도는 서로 다르므로 첫 연결을 위해 모두 변경할 필요는 없으며, 이 가이드를 완료하기 위해 HTTPS Decryption을 켤 필요도 없습니다. 구성 파일과 서버 구독은 서로 다른 자료이며, 구독을 가져왔다고 규칙까지 설정된 것은 아닙니다.
아래 Rule 예시는 문법을 이해하기 위한 것입니다. example.com과 그 하위 도메인에 접속할 때 PROXY를 사용하고, 나머지 요청은 FINAL에 지정된 DIRECT로 처리합니다. 완성된 구성 파일이 아니며 모든 네트워크 환경에 권장되는 기본 규칙도 아닙니다. 규칙은 일반적으로 목록 순서대로 확인하며 먼저 일치한 규칙이 결과에 영향을 줍니다. FINAL은 마지막 기본 규칙으로 두어야 합니다. 규칙을 추가하려면 Add Rule을 사용할 수 있지만, 먼저 선택한 유형의 일치 범위를 이해하세요.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT정상적으로 사용할 수 있는 기존 구성을 먼저 보관한 다음 한 번에 한 항목씩 변경합니다. DOMAIN-SUFFIX, IP-CIDR 또는 정책 이름의 의미가 불확실하다면 먼저 규칙 및 구성 참고를 읽어보세요. 이 페이지에서는 우선 연결과 확인을 진행하며, 지금 전체 트래픽 분기 규칙을 작성할 필요는 없습니다.
스위치를 켜고 연결
항목과 모드를 선택한 다음 시스템 권한을 처리합니다. 연결 스위치와 실제 접속 결과는 각각 확인해야 합니다.
SERVER와 상단 스위치 확인
Home으로 돌아와 SERVER에서 현재 선택된 항목이 방금 추가한 구독 또는 서버에 속하는지 확인합니다. 구독에 여러 항목이 있으면 사용 가능한 것으로 확인된 항목 하나를 먼저 선택하고 연결 도중 계속 전환하지 마세요. Global Routing도 확인해 이전 단계에서 선택한 모드가 유지되어 있는지 살펴봅니다. 스크린샷의 상단에 표시된 Not Connected는 아직 연결되지 않은 상태의 예시이며 가져오기 실패 안내가 아닙니다.
상단의 연결 스위치를 누릅니다. 처음 연결할 때 시스템에서 VPN 구성 추가 권한을 요청할 수 있습니다. 안내를 읽고 허용한 다음 시스템 요구에 따라 기기 암호 또는 생체 인증으로 확인합니다. 이 권한은 Shadowrocket이 시스템 연결 구성을 생성하도록 허용하는 것이며 구독을 다시 가져오거나 서버 서비스를 구매하는 과정이 아닙니다. 권한을 허용한 뒤 Home으로 돌아가 상태가 바뀔 때까지 기다린 다음 다음 단계에서 테스트합니다.
연결되지 않으면 먼저 권한 확인
방금 권한 요청을 거부했다면 앱으로 돌아와 다시 연결을 시도하고, 실제로 표시되는 시스템 안내에 따라 권한을 부여합니다. 스위치가 바로 꺼진 상태로 돌아오면 시스템 설정에 VPN 구성이 남아 있는지, 실행 중인 다른 VPN 연결과 충돌하는지 먼저 확인합니다. 시스템 네트워크 설정을 모두 반복해서 삭제하지 마세요. 먼저 구체적인 안내를 기록한 다음 자주 묻는 질문에서 해결 방법을 확인합니다.
연결 상태가 바뀌었다는 것은 시스템 연결 절차가 시작되었다는 뜻일 뿐, 대상 서버, 도메인 해석, 트래픽 분기 규칙이 모두 정상이라는 뜻은 아닙니다. 시스템 상태 막대의 VPN 표시만으로 웹페이지 접속 테스트를 대신할 수 없습니다. 서버, 모드, 구성을 그대로 유지하고 아래 확인 단계로 이동하세요. 그래야 문제가 생겼을 때 비교할 조건을 일정하게 유지할 수 있습니다.
연결 및 규칙 확인
테스트 결과, 실제 접속, 규칙 일치 여부를 각각 확인해 단일 상태 표시를 전체 결론으로 오해하지 않도록 합니다.
먼저 테스트한 뒤 실제 웹페이지 접속
Home에서 Connectivity Test를 누르고 테스트가 끝날 때까지 기다립니다. 테스트 방식에 따라 결과가 달라질 수 있습니다. 특정 테스트에 응답이 없다고 해서 모든 앱에 접속할 수 없는 것은 아니며, 테스트 결과가 표시되어도 모든 도메인에 예상한 규칙이 적용된다는 뜻은 아닙니다. 먼저 결과를 기록하고 이를 근거로 서버를 한꺼번에 삭제하지 마세요. 테스트 방식을 확인하려면 Settings에서 Test Method를 찾을 수 있습니다. 첫 확인 단계에서는 가능한 한 설정을 변경하지 마세요.
그다음 브라우저를 열어 평소 정상 접속되는 것으로 확인된 웹페이지를 먼저 방문해 기기에서 기본 네트워크 접속이 되는지 확인합니다. 이어 현재 구성에서 프록시를 사용해야 하는 웹페이지를 방문하고, 이전 탭의 내용만 확인하지 말고 페이지가 실제로 로드될 때까지 기다립니다. 필요하다면 새로고침하거나 새 탭을 열어 캐시로 인한 혼란을 줄입니다. Direct를 사용 중이라면 해당 페이지가 열려도 프록시 경로가 작동한다는 뜻은 아니므로 현재 모드와 함께 판단해야 합니다.
한 가지 항목만 변경해 비교
Proxy에서는 접속되지만 Config에서는 되지 않는다면 같은 서버를 유지한 채 현재 구성의 규칙, 해석 설정, 최종 정책을 확인합니다. 두 모드 모두 접속되지 않으면 규칙을 계속 추가하기보다 서버 정보와 사용 가능 여부를 먼저 확인합니다. 앱의 연결 기록이나 Data에서 대상 요청을 확인할 수 있다면 대상 도메인, 일치한 규칙, 정책이 예상과 맞는지 살펴봅니다. 기록이 보이지 않아도 요청이 프록시를 거쳤다고 추측하지 마세요.
확인이 완료되려면 선택한 항목이 올바르고 연결 상태가 안정적이며 실제 페이지가 로드되고, 분기가 필요한 요청에 예상한 정책이 적용되어야 합니다. 이 항목들을 확인한 다음 일상적으로 사용하는 Config로 되돌려 한 번 더 테스트합니다. 이후 On Demand를 사용하려면 적용할 네트워크 조건을 별도로 설정하세요. 조건에 따라 연결을 시작하는 기능이지 서버를 사용할 수 없을 때 문제를 해결하는 스위치는 아닙니다.
일반적인 문제 해결
한 번에 조건 하나만 변경합니다. 먼저 정보와 서버를 확인한 다음 권한, 모드, DNS, 규칙을 점검합니다.
구독에 내용이 없거나 서버를 사용할 수 없음
가져온 뒤 서버가 나타나지 않으면 구독 편집 화면으로 돌아가 링크가 온전한지, 자료 형식이 맞는지, 업데이트 오류 안내가 있는지 확인합니다. 구독 만료, 서버 목록이 아닌 내용의 반환, 기기에서 구독 주소에 접속할 수 없는 상황 등으로 가져오기에 실패할 수 있습니다. 목록은 정상이지만 특정 항목 연결에 실패한다면 Type, Host, Port 및 인증 정보를 확인합니다. 필요한 경우 본인이 이용하는 서비스 제공업체에 해당 항목의 유효 상태를 문의합니다. 목록 업데이트와 서버 연결은 별개의 작업이므로 서로 대신할 수 없습니다.
스위치가 켜지지 않거나 연결 후 접속 불가
스위치가 켜지지 않으면 시스템 VPN 권한과 앱 안내를 먼저 확인합니다. 스위치는 켜져 있지만 웹페이지에 접속할 수 없다면 현재 서버는 그대로 두고 Global Routing이 예상과 다른 Direct로 설정되어 있지 않은지 확인한 다음 Proxy와 Config를 각각 비교합니다. Shadowrocket을 연결 해제한 상태에서도 기기에서 일반 웹페이지에 접속할 수 없다면 앱 매개변수를 계속 수정하기보다 Wi-Fi, 셀룰러 네트워크 또는 시스템 네트워크 문제를 먼저 해결합니다.
일부 도메인이나 앱만 실패
일부 대상에서만 실패한다면 구체적인 도메인, 실패한 네트워크 환경, Config에서만 문제가 발생하는지 기록합니다. 현재 구성의 DNS와 Rule을 확인하되 웹페이지가 열리지 않는다는 이유만으로 모든 DNS 항목을 같은 주소로 바꾸지 마세요. 이름 해석과 연결 단계 중 어느 쪽에서든 실패할 수 있으므로 진단 정보를 함께 확인해야 합니다. 규칙을 추가한 뒤 문제가 생겼다면 해당 변경을 먼저 되돌린 다음 같은 대상으로 다시 테스트하고, 일치하지 않은 요청을 FINAL이 예상한 정책으로 보내는지 확인합니다.
Settings에서 Diagnostics와 Proxy, TCP, UDP 관련 설정 항목을 찾을 수 있습니다. 처음 문제를 해결할 때는 먼저 기존 진단 정보를 확인하고 여러 고급 옵션을 동시에 변경하지 마세요. 프로토콜이나 대상 앱마다 전송 방식에 대한 요구가 다르므로 임의로 전환하면 새로운 변수가 생길 수 있습니다. On Demand는 수동 연결 확인을 완료한 뒤 설정하는 것이 좋습니다. 자동 재연결이 테스트 중 관찰에 영향을 줄 수 있습니다.
필요한 정보는 기록하고 인증 정보는 가리기
추가 확인이 필요하다면 기기 네트워크 유형, 현재 Global Routing, 실패한 대상, 오류 안내를 기록하고 문제가 가져오기, 권한 허용, 실제 접속 중 어느 단계에서 발생했는지 적습니다. 스크린샷이나 로그를 공유하기 전에 구독 링크, 서버 인증 항목, 개인정보를 가립니다. 단계별 점검 방법은 스위치는 켜졌지만 인터넷에 연결되지 않을 때에서 확인할 수 있습니다. 계정, 권한, 가져오기 관련 문제는 자주 묻는 질문을 확인하세요. 이 가이드에서 모든 고급 구성을 수정할 필요는 없습니다.
