공식 매뉴얼 · 용어 정리

Shadowrocket 용어 정리

먼저 화면 옵션, 프로토콜 이름, 규칙 키워드를 구분한 뒤 관련 설정을 확인하세요. 자주 쓰이는 용어를 다섯 가지 범주로 정리했습니다. 영문은 앱에 표시되는 그대로 두고, 용도와 적용 범위, 혼동하기 쉬운 점을 설명합니다.

화면 및 설정

전체 처리 방식, 자동 연결 조건, 서버 정보 입력은 각각 다른 기능입니다. 설정을 바꾸기 전에 연결 경로를 바꾸려는 것인지, 연결 조건을 바꾸려는 것인지 먼저 확인하세요.

화면 및 설정

Global Routing

전체 트래픽 처리 방식을 선택하는 설정으로, Config, Proxy, Direct 세 가지 옵션이 있습니다. 각각 구성에 따른 처리, 프록시 연결, 직접 연결을 의미합니다. 연결 처리 방식을 정하는 기능이지 서버 주소나 인증 정보를 입력하는 기능은 아닙니다. 서버를 가져온 뒤에도 현재 선택된 옵션을 별도로 확인해야 합니다.

Global Routing 사용 방법 보기 →
화면 및 설정

Config

Global Routing에서 Config를 선택하면 현재 활성화된 구성과 규칙에 따라 연결이 처리됩니다. 모든 연결이 프록시를 통과한다는 뜻은 아닙니다. Config는 구성 관리 메뉴에도 표시될 수 있으므로, 설명을 볼 때는 해당 화면에서 모드 옵션을 가리키는지 구성 파일 자체를 가리키는지 구분하세요.

화면 및 설정

Proxy

Global Routing의 Proxy 옵션은 일반적으로 선택한 프록시 경로를 통해 트래픽을 처리합니다. 진단할 때 규칙 매칭의 영향을 일시적으로 줄이는 데 사용할 수 있습니다. 이 옵션을 선택해도 잘못된 서버 매개변수가 수정되거나 모든 서비스에 정상적으로 접속할 수 있게 되는 것은 아닙니다. 테스트가 끝나면 사용 목적에 맞는 옵션으로 되돌리세요.

화면 및 설정

Direct

Global Routing의 Direct 옵션은 선택한 원격 프록시를 사용하지 않고, 일반적으로 로컬 네트워크를 통해 대상에 직접 연결합니다. 로컬 네트워크와 프록시 경로의 연결 상태를 비교할 때 사용할 수 있습니다. Direct로 바꿔도 앱의 연결 스위치가 꺼지는 것은 아니며, 대상 서비스에 반드시 접속할 수 있다는 뜻도 아닙니다.

화면 및 설정

On Demand

On Demand는 설정 조건에 따라 연결을 시작하는 온디맨드 기능입니다. 구체적인 조건은 현재 앱 설정에서 확인하세요. Global Routing과 역할이 다릅니다. On Demand는 연결을 시작하는 시점을, Global Routing은 트래픽을 처리하는 방식을 정합니다. 기능을 켠 뒤에도 서버가 사용 가능한지 확인하고, 수동으로 연결을 끊은 후 실제로 언제 다시 연결되는지 살펴보세요.

화면 및 설정

Add Server

Add Server는 기존 서버 정보를 직접 입력하는 메뉴입니다. 프로토콜에 따라 표시되는 항목이 다를 수 있습니다. 먼저 올바른 유형을 선택한 다음 주소, 포트, 인증, 전송 방식, TLS 설정을 하나씩 확인하세요. 표시 이름은 기기에서 서버를 구분하기 위한 이름일 뿐이며, 이름을 바꿔도 연결 매개변수는 달라지지 않습니다.

서버 항목 설명 보기 →

프로토콜

프로토콜에 따라 양쪽에서 인증하고 데이터를 전송하는 방식이 정해집니다. 다음 설명은 기존 서버 설정을 이해하기 위한 것으로, 프로토콜 이름만으로 속도나 안정성을 판단할 수는 없습니다.

프로토콜

Shadowsocks

