공식 매뉴얼 · iPhone / iPad 조작 예시
Shadowrocket 사용 가이드
구독 가져오기, 연결 및 확인
다섯 단계로 첫 설정을 완료합니다. 먼저 기존 정보를 Home에 추가하고 요청 경로를 선택한 다음 테스트와 실제 접속으로 결과를 확인합니다. 처음 진행할 때는 약 10분을 예상하세요. 문제가 발생하면 해당 점검 항목으로 바로 이동합니다.
STEP 01 / IMPORT
Add Server: 서버 추가 또는 구독 가져오기
Shadowrocket을 열고 Home으로 이동해 아래쪽의 SERVER 영역을 확인합니다. 이곳에는 선택할 수 있는 서버 항목이 표시됩니다. 목록에 이름이 보인다는 것은 정보가 저장되었다는 뜻일 뿐, 서버를 현재 사용할 수 있다는 뜻은 아닙니다. 자신의 서비스 정보를 준비한 다음 Add Server로 이동합니다. 처음 가져올 때는 한 가지 방법만 선택하고 결과를 확인한 뒤 다른 정보를 추가하는 것이 좋습니다. 그래야 이름이 같은 항목이 섞여 어느 항목을 테스트하는지 혼동하지 않습니다.
구독 링크가 있는 경우: Subscribe 선택
- Home에서 추가 메뉴를 눌러 Add Server를 열고 Type에서 Subscribe를 선택합니다. 서비스 제공자가 안내한 전체 링크를 사용해야 하며, 웹사이트 첫 화면이나 로그인 페이지 또는 계정 관리 페이지를 입력하면 안 됩니다.
- 링크를 해당 URL 입력란에 붙여 넣고 앞뒤에 공백, 줄 바꿈 또는 채팅 문구가 섞이지 않았는지 확인합니다. 링크의 매개변수는 주소의 일부이므로 표시를 짧게 하려고 삭제하지 마세요.
- 구분하기 쉬운 메모를 입력하고 저장합니다. 구독 정보 읽기가 끝나면 Home으로 돌아가 SERVER 목록을 확인합니다. 항목이 생성되지 않으면 여러 번 연달아 가져오지 말고 먼저 읽기 실패 안내를 확인합니다.
구독은 여러 서버 정보를 가져오는 경로입니다. 이후 업데이트로 이름, 주소 또는 항목 수가 바뀔 수 있으며, 구독에서 생성된 내용을 직접 수정하면 업데이트 과정에서 덮어쓸 수도 있습니다. 따라서 처음에는 구독을 정상적으로 읽을 수 있는지 확인한 뒤 그룹을 정리하세요. 구독 링크에는 접근 자격 정보가 포함되는 경우가 많으므로 전체 링크를 공개 스크린샷, 댓글 또는 공유 문서에 올리지 마세요. 다른 사람에게 오류를 설명할 때는 인증 정보를 가려야 합니다.
개별 서버 정보가 있는 경우: Type에 맞춰 입력
Add Server로 다시 이동해 Type을 보유한 서비스 정보와 일치시킵니다. 스크린샷의 양식을 예로 들면 Host에는 서버 호스트 이름 또는 IP 주소를, Port에는 서비스 포트를 입력하고, Password와 Method는 원래 정보를 그대로 입력합니다. Host에 전체 웹페이지 경로를 넣으면 안 됩니다. 다른 프로토콜을 선택하면 입력란이 달라지므로 한 프로토콜의 입력 방식을 다른 프로토콜에 그대로 적용할 수 없습니다. TLS, 전송 방식 또는 추가 인증 항목이 있다면 이름만 보고 값을 추측하지 말고 서버 정보를 하나씩 대조하세요.
정보가 QR 코드로 제공된 경우 Scan QR Code를 사용할 수 있습니다. Import from Cloud JSON은 해당 JSON 정보를 가져오는 기능이며, 임의의 구독 주소를 대신 입력하는 곳이 아닙니다. 링크를 가져오기 위해 맞지 않는 Type을 반복해서 바꾸지 마세요. 저장한 뒤 Home으로 돌아가 이번에 추가한 항목을 선택하고 메모를 확인합니다. 다음 단계에서는 선택한 항목의 요청 경로를 정합니다.
구독, 서버 및 구성 파일의 차이가 궁금하다면 용어 가이드를 먼저 확인하세요. 이 단계의 완료 기준은 Home에서 예상한 항목을 찾을 수 있고 프로토콜 및 연결 매개변수의 출처가 명확한 것입니다.
STEP 02 / ROUTING
Global Routing: 구성, 프록시 또는 직접 연결 선택
서버 항목을 준비했다면 Home으로 돌아가 Global Routing을 엽니다. 여기서는 요청을 처리할 방식을 정하며, 서버 정보를 보완하거나 연결할 수 없는 서버를 자동으로 사용 가능하게 만들지는 않습니다. 세 가지 모드는 구성(Config) / 프록시(Proxy) / 직접 연결(Direct)로 구분합니다. 선택하기 전에 목적을 명확히 하세요. 기존 서버가 작동하는지 확인하려는 것인지, 아니면 자신의 규칙에 따라 일상적인 트래픽을 분리하려는 것인지 판단합니다.
- 구성(Config): 현재 구성의 규칙에 따라 요청 경로를 결정합니다. 한 번 연결해도 도메인마다 PROXY, DIRECT 또는 REJECT 등의 정책이 다를 수 있으며, 결과는 실제 규칙과 순서에 따라 달라집니다.
- 프록시(Proxy): 주요 요청 경로에 프록시 정책을 적용합니다. 문제 해결 과정에서 규칙 분기로 인한 변수를 줄이는 데 적합하지만, 실제 구성과 시스템 트래픽 범위도 함께 고려해야 합니다.
- 직접 연결(Direct): 주요 요청 경로가 대상에 직접 연결됩니다. 선택한 프록시 서버가 작동하는지 확인하는 방법으로는 적합하지 않습니다. 스위치가 켜져 있는지와 요청이 프록시를 사용하는지는 별도로 확인해야 합니다.
구성(Config)을 사용하기 전에 현재 파일 확인
하단의 Config로 이동해 현재 사용 중인 구성 파일을 확인합니다. 내용을 점검해야 할 때 편집 화면으로 이동하세요. 공식 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 각각 다른 구성 섹션입니다. 처음에는 현재 파일과 Rule을 중심으로 확인하고 모든 섹션을 한꺼번에 수정할 필요는 없습니다. 기존 파일을 먼저 백업한 뒤 대상 도메인과 관련된 규칙이 있는지 확인합니다. Add Rule은 규칙을 추가하는 기능이며 서버를 추가하는 메뉴가 아닙니다.
아래 예시는 규칙 순서를 설명하기 위한 것이며 완전한 구성 파일도, 서버 정보도 포함하지 않습니다. DOMAIN-SUFFIX는 지정된 도메인과 하위 도메인을 일치시키며 FINAL은 앞선 규칙과 일치하지 않은 요청을 처리합니다. 최종 규칙을 앞에 놓으면 뒤의 규칙이 일치 여부를 확인할 기회가 없을 수 있습니다. 예시에서는 example.com에 일치하는 요청만 PROXY를 사용하고 나머지는 DIRECT로 처리됩니다. 이를 근거로 모든 접속이 프록시를 사용해야 한다고 판단해서는 안 됩니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
확인을 마친 뒤 Home으로 돌아와 Global Routing에 방금 선택한 모드가 표시되는지 확인합니다. 첫 테스트에서 모드, 서버 및 전체 구성을 동시에 바꾸지 마세요. 결과가 달라져도 어떤 변경이 영향을 주었는지 알기 어렵습니다. 규칙 키워드의 의미는 용어 가이드에서 확인하세요. DNS, 규칙 참조 및 추가 설정은 Settings 설정 참고에서 계속 살펴볼 수 있습니다.
STEP 03 / CONNECT
Home: 상단 스위치를 켜고 시스템 승인 완료
Home으로 돌아가 먼저 SERVER에서 현재 선택된 항목을 확인하고 Global Routing도 확인합니다. 두 항목이 모두 예상한 설정과 일치한 뒤 상단 연결 스위치를 켭니다. 스크린샷의 Not Connected는 아직 연결되지 않은 상태를 뜻하며 조작 전 상태의 참고 화면입니다. 작업을 마친 뒤에도 이 문구가 유지되어야 한다고 생각하지 마세요. 이미 연결된 상태에서 주요 매개변수를 변경했다면 새 설정을 확인할 수 있도록 필요에 따라 먼저 연결을 끊었다가 다시 연결합니다.
- Home 상단의 스위치를 누릅니다. 처음 사용할 때 시스템에서 VPN 구성을 추가할지 요청할 수 있습니다. 안내에 Shadowrocket이 표시되는지 확인한 뒤 계속 진행하고 기기에서 요구하는 암호 또는 생체 인증을 완료합니다.
- 승인한 뒤 Shadowrocket으로 돌아와 스위치가 켜진 상태인지, 연결 상태가 바뀌었는지 확인합니다. 승인을 취소했다면 연결을 다시 시작해야 합니다. 시스템 승인 절차를 건너뛰고 서버 암호를 바로 변경하지 마세요.
- 스위치가 곧바로 꺼지면 안내 문구를 기록한 뒤 시스템 승인, 현재 구성 및 매개변수를 확인합니다. 스위치는 켜져 있지만 웹페이지에 접속할 수 없다면 다음 단계에서 확인합니다. 두 종류의 실패를 같은 문제로 취급하지 마세요.
시스템 VPN 표시는 기기에 해당 네트워크 구성이 설정되었음을 나타낼 뿐, 원격 서버, 도메인 해석 및 대상 서비스가 모두 정상이라는 것을 단독으로 증명하지 않습니다. 마찬가지로 Home의 연결 상태와 SERVER 항목의 사용 가능 여부는 서로 다른 문제입니다. “구성이 활성화됨”, “서버가 응답함”, “실제 요청이 올바른 경로를 사용함”을 각각 확인해야 스위치가 켜진 것만 보고 점검을 끝내는 일을 피할 수 있습니다.
테스트하는 동안 복잡한 On Demand 조건을 활성화하지 말고 다른 VPN 구성도 네트워크를 동시에 제어하지 않도록 합니다. 연결을 끈 뒤 다시 자동 연결된다면 상단 스위치를 반복해서 켰다 끄기보다 Settings에서 On Demand 조건을 먼저 확인하세요. 첫 설정의 목표는 반복 가능한 수동 연결을 한 번 완료하는 것입니다. 기본 경로가 작동하는 것을 확인한 다음 자동 연결 동작을 추가합니다.
이 단계가 끝나면 같은 서버, 같은 모드 및 같은 Config를 유지한 채 다음 단계에서 확인합니다. 그래야 문제가 발생했을 때 테스트 결과를 서로 비교할 수 있습니다.
STEP 04 / VERIFY
Connectivity Test: 테스트 후 실제 접속 확인
연결을 유지하고 Home에서 Connectivity Test를 눌러 테스트가 끝날 때까지 기다립니다. 테스트 결과는 현재 테스트 방법에 따른 연결 상태를 판단하는 데 도움이 되지만, 테스트 대상이 실제로 이용하려는 서비스와 다를 수 있습니다. 목록에 표시된 특정 수치만으로 모든 서비스가 정상인지 판단하지 말고, 한 번의 시간 초과를 구독이 유효하지 않다는 의미로 단정하지 마세요. 먼저 방금 선택한 항목을 테스트하고 있는지 확인하고, 테스트 중 Wi-Fi에서 셀룰러 네트워크로 전환되지 않았는지도 살펴봅니다.
이어서 브라우저 또는 대상 앱을 열고 새 요청을 보냅니다. 정상 작동을 알고 있고 실제 확인이 필요한 서비스 페이지를 우선 사용하세요. 이미 열어 둔 페이지를 그대로 표시하면 캐시 때문에 결과가 참고가 되지 않을 수 있습니다. 페이지를 새로고침하거나 해당 서비스에서 아직 방문하지 않은 콘텐츠를 엽니다. 실제 접속이 성공했더라도 현재 Global Routing을 확인해야 합니다. 직접 연결(Direct)에서 열리는 페이지는 프록시 경로가 작동한다는 증거가 아닙니다.
| 확인된 결과 | 다음 점검 항목 |
|---|---|
| 테스트 실패, 실제 접속도 실패 | 기기 네트워크, 서버 매개변수 및 서비스 상태를 확인해 기본 연결 문제부터 배제합니다. |
| 테스트 성공, 일부 서비스만 실패 | 대상 도메인의 규칙, DNS 및 대상 서비스 자체의 상태를 확인합니다. |
| 테스트 실패, 실제 접속은 정상 | Settings의 Test Method를 확인해 테스트 조건과 실제 요청을 구분합니다. |
| 연결은 켜졌지만 요청 경로가 예상과 다름 | Global Routing, 현재 Config 및 해당 규칙의 일치 결과를 확인합니다. |
구성(Config)을 사용한다면 이용 가능한 로그에서 대상 요청에 적용된 규칙과 정책을 확인합니다. 하나의 페이지가 여러 도메인을 호출할 수 있으므로 기본 페이지가 열렸다고 해서 모든 관련 요청이 같은 경로를 사용한다고 볼 수는 없습니다. 문제를 점검할 때는 실패한 요청 하나만 추적하고 대상 호스트 이름, 사용 네트워크 및 현재 모드를 기록한 뒤 해당 규칙을 확인합니다. 규칙을 변경하기 전에는 백업하고, 수정한 뒤 새 요청을 보내세요. 이전 연결의 결과에 의존하지 마세요.
이 단계의 완료 기준은 특정 테스트 수치가 아니라 연결이 유지되고, 필요한 서비스를 정상적으로 요청할 수 있으며, 규칙 경로가 예상과 일치하는지 여부입니다. 테스트 결과와 실제 결과가 다르면 관찰한 내용을 기록하고 마지막 단계로 이동하세요. 클라이언트를 바로 다시 설치하지 마세요.
STEP 05 / DIAGNOSE
Settings: 실패 단계에 따라 항목별 점검
먼저 실패가 가져오기, 연결 또는 실제 요청 중 어느 단계에서 발생했는지 판단한 다음 Settings에서 관련 항목을 확인합니다. 스크린샷의 Test Method, On Demand, Diagnostics, Proxy, TCP 및 UDP는 서로 다른 설정 범위이므로 문제 해결을 위해 모두 변경하지 마세요. 한 번에 한 항목만 바꾸고 다시 연결한 뒤 동일한 테스트를 반복합니다. 개선되지 않으면 원래 값으로 되돌립니다. 현재 Config와 원래 서비스 정보를 보관하는 편이 설정을 무작정 지우는 것보다 문제를 찾는 데 유리합니다.
구독을 읽지 못하거나 가져온 뒤 목록이 비어 있는 경우
Add Server로 돌아가 Type이 Subscribe인지, 링크가 완전한지, 웹페이지 주소를 잘못 사용하지 않았는지 확인합니다. 현재 네트워크에서 기기가 구독 주소에 접속할 수 있는지 확인하세요. 구독을 읽는 과정에도 네트워크가 필요하므로 프록시 연결을 아직 설정하지 않았다고 해서 업데이트가 반드시 불가능한 것은 아닙니다. 인증 또는 권한 오류가 표시되면 기존 서비스 제공자에게 정보의 상태를 확인하세요. 같은 링크를 반복해서 가져오지 말고 전체 구독 주소를 공개하지도 마세요. 이전에 사용할 수 있던 항목이 있다면 비교할 수 있도록 먼저 보관하고 삭제하지 않습니다.
항목은 저장됐지만 연결 또는 테스트가 실패하는 경우
Host, Port, 인증 항목 및 Type을 하나씩 확인하고 복사 과정에서 공백이 들어갔거나 프로토콜이 일치하지 않는 부분이 없는지 살펴봅니다. 정보에 TLS, 전송 경로 또는 추가 매개변수가 포함된 경우 서버 측 설정과 일치해야 합니다. 기기 자체가 정상적으로 인터넷에 연결되는지 확인한 뒤, 가능한 경우 다른 네트워크에서 동일한 테스트를 반복합니다. 네트워크를 바꾼 뒤에만 결과가 달라진다면 네트워크 조건을 더 살펴봐야 합니다. 모든 네트워크에서 실패하면 규칙을 먼저 수정하기보다 서버 정보와 서비스 상태를 확인합니다.
테스트 결과가 이상하거나 일부 요청만 실패하는 경우
Settings에서 Test Method를 확인하고 사용 중인 테스트 방법을 파악한 뒤 Connectivity Test와 실제 접속 결과를 비교합니다. 특정 테스트 조건의 시간 초과가 모든 프로토콜을 사용할 수 없다는 뜻은 아닙니다. 특정 도메인만 문제가 있다면 Config에서 규칙 순서, REJECT 일치 여부 및 DNS의 유효한 결과 반환 여부를 확인합니다. TCP와 UDP의 차이도 실제 서비스에 따라 판단해야 하므로 실패한 요청 유형을 확인하기 전에 관련 설정을 임의로 바꾸지 않는 것이 좋습니다.
연결을 끈 뒤 자동 연결되거나 진단 정보를 수집해야 하는 경우
현재 네트워크 조건과 일치하는 On Demand 규칙이 있는지 확인하고 자동 연결 요인을 먼저 일시 중지한 뒤 상단 스위치로 수동 확인합니다. 추가 분석이 필요하면 Diagnostics에서 사용 가능한 진단 정보를 확인합니다. 공유하기 전에는 서버 주소의 개인 정보, 구독 인증 매개변수 및 기타 자격 정보를 가립니다. 문제를 설명할 때는 어느 단계에서 실패했는지, 사용 네트워크, 현재 Global Routing 및 이미 진행한 개별 테스트를 명확히 작성하는 편이 스위치 스크린샷 한 장만 제공하는 것보다 도움이 됩니다.
DNS, Proxy 포트 또는 On Demand의 세부 항목을 점검해야 한다면 Settings 설정 참고를 확인하세요. 프로토콜 항목이나 규칙 키워드는 용어 가이드에서 찾아볼 수 있습니다. 작동 여부를 확인한 뒤 현재 구성의 백업을 저장하고 구독과 자동 연결 조건을 정리하세요. 최초 연결 확인과 고급 설정을 한 번에 진행하지 않도록 합니다.