Home
저장된 서버, 현재 선택 항목, 연결 상태를 확인하는 화면입니다. 목록에 항목이 표시된다는 것은 정보가 저장되었다는 뜻일 뿐, 연결이 설정되었다는 의미는 아닙니다. 처음 설정하는 경우 시작 가이드에 따라 가져오기, 선택, 시스템 권한 허용을 차례로 진행하세요.
Official Manual / Defined Terms
Shadowrocket 용어 해설
인터페이스 위치와 설정의 역할에 따라 용어를 찾아볼 수 있습니다. 인터페이스와 구문은 영어 원문을 유지하고, 각 용어의 의미와 사용 범위 및 혼동하기 쉬운 점을 한국어로 설명합니다.
모드, 조건, 동작을 먼저 구분하기
Proxy와 PROXY는 다릅니다
Global Routing의 Proxy는 전역 모드이고, 규칙 끝에 표시되는 PROXY는 처리 정책입니다. 전자는 전체 라우팅 방식을 정하고, 후자는 특정 규칙에 매칭된 요청의 처리 방식을 지정합니다. 문제를 확인할 때는 먼저 모드를 확인한 다음 규칙 순서와 최종 정책을 살펴보세요.
이 표는 사용자가 본인의 구독 또는 서버 정보를 이미 보유하고 있다는 전제에서 작성했습니다. 앱을 한 번 구매하는 것과 회선 요금제는 별개입니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. Shadowrocket은 Apple 플랫폼용 유료 앱입니다. 구매 및 설치 방법은 먼저 App Store 정품 확인 안내를 읽어보세요.
01 / Interface
인터페이스와 스위치
먼저 현재 화면을 확인한 다음, 작업으로 변경되는 항목이 서버 정보인지 라우팅 모드인지 연결 상태인지 구분하세요.
Add Server
기존 서버 정보를 직접 입력하는 화면입니다. 먼저 프로토콜 유형을 선택한 뒤 해당 항목을 입력하세요. 주소, 포트, 인증 정보, 전송 방식, TLS 설정은 보유한 서버 정보에 맞춰야 합니다. 표시 이름만 바꿔서는 연결 매개변수 오류를 해결할 수 없습니다.
Global Routing
전역 라우팅 모드를 선택하는 항목입니다. 대표적인 세 모드는 설정, 프록시, 직접 연결이며 인터페이스에서는 Config, Proxy, Direct로 표시됩니다. 요청의 전체 처리 방식을 결정하며 서버 프로토콜을 선택하는 항목은 아닙니다. 특정 규칙을 확인하기 전에 현재 Config 모드인지 확인하세요.
Config
Global Routing에서 Config는 현재 적용 중인 설정 파일의 규칙에 따라 요청을 처리한다는 뜻입니다. 같은 요청이라도 규칙 순서, DNS 조회 결과, 정책 선택에 따라 경로가 달라질 수 있습니다. 이 모드 이름은 설정 파일을 관리하는 Config 화면과 같으므로 안내를 읽을 때는 어느 화면인지 확인하세요.
Proxy
Global Routing에서 요청을 프록시 경로로 처리하는 모드입니다. 현재 프록시 연결이 작동하는지 확인할 때 자주 사용합니다. 기기의 모든 트래픽이 반드시 같은 경로를 거친다고 단정할 수는 없으며 시스템 트래픽 및 관련 설정에 따라 처리 범위가 달라집니다. 개별 규칙에 쓰이는 대문자 PROXY와도 다릅니다.
Direct
Global Routing에서 요청을 직접 연결 경로로 처리하는 모드입니다. Direct를 선택하는 것과 연결 스위치를 끄는 것은 서로 다른 작업입니다. 전자는 라우팅 방식을 바꾸고, 후자는 연결 상태를 바꿉니다. 문제를 확인하기 전후에 선택한 모드를 기록해 두면 모드 변경에 따른 결과를 서버 변경으로 오해하지 않을 수 있습니다.
On Demand
시스템과 앱에 설정한 조건에 따라 연결 동작을 실행하는 기능입니다. 연결을 시도할 시점을 정하는 기능이지 구독의 유효성을 확인하거나 모든 웹사이트의 접속 여부를 계속 검사하는 기능은 아닙니다. 활성화한 뒤 연결이 다시 설정된다면 수동으로 반복해서 끄기 전에 관련 조건을 확인하세요.
02 / Protocols
프로토콜
프로토콜 이름은 통신 방식을 나타내며 속도 등급을 뜻하지 않습니다. 정보를 가져올 때는 인증, 전송, 보안 계층의 매개변수를 함께 확인해야 합니다.
Shadowsocks
대표적인 프록시 프로토콜로 서버 주소, 포트, 비밀번호, 암호화 방식 등을 설정합니다. 암호화 방식은 서버 측 설정과 일치해야 하며 이름이 비슷하다는 이유로 다른 방식을 선택하면 안 됩니다. 별도의 전송 매개변수가 안내되어 있다면 비밀번호만 확인하지 말고 함께 점검하세요.
VMess
UUID 등의 매개변수로 사용자를 식별하는 프록시 프로토콜입니다. UUID, 전송 방식, TLS는 각각 별도의 항목이므로 하나만 정확하다고 전체 설정이 완성된 것은 아닙니다. 연결에 문제가 있다면 기기 시간이 정확한지, 서버에서 안내한 경로와 호스트 이름이 일치하는지도 확인하세요.
VLESS
UUID로 사용자를 식별하는 프록시 프로토콜입니다. 자체적으로 페이로드를 암호화하지 않으므로 실제 전송 방식 및 보안 설정과 함께 살펴봐야 합니다. 유형 이름만 바꾸면 VMess와 서로 대체할 수 있는 것은 아닙니다. 기존 서버를 추가할 때는 안내된 정보를 기준으로 UUID, 전송 방식, 서버 이름, 관련 보안 매개변수를 하나씩 확인하세요.
Trojan
일반적으로 TLS와 함께 사용하고 비밀번호로 인증하는 프록시 프로토콜입니다. 비밀번호뿐 아니라 연결 주소, TLS 서버 이름, 인증서가 서로 일치하는지도 확인해야 합니다. 인증서 검증에 실패하면 이름과 기기 시간을 먼저 점검하고, 검증을 건너뛰는 방법을 일반적인 해결책으로 사용하지 마세요.
Hysteria2
QUIC 기반 프록시 프로토콜이며 하위 계층에서 UDP 통신을 사용합니다. 연결 여부와 실제 성능은 UDP 연결 가능 여부, 네트워크 혼잡, 서버 리소스, 매개변수 일치 여부에 따라 달라집니다. 프로토콜 이름만으로 지연 시간이 짧거나 처리량이 높다고 보장할 수 없으며, 실제 네트워크에서 테스트를 대신할 수도 없습니다.
WireGuard
공개 키와 개인 키로 통신 상대를 식별하는 VPN 프로토콜입니다. 비밀번호나 UUID를 주로 사용하는 프로토콜과 매개변수 구조가 다릅니다. 기존 설정에 따라 엔드포인트, 키, 터널 주소, 라우팅 범위를 함께 확인해야 합니다. 개인 키는 민감한 정보이므로 문제 해결 자료를 다른 사람에게 전달할 때 삭제하세요.
03 / Match & Policy
규칙 키워드와 정책
규칙 앞부분은 매칭 조건을, 끝부분은 처리 동작을 나타냅니다. 키워드의 대소문자와 쉼표 구성을 유지하고, 수정하기 전에 현재 설정을 백업하세요.
Rule
규칙은 요청의 특징과 처리 정책을 연결하며, 설정 파일의 [Rule] 섹션에 작성하는 것이 일반적입니다. 규칙은 보통 위에서 아래 순서로 매칭되므로 앞에 있는 적용 가능한 규칙이 뒤쪽 규칙의 적용 여부에 영향을 줍니다. 결과를 확인할 때는 도메인 검색에만 그치지 말고 조건, 순서, 정책을 함께 살펴보세요.
DOMAIN
지정한 도메인과 정확히 일치시킵니다. 예: DOMAIN,example.com,DIRECT. www.example.com 같은 하위 도메인은 자동으로 포함되지 않습니다. 기본 도메인과 하위 도메인을 모두 포함해야 한다면 DOMAIN-SUFFIX의 매칭 범위를 확인한 뒤 규칙을 선택하세요.
DOMAIN-SUFFIX
지정한 도메인과 그 하위 도메인을 매칭합니다. 예: DOMAIN-SUFFIX,example.com,PROXY. 도메인 접미사의 경계를 기준으로 판단하므로 문자열이 어느 위치에든 포함되기만 하면 매칭되는 것은 아닙니다. 더 구체적인 하위 도메인에 다른 정책을 적용하려면 해당 정확 일치 규칙을 더 넓은 범위의 규칙보다 앞에 두세요.
GEOIP
대상 IP의 지리 데이터베이스 분류 결과를 기준으로 매칭합니다. 분류 결과는 데이터베이스 업데이트, 주소 할당, DNS 조회 결과에 따라 달라질 수 있으며 서버의 실제 물리적 위치를 실시간으로 측정하는 것은 아닙니다. 도메인 규칙과 GEOIP 결과가 다르면 규칙 순서와 실제 대상 IP를 함께 살펴보세요.
IP-CIDR
IPv4 주소 대역을 기준으로 매칭합니다. 예: IP-CIDR,192.168.0.0/16,DIRECT. 슬래시 뒤의 프리픽스 길이는 주소 범위를 나타내며 서버 포트가 아닙니다. IPv6 주소 대역에는 IP-CIDR6을 사용합니다. 설정할 때 주소 체계를 구분하고 IPv4 규칙을 그대로 복사하지 마세요.
FINAL
앞선 규칙에 모두 매칭되지 않았을 때 적용하는 기본 규칙입니다. 예: FINAL,DIRECT. 보통 규칙 목록의 마지막에 배치해야 하며, 앞에 두면 뒤쪽 규칙이 매칭될 기회를 잃을 수 있습니다. FINAL 뒤에 지정한 정책은 분류되지 않은 요청의 경로를 정하며, 설정의 모든 요청이 그 정책을 사용한다는 뜻은 아닙니다.
PROXY
규칙에서 프록시 정책을 나타내며, 매칭된 요청을 해당 프록시 경로로 처리합니다. 서버를 생성하거나 누락된 인증 및 전송 매개변수를 채워주는 기능은 아닙니다. Global Routing의 Proxy 모드와 비교하면 PROXY는 개별 규칙의 처리 결과이므로 현재 모드 및 선택된 프록시를 함께 확인해야 합니다.
DIRECT
규칙에서 직접 연결 정책을 나타내며, 해당 요청을 프록시 서버를 거치지 않고 처리합니다. 요청은 로컬 네트워크, 대상 서비스, 관련 DNS 설정의 영향을 받으므로 직접 연결도 실패할 수 있습니다. DIRECT는 Shadowrocket을 끄는 것이 아니며 다른 규칙이 더 이상 적용되지 않는다는 뜻도 아닙니다.
REJECT
규칙에 매칭된 요청을 거부합니다. 예: DOMAIN,example.com,REJECT. 요청을 처리하는 기능이지 페이지의 시각적 요소를 삭제하거나 같은 도메인에서 제공되는 모든 콘텐츠를 구분하는 기능은 아닙니다. 조건 범위가 너무 넓으면 로그인, 이미지 또는 다른 정상 기능에도 영향을 줄 수 있습니다.
04 / Subscription & Config
구독과 설정 파일
서버 정보는 연결 대상을 나타내고, 설정 파일은 처리 방식을 지정합니다. 같은 자료에서 함께 가져올 수는 있지만 각각의 역할을 구분해 확인해야 합니다.
Subscribe
사용자가 보유한 구독 주소에서 서버 정보를 읽고 업데이트하는 기능입니다. 가져올 수 있는 내용은 응답 형식에 따라 달라집니다. 구독 업데이트에 성공했다는 것은 정보를 읽거나 해석했다는 뜻일 뿐, 모든 서버에 연결할 수 있다는 의미는 아닙니다. 구독 주소에 접근 자격 정보가 포함될 수 있으므로 공개적으로 공유하지 마세요. 앱 구매 여부와 구독의 유효 상태는 서로 별개입니다.
Server
연결에 사용하는 서버 매개변수 모음으로, 일반적으로 주소, 포트, 프로토콜, 인증 정보를 포함합니다. 표시 이름은 서버를 구분하기 위한 라벨일 뿐 실제 지리적 위치, 사용 가능 여부, 네트워크 성능을 증명하지 않습니다. 문제를 확인할 때는 이름으로 매개변수를 추측하지 말고 보유한 원본 정보를 기준으로 각 항목을 확인하세요.
설정 파일
처리 옵션과 규칙을 저장하는 텍스트 파일입니다. 일반적인 섹션에는 [General], [Rule], [Host], [URL Rewrite]가 있습니다. 서버 구독과 같은 의미가 아니므로 서버 정보를 가져온 뒤에도 현재 어떤 설정 파일을 사용하는지 확인해야 합니다. 편집 전에 복구 가능한 사본을 보관하고, 이름이 같은 다른 파일이 아니라 현재 적용 중인 파일을 수정하는지 확인하세요.
Scan QR Code
QR 코드에 포함된 호환 서버 또는 구독 정보를 읽어오는 기능입니다. QR 코드는 데이터를 담는 방식일 뿐이며, 내부 콘텐츠와 형식에 따라 가져올 수 있는지가 달라집니다. 모든 이미지를 연결 정보로 인식하는 것은 아닙니다. 가져온 뒤 유형과 주요 항목을 확인하고, 비밀번호나 구독 인증 정보가 포함된 QR 코드는 공유하지 마세요.
05 / Settings & Diagnostics
설정 항목
테스트 결과, 로그, 동기화는 각각 서로 다른 내용을 확인하는 수단입니다. 설정을 조정할 때는 한 번에 하나만 변경하고 변경 전후의 결과를 기록하세요.
Settings
앱 설정을 한곳에서 관리하는 화면입니다. 구체적인 항목은 기기에 표시되는 실제 화면을 기준으로 확인하세요. 앱 수준 옵션과 설정 파일의 매개변수는 적용 계층이 다르므로 이름이 비슷하다는 이유만으로 적용 범위가 같다고 볼 수 없습니다. 변경 전에 기존 값을 기록하세요. 설정 간 상속 관계가 확실하지 않다면 Settings 설정 항목 참고를 확인한 뒤 검증하세요.
DNS
도메인 이름을 IP 주소로 변환하는 기능입니다. 설정의 dns-server = system은 시스템 DNS 리졸버를 사용한다는 뜻입니다. DNS 조회 성공과 웹사이트 요청 성공은 서로 다른 단계이며, 이후 규칙, 연결, 대상 서비스의 영향을 받을 수 있습니다. DNS 설정을 바꾸기 전에 문제가 도메인 조회 단계에서 발생하는지 연결 단계에서 발생하는지 먼저 확인하세요.
Connectivity Test
지정한 테스트 방식으로 연결 가능 여부를 확인하는 도구입니다. 결과는 테스트 대상과 방법을 함께 고려해 해석해야 합니다. 표시된 시간은 다운로드 속도가 아니며 실제 앱의 모든 요청이 정상 작동한다고 보장하지 않습니다. 결과를 비교할 때는 네트워크와 테스트 조건을 동일하게 유지하세요. 테스트에 실패하면 실제 요청과 로그를 추가로 대조해 확인하세요.
Log
연결, DNS 조회, 규칙 처리 과정을 살펴보는 로그입니다. 문제를 확인할 때는 먼저 구체적인 동작을 한 번 재현한 뒤 시간과 대상을 기준으로 관련 기록을 찾으세요. 서로 다른 요청의 결과를 혼용하지 않도록 주의해야 합니다. 로그에는 방문한 도메인, 서버 주소, 인증 관련 정보가 포함될 수 있으므로 외부에 공유하기 전에 민감한 내용을 삭제하세요.
URL Rewrite
매칭 표현식과 지정된 동작에 따라 URL을 처리하는 설정 기능으로, 일반적으로 [URL Rewrite] 섹션에서 사용합니다. 요청 라우팅을 결정하는 Rule과는 역할이 다르므로 같은 매칭 방식을 그대로 적용할 수 없습니다. 암호화된 요청에서 확인할 수 있는 정보와 추가 설정의 필요 여부는 구체적인 동작에 따라 달라집니다. 이를 근거로 모든 요청 내용을 읽을 수 있다고 가정해서는 안 됩니다.
iCloud 동기화
조건을 충족하는 기기 간에 iCloud를 통해 앱이 지원하는 데이터를 동기화합니다. 시스템 계정, iCloud 권한, 앱 내 설정을 함께 확인해야 합니다. 동기화는 모든 변경 내역을 보관하는 백업이 아니며, 삭제한 내용도 동기화될 수 있습니다. 기기를 변경하기 전에 필요한 설정을 별도로 저장하고 새 기기에서 서버 정보와 적용 중인 설정을 확인하세요.