공식 매뉴얼 · 용어 정리

Shadowrocket
화면·프로토콜·규칙 용어

용어가 표시된 위치에 따라 확인하세요. 화면 용어는 메뉴와 조작을, 프로토콜 이름은 연결 방식을, 규칙 키워드는 일치 조건을 설명합니다. 같은 용어도 위치에 따라 의미가 다를 수 있습니다. 예를 들어 Config는 구성 관련 화면 이름이자 Global Routing의 한 가지 모드입니다.

이 표는 사용자가 자신의 구독이나 서버 정보를 보유하고 있다는 전제에서 작성했습니다. 먼저 용어를 이해한 뒤 실제 매개변수에 맞게 설정하세요. 프로토콜 이름, 필드 이름, 규칙 키워드는 Shadowrocket 화면과 대조할 수 있도록 영어 원문으로 표기합니다.

화면 및 스위치

메뉴, 모드, 연결 확인

먼저 현재 화면을 확인한 다음, 설정 변경이 연결 대상, 라우팅 방식, 클라이언트 동작 중 무엇에 영향을 주는지 살펴보세요.

Home: 저장된 서버 항목을 확인하고 연결 대상을 선택하거나 연결 스위치를 조작하는 주요 화면입니다. 항목을 추가한 뒤에는 선택한 대상을 먼저 확인하고 연결을 시도하세요. 항목이 표시된다는 것은 정보가 저장되었다는 뜻일 뿐, 현재 서버를 사용할 수 있다는 의미는 아닙니다. 처음 연결할 때 표시되는 시스템 VPN 구성 승인 요청도 현재 작업에 필요한지 확인하세요.

Global Routing: Shadowrocket이 처리하는 트래픽의 전체 라우팅 방식을 정하며, 일반적인 옵션은 Config, Proxy, Direct입니다. 이 설정은 서버 선택과 별개입니다. 서버를 선택했다고 해서 모든 요청의 처리 방식이 자동으로 정해지지는 않습니다. 모드를 변경한 뒤에는 동일한 대상을 다시 확인하고, 여러 변수를 동시에 바꾸지 마세요.

Config / Proxy / Direct: Config(구성)는 현재 구성의 규칙에 따라 처리합니다. Proxy(프록시)는 클라이언트가 처리하는 트래픽에 프록시 정책을 적용하고, Direct(직접 연결)는 직접 연결합니다. 분할 라우팅 규칙을 유지하려면 Config를 선택하고 현재 구성이 적용되었는지 확인하세요. Proxy와 Direct는 문제를 비교해 확인할 때 사용할 수 있지만, 한 번 테스트에 성공했다고 해서 모든 네트워크 조건에서 같은 결과가 나온다는 뜻은 아닙니다.

On Demand: 설정한 조건에 따라 연결을 시작합니다. 네트워크 조건에 맞춰 연결 동작을 조정할 때 유용합니다. 서버를 자동으로 복구하는 기능이 아니며, 유효한 구성이나 시스템 승인을 대신하지도 않습니다. 활성화하기 전에 수동 연결을 확인하고 트리거 조건을 하나씩 점검하세요. 연결이 반복되는 문제를 확인할 때도 이 설정을 함께 살펴봐야 합니다.

Add Server: 저장된 서버 정보를 사용해 항목을 추가하는 메뉴입니다. 일반적으로 프로토콜을 선택하고 주소, 포트, 인증 매개변수를 입력해야 합니다. 프로토콜마다 표시되는 필드가 다르므로 한 프로토콜의 필드를 다른 프로토콜에 그대로 적용하지 마세요. 저장한 뒤 항목을 다시 열어 전송 방식, TLS, 서버 이름처럼 빠뜨리기 쉬운 부분을 확인하세요.

Connectivity Test: 연결 가능 여부와 응답 상태를 확인하는 보조 기능입니다. 구체적인 테스트 옵션은 현재 앱에 표시되는 내용을 기준으로 확인하세요. 결과는 대상과 테스트 방식, 당시 네트워크 상태에 따라 달라지며 다운로드 속도로 환산할 수 없습니다. 테스트에서는 연결되지만 실제 요청이 실패한다면 테스트만 반복하지 말고 DNS, Global Routing, 일치한 규칙을 확인하세요.

Settings: 클라이언트 관련 설정을 확인하고 변경하는 화면입니다. 세부 항목은 현재 앱에 표시되는 내용을 기준으로 확인하세요. 변경 전에는 기존 값을 기록하고, 문제가 생기면 한 번에 한 항목만 바꾼 뒤 같은 요청으로 차이를 확인하세요. 이름이 비슷한 설정도 기능이 같다는 뜻은 아닙니다. 연결 트리거, DNS 확인, 데이터 관리 항목을 각각 이해해야 합니다.

