공식 매뉴얼 · 설치 및 설정

Shadowrocket 사용법
구독 가져오기와 규칙 분기

모든 플랫폼에서 사용할 수 있는 규칙 기반 프록시 클라이언트입니다. 기존 구독을 가져온 뒤 Global Routing을 확인하고, Config 규칙 분기로 요청이 전달되는 경로를 살펴보세요.

Shadowrocket 다운로드 모든 플랫폼

현재 버전 · iPhone / iPad는 App Store에서 $2.99 일회성 결제, Mac·Windows·Android·Linux는 무료

처음 설정하기: 사용 가이드 보기 →
VLESS On Demand Config

설정 확인 절차

연결 설정부터 요청 경로까지

연결 스위치, 서버 정보, 분기 규칙은 서로 다른 설정입니다. 먼저 설정으로 연결할 수 있는지 확인하고, 어떤 규칙이 요청 경로를 결정하는지 살펴보세요. 한 번에 하나의 변수만 바꾸고 결과를 비교할 수 있도록 기록해 두세요.

설정 가이드 보기

규칙 분기: 먼저 매칭 순서 확인

규칙 분기는 요청에 적용할 정책을 결정하며, 서버 연결 매개변수를 보완하지는 않습니다. Home에서 Global Routing이 Config로 설정되어 있는지 확인한 뒤, 현재 선택된 Config에서 Rule을 살펴보세요. 규칙은 보통 위에서 아래로 매칭되므로, 구체적인 도메인 규칙을 포괄적인 규칙보다 위에 배치해야 합니다. 앞선 규칙에 매칭되지 않은 요청은 FINAL이 처리합니다. 특정 웹사이트의 경로가 예상과 다르면 도메인과 실제로 매칭된 규칙을 기록한 다음 규칙 순서와 정책 이름을 확인하세요. 문제를 감추려고 모든 요청을 PROXY로 바꾸지 마세요. 오른쪽은 규칙 문법 예시이며, 모든 네트워크에 사용할 수 있는 완성된 설정은 아닙니다.

Rule · 예시
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
정책 의미

DIRECT는 직접 연결, PROXY는 프록시 정책 사용, REJECT는 매칭된 요청 거부를 뜻합니다. 규칙 매칭에 성공해도 대상 서비스가 반드시 작동하는 것은 아닙니다.

On Demand: 자동 연결 조건 확인

On Demand는 설정된 조건에 따라 연결을 실행합니다. 수동 연결이 정상 작동하는지 확인한 다음 설정하세요. Settings에서 On Demand를 찾아 각 조건을 읽고, 어떤 네트워크 변화에 연결할지 또는 연결을 건너뛸지 확인합니다. 연결을 끈 뒤 자동으로 다시 켜진다면 서버를 반복해서 삭제하기보다 먼저 이 설정을 확인하세요. 연결이 불안정한 원인을 찾을 때는 자동 실행을 잠시 끄고 수동 연결만 비교해 볼 수 있습니다. 원인을 확인한 뒤 기존 조건을 복원하세요. 시스템의 백그라운드 작업과 네트워크 전환에 따라 실행 시점이 달라질 수 있으므로, 자동 연결이 항상 가능하다고 보장하지는 않습니다.

설정 경로

Settings → On Demand

수동 연결을 확인한 뒤 자동 실행 조건을 추가하세요.

문제 해결 순서

On Demand 일시 중지 → 수동 연결 → 네트워크 전환 테스트 → 확인된 실행 조건 복원

여러 프로토콜: 기존 정보에 맞는 Type 선택