Shadowsocks는 서버 주소, 포트, 비밀번호, 암호화 방식 등을 사용하는 프록시 프로토콜입니다. 클라이언트와 서버의 암호화 방식이 일치해야 합니다. 비밀번호가 같다는 이유만으로 설정이 올바르다고 볼 수는 없습니다. 서비스 제공업체가 추가 매개변수를 안내했다면 원본 정보와 함께 확인하세요.

프로토콜

VMess

VMess는 사용자 식별 정보 등을 사용해 인증합니다. UUID가 주요 항목인 경우가 많지만, 연결에 필요한 정보가 UUID만 있는 것은 아닙니다. 해당되는 경우 전송 방식, 경로, 호스트 이름, TLS 설정도 확인하세요. UUID가 같아도 서로 다른 서버 항목을 바꿔 쓸 수 있는 것은 아니며, 기기 시간이 맞지 않으면 인증에 영향을 줄 수 있습니다.

프로토콜

VLESS

VLESS는 UUID로 사용자를 식별합니다. 프로토콜 자체는 데이터를 암호화하지 않으며, 연결 보호 여부는 전송 방식과 보안 설정에 따라 달라집니다. 입력할 때 UUID, 전송 유형, 서버 이름과 서비스 제공업체가 지정한 다른 항목을 함께 확인하세요. UUID를 사용한다는 이유만으로 VMess 설정을 그대로 적용해서는 안 됩니다.

기존 서버 매개변수 확인 →
프로토콜

Trojan

Trojan은 일반적으로 TLS를 통해 연결하며, 비밀번호와 서버 이름을 특히 꼼꼼히 확인해야 합니다. 서버 주소는 네트워크 연결에 사용되고, TLS 서버 이름은 핸드셰이크와 인증서 검증에 사용되므로 둘이 다를 수 있습니다. 인증서 오류가 발생하면 먼저 서버 이름, 기기 시간, 서버 인증서 상태를 확인하세요.

연결 매개변수 확인 방법 보기 →
프로토콜

HTTP / SOCKS5

HTTP와 SOCKS5는 자주 사용되는 프록시 프로토콜로, 인증 방식과 지원하는 트래픽 범위가 서로 다릅니다. 프로토콜 이름만으로 전송이 암호화된다고 볼 수 없으며, 추가 보호를 사용하는지는 설정에 따라 달라집니다. 입력할 때 유형, 주소, 포트와 서버에서 사용자 이름 및 비밀번호를 요구하는지 확인하세요.

프로토콜

WireGuard

WireGuard는 키 기반 터널 프로토콜로, 로컬 개인 키, 피어 공개 키, 엔드포인트 주소, 터널 주소 등의 정보가 필요할 수 있습니다. 라우팅 범위에 따라 터널을 통과하는 트래픽도 달라지므로 키만 확인해서는 안 됩니다. 개인 키는 민감한 인증 정보이므로 설정을 정리하거나 도움을 요청할 때 가려야 합니다.

프로토콜

Hysteria2

Hysteria2는 QUIC 기반으로 UDP를 사용하며, 실제 연결 상태는 패킷 손실, 왕복 시간, 대역폭, 서버 설정에 따라 달라집니다. 모든 네트워크에서 더 빠른 것은 아닙니다. 현재 네트워크에서 UDP가 제한되는지 먼저 확인한 다음 전송 경로와 인증 및 TLS 설정을 살펴보세요. 대역폭 설정만 반복해서 바꾸는 것은 피하는 것이 좋습니다.

규칙 키워드

매칭 조건, 처리 방식, 규칙 순서를 차례로 확인하세요. 예시에 사용한 example.com은 문법을 설명하기 위한 것으로, 실제 서비스 설정과는 관련이 없습니다.

규칙 키워드

[Rule]

[Rule]은 구성에서 트래픽 분기 규칙을 설정하는 섹션입니다. 일반적으로 위에서 아래로 매칭되며, 먼저 조건에 맞는 항목이 이후 처리 방식을 결정합니다. 구체적인 조건을 포괄적인 조건보다 위에 두세요. 예상하지 못한 규칙이 적용되면 해당 항목뿐 아니라 위쪽 규칙이 먼저 매칭되었는지도 확인해야 합니다.

규칙 분기 설명 보기 →
규칙 키워드

DOMAIN-SUFFIX

