공식 설명서 용어 정리

Shadowrocket
화면 및 규칙 용어

화면과 사용 상황에 맞춰 용어를 찾아보고 연결 모드, 일치 조건, 처리 정책을 구분하세요.

영문 명칭은 앱과 설정에 표시된 원문 그대로 표기합니다. 각 용어는 제목 옆 링크로 찾아볼 수 있습니다. 연속된 설정 절차는 사용 가이드에서, 구매 내역 확인은 App Store 안내에서 확인하세요.

5가지 주제
자주 쓰는 용어 30개
화면 용어와 규칙 문법을 구분해 설명

화면 및 스위치

연결 방식과 작업 메뉴

먼저 현재 모드를 확인한 뒤 설정이 적용되는지 살펴보세요. 연결 스위치가 켜졌다는 것은 시스템이 해당 트래픽을 처리하기 시작했다는 뜻일 뿐, 대상 웹사이트나 서버에 연결할 수 있다는 보장은 아닙니다.

Global Routing

전체 트래픽 처리 모드를 선택하는 메뉴입니다. 세 가지 모드는 설정 Config, 프록시 Proxy, 직접 연결 Direct입니다. 도메인이나 IP 규칙에 따라 트래픽을 분기하려면 Config를 선택하고 현재 설정을 확인하세요. 모드만 전환해도 서버 인증 정보가 보완되거나 원격 연결 오류가 해결되지는 않습니다.

Config

이 이름은 설정 관리 메뉴와 Global Routing에서 설정에 따라 트래픽을 처리하는 모드, 두 가지 맥락에서 쓰입니다. 설정 관리에서는 파일을 확인하거나 편집할 수 있고, Config 모드를 선택해야 트래픽에 현재 설정이 적용됩니다. 파일을 저장했더라도 올바른 설정을 선택하지 않으면 예상과 다른 결과가 나올 수 있습니다.

Proxy / Direct

Global Routing에서 전체 처리 방식을 바꾸는 모드 이름으로, 각각 프록시와 직접 연결을 뜻합니다. 규칙이 결과에 영향을 주는지 확인하려면 목적을 분명히 한 뒤 모드를 잠시 전환해 요청을 다시 보내 보세요. 테스트가 끝나면 필요한 모드로 되돌리고, 화면 모드와 규칙의 대문자 정책 키워드를 혼동하지 마세요.

On Demand

설정된 조건에 따라 시스템이 연결을 시작하는 기능으로, 네트워크 환경에 맞춰 연결을 관리할 때 사용합니다. 시스템 VPN 설정과 관련 조건에 따라 동작하며 서버 사용 가능성을 보장하지는 않습니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 먼저 On Demand 설정을 확인한 다음 이상 여부를 살펴보세요.

Add Server

사용자가 보유한 서버 정보를 직접 입력하는 메뉴입니다. 먼저 프로토콜 유형을 선택하고 주소, 포트, 인증 항목을 확인하세요. 프로토콜마다 입력 양식이 달라 그대로 바꿔 쓸 수 없습니다. 비밀번호나 사용자 식별자처럼 이름이 같은 항목도 원래 설정에 따라 입력해야 합니다. 저장되었다고 연결이 확인된 것은 아니므로 직접 연결해 보세요.

Connectivity Test

연결 가능 여부를 확인하는 테스트 메뉴입니다. 결과는 선택한 테스트 방식에 맞춰 해석해야 합니다. 표시 시간은 보통 특정 탐색이나 요청에 걸린 왕복 시간이며 다운로드 속도를 뜻하지 않고 모든 대상 웹사이트를 나타내지도 않습니다. 시간이 초과되면 네트워크, 서버 매개변수, 실제 요청 결과를 추가로 확인하세요.

프로토콜

프로토콜 유형 및 연결 매개변수

프로토콜은 양측이 연결을 설정하는 방식을 정합니다. 전송 방식과 보안 계층은 별도 설정일 수 있습니다. 아래 설명은 사용자가 기존에 보유한 구독 또는 서버 정보를 기준으로 하며, 입력할 때는 해당 설정을 확인하세요.

Shadowsocks

프록시 프로토콜의 하나로, 일반적인 매개변수는 서버 주소, 포트, 암호화 방식, 비밀번호입니다. 암호화 방식은 서버 설정과 일치해야 하며 연결을 시도하려고 임의로 바꾸면 안 됩니다. 기존 정보를 직접 입력할 때 추가 전송 매개변수가 있는지도 확인해 주소와 비밀번호만 복사하고 필요한 항목을 빠뜨리지 않도록 하세요.

VMess