서버를 추가할 때는 사용자가 보유한 서버에서 실제 제공하는 프로토콜에 맞춰 Type을 선택해야 합니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등의 프로토콜은 입력 항목이 서로 다르므로 프로토콜 이름만 바꿔서 변환할 수 없습니다. Add Server에서 Type을 선택한 뒤 Host, Port와 해당 인증 및 전송 매개변수를 하나씩 확인하세요. 링크나 QR 코드로 가져온 뒤에도 입력 항목을 검토하고, 특히 복사 과정에서 끝부분의 매개변수가 누락되지 않았는지 살펴보세요. 프로토콜 이름은 통신 방식을 나타낼 뿐 속도나 사용 가능성을 보장하지 않습니다. 서버 상태, 매개변수 일치 여부, 현재 네트워크 환경을 각각 확인해야 합니다.

프로토콜 참고
ShadowsocksVMessVLESSTrojanHysteria2WireGuard
Add Server

Type → Host → Port → 해당 인증 매개변수. 각 항목의 의미는 용어집을 참고하세요.

구독 가져오기: 링크와 설정 내용 구분

구독을 사용하면 사용자가 보유한 서버 항목을 한곳에서 가져오고 업데이트할 수 있습니다. 가져오기 전에 본인의 서비스 제공업체에서 전체 링크를 받아 공백, 줄바꿈 또는 잘림이 없는지 확인한 다음 Add Server에서 Subscribe를 선택해 입력하세요. 저장 후 Home으로 돌아가 항목을 확인하고 필요하면 수동으로 업데이트합니다. 업데이트 후 목록이 비어 있다면 링크에 접근할 수 없는 경우, 응답이 구독 형식이 아닌 경우, 서버 항목을 해석하지 못한 경우를 구분해 살펴보세요. 구독 업데이트는 Config의 규칙을 업데이트하는 작업이 아니며, 선택한 서버가 자동으로 사용 가능해지는 것도 아닙니다. 구독 링크에 접근 자격 증명이 포함될 수 있으므로 문제 화면을 공유할 때는 링크 전체를 가리세요.

가져오기 확인

Add Server → Subscribe

전체 링크, 저장 결과, 수동 업데이트, 서버 선택 순서로 확인하세요.

관리 범위

구독은 서버 목록을 관리하고 Config는 규칙과 관련 설정을 관리합니다. 목록을 업데이트한 뒤 규칙도 업데이트됐다고 오해하지 않도록 각각 확인하세요.

Config: 현재 사용 중인 파일 확인

설정 파일을 저장하는 것과 실제로 사용하는 것은 다릅니다. Config에 들어가 현재 선택된 파일을 확인한 뒤 General, Rule, Hosts 등의 섹션을 살펴보세요. 수정하기 전에 복원 가능한 사본을 보관하세요. 원격 설정을 업데이트한 뒤에는 로컬 수정 사항이 유지됐는지 다시 확인해 동기화나 덮어쓰기를 규칙 오류로 오인하지 않도록 합니다. iCloud 동기화를 사용한다면 대상 기기에 내용이 도착했는지 확인하고 해당 기기에서 선택 항목을 다시 확인하세요. 설정 동기화는 현재 네트워크 상태를 동기화하지 않으며 서버 자격 증명 확인을 대신하지도 않습니다. 한 번에 설정 하나씩 변경하고 변경 전후의 접속 결과를 기록하는 것이 좋습니다.

Config 섹션
GeneralRuleHostsURL Rewrite
iCloud

파일이 동기화됐는지 확인한 다음 현재 선택된 항목을 확인하세요. 수정 전에 사본을 보관하고 문제가 생기면 이전에 작동하던 설정으로 되돌리세요.

진단 도구: 문제 범위를 좁히기

Connectivity Test, Diagnostics, Data는 각각 연결 확인, 진단 정보, 트래픽 확인 기능을 제공합니다. 먼저 연결을 끄고 기본 네트워크를 확인한 다음 연결을 켜고 같은 대상을 테스트해 결과를 비교하세요. 한 번의 테스트가 시간 초과됐다고 모든 요청이 실패했다고 단정할 수는 없습니다. 테스트 대상, DNS 확인, 서버 상태도 결과에 영향을 줄 수 있습니다. Data의 트래픽 변화는 요청 발생 여부를 살펴보는 데 도움이 되지만 요청 성공을 단독으로 입증하지는 않습니다. 문제를 기록할 때 네트워크 종류, Global Routing, 현재 Config, 재현 절차를 함께 적으세요. 공유하기 전에는 서버 인증 정보, 구독 링크, 개인 접속 기록을 가리세요.

