공식 매뉴얼 · 용어 빠른 검색

Shadowrocket 용어집

먼저 용어가 표시된 위치를 확인한 뒤 인터페이스 메뉴, 프로토콜 매개변수, 규칙 정책 중 무엇을 가리키는지 살펴보세요. 영어 원문은 그대로 두고, 한국어 설명으로 기능과 적용 범위를 안내합니다.

인터페이스 용어 ≠ 규칙 정책 키워드 서버 항목 ≠ 구성 파일 테스트 응답 ≠ 실제 서비스 사용 가능 여부

01 · 인터페이스 및 스위치

메뉴와 라우팅 모드

같은 단어라도 표시되는 위치에 따라 의미가 달라질 수 있습니다. 특히 Global Routing의 Config / Proxy / Direct와 규칙에 쓰이는 대문자 정책 키워드를 구분해야 합니다.

Home

Home은 서버 항목을 확인하고 연결 대상을 선택하거나 연결 스위치를 조작하는 주요 화면입니다. 추가한 항목이 목록에 보인다는 것은 매개변수가 저장됐다는 뜻일 뿐, 서버에 접속할 수 있다는 의미는 아닙니다. 처음 사용할 때는 기존 서버 정보를 확인하고 항목을 선택한 뒤 시스템 권한을 설정하세요.

Global Routing

Global Routing은 전체 라우팅 모드를 결정합니다. 주로 Config, Proxy, Direct를 선택할 수 있으며 각각 구성, 프록시, 직접 연결을 뜻합니다. Config는 현재 구성에 따라 요청을 처리하고, Proxy는 프록시 모드, Direct는 직접 연결 모드로 처리합니다. 규칙이 적용되지 않는 문제를 살피기 전에 이 설정을 확인해 잘못된 모드에서 규칙을 반복 수정하지 않도록 하세요.

Config

Config는 구성 파일을 관리하는 메뉴일 수도 있고, Global Routing에서 선택하는 구성 모드일 수도 있습니다. 메뉴에서는 구성을 확인하고 선택하며, 라우팅 모드에서는 현재 구성의 규칙에 따라 요청을 처리합니다. Config 화면을 열었다고 해서 특정 구성이 선택된 것은 아니므로 현재 사용 중인 파일을 확인해야 합니다.

Proxy

Proxy는 Global Routing에서 요청을 프록시 방식으로 처리하는 모드입니다. 규칙 항목의 PROXY와 관련은 있지만 같은 설정 위치가 아니며, 서버 프로토콜을 직접 지정하지도 않습니다. Proxy로 전환한 뒤에도 연결 대상과 인증 매개변수를 확인해야 합니다. 모드 변경으로 잘못된 서버 정보가 해결되지는 않습니다.

Direct

Direct는 Global Routing의 직접 연결 모드입니다. 선택한 프록시 서버를 거치지 않고 현재 네트워크를 통해 대상에 직접 접속합니다. Direct를 선택해도 서버 항목이 삭제되거나 구성 파일이 비워지지는 않습니다. 비교 테스트에서는 대상 주소와 다른 조건을 동일하게 유지하고, 테스트가 끝나면 원래 라우팅 모드로 되돌리세요.

On Demand

On Demand는 설정된 네트워크 조건에 따라 연결 동작을 시작하는 기능이며, 단순한 속도 최적화 옵션이 아닙니다. 실제 동작은 앱의 조건 설정, 시스템 VPN 구성, 현재 네트워크에 따라 달라집니다. 수동으로 연결을 끈 뒤 다시 시작된다면 On Demand 조건을 확인하고 중복되거나 남아 있는 시스템 구성도 살펴보세요.

Data

Data에서는 앱에 기록된 트래픽 및 요청 관련 정보를 확인할 수 있습니다. 요청이 클라이언트를 거쳤는지, 어떤 처리 경로를 따랐는지 파악하는 데 도움이 됩니다. 통계 범위는 기록 방식과 집계 시간에 따라 달라 서비스 제공업체의 과금 기준과 일치하지 않을 수 있습니다. 트래픽 차이를 비교할 때는 양쪽의 집계 시작 및 종료 시간을 먼저 확인하세요.

