OFFICIAL MANUAL · GLOSSARY

Shadowrocket 용어 정리

인터페이스, 프로토콜, 규칙, 설정, 설치 관련 용어를 찾아보세요. 명칭이 메뉴인지, 연결 방식인지, 규칙 동작인지 먼저 구분한 다음 필요한 설정을 변경하세요.

이 페이지는 Shadowrocket 공식 매뉴얼의 용어 색인입니다. 사용 방법은 빠른 시작 가이드를, 클라이언트 다운로드는 전체 플랫폼 다운로드를 확인하세요.

INTERFACE

인터페이스와 스위치

인터페이스 이름은 조작 위치를 나타내며 규칙 동작과는 다릅니다. 특히 Global Routing의 Config와 파일을 관리하는 Config 화면을 구분해야 합니다.

인터페이스 메뉴

Home

Home은 서버 항목을 확인하고 연결 대상을 선택하거나 연결 스위치를 조작하는 주요 화면입니다. 목록에 항목이 있더라도 연결 매개변수가 저장된 것일 뿐, 연결이 수립됐다는 뜻은 아닙니다. 문제를 확인할 때는 현재 선택 항목, 연결 스위치, 실제 요청 결과를 각각 살펴보세요. 목록에 표시된다는 이유만으로 연결이 정상이라고 판단하지 마세요.

전체 처리 방식

Global Routing

Global Routing은 전체 트래픽 처리 방식을 정합니다. 설정은 Config, 프록시는 Proxy, 직접 연결은 Direct에 해당합니다. Config는 현재 설정의 규칙에 따라 처리하고, Proxy는 프록시 방식, Direct는 직접 연결 방식으로 처리합니다. 이는 규칙에 쓰이는 대문자 PROXY, DIRECT와 다른 단계입니다. 특정 규칙이 적용되는지 판단하기 전에 여기서 선택한 항목을 먼저 확인하세요.

연결 시작 조건

On Demand

On Demand는 설정된 조건에 따라 연결을 시작하거나 유지하는 기능입니다. 구체적인 조건은 현재 화면에서 선택할 수 있는 항목을 기준으로 확인하세요. 서버를 만들거나 빠진 인증 정보를 자동으로 채우지는 않습니다. 연결을 일시 중지하려면 On Demand 조건도 함께 확인하세요. 조건이 다시 충족되면 시스템이 연결을 재개할 수 있습니다.

직접 입력

Add Server

Add Server에서 서버 항목을 직접 만들 수 있습니다. 기존 서버 정보를 확인해 프로토콜 유형을 선택한 뒤 주소, 포트, 인증 항목을 입력하세요. 주소만으로 어떤 프로토콜을 사용하는지 판단할 수 없습니다. TLS, 전송 방식, 서버 이름도 원격 서버 설정과 일치해야 합니다. 저장이 완료되어도 입력한 내용이 받아들여졌다는 뜻일 뿐이므로 연결을 별도로 확인해야 합니다.

진단 도구

Connectivity Test

Connectivity Test는 특정 조건에서 연결 상태를 확인하는 도구입니다. 테스트 대상과 방식은 현재 설정을 기준으로 확인하세요. 테스트에 성공해도 모든 웹사이트나 앱에 접속할 수 있다고 보장하지 않으며, 실패했다고 인증 정보가 잘못됐다고 단정할 수도 없습니다. 결과를 비교할 때는 테스트 방식, 네트워크 환경, 테스트 대상을 동일하게 유지하세요.

도메인 조회

DNS

DNS는 도메인 이름을 IP 주소로 변환합니다. 연결하려면 보통 먼저 사용할 수 있는 조회 결과를 얻어야 합니다. 조회 경로와 캐시, 반환된 주소가 이후 연결 동작을 바꿀 수 있으므로 DNS 문제와 서버 연결 문제를 구분해서 확인하세요. DNS를 변경한 뒤에는 요청을 다시 보내고 로그에서 실제 조회 과정을 살펴보세요. 설정이 저장됐는지만 확인해서는 충분하지 않습니다.

PROTOCOL

프로토콜 유형

프로토콜 유형은 원격 서버와 일치해야 합니다. 드롭다운 옵션만 바꾼다고 서버의 프로토콜이 바뀌지는 않습니다. 속도와 배터리 소모, 안정성은 네트워크와 설정에 따라 달라지므로 프로토콜 이름만으로 순위를 매길 수 없습니다.

암호화 프록시

Shadowsocks

Shadowsocks는 암호화 프록시 전송을 중심으로 하는 프로토콜입니다. 일반적인 연결 항목에는 서버 주소, 포트, 비밀번호, 암호화 방식이 포함됩니다. 양쪽에서 사용하는 암호화 방식이 호환되어야 합니다. 비밀번호가 맞아도 암호화 방식이 일치하지 않으면 연결에 실패할 수 있습니다. 가져온 뒤에는 전체 매개변수를 확인하고, 표시 이름을 프로토콜 버전이나 성능 보장으로 오해하지 마세요.

