Shadowrocket 사용법: 가져오기 및 연결
‘정보 추가 → 모드 선택 → 연결 → 확인 → 문제 해결’ 순서로 진행합니다. 먼저 재현 가능한 수동 연결을 한 번 완료한 다음 규칙과 자동 연결 조건을 조정하세요.
Add Server: 추가 및 가져오기
먼저 정보의 유형을 구분하세요. 개별 서버, 서버 구독, Config 설정 파일은 서로 다른 항목입니다.
Shadowrocket의 Home을 열어 SERVER 그룹과 Add Server 항목을 찾습니다. 입력하기 전에 보유한 정보를 확인하세요. 주소, 포트 및 인증 정보가 있으면 직접 추가하고, 서버 공유 링크나 QR 코드가 있으면 단일 항목으로 가져옵니다. 서버 목록을 제공하는 링크는 서버 구독에 해당합니다. 규칙, DNS 또는 정책 설정이 포함된 설정 파일은 Config에서 관리합니다. 모두 URL이라고 해서 같은 항목에 입력할 수 있는 것은 아닙니다.
Add Server에 직접 입력
Add Server를 누르고Type을 열어 보유한 정보에 맞는 프로토콜을 선택합니다. 선택한 프로토콜에 따라 입력란이 달라집니다. 스크린샷의Password와Method는 해당 유형의 입력 항목 예시이며, 모든 프로토콜이 같은 양식을 사용하는 것은 아닙니다.- 서버 주소는
Host에, 포트는Port에 입력합니다. 각 입력란이 요구하는 값만 입력하세요. 전체 공유 링크를 Host에 넣거나 주소 끝에 포트를 덧붙인 뒤 Port에도 중복 입력하지 마세요. - 보유한 정보에 따라 인증 정보와 프로토콜 관련 옵션을 입력합니다. 대소문자, 앞뒤 공백, 복사 과정에서 줄바꿈이 섞이지 않았는지 확인하세요. TLS, 전송 방식 또는 서버 이름은 원래 제공된 매개변수대로 설정하고 이름만 보고 추측하지 마세요.
- 화면의 저장 기능을 사용해
Home으로 돌아와SERVER에 해당 항목이 표시되는지 확인합니다. 메모는 서버를 구별하는 용도이며, 메모가 같더라도 주소나 인증 정보까지 같다는 뜻은 아닙니다.
기존 서버의 QR 코드가 있다면 Add Server 화면에서 Scan QR Code를 사용할 수 있습니다. 스캔한 뒤 인식된 Type, Host 및 Port를 확인하고 저장하세요. Import from Cloud JSON은 해당 항목에서 요구하는 JSON을 가져오는 기능이지, 아무 구독 링크나 붙여 넣는 범용 입력란이 아닙니다. 가져오기에 성공했다는 것은 앱이 정보를 인식했다는 뜻일 뿐, 원격 서버에 연결되었다는 뜻은 아닙니다.
기존 구독: 서버 목록과 설정 파일 구분
서버 구독을 보유한 경우 Add Server에서 정보 유형에 맞는 Subscribe를 선택하고 전체 구독 주소를 URL에 입력한 뒤 저장합니다. 목록을 가져올 때까지 기다리세요. 링크의 경로와 쿼리 매개변수를 삭제하거나 수정하지 마세요. 인증에 사용되는 정보일 수 있습니다. Home으로 돌아가 구독 그룹에 서버가 표시되는지 확인합니다. 그룹 이름만 있고 항목이 없다면 연결 단계로 넘어가지 말고 먼저 목록을 가져오지 못한 문제를 해결하세요.
Config 파일 구독을 보유한 경우 Config로 이동해 Subscribe 항목에서 해당 설정 주소를 추가합니다. 가져온 뒤 확인하고 사용할 파일을 선택하세요. Config의 Subscribe와 서버 목록 구독은 역할이 다릅니다. 전자는 설정 내용을 관리하고, 후자는 연결 대상을 관리합니다. 링크 이름에 ‘구독’이 들어 있다는 이유만으로 두 항목을 바꿔 사용하면 안 됩니다. 여러 구독을 정리하거나 공유 형식을 확인하고 업데이트를 설정하려면 구독 및 서버 관리 매뉴얼을 읽어보세요.
이 단계가 끝나면 Home에서 사용할 서버가 무엇인지, 규칙 모드에 사용할 설정 파일이 있는지 명확히 확인할 수 있어야 합니다. 다음으로 Global Routing을 선택하고, 바로 연결 스위치를 반복해서 켰다 끄지는 마세요.
Global Routing: 세 가지 모드
먼저 트래픽을 어떻게 처리할지 정한 다음 설정 파일을 확인하세요. 모드 이름은 연결 품질을 나타내는 지표가 아닙니다.
Home으로 돌아와 Global Routing을 누릅니다. 이 안내에서는 세 가지 모드를 설정(Config), 프록시(Proxy), 직접 연결(Direct)로 표기하며, 괄호 안은 앱에 표시되는 영어 옵션입니다. 선택한 다음 Home으로 돌아와 Global Routing 항목에 실제로 표시된 값을 확인하세요. 이전 조작을 기억하는 것만으로 현재 모드를 판단하지 마세요.
| 모드 | 처리 기준 및 사용 목적 |
|---|---|
| 설정(Config) | 현재 활성화된 설정 파일과 규칙에 따라 정책을 결정하며, 트래픽 분기 결과를 확인할 때 적합합니다. |
| 프록시(Proxy) | 프록시 모드로 트래픽을 처리하며, 규칙의 영향을 분리해 선택한 서버를 먼저 확인할 때 적합합니다. |
| 직접 연결(Direct) | 트래픽을 직접 연결로 처리합니다. 로컬 네트워크와 비교할 때 사용할 수 있지만 프록시 서버의 사용 가능 여부를 확인하는 용도는 아닙니다. |
처음 서버를 추가했고 사용할 규칙 설정이 아직 없다면 먼저 프록시(Proxy)로 연결 대상을 확인할 수 있습니다. 확인이 끝나면 설정(Config)으로 전환해 실제 트래픽 분기를 점검하세요. Proxy가 모든 문제를 해결하는 것은 아닙니다. 서버 주소, 인증 정보 또는 로컬 네트워크에 문제가 있다면 모드를 바꿔도 누락된 조건이 해결되지 않습니다.
Config 모드에서 확인할 항목
설정(Config)을 선택하기 전에 Config로 이동해 현재 선택된 파일이 이번에 사용하려는 파일인지 확인합니다. 파일 내용을 볼 때는 스크린샷처럼 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 항목을 기준으로 구분할 수 있습니다. 처음 연결할 때는 기존 설정만 확인하면 됩니다. 튜토리얼을 완료하기 위해 각 기능을 하나씩 활성화할 필요는 없습니다. 특히 HTTPS Decryption은 일반 연결에 필요한 단계가 아닙니다.
Rule에서는 접속 대상이 어떤 규칙과 일치하는지, 해당 규칙에 어떤 정책이 지정되었는지, 마지막으로 어떤 기본 처리가 적용되는지 확인합니다. 규칙은 일반적으로 순서대로 적용되며, 앞의 규칙에 일치하면 같은 판단에서 뒤의 규칙은 적용되지 않을 수 있습니다. 아래 내용은 문법을 확인하기 위한 예시일 뿐이며, 기존 설정 전체를 교체하라는 뜻은 아닙니다.
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
이 예시는 각각 도메인 접미사 일치, 로컬 네트워크 주소 대역 일치, 최종 정책을 나타냅니다. PROXY와 DIRECT는 정책 용어이지 서버 주소가 아닙니다. Add Rule로 항목을 추가하기 전에 삽입 위치와 기존 규칙의 관계를 확인하세요. 순서를 확인하지 않고 규칙 하나만 덧붙이면 예상한 결과가 나오지 않을 수 있습니다. 규칙 키워드와 DNS에 대한 자세한 설명은 용어 빠른 참조를 확인하세요. 이번에는 확인 가능한 최소한의 변경만 적용합니다.
이제 “선택한 서버 + 현재 Global Routing + 현재 Config 파일”이라는 조합을 명확히 확인할 수 있어야 합니다. 연결에 실패하면 이 세 가지 정보를 기록해 두어야 이후에 어느 단계에서 문제가 발생했는지 구분할 수 있습니다.
Home: 연결 스위치 및 시스템 권한
먼저 서버를 선택하고 상단 스위치를 켭니다. 시스템 권한 승인과 원격 서비스 사용 가능 여부는 각각 확인해야 합니다.
Home으로 돌아와 SERVER 그룹에서 사용할 서버를 선택하고 선택 표시를 확인합니다. 한 그룹에 서버가 여러 개 있으면 목록을 보는 것만으로 특정 서버가 선택된 것은 아닙니다. 구독 그룹 이름을 현재 연결 대상으로 착각하지 마세요. 서버를 확인한 뒤 Global Routing이 앞 단계에서 선택한 모드인지 다시 확인합니다.
- Home 상단에서 연결 스위치를 찾습니다. 스크린샷의
Not Connected는 촬영 당시 연결이 설정되지 않았다는 뜻이며, 정보를 가져오지 못했다는 오류가 아닙니다. - 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 메시지가 표시될 수 있습니다. 요청을 시작한 앱이 Shadowrocket인지 확인한 뒤 시스템 안내에 따라 허용하고 기기에서 요구하는 인증을 완료하세요.
- Shadowrocket으로 돌아와 상태가 표시될 때까지 기다립니다. 권한 요청을 취소했다면 서버 비밀번호나 규칙을 바로 수정하지 말고 연결을 다시 시작해 권한 승인을 완료하세요.
- 연결 상태가 설정되면 서버와 모드를 그대로 유지하고 다음 단계에서 실제 접속을 확인합니다. 확인하기 전에 구독 업데이트, 서버 변경, DNS 수정을 동시에 하지 마세요.
시스템 VPN 구성은 기기가 앱 설정에 따라 해당 네트워크 트래픽을 처리하도록 합니다. 원격 서버를 생성하는 기능은 아닙니다. 권한을 승인해도 구독 유효 기간, 서버 인증 및 원격 네트워크가 모두 정상이라는 뜻은 아닙니다. 반대로 시스템 권한 승인이 끝나지 않았다면 서버 매개변수를 계속 테스트해도 권한 승인을 대신할 수 없습니다.
스위치를 켠 직후 다시 꺼지면 명확한 오류가 표시되는지 먼저 확인하고, 기기에서 다른 VPN 구성이 연결을 사용 중인지 살펴봅니다. 전환해야 한다면 기존 연결을 먼저 중지한 뒤 Shadowrocket을 다시 시도하세요. 출처와 용도를 모르는 기기 관리 설정은 삭제하지 마세요. 스위치가 켜져 있는데도 웹페이지를 열 수 없다면 현재 상태를 유지하고 아래의 확인 및 문제 해결 순서에 따라 점검하세요.
첫 수동 연결이 성공했는지 확인하기 전에는 On Demand를 설정하지 마세요. 자동 연결 조건을 추가하면 재연결을 유발한 원인과 서버의 사용 가능 여부를 구분하기 어려워집니다. 먼저 직접 연결을 켜고, 확인한 다음 직접 끄는 과정을 한 번 완료하세요. 그 후 자동화를 고려합니다.
Connectivity Test: 작동 여부 확인
테스트 결과, 실제 접속 여부 및 규칙 일치는 서로 다른 단계의 근거입니다. 스위치만 확인해서는 안 됩니다.
연결 스위치를 켠 뒤 Home에서 Connectivity Test를 실행하고, 현재 테스트 방식에서 선택한 서버의 결과를 확인합니다. 결과는 연결 상태를 판단하는 데 도움이 되지만 특정 수치만으로 모든 웹사이트에 접속할 수 있다고 단정할 수는 없습니다. 테스트 실패가 곧 비밀번호 오류를 뜻하는 것도 아닙니다. 테스트 방식과 대상에 따라 결과가 달라질 수 있으므로 이후 문제 해결에서도 같은 조건을 유지하세요.
- 실제 요청을 확인합니다. 브라우저에서 실제로 사용하려는 페이지를 열고 새로고침한 뒤 페이지 내용이 계속 표시되는지 확인합니다. 이전에 열어둔 내용만 보이는 경우 캐시일 수 있으므로 새 연결이 성공했다는 충분한 근거가 되지 않습니다.
- 현재 모드와 비교합니다. 현재 Proxy라면 선택한 서버가 요청을 처리할 수 있는지 먼저 확인합니다. Config라면 대상이 예상한 규칙과 일치하는지도 확인해야 합니다. Direct에서 페이지에 접속할 수 있어도 해당 요청이 프록시를 사용했다는 뜻은 아닙니다.
- 서로 다른 정책을 확인합니다. 본인이 알고 있고 접속 권한이 있는 대상을 사용해 PROXY와 DIRECT를 사용해야 하는 요청을 각각 확인합니다. 앱에서 제공하는 연결 기록을 통해 대상, 일치한 규칙 및 정책을 비교하세요. 기록의 보존 여부와 표시 범위는 현재 앱 화면을 기준으로 확인합니다.
- 같은 대상을 다시 테스트합니다. 설정을 조정해야 한다면 변수 하나만 변경한 뒤 같은 페이지를 다시 엽니다. 변경 전후의 모드, 서버 및 현상을 기록해 대상 웹사이트의 차이를 설정 변경의 결과로 오인하지 않도록 하세요.
Proxy에서는 접속되지만 Config에서는 안 된다면 구독을 바로 다시 만들기보다 현재 설정 파일, 규칙 순서 및 DNS를 먼저 확인하세요. 두 모드 모두 접속되지 않으면 서버와 로컬 네트워크부터 점검합니다. 특정 사이트 하나만 실패한다면 전체 설정을 초기화하지 말고 해당 대상에 적용되는 규칙과 서비스 상태를 확인하세요.
Settings: 자주 발생하는 문제
사전 조건부터 규칙까지 단계별로 점검하세요. 한 번에 한 항목만 조정하고 다시 테스트한 뒤 다음 항목을 결정합니다.
목록이 표시되지 않음: 먼저 가져오기 확인
구독을 저장했는데 서버 항목이 표시되지 않으면 링크가 완전한지, 해당하는 Subscribe 항목을 사용했는지, 로컬 네트워크에서 정보를 가져올 수 있는지 먼저 확인합니다. 학교, 회사 또는 공용 Wi-Fi에서는 먼저 네트워크 로그인이 필요할 수 있습니다. 필요한 경우 본인의 Wi-Fi와 셀룰러 네트워크를 비교해 보세요. 구독 주소에 인증 정보가 포함되어 있다면 복사 과정에서 잘리지 않았는지 확인하되, 전체 링크를 공개 페이지에 게시하지 마세요. 서비스 상태를 확인해야 한다면 기존 서비스의 관리 경로를 이용하고, 출처를 모르는 주소로 바꾸지 마세요.
항목은 있지만 연결되지 않음: 서버 매개변수 확인
서버 편집 화면을 다시 열고 원본 정보와 Type, Host, Port 및 인증 정보를 하나씩 대조합니다. 먼저 프로토콜을 확인한 다음 해당 프로토콜에 필요한 추가 설정을 확인하세요. Password 하나만 바꿔서는 Type을 잘못 선택한 문제를 해결할 수 없습니다. 구독으로 생성된 항목은 업데이트 때 다시 작성될 수 있으므로 계속 수동으로 수정하기 전에 구독 데이터가 올바른지 확인하세요. 삭제하거나 다시 가져오기 전에 필요한 백업을 보관합니다. 자세한 정리 방법은 서버 관리 매뉴얼을 참조하세요.
연결되었지만 접속되지 않음: 모드, 규칙 및 DNS 확인
먼저 Home에서 현재 선택된 서버를 확인한 다음 Global Routing을 점검합니다. Config에서만 실패한다면 실제 활성화된 파일, Rule의 일치 순서 및 FINAL 처리를 확인하세요. 파일 이름이 비슷하다고 내용까지 같다고 판단하지 마세요. 도메인 접속에 문제가 있다면 설정의 DNS와 로컬 네트워크가 DNS 요청에 미치는 영향을 확인합니다. DNS, 서버 및 규칙 파일을 한꺼번에 바꾸면 결과를 비교하기 어렵습니다.
Settings로 이동해 Test Method를 확인하고 테스트 전후에 같은 방식을 사용합니다. 추가로 원인을 파악해야 한다면 Diagnostics에서 확인할 수 있는 진단 정보를 살펴보고 오류가 발생한 동작과 대상을 기록하세요. 진단 내용에 서버 주소나 연결 정보가 포함될 수 있으므로 공유하기 전에 구독 인증 매개변수, 비밀번호 및 기타 개인정보를 삭제합니다. 웹페이지 문제 하나를 해결하려고 Proxy, TCP, UDP의 모든 옵션을 연이어 변경하지 마세요.
자동 연결 및 속도 문제: 마지막으로 확인
수동 연결이 확인된 후에만 Settings에서 On Demand를 설정하고 실제 네트워크 조건에 맞는 자동 연결 동작을 구성하세요. 변경한 뒤 해당 네트워크에 들어갈 때와 나올 때의 동작을 각각 확인합니다. 자동 연결이 실행되어도 원격 연결이 성공한다는 보장은 없습니다. 예상치 못한 재연결이 발생하면 관련 조건을 먼저 비활성화하고 수동 연결을 다시 확인한 다음 하나씩 복원하세요.
연결은 되지만 속도가 기대에 미치지 못하면 먼저 같은 기기, 같은 대상, 같은 모드에서 로컬 네트워크를 비교한 다음 본인이 보유한 다른 서버와 비교합니다. Connectivity Test 결과를 다운로드 속도로 바로 환산할 수는 없습니다. 대상 서비스의 응답, 원격 회선 및 기기의 현재 네트워크가 모두 사용 경험에 영향을 줄 수 있습니다. 한꺼번에 설정을 여러 개 바꾸기보다 반복해서 확인되는 현상을 기록하는 편이 원인을 찾는 데 도움이 됩니다.
문제 해결이 끝나면 성공 상태를 재현할 수 있는 서버, 모드 및 설정 파일을 유지한 뒤 필요한 규칙이나 자동 연결 조건을 하나씩 복원합니다. 프로토콜 입력란이나 규칙 키워드가 불분명하다면 용어 빠른 참조를 확인하세요. 여러 구독의 관리, 업데이트, 삭제 및 백업은 구독 및 서버 관리 매뉴얼에서 확인할 수 있습니다. 이 튜토리얼은 확인 가능한 연결을 한 번 완료하는 데까지 안내하며, 처음부터 모든 설정을 조정할 필요는 없습니다.