Settings

Settings에서 앱 설정을 관리할 수 있으며, 실제 항목은 현재 앱 화면에 표시되는 내용을 기준으로 합니다. 서버 항목과 달리 일부 설정은 하나의 연결 대상이 아니라 앱 전반의 동작에 영향을 줄 수 있습니다. 문제를 점검할 때는 관련 항목을 한 번에 하나씩 변경하고 기존 값을 기록해 재현 가능한 비교 조건을 유지하세요.

Connectivity Test

Connectivity Test는 선택한 테스트 방식으로 연결 응답을 확인하며, 기본적인 접속 가능 여부를 살펴보는 데 적합합니다. 테스트에 성공해도 테스트 대상과 실제 서비스가 다를 수 있으므로 모든 웹사이트, 앱 요청, 지속 연결이 정상이라고 볼 수는 없습니다. 실패한 경우에도 시간 초과, 대상 접속 불가, 매개변수 오류를 구분한 뒤 실제 접속 결과와 함께 판단하세요.

02 · 프로토콜

연결 매개변수 유형

프로토콜 이름은 매개변수를 해석하는 방식을 나타내며 속도나 안정성 순위를 뜻하지 않습니다. 아래 설명은 사용자가 이미 자신의 서버 정보를 보유하고 있다는 전제이며, 입력값은 서버 측 요구 사항과 일치해야 합니다.

Shadowsocks

Shadowsocks는 프록시 프로토콜의 하나로, 일반적인 매개변수에는 서버 주소, 포트, 암호화 방식, 비밀번호가 포함됩니다. 암호화 방식과 비밀번호는 서버 측 설정과 일치해야 하며, 주소와 포트만으로 정상 연결을 만들 수는 없습니다. 기존 정보에 추가 전송 매개변수가 있다면 항목별로 확인하고 다른 프로토콜의 필드를 그대로 적용하지 마세요.

VMess

VMess는 인증을 사용하는 프록시 프로토콜이며 ID와 전송 방식 모두 연결 구성의 일부입니다. 항목을 가져온 뒤 주소, 포트, ID와 기존 정보에 명시된 TLS, 경로, 서버 이름 등의 값을 확인하세요. QR 코드가 인식됐다는 것은 형식을 파싱할 수 있다는 뜻일 뿐, 모든 항목이 서버 설정과 일치한다는 의미는 아닙니다.

VLESS

VLESS는 프록시 프로토콜의 하나입니다. ID와 전송 보안 설정은 서로 다른 매개변수입니다. VLESS를 선택하고 ID를 입력하는 것만으로 서버에서 요구하는 전송 방식과 보안 설정을 대신할 수는 없습니다. 연결에 실패하면 기존 정보를 기준으로 항목을 하나씩 확인하고, 이름이 비슷한 매개변수를 올바른 위치에 입력했는지 살펴보세요.

Trojan

Trojan은 일반적으로 TLS와 함께 사용하며 비밀번호, 서버 이름, 인증서 검증을 각각 확인해야 합니다. 연결 주소는 IP일 수 있지만 TLS 검증에 쓰는 서버 이름은 도메인일 수 있으며 둘의 용도는 다릅니다. 인증서 오류가 발생하면 먼저 기기의 시간, 서버 이름, 서버 구성을 확인하세요. 인증서 검증을 끄는 것을 일반적인 해결책으로 삼아서는 안 됩니다.

Hysteria2

Hysteria2는 QUIC 기반 프록시 프로토콜이며 현재 네트워크에서 관련 UDP 통신을 지원해야 작동합니다. 설정할 때 인증 정보와 TLS 매개변수, 기존 서버 정보에 명시된 추가 항목을 확인하세요. 직접 연결 상태에서 일반 웹페이지를 열 수 있어도 이 프로토콜의 전송 경로가 작동한다는 뜻은 아닙니다. 문제를 점검할 때 네트워크 연결 가능 여부와 인증 오류를 구분하세요.

WireGuard