확인 도구
Connectivity TestDiagnosticsData
증상별 안내

스위치 오류, 서버 시간 초과, DNS 문제, 업데이트 후 오류는 각각 다른 절차로 확인해야 합니다. 문제 해결 매뉴얼을 참고하세요.

GLOBAL ROUTING

세 가지 모드별 확인 사항

화면의 Config / Proxy / Direct는 각각 설정, 프록시, 직접 연결을 뜻합니다. 모드를 선택하면 요청 처리 방식이 달라지며 서버 자체의 인증 매개변수는 변경되지 않습니다.

Config: 현재 설정에 따라 분기

도메인, IP 또는 다른 조건에 따라 요청을 구분해야 한다면 Config를 선택하고 Config 화면에서 실제로 선택된 파일을 확인하세요. 요청 경로가 예상과 다르면 해당 요청에 가장 먼저 매칭된 규칙과 그 규칙에서 참조하는 정책의 존재 여부를 확인합니다. 같은 서버라도 규칙 파일에 따라 결과가 달라질 수 있으므로 서버를 고정하고 규칙만 비교하세요. 규칙 예시에서 PROXY를 참조한다면 앱에서 해당 정책이 사용 가능한 서버를 찾을 수 있는지도 확인하세요. 이해하지 못한 설정 전체를 현재 파일에 바로 덮어쓰지 마세요.

기기별 설치

Shadowrocket 전체 플랫폼 설치 안내

iPhone/iPad는 App Store에서 $2.99 일회성 결제이며 Mac·Windows·Android·Linux 버전은 무료입니다. 설치 파일은 이 사이트의 /dl/shadowrocket/에서 제공됩니다. 홈페이지의 설치 링크는 다운로드 안내로 연결되며, 기기에 맞는 항목을 선택할 수 있습니다.

iPhone iPad

iPhone / iPad

App Store에서 $2.99 일회성 결제 · Mac·Windows·Android·Linux 버전은 무료

본인의 구매 계정으로 제품 페이지를 확인한 뒤 설치하세요. 두 기기는 같은 구매 기록을 공유하며 시스템 요구 사항은 App Store 페이지의 표기를 기준으로 합니다. 처음 사용하기 전에 본인의 구독 또는 서버 정보를 준비하세요. 설치만으로 연결 설정이 자동 생성되지는 않습니다.

App Store 및 구매 안내 보기

Mac

무료 · Apple 실리콘 / Intel

먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. 다운로드 페이지에서 Apple 실리콘과 Intel용 설치 파일을 각각 제공합니다. 처음 실행할 때 ‘개발자를 확인할 수 없음’이 표시되면 다운로드 경로를 확인한 뒤 다운로드 안내에 따라 ‘개인정보 보호 및 보안’에서 처리하세요. 출처가 불분명한 파일로 반복해서 교체하지 마세요.

Mac 설치 옵션 보기

Windows

무료

다운로드 페이지에서 Windows 64비트 설치 파일을 제공합니다. 처음 실행할 때 SmartScreen 경고가 표시되면 파일을 이 사이트에서 받았는지 확인한 뒤 ‘자세한 정보’에서 ‘실행’을 선택하세요. 설치 경고 처리와 연결 문제 해결은 별개입니다. 연결 매개변수는 앱이 정상적으로 열린 뒤 확인해야 합니다.

Windows 다운로드 안내 보기

Android

무료