DOMAIN-SUFFIX는 도메인 접미사를 기준으로 매칭합니다. 예를 들어 example.com은 해당 도메인과 하위 도메인에 적용되지만, 이 문자열이 포함된 모든 도메인에 적용되는 것은 아닙니다. 예시 DOMAIN-SUFFIX,example.com,PROXY에서 마지막 항목은 처리 방식을 지정합니다. 입력할 때 프로토콜 헤더나 웹페이지 경로를 포함하지 마세요.

규칙 키워드

DOMAIN-KEYWORD

DOMAIN-KEYWORD는 도메인에 지정한 문자열이 포함되어 있는지 확인해 매칭합니다. 예를 들어 example이라는 키워드는 다양한 접미사를 가진 도메인에 적용될 수 있습니다. 접미사 매칭보다 범위가 넓어 의도하지 않은 대상까지 포함하기 쉽습니다. 규칙이 예상대로 적용되지 않으면 연결 기록에서 실제 매칭된 도메인을 확인하세요.

규칙 키워드

IP-CIDR / IP-CIDR6

IP-CIDR은 IPv4 주소 범위에, IP-CIDR6은 IPv6 주소 범위에 사용합니다. 슬래시 뒤의 숫자는 네트워크 접두사 길이를 나타냅니다. 예를 들어 192.168.0.0/16은 단일 기기가 아니라 주소 범위입니다. 이 규칙은 대상 주소를 기준으로 하며, 도메인 문자열을 기준으로 하는 규칙과는 매칭 방식이 다릅니다.

규칙 키워드

GEOIP

GEOIP는 주소 데이터베이스에 등록된 지역 정보를 기준으로 대상 IP를 매칭합니다. 예를 들어 GEOIP,CN,DIRECT와 같이 사용할 수 있습니다. 데이터베이스의 지역 정보는 실제 위치를 실시간으로 측정한 값도, 사용자의 현재 위치도 아닙니다. 같은 도메인도 서로 다른 주소로 확인될 수 있으므로 DNS 조회 기록과 함께 결과를 살펴보세요.

규칙 키워드

FINAL

FINAL은 앞선 조건에 하나도 매칭되지 않을 때 사용하는 최종 처리 규칙으로, 보통 규칙의 마지막에 둡니다. 예를 들어 FINAL,DIRECT는 나머지 트래픽을 DIRECT로 처리한다는 뜻입니다. 단순한 마무리 설명이 아니므로 처리 방식을 바꾸면 앞선 규칙에서 다루지 않은 모든 연결에 영향을 줍니다.

규칙 키워드

PROXY / DIRECT / REJECT

PROXY는 프록시 경로로 처리, DIRECT는 직접 연결, REJECT는 연결 거부를 뜻합니다. 규칙의 처리 결과이지 매칭 조건은 아닙니다. 대문자로 표시되는 처리 방식과 Global Routing의 Proxy, Direct 옵션은 구분해서 이해해야 합니다. 요청이 거부되면 서버만 바꾸기보다 먼저 어떤 규칙이 매칭되었는지 확인하세요.

구독 및 구성

구독은 서버 정보를 관리하고, 구성은 트래픽 처리 방식을 설정합니다. 두 기능을 혼동하지 마세요. 이 섹션은 이미 본인 명의의 구독 또는 서버 정보가 있는 경우를 전제로 하며, 구독 주소는 서비스 제공업체에서 받아야 합니다.

구독 및 구성

Subscribe

Subscribe는 기존 구독을 관리하는 기능입니다. 업데이트하면 구독 주소에서 서버 목록을 불러옵니다. 구독 주소에 인증 정보가 포함될 수 있으므로 공개하지 마세요. 서버 목록 업데이트와 앱 업데이트는 서로 다른 작업입니다. 목록 업데이트에 실패해도 기존 서버를 즉시 사용할 수 없게 되는 것은 아니므로, 목록을 가져오는 과정과 실제 연결 상태를 따로 확인하세요.

Subscribe 관리 방법 보기 →
구독 및 구성

SERVER