WireGuard는 키 쌍을 사용하는 터널 프로토콜입니다. 로컬 키, 피어 공개 키, 인터페이스 주소, 피어 엔드포인트, 라우팅 범위를 설정해야 합니다. 공개 키와 개인 키는 역할이 다르므로 개인 키는 민감한 정보로 안전하게 보관하세요. 문제를 점검할 때 엔드포인트 접속 가능 여부뿐 아니라 주소와 허용된 라우팅 범위가 피어 설정과 일치하는지도 확인해야 합니다.

HTTP / SOCKS5

HTTP와 SOCKS5는 서로 다른 프록시 프로토콜 유형이므로 같은 서버 주소를 사용한다고 해서 임의로 바꿔 쓸 수는 없습니다. 요청 처리 방식과 대상 주소를 다루는 방법이 다르며 인증 방식과 전송 보안도 각각 확인해야 합니다. 기존 프록시 정보를 입력할 때는 유형을 먼저 확인한 다음 포트와 인증 항목을 설정하세요. 흔히 쓰이는 포트 번호만으로 프로토콜을 추측해서는 안 됩니다.

03 · 규칙 키워드 및 정책

매칭 조건과 처리 결과

규칙은 “요청이 어떤 조건에 해당하는가”를, 정책은 “일치한 요청을 어떻게 처리하는가”를 나타냅니다. 아래 예시는 문법 설명용이며 example.com은 실제 연결 서비스가 아닌 예시 도메인입니다.

규칙

규칙은 보통 매칭 유형, 매칭 값, 정책으로 구성됩니다. 예: DOMAIN-SUFFIX,example.com,DIRECT. 일반적인 순차 매칭 구성에서는 요청을 규칙 순서대로 확인하며 앞에서 일치한 항목이 이후 처리에 영향을 줍니다. Global Routing이 Config 모드가 아니라면 규칙을 수정해도 예상과 다르게 동작할 수 있으므로 먼저 라우팅 모드를 확인하세요.

DOMAIN / DOMAIN-SUFFIX

DOMAIN은 전체 도메인과 일치시키고, DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인에 일치시킵니다. 예를 들어 후자에 example.com을 입력하면 api.example.com도 포함됩니다. 두 키워드는 전체 URL이 아니라 도메인을 매칭하므로 경로, 쿼리 매개변수, 프로토콜 접두어를 도메인 조건에 넣어서는 안 됩니다.

DOMAIN-KEYWORD

DOMAIN-KEYWORD는 도메인에 포함된 키워드로 매칭하며, 관련 이름 여러 개를 함께 처리해야 할 때 사용할 수 있습니다. 키워드가 너무 짧으면 용도가 다른 도메인까지 일치할 수 있습니다. 거부 정책에 적용하기 전에 실제 요청 기록을 확인하세요. 특정 도메인 하나만 매칭하려면 더 정확한 조건을 우선 고려하세요.

IP-CIDR / IP-CIDR6

IP-CIDR은 IPv4 대역을, IP-CIDR6은 IPv6 대역을 매칭하며 슬래시 뒤 숫자는 네트워크 접두사 길이를 나타냅니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT는 IPv4 사설 주소 범위를 지정합니다. 도메인 요청이 언제 조회되어 주소 매칭에 포함되는지는 구성 옵션의 영향을 받으므로 IP 대역 규칙을 도메인 접미사 규칙처럼 사용하면 안 됩니다.

GEOIP

GEOIP는 IP 지리 위치 데이터베이스를 기준으로 대상 주소를 매칭하며 웹페이지 언어나 사용자의 위치를 기준으로 판단하지 않습니다. 주소의 지리적 분류는 데이터베이스 내용과 네트워크 구성에 따라 달라질 수 있으므로 웹사이트 운영자의 소재지를 직접 나타내지는 않습니다. 도메인에서 서로 다른 주소가 조회되면 매칭 결과도 달라질 수 있으니 현재 DNS 조회 결과와 함께 확인하세요.

FINAL