인증

VMess

VMess는 인증 기능을 갖춘 프록시 프로토콜이며 UUID는 연결 식별에 쓰이는 주요 매개변수입니다. 전송 방식, TLS, 관련 경로 매개변수도 서버 설정과 일치해야 합니다. 기기의 시간이 크게 어긋나도 인증에 영향을 줄 수 있습니다. 연결에 문제가 있으면 UUID만 다시 붙여 넣지 말고 관련 항목 전체를 확인하세요.

간결한 구조

VLESS

VLESS는 간결한 인증과 프로토콜 구조를 강조하며, 이름만으로 연결이 암호화된다고 볼 수는 없습니다. 실제 보안 수준은 함께 사용하는 전송 방식과 보안 계층에 따라 달라집니다. UUID, 서버 이름 등은 서비스 제공업체가 안내한 정보대로 입력하세요. 프로토콜 이름만 바꿔 VMess 설정을 VLESS에 그대로 사용할 수는 없습니다.

TLS 전송

Trojan

Trojan은 일반적으로 TLS 연결에서 동작합니다. 비밀번호는 인증에 사용되며, 서버 이름과 인증서 검증 조건은 보안 연결 수립에 영향을 줍니다. 연결 주소와 인증서에 등록된 이름은 서로 다른 역할을 할 수 있으므로 안내받은 정보에 따라 각각 입력하세요. 인증서 오류가 발생하면 이름, 기기 시간, 서버 인증서를 확인하고 검증을 바로 끄지 마세요.

QUIC

Hysteria2

Hysteria2는 QUIC 기반으로 UDP 경로를 사용하며, 다양한 네트워크 조건에 대응하는 전송 처리를 포함합니다. 실제 성능은 패킷 손실, 혼잡, 서버 부하, 기기 상태에 따라 달라지므로 일정한 속도를 보장할 수 없습니다. 현재 네트워크에서 UDP가 제한된다면 인증이나 대역폭 매개변수를 살펴보기 전에 네트워크 조건부터 확인하세요.

터널 프로토콜

WireGuard

WireGuard는 공개 키로 상대를 식별하고 터널을 통해 IP 트래픽을 전달합니다. 설정에는 키, 엔드포인트, 터널 주소, 라우팅 범위가 포함됩니다. 개인 키는 민감한 정보이므로 공개적으로 도움을 요청할 때 삭제하고, 공개 키와 혼동하지 마세요. 연결 수립과 라우팅 설정은 별개의 문제입니다. 핸드셰이크에 성공한 뒤에도 대상 트래픽이 예상한 경로로 전달되는지 확인해야 합니다.

프록시 인터페이스

HTTP / SOCKS5

HTTP와 SOCKS5는 자주 쓰이는 프록시 인터페이스로, 지원하는 요청 형식과 인증 방식이 서로 다릅니다. 프로토콜 이름만으로 클라이언트와 프록시 서버 사이의 연결이 암호화된다고 보장할 수는 없습니다. 대상 웹사이트가 HTTPS를 사용해도 프록시 구간에서 TLS를 사용한다는 뜻은 아닙니다. UDP 지원 여부와 인증 필요 여부는 실제 서버 기능을 확인하세요.

프로토콜 매개변수와 선택 기준 보기 →

RULE & POLICY

규칙 키워드와 정책

규칙은 '무엇을 일치시킬지'와 '일치한 뒤 어떻게 처리할지'로 구성됩니다. 전자는 조건, 후자는 정책입니다. 일반적으로 구체적인 조건을 포괄적인 조건보다 앞에 둡니다.

일치 순서

Rule

Rule은 설정 파일의 트래픽 분기 규칙입니다. 일반적으로 위에서 아래로 하나씩 확인하고 일치하는 규칙에 지정된 정책을 적용합니다. 규칙이 많다고 더 정확해지는 것은 아닙니다. 앞에 있는 포괄적인 조건이 뒤의 세부 조건보다 먼저 일치할 수 있습니다. 요청을 분석할 때는 먼저 Config 방식이 선택되어 있는지 확인한 뒤 실제로 일치한 규칙과 정책을 살펴보세요.

도메인 조건

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD

DOMAIN은 전체 도메인, DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인, DOMAIN-KEYWORD는 도메인에 포함된 키워드를 기준으로 일치시킵니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인 범위의 요청을 PROXY 정책으로 처리한다는 뜻입니다. 키워드 규칙의 범위는 넓을 수 있으므로 짧은 단어가 관련 없는 도메인에 잘못 일치하지 않도록 주의하세요.

