규칙 매칭
조건과 정책을 한 줄에 작성합니다.
Shadowrocket은 전체 플랫폼을 지원하는 규칙 기반 프록시 클라이언트입니다. 기존 서버 정보나 구독을 가져와 규칙에 따라 트래픽을 라우팅할 수 있습니다. iPhone / iPad 버전은 App Store에서 $2.99 일회성 구매이며, Mac, Windows, Android, Linux 버전은 무료입니다.
현재 설치 패키지 버전 v2.2.92 · iPhone / iPad $2.99 일회성 구매; Mac, Windows, Android, Linux 버전은 무료입니다.
조건과 정책을 한 줄에 작성합니다.
기존 링크를 사용하세요. 아래는 예시 값입니다.
연결 시점과 트래픽 정책을 따로 설정합니다.
CONFIGURATION
먼저 세 가지 항목을 구분하세요. 서버 정보는 연결할 대상을 정하고, 구성 파일은 요청이 이동할 경로를 정하며, 연결 스위치는 클라이언트가 트래픽을 처리할지 결정합니다. 문제가 발생하면 이 순서대로 하나씩 확인하는 편이 여러 설정을 동시에 바꾸는 것보다 원인을 찾기 쉽습니다.
RULE ROUTING
Home에서 Global Routing을 Config로 선택하면 클라이언트가 현재 구성 파일의 규칙을 위에서부터 확인합니다. 특정 도메인에 대한 예외는 더 포괄적인 규칙보다 앞에 작성하세요. 앞선 조건에 일치하지 않는 요청은 마지막의 FINAL에서 처리됩니다. 연결 동작을 잠시 비교하려면 Proxy 또는 Direct로 전환해 프록시 연결과 직접 연결 결과를 각각 확인할 수 있습니다. 비교를 마친 뒤에는 Config로 돌아가 현재 선택된 파일을 확인하세요. 그렇지 않으면 규칙을 저장했더라도 해당 규칙을 테스트한 것이 아닐 수 있습니다.
ON DEMAND
Settings에서 On Demand를 열고 연결을 시작할 네트워크 조건을 확인하세요. 필요 시 연결은 시작 시점을 정하는 기능이며, 요청을 프록시로 보낼지 직접 연결할지는 Global Routing에서 설정합니다. 먼저 현재 네트워크에서 수동 연결이 되는지 확인한 다음 테스트할 네트워크로 전환해 조건이 작동하는지 살펴보세요. 수동 연결은 되지만 자동 연결이 예상대로 작동하지 않으면 조건이 현재 네트워크를 포함하는지 확인하고, 시스템에서 실제로 활성화된 VPN 구성이 무엇인지 살펴보세요. 서버 설정부터 바꾸지는 마세요.
PROTOCOLS
Add Server에서 먼저 Type을 설정한 뒤 기존 서버 정보를 참고해 Host, Port와 선택한 프로토콜에 필요한 항목을 입력하세요. 유형에 따라 필요한 인증 정보가 다릅니다. 유형을 바꾼 뒤 어떤 항목이 사라져도 정보가 삭제된 것은 아니며, 현재 유형에서 사용하지 않을 수 있습니다. 내용을 복사한 뒤 연결되지 않으면 프로토콜, 호스트, 포트와 인증 정보를 하나씩 확인하고 앞뒤에 불필요한 공백이 없는지도 살펴보세요. 프로토콜을 계속 바꿔 가며 서버 설정을 추측하지 마세요.
SUBSCRIBE
기존 구독 주소가 있다면 Add Server에서 Subscribe를 선택하고 서비스 제공자에게 받은 주소를 빠짐없이 붙여 넣은 뒤 저장하세요. Home으로 돌아와 해당 그룹이 표시되는지, 사용할 항목이 목록에 있는지 확인합니다. 구독 업데이트 성공은 클라이언트가 목록을 가져왔다는 뜻일 뿐, 각 서버에 연결할 수 있다는 의미는 아닙니다. 업데이트에 실패하면 주소가 완전한지, 현재 네트워크가 작동하는지, 링크가 교체되지 않았는지 각각 확인하세요. 문제 화면을 공유할 때는 주소의 쿼리 매개변수와 인증 정보를 가리세요.
CONFIG & DIAGNOSTICS
Config에서 현재 선택된 구성 파일을 확인하고, 편집하기 전에 복구할 수 있도록 원본을 보관하세요. 여러 기기를 사용하는 경우 앱의 iCloud 설정에서 동기화 가능한 항목을 확인하되, 동기화를 구성 백업으로 간주하지 마세요. 연결에 문제가 있으면 Home에서 Connectivity Test로 서버를 확인한 다음 Data의 트래픽 통계와 Settings의 Diagnostics를 살펴보세요. 트래픽이 증가했다는 사실만으로는 특정 대상에 어떤 규칙이 적용됐는지 알 수 없습니다.
먼저 Global Routing이 Config로 설정되어 있는지 확인한 다음 Config에서 현재 선택된 항목을 살펴보세요. 두 설정이 모두 올바르면 주소 표시줄 끝에 보이는 도메인만 보지 말고 실제로 접속한 호스트 이름을 기록하세요. 페이지 콘텐츠가 다른 호스트에서 제공될 수 있습니다. 대상 규칙보다 앞에 더 포괄적인 조건이 있는지, 일치하는 규칙이 없을 때 어떤 정책이 적용되는지 확인하세요. 한 번에 한 곳만 수정하고 같은 네트워크와 같은 대상을 사용해 다시 테스트하면 변화가 규칙 수정 때문인지 네트워크 변경 때문인지 구분할 수 있습니다.
먼저 On Demand를 잠시 끄고 현재 네트워크에서 수동 연결을 시도하세요. 수동 연결이 정상이면 On Demand를 다시 켜고 같은 기기에서 연결이 시작되어야 하는 네트워크로 전환하세요. 전환 전후의 연결 상태를 기록하고 서버나 규칙 파일은 동시에 바꾸지 마세요. 그래도 연결이 시작되지 않으면 시스템에서 현재 활성화된 VPN 구성과 앱의 트리거 조건을 확인하세요. 수동 연결도 실패한다면 자동 트리거를 살펴보기 전에 기본 연결부터 복구하세요.
라우팅 구성을 바꾸지 않은 상태에서 먼저 기기 자체의 인터넷 연결이 정상인지 확인한 뒤 Connectivity Test로 선택된 서버를 점검하세요. 테스트에 실패하면 Add Server로 돌아가 기존 설정을 비교하고, Type, Host, Port가 같은 서버 정보에 해당하는지 먼저 확인하세요. 마지막으로 프로토콜에 필요한 인증 항목을 살펴봅니다. 테스트에 성공했더라도 모든 대상에 접속할 수 있다는 뜻은 아니므로 실제 접속 결과도 확인해야 합니다.
목록 업데이트 자체가 안 되는지, 목록은 업데이트됐지만 특정 서버에 연결되지 않는지 먼저 구분하세요. 전자는 구독 주소 전체, 현재 네트워크, 서비스 제공자가 안내한 링크 상태를 확인해야 합니다. 후자는 선택된 항목과 서버 정보를 살펴보세요. 이전 그룹이 남아 있다면 비교를 위해 유지하고 주소를 확인하기 전에 삭제할 필요는 없습니다. 오류 메시지를 기록해야 한다면 오류 내용만 남기고 구독 주소, 식별 정보 및 서버 인증 정보는 가리세요.
App Store에서 복원되는 것은 클라이언트이며 이전 기기의 모든 구성은 복원되지 않습니다. 앱을 다시 연 뒤 구독 그룹, 저장된 서버와 Config의 현재 선택 항목을 각각 확인하세요. 이전에 iCloud 관련 설정을 사용했다면 동기화 가능한 항목이 새 기기에 도착했는지 먼저 확인하고, 나머지는 보관한 구성이나 원본 정보를 이용해 복원하세요. 먼저 수동 연결을 확인한 뒤 필요 시 연결 조건을 다시 설정합니다.
PLATFORM DOWNLOADS
iPhone / iPad 버전은 App Store에서 $2.99 일회성 구매할 수 있습니다. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료이며, 설치 파일은 본 사이트 다운로드 페이지의 /dl/shadowrocket/ 경로에서 받을 수 있습니다. 아래 항목을 선택하면 해당 기기에 맞는 옵션이 표시되며, 카드를 눌러도 설치가 바로 시작되지는 않습니다.
App Store에서 시스템 요구 사항을 확인하세요. 다시 설치하려면 구매한 계정의 구입 항목을 확인하세요.
먼저 ‘이 Mac에 관하여’를 열고 표시된 칩 또는 프로세서 유형에 맞는 디스크 이미지를 선택하세요. 다운로드 페이지에 두 버전이 함께 제공됩니다. 컴퓨터를 바꾼 경우 새 기기에 표시된 유형에 맞춰 다시 선택하세요.
먼저 시스템 정보에서 기기와 설치 파일의 아키텍처가 맞는지 확인하세요. 처음 실행할 때 시스템 알림이 나타나면 다운로드 출처가 본 사이트인지 확인한 뒤 설치 안내에 따라 진행하세요. 조직에서 관리하는 기기는 설치 권한이 있는지 먼저 확인해야 합니다.
기기의 아키텍처에 맞는 설치 파일을 선택하세요. 앱 내에서 다운로드가 안 되면 기본 브라우저로 열어 보세요.
먼저 프로세서 아키텍처를 확인한 뒤 배포판의 패키지 관리 방식에 맞는 형식을 선택하세요. AppImage를 선택했다면 설치 안내에 따라 실행 권한을 설정하고, 패키지를 사용하는 경우 패키지 관리자가 표시하는 의존성 안내를 확인하세요.
FIRST CONNECTION
아래 단계는 iPhone / iPad 화면을 기준으로 설명합니다. 기존 서버 정보나 구독 주소를 준비하고, 프록시를 켜지 않은 상태에서도 기기가 인터넷에 정상적으로 연결되는지 확인하세요. 이렇게 하면 처음 연결에 실패했을 때 기기 자체의 네트워크 연결 문제를 먼저 배제할 수 있습니다.
서버 정보가 하나뿐이라면 Home에서 Add Server로 이동해 Type을 확인하고 항목을 하나씩 입력한 뒤 저장하고 목록으로 돌아오세요. 구독 주소가 있다면 Subscribe로 가져오면 구독 내용에 따라 목록이 만들어집니다. 두 방법 중 어느 쪽을 사용하더라도 같은 항목을 중복해서 추가할 필요는 없습니다. 저장 후 SERVER 그룹을 열어 이번 테스트에 사용할 서버가 선택되어 있는지, 이전에 남겨 둔 항목이 선택된 것은 아닌지 확인하세요. 직접 추가한 서버와 구독 항목은 이름이 비슷하게 표시될 수 있으므로 출처를 기준으로 구분하세요. 확인을 위해 주소나 인증 정보를 공개된 곳에 올릴 필요는 없습니다.
Global Routing 모드 선택규칙에 따라 요청을 처리하려면 먼저 Config에서 현재 파일을 확인한 뒤 Home으로 돌아가 Global Routing을 Config로 설정하세요. 문제가 규칙과 관련 있는지 확인하려면 같은 네트워크에서 Proxy와 Direct를 각각 선택해 결과를 비교할 수 있습니다. 테스트 중에는 모드만 바꾸고 서버, 구성 파일 또는 네트워크는 동시에 변경하지 마세요. 규칙 모드에서만 결과가 다르다면 파일과 규칙 순서를 우선 확인하세요. 테스트 전에 사용한 모드를 기록하고, 끝난 뒤에는 평소 설정으로 복원해 임시 선택을 기존 구성 결과로 혼동하지 않도록 하세요.
Home으로 돌아가 연결 스위치를 켜세요. 처음 시스템의 VPN 구성 요청이 표시되면 현재 실행 중인 Shadowrocket에서 보낸 요청인지 확인한 뒤 시스템 안내에 따라 허용하세요. 연결 상태가 바뀌면 먼저 Connectivity Test를 실행한 다음 직접 연결될 것으로 예상하는 대상과 프록시를 거칠 것으로 예상하는 대상에 각각 접속해 보세요. 예상과 다른 결과가 나오면 네트워크 유형, 현재 모드, 구성 파일과 오류 메시지를 기록하세요. 연결 스위치가 켜져 있다는 것만으로 실제 통신이 확인된 것은 아닙니다. 두 대상 모두 접속되지 않으면 잠시 연결을 끊고 같은 대상을 다시 테스트해 기본 네트워크에도 문제가 있는지 먼저 판단하세요.
STORE VERIFICATION
Shadowrocket의 App Store 제품 페이지를 열어 개발자가 Shadow Launch Technology Limited인지 확인한 다음 흰색 바탕에 청자색 테두리가 있는 공식 아이콘과 대조하고, 제품 페이지 링크의 id932747118도 확인하세요. 검색 결과에는 이름이나 아이콘이 비슷한 앱이 있을 수 있으며, 중국어 별칭으로 불리는 경우도 구매 증거가 될 수 없습니다. 목록 요약만 보지 말고 제품 상세 정보를 기준으로 확인하세요. 개발자 이름과 앱 ID가 동일한 제품 페이지에 표시되어야 합니다. 하나라도 일치하지 않으면 이 매뉴얼에서 안내하는 앱으로 간주하지 마세요.
앱의 표시 여부는 기기의 언어나 시스템 지역이 아니라 현재 계정에서 사용하는 App Store 스토어에 따라 달라집니다. 검색 결과가 나오지 않으면 제품 페이지에서 해당 스토어의 제공 여부를 확인한 다음 Apple 계정의 ‘미디어 및 구입 항목’에서 앱을 받을 때 사용하는 계정과 국가 또는 지역을 확인하세요. 중국 본토 스토어에서는 이 앱을 제공하지 않습니다. 미국 스토어 제품 페이지를 열어 확인하더라도 계정의 스토어가 자동으로 바뀌지는 않습니다. 해당 스토어에서 제공되는데도 다운로드할 수 없다면 기기 제한과 호환성을 확인하세요. iPhone / iPad의 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 안내 문구를 더 자세히 확인하려면 App Store 안내를 참조하세요.
iPhone / iPad 버전은 미국 App Store에서 $2.99 일회성 구매이며, 각 스토어의 가격은 현지 표시를 따릅니다. Mac, Windows, Android, Linux 버전은 무료입니다. 한 번 구매하면 iPhone과 iPad에서 사용할 수 있어 기기별로 따로 구매할 필요가 없습니다. 기기를 바꾸거나 앱을 다시 설치할 때는 원래 구매한 계정으로 App Store에 로그인해 구입 항목에서 Shadowrocket을 찾아 다시 다운로드하세요. 다시 다운로드하는 대신 가격이 표시되면 즉시 구매하지 말고 먼저 구매 계정과 스토어를 확인하세요. 앱을 다시 다운로드해도 앱 자체만 복원됩니다. 기존 구독, 직접 추가한 서버와 로컬 규칙은 각각 동기화 또는 백업 상태를 확인해야 합니다.
따라서 앱이 정상적으로 열려도 기존 서버를 계속 사용할 수 있다는 뜻은 아닙니다. 반대로 구독 업데이트가 일시적으로 실패했다고 해서 구매 내역에 문제가 있다고 볼 수도 없습니다. 연결 문제가 생기면 앱 다운로드, 정보 가져오기, 대상 접속 중 어느 단계에서 안내가 표시됐는지 먼저 구분하세요. 앱 다운로드 문제는 스토어나 설치 경로를 확인하고, 기존 서비스 정보 변경은 해당 서비스 기록을 확인하세요. 모드와 규칙 문제는 Home과 Config에서 하나씩 살펴보세요.
iPhone과 iPad는 App Store에서 업데이트를 확인할 수 있으며 시스템의 자동 업데이트 설정을 그대로 사용해도 됩니다. Mac, Windows, Android, Linux는 본 사이트의 다운로드 페이지에서 해당 설치 파일을 다시 받으세요. 파일명이 비슷하다는 이유만으로 버전이나 출처를 판단하지 마세요. 업데이트 전에 사용 중인 모드와 구성 파일을 기록하고 필요한 로컬 백업을 보관하세요. 업데이트 후에는 수동 연결을 먼저 확인한 뒤 구독 업데이트, 규칙 라우팅과 On Demand가 예상대로 작동하는지 살펴보세요. 시스템에 설치 안내가 표시되면 다운로드 출처를 확인한 다음 다운로드 페이지에서 해당 플랫폼의 설치 안내를 확인하세요. 출처를 알 수 없는 파일은 허용하지 마세요.
READING NOTES
현재 문제에 맞는 글을 선택하세요. 도메인이 간헐적으로 열리지 않으면 먼저 DNS 경로를 확인하고, 링크를 받았지만 어디에 넣어야 할지 모르겠다면 링크 유형을 구분하세요. 라우팅 결과만 예상과 다를 때는 규칙의 매칭 조건과 순서를 확인하면 됩니다.
시스템 DNS, 사용자 지정 DNS, DNS over HTTPS의 조회 경로와 사용 상황을 설명하고, 도메인 조회 문제로 연결되지 않을 때 확인할 순서를 안내합니다.
ss://, vmess://, vless://, trojan:// 공유 링크의 구조를 살펴보고, 단일 링크와 구독 링크의 가져오기 방법 및 업데이트 방식 차이를 비교합니다. 모든 예시는 실제 정보가 아닌 예시 값입니다.
DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP, IP-CIDR, FINAL의 매칭 대상과 규칙을 위에서부터 확인하는 순서, PROXY / DIRECT / REJECT 작성 방법을 설명합니다.