Shadowrocket 사용법
기존 설정 → 모드 선택 → 연결 확인
이 페이지에서는 첫 사용에 필요한 기본 절차를 안내합니다. 기존 서버 설정 하나로 먼저 연결한 뒤 규칙 세부 설정과 자동 연결 조건을 살펴보세요. 여러 설정을 동시에 변경하지 않는 것이 좋습니다.
아래 내용은 iPhone과 iPad의 조작 방법을 기준으로 설명합니다. 스크린샷은 화면과 입력란의 위치를 확인하기 위한 것으로, 목록이 그림과 똑같아야 한다는 뜻은 아닙니다. 프로토콜에 따라 Add Server에서 입력해야 하는 항목이 달라지므로 현재 선택한 Type과 본인의 설정 정보를 기준으로 진행하세요.
- 먼저 설정이 완전한지 확인
- 다음으로 연결 상태 확인
- 한 번에 조건 하나만 변경
Add Server: 서버 추가 또는 구독 가져오기
가지고 있는 정보에 맞는 추가 방법을 하나 선택하세요. 같은 정보를 여러 번 가져올 필요는 없습니다.
Shadowrocket을 열고 Home으로 이동합니다. SERVER 영역에서 Add Server를 찾거나 화면의 추가 버튼을 이용하세요. 먼저 Type을 확인합니다. Type에 따라 뒤에 나오는 입력 항목의 의미가 달라집니다. 서버 매개변수만 받은 경우 안내된 프로토콜을 선택하고, 구독 링크를 받은 경우 Subscribe를 선택하세요. 주소 형태만 보고 프로토콜을 짐작하거나 구독 링크를 Host와 Port에 나누어 입력하지 마세요.
서버 매개변수 직접 입력
Add Server에서 정보와 일치하는 Type을 먼저 선택한 다음 Host, Port 및 해당 유형에 필요한 항목을 입력합니다. Host에는 보통 서버 도메인이나 주소를, Port에는 포트 번호를 입력합니다. Password와 Method 등의 항목은 해당 프로토콜에서 요구하는 경우에만 입력하세요. 프로토콜마다 인증 방식이 다르므로 한 프로토콜의 입력 방식을 다른 프로토콜에 그대로 적용하면 안 됩니다. TLS나 전송 방식 같은 추가 항목은 보유한 정보를 기준으로 설정하고, 연결을 시도하려고 임의로 바꾸지 마세요.
복사한 내용에 공백, 줄바꿈 또는 한글 문장 부호가 섞이지 않았는지 확인하세요. 특히 포트 번호와 인증 정보가 온전히 입력됐는지 살펴봅니다. 알아보기 쉬운 이름을 메모로 입력한 뒤 저장하고 Home으로 돌아가 SERVER에 해당 항목이 표시되는지 확인하세요. 메모는 설정을 구분하는 데 도움이 되지만, 메모를 수정해도 서버 연결 매개변수는 바뀌지 않습니다.
기존 구독 링크 가져오기
Add Server의 Type에서 Subscribe를 선택하고 본인 소유의 구독 링크 전체를 해당 URL 입력란에 붙여넣은 다음 저장해 결과를 기다립니다. 구독 링크에는 서비스 이용 권한을 확인하는 정보가 포함될 수 있으니 원본을 빠짐없이 복사하세요. 물음표 뒤 내용을 지우거나 채팅 안내 문구까지 함께 붙여넣지 마세요. 구독 항목 저장과 서버 목록 가져오기는 서로 다른 결과입니다. Home으로 돌아가 SERVER에 선택 가능한 항목이 실제로 표시되는지 확인하세요.
QR 코드를 받은 경우 자료의 형식에 따라 Scan QR Code를 이용할 수 있습니다. Import from Cloud JSON은 특정 형식의 가져오기 기능이며 모든 구독 링크에 사용할 수 있는 것은 아닙니다. 실제 자료 형식에 맞는 기능을 선택하고 형식을 확인하기 어려우면 서비스 제공자에게 문의하세요. 같은 내용을 여러 가져오기 기능으로 반복해서 불러오면 이후 선택과 문제 해결이 복잡해질 수 있습니다.
목록이 비어 있으면 먼저 링크 전체가 복사됐는지, 현재 네트워크에서 링크를 가져올 수 있는지, 이용 중인 서비스가 정상인지 확인하세요. 서버를 가져오지 못한 상태에서 규칙을 편집할 필요는 없습니다. Rule은 목록에 없는 서버를 추가해 주지 않습니다. 항목이 표시되면 현재 기록을 유지하고 다음 단계에서 Global Routing을 선택하세요. 자세한 내용은 자주 묻는 질문의 구독 및 서버 가져오기 안내를 참고하세요.
이 단계의 완료 기준: Home의 SERVER에 알아볼 수 있는 서버 항목이 표시되어야 합니다. 구독 기록만 저장된 상태여서는 안 됩니다.
Global Routing: 연결 모드 선택
세 가지 모드는 연결에 적용할 정책을 결정합니다. 서버 정보를 대신하거나 잘못된 매개변수를 수정해 주지는 않습니다.
Home으로 돌아가 Global Routing을 누릅니다. 세 가지 모드는 Config/Proxy/Direct입니다. 먼저 이번에 확인하려는 목적이 선택한 서버의 사용 가능 여부인지, 기존 규칙에 따른 일상적인 트래픽 분기인지 정하세요. 모드를 선택한 뒤 Home으로 돌아와 Global Routing에 표시된 값을 확인합니다. 전환했다고 생각했지만 실제로는 이전 모드에 머물러 있는 상황을 방지할 수 있습니다.
Config: 현재 구성의 규칙에 따라 판단
Config는 현재 구성에 설정된 규칙에 따라 연결에 사용할 정책을 결정합니다. 구독의 서버 목록과 Config의 구성 파일은 서로 다른 역할을 합니다. 서버 목록은 연결에 사용할 정보를 제공하고, 구성 파일은 트래픽을 판단하는 방법을 정의합니다. 구독을 가져와 서버 목록이 표시된다고 해서 트래픽 분기 규칙까지 준비된 것은 아닙니다. Config를 사용하기 전에 Config에서 현재 적용 중인 구성을 확인하고 Rule의 규칙과 순서를 살펴보세요.
오른쪽 공식 스크린샷은 구성 편집 화면의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption, Add Rule을 보여 줍니다. 첫 연결을 위해 각 항목을 하나씩 수정할 필요는 없습니다. 특히 고급 항목이 보인다고 해서 바로 켜거나 편집하지 마세요. 먼저 이해하고 출처를 확인한 구성을 사용하고, 규칙 조정은 연결 확인 후 진행하세요.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT규칙 문법을 이해하기 위한 예시입니다. 도메인 접미사나 주소 범위에 따라 일치시키고, 일치하는 항목이 없으면 FINAL이 처리합니다. 구성을 통째로 바꾸라는 의미는 아닙니다.
Proxy와 Direct: 테스트 목적 구분
Proxy는 프록시 경로로 연결을 처리하므로 처음 문제를 점검할 때 규칙 매칭에 따른 변수를 줄이는 데 유용합니다. 다만 사용할 수 있는 서버 설정이 있어야 합니다. Host, 인증 정보 또는 서비스 상태에 문제가 있으면 Proxy로 바꿔도 자동으로 해결되지 않습니다. 테스트를 통과한 뒤 일상적으로 규칙에 따라 트래픽을 분기하려면 Config로 돌아가 실제 접속을 다시 확인하세요.
Direct는 직접 연결 경로를 사용하며 기본 네트워크 접속이 정상인지 확인할 때 적합합니다. Direct로 페이지가 열린다고 해서 프록시 서버의 사용 가능 여부가 확인되는 것은 아닙니다. 이때 성공한 것은 직접 접속뿐이며, 선택한 서버가 정상이라는 뜻은 아닙니다. 기존 서버를 처음 확인할 때는 Proxy로 연결 및 테스트를 마친 뒤 Config로 돌아가 트래픽 분기를 확인할 수 있습니다.
규칙의 세부적인 매칭 순서, 정책 참조 또는 DNS 설정이 필요하면 전체 매뉴얼을 참고하세요. 이 튜토리얼에서는 명확한 테스트 모드 하나만 유지하며 첫 연결 단계에서 여러 설정을 한꺼번에 바꾸지 않습니다.
이 단계의 완료 기준: Home에서 현재 모드를 확인하고, 다음에 서버 경로를 확인할지 규칙에 따른 트래픽 분기를 확인할지 알고 있어야 합니다.
Home: 서버 선택 및 연결
먼저 SERVER에서 서버를 선택하고 상단 스위치를 켠 다음 연결 상태가 유지되는지 확인하세요.
Home으로 돌아가 SERVER에서 확인할 서버를 찾고 항목 왼쪽의 원형 선택 버튼을 눌러 현재 서버로 지정합니다. ‘서버 선택’과 ‘세부 정보 편집’은 다른 작업입니다. 여기서는 사용할 서버를 정하기만 하면 되며 정보를 다시 입력할 필요는 없습니다. 목록에 비슷한 메모가 여러 개 있으면 해당 항목이 어느 구독 그룹이나 서버 정보에 해당하는지 확인해 다른 설정을 테스트하지 않도록 주의하세요.
Global Routing이 앞서 정한 테스트 목적에 맞는지 다시 확인한 다음 Home 상단의 연결 스위치를 켭니다. 연결 전에는 Not Connected가 표시될 수 있습니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용을 요청할 수 있습니다. 안내에 표시된 앱 이름이 현재 작업과 일치하는지 확인한 뒤 시스템 절차에 따라 승인하세요. 기기 인증이 필요할 수도 있습니다. 이 단계는 시스템 VPN 구성을 만들 권한을 부여하는 것이며 서버 인증 정보를 입력하는 화면이 아닙니다.
권한 요청을 취소하면 연결 절차를 계속 진행하지 못할 수 있습니다. Shadowrocket으로 돌아가 연결을 다시 시작하고 표시되는 시스템 안내에 따라 진행하세요. 기기가 조직 관리 대상이거나 시스템 제한을 받는 경우 허용된 구성 범위를 먼저 확인하세요. 권한 문제를 해결하려고 서버 비밀번호를 반복해서 바꾸지 마세요.
권한을 승인한 뒤 Home으로 돌아와 상단 연결 상태가 Not Connected에서 연결됨으로 바뀌는지, 스위치가 곧바로 꺼지지 않는지 확인합니다. 시스템에 표시되는 VPN 상태는 터널이 설정되었는지 확인하는 보조 정보지만 실제 접속 확인을 대신하지는 않습니다. 연결됨은 연결 절차가 완료됐다는 뜻일 뿐 모든 주소에 접속할 수 있다거나 Config의 모든 규칙이 예상대로 동작한다는 의미는 아닙니다.
iPad에서도 현재 서버와 Global Routing을 먼저 확인한 다음 시스템 권한을 처리합니다. 다른 기기에서 Shadowrocket을 사용한 적이 있어도 이 기기의 권한과 설정 정보는 따로 확인해야 합니다. 다음 단계에서는 현재 서버와 모드를 그대로 유지한 채 Connectivity Test와 실제 접속을 진행해 같은 조건에서 결과를 확인하세요.
이 단계의 완료 기준: 선택한 서버가 명확하고 연결 스위치가 유지되며 Home에 Not Connected가 표시되지 않아야 합니다.
Connectivity Test: 연결 확인
테스트 결과, 실제 접속, 현재 모드를 함께 확인하세요. 어느 한 가지의 성공만으로 전체 연결을 확인할 수는 없습니다.
Home에서 Connectivity Test를 누르고 테스트가 끝날 때까지 기다린 뒤 선택한 서버의 결과를 확인합니다. 이 테스트로 현재 조건에서 연결 가능한지 살펴볼 수 있습니다. 결과가 표시돼도 모든 앱, 도메인, 연결 방식이 반드시 성공한다는 뜻은 아니며, 시간 초과만으로 서버 정보가 잘못됐다고 단정할 수도 없습니다. 테스트 방식, 현재 네트워크, 대상의 응답 상태가 결과에 영향을 줄 수 있으므로 실제 접속 결과와 함께 확인하세요.
이어서 브라우저를 열고 평소 이용하며 접근 권한이 있는 페이지에 접속해 완전히 로드되는지 확인하세요. 이미 캐시된 제목이나 이미지만 보지 않도록 주의합니다. 서버, Global Routing, 네트워크 환경을 그대로 유지하고 필요하면 페이지를 새로고침하세요. 네트워크를 바꾸고 DNS를 수정하고 서버까지 교체하면 어떤 변경이 결과에 영향을 줬는지 파악하기 어렵습니다.
그다음 Data로 이동해 사용 전후의 트래픽이 달라졌는지 확인합니다. Data는 사용량을 파악하는 데 도움이 되지만 누적 수치만으로 특정 페이지가 프록시를 거쳤다고 판단해서는 안 됩니다. 특히 Config에서는 일부 요청이 DIRECT로, 다른 요청은 PROXY로 처리될 수 있습니다. 페이지가 열렸더라도 예상한 경로를 사용했는지는 규칙을 함께 살펴봐야 합니다.
서버 확인을 위해 Proxy를 임시로 사용했다면 실제 접속이 정상인지 확인한 뒤 Config로 돌아가 두 번째 테스트를 진행하세요. 같은 서버가 Proxy에서는 동작하지만 Config로 돌아온 뒤 문제가 생기면 구독을 바로 다시 가져오기보다 현재 구성과 Rule을 먼저 확인하세요. 반대로 Direct에서 접속된다고 프록시 경로도 정상이라고 볼 수는 없으므로 각각 따로 판단해야 합니다.
확인을 마친 뒤 정상 작동한 조건을 기억해 두세요. 선택한 서버, 현재 모드, 사용 중인 구성, 네트워크 환경입니다. 나중에 문제가 생기면 연결 스위치를 계속 누르기보다 이 조건과 달라진 점을 먼저 비교하는 편이 원인을 찾기 쉽습니다. 트래픽 해석이나 규칙 판단을 더 자세히 알아보려면 전체 매뉴얼의 연결 및 Data 안내를 참고하세요.
이 단계의 완료 기준: 실제 접속 결과가 예상과 맞고, 현재 Proxy, Direct 또는 Config의 규칙 정책 중 무엇을 사용했는지 설명할 수 있어야 합니다.
Settings: 실패한 단계별 문제 해결
먼저 문제가 발생한 단계를 확인한 다음 점검할 화면을 정하세요.
문제가 발생하면 먼저 상황을 기록하세요. 목록이 비어 있는지, 스위치가 유지되지 않는지, 테스트 시간이 초과되는지, 특정 페이지에서만 실패하는지 확인합니다. 각각 문제가 생긴 단계가 다르므로 같은 방법으로 처리하면 안 됩니다. 아래 순서대로 하나씩 확인하고 항목을 점검할 때마다 기존 조건으로 다시 테스트하세요. 아직 변경하지 않은 정보는 그대로 두어 비교할 수 있게 합니다.
목록이 비어 있음: 가져오기 단계 확인
먼저 기기의 기본 네트워크가 정상인지 확인한 다음 Subscribe에 입력한 URL 전체와 가져오기 결과를 살펴보세요. 링크가 잘렸거나 이용 중인 서비스 상태가 바뀌었거나 구독 내용을 해석하지 못하면 목록이 비어 있을 수 있습니다. 서비스 제공자에게 문의할 때는 가져오기 결과와 문제가 발생한 단계를 설명하되 구독 링크 전체를 공개하지 마세요. 선택 가능한 서버를 가져오지 못한 상태이므로 이때 Global Routing이나 Rule을 수정해도 문제 해결에 도움이 되지 않습니다.
스위치가 유지되지 않음: 권한과 선택 항목 확인
SERVER에서 서버가 선택되어 있는지, 시스템의 VPN 구성 추가 절차가 완료됐는지 확인합니다. 기기 관리 제한이나 다른 VPN 연결이 활성화되어 있는지도 살펴보세요. 시스템 안내에 따라 현재 연결 상태를 처리한 뒤 다시 시도하고 모든 구성을 바로 삭제하지 마세요. 네트워크를 바꾼 뒤에만 문제가 발생한다면 원래 네트워크로 돌아가 다시 테스트해 네트워크 환경과 관련이 있는지 확인하세요.
연결은 되지만 접속 실패: 매개변수와 규칙 구분
Type, Host, Port, 인증 정보와 설정 자료에서 요구하는 추가 매개변수를 기억에 의존하지 말고 하나씩 대조하세요. 다음으로 Global Routing을 확인합니다. Config를 사용 중이었다면 비교를 위해 Proxy를 잠시 선택할 수 있습니다. Config에서만 문제가 발생하는 경우 현재 구성, 규칙 순서, 대상에 적용되는 정책을 먼저 살펴보세요. 일부 도메인에서만 실패한다면 모든 옵션을 반복해서 전환하기보다 DNS와 규칙 매칭도 확인해야 합니다.
테스트와 실제 접속 결과가 다름: 진단 조건 확인
Settings에서 현재 선택된 Test Method를 확인하세요. 테스트 방식에 따라 확인하는 조건이 다르므로 한 번의 테스트 결과를 모든 접속에 그대로 적용할 수 없습니다. 원인을 더 찾으려면 Diagnostics를 사용하고 실제로 표시되는 항목을 확인하세요. 진단 정보를 저장하거나 전달하기 전에 본인의 구독 링크, 인증 정보, 공개하고 싶지 않은 접속 기록을 가리세요.
처음 문제를 점검하는 동안에는 수동 연결을 유지하세요. On Demand는 조건에 따라 연결을 시작하는 기능이므로 수동 연결이 안정된 다음 설정하는 것이 좋습니다. 스위치가 수동 조작과 다르게 동작하면 On Demand가 활성화되어 있는지도 확인하세요. Settings의 Proxy, TCP, UDP 등의 항목도 연결을 시도하려고 모두 변경할 필요는 없습니다. 기존 설정을 유지하고 현재 증상과 직접 관련된 항목만 조정하세요.
문제 해결을 마친 뒤 테스트 중 임시로 바꾼 모드를 일상적으로 사용할 설정으로 되돌리고 실제 접속을 다시 확인하세요. 해결되지 않았다면 자주 묻는 질문에서 증상에 따라 계속 살펴보세요. 규칙, DNS, 장기적인 유지 관리에 관한 안내는 전체 매뉴얼에 있습니다. 문의할 때 ‘연결이 안 됨’이라고만 쓰기보다 실패한 단계, 현재 모드, 확인한 조건을 구체적으로 설명하면 원인을 파악하는 데 도움이 됩니다.
이 단계의 완료 기준: 문제 원인을 가져오기, 권한, 서버 매개변수, 규칙 중 한 단계로 좁히고 같은 조건에서 다시 테스트할 수 있어야 합니다.
