공식 매뉴얼 · Shadowrocket Q&A
모든 플랫폼을 위한 규칙 기반 프록시 클라이언트의 다운로드와 설정, 규칙 라우팅을 문답으로 확인하세요. iPhone / iPad 버전은 App Store에서 $2.99 일회성 구매하며, Mac, Windows, Android, Linux 버전은 무료입니다.
현재 버전 v2.2.92 · Mac, Windows, Android, Linux 버전 무료
처음 사용하시나요? 시작 가이드 보기 →
Shadowrocket의 연결 스위치, 서버 정보와 라우팅 규칙은 서로 다른 설정입니다. 한 번에 여러 항목을 바꾸기보다 하나씩 확인하면 문제를 찾기 쉽습니다.
먼저 사용 중인 구독 링크나 본인이 이용하는 서비스 제공업체가 제공한 서버 매개변수를 준비하세요. 클라이언트는 해당 정보를 읽어 연결을 설정하며, 앱을 설치한다고 사용할 수 있는 서버가 자동으로 생성되지는 않습니다. 직접 입력할 때는 Type, Host, Port와 해당 인증 필드를 하나씩 확인하세요. 웹사이트 로그인 비밀번호를 연결 매개변수로 사용하지 마세요.
구독에 여러 항목이 포함될 수 있지만, 목록에 표시되는 것은 가져오기가 완료되었다는 뜻일 뿐입니다. 실제 연결 가능 여부는 서비스 상태, 프로토콜 매개변수와 현재 네트워크에 따라 달라집니다. 문제를 확인할 때는 먼저 항목 하나와 네트워크 하나를 고정하고, 현상을 기록한 다음 조건을 바꿔 보세요.
처음 사용하는 경우 다운로드 페이지에서 기기를 선택한 다음 시작 가이드에 따라 정보를 가져오고 VPN 설정을 허용하세요. 이미 연결할 수 있다면 Global Routing과 Config 안내를 바로 확인해 요청이 PROXY, DIRECT 또는 REJECT를 사용하는 이유를 살펴볼 수 있습니다.
위의 공식 Home 화면은 연결 스위치, Global Routing, Add Server의 위치를 보여줍니다. 현재 기기의 연결 상태를 나타내는 것은 아닙니다. 실제 규칙은 자신의 설정에 맞춰 확인하고, 앞쪽의 포괄적인 규칙이 뒤쪽의 구체적인 조건을 먼저 적용하지 않는지 주의하세요.
실제 질문에서 해당 설정을 찾아보세요. 아래 설명은 iPhone / iPad 화면에 표시되는 용어를 기준으로 하며, 다른 플랫폼에서는 앱에 표시되는 위치를 확인하세요.
Global Routing에서 Config를 선택하면 현재 구성의 규칙에 따라 요청이 라우팅됩니다. Config에서 현재 사용 중인 파일을 확인한 다음 Rule의 순서를 점검하세요. 일반적으로 구체적인 도메인 조건을 포괄적인 조건보다 앞에 두고, FINAL은 일치하지 않은 요청을 처리하도록 맨 마지막에 둡니다. PROXY는 프록시 정책을 사용하고, DIRECT는 직접 연결하며, REJECT는 요청을 거부합니다. Global Routing의 Proxy와 Direct는 전체 처리 방식을 전환합니다. 구성에서 규칙을 하나씩 매칭하는 방식과 혼동하지 마세요.
현재 파일과 Global Routing 옵션을 기록하고 요청 하나를 사용해 동작을 확인한 다음 적용된 정책을 살펴보세요. 관련 규칙의 순서만 조정하고 서버와 구성을 동시에 바꾸지 마세요. 변경 사항 중 무엇이 영향을 주었는지 판단하기 어렵습니다.
DOMAIN-SUFFIX,example.com,PROXYFINAL,PROXYOn Demand는 설정한 조건에 따라 연결을 시작하는 기능이며 서버 매개변수를 복구하지는 않습니다. Settings에서 On Demand를 확인하고 앱에 표시되는 조건을 설정하세요. 먼저 수동 연결과 접속을 테스트한 다음 자동 연결을 활성화하는 것이 좋습니다. 수동 연결 자체가 실패한다면 자동으로 연결을 시작해도 같은 매개변수를 점검해야 합니다. 연결이 끊긴 상태를 확인할 때도 On Demand가 계속 작동 중인지 살펴보세요. 조건에 따른 재연결을 스위치 오작동으로 오해할 수 있습니다.
먼저 자동 연결을 끄고 수동으로 한 번 테스트해 선택한 서버와 규칙이 작동하는지 확인한 다음 필요한 조건을 다시 설정하세요. 네트워크를 바꾼 후 실제 동작을 확인하고, 자동 연결이 시작되었다는 사실만으로 대상에 접속할 수 있다고 판단하지 마세요.
Shadowrocket은 Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등의 프로토콜을 지원합니다. 직접 추가할 때는 Add Server에서 서버 측과 일치하는 Type을 선택한 다음 해당 유형에 필요한 필드를 입력하세요. 프로토콜 이름이 같더라도 모든 매개변수를 공통으로 사용할 수 있는 것은 아닙니다. 전송 방식, 인증 정보와 TLS 설정을 각각 확인해야 합니다. 기존 구독이 있다면 원래 정보대로 가져오는 것이 좋습니다. 다른 프로토콜을 시험하려고 Type만 변경하지 마세요. 연결 가능 여부는 클라이언트와 서버의 매개변수가 일치하는지에 달려 있습니다.
서비스 제공업체가 안내한 필드를 Add Server와 대조하세요. QR 코드는 매개변수를 전달하는 한 가지 방법일 뿐입니다. Scan QR Code를 사용한 후에도 가져온 결과를 확인하고, 특히 Host와 인증 필드가 누락되지 않았는지 살펴보세요.
구독 링크는 본인이 이용하는 서비스 제공업체에서 받아야 합니다. 가져온 후 SERVER 목록을 확인하세요. 추가 화면에서 Subscribe를 선택하고 기존 링크를 입력해 저장한 다음 업데이트하세요. 가져오기에 실패하면 계정 웹페이지 주소가 아닌 구독 주소를 복사했는지 확인하고, 주소 전체가 복사되었는지, 서비스가 유효한지, 현재 네트워크에서 업데이트 주소에 접속할 수 있는지도 살펴보세요. 구독 업데이트와 Config 업데이트는 별개의 작업입니다. 전자는 서버 항목을 관리하고 후자는 요청 처리 규칙을 관리하므로, 한쪽이 완료되었다고 다른 쪽도 올바르다는 뜻은 아닙니다.
복사한 내용 앞뒤에 공백이나 줄바꿈이 포함되지 않았는지 확인하세요. 업데이트 오류가 표시되면 문제 해결에 참고할 수 있도록 오류 유형을 기록하되, 공개 스크린샷이나 문의 내용에 전체 구독 링크를 노출하지 마세요.
Config에서 구성 파일을 확인, 편집, 선택할 수 있습니다. 파일을 저장한 후에는 현재 선택된 항목도 확인해야 합니다. 규칙을 편집하려면 Rule과 Add Rule부터 확인하고 규칙 유형, 매칭 내용과 정책을 살펴보세요. 수정 전에 원본 파일을 보관하세요. 수정 후 Global Routing이 Config로 설정되어 있는지 확인하지 않으면 규칙 변경이 요청에 예상대로 적용되지 않을 수 있습니다. iCloud 동기화를 사용하는 경우 기기의 파일과 선택된 상태도 확인하세요. 파일이 동기화되었다고 서버 매개변수, 연결 상태 또는 다른 기기의 설정까지 일치하는 것은 아닙니다.
정상 작동하는 원본 구성을 보관하고 필요한 부분만 수정하세요. 복원할 때는 원본 파일을 다시 선택하고 모드를 확인하세요. 파일 이름만 보고 현재 적용 중인 내용을 판단하지 마세요.
먼저 Connectivity Test로 선택된 항목을 확인한 다음 실제 요청과 Diagnostics를 함께 살펴보며 실패 단계를 찾으세요. 테스트 결과는 Test Method와 현재 네트워크의 영향을 받으므로, 테스트 한 번만으로 모든 웹사이트나 프로토콜을 사용할 수 있는지 판단할 수 없습니다. 연결 스위치가 켜져 있어도 대상에 접속할 수 없다면 Global Routing, 적용된 규칙, DNS와 서비스 상태를 계속 확인하세요. Data에서 트래픽 변화를 확인할 수 있지만 트래픽이 있다는 사실이 특정 대상에 접속되었다는 뜻은 아닙니다. 대상 요청의 실제 결과를 기준으로 확인하세요.
서버와 구성을 고정하고 현재 네트워크와 다른 사용 가능한 네트워크에서 각각 확인하세요. 구독 업데이트, VPN 연결 또는 대상 접속 중 어느 단계에서 실패하는지 기록한 다음 해당 단계에 맞춰 해결하세요. 구성 전체를 반복해서 삭제하지 마세요.
다운로드 방법은 2가지입니다. iPhone / iPad 버전은 App Store에서 $2.99에 일회성 구매하며, Mac, Windows, Android, Linux 버전은 무료입니다. 설치 파일은 이 사이트의 다운로드 페이지에서 제공합니다.
App Store 제품 페이지에서 다운로드하세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 구매 전에 계정의 스토어 지역을 확인하세요. 호환되는 iPhone과 iPad에서는 동일한 구매 계정으로 구매 항목을 복원할 수 있으므로 기기를 바꿀 때 새로 구매할 필요는 없습니다.
iPhone / iPad 다운로드 안내 →먼저 ‘이 Mac에 관하여’에서 칩을 확인한 다음 해당 dmg를 선택하세요. 다운로드 페이지에는 Apple 칩과 Intel용 버튼이 각각 표시됩니다. 처음 실행할 때 시스템 알림이 나타나면 설치 허용 안내에 따라 출처를 확인하고 처리하세요. 브라우저의 기기 감지 결과만으로 칩을 추측할 필요는 없습니다.
Mac 다운로드 보기 →다운로드 페이지에서 이 사이트가 제공하는 exe를 받으세요. 처음 실행할 때 SmartScreen 알림이 표시되면 파일이 이 사이트에서 제공되었는지 확인한 다음 ‘자세한 정보 → 실행’을 선택하세요. 조직에서 관리하는 기기라면 관리자가 설정한 설치 정책을 따라야 합니다.
Windows 다운로드 보기 →이 사이트의 다운로드 페이지에서 apk를 받으세요. 시스템 안내에 따라 설치를 시작한 브라우저에 ‘알 수 없는 앱 설치’를 허용하세요. WeChat 내장 브라우저에서 다운로드할 수 없다면 시스템 브라우저로 다운로드 페이지를 여세요. 설치가 끝난 후 필요에 따라 임시로 허용한 권한을 해제할 수 있습니다.
Android 다운로드 보기 →배포판의 패키지 관리 방식에 맞는 형식을 선택하세요. deb와 rpm은 해당 패키지 관리자로 설치하고, AppImage는 먼저 실행 권한을 추가해야 합니다. 다운로드 페이지에서 형식과 설치 방법을 확인하세요. 명령을 실행하기 전에 다운로드 파일의 위치와 실제 이름을 확인하세요.
Linux 다운로드 보기 →컴퓨터와 Android용 설치 파일은 이 사이트의 /dl/shadowrocket/에서 제공합니다. 업데이트하려면 다운로드 페이지에서 현재 파일을 다시 받으세요. iPhone / iPad 버전은 App Store에서 업데이트합니다. 설치 권한과 VPN 연결 권한은 별개의 단계입니다. 설치 후에도 첫 사용 안내에 따라 연결 권한을 확인하세요.
모든 플랫폼 보기 →아래 미리보기는 iPhone / iPad를 기준으로 합니다. 먼저 수동 연결을 완료한 뒤 자동 실행, 동기화 또는 복잡한 규칙 조정을 진행하세요.
Home의 추가 메뉴에서 기존 정보를 입력하세요. 서버 항목은 Type에 맞춰 필드를 입력하고, 기존 구독은 Subscribe를 사용해 가져온 다음 업데이트하세요. 저장 후 SERVER로 돌아가 항목을 확인하고 테스트할 서버를 선택하세요. 가져오기 성공과 연결 성공을 혼동하지 마세요.
QR 코드를 사용하는 경우 먼저 본인이 이용하는 서비스 제공업체에서 받은 내용인지 확인한 다음 Scan QR Code로 읽으세요. 가져온 후에도 필드를 확인하고 공개 이미지에 구독 주소나 인증 정보가 노출되지 않도록 주의하세요.
규칙에 따라 라우팅하려면 Config를 선택한 다음 Config에서 현재 구성 파일을 확인하세요. Proxy와 Direct는 전체 요청 처리 방식입니다. 용도를 이해한 뒤 점검에 사용하세요. 특정 대상에 접속할 수 없다는 이유만으로 모드를 계속 전환하면서 개별 규칙을 확인하지 않는 것은 피하세요.
첫 테스트는 구성을 가능한 한 단순하게 유지하세요. 선택한 서버에 연결할 수 있는지 먼저 확인한 다음 라우팅 결과를 점검하세요. 복잡한 구성을 가져오고 서버를 바꾸고 DNS까지 조정하면 문제의 원인을 찾기 어렵습니다.
처음 연결할 때는 시스템 안내에 따라 VPN 구성을 추가하도록 허용하세요. 권한을 허용한 뒤 Home으로 돌아와 연결 상태를 확인하고 Connectivity Test를 실행한 다음 실제로 확인할 대상에 접속해 요청이 예상대로 처리되는지 확인하세요.
연결 스위치가 켜져 있어도 모든 요청이 프록시를 사용하는 것은 아닙니다. 결과가 예상과 다르면 먼저 Global Routing과 규칙 정책을 확인한 다음 서비스 상태를 점검하세요. 문제 발생 단계를 기록해 두면 앱을 반복해서 다시 설치하는 것보다 해결에 도움이 됩니다.
Shadowrocket은 폐쇄형 상용 앱입니다. iPhone / iPad에서는 스토어 제품 정보를 확인하고, 다른 플랫폼에서는 이 사이트의 다운로드 페이지에서 해당 설치 파일을 받으세요.
App Store 제품 페이지에서 앱 이름이 Shadowrocket이고 개발자가 Shadow Launch Technology Limited인지 확인한 다음, 링크의 앱 ID 932747118을 확인하세요. 공식 아이콘은 이 사이트의 페이지 상단 아이콘과 대조할 수 있습니다. 검색 결과에 나온 이름이나 비슷한 모양만으로 판단하지 말고 세 가지 정보가 같은 제품을 가리키는지 확인하세요.
이 사이트는 Shadowrocket 공식 웹사이트 및 매뉴얼입니다. 다운로드 안내에서는 스토어 표시 여부, 구매와 복원 방법을 나누어 설명합니다. 컴퓨터와 Android 사용자는 이 사이트의 다운로드 페이지에서 기기에 맞는 설치 파일을 선택하세요. iPhone / iPad 스토어 구매 절차를 적용할 필요는 없습니다.
App Store는 계정에 설정된 국가 또는 지역에 따라 앱을 표시합니다. 중국 본토 스토어에서는 현재 Shadowrocket을 검색해 다운로드할 수 없습니다. 기기 언어, 시스템 지역과 스토어 계정 지역은 서로 다른 설정입니다. 기기 언어만 바꿔도 계정에 연결된 스토어 목록은 달라지지 않습니다.
계정 설정에서 ‘미디어 및 구입 항목’에 연결된 계정을 확인한 다음 ‘국가 또는 지역’을 확인하세요. 지역 변경 가능 여부는 계정 잔액, 유효한 구독과 결제 정보 등의 조건에 따라 달라지므로 계정 페이지의 안내를 따르세요. 확인 순서는 다운로드 안내에서 볼 수 있습니다. 검색되지 않는다는 이유만으로 기기가 지원되지 않는다고 판단하지 마세요.
iPhone / iPad 버전은 미국 App Store에서 $2.99에 일회성 구매하며, 다른 스토어에서는 현지 통화로 표시됩니다. Mac, Windows, Android, Linux 버전은 무료입니다. iPhone과 iPad에서는 동일한 구매 계정으로 구매 항목을 공유할 수 있습니다. 기기를 바꾸거나 다시 설치할 때는 먼저 App Store의 구입 항목에서 앱을 찾고 기기 호환성을 확인하세요.
페이지에 구매 가격이 다시 표시되면 결제를 반복하기 전에 현재 ‘미디어 및 구입 항목’ 계정이 원래 구매한 계정과 같은지 확인하세요. 가족 공유의 적용 여부와 구성원의 다운로드 조건은 제품 페이지와 가족 설정에서 확인해야 합니다. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다.
iPhone / iPad 앱은 App Store에서 업데이트합니다. Mac, Windows, Android, Linux 사용자는 이 사이트의 다운로드 페이지에서 현재 설치 파일을 다시 받으세요. 앱 업데이트는 클라이언트 자체를 변경하고, Subscribe 업데이트는 기존 서버 목록을 변경하며, Config 업데이트는 라우팅 규칙을 변경할 수 있습니다. 세 작업은 서로 다른 대상을 다룹니다.
업데이트 전에 필요한 구성 정보를 보관하세요. 문제가 생기면 먼저 방금 업데이트한 항목을 확인하고 변경 전후의 차이를 비교하세요. 서버가 작동하지 않는 원인을 앱 업데이트로 바로 단정하지 말고, 현재 구성 파일과 Global Routing을 확인하지 않은 채 구독을 다시 가져오는 것으로 대신하지 마세요.
구독 업데이트 성공은 목록을 읽었다는 뜻일 뿐 목록의 모든 서버를 사용할 수 있다는 뜻은 아닙니다. 먼저 SERVER에서 현재 선택된 항목을 확인하고 Connectivity Test를 실행한 다음 서비스 상태, 인증 매개변수와 현재 네트워크를 점검하세요. 항목에 연결할 수 있지만 대상에 접속할 수 없다면 Global Routing과 규칙 매칭 결과를 확인하세요.
단계별 연결 문제 해결구성 규칙에 따라 라우팅하려면 Config를 선택하세요. Proxy와 Direct는 전체 요청을 프록시 또는 직접 연결 방식으로 처리합니다. 어떤 항목을 사용할지는 확인하려는 대상에 따라 달라지므로 전환 후 대상 요청을 다시 실행하세요. Config 모드에서 DIRECT가 표시되더라도 클라이언트가 작동하지 않는다는 뜻은 아닙니다. 요청이 정상적으로 직접 연결 정책에 일치했을 수 있습니다.
모드 안내 보기먼저 On Demand 조건과 시스템 VPN 상태를 확인하세요. 조건에 해당하면 자동 연결이 다시 시작될 수 있으며, 서버를 사용할 수 없거나 네트워크가 바뀌어도 연결에 영향을 줄 수 있습니다. 자동 연결을 일시적으로 끄고 수동으로 테스트하면 자동 실행 문제와 서버 연결 문제를 구분하는 데 도움이 됩니다.
첫 연결 과정 보기편집한 파일이 현재 선택된 Config인지 확인하고 Global Routing이 Config인지 점검하세요. 그런 다음 규칙 목록 위에서부터 더 앞선 조건에 먼저 일치하는지 확인하세요. 수정 내용을 저장한 뒤 요청을 다시 실행하세요. 기존 연결의 동작으로 새 규칙의 적용 여부를 판단하지 마세요. 필요한 경우 원본 파일을 복원해 비교하세요.
구성 점검 방법 보기기본 절차 외의 문제는 주제별 안내를 확인하세요. 아래 글에서는 Linux 설치, REJECT 규칙과 첫 연결 화면을 각각 설명합니다.
Linux 버전은 무료입니다. 배포판에 맞는 패키지 형식을 선택하고 apt, dnf 설치와 AppImage 실행 권한 추가 방법을 확인하세요. 실행 전에 다운로드 위치와 파일 이름을 확인하세요. 의존성 문제가 발생하면 패키지 관리자의 안내를 기록하고 서로 다른 배포판의 설치 방법을 섞어 사용하지 마세요.
설치 안내 읽기 →REJECT는 규칙에 일치한 요청을 거부합니다. DOMAIN-SUFFIX, DOMAIN-KEYWORD와 정책을 조합하는 방법, 규칙 위치에 따라 결과가 달라지는 이유를 설명합니다. 규칙은 요청 조건에 따라 매칭되며 페이지 내용을 임의로 수정하는 기능이 아닙니다.
규칙 안내 읽기 →Not Connected 스위치부터 Global Routing, Connectivity Test와 SERVER 목록의 역할을 구분해 살펴봅니다. 첫 연결 순서에 따라 권한, 선택된 항목과 테스트 결과를 확인하고 각 단계가 끝난 뒤 무엇을 점검해야 하는지 알아보세요.
화면 안내 읽기 →