공식 매뉴얼 · 다운로드 및 설정
모든 플랫폼에서 사용할 수 있는 규칙 기반 프록시 클라이언트로, 기존 서버 정보를 이용해 규칙 라우팅을 설정합니다. iPhone/iPad는 App Store에서 $2.99 일회성 구매하며, Mac·Windows·Android·Linux 버전은 무료입니다.
현재 버전 v2.2.92 · iPhone/iPad $2.99 일회성 구매, Mac·Windows·Android·Linux 버전은 무료입니다.
Settings 설정 참고
인터페이스 용어로 설정값 찾기
CONFIGURATION / CAPABILITIES
서버, 구독, 구성 파일을 구분한 다음 트래픽 처리 방식을 정합니다. 아래에서는 자주 쓰는 인터페이스 용어를 기준으로 각 기능의 목적을 설명합니다. 세부 옵션 위치는 현재 클라이언트 화면을 확인하세요.
Home의 Global Routing에서 Config는 현재 구성 파일의 규칙을 차례로 매칭하고, Proxy는 프록시를 사용할 수 있는 요청을 선택한 서버로 전달하며, Direct는 직접 연결합니다. 평소 규칙에 따라 사용할 때는 먼저 Config를 선택하고 활성화된 구성 및 최종 정책을 확인하세요. 규칙은 일반적으로 위에서부터 매칭되므로 구체적인 항목을 포괄적인 항목보다 앞에 둡니다. PROXY, DIRECT, REJECT는 규칙 동작이며 상단 모드 이름과는 다릅니다. 문제를 확인할 때는 동일한 대상으로 모드를 잠시 전환해 비교한 뒤 원래 설정으로 복구하세요. 일시적인 결과를 장기 설정으로 오해하지 않도록 주의합니다.
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECTOn Demand는 네트워크 조건에 따라 연결 동작을 제어하며, Settings에서 설정할 수 있습니다. 먼저 수동으로 연결해 기존 서버가 정상 작동하는지 확인한 다음, 연결을 트리거하거나 제외할 네트워크 조건을 설정하세요. 한 번에 한 항목씩 변경하고 Wi-Fi와 모바일 네트워크를 전환해 결과를 확인합니다. 이 기능은 연결 시점을 제어할 뿐 Global Routing 규칙을 대체하지 않으며, 만료된 구독이나 잘못된 서버 매개변수를 해결하지도 않습니다. 연결을 끊은 뒤 다시 자동 연결되면 On Demand가 계속 활성화되어 있는지 확인하세요. 자동 트리거를 중지하려면 해당 조건을 먼저 비활성화한 뒤 수동으로 연결을 해제합니다.
Settings
On Demand
Global Routing → ConfigShadowrocket은 Shadowsocks, VMess, VLESS, Trojan, Hysteria2 등의 프로토콜을 지원합니다. 직접 입력할 때는 Add Server의 Type부터 시작해 사용자가 보유한 서버 정보에 따라 Host, Port 및 인증 필드를 입력하고 TLS, 전송 방식 등의 추가 매개변수를 확인하세요. 프로토콜 이름이 같아도 다른 매개변수를 바꿔 쓸 수 있는 것은 아닙니다. 가져오기에 성공했다고 연결 검증이 완료된 것도 아닙니다. 기존 서버의 전체 공유 정보를 우선 사용하고, 연결 실패 시 항목별로 확인하세요. 경험만으로 암호화 방식을 바꾸거나 검증을 임의로 끄지 마세요. 정확한 값은 서버 설정과 일치해야 합니다.
Add Server
Type → VMess
Host → example.comSubscribe는 사용자가 보유한 구독 주소를 저장하고 해당 주소를 통해 서버 목록을 업데이트하는 기능입니다. 가져오기 전에 전체 링크를 복사했는지 확인하고 공백, 줄바꿈, 설명 문구가 섞이지 않도록 하세요. 주소에 포함된 인증 정보는 개인 자격 증명으로 안전하게 보관해야 합니다. 업데이트에 실패하면 현재 네트워크에서 구독 주소에 접근할 수 있는지 확인한 다음 링크가 유효한지 점검하세요. 같은 항목을 반복해서 추가하지 마세요. 구독 업데이트는 주로 목록 내용을 변경하며 현재 선택된 서버나 Config가 자동으로 적합해진다는 의미는 아닙니다. 업데이트 후 선택된 항목을 다시 확인하고 Connectivity Test를 실행한 다음 실제 요청을 검증하세요.
Subscribe
Update
Connectivity TestConfig에는 규칙과 관련 네트워크 설정이 저장되고, 서버 목록에는 연결에 필요한 매개변수가 저장됩니다. 두 항목의 용도는 서로 다릅니다. 편집하기 전에 정상 작동하는 사본을 보관하고 General, Rule, Hosts 등의 섹션을 확인해 문제와 관련된 항목만 변경하세요. 새 규칙은 매칭 순서와 최종 정책을 함께 확인하고 저장 후 해당 파일이 활성화되었는지도 확인해야 합니다. iPhone과 iPad에서 iCloud 동기화를 사용하는 경우 기기의 로그인 상태와 동기화 옵션을 확인한 뒤 파일이 대상 기기에 완전히 도착했는지 점검하세요. 동기화는 즉시 연결 테스트가 아니며 수정 전 백업을 대신할 수 없습니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
FINAL,DIRECTConnectivity Test는 서버 테스트 결과를 확인하고, Data는 트래픽 통계를 확인하는 데 사용합니다. Settings의 Diagnostics와 Log는 개별 요청의 원인을 찾는 데 도움이 됩니다. 테스트 수치는 테스트 방법과 대상에 영향을 받으므로 실제 앱 사용 경험을 그대로 대신할 수 없습니다. 문제가 발생한 대상과 시간을 기록한 다음 예상 규칙이 적용되었는지, 어떤 정책을 사용했는지, 이름 확인 또는 연결 오류가 발생했는지 살펴보세요. Data 누적값은 통계 범위와 초기화 시점을 함께 고려해 해석해야 합니다. 문제 기록을 다른 사람에게 전달하기 전에 구독 주소, 인증 필드 및 기타 개인정보를 가리세요.
Connectivity Test
Data
Settings → Diagnostics실제 설정에서는 “기존 서버 연결 여부 → 현재 구성 활성화 여부 → 규칙 매칭 여부 → DNS가 네트워크 환경에 적합한지” 순서로 확인하는 것이 좋습니다. 모든 스위치를 한꺼번에 바꾸면 변경 전후를 비교하기 어렵습니다. 정상 작동하는 구성을 하나 보관하고 매번 변수 하나만 변경해야 어떤 설정이 영향을 주었는지 파악할 수 있습니다.
Settings 설정 항목별 참고 →GET / PLATFORMS
다운로드 방식은 두 가지입니다. iPhone/iPad는 App Store에서 $2.99 일회성 구매하며, Mac·Windows·Android·Linux 버전은 무료입니다. 아래 링크는 모두 다운로드 페이지로 이동합니다. 설치 전에 기기와 시스템 유형을 확인하세요.
App Store $2.99 일회성 구매, 기타 플랫폼 무료.iPhone과 iPad는 구매 기록을 공유할 수 있으며, 시스템 요구 사항은 App Store 페이지에 표시된 내용을 따릅니다. 다운로드 전에 제품 페이지의 개발자, 아이콘, 앱 ID를 확인하세요. 기기를 변경할 때는 기존 구매 계정의 구입 항목을 먼저 확인합니다.
처음 연결할 때 시스템 안내에 따라 VPN 구성을 추가하도록 허용해야 합니다. 구성을 허용하는 것은 클라이언트가 트래픽을 처리하기 위한 조건일 뿐이며, 사용자가 보유한 서버 정보를 가져와야 합니다. 가이드에 따라 가져오기, 모드 선택, 연결, 검증을 차례로 진행하세요.
무료 · Apple 실리콘 / Intel.“이 Mac에 관하여”에서 칩 또는 프로세서를 확인한 뒤 해당 dmg를 선택하세요. 두 아키텍처용 파일이 각각 제공됩니다. 브라우저 정보로 칩을 추측하지 않으며 iPhone/iPad 구매 기록은 Mac 버전 다운로드 조건이 아닙니다.
처음 실행할 때 “개발자를 확인할 수 없음” 메시지가 표시되면 파일이 이 사이트에서 제공된 것인지 확인한 뒤 다운로드 페이지의 “개인정보 보호 및 보안 → 그래도 열기” 안내를 따르세요. 다른 경고가 표시되면 해당 안내를 확인하세요. 모든 시스템 차단 메시지를 같은 문제로 취급하지 마세요.
무료 · 64비트 설치 프로그램.먼저 시스템 유형을 확인한 다음 다운로드 페이지에서 이 사이트의 설치 파일을 받으세요. SmartScreen이 차단하면 출처와 파일을 먼저 확인하고 “추가 정보 → 실행”을 선택합니다. 조직에서 관리하는 기기는 관리자 정책을 따르세요.
설치 후 기존 서버 하나를 먼저 테스트한 다음 평소 사용하는 규칙을 활성화하세요. 앱 실행, 테스트 결과, 실제 요청 접근은 서로 다른 확인 항목이므로 각각 검증해야 합니다. 한 번의 테스트 수치만으로 구성이 완전하다고 판단하지 마세요.
무료 · arm64 설치 패키지.이 사이트의 다운로드 페이지에서 받으세요. 시스템에서 요청하면 이번 다운로드에 사용할 브라우저나 파일 앱에만 “알 수 없는 앱 설치 허용” 권한을 부여하고, 설치 후에는 해당 권한을 취소할 수 있습니다. 기기마다 설정 이름이 다를 수 있으므로 실제 시스템 안내를 따르세요.
처음 연결할 때 시스템의 VPN 권한 안내를 확인하세요. 네트워크를 전환한 뒤 연결에 문제가 생기면 클라이언트 상태를 확인하고 백그라운드 제한과 현재 네트워크 조건을 점검하세요. 네트워크 진단 대신 구독을 반복해서 가져오지 마세요.
무료 · deb / rpm / AppImage.배포판의 패키지 체계에 맞춰 deb 또는 rpm을 선택하세요. AppImage를 사용하는 경우 다운로드 페이지 안내에 따라 실행 권한을 부여합니다. 먼저 아키텍처와 실행 환경을 확인하고 권한 또는 의존성 안내를 처리하세요. 서로 다른 배포판의 설치 명령을 혼용하지 마세요.
업그레이드하려면 이 사이트에서 해당 형식의 새 패키지를 받으세요. 교체 전에 현재 구성 위치를 기록하고 사본을 보관한 뒤, 업그레이드 후 선택한 서버와 규칙 상태를 확인하고 실제 요청을 검증합니다. 설치 성공이 기존 구성이 올바르게 복원되었다는 뜻은 아닙니다.
IDENTITY / PURCHASE / CONTENT
이 사이트는 Shadowrocket 공식 웹사이트이자 공식 매뉴얼입니다. Shadowrocket은 비공개 소스 상용 앱입니다. 제품 확인, 다운로드 방식 파악, 연결 정보 준비는 첫 설정 전에 각각 확인해야 할 단계입니다.
먼저 앱 이름 Shadowrocket과 공식 아이콘을 확인하고, 개발자 Shadow Launch Technology Limited를 확인한 다음 제품 페이지의 앱 ID가 932747118인지 확인하세요. 검색 결과의 비슷한 이름과 이미지는 이 세 가지 확인을 대신할 수 없으며 검색 순위도 식별 기준이 아닙니다.
확인할 때는 검색 목록의 작은 이미지에 그치지 말고 제품 상세 페이지를 여세요. 이 사이트의 페이지 상단에 표시된 공식 아이콘은 외관을 구분하는 참고 자료입니다. 구매 전에는 지정된 제품 페이지의 정보를 확인하세요. 기타 플랫폼은 이 사이트의 다운로드 페이지에서 받으며 설치 파일 주소는 이 사이트의 /dl/shadowrocket/ 경로를 사용합니다.
App Store의 표시 범위는 구매 계정의 스토어 지역에 따라 달라집니다. 중국 본토 App Store에는 현재 이 앱이 없습니다. 검색되지 않으면 키워드를 반복해서 바꾸기보다 사용 중인 스토어 지역을 먼저 확인하세요. 제품 페이지 표시 여부, 구매 가능 여부, 현지 통화 금액은 해당 계정으로 연 스토어 페이지를 기준으로 확인해야 합니다.
지역을 변경해야 한다면 계정의 구독, 잔액, 결제 정보 요구 사항을 먼저 확인한 뒤 시스템의 계정 지역 설정을 이용하세요. 언어 또는 기기의 표시 지역을 바꿔도 App Store 구매 계정의 지역은 바뀌지 않습니다. 두 설정은 따로 확인해야 합니다.
App Store 및 지역 안내 →iPhone/iPad 버전의 미국 스토어 가격은 $2.99이며 일회성 구매입니다. 두 기기는 구매 기록을 공유할 수 있고 Mac·Windows·Android·Linux 버전은 무료입니다. 다른 스토어에서는 현지 통화로 표시되며 최종 금액은 구매 확인 화면을 기준으로 합니다. 기기를 바꿔도 구매 기록이 사라지는 것은 아니므로 재설치 전에 기존 구매 계정을 확인하세요.
iPhone 또는 iPad에서 기존 구매 계정으로 구입 항목을 확인한 뒤 Shadowrocket을 다시 받으세요. 앱 구매 기록과 사용자의 구독, 서버, Config는 서로 다른 정보입니다. 앱을 복원한 후에도 구성이 유지되었는지 확인하고, 필요한 경우 미리 저장해 둔 사본에서 복구하세요.
구입 항목 복원 안내 →Mac용 Apple 실리콘 버전과 Intel 버전이 각각 제공되며 Windows, Android, Linux는 각 시스템 형식에 맞춰 다운로드합니다. 이 사이트의 다운로드 페이지에서 버전 선택 방법, 처음 실행할 때 시스템에서 허용하는 방법, 현재 설치 파일을 한곳에서 확인할 수 있습니다. 플랫폼 형식이나 프로세서 유형을 혼동하지 않도록 하세요.
iPhone/iPad 앱 업데이트는 App Store에서 진행하고, 기타 플랫폼은 이 사이트의 다운로드 페이지에서 새 설치 파일을 받으세요. 업데이트 전에 현재 정상 작동하는 구성을 보관하고, 업데이트 후 선택된 서버, Global Routing, Config를 확인합니다. 동작이 달라지면 설정 참고 내용을 대조한 뒤 매개변수 조정 여부를 결정하세요.
플랫폼 및 다운로드 방식 확인 →먼저 명확한 대상 하나를 열어 요청에 예상한 정책이 적용되는지 확인한 다음, 직접 연결되어야 하는 다른 대상으로 교차 검증하세요. 시스템에 VPN 연결됨으로 표시되는 것은 연결 구성이 작동 중이라는 의미일 뿐 모든 대상이 같은 경로를 이용한다는 뜻은 아닙니다. 규칙 모드에서는 요청마다 PROXY, DIRECT 또는 REJECT가 적용될 수 있으므로 일부 요청이 직접 연결되는 것은 예상된 구성 결과일 수 있습니다.
테스트 결과가 예상과 다르면 대상, 현재 모드, 선택한 서버, 구성 파일 이름을 기록한 다음 관련 로그를 확인하세요. DNS, 규칙, 서버 매개변수를 수정할 때는 변경 전후를 비교할 수 있도록 기록을 남기세요. 다른 사람에게 문제를 설명할 때는 필요한 필드만 제공하고 인증 정보를 가립니다. “구독”, “구성 파일”, “최종 정책”의 차이는 먼저 용어집에서 확인한 뒤 계속 설정하세요.
TECHNICAL NOTES
문제에 맞는 내용을 확인하세요. 설치 문제는 플랫폼과 시스템 안내를 먼저 확인하고, 이름 확인 문제는 DNS 경로를 구분하며, 프로토콜 문제는 서버에서 제공한 전체 매개변수부터 점검합니다.
QUIC 전송, 혼잡 제어, 패킷 손실 복구를 통해 프로토콜의 동작 특성을 살펴보고 패킷 손실이 많거나 이동 네트워크를 사용할 때의 조건과 기존 서버 매개변수 입력 방법을 설명합니다. 프로토콜 선택은 서버 지원 여부와 현재 네트워크 테스트를 바탕으로 하며, 이름만으로 속도를 보장할 수는 없습니다.
프로토콜 안내 읽기 →세 가지 이름 확인 방식의 경로와 적합한 네트워크를 비교하고 이름 확인 결과와 규칙 라우팅의 관계를 설명합니다. 문제를 확인할 때는 먼저 기존 설정을 저장한 뒤 동일한 대상을 대상으로 하나씩 테스트하세요. DNS 방식과 서버를 동시에 바꾸면 원인을 파악하기 어렵습니다.
DNS 설정 안내 읽기 →“이 Mac에 관하여”에서 Apple 실리콘 또는 Intel을 확인하고 macOS의 개발자 확인 안내와 Windows SmartScreen에 각각 대응하는 방법을 소개합니다. 이 사이트의 다운로드 출처를 먼저 확인한 뒤 실제 시스템 안내에 따라 허용 단계를 선택하세요. 관리 대상 기기는 조직의 지침을 따릅니다.
설치 안내 읽기 →