사용자 식별자 등의 매개변수로 연결하는 프록시 프로토콜이며 여러 전송 방식과 함께 사용할 수 있습니다. 문제를 확인할 때는 프로토콜 인증 정보, 전송 경로, 보안 계층 설정을 각각 점검하세요. 주소와 사용자 식별자가 같아도 전송 방식이나 경로가 맞지 않으면 연결에 실패할 수 있습니다.

VLESS

프록시 프로토콜의 하나입니다. 사용자 식별자, 전송 방식, 보안 계층 매개변수가 서버 측 설정과 일치해야 합니다. VLESS라는 이름만 보고 어떤 보안 계층을 사용하는지 판단할 수는 없습니다. 직접 입력할 때는 기존 설정을 항목별로 확인하고 다른 프로토콜의 값을 그대로 옮기지 마세요.

Trojan

일반적으로 TLS와 함께 사용하는 프록시 프로토콜로, 연결할 때 인증 비밀번호와 인증서 관련 설정을 모두 확인해야 합니다. 서버 주소와 인증서 검증에 사용할 이름은 서로 다른 역할을 할 수 있으므로 같은 항목으로 보면 안 됩니다. 인증서 오류가 나면 이름과 기기 시간을 확인하고 정상적인 인증서 검증을 유지하세요.

Hysteria2

QUIC 기반 프록시 프로토콜로 UDP를 사용합니다. 실제 연결 상태는 네트워크 경로, 혼잡도, 서버 설정에 따라 달라집니다. 입력할 때는 기존 설정의 password, sni, obfs 등의 필드를 확인하세요. 네트워크 경로에서 UDP가 제한된다면 규칙만 바꿔서는 핸드셰이크 문제를 해결하기 어렵습니다.

공개 키와 개인 키, 터널 주소를 사용해 연결하는 VPN 프로토콜입니다. 일반적인 필드에는 PrivateKey, PublicKey, Address, AllowedIPs가 있습니다. 개인 키는 민감한 정보이므로 공개 문의용 스크린샷에 포함하지 마세요. MTU와 주소 범위는 실제 설정에 맞춰 확인하고 다른 사람의 값을 그대로 적용하지 마세요.

HTTP / SOCKS5

서로 다른 두 가지 프록시 프로토콜입니다. 서버가 지원하는 유형을 선택하고 인증 요건을 확인하세요. 대상 웹사이트가 HTTPS를 사용한다고 해서 프록시 유형도 반드시 HTTP여야 하는 것은 아닙니다. 프로토콜 이름만으로 클라이언트와 프록시 서버 사이의 암호화 여부를 알 수 없으므로 관련 전송 설정도 확인해야 합니다.

규칙 키워드

일치 대상 및 처리 정책

규칙은 일반적으로 일치 방식, 일치 내용, 처리 정책 순으로 작성합니다. 특정 키워드 하나만 보는 것보다 먼저 “무엇과 일치하는지”, 다음으로 “일치한 뒤 어떻게 처리하는지”를 확인하면 문제를 더 쉽게 찾을 수 있습니다.

DOMAIN

지정한 전체 도메인 하나와 일치시킵니다. 예를 들어 DOMAIN,example.com,DIRECT는 해당 도메인 자체에 적용됩니다. 모든 하위 도메인이나 URL 경로까지 자동으로 포함하지 않습니다. 같은 도메인의 경로별로 다르게 처리하려면 이 규칙에서 도메인만 바꿔서는 해결되지 않습니다.

DOMAIN-SUFFIX

도메인 접미사로 일치시키며, 일반적으로 입력한 도메인과 하위 도메인을 포함합니다. 예: DOMAIN-SUFFIX,example.com,PROXY. 일치 항목에는 도메인만 입력하고 프로토콜이나 페이지 경로는 쓰지 마세요. 특정 하위 도메인에 예외를 적용하려면 더 구체적인 규칙을 이 규칙보다 앞에 두세요.

DOMAIN-KEYWORD

도메인에 포함된 문자열로 일치시키며 관련 도메인을 여러 개 포함해야 할 때 사용합니다. 키워드가 너무 짧으면 관계없는 도메인까지 일치할 수 있으므로 DOMAIN-SUFFIX를 간단히 대체하는 용도로 쓰지 마세요. 의도하지 않은 항목이 일치하면 먼저 키워드가 지나치게 포괄적인지 확인하세요.

GEOIP

지리 데이터베이스에서 대상 IP를 분류한 결과에 따라 일치시킵니다. 예: GEOIP,CN,DIRECT. 데이터베이스 분류는 웹사이트 표시 언어, 운영 주체의 소재지, 사용자의 위치와 다릅니다. 같은 도메인도 서로 다른 주소로 해석될 수 있으므로 규칙 결과를 확인할 때 실제 대상 IP도 살펴보세요.

IP-CIDR / IP-CIDR6

