Shadowrocket 사용법
quick-start기존 설정 가져오기 → 분기 모드 선택 → 연결 및 확인. 다섯 단계로 처음 설정한 뒤, 문제가 발생한 위치에 따라 항목별로 점검하세요.
서버 추가 및 구독 가져오기
01 / import먼저 보유한 정보가 어떤 종류인지 확인하세요. 구독 링크는 보통 서버 목록을 가져오는 주소이고, 단일 서버 공유 정보는 연결 하나에 대한 내용입니다. 수동 설정 정보에는 프로토콜, 주소, 포트, 인증 정보가 포함됩니다. 각각 용도가 다르므로 구독 주소를 Host에 입력하거나, 안내 페이지의 URL을 구독 링크로 사용하지 마세요. 종류를 알기 어렵다면 본인의 서비스 제공자에게 먼저 문의하세요.
기존 구독 링크가 있는 경우: Subscribe 선택
Home(홈)을 열고 오른쪽 위의 추가 버튼이나 SERVER(서버 그룹)의 Add Server(서버 추가)를 누릅니다. Type(유형)을 누르고 Subscribe(구독)를 선택한 뒤, URL 입력란에 본인의 구독 링크 전체를 입력합니다. 구독을 알아보기 쉬운 이름으로 지정하고 저장합니다. Home으로 돌아가 목록을 가져올 때까지 기다린 다음, 구독 아래에 서버 항목이 표시되는지 확인하세요.
링크를 붙여넣기 전후에 시작과 끝을 포함해 주소가 온전한지 확인하세요. 채팅 내용의 안내 문구, 줄바꿈, 불필요한 공백까지 함께 복사될 수 있으며 주소의 쿼리 매개변수가 잘릴 수도 있습니다. 복잡해 보이는 매개변수도 임의로 삭제하지 마세요. 구독을 식별하는 데 필요할 수 있습니다. 구독 주소는 계정 인증 정보처럼 안전하게 보관하고 공개 댓글, 스크린샷, 온라인 변환 페이지에 올리지 마세요.
구독을 저장했다고 해서 업데이트까지 성공한 것은 아닙니다. 그룹 이름만 표시되고 서버가 없다면 해당 구독의 작업 메뉴에서 업데이트를 시도한 뒤, 링크가 유효한지와 현재 네트워크에서 내용을 가져올 수 있는지 확인하세요. 이 단계에서는 Global Routing을 변경할 필요가 없습니다. 가져오기가 끝나지 않은 빈 목록은 모드를 바꿔도 채워지지 않습니다. 나중에 어느 구독을 사용하는지 헷갈리지 않도록 같은 구독을 여러 개 만들지 마세요.
기존 서버 설정 정보가 있는 경우: Type에 맞게 입력
항목별 서버 설정 정보를 받았다면 Add Server에서 올바른 Type을 먼저 선택한 다음 Host(서버 주소)와 Port(포트)를 입력합니다. 스크린샷에는 Password(비밀번호)와 Method(암호화 방식)가 포함된 필드가 표시되어 있습니다. 프로토콜마다 입력 항목이 다르므로 모든 프로토콜에 스크린샷과 같은 항목을 입력하면 안 됩니다. Host에는 일반적으로 서비스 제공자가 안내한 도메인이나 IP 주소를 입력하며, 웹페이지 URL 전체를 입력하지 않습니다.
인증 정보, 암호화 방식, 전송 방식, TLS 관련 설정은 서버 측 정보와 일치해야 합니다. 프로토콜 이름이 비슷해도 필드를 서로 바꿔 쓸 수 있는 것은 아닙니다. 누락된 값을 추측해 입력하지 마세요. 입력 후 저장하고 Home으로 돌아가 SERVER에 새 항목이 있는지 확인합니다. QR 코드가 있다면 Scan QR Code(QR 코드 스캔)를 사용할 수 있습니다. Import from Cloud JSON(Cloud JSON에서 가져오기)은 해당 형식의 자료에만 사용하는 기능이며, 일반 구독 가져오기가 아닙니다.
이 단계의 완료 기준은 목록에 선택 가능한 서버가 있고, 출처와 메모를 알아볼 수 있는 것입니다. 정보가 완전한 항목 하나를 선택한 뒤 다음 단계로 넘어가세요. 프로토콜별 필드를 자세히 알아보려면 프로토콜 해설을 확인하세요. 첫 연결 단계에서 모든 고급 설정을 바꿀 필요는 없습니다.
Global Routing 세 가지 모드
02 / routing서버 항목을 준비한 뒤 Home으로 돌아가 Global Routing(글로벌 라우팅)을 눌러 현재 처리 방식을 확인합니다. 이 옵션은 연결에 적용할 정책을 정하며 구독을 다운로드하거나 잘못된 서버 비밀번호를 수정하지는 않습니다. 처음 사용하는 경우 세 가지 모드를 먼저 이해한 뒤 구성 파일을 편집할지 결정하세요.
- Config(구성): 현재 구성 파일의 규칙에 따라 연결 처리 방식을 결정합니다. 도메인이나 주소에 따라 프록시와 직접 연결을 구분할 때 사용합니다. 단, 원하는 규칙이 포함된 구성 파일이 활성화되어 있어야 합니다.
- Proxy(프록시): 프록시 정책으로 처리할 수 있는 연결을 프록시에 전달합니다. 서버 연결을 잠시 확인할 때 유용합니다. 모든 앱의 모든 네트워크 동작이 반드시 같은 경로를 거친다는 뜻은 아닙니다.
- Direct(직접 연결): 프록시 서버를 거치지 않고 직접 연결합니다. 로컬 네트워크 접속 결과를 잠시 비교할 때 선택할 수 있습니다. 이 모드를 선택한 상태에서는 프록시를 통한 접속 결과로 서버가 정상인지 판단할 수 없습니다.
Config 모드와 Config 화면의 차이
Global Routing의 Config는 연결 처리 모드이고, 하단의 Config(구성 파일) 화면은 구성 내용을 관리하고 편집하는 곳입니다. 이름은 같지만 서로 다른 기능입니다. 규칙 분기를 사용하려면 Config에 들어가 현재 선택된 파일을 확인한 뒤 Rule(규칙) 항목을 살펴봅니다. 스크린샷의 General(일반 설정), Hosts(호스트 매핑), URL Rewrite(URL 재작성), HTTPS Decryption(HTTPS 복호화)은 다른 구성 항목이며, 첫 연결에서 하나씩 켤 필요는 없습니다.
Rule은 일반적으로 위에서 아래 순서로 일치 여부를 확인하고, 처음 일치한 규칙의 정책을 적용합니다. DOMAIN-SUFFIX는 도메인 접미사를, IP-CIDR은 IP 주소 대역을 기준으로 일치시킵니다. FINAL은 앞선 규칙에 모두 해당하지 않을 때 적용하는 기본 규칙입니다. DIRECT는 직접 연결, PROXY는 프록시 정책을 뜻합니다. 규칙을 확인할 때 대상 도메인이 있는지만 보지 말고, 그보다 위에 있는 더 포괄적인 규칙이 먼저 일치하는지도 살펴보세요.
이 가이드에서는 규칙을 새로 구성할 필요가 없습니다. 신뢰할 수 있는 기존 구성이 있다면 선택 상태와 규칙 내용만 확인하세요. 서버 정보만 있고 구성이 올바른지 판단하기 어렵다면 Proxy(프록시)로 연결을 한 번 비교해 볼 수 있습니다. 확인 후 Config(구성)로 돌아가세요. 서버, 규칙, DNS를 한꺼번에 바꾸면 접속 결과가 달라져도 어느 변경이 영향을 줬는지 판단하기 어렵습니다. 규칙 키워드의 간단한 설명은 용어집에서 확인할 수 있습니다.
Home에서 연결 켜기
03 / connect모드를 선택한 뒤 Home으로 돌아가 SERVER 그룹에서 사용할 서버를 선택합니다. 선택 표시가 원하는 항목에 있는지 확인한 다음 Global Routing에 표시된 현재 값을 살펴봅니다. 구독에 항목이 여러 개 있다면 가져오기에 성공했더라도 방금 추가한 항목이 선택되어 있다는 보장은 없습니다. 연결 전에 확인하면 이전 항목을 잘못 사용하는 일을 막을 수 있습니다.
페이지 상단의 Not Connected(연결 안 됨) 옆 스위치를 켭니다. 처음 사용할 때는 시스템에서 VPN 구성 추가 권한을 요청할 수 있습니다. 요청한 앱이 Shadowrocket인지 확인하고 허용을 선택한 다음, 시스템 안내에 따라 암호나 기기 인증을 완료하세요. 이 절차는 시스템이 로컬 네트워크 연결을 처리하도록 설정하는 과정이며 서버 계정 정보를 입력하는 것과는 다릅니다. 시스템 암호를 서버의 Password 필드에 입력하지 마세요.
앱으로 돌아가 상단 상태가 바뀔 때까지 기다립니다. 앞서 권한 요청을 거부했다면 스위치가 켜진 상태로 유지되지 않을 수 있습니다. 이 경우 다시 연결을 시도하고 시스템 안내에 따라 VPN 구성 권한을 확인하세요. 권한 문제를 해결하려고 구독을 반복해서 가져오지 마세요. 조직에서 관리하는 기기에서 VPN 구성이 제한되어 있다면 서버 필드를 계속 바꾸기보다 기기 관리 정책을 먼저 확인하세요.
스위치가 켜지고 시스템에 VPN 상태가 표시되는 것은 로컬 네트워크 연결 처리가 시작됐다는 뜻일 뿐입니다. 원격 서버에 접속할 수 있는지 또는 모든 규칙이 예상대로 적용되는지를 단독으로 증명하지는 않습니다. 비밀번호가 틀리거나 대상 서비스에 연결할 수 없어도 로컬 상태와 실제 접속 결과가 다를 수 있습니다. 서버와 모드는 그대로 둔 채 다음 단계에서 확인하고, 재현 가능한 결과를 먼저 기록하세요.
연결을 중지하려면 Home으로 돌아가 상단 스위치를 끄고 상태가 연결 안 됨으로 바뀌는지 확인합니다. 처음 문제를 확인하는 동안에는 On Demand(요청 시 연결)를 켤 필요가 없습니다. 이미 활성화되어 있다면 네트워크 조건에 따라 연결이 다시 시작되는지 살펴보세요. 연결 스위치, 선택한 서버, 모드를 명확히 유지하면 여러 항목을 반복해서 바꾸는 것보다 문제를 쉽게 찾을 수 있습니다.
연결 테스트와 작동 확인
04 / check먼저 Home에서 Connectivity Test(연결 테스트)를 실행해 현재 항목이 응답하는지 확인합니다. 테스트 결과는 Settings의 Test Method(테스트 방법)에 따라 달라지며, 방법마다 확인 대상과 네트워크 계층이 다릅니다. 따라서 응답이 있다고 웹페이지가 완전히 열린다는 뜻은 아니며, 응답이 없다고 서버의 모든 기능을 사용할 수 없다는 뜻도 아닙니다. 결과를 기록한 뒤 실제 접속 결과와 함께 판단하세요.
연결 가능 여부와 규칙 적용 여부를 따로 확인하기
브라우저를 열고 평소 이용하려던 주소가 명확한 페이지에 접속해 제대로 로드되는지 확인합니다. 이어서 직접 연결될 것으로 예상되는 페이지에도 접속해 일반 네트워크가 정상인지 살펴봅니다. 테스트할 때는 캐시된 화면만 보고 판단하지 않도록 새 페이지 요청을 이용하세요. 특정 앱에서만 문제가 발생한다면 전체 연결이 불가능하다고 단정하기 전에 브라우저 접속 결과를 확인합니다.
그다음 Shadowrocket으로 돌아가 Data(데이터 기록)를 열고 이번 요청에 해당하는 연결 정보를 확인합니다. 확인 가능한 요청 상세 정보에서 대상, 규칙, 처리 정책을 살펴봅니다. Config(구성)를 사용한다면 직접 연결할 것으로 예상한 요청은 DIRECT로, 프록시를 사용할 요청은 해당 프록시 정책으로 처리되어야 합니다. 페이지가 열린다는 것은 사용 가능한 경로가 하나 있다는 뜻일 뿐, 규칙이 올바르게 적용됐다는 확인을 대신하지 않습니다.
비교가 필요하다면 같은 서버를 유지한 채 Config(구성)와 Proxy(프록시)를 잠시 비교합니다. Proxy는 되지만 Config에서 문제가 생긴다면 현재 구성과 규칙 우선순위를 먼저 확인합니다. 둘 다 실패한다면 서버 정보, 로컬 네트워크, 원격 서버 상태를 차례로 살펴봅니다. 테스트가 끝나면 평소 사용할 모드로 되돌리세요. 문제를 확인하는 동안 임시로 선택한 모드를 최종 설정으로 두지 마세요.
서버를 사용할 수 있고 대상 페이지에 정상적으로 접속되며 규칙 처리도 예상과 일치하면 첫 설정이 완료된 것입니다. 현재 작동하는 설정을 유지한 채 On Demand나 더 세밀한 규칙 분기를 차례로 살펴보세요. 최적의 설정을 찾겠다며 고급 옵션을 한꺼번에 여러 개 바꾸지 마세요. 이후 설정을 변경하기 전에 복구 가능한 구성 사본을 보관하고 연결 인증 정보를 안전하게 관리하세요.
문제가 발생한 단계별로 하나씩 확인하기
05 / diagnose먼저 문제를 가져오기, 연결, 접속, 규칙의 네 단계 중 하나로 구분한 뒤 해당 조건을 확인하세요. 저장 실패, SERVER 목록이 비어 있음, 스위치를 켤 수 없음, 페이지 로드 실패는 서로 다른 문제입니다. 처음부터 모든 구성을 삭제하거나 설정을 초기화하지 말고 오류 문구를 보관하세요. 그러면 비교에 필요한 정보를 잃을 수 있고, 원래 사용할 수 있던 항목까지 사라질 수 있습니다.
가져오기 실패 또는 목록이 비어 있음
구독 설정으로 돌아가 전체 URL이 맞는지, 일반 웹페이지 주소를 잘못 사용하지 않았는지, 복사 과정에서 매개변수가 빠지지 않았는지 확인하세요. 현재 네트워크에서 구독 주소에 접속할 수 있는지 확인하고 본인의 서비스 제공자에게 구독 상태를 문의합니다. 로그인 페이지, 오류 안내, 지원되지 않는 내용이 반환된다면 업데이트를 반복해도 유효한 구성으로 바뀌지 않습니다. 구독 메모를 유지하고 오류 안내를 기록하되 인증 정보가 포함된 링크를 공개적으로 보내지 마세요.
테스트 실패 또는 연결 후 접속할 수 없음
수동으로 추가한 항목은 Type, Host, Port와 인증 정보를 먼저 확인한 다음 TLS와 전송 방식 등 추가 설정이 빠짐없이 입력되었는지 살펴봅니다. 로컬 네트워크에서 일반 페이지에도 접속할 수 없다면 먼저 Wi-Fi 또는 모바일 네트워크 문제를 해결하세요. 이후 같은 항목과 모드를 유지한 채 네트워크를 바꿔 비교할 수 있습니다. 연결 테스트는 성공했지만 웹페이지가 열리지 않는다면 도메인 확인과 대상 서비스 상태도 점검해야 합니다. 테스트 수치 하나만 보고 판단하지 마세요.
일부 페이지만 문제가 있거나 모드를 바꾼 뒤 결과가 달라짐
먼저 Global Routing이 Direct(직접 연결)에 머물러 있지 않은지 확인한 뒤 Config에서 실제 활성화된 구성 파일을 확인하세요. Config(구성)에서 특정 대상에 문제가 있지만 Proxy(프록시)에서는 정상이라면 해당 요청에 어떤 Rule이 적용됐는지 살펴봅니다. 구체적인 도메인 규칙은 먼저 적용될 수 있는 포괄적인 규칙보다 위에 두어야 합니다. FINAL은 일반적으로 마지막 기본 규칙으로 사용합니다. 규칙 전체를 삭제하지 말고 실제로 적용된 항목부터 확인한 뒤 필요한 부분만 조정하세요.
Settings에서는 증상과 관련된 항목만 확인
Settings(설정)에서 Test Method를 확인해 Connectivity Test가 어떤 방식으로 테스트하는지 살펴볼 수 있습니다. On Demand가 현재 네트워크 조건에서 연결을 시작했는지도 확인하세요. 추가 단서가 필요할 때 Diagnostics(진단)를 사용합니다. 스크린샷의 Proxy, TCP, UDP는 서로 다른 설정 그룹이며 문제가 생겼다고 모두 변경해야 하는 스위치가 아닙니다. 조정 전 기존 값을 기록하고 변경 후 바로 다시 테스트하세요. 예상과 다르면 원래 값으로 되돌립니다.
문제가 계속되면 발생 시각, 네트워크 종류, 선택한 프로토콜, 현재 모드와 구체적인 오류 내용을 정리해 본인의 서비스 제공자에게 서버 측 상태를 문의하세요. 스크린샷이나 진단 내용을 공유하기 전에는 구독 URL, 비밀번호, 인증 정보와 기타 개인정보를 가려야 합니다. 다른 증상은 자주 묻는 질문에서 유형별로 확인하세요. 프로토콜 설정값의 의미와 선택 기준은 프로토콜 해설을 참고하세요. 처음 설정하는 단계에서 전체 기술 설정을 다룰 필요는 없습니다.
다른 기기와 다운로드 경로
get위의 화면 안내는 iPhone·iPad를 기준으로 합니다. Shadowrocket은 Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전도 제공합니다. iPhone·iPad 버전은 App Store에서 $2.99를 한 번 결제하며, Mac·Windows·Android·Linux 버전은 무료입니다. 설치 파일은 이 사이트의 다운로드 페이지에서 받을 수 있으며, 주소는 사이트 내 /dl/shadowrocket/ 경로입니다.
현재 버전 불러오는 중 · iPhone·iPad $2.99 일회성 결제, 다른 플랫폼 무료
iPhone·iPad 앱 정보를 다시 확인하려면 다운로드 페이지의 정품 확인을 참고하세요. 개발자는 Shadow Launch Technology Limited, 앱 ID는 932747118이며 아이콘은 공식 스토어에 표시된 이미지를 기준으로 합니다.