FINAL은 앞선 규칙에 일치하지 않은 요청을 처리하며 보통 규칙 목록의 마지막에 둡니다. FINAL,PROXY는 나머지 요청에 PROXY 정책을 적용한다는 뜻이지 모든 요청이 프록시를 거친다는 뜻은 아닙니다. 기본 정책을 확인할 때는 앞부분에 범위가 지나치게 넓어 먼저 일치하는 규칙이 있는지도 살펴보세요.

PROXY / DIRECT / REJECT

PROXY, DIRECT, REJECT는 규칙에서 각각 프록시, 직접 연결, 거부를 뜻하는 대문자 정책 키워드입니다. PROXY가 사용할 연결 대상은 현재 구성과 선택 상태를 함께 확인해야 합니다. REJECT는 일치한 요청을 거부하므로 조건 범위가 넓으면 로그인, 이미지 또는 앱 인터페이스에 영향을 줄 수 있습니다. 특정 유형의 콘텐츠를 완전히 필터링하는 기능과 같지는 않습니다.

DNS

DNS는 도메인을 주소로 변환하며 대상에 접속하기 전에 거치는 중요한 단계입니다. DNS 조회 경로와 서비스 요청의 라우팅은 관련은 있지만 서로 다른 설정입니다. 도메인이 조회된다고 해서 이후 연결까지 성공한다는 뜻은 아닙니다. 문제를 점검할 때는 DNS 조회 실패, 잘못된 주소, 연결 실패를 구분한 다음 현재 구성의 DNS 서버와 규칙 동작을 확인하세요.

URL Rewrite

URL Rewrite는 구성의 매칭 조건에 따라 URL을 바꾸거나 요청을 처리하는 기능으로, 도메인만 확인해 정책을 선택하는 라우팅 규칙과 다릅니다. 특정 요청에 적용되는지는 요청 유형, 확인 가능한 정보, 관련 구성 조건에 따라 달라집니다. 사용하기 전에 매칭 범위를 파악하고 복구할 수 있도록 기존 구성을 보관하세요. 이를 통해 모든 페이지나 앱의 동작이 바뀐다고 보장할 수는 없습니다.

04 · 구독 및 구성

가져오기와 유지 관리

아래 절차는 사용자가 자신의 구독 또는 서버 정보를 이미 보유한 경우를 전제로 합니다. 가져올 항목이 단일 연결 정보인지, 서버 목록인지, 구성 파일인지 먼저 확인한 다음 해당 메뉴를 선택하세요.

SERVER / Add Server

SERVER는 서버 항목을 뜻하고 Add Server는 연결 매개변수를 추가하는 메뉴입니다. 항목에는 보통 유형, 주소, 포트와 해당 프로토콜에 필요한 인증 및 전송 설정이 포함됩니다. 메모 이름은 항목을 구분하기 위한 라벨일 뿐 실제 매개변수를 대신하지 않습니다. 저장한 뒤에는 항목을 선택하고 실제 연결을 확인해야 합니다.

Scan QR Code

Scan QR Code는 QR 코드를 스캔해 안에 포함된 연결 정보를 인식하는 기능입니다. QR 코드는 데이터를 담는 수단일 뿐입니다. 스캔 전에 출처를 확인하고 인식한 뒤에는 항목 이름만 보지 말고 프로토콜, 주소, 필수 매개변수를 점검하세요. 구독 인증 정보나 로그인 데이터가 포함된 QR 코드도 민감한 정보로 취급해야 합니다.

구성 파일

구성 파일은 규칙, DNS, 정책 및 지원되는 기타 설정을 관리하며 단일 서버 항목과는 역할이 다릅니다. 서버 목록은 “어떤 연결 대상이 있는가”를 보여주고 구성 파일은 “각 요청을 어떤 경로로 처리하는가”를 정할 수 있습니다. 파일을 가져온 뒤 현재 선택된 구성을 확인하고 수정하기 전에 사본을 보관해 기존 동작과 비교할 수 있도록 하세요.

구독 업데이트

구독을 업데이트하면 구독 주소에 다시 요청을 보내고 응답 내용을 파싱합니다. 서비스 제공업체가 목록을 변경한 경우 업데이트를 통해 변경 사항을 반영해야 합니다. 요청 성공 여부, 내용 파싱 여부, 항목 변경 여부는 각각 따로 확인해야 합니다. 업데이트 후 목록이 비어 있다면 링크가 올바른지, 제공업체 측 상태와 응답 내용을 확인하세요. 같은 주소를 반복해서 추가하는 것으로 문제를 해결하려고 하지 마세요.

