공식 매뉴얼 · 전 플랫폼
전 플랫폼 규칙 기반 프록시 클라이언트로 규칙 분할을 지원합니다. iPhone / iPad는 App Store에서 $2.99 일회성 구매, Mac·Windows·Android·Linux 버전은 무료입니다.
현재 버전 불러오는 중 · iPhone / iPad $2.99 일회성 구매, Mac·Windows·Android·Linux 버전은 무료
처음 사용하기: 시작 안내 보기CONFIGURATION INDEX
연결 매개변수, 라우팅 모드 및 구성 규칙을 먼저 구분하세요. 서버는 연결 대상을 결정하고, Global Routing은 경로 선택 방식을 정하며, Config의 규칙은 요청을 하나씩 판단합니다. 세 기능은 서로 대체할 수 없습니다. 아래 설명은 일반적인 인터페이스 용어를 기준으로 하며, 구체적인 옵션은 기기에 표시되는 화면을 따르세요.
Home에서 Global Routing을 확인하세요. 구성 모드 Config는 현재 구성의 규칙에 따라 요청을 처리합니다. 프록시 모드 Proxy는 선택한 프록시를 통해 요청을 보내고, 직접 연결 모드 Direct는 직접 연결할 때 사용합니다. 트래픽을 분할하려면 Config를 선택한 뒤 Config에서 [Rule]을 확인하세요. 규칙은 위에서 아래로 매칭되며, 일치 항목이 발견되면 PROXY, DIRECT 또는 REJECT를 실행하고 이후 규칙은 비교하지 않습니다. 범위가 좁은 조건을 앞에 두고 마지막에 FINAL을 기본 규칙으로 배치하세요. 문제를 확인할 때는 먼저 모드와 현재 구성을 점검한 다음 개별 규칙을 조정하세요. 매개변수 오류를 트래픽 분할 문제로 오인하지 않도록 합니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXYOn Demand는 네트워크 조건에 따라 연결을 시작하며, [Rule]의 트래픽 분할 판단을 대신하지 않습니다. Settings에서 On Demand를 찾아 각 조건이 적용되는 네트워크를 확인한 뒤 활성화 여부를 결정하세요. 처음 설정할 때는 먼저 수동으로 연결을 켜고 확인한 다음, 기존 서버를 사용할 수 있는지 확인하고 조건을 추가하세요. 연결을 끈 뒤 다시 자동으로 켜지면 구성을 계속 삭제하기보다 On Demand와 시스템의 관련 설정을 확인하세요. Wi-Fi와 셀룰러 네트워크를 전환한 뒤 작동 조건을 다시 확인하세요. On Demand 연결에 성공했다는 것은 연결 동작이 조건에 맞음을 뜻할 뿐, 모든 대상 요청에 같은 정책이 적용된다는 의미는 아닙니다.
Settings → On Demand
Home → Global Routing → ConfigAdd Server에서 Type을 먼저 선택한 다음, 기존 서비스에 해당하는 필드를 입력하세요. Shadowrocket은 Shadowsocks, VMess, VLESS, Trojan, WireGuard 등의 프로토콜을 지원합니다. 프로토콜마다 인증 정보와 전송 설정이 다르므로 서로 섞어 입력하지 마세요. Host와 Port 외에도 비밀번호, 식별자 또는 키, 서비스에서 요구하는 TLS 및 전송 매개변수를 확인하세요. WireGuard의 개인 키, 공개 키, Endpoint는 각각 용도가 다르므로 서로 바꾸면 안 됩니다. 원래 구성을 기준으로 항목을 하나씩 대응하고 저장한 뒤 연결 테스트를 수행한 다음 실제 웹페이지를 확인하세요. 표시 이름만 바꿔서는 연결에 필요한 프로토콜 매개변수가 달라지지 않습니다.
Add Server → Type
Host / Port
WireGuard → Endpoint / Public Key / Private Key구독을 가져오려면 본인이 이미 구독 또는 서버 정보를 보유하고 있어야 합니다. Home에서 추가 메뉴를 열고 Subscribe를 선택한 뒤, 본인의 서비스 제공자로부터 받은 전체 링크를 붙여 넣고 저장한 다음 업데이트하세요. 업데이트 후 그룹과 항목이 표시되는지, 현재 선택한 서버가 맞는지 확인하세요. 구독 링크에는 인증 정보가 포함될 수 있으므로 공개 스크린샷이나 문제 논의에 노출하지 마세요. 업데이트에 실패하면 링크가 완전하고 유효한지, 현재 네트워크에서 구독 주소에 접근할 수 있는지 먼저 확인하세요. 구독 업데이트와 서버 연결은 별개의 단계이며, 업데이트에 성공해도 모든 항목을 사용할 수 있는 것은 아닙니다.
Home → Add Server → Subscribe
저장 → 구독 업데이트 → 서버 선택 → 연결 확인Config는 규칙, DNS 등의 구성 내용을 관리하며 Home의 서버 목록과는 역할이 다릅니다. 파일을 가져온 뒤 올바른 구성을 선택했는지 확인하고 [General], [Rule] 등의 섹션을 살펴보세요. 수정 전에는 복구할 수 있는 사본을 보관하고, 결과를 비교하기 쉽도록 한 번에 한 종류의 설정만 변경하세요. iCloud 동기화를 사용할 때는 해당 기능을 지원하는 기기에서 동일한 계정과 관련 권한을 확인하고, 동기화가 완료될 때까지 기다린 뒤 파일 내용을 확인하세요. 동기화가 완료되어도 다른 기기에서 해당 구성이 활성화된 것은 아닙니다. 구성에 민감한 주소가 포함될 수 있으므로 공유 전에 서버 정보와 인증 항목을 확인하세요.
[General]
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXYHome의 Connectivity Test는 연결을 확인하고, Settings의 Diagnostics는 추가 문제 해결 기능을 제공합니다. Data에서는 트래픽 변화를 살펴볼 수 있습니다. 테스트 결과는 테스트 방법과 함께 해석해야 하며, 한 번의 지연 시간 결과만으로 모든 웹사이트에 접근할 수 있다고 판단해서는 안 됩니다. 웹페이지가 열리지 않으면 서버 매개변수, 현재 모드, 일치한 규칙, DNS 순서로 하나씩 확인하고 문제가 발생한 네트워크 환경을 기록하세요. Data의 통계는 서비스 제공자 계정의 과금 내역과도 다릅니다. 문제를 제출할 때는 필요한 오류 정보만 남기고 구독 링크, 비밀번호, 키를 숨긴 뒤 재현 가능한 단계를 설명하세요.
Connectivity Test → 연결 확인
Diagnostics → 문제 해결 정보
Data → 트래픽 확인
Config → DNS 및 [Rule]PLATFORM ACCESS
2가지 다운로드 방식: iPhone / iPad는 App Store에서 $2.99 일회성 구매, Mac(Apple 실리콘 및 Intel)·Windows·Android·Linux 버전은 무료입니다. 기기와 프로세서 종류를 확인한 뒤 해당 다운로드 영역으로 이동하세요. 데스크톱, Android 및 Linux 설치 파일은 사이트 다운로드 페이지에서 제공하며, 파일 주소는 사이트의 /dl/shadowrocket/ 경로를 사용합니다.
App Store 제품 페이지에서 이름, 개발자 및 앱 ID를 확인한 뒤 구매하고 설치하세요. iPhone과 iPad는 구매를 공유합니다. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 스토어에서 앱이 보이는지는 계정의 국가 또는 지역에 따라 달라지며, 기기에 표시된 언어와는 관계가 없습니다.
처음 실행한 뒤에는 본인이 이미 보유한 서비스 정보도 가져와야 합니다. 앱 구매 기록, 연결 매개변수 및 구성 파일은 서로 다른 항목입니다. 기기를 변경할 때 각각 확인해야 하며, 앱을 다시 다운로드했다고 구성이 복원된 것은 아닙니다.
먼저 '이 Mac에 관하여'를 열고 '칩' 또는 '프로세서' 정보를 확인해 Apple 실리콘 버전과 Intel 버전 중 하나를 선택하세요. 다운로드 페이지에서는 두 아키텍처에 각각 설치 버튼을 제공합니다. 브라우저가 기기를 감지한 결과만으로 칩 종류를 추정하지 마세요.
처음 실행할 때 '개발자를 확인할 수 없음' 메시지가 나타나면 먼저 파일이 사이트에서 제공된 것인지 확인한 뒤 '개인정보 보호 및 보안'에서 '그래도 열기'를 확인하세요. '손상됨' 안내가 표시되면 다운로드 페이지의 별도 단계를 따르세요. 아키텍처가 맞지 않는 버전을 반복해서 바꾸지 마세요.
다운로드 페이지에서 Windows 64비트 설치 파일을 제공합니다. 시스템 종류를 먼저 확인한 뒤 파일을 저장하고 실행하세요. SmartScreen 안내가 나타나면 다운로드 출처와 파일 이름을 먼저 확인한 뒤 '추가 정보 → 실행'을 선택하세요. 조직에서 관리하는 기기는 관리자 설정도 따라야 합니다.
설치가 끝나면 클라이언트가 열리는지, 서비스 매개변수를 가져왔는지, 현재 모드가 올바른지 각각 확인하세요. 시스템 차단은 설치 단계의 문제이고 웹페이지에 연결되지 않는 것은 연결 단계의 문제이므로 따로 기록해 혼동하지 마세요.
사이트 다운로드 페이지에서 arm64 설치 파일을 받으세요. 시스템에서 설치 권한을 묻는 경우, 설정에서 설치 파일을 여는 데 실제로 사용하는 앱에 대해 '알 수 없는 앱 설치 허용'을 활성화하세요. 설치 후 필요에 따라 해당 권한을 해제할 수 있으며 다른 앱까지 일괄 허용할 필요는 없습니다.
WeChat에서 다운로드를 계속할 수 없다면 안내에 따라 시스템 브라우저에서 사이트를 여세요. 파일 저장과 설치 완료는 별개의 단계이므로 다운로드가 끝난 뒤 시스템의 설치 결과를 확인하세요. 처음 연결할 때 시스템 권한 요청이 나타나면 내용을 읽고 확인하세요.
배포판의 패키지 관리 방식에 따라 deb, rpm 또는 AppImage를 선택하고 다운로드 페이지에 표시된 아키텍처를 확인하세요. 파일 아이콘만 보고 형식을 판단하지 말고, 동일한 연결 문제를 해결하려고 여러 형식을 동시에 설치하지 마세요.
AppImage는 처음 실행하기 전에 실행 권한이 필요합니다. deb 및 rpm은 해당 패키지 관리자의 방식으로 설치하세요. 다운로드 페이지에 구체적인 명령과 시스템 허용 안내가 나와 있습니다. 설치를 확인한 뒤 기존 서버 정보를 가져오세요. 업그레이드 전에 현재 구성을 보관하고, 업그레이드 후 실제로 활성화된 구성 파일을 확인하세요.
FIRST CONNECTION
다음은 iPhone / iPad의 간단한 사용 순서입니다. 시작하기 전에 본인이 이미 보유한 구독 링크 또는 서버 매개변수를 준비하고, 현재 네트워크가 정상적으로 작동하는지 확인하세요. 한 번에 설정 하나만 조정하세요. 문제가 생기면 모든 항목을 다시 입력하기보다 바로 앞 단계를 확인하는 편이 원인을 찾기 쉽습니다.
01 / ADD SERVER
Home에서 Add Server를 열고 직접 추가할 경우 Type을 먼저 선택한 뒤 Host, Port 및 인증 항목을 입력하세요. 기존 구독을 가져오려면 Subscribe를 사용하세요. 보유한 자료에 따라 Scan QR Code를 선택할 수도 있습니다. 완료 후 SERVER 그룹에 예상한 항목이 표시되는지 확인하고 서버를 하나 선택하세요.
항목 이름은 식별용일 뿐 연결을 확인해 주지 않습니다. 매개변수를 복사할 때 앞뒤 공백, 포트 및 프로토콜 종류를 확인하세요. 구독 업데이트에 실패하면 다른 프로토콜을 반복해서 시도하지 말고 원본 링크를 확인하세요. 사이트는 노드나 구독을 제공하지 않으며, 모든 절차는 사용자가 이미 보유한 정보를 전제로 합니다.
02 / GLOBAL ROUTING
Home으로 돌아가 Global Routing을 확인하세요. 규칙 분할이 필요하면 구성 모드 Config를 선택하고 Config에서 적절한 구성이 활성화되어 있는지 확인하세요. 프록시 모드 Proxy와 직접 연결 모드 Direct는 프록시 경로와 직접 경로를 구분하는 데 사용할 수 있으며, 같은 규칙을 표현하는 세 가지 방식이 아닙니다.
서버를 가져온 뒤 모든 요청이 반드시 프록시를 거친다고 생각하지 마세요. 모드, 규칙 및 선택한 서버가 실제 경로를 함께 결정합니다. 구성을 변경하기 전에 기존 옵션을 기록하고, 테스트가 끝나면 평소 사용할 모드로 되돌리세요. 임시 진단 설정을 일상 설정으로 사용하지 않도록 주의하세요.
03 / CONNECTIVITY TEST
Home 상단의 연결 스위치를 켜세요. 처음 연결할 때는 시스템의 VPN 구성 요청 내용을 읽고 확인한 다음 Connectivity Test로 연결을 점검하세요. 이어서 확인할 테스트 대상을 열고 모드와 관련 규칙을 함께 확인하세요. 시스템에 연결됨으로 표시되어도 연결 상태만 확인된 것이며 모든 대상에 접근할 수 있다는 뜻은 아닙니다.
지연 시간 테스트는 정상이지만 웹페이지가 열리지 않으면 DNS, 대상 규칙 및 서비스 매개변수를 추가로 확인하세요. 문제가 발생한 네트워크, 테스트 방법 및 구체적인 현상을 기록하세요. 로그를 공유하기 전에 인증 정보를 숨기세요. 한 번의 테스트 결과만으로 서버를 일괄 삭제하거나 모든 설정을 초기화하지 마세요.
IDENTITY & PURCHASE
Shadowrocket은 폐쇄형 상용 앱입니다. 이 페이지는 Shadowrocket 매뉴얼의 공식 안내이며, 이 사이트가 공식 웹사이트입니다. 다운로드 경로를 확인할 때 iPhone / iPad는 App Store 제품 정보를 확인하고, Mac·Windows·Android·Linux는 사이트 다운로드 페이지와 /dl/shadowrocket/ 파일 경로를 확인하세요. 검색 결과에서 이름이 비슷하다는 이유만으로 판단하지 마세요.
iPhone / iPad에서 정품 여부를 확인하려면 세 가지를 함께 확인해야 합니다. 개발자는 Shadow Launch Technology Limited이고, 아이콘은 이 사이트의 공식 아이콘과 일치하며, 제품 페이지의 앱 ID는 932747118입니다. Shadowrocket이라는 이름만 같다고 해서 동일한 앱이라고 확인할 수는 없습니다. 검색 결과에는 이름이 비슷한 항목이 표시될 수 있으므로 검색 목록의 첫 번째 결과만 보지 말고 전체 제품 페이지에서 개발자 정보를 읽으세요.
가격을 확인할 때는 플랫폼도 구분해야 합니다. iPhone / iPad는 App Store에서 $2.99 일회성 구매이며 Mac·Windows·Android·Linux 버전은 무료입니다. iPhone / iPad 스토어에 무료로 표시되는 동명 항목은 여기서 안내하는 제품이 아닙니다. 다른 플랫폼의 무료 버전은 사이트 다운로드 페이지에서 받아야 하며, 두 가지 다운로드 방식을 같은 기준으로 판단하지 마세요.
App Store의 표시 내용은 계정의 국가 또는 지역에 따라 결정됩니다. 중국 본토 스토어에 앱이 표시되지 않는 경우 기기 언어, 키보드 또는 시간대를 바꿔도 소속 스토어는 변경되지 않습니다. 계정 설정에서 국가 또는 지역을 확인한 다음 제품 페이지를 열어 현재 스토어에서 표시되는지 확인하세요. 지역을 변경해야 한다면 잔액, 구독 및 결제 정보에 관한 시스템 안내를 먼저 읽고 Apple 계정 설정 절차를 따르세요.
구매하기 전에 App Store에 사용하는 계정을 확인해 기기 로그인 계정과 스토어 구매 계정을 혼동하지 않도록 하세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 제품 소개 페이지를 열 수 있다고 해서 현재 기기가 설치 조건을 충족하는 것은 아닙니다. 자세한 확인 경로와 일반적인 다운로드 실패 원인은 설치 안내를 참조하세요.
iPhone / iPad는 $2.99 일회성 구매이며 두 기기에서 구매를 공유합니다. Mac·Windows·Android·Linux 버전은 무료입니다. 기기를 변경하거나 재설치할 때는 원래 구매한 계정의 구입 항목에서 Shadowrocket을 찾아 다시 다운로드하세요. 페이지에 여전히 구매 가격이 표시되면 결제를 반복하지 말고 먼저 계정, 지역 및 구매 기록을 확인하세요. 가족 공유 적용 여부와 설정 조건은 제품 페이지 및 가족 설정에 실제로 표시된 내용을 따릅니다.
구매 기록은 앱을 받을 수 있는 권한을 복구할 뿐 서버 목록, 구독 링크 및 구성 파일까지 복원하지는 않습니다. 재설치 전에 필요한 구성을 저장하고, 기기를 변경한 뒤 동기화 상태와 현재 활성화된 파일을 확인하세요. 인증 정보가 포함된 자료는 본인이 관리할 수 있는 위치에만 보관하세요. 도움을 요청하기 위해 전체 구독 링크, 개인 키 또는 비밀번호를 공개하지 마세요.
iPhone / iPad 앱은 App Store에서 업데이트합니다. Mac·Windows·Android·Linux 사용자는 사이트 다운로드 페이지에서 새 설치 파일을 받아 각 플랫폼의 절차에 따라 업데이트하세요. 앱 업데이트는 클라이언트 프로그램을 변경하고, Subscribe 업데이트는 기존 구독에서 제공하는 항목을 변경하며, Config 업데이트는 구성 내용을 변경합니다. 어느 한 단계를 완료해도 나머지 두 항목의 확인을 대신할 수 없습니다.
업데이트 후 연결 문제가 발생하면 현재 모드, 선택된 서버 및 활성 구성 기록을 남기고 기존 매개변수가 여전히 유효한지 먼저 확인하세요. 설치 단계의 시스템 안내는 다운로드 페이지의 허용 절차를 따르고, 연결 단계에서는 프로토콜, 규칙 및 DNS를 확인하세요. 웹페이지가 잠시 열리지 않는다고 앱을 다시 구매할 필요는 없습니다.
READING NOTES
처음 연결을 완료한 뒤 실제로 겪은 문제에 해당하는 안내를 읽어 보세요. 매개변수 안내, DNS 문제 해결 및 계정 지역은 서로 다른 단계의 문제이므로 모든 설정을 한꺼번에 바꿀 필요가 없습니다. 아래에는 확인된 게시일을 기준으로 최신 글 세 편을 소개합니다. 규칙 순서 및 데스크톱 설치 글은 글 목록에서 확인할 수 있습니다.
Apple ID의 국가 또는 지역에 따라 스토어 콘텐츠가 결정되는 방식과 iPhone 설정 및 App Store에서 계정의 스토어를 확인하는 방법을 설명합니다.
스토어 지역 안내 읽기연결 테스트와 도메인 이름 확인을 구분하고 DNS 설정 항목의 의미를 설명하며, 이름 확인 실패와 웹페이지 로딩 문제를 단계별로 점검합니다.
DNS 문제 해결 단계 읽기Shadowrocket에 WireGuard를 추가할 때 입력하는 각 매개변수를 설명하고, 서비스 제공자가 전달한 구성 항목과 대응하는 방법 및 일반적인 입력 오류를 안내합니다.
WireGuard 매개변수 안내 읽기