SERVER 관련 항목에는 원격 서비스에 연결하는 데 필요한 프로토콜, 주소, 포트, 인증 정보가 표시됩니다. 한국어 설명에서는 서버 또는 노드라고 부르기도 합니다. 항목에 표시된 이름이 서버 도메인과 같지 않을 수 있습니다. 두 항목을 비교할 때는 이름, 지역 표시, 정렬 순서만 보지 말고 실제 매개변수를 확인하세요.

구독 및 구성

공유 링크와 Scan QR Code

공유 링크는 연결 매개변수를 정해진 형식으로 인코딩합니다. Scan QR Code는 QR 코드에 담긴 내용을 읽고, 클립보드 가져오기는 복사한 텍스트를 읽습니다. QR 코드가 일반 웹 주소만 담고 있을 수도 있으므로, 스캔에 성공했다고 서버 가져오기가 완료된 것은 아닙니다. 저장하기 전에 유형, 주소, 필수 항목이 모두 입력되었는지 확인하세요.

QR 코드 및 클립보드 가져오기 보기 →
구독 및 구성

Config 파일

Config 파일에는 규칙, 정책 및 관련 설정이 포함될 수 있지만, 사용 가능한 서버나 서버 구독이 반드시 들어 있는 것은 아닙니다. 가져온 다음 현재 어떤 구성이 활성화되어 있는지 확인하고 기존 설정을 덮어쓰는지 살펴보세요. 수정하기 전에 사본을 보관하고, 공유하기 전에는 계정, 비밀번호, 구독 인증 정보가 포함되어 있는지 확인하세요.

네트워크 및 진단

이름 확인, 연결, 인증, 데이터 전송을 나누어 점검하세요. 한 번의 테스트 결과는 특정 시점, 대상, 테스트 방법에만 해당합니다.

네트워크 및 진단

DNS

DNS는 도메인을 주소로 변환하며, 변환 결과는 연결 대상과 IP 기반 규칙 판정에 영향을 줄 수 있습니다. 도메인이 열리지 않는다고 해서 서버에 문제가 있다고 단정할 수는 없습니다. DNS 시간 초과, 캐시 문제, 반환된 주소에 연결할 수 없는 경우도 있습니다. 문제를 확인할 때는 먼저 DNS 조회 단계에서 실패했는지, 이후 연결 단계에서 실패했는지 구분하세요.

네트워크 및 진단

지연 시간

지연 시간은 특정 테스트 방식으로 요청을 보내고 응답을 받기까지 걸린 시간입니다. 다운로드 속도나 사용 가능한 대역폭을 직접 나타내지는 않습니다. 같은 네트워크와 테스트 방식으로 비슷한 시간대에 측정해야 결과를 비교하기 쉽습니다. 시간 초과는 해당 테스트가 완료되지 않았다는 뜻이므로 실제 연결 상태와 함께 원인을 확인하세요.

지연 시간 테스트 및 정렬 보기 →
네트워크 및 진단

Connectivity Test

Connectivity Test는 지정한 경로에서 특정 연결 요청을 완료할 수 있는지 확인합니다. 결과는 테스트 대상과 현재 네트워크 상태에 따라 달라집니다. 테스트에 성공해도 모든 앱이나 도메인을 사용할 수 있다는 뜻은 아닙니다. 실제 접속에 실패하면 Global Routing, 매칭된 규칙, DNS, 대상 서비스 상태를 계속 확인하세요.

네트워크 및 진단

TLS

TLS는 전송 데이터 암호화와 상대방 인증을 제공합니다. 핸드셰이크 문제를 확인할 때 서버 이름, 인증서, 기기 시간을 함께 살펴봐야 합니다. 연결 주소와 인증서 검증에 사용하는 이름은 다를 수 있으므로 서비스 제공업체가 안내한 정보를 입력하세요. 인증서 오류가 발생했을 때 검증을 건너뛰는 것을 일반적인 해결 방법으로 삼기보다 이름이나 인증서에 문제가 있는지 확인해야 합니다.

문제에 따라 관련 사용법으로 이동

용어 설명으로 각 항목을 이해한 뒤 구체적인 절차는 현재 화면을 기준으로 확인하세요. 문제를 해결할 때는 한 번에 설정 하나만 바꾸고 변경 전후의 연결 상태를 기록하세요. 매개변수, QR 코드, 로그에 인증 정보가 포함되어 있다면 공유하기 전에 가려야 합니다.