지연 시간

지연 시간은 특정 테스트 방식으로 측정한 응답 시간이며 측정 대상과 방법에 따라 결과가 달라집니다. 지연 시간이 낮다고 전송 속도가 빠르다는 뜻은 아니며 장시간 연결의 안정성을 보장하지도 않습니다. 결과를 비교할 때는 테스트 대상, 네트워크, 시간 조건을 가능한 한 동일하게 유지하고 실제 서비스 접속도 함께 확인하세요.

iCloud 동기화

iCloud 동기화는 앱에서 지원하는 데이터를 여러 기기 간에 동기화하는 기능이며 구체적인 범위와 옵션은 앱에 표시되는 내용을 기준으로 합니다. 데이터 동기화와 App Store 구매 복원은 별개의 절차입니다. 전자는 콘텐츠를 동기화하고 후자는 앱을 받을 수 있는 구매 자격을 처리합니다. 기기를 바꾸기 전에 동기화 설정과 실제 반영 여부를 확인하고 중요한 구성은 별도로 보관하세요. 계정에 로그인했다는 이유만으로 모든 콘텐츠가 동기화됐다고 가정해서는 안 됩니다.

기존 정보를 단계별로 가져오기 → 구독 파싱 문제 직접 점검하기 →

05 · App Store 및 계정

구매 계정 및 복원 기록

Shadowrocket은 Apple 플랫폼에서만 제공되며 주로 iPhone 및 iPad에서 사용할 수 있습니다. Mac, Apple TV, Apple Vision의 호환성 및 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다.

App Store

App Store는 Shadowrocket을 받을 수 있는 유일한 경로입니다. 가격, 호환성, 업데이트 기록은 제품 페이지에서 확인하세요. 정식 앱인지 확인할 때는 개발자 Shadow Launch Technology Limited, 공식 앱 아이콘, 앱 ID 932747118을 살펴보세요. 이름이 비슷하거나 검색 결과에서 위쪽에 나온다는 이유만으로 판단하지 말고 이 세 가지를 모두 확인해야 합니다.

Apple 계정 / 스토어 국가 또는 지역

미디어 및 구입 항목에 사용하는 Apple 계정은 스토어 구매 계정이며 iCloud 계정과 다를 수 있습니다. 스토어 국가 또는 지역에 따라 앱 표시 여부, 현지 통화, 결제 조건이 달라질 수 있으며 기기 언어만으로 결정되지는 않습니다. 앱을 검색할 수 없거나 구매 복원에 실패하면 현재 스토어 계정과 국가·지역 설정을 확인한 뒤 구매 당시 사용한 계정인지 살펴보세요.

구입 항목

구입 항목에서 이전에 구매한 앱을 찾아 다시 받을 수 있으며 메뉴 이름과 위치는 시스템 인터페이스에 따라 달라질 수 있습니다. 기기를 바꾸거나 앱을 다시 설치할 때는 App Store에서 구매할 당시 사용한 Apple 계정으로 로그인했는지 확인한 뒤 Shadowrocket을 찾아보세요. 앱을 다시 받는 것과 서버, 구독, 구성 데이터를 복원하는 것은 별개의 절차입니다. 후자는 앱 데이터와 백업도 확인해야 합니다.

일회성 구매

일회성 구매는 앱 결제 방식을 뜻하며 Shadowrocket은 상용 폐쇄형 앱입니다. 미국 스토어 가격은 약 2.99달러이며 각 스토어에서는 현지 통화로 표시됩니다. 실제 금액은 App Store 페이지를 기준으로 합니다. 앱의 일회성 구매는 연결 서비스 요금제와 다르며, 앱 구매에 사용자의 연결 서버에 필요한 구독이나 인증 정보가 포함되지는 않습니다.

정식 앱 확인 절차 보기 → App Store에서 받는 방법 보기 →