다운로드 페이지에서 arm64 설치 옵션을 선택하세요. 시스템에서 설치 권한을 요청하면 사용 중인 다운로드 앱에 필요한 경우에만 ‘알 수 없는 앱 설치’를 허용하고, 설치 후 원래 설정으로 되돌릴 수 있습니다. WeChat에서 다운로드를 계속할 수 없다면 시스템 브라우저에서 이 사이트의 다운로드 페이지를 열고 안내에 따라 진행하세요.

Android 설치 안내 보기

Linux

무료 · deb / rpm / AppImage

배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택하세요. AppImage를 사용할 때는 먼저 파일에 실행 권한을 부여해야 합니다. 다운로드 안내에서 해당 설치 절차를 확인할 수 있습니다. 종속성 또는 실행 오류가 표시되면 전체 오류 메시지를 보관하고, 먼저 앱 실행 문제를 해결한 뒤 기존 설정을 가져오세요.

Linux 설치 옵션 보기

모든 플랫폼 보기 →

처음 설정하기

설정 추가, 모드 선택, 연결 확인

아래 내용은 iPhone / iPad 화면을 기준으로 합니다. 먼저 재현 가능한 수동 연결을 확인한 뒤 자동 실행과 세부 분기 조건을 설정하세요.

단계 01 · Add Server

기존 서버 또는 구독 가져오기

Home에서 Add Server로 이동해 기존 정보에 맞는 프로토콜을 선택하거나 Subscribe로 전체 구독 링크를 가져오세요. 저장한 뒤 SERVER 목록에 항목이 나타나는지 확인하고 사용할 서버를 선택합니다. QR 코드로 가져온 경우에도 프로토콜과 주요 항목을 확인해야 합니다. 이름만 보고 설정이 올바르다고 판단하지 마세요.

단계 02 · Global Routing

모드 및 Config 확인

규칙 분기가 필요하면 Config를 선택하고 Config 화면에서 현재 선택된 파일을 확인하세요. Proxy를 임시 비교용으로 사용할 때는 원래 상태를 기억해 두세요. 서버 목록은 연결 대상을, Config는 규칙을 관리하므로 두 항목을 모두 확인해야 합니다. 처음 설정할 때 여러 출처의 규칙을 한꺼번에 추가하면 결과에 영향을 준 항목을 찾기 어렵습니다.

단계 03 · Connectivity Test

연결하고 결과 비교

시스템 안내에 따라 VPN 설정 추가를 허용한 뒤 연결 스위치를 켜세요. 명확한 테스트 대상에 접속하고 Connectivity Test로 확인합니다. 연결됨 표시는 연결 상태가 바뀌었다는 뜻일 뿐, 모든 대상에 접근할 수 있다는 의미는 아닙니다. 실패하면 모드, 서버, 오류 정보를 기록한 뒤 문제 해결 매뉴얼에 따라 범위를 좁히세요.

전체 가이드 보기 →

정품 확인 및 설치 정보

제품 정보를 확인한 뒤 구매 및 복원

Shadowrocket은 클로즈드 소스 상용 앱입니다. 이 사이트는 공식 웹사이트와 공식 매뉴얼입니다. 설치, 설정, 문제 해결은 각각 별도의 단계이므로 따로 확인하세요.

개발자 Shadow Launch Technology Limited 앱 ID 932747118 2가지 설치 방식 · App Store 및 이 사이트의 설치 파일

개발자, 아이콘, 앱 ID

iPhone / iPad에 설치하기 전에 제품 이름 Shadowrocket, 개발자 Shadow Launch Technology Limited, 앱 ID 932747118을 확인하고 페이지의 공식 아이콘과 비교하세요. 검색 결과에 같은 이름이 있다는 사실만으로 제품을 확인할 수는 없습니다. 다운로드 안내에서 지정된 제품 페이지로 이동한 뒤 제품 정보를 하나씩 확인하세요. 이름이 비슷한 다른 항목의 가격이나 기능 설명을 Shadowrocket에 적용하지 마세요.