IP 분류

GEOIP

GEOIP는 IP 지리 데이터베이스를 바탕으로 대상 주소를 분류합니다. 웹페이지 언어나 웹사이트 이름을 기준으로 판단하지 않습니다. 데이터베이스 기록과 실제 서버 위치가 다를 수 있고, 한 웹사이트가 여러 지역의 주소를 사용할 수도 있습니다. IP 정보만 있는 경우에는 도메인 규칙과 사용할 수 있는 조건이 다르므로 요청에서 어떤 정보를 확인할 수 있는지 살펴보세요.

주소 범위

IP-CIDR / IP-CIDR6

IP-CIDR은 IPv4 주소 범위, IP-CIDR6은 IPv6 주소 범위에 일치합니다. 슬래시 뒤의 프리픽스 길이가 적용 범위를 결정하며, 숫자가 클수록 일반적으로 범위가 좁습니다. 도메인은 여러 주소로 해석될 수 있습니다. IPv4 조건만 설정하면 IPv6 연결이 포함되지 않을 수 있으므로 실제 조회 결과를 확인해 일치 여부를 판단하세요.

기본 규칙

FINAL

FINAL은 앞선 규칙에 일치하지 않은 요청을 처리하며 규칙 목록의 마지막에 두어야 합니다. 예를 들어 FINAL,DIRECT는 나머지 요청을 DIRECT로 처리한다는 뜻이지, 앞에서 이미 일치한 요청도 직접 연결로 바꾼다는 뜻은 아닙니다. 많은 요청이 FINAL에 해당한다면 앞선 규칙이 대상 범위를 포함하는지, 현재 설정이 선택되어 있는지 확인하세요.

규칙 동작

PROXY / DIRECT / REJECT

PROXY는 프록시 정책을, DIRECT는 대상에 직접 연결하는 것을, REJECT는 일치한 요청을 거부하는 것을 뜻합니다. 이는 규칙 동작이며 Global Routing의 Proxy, Direct 인터페이스 옵션과 구분해야 합니다. REJECT는 일치 조건에 따라 동작합니다. 같은 도메인이라도 콘텐츠가 다르면 도메인이나 IP 규칙만으로 구분하지 못할 수 있습니다.

측정 결과

지연 시간

지연 시간은 특정 테스트 방식에서 요청과 응답에 걸리는 시간을 말하며 보통 밀리초로 표시합니다. 사용 가능한 대역폭으로 환산할 수 없고, 지속적인 다운로드나 동영상 요청의 성능을 보장하지도 않습니다. 결과를 비교할 때는 같은 테스트 방식을 사용하고 패킷 손실, 변동 폭, 실제 서비스 요청도 함께 확인하세요. 숫자가 가장 낮은 항목만 고르지 마세요.

SUBSCRIBE & CONFIG

구독 및 설정 파일

서버 항목은 어디에 연결할지 설명하고, 설정 파일은 요청을 어떻게 처리할지 정합니다. 서버 목록 업데이트와 설정 전환은 서로 다른 작업이므로 결과를 혼동하지 마세요.

목록 업데이트

Subscribe / 구독

구독은 링크를 통해 서버 항목 묶음을 가져오고 업데이트하는 방식입니다. 링크는 서비스 제공업체에서 받아야 합니다. 링크에 개인 인증 정보가 포함될 수 있으므로 스크린샷이나 문의 내용에 공개적으로 붙여 넣지 마세요. 업데이트 실패는 링크 접속, 응답 형식, 내용 분석 단계에서 발생할 수 있습니다. 오류 메시지를 기준으로 원인을 구분하고 모든 서버가 만료됐다고 단정하지 마세요.

원격 엔드포인트

서버

서버는 클라이언트가 연결하는 원격 엔드포인트입니다. 저장된 항목에는 일반적으로 프로토콜, 주소, 포트, 인증 정보가 포함됩니다. 이런 연결 항목을 흔히 '노드'라고 부르지만, 클라이언트에 서비스가 내장되어 있다는 뜻은 아닙니다. 표시 이름은 항목을 구분하기 위한 것으로 물리적 위치, 사용 가능한 대역폭, 이용 기간을 증명하지 않습니다. 관련 정보는 서비스 제공업체에 확인하세요.

설정 관리

Config / .conf

Config는 설정 관리 화면을 뜻할 수 있고, .conf는 흔히 사용하는 설정 파일 확장자입니다. 파일에는 General, Rule, Host 등의 섹션이 들어갈 수 있습니다. Global Routing의 Config는 설정 규칙에 따라 트래픽을 처리한다는 뜻으로, 이름은 같지만 용도가 다릅니다. 파일을 다운로드하거나 편집한 뒤에는 예상한 설정이 선택되어 있는지 확인하고 실제 요청으로 적용 여부를 살펴보세요.