Data: 클라이언트의 업로드, 다운로드 및 관련 트래픽 통계를 확인합니다. 표시된 수치는 페이지의 통계 범위와 누적 시간을 함께 고려해 해석해야 합니다. 누적 트래픽은 현재 속도가 아니며 서버에 기록된 사용량과도 다를 수 있습니다. 초기화하기 전에 보관할 수치를 기록하세요. 통계 기준과 그룹 표시 방식은 Data 기능 설명을 확인하세요.

Global Routing 설정 방법 보기 →

프로토콜

프로토콜 이름과 매개변수 확인

프로토콜은 클라이언트와 서버가 통신하는 방식을 정합니다. 저장된 정보를 기준으로 입력하고, 이름만 보고 속도를 추측하거나 포트만으로 프로토콜을 판단하지 마세요.

Shadowsocks: 프록시 프로토콜의 하나로, 일반적인 설정 항목에는 서버 주소, 포트, 암호화 방식, 비밀번호가 있습니다. 암호화 방식은 서버 측 설정과 일치해야 하며 비밀번호의 대소문자와 문자를 그대로 입력해야 합니다. 가져온 뒤 연결되지 않으면 먼저 기본 필드를 확인한 다음 추가 전송 매개변수가 필요한지 살펴보세요.

VMess: UUID 등의 정보로 사용자를 인증하는 프록시 프로토콜입니다. 전송 계층 설정도 구성의 일부입니다. 주소, 포트, UUID가 정확해도 연결이 보장되지는 않습니다. 해당되는 전송 방식, 경로, TLS 등의 필드도 확인해야 합니다. UUID는 인증 정보이므로 원래 값을 그대로 보관하고, 공개적으로 문제를 설명할 때 실제 값을 노출하지 마세요.

VLESS: UUID 등의 정보로 사용자를 식별하는 프록시 프로토콜입니다. 이름의 차이를 단순히 속도 차이로 해석해서는 안 됩니다. 연결 보안은 실제 전송 계층과 인증 설정을 함께 확인해야 하며 프로토콜 이름만으로 판단할 수 없습니다. 기존 항목을 가져온 뒤 전송 방식과 관련 보안 매개변수를 확인하고, VMess의 필드 조합을 그대로 적용하지 마세요.

Trojan: 일반적으로 TLS와 함께 사용하는 프록시 프로토콜입니다. 설정할 때 서버 주소, 포트, 비밀번호, 서버 이름을 확인해야 합니다. 연결 주소와 TLS 인증에 사용하는 이름은 다를 수 있으므로 저장된 구성 안내를 기준으로 확인하세요. 인증서 검증에 실패하면 이름, 인증서, 기기 시간을 먼저 확인하고, 검증 생략을 일반적인 해결책으로 사용하지 마세요.

Hysteria2: QUIC 기반 프록시 프로토콜로, 적절한 UDP 통신 환경이 필요합니다. 지연 시간이 길거나 패킷 손실이 있는 환경에서의 실제 성능은 대역폭, 혼잡 상태, 서버 설정에도 영향을 받으므로 프로토콜 이름만으로 보장되지 않습니다. 추가할 때 저장된 정보에 따라 인증, TLS, 해당하는 대역폭 매개변수를 확인하세요. UDP에 연결할 수 없다면 먼저 네트워크 조건을 점검하세요.

WireGuard: 공개 키와 개인 키로 암호화 터널을 구성하는 프로토콜입니다. 일반적으로 키, 엔드포인트, 인터페이스 주소, 라우팅 범위를 설정해야 합니다. 개인 키는 민감한 정보이므로 공개 스크린샷이나 문제 해결 기록에 포함하지 마세요. 엔드포인트 주소만 맞아서는 통신이 완성되지 않으므로 피어의 공개 키와 허용 주소 범위도 함께 확인해야 합니다.

HTTP / SOCKS5: 서로 다른 두 프록시 프로토콜 이름이며, 핸드셰이크와 인증 방식도 각각 다릅니다. 입력할 때는 사용자가 보유한 서버 정보에 지정된 유형을 선택하고, 포트가 같다는 이유로 서로 바꿔 쓰지 마세요. 암호화 전송 여부나 특정 요청 지원 여부는 서버 기능과 클라이언트 설정을 함께 확인해야 합니다.

규칙 키워드

일치 조건과 처리 정책

규칙은 보통 일치 유형, 일치 값, 처리 정책으로 구성됩니다. 먼저 무엇을 검사하는지 확인한 뒤 일치했을 때 어떻게 처리하는지 살펴보세요.