각각 IPv4와 IPv6 주소 범위에 적용하며 슬래시 뒤의 숫자는 네트워크 접두사 길이를 나타냅니다. 예를 들어 192.168.0.0/16은 IPv4 네트워크 범위이지 단일 호스트 주소가 아닙니다. IPv4 규칙만 설정했다고 IPv6 연결도 같은 조건에 자동으로 일치하는 것은 아닙니다.

FINAL

앞선 규칙이 모두 일치하지 않을 때 적용되는 최종 처리 규칙으로, 보통 규칙 목록 맨 끝에 둡니다. FINAL,DIRECT와 FINAL,PROXY는 기본 처리 방향이 다르므로 실제 요구에 맞춰 선택하세요. 특정 대상이 직접 연결되거나 프록시를 사용하는 이유를 찾을 때는 이 규칙에 최종적으로 일치했는지도 확인하세요.

PROXY / DIRECT / REJECT

규칙에서 사용하는 기본 정책 키워드로, 각각 프록시 처리, 직접 연결, 요청 거부를 뜻합니다. 규칙의 정책 위치에 쓰며 도메인이나 주소 조건을 대신할 수는 없습니다. PROXY는 실제로 사용할 수 있는 프록시 선택 항목이 있어야 하고, DIRECT라고 해서 기기가 연결된 로컬 네트워크를 벗어나는 것은 아닙니다.

규칙 순서

규칙은 일반적으로 위에서 아래로 차례대로 일치 여부를 확인합니다. 포괄적인 조건보다 구체적인 예외를 앞에 두고 마지막에 FINAL을 배치하세요. 두 규칙이 같은 대상을 포함하면 뒤쪽 규칙이 적용되지 않을 수 있습니다. 순서를 바꾼 뒤 저장하고 현재 설정이 선택되어 있는지 확인한 다음 새 요청으로 다시 테스트하세요.

[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

규칙을 한 줄씩 설명한 내용은 DOMAIN-SUFFIX 규칙 작성 예시에서 확인하세요.

구독 및 설정

가져오는 항목과 설정 범위

서버 항목은 연결 방법을 설명하고, 구독은 항목을 일괄 업데이트하며, 설정 파일은 규칙과 일반 설정을 구성합니다. 가져오기 전에 항목 유형부터 확인해 서로 다른 메뉴를 같은 작업으로 착각하지 않도록 하세요.

서버 항목

클라이언트에 저장되는 연결 매개변수 모음으로, 일반적으로 프로토콜, 주소, 포트, 관련 인증 정보를 포함하며 ‘노드’라고도 합니다. 표시 이름은 항목을 구분하기 위한 것으로 실제 위치나 성능을 보장하지 않습니다. 항목을 변경한 뒤에는 기존 연결을 다시 설정해야 할 수 있으므로 새 요청을 보내 확인하세요.

Config 설정 파일

일반 설정, 규칙, 정책 등을 구성하는 텍스트 설정이며 [General], [Rule] 등의 섹션을 포함할 수 있습니다. 서버 구독과는 다른 유형의 콘텐츠입니다. 수정하기 전에 현재 정상 작동하는 사본을 보관하고, 가져온 뒤 대상 파일이 선택되어 있는지 확인한 다음 규칙과 관련 설정을 점검하세요.

DNS / DoH

DNS는 도메인을 IP 주소로 변환하고, DoH는 HTTPS를 통해 DNS 질의를 전달합니다. 도메인이 해석되더라도 이후 연결까지 성공한다는 뜻은 아니며, 해석 방식을 바꿔도 연결 경로가 바뀌지는 않습니다. 문제를 확인할 때는 해석 결과, 규칙 일치 여부, 대상 연결을 각각 점검하고 여러 설정을 한꺼번에 바꾸지 마세요.

Scan QR Code

QR 코드에서 연결 정보를 읽어오는 메뉴입니다. 인식 결과는 단일 서버 정보일 수도 있고 구독 주소일 수도 있습니다. QR 코드는 데이터를 전달할 뿐 내용이 정확하다는 것을 보장하지 않습니다. 저장하기 전에 프로토콜 유형, 주소, 기타 매개변수를 확인하고 형식을 인식할 수 없다면 기존 원본 설정을 기준으로 항목별로 점검하세요.

작업 순서에 따라 계속 확인하세요: 기존 설정 가져오기, Global Routing 선택, 연결 확인.

App Store 및 구매

정품 확인 및 구매 내역

Shadowrocket은 Apple 플랫폼용 유료 클라이언트이며 주로 iPhone과 iPad에서 사용합니다. Mac, Apple TV, Apple Vision 호환 여부와 시스템 요구 사항은 App Store 페이지를 확인하세요.