파일 섹션

General / Host

General에는 설정에서 사용하는 DNS 등 전역 매개변수를 지정합니다. Host에는 로컬 도메인 매핑을 지정합니다. Host는 특정 도메인의 조회 결과를 바꾸지만, 일치 후 적용되는 라우팅 정책을 바꾸지는 않습니다. 주소를 장기간 고정하면 서버 주소 변경과 충돌할 수 있으므로 문제가 발생하면 해당 매핑이 여전히 필요한지 확인하세요.

요청 처리

URL Rewrite

URL Rewrite는 지정한 조건에 따라 요청 URL을 처리하며 구체적인 동작은 일치 표현식과 동작 설정에 따라 달라집니다. 모든 웹페이지 콘텐츠에 적용되는 범용 치환 기능은 아닙니다. 일치 여부는 요청에서 확인할 수 있는 정보와 관련 처리 조건에 따라 달라집니다. 수정하기 전에 규칙의 대상과 적용 범위를 파악하고 출처가 불분명한 재작성 설정을 일상적인 연결에 바로 적용하지 마세요.

가져오기 메뉴

Scan QR Code

Scan QR Code는 QR 코드에 담긴 텍스트를 읽습니다. 가져올 수 있는지는 링크 형식과 지원되는 필드인지에 따라 달라집니다. QR 코드는 정보를 담는 수단일 뿐, 일반 웹페이지 주소를 서버 설정으로 자동 변환하지 않습니다. 가져온 뒤에도 프로토콜, 주소, 매개변수를 확인하고 인증 정보가 포함된 QR 코드를 공개하지 마세요.

.conf 각 섹션의 역할 더 알아보기 →

PLATFORM & INSTALL

플랫폼과 설치

Shadowrocket은 iPhone, iPad, Mac, Windows, Android, Linux 버전을 제공합니다. 다운로드 경로, 프로세서 아키텍처, 시스템 설치 확인은 서로 다른 사항이므로 기기별로 확인하세요.

구입 내역

App Store / 구입 항목

App Store는 iPhone / iPad 버전을 다운로드하는 경로입니다. 구입 항목에서 구매 당시 사용한 Apple ID에 연결된 앱 내역을 찾을 수 있습니다. 다시 다운로드할 수 있는지는 스토어 제공 여부와 기기 호환성에 따라 달라집니다. 정품을 확인할 때는 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 확인하세요. 시스템 요구 사항은 App Store 페이지 표기를 기준으로 합니다. iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제, Mac / Windows / Android / Linux 버전은 무료입니다.

프로세서 아키텍처

Apple 실리콘 / Intel

두 명칭은 Mac의 프로세서 아키텍처를 구분합니다. '이 Mac에 관하여'에서 칩 또는 프로세서 정보를 확인한 뒤 해당 설치 파일을 선택하세요. 이 사이트에서는 Shadowrocket의 Apple 실리콘 버전과 Intel 버전 dmg 파일을 각각 제공합니다. 컴퓨터 외관이나 구입 연도만으로 아키텍처를 추측하지 마세요. 처음 실행할 때 시스템이 차단하면 이 사이트에서 받은 파일인지 확인한 뒤 아래 설치 허용 안내를 따르세요.

시스템 확인

설치 허용

설치 허용은 파일의 출처를 확인한 뒤 시스템 알림이나 보안 설정에서 실행을 승인하는 작업입니다. 데스크톱 및 Android 설치 파일에는 코드 서명이 없으며, 설치 파일은 이 사이트의 /dl/shadowrocket/에서만 받을 수 있습니다. macOS에서는 '개인정보 보호 및 보안'에서 '그래도 열기'를 선택하고, Windows SmartScreen에서는 '추가 정보 → 실행'을 선택할 수 있습니다. Android에서는 현재 다운로드 출처에 알 수 없는 앱 설치를 허용하세요. Linux AppImage는 먼저 실행 권한을 부여해야 합니다. 자세한 단계는 설치 허용 안내표를 확인하고 시스템 보호 기능을 전체적으로 끄지 마세요.

비용 안내

클라이언트 일회성 구매

iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제, Mac / Windows / Android / Linux 버전은 무료입니다. 실제 결제 금액은 해당 지역 스토어 페이지를 기준으로 합니다. 클라이언트 일회성 구매 ≠ 회선 요금제입니다. 클라이언트를 구매해도 구독 링크, 서버 계정, 서비스 이용 기간이 제공되지 않습니다. 기존 구독은 서비스 제공업체가 관리하며, 클라이언트는 정보를 가져와 설정에 따라 연결을 처리합니다.

Shadowrocket 전체 플랫폼 다운로드