Rules: 구성에서 연결 처리 방식을 판단하는 규칙 모음입니다. 일반적으로 순서대로 검사해 처음 일치하는 규칙을 적용합니다. 구체적인 규칙을 앞에, 범위가 넓은 조건을 뒤에 배치하면 예상치 못한 적용을 줄일 수 있습니다. 규칙은 해당 구성의 처리 경로에서만 판단에 참여하므로, 문제를 확인할 때 Global Routing과 현재 구성을 함께 살펴보세요.

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN은 전체 도메인, DOMAIN-SUFFIX는 도메인 접미사와 하위 도메인, DOMAIN-KEYWORD는 도메인에 포함된 키워드와 일치합니다. 뒤의 두 유형은 적용 범위가 더 넓을 수 있으므로 테스트 요청 하나만으로 영향 범위를 판단하지 마세요. 도메인 규칙에는 도메인만 입력하고 URL 경로, 쿼리 매개변수, 프로토콜 접두사는 포함하지 마세요.

GEOIP: IP 지리 데이터베이스를 기준으로 주소의 지역을 판별한 뒤 해당 정책을 적용합니다. 방문자의 위치나 도메인 접미사가 아니라 대상 IP 주소를 기준으로 판정합니다. 데이터베이스 내용과 DNS 결과가 모두 일치 여부에 영향을 줄 수 있습니다. 문제를 확인할 때는 페이지 언어로 규칙 결과를 추측하지 말고 실제 연결 주소를 확인하세요.

IP-CIDR / IP-CIDR6: 각각 IPv4와 IPv6 주소 대역을 일치시킵니다. 슬래시 뒤의 프리픽스 길이는 주소 범위를 나타냅니다. 단일 주소보다 넓은 네트워크 대역은 더 많은 대상에 영향을 줄 수 있으므로 입력 전에 범위를 확인하세요. 도메인 하나가 여러 주소로 확인될 수 있어 일부 주소만 일치하면 요청 결과가 달라질 수 있습니다.

FINAL: 앞선 규칙이 하나도 일치하지 않을 때 적용되는 최종 규칙으로, 보통 규칙 목록 맨 아래에 둡니다. 나머지 트래픽의 처리 방향을 정하는 규칙이지, 이미 일치한 규칙을 모두 덮어쓰는 스위치는 아닙니다. 일치 조건이 빠진 요청은 이 규칙으로 처리되므로 FINAL의 정책이 존재하고 예상과 일치하는지 확인하세요.

PROXY / DIRECT / REJECT: 규칙의 처리 정책입니다. PROXY는 프록시 정책을, DIRECT는 직접 연결을, REJECT는 연결 거부를 뜻합니다. 예시의 PROXY는 현재 구성에서 사용할 수 있는 정책 또는 정책 그룹에 연결해야 하며, 모든 구성에서 바로 사용할 수 있다고 가정해서는 안 됩니다. 이 정책은 Global Routing의 Proxy, Direct와 서로 다른 계층에 있습니다.

USER-AGENT: 확인 가능한 HTTP 요청의 User-Agent 정보를 기준으로 일치시키며, 기기에 설치된 앱 이름으로 모든 트래픽을 식별하는 기능은 아닙니다. 암호화된 요청에서는 관련 정보가 기본적으로 보이지 않을 수 있으므로 적용 범위는 실제 요청과 구성 조건에 따라 달라집니다. 일치 여부를 판단할 때는 확인 가능한 요청 기록을 살펴보세요. 앱별 트래픽을 나누는 범용 규칙으로 사용해서는 안 됩니다.

규칙 예시: 도메인을 먼저 일치시키고 나머지 트래픽 처리하기

아래 내용은 규칙의 구조를 설명하는 예시일 뿐이며 example.com은 예시 도메인입니다. 사용하기 전에 구성에서 PROXY를 사용할 수 있는지 확인하고, FINAL,DIRECT를 사용하면 일치하지 않은 요청이 직접 연결된다는 점을 이해하세요.

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

Rules 기능 설명 보기 →

구독 및 구성

항목, DNS 확인, 구성 데이터

서버 항목에는 연결 매개변수가, 구성 파일에는 처리 방식이 담깁니다. 가져오기가 완료된 뒤에도 연결 대상과 선택된 구성을 각각 확인해야 합니다.

SERVER: 서버 관련 필드나 영역을 나타내는 화면 표기입니다. 입력할 때 사용자가 보유한 주소 정보를 사용하세요. 서버 항목에는 포트, 프로토콜, 인증, 전송 매개변수도 포함될 수 있으므로 주소만으로는 보통 연결할 수 없습니다. 항목의 표시 이름은 식별을 돕지만, 이름을 바꿔도 실제 연결 대상이나 인증 정보는 바뀌지 않습니다.

