공식 가이드 / 시작하기
Shadowrocket 구독 가져오기와 첫 연결
가져오기, 라우팅 선택, 연결, 확인 순서로 진행하세요. 먼저 전체 접속 과정을 한 번 완료한 뒤 규칙과 자동 연결 설정을 조정합니다.
먼저 전체 과정을 읽은 다음 기기에서 단계별로 진행하는 것이 좋습니다. 화면에 표시되는 용어는 영어 그대로 사용합니다. 기기에 따라 항목 배치가 다를 수 있으므로 화면 위치를 짐작하기보다 필드 이름을 확인하세요.
1단계 / 연결할 서버 준비
Add Server와 Subscribe: 기존 정보 가져오기
Shadowrocket을 열고 먼저 Home 화면으로 이동합니다. 여기에서 서버 목록을 확인하고 사용할 서버를 선택하며 연결을 제어합니다. 처음 사용하는 경우 선택할 항목이 아직 목록에 없을 수 있습니다. 이때는 연결 스위치를 켜지 마세요. 가지고 있는 정보가 구독 링크인지, 단일 서버의 개별 설정인지 확인합니다. 진입 경로는 비슷하지만 입력 방법은 다릅니다.
구독 링크가 있는 경우: Subscribe 선택
Home에서 오른쪽 위의 더하기 버튼을 눌러 Add Server로 이동한 뒤 Type을 열고 Subscribe를 선택합니다. 본인의 전체 구독 링크를 URL에 붙여 넣고 앞부분, 경로, 끝의 매개변수를 확인한 다음 저장합니다. 인증 정보도 링크의 일부입니다. 문자를 하나라도 빠뜨리거나 줄 바꿈을 포함하거나 안내 문구까지 함께 붙여 넣으면 가져오기에 실패할 수 있습니다. 메모에는 알아보기 쉬운 이름을 사용하고 전체 링크를 그대로 입력하지 마세요.
저장한 뒤 Home으로 돌아가 구독 정보가 모두 가져올 때까지 기다린 다음 해당 그룹과 서버 항목이 표시되는지 확인합니다. 구독 이름이 보인다고 해서 서버 목록까지 정상적으로 가져온 것은 아닙니다. 그룹을 펼치거나 열어 선택할 수 있는 항목이 실제로 있는지 확인하세요. 목록이 비어 있다면 구독 가져오기 문제부터 해결하고, 같은 이름의 구독을 반복해서 추가하지 마세요. 항목이 있으면 그중 하나를 선택해 다음 테스트에 사용합니다.
구독 링크에는 일반적으로 접속 정보가 포함되어 있으므로 필요한 기기와 신뢰할 수 있는 백업에만 보관하세요. 문제를 설명할 때는 오류 증상만 공유하고 전체 링크는 보내지 마세요. 구독 업데이트, 여러 구독 관리, 삭제 후 영향은 서버 관리 가이드에서 별도로 설명합니다. 이 페이지에서는 먼저 가져오기를 완료하고 자동 업데이트 설정은 변경하지 않습니다.
단일 서버 정보가 있는 경우: 프로토콜에 맞게 입력
자료에 서버 주소, 포트, 인증 정보가 있다면 Add Server에서 시작합니다. Type에서 자료에 명시된 프로토콜을 선택한 뒤 항목을 하나씩 입력하세요. 이름이 비슷하다는 이유로 프로토콜을 바꾸거나 웹 주소 전체를 서버 주소 필드에 입력하지 마세요. 주소와 포트를 각각 확인하고 비밀번호, 사용자 ID, 프로토콜에 필요한 다른 옵션은 원본 정보와 일치시킵니다.
프로토콜마다 표시되는 필드가 다릅니다. 예를 들어 일부 연결에서는 TLS, Server Name 또는 전송 설정도 확인해야 합니다. 이런 항목은 추측으로 채울 수 없습니다. 원본 자료에 필수 정보가 없다면 여러 설정을 바꿔 가며 시도하지 말고 먼저 자료를 확인하세요. 입력을 마치면 저장하고 Home으로 돌아가 항목 이름을 확인한 뒤 선택합니다. 수정이 필요하면 해당 항목의 편집 화면을 다시 열고, 같은 설정을 여러 번 추가하지 않도록 합니다.
호환되는 QR 코드가 있다면 Scan QR Code로 읽을 수 있지만, 인식이 끝난 뒤에도 생성된 서버 항목을 확인해야 합니다. 스크린샷, QR 코드, 공유 링크에는 인증 정보가 포함될 수 있으므로 공개적으로 문제를 설명할 때 사용하지 마세요. 이 단계의 완료 기준은 Home에 출처가 분명하고 설정을 확인했으며 선택까지 완료한 서버가 있는 것입니다. 구독 이름만 저장한 상태로는 충분하지 않습니다.
2단계 / 트래픽 처리 방식 선택
Global Routing: 사용할 모드 선택
서버를 선택한 뒤 Home에서 Global Routing을 엽니다. 여기서는 트래픽 처리 방식을 정하며 서버 설정을 보완하지는 않습니다. 처음 사용하는 경우 현재 선택된 모드를 확인한 다음 웹페이지를 테스트하세요. 그렇지 않으면 접속에 성공하더라도 요청이 선택한 서버를 거쳤는지 직접 연결되었는지 알기 어렵습니다. 세 가지 모드는 Config, Proxy, Direct입니다. 하단의 다른 화면 메뉴와 혼동하지 마세요.
Config: 현재 설정에 따라 처리
Config는 현재 적용된 설정의 규칙에 따라 트래픽의 경로를 결정합니다. 분할 라우팅을 사용하려면 먼저 Config에서 사용할 설정이 선택되어 있는지, 출처와 용도를 이해하고 있는지 확인한 뒤 Home으로 돌아가 Config를 선택합니다. 구독을 가져왔다고 해서 원하는 규칙까지 함께 가져온 것은 아닙니다. 구독의 서버 목록과 Config의 설정 파일은 서로 다른 역할을 합니다.
규칙에는 적용 순서가 있으며 일부 요청이 DIRECT로 설정될 수도 있습니다. 따라서 Config에서 특정 웹페이지가 열린다는 사실만으로 프록시 연결이 정상이라고 단정할 수는 없습니다. 처음 연결한 뒤에는 요청 기록에서 실제로 적용된 정책을 확인하세요. 아직 규칙 설정을 준비하지 않았다면 다음 모드로 전환해 규칙의 영향을 잠시 배제하고 서버 자체가 작동하는지 확인한 뒤 설정 문제를 점검할 수 있습니다.
Proxy: 선택한 서버 먼저 점검
처음 문제를 확인할 때 Proxy를 잠시 사용하면 선택한 서버를 통한 프록시 접속 경로를 점검하고 규칙 선택에 따른 영향을 줄일 수 있습니다. 그래도 서버 설정이 올바르고 로컬 네트워크와 서버 측 상태가 정상이어야 합니다. 모든 앱의 모든 요청이 동일한 결과를 보장하지는 않습니다. 테스트 중에는 원래 선택을 기억해 두고 확인이 끝나면 평소 사용하는 Config로 되돌리세요. 임시 점검 설정을 계속 사용하지 않도록 합니다.
Direct: 로컬 네트워크와 비교
Direct는 선택한 서버를 프록시 출구로 사용하지 않고 트래픽을 직접 연결합니다. 프록시 연결과 비교해 로컬 네트워크에서 대상에 접속할 수 있는지 확인할 때 유용합니다. Direct를 선택하고 스위치가 켜져 있다는 사실만으로 서버 연결이 성공했다고 판단하지 마세요. 모드를 선택한 뒤 Home으로 돌아가 서버가 선택되어 있는지 다시 확인하고 시스템 권한을 허용한 다음 연결합니다.
3단계 / 기기 연결 설정
연결 스위치를 켜고 시스템 권한 허용
Home으로 돌아가 현재 서버와 Global Routing이 앞 단계에서 선택한 것과 같은지 확인한 뒤 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 안내가 표시될 수 있습니다. 이는 기기가 클라이언트의 네트워크 터널 연결을 허용하도록 하는 권한 단계입니다. 안내에 표시된 앱 이름을 확인하고 방금 실행한 Shadowrocket의 요청이 맞는지 확인한 다음 시스템 안내에 따라 허용하고 기기에서 요구하는 인증을 완료합니다.
권한을 허용한 뒤 Home으로 돌아가 스위치가 계속 켜져 있는지, 연결 상태가 표시되는지 확인합니다. 시스템의 VPN 표시는 참고용으로 사용할 수 있지만 기기마다 위치가 다를 수 있습니다. 특정 위치의 아이콘을 찾으려고 반복 조작하지 마세요. 클라이언트의 연결 상태가 안정적인지, 다음 단계에서 실제 접속이 가능한지가 더 중요합니다.
이전에 권한 요청을 취소했다면 클라이언트로 돌아가 연결을 다시 시작하고 시스템 안내에 따릅니다. 예상한 안내가 계속 표시되지 않으면 기기의 Settings에서 VPN 관련 설정과 관리 제한을 확인하세요. 기기가 관리되는 경우 관리 정책을 따르고 알 수 없는 설정을 함부로 삭제하지 마세요. 시스템 권한을 허용하지 않았다면 서버 프로토콜을 바꾸기 전에 권한 문제부터 해결합니다.
스위치를 켠 직후 저절로 꺼진다면 오류 메시지가 표시되었는지 기록하고 서버가 여전히 선택되어 있는지, 필수 항목이 모두 입력되었는지, 기기에서 다른 VPN 연결을 사용 중인지 확인합니다. 이때 스위치를 빠르게 반복해서 켜고 끌 필요는 없습니다. 먼저 연결을 끄고 한 항목을 확인한 뒤 다시 시도하세요. 빠른 반복 연결은 문제 해결 기록을 혼란스럽게 만들며 어떤 변경이 결과를 바꿨는지도 알기 어렵게 합니다.
처음 확인하는 동안에는 현재 네트워크를 유지하고 On Demand를 켜지 마세요. 네트워크 조건에 따른 자동 동작이 확인을 방해할 수 있습니다. 조건에 따라 자동 연결해야 한다면 수동 연결과 접속이 모두 정상인지 확인한 뒤 설정하세요. 이 단계가 끝났다는 것은 기기가 터널 연결을 시도했다는 뜻일 뿐입니다. 실제 요청을 통해 정상적으로 사용할 수 있는지 확인해야 합니다.
4단계 / 실제 접속 확인
Connectivity Test와 웹페이지 확인
연결을 켠 상태에서 Home의 Connectivity Test를 사용해 선택한 서버의 테스트 결과를 확인합니다. 테스트는 명백하게 접속할 수 없는 항목을 빠르게 찾는 데 유용하지만 테스트 대상과 브라우저에서 접속하는 대상은 다를 수 있습니다. 결과에 수치가 표시된다는 것은 해당 테스트에서 응답을 받았다는 뜻일 뿐, 모든 웹페이지가 정상적으로 열리거나 평소 속도가 빠르다는 뜻은 아닙니다.
이어서 브라우저를 열고 내용이 갱신되었는지 확인할 수 있는 익숙한 웹페이지를 새로고침한 다음, 평소 사용하는 다른 페이지와 비교합니다. 기존 페이지는 캐시에서 표시될 수 있으므로 열려 있는 탭만 확인하지 말고 새 요청을 보내세요. 특정 대상을 확인 중이라면 설정을 바꾸기 전후에 같은 대상으로 비교해 서로 다른 웹사이트의 응답 차이를 설정 변경의 결과로 오해하지 않도록 합니다.
Shadowrocket으로 돌아가 Data에서 요청 또는 트래픽 기록을 확인하고 접속 시각에 해당하는 요청을 찾습니다. 현재 버전에서 관련 세부 정보가 제공된다면 대상, 적용된 규칙, 사용된 정책을 확인하세요. Config에서 DIRECT가 표시되어도 반드시 오류는 아닙니다. 규칙상 해당 대상이 직접 연결되어야 한다면 이는 의도된 분할 라우팅 결과입니다. 반대로 프록시를 사용할 것으로 예상했는데 DIRECT로 기록되었다면 구독을 다시 만들기보다 현재 설정과 규칙부터 확인합니다.
서버 경로를 확인하려면 원래 설정을 기록한 뒤 Proxy로 잠시 전환해 동일한 대상에 새 요청을 보낼 수 있습니다. Proxy에서는 접속되고 Config에서는 실패한다면 규칙과 설정을 먼저 확인하세요. 두 모드 모두 실패하면 서버 정보, DNS, 로컬 네트워크를 점검합니다. 테스트가 끝나면 원래 Global Routing으로 되돌리고 여러 임시 설정을 동시에 유지하지 마세요.
정상적으로 확인하려면 세 가지를 살펴보세요. Home의 연결 상태가 안정적으로 유지되고, 웹페이지에 새 요청을 보내 접속할 수 있으며, 요청 기록이 선택한 모드와 일치해야 합니다. 이는 스위치 상태만 확인하는 것보다 더 신뢰할 수 있는 기준입니다. 사용을 마치려면 Home에서 연결을 끕니다. 이후 다른 네트워크로 전환했다면 간단한 확인을 다시 진행하고 이전 네트워크에서 성공한 결과를 새 환경에 그대로 적용하지 마세요.
5단계 / 증상별로 범위 좁히기
자주 발생하는 문제: 한 번에 한 항목씩 변경
문제가 발생하면 먼저 어느 단계에서 멈췄는지 확인합니다. 구독을 가져오지 못했는지, 서버 테스트에 실패했는지, 연결이 유지되지 않는지, 웹페이지에 접속할 수 없는지에 따라 점검할 위치가 다릅니다. 현재 네트워크, 선택한 서버, Global Routing, 오류 메시지를 기록한 뒤 아래 순서대로 확인하세요. 앱 재설치를 첫 번째 해결 방법으로 삼지 마세요. 사용할 수 없는 서버 정보를 해결하지 못하며 기존 설정이 사라질 수도 있습니다.
구독은 저장됐지만 목록이 비어 있음
구독 편집 화면으로 돌아가 URL이 완전한지, 특히 끝부분의 인증 정보가 잘리지 않았는지 확인합니다. 구독이 아직 유효한지, 현재 네트워크에서 구독 정보를 가져올 수 있는지도 점검하세요. 구독 접속과 서버 연결은 서로 다른 단계입니다. 기존 서버 항목으로 테스트에 성공하더라도 구독 업데이트까지 정상이라는 뜻은 아닙니다. 먼저 업데이트 결과를 확인하고 링크를 수정할지 판단하세요. 전체 구독 링크를 공개 게시판에 붙여 넣어 확인을 요청하지 마세요.
Connectivity Test 실패 또는 연결이 바로 끊김
먼저 로컬 네트워크를 정상적으로 사용할 수 있는지 확인한 다음, 선택한 서버의 주소, 포트, 프로토콜, 인증 항목을 점검합니다. TLS나 전송 옵션이 있다면 원본 정보와 하나씩 대조하고 복사 과정에서 공백이 붙지 않았는지 특히 주의하세요. 다른 서버가 있다면 Global Routing은 그대로 둔 채 서버만 바꿔 비교할 수 있습니다. 한 항목에서만 실패한다면 해당 항목을 먼저 점검하고, 모든 항목에서 실패한다면 공통 네트워크 환경과 시스템 권한을 확인합니다.
테스트 결과는 있지만 웹페이지가 열리지 않음
이때는 DNS 조회 문제와 실제 연결 문제를 구분해야 합니다. 기록에 조회 실패가 나타나면 현재 설정에서 접속할 수 없는 DNS를 지정했는지, 현재 네트워크 환경에 맞지 않는 설정이 있는지 확인합니다. 시험 삼아 DNS 주소를 여러 개 한꺼번에 추가하거나 설정 전체를 바로 덮어쓰지 마세요. 같은 웹페이지가 Proxy에서는 열리고 Config에서는 열리지 않는다면 해당 대상에 적용된 규칙, 정책, 관련 DNS 설정을 추가로 확인합니다.
네트워크를 바꾼 뒤에만 문제가 발생함
Wi-Fi에서 셀룰러 네트워크로 전환하면 로컬 네트워크 경로와 이용 조건이 달라질 수 있습니다. 서버와 모드는 그대로 유지하고 다시 연결한 뒤 같은 대상을 테스트해 두 네트워크의 결과를 기록하세요. 원래 네트워크로 돌아왔을 때 정상적으로 작동한다면 이 비교는 프로토콜을 계속 바꾸는 것보다 유용합니다. On Demand를 설정했다면 네트워크 전환 중 자동 연결 또는 연결 해제가 실행되었는지도 확인해 자동 동작을 수동 스위치의 오류로 오해하지 않도록 합니다.
결과를 기록한 뒤 계속 점검
설정을 바꿀 때마다 같은 테스트를 반복하세요. 개선되지 않으면 원래 값으로 되돌린 뒤 다음 항목을 확인합니다. 추가 분석이 필요하다면 오류 메시지, 발생 단계, 이미 확인한 조건을 정리하되 구독 링크, 비밀번호, 인증 정보는 가리세요. 자주 발생하는 증상은 문제 해결에서 확인할 수 있습니다. 구독 업데이트, 서버 관리, 백업은 서버 관리 가이드를 참고하세요. 이 페이지의 과정을 마친 뒤 규칙, 자동 업데이트, On Demand를 하나씩 추가하면 이후 문제를 더 쉽게 찾아낼 수 있습니다.