공식 아이콘은 흰 바탕에 파란색과 보라색 윤곽의 그림을 사용하며 페이지 상단에도 같은 아이콘이 표시됩니다. 색상이나 검색 순위, 소개 이미지 한 장만 보지 말고 제품 정보를 전체적으로 확인하세요.

App Store 노출 및 계정 국가

중국 본토 App Store에서는 현재 이 앱을 제공하지 않습니다. 검색되지 않으면 검색어를 반복해서 바꾸기보다 Apple ID의 스토어 국가 또는 지역을 확인하세요. 스토어 지역에 따라 제품 노출, 현지 통화 가격, 결제 옵션이 달라집니다. 지역 변경이 필요하다면 계정의 지역 변경 조건을 확인하고 잔액, 구독 등의 제한 사항을 처리한 뒤 Apple 계정 설정 절차에 따라 진행하세요.

iPhone / iPad의 시스템 요구 사항은 App Store 페이지의 표기를 기준으로 합니다. 페이지에 기기 비호환 안내가 표시되면 시스템과 제품 페이지의 요구 사항을 확인하세요. 계정 지역 문제와 시스템 호환성 문제를 같은 오류로 취급해서는 안 됩니다.

두 가지 가격 및 구매 기록

iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제이며, 스토어에 따라 현지 통화로 표시됩니다. Mac·Windows·Android·Linux 버전은 무료입니다. iPhone과 iPad는 동일한 구매 계정의 기록으로 다시 설치할 수 있으므로 기기를 바꾸거나 재설치할 때는 중복 결제 전에 구입 항목을 확인하세요.

앱을 다시 다운로드하는 것과 로컬 설정을 복원하는 것은 별개입니다. 이전에 저장한 구독, 서버 정보, Config 파일은 보관해 둔 설정이나 사용할 수 있는 동기화 내용을 이용해 복원한 뒤 새 기기에서 현재 선택된 항목을 다시 확인하세요.

앱 구매와 서버 이용 요금은 별개

앱 비용은 앱 설치에 대한 비용이며 서버 접속 권한은 포함되지 않습니다. 가져오기 안내는 사용자가 이미 본인의 구독 또는 서버 정보를 보유한 경우를 전제로 합니다. 이 사이트는 서버나 구독을 제공·판매·추천하지 않으며, 이미 보유한 정보를 입력하고 업데이트하거나 문제를 해결하는 방법만 안내합니다. 설치 후 목록이 비어 있어도 앱 설치가 실패한 것은 아닙니다.

서버 만료, 인증 정보 변경, 구독 링크 오류는 기존 서비스 제공업체에 문의하세요. 앱을 다시 구매해도 이런 문제는 해결되지 않으며 Config를 반복해서 덮어쓰는 방법으로도 해결할 수 없습니다.

앱 업데이트 후 비교 가능한 설정 유지

iPhone / iPad는 App Store에서 앱 업데이트를 관리합니다. 다른 플랫폼은 이 사이트의 다운로드 안내에서 해당 설치 파일을 받으세요. Mac은 Apple 실리콘과 Intel용을 구분해야 합니다. 설치 파일은 이 사이트의 /dl/shadowrocket/ 경로에서만 제공합니다. 업데이트 전에 기존 서버 정보와 작동하는 Config를 보관하고, 업데이트 후에는 기존 설정으로 먼저 확인한 뒤 항목별로 조정하세요. 새로운 문제가 생기면 앱에 표시된 메시지, 기기의 시스템, 네트워크 종류와 작업 순서를 기록하세요. 비교할 수 없게 되지 않도록 서버, 구독, 규칙, DNS를 동시에 변경하지 마세요.

정품 확인 및 구매 복원 안내 보기 →

관련 문서

설치 형식 및 App Store 안내

현재 겪는 문제에 맞춰 Linux 패키지 형식, App Store 제품 확인, 데스크톱 첫 실행 경고를 살펴보세요. 설치를 마친 뒤 사용 가이드에서 기존 설정을 가져오세요.

모든 글 보기 →