Config: 화면 이름으로는 구성 파일을 관리하는 메뉴를 뜻하고, Global Routing에서는 현재 구성 규칙에 따라 처리하는 모드를 뜻합니다. 구성 파일에는 규칙, 정책 및 기타 적용 가능한 설정이 포함될 수 있으며 서버 구독이 구성 파일과 같은 것은 아닙니다. 가져온 뒤 실제로 선택된 파일을 확인해 저장만 된 상태를 적용된 상태로 혼동하지 마세요.

DNS: 도메인을 IP 주소로 변환하는 기능으로, 도메인 요청이 연결되기 전에 거치는 중요한 과정입니다. 서버 연결 자체가 정상이어도 DNS 확인에 실패하면 웹사이트가 열리지 않을 수 있습니다. DNS 설정을 변경할 때는 DNS 요청의 처리 경로와 규칙 조건도 함께 고려하고, 같은 네트워크에서 대상 도메인을 다시 확인하세요.

URL Rewrite: 조건에 따라 처리 대상 요청의 URL을 바꾸는 기능입니다. 요청 대상이나 요청의 일부 내용을 변경하는 기능으로 이해할 수 있습니다. Rules와는 다릅니다. 규칙은 주로 트래픽을 어떤 정책에 맡길지 결정하고, URL 재작성은 요청 자체에 영향을 줍니다. 해당 처리 조건을 만족하는 요청에만 적용되므로 범위를 명확히 확인한 뒤 보유한 구성을 사용하세요.

지연 시간: 테스트 조건에서 측정한 응답 시간으로, 테스트 방식에 따라 연결 설정이나 지정된 대상의 응답에 걸리는 시간이 포함될 수 있습니다. 지연 시간이 낮다고 지속 전송 속도가 빠르거나 모든 대상에 연결할 수 있다는 뜻은 아닙니다. 비교할 때는 테스트 방식, 대상, 네트워크를 동일하게 유지하세요. 한 번의 측정보다 여러 번 관찰한 결과가 더 유용합니다.

iCloud 동기화: 앱에서 제공하는 iCloud 관련 기능으로 지원 데이터를 동기화합니다. 구체적인 동기화 범위는 현재 앱 설정을 기준으로 확인하세요. App Store 구매 기록과는 별개의 기능이므로 앱을 복원해도 구성이 자동으로 나타나지는 않습니다. 기기를 바꾸기 전에 동기화 스위치와 계정, 실제 동기화 결과를 확인하고 인증 정보가 포함된 데이터는 안전하게 보관하세요.

App Store 및 계정

정품 확인, 스토어프런트, 구매 기록

Shadowrocket은 Apple 플랫폼 전용 유료 상용 앱이며 App Store에서만 받을 수 있습니다. 주 사용 기기는 iPhone과 iPad입니다. 시스템 요구 사항과 구매 가능 기기는 App Store 페이지에 표시된 내용을 기준으로 확인하세요.

App Store 정품 확인: 제품 페이지에서 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 확인하세요. 공식 아이콘은 흰색 배경에 파란색과 보라색 테두리의 로켓입니다. 앱 ID는 제품 페이지 URL에서 확인할 수 있습니다. 검색 결과의 이름만으로 판단하지 말고 세 가지 정보를 공식 제품과 대조한 뒤 가격과 호환성도 확인하세요.

스토어 국가 또는 지역: 구매 계정에 연결된 App Store 스토어프런트로, 앱 표시 여부와 통화, 결제 조건에 영향을 줄 수 있습니다. 기기 언어나 현재 위치만으로 스토어프런트를 판단할 수는 없습니다. 계정의 국가 또는 지역 설정을 확인하세요. 지역을 변경하기 전에 계정 잔액, 기존 구독, 결제 수단 등의 조건을 살펴보고 자세한 내용은 스토어 국가 또는 지역 안내를 확인하세요.

구입 항목: App Store에서 기존 구매 기록을 찾아 조건을 충족하는 기기에 앱을 다시 받을 수 있습니다. 기기를 바꾸거나 앱을 다시 설치할 때는 기존 구매 계정으로 로그인했는지 확인한 다음 Shadowrocket을 찾아보세요. 구매 기록으로 복원되는 것은 앱을 받을 수 있는 권한이며 서버 정보, 구독 URL, 구성 파일은 자동으로 복원되지 않습니다.

일회성 구매: 클라이언트 사용 권한을 구매하는 결제 방식입니다. 미국 스토어 가격은 약 2.99달러이며 실제 금액은 스토어 페이지를 기준으로 확인하세요. 클라이언트 일회성 구매 ≠ 회선 요금제. 구매 후에도 사용자가 보유한 구독 또는 서버 정보를 가져와야 합니다. 이후 앱 업데이트는 App Store에서 받을 수 있으며, 사용 가능한 기기와 가족 공유 조건은 제품 페이지를 기준으로 확인하세요.

App Store 정품 확인 및 구매 안내 보기 →