iOS / macOS / Windows / Android / Linux규칙 매칭 · 첫 일치 항목설정 메뉴 · Global Routing
설정 및 연결
규칙 분기와 연결 설정
연결 전에 두 가지를 구분하세요. 서버 정보는 연결할 대상을 정하고, 규칙은 어떤 요청에 해당 연결을 사용할지 정합니다. 기존 구독이 있다면 먼저 Home에서 서버를 가져왔는지 확인한 뒤 Global Routing에서 선택한 모드를 살펴보세요. 규칙 파일이 올바르게 작성되어 있어도 클라이언트에서 실제로 사용 중이라는 뜻은 아닙니다.
요청별 연결 정책 지정
Home의 Global Routing에서 Config를 선택해야 요청에 현재 설정의 규칙이 적용됩니다. Proxy 또는 Direct를 선택한 경우에는 규칙 분기로 결과를 설명하기 어렵습니다. 규칙은 위에서 아래로 확인하며, 처음 일치하는 규칙이 정책을 결정합니다. 예시에서는 지정된 하위 도메인만 직접 연결하고, 같은 접미사를 사용하는 나머지 도메인은 프록시를 사용합니다. 접미사 규칙을 정확한 도메인 규칙보다 앞에 두면 지정된 하위 도메인도 프록시를 사용합니다. FINAL은 앞선 규칙과 일치하지 않은 요청을 처리합니다.
먼저 Home에서 수동으로 연결한 다음 Settings에서 On Demand를 확인하세요. 주문형 연결은 연결을 시작할 시점을 제어하며 요청의 분기 정책은 바꾸지 않습니다. 재현하기 쉬운 네트워크 조건 하나를 먼저 설정하고 네트워크를 전환한 뒤 Home으로 돌아와 연결 상태를 확인하는 방법을 권장합니다. 연결이 간헐적으로 끊기는 문제를 점검할 때는 주문형 연결을 잠시 중지하고 한 번 수동으로 테스트하세요. 이렇게 하면 조건이 예상대로 충족되지 않는 문제인지 서버에 연결할 수 없는 문제인지 구분하기 쉽습니다.
확인 경로
Settings → On Demand
Home → 연결 상태 확인
서버 프로토콜에 맞춰 항목 입력
기존 서버 매개변수가 있다면 Add Server를 열고 먼저 Type을 서버에서 사용하는 프로토콜로 설정한 다음, 해당 유형에 표시되는 항목을 입력하세요. 두 프로토콜 모두 Host와 Port를 사용하더라도 인증 정보는 서로 바꿔 쓸 수 없습니다. 입력한 후에는 해당 서버만 먼저 테스트하세요. 연결을 시도하면서 키, 포트, 라우팅 규칙을 한꺼번에 바꾸지 마세요. 저장에 실패하면 필수 항목을 먼저 확인하고, 저장은 됐지만 연결되지 않으면 클라이언트와 서버 양쪽의 설정이 일치하는지 확인하세요.
Shadowsocks
VMess
VLESS
Trojan
HTTP
SOCKS5
WireGuard
Hysteria2
기존 구독 가져오기 및 새로 고침
서비스 제공업체에서 기존 구독 주소를 받은 다음 Add Server에서 Subscribe를 선택해 저장하세요. 이후 Home으로 돌아와 SERVER 아래에 선택 가능한 항목이 표시되는지 확인합니다. 단일 서버 공유 링크는 서버 한 대의 정보만 설명하며, 주기적으로 새로 고칠 수 있는 구독과는 다릅니다. 새로 고침 후 목록이 비어 있다면 먼저 다운로드 실패인지 반환된 내용을 해석하지 못한 것인지 구분한 뒤 링크가 잘리지 않았는지 확인하세요. 문제 해결을 위해 화면을 공유할 때는 전체 링크, 특히 물음표 뒤의 매개변수가 노출되지 않도록 하세요.
구독 주소 형식 예시
https://example.com/sub?token=xxxx
설정 편집, 백업 및 동기화
Config에서 현재 사용 중인 파일을 확인하고, 변경 전에 정상 작동하는 사본을 보관하세요. 규칙만 수정할 때는 [General]의 DNS 설정을 동시에 바꾸지 마세요. 문제가 발생하면 원인을 찾기 어려워집니다. iCloud로 설정을 동기화하기 전에 기기에서 사용하는 iCloud 계정과 동기화 범위를 확인하세요. 동기화가 끝난 뒤에도 다른 기기에서 활성화된 파일을 확인해야 합니다. 서버 매개변수가 포함된 사본은 안전하게 보관하고, 공개 규칙 예시인 것처럼 전달하지 마세요.
[General]
dns-server = system
[Rule]
DOMAIN,example.com,DIRECT
FINAL,PROXY
서버, 규칙, 통계 문제 구분
먼저 Home에서 Connectivity Test로 현재 서버를 확인한 다음 동일한 대상으로 실제 접속을 테스트하세요. 테스트 성공은 선택한 테스트 조건에서 연결할 수 있다는 뜻일 뿐, 모든 대상에 접속할 수 있다는 보장은 아닙니다. 일부 요청만 문제가 있다면 Global Routing과 일치한 정책을 기록한 뒤 Settings에서 Diagnostics를 확인하세요. Data로 테스트 중 트래픽 변화를 비교할 수는 있지만, 통계 변화만으로 어떤 규칙이 일치했는지 증명할 수는 없습니다.
한 번에 점검하는 순서
Connectivity Test → 실제 접속 → Diagnostics
Data: 테스트 전후 트래픽 비교
같은 대상으로 규칙 차이 확인
프록시 모드에서는 접속되지만 Config로 전환한 뒤 실패한다면 같은 서버, 네트워크, 대상을 유지하고 모드만 비교하세요. 이어 대상의 실제 호스트 이름을 확인합니다. 페이지 주소, 이미지 출처, 로그인 요청은 서로 다른 도메인을 사용할 수 있으므로 홈페이지가 열린다고 해서 페이지 전체에 같은 규칙이 적용된다는 뜻은 아닙니다. 규칙 범위가 겹친다면 앞쪽의 넓은 접미사 규칙이 뒤쪽 예외 항목을 가리고 있는지 확인하세요. 모든 요청을 같은 정책으로 바꾸는 것은 서두르지 마세요.
IP 규칙을 사용할 때는 ‘주소에 직접 접속’하는 경우와 ‘도메인에 접속한 뒤 주소를 확인’하는 경우도 구분해야 합니다. 주소 문자열의 모양만 보고 어떤 규칙이 적용될지 추측하지 말고, 예시의 사설 주소 대역을 모든 네트워크에 적합한 기본값으로 간주하지 마세요. 수정 후 요청을 다시 보내 변경 전에 생성된 연결을 그대로 사용하지 않는지 확인하세요.
다운로드 방식은 두 가지입니다. iPhone / iPad는 App Store에서 $2.99 일회성 구매이며, Mac(Apple 실리콘 및 Intel) / Windows / Android / Linux 버전은 무료입니다. 설치 파일은 사이트의 /dl/shadowrocket/에서 제공합니다. 아래 카드는 플랫폼별 다운로드와 설치 안내로 연결되며 설치를 바로 시작하지는 않습니다.
처음 실행할 때 시스템에서 차단되면 다운로드 페이지로 돌아가 플랫폼, 아키텍처, 파일 출처를 확인한 뒤 설치 차단 해제 안내에서 해당 시스템의 안내를 확인하세요. 설치 권한이 있고 시스템에서 허용하는 경우에만 현재 앱을 한 번 승인하세요. 설치를 위해 시스템 보호 기능을 끄지 마세요. 출처가 불분명하거나 대상 기기와 맞지 않거나 조직 정책에서 설치를 금지한다면 작업을 중단하세요.
iPhone 또는 iPad에서 App Store 제품 페이지를 열고 앱 제목 아래나 제품 정보에 표시된 개발자를 확인한 다음 공식 아이콘과 앱 ID를 확인하세요. 개발자는 Shadow Launch Technology Limited여야 하고, 아이콘은 이 섹션에 표시된 흰색 바탕의 파란색·보라색 윤곽 로켓과 같아야 합니다. 제품 링크의 번호는 932747118이어야 합니다. 검색 결과 순위, 비슷한 아이콘, 약칭만으로 판단하지 마세요. 제품 페이지가 아닌 검색 결과를 열었다면 항목을 선택해 정보를 확인하고, 결과 목록에서 아이콘만 보고 구매하지 마세요.
앱 ID는 제품 항목을 식별하는 번호이며 주문 번호도 아니고 가입 시 입력하는 항목도 아닙니다. 다른 사람이 전달한 이미지나 설명은 제품 페이지를 찾는 단서로만 활용하고, 구매할 때는 기기에서 직접 연 제품 정보를 기준으로 하세요. 같은 이름의 항목이 표시되면 개발자와 번호를 하나씩 확인하고, 하나라도 다르면 해당 제품으로 간주하지 마세요.
제품이 표시되는지, 어떤 통화가 적용되는지, 현재 기기에 설치할 수 있는지는 각각 스토어 지역과 호환성 정보를 확인해야 합니다. 링크는 미국 스토어 제품 페이지를 가리키지만 현재 로그인한 계정의 스토어 지역을 바꾸지는 않습니다. 항목을 사용할 수 없다는 안내가 표시되면 먼저 App Store 계정에서 현재 국가 또는 지역을 확인한 다음 지역별 판매 차이인지 시스템이나 기기 요구 사항을 충족하지 못한 것인지 구분하세요. 휴대폰의 표시 언어를 바꿔도 구매에 사용하는 스토어 지역은 달라지지 않습니다. iPhone / iPad의 시스템 요구 사항은 항상 App Store 페이지 표기를 기준으로 확인하세요.
기기를 바꾸기 전 기존 기기를 사용할 수 있다면 구매에 사용한 계정과 구입 기록을 먼저 확인하세요. 같은 기기에서 여러 계정을 차례로 사용했다면 현재 로그인한 계정이 실제 구매에 사용한 계정이 아닐 수도 있습니다. 계정 기록과 기기 호환성을 따로 확인하면 같은 지역 링크를 반복해서 여는 것보다 문제를 찾기 쉽습니다.
일회성 앱 구매와 서버 서비스는 별개
iPhone / iPad의 미국 App Store 가격은 $2.99 일회성 구매입니다. 동일한 구매 계정으로 요구 사항을 충족하는 두 기기에서 이 구매를 사용할 수 있으며, Mac / Windows / Android / Linux 버전은 무료입니다. 다른 스토어 지역에서는 페이지에 표시되는 통화와 가격을 확인하세요. Shadowrocket은 비공개 소스의 상용 앱입니다. 구매 기록은 클라이언트 이용 권한에 해당하며 서버 주소, 연결 인증 정보 또는 서버 이용 기간을 포함하지 않습니다.
기기 변경, 재설치, 업데이트를 각각 확인
iPhone 또는 iPad에 재설치할 때는 먼저 App Store에서 기존 구매 계정을 사용 중인지 확인한 뒤 구입 항목에서 Shadowrocket을 찾으세요. 페이지에 재다운로드 버튼 대신 구매 버튼이 표시되면 결제를 반복하지 말고 현재 스토어 계정, 지역, 기존 구매 기록을 확인하세요. 앱을 다시 다운로드해도 당시 선택한 서버, 활성화된 설정 파일, 로컬 수정 사항까지 복원되는 것은 아닙니다. 실행한 뒤 Home의 서버 목록과 Config에서 활성화된 파일을 확인한 다음 연결을 테스트하세요.
iPhone 및 iPad 앱은 App Store에서 업데이트합니다. Mac, Windows, Android, Linux용 업데이트 설치 파일은 이 사이트의 앱 페이지에서 선택하고 현재 기기에 맞는 아키텍처와 배포 형식을 유지하세요. 규칙을 수정했다면 업데이트 전에 현재 설정 파일과 활성화 상태를 별도로 기록해 두는 것이 좋습니다. 업데이트 후에는 기존에 작동하던 대상을 먼저 다시 테스트하고 설정이 바뀌지 않았는지 확인한 뒤 규칙 수정 여부를 판단하세요. 한 번의 문제 해결 과정에서 앱을 바꾸고 새 구독을 가져오며 규칙까지 다시 작성하지 마세요.
가져오기에 문제가 있으면 먼저 올바른 항목을 확인하세요. 필요한 필드는 있지만 링크가 없다면 프로토콜을 확인하고, 공유 링크를 받았지만 갱신 여부를 모르겠다면 링크 형식을 확인하세요. 가져온 항목이 표시되지 않으면 반환된 내용과 업데이트 시점을 확인합니다. 가져오기에 성공했다고 연결까지 성공한 것은 아니므로 두 단계를 각각 확인해야 합니다.
단일 서버 공유 링크와 구독 주소는 서로 다른 가져오기 방식을 사용합니다. 링크 접두사와 용도를 구분하는 방법, 인코딩된 내용을 직접 수정하지 않아야 하는 이유, 공유 링크를 갱신하려면 보통 다시 가져와야 하는 이유를 설명합니다. 문제를 확인할 때는 접두사만 알려도 되며 연결 정보가 포함된 전체 문자열을 전달할 필요는 없습니다.
주소가 완전한지, 네트워크에서 내용을 가져올 수 있는지, 반환된 내용을 해석할 수 있는지, 새로 고침 시점이 적절한지 순서대로 확인합니다. 가져온 결과를 찾을 수 없는 경우와 항목은 있지만 연결되지 않는 경우도 구분해 파싱 문제를 라우팅 문제로 오해하고 설정을 반복해서 바꾸지 않도록 합니다.