Shadowrocket 용어집 - 인터페이스, 프로토콜, 규칙 키워드

01 / Interface

인터페이스 및 스위치

하나의 연결 문제에도 여러 화면이 관련될 수 있습니다. 설정을 바꾸기 전에 현재 화면과 상태부터 확인해 테스트 결과, 라우팅 모드, VPN 스위치를 혼동하지 않도록 하세요.

Home

Home은 서버 목록과 현재 선택 항목, 연결 스위치를 확인하는 주요 화면입니다. 항목을 가져온 뒤 목록에 예상한 항목이 있는지 살펴보고 현재 선택된 항목도 확인하세요. 목록에 보인다는 것은 정보가 저장되었다는 뜻일 뿐, 인증 성공이나 대상 서비스 접속을 보장하지 않습니다.

Add Server

Add Server에서는 기존 서버 정보를 추가할 수 있으며, Type에 따라 입력해야 하는 항목이 달라집니다. 서버 자료에 맞춰 프로토콜을 선택한 다음 주소, 포트, 인증 정보, TLS 등 추가 옵션을 확인하세요. 서로 다른 프로토콜의 비밀번호, 사용자 식별자, 전송 매개변수를 혼용하지 마세요.

Global Routing

Global Routing은 전체 라우팅 모드를 제어합니다. Config, Proxy, Direct는 각각 Config 규칙 적용, 프록시 경로, 직접 연결 경로를 뜻합니다. 규칙이 적용되지 않는 것 같다면 먼저 이 설정을 확인하세요. Config 모드가 아니면 모든 연결을 Config 규칙의 예상대로 해석할 수 없습니다.

On Demand

On Demand는 설정한 조건에 따라 VPN 연결을 시작하는 기능이며, 서버 사용 가능 여부를 보장하지 않습니다. 설정 후 Wi-Fi 전환, 셀룰러 네트워크 사용, 화면 잠금, 네트워크 재연결 시의 상태를 각각 확인하세요. 수동으로 끈 뒤 다시 연결된다면 비정상적인 재연결로 판단하기 전에 여기의 조건을 살펴보세요.

Connectivity Test

Connectivity Test는 지정한 테스트 조건에서 항목의 연결 상태를 확인합니다. 표시되는 지연 시간은 테스트 대상과 방식, 당시 네트워크 상태에 따라 달라지며 실제 다운로드 속도를 나타내지는 않습니다. 테스트는 성공했지만 앱에 접속할 수 없다면 DNS, 규칙 일치 결과, 대상 서비스 상태도 확인하세요.

DNS

DNS는 도메인 이름을 IP 주소로 변환하며, 여러 연결을 시작하기 전에 거치는 과정입니다. 도메인 규칙과 IP 규칙은 서로 다른 대상을 기준으로 하므로 DNS 결과와 해석 시점이 이후 규칙 적용에 영향을 줄 수 있습니다. 도메인으로는 열리지 않지만 주소로는 접속되는 경우 DNS 오류를 기록하고 서버만 반복해서 바꾸지 마세요.

URL Rewrite

URL Rewrite는 조건에 따라 요청 URL을 처리하며, 연결 경로를 결정하는 라우팅 규칙과는 다른 계층의 설정입니다. 특정 요청에 적용되는지는 요청 형식과 관련 설정 조건에 따라 달라집니다. 문제를 확인할 때는 요청이 일치 표현식에 부합하는지 먼저 살펴보세요. URL을 바꾸는 것은 PROXY 또는 DIRECT를 선택하는 것과 다릅니다.

Data

Data에서는 클라이언트가 기록한 트래픽과 관련 통계를 확인할 수 있어 일정 기간의 사용량 변화를 살펴볼 때 유용합니다. 수치를 읽기 전에 통계 범위와 집계 기간, 초기화 여부를 확인하세요. 이곳의 집계 방식은 서비스 제공업체의 기준과 다를 수 있으므로 계정 잔여량이나 요금 청구 결과를 추정하는 데 사용할 수 없습니다.

02 / Protocols

프로토콜

Type은 서버 설정과 일치해야 합니다. 프로토콜 이름은 통신 방식의 일부만 설명하며, 실제 속도와 배터리 사용량은 네트워크 품질, 전송 방식, 연결 시간, 서버 설정에도 영향을 받습니다.

Shadowsocks

Shadowsocks는 지정한 암호화 방식과 비밀번호로 프록시 통신을 설정합니다. 서버 주소, 포트, 암호화 방식, 비밀번호를 모두 확인하세요. 비밀번호만 맞는지 확인해서는 충분하지 않습니다. 암호화 방식마다 호환 조건이 다를 수 있으므로 보유한 서버 정보를 기준으로 각 항목을 입력하세요.

VMess

VMess는 사용자 식별자 등의 정보로 인증하며 여러 전송 방식을 함께 사용할 수 있습니다. 프로토콜 유형, 전송 방식, TLS는 각각 별개의 설정이므로 가져온 뒤 항목별로 확인하세요. 인증 또는 핸드셰이크 오류가 발생하면 전송 매개변수를 점검하기 전에 기기 시간이 정확한지도 확인하세요.

VLESS

VLESS는 사용자 인증과 전송 보호 방식을 별도로 다루므로 이름만으로 연결 암호화 여부를 판단할 수 없습니다. 사용자 식별자, 전송 매개변수, 서버가 요구하는 보안 설정을 함께 맞춰야 합니다. VMess와는 다른 프로토콜이므로 Type만 바꾸면 나머지 항목도 그대로 쓸 수 있다고 가정하지 마세요.

Trojan

Trojan은 일반적으로 TLS와 비밀번호 인증을 사용합니다. 주소와 비밀번호 외에도 인증서 검증에 사용되는 이름과 서버가 요구하는 관련 매개변수를 확인하세요. 핸드셰이크 실패가 반드시 비밀번호 오류를 뜻하지는 않습니다. 문제 확인을 대신해 인증서 검증을 임의로 끄지 마세요.

HTTP

HTTP 프록시는 애플리케이션 계층에서 요청을 전달하며 CONNECT로 대상까지 터널을 만들 수도 있습니다. 계정과 비밀번호가 필요한지, 클라이언트에서 프록시 서버까지의 전송이 보호되는지는 설정을 각각 확인해야 합니다. 대상이 HTTPS를 사용하더라도 프록시 연결의 모든 구간이 같은 방식으로 보호되는 것은 아닙니다.

SOCKS5

SOCKS5는 대상 주소와 포트를 협상하며 프로토콜 자체는 전송 암호화를 제공하지 않습니다. 인증 방식과 UDP 전달 기능은 클라이언트와 서버 양쪽에서 지원해야 합니다. 일부 앱은 접속되지만 실시간 통신이 실패한다면 TCP와 UDP가 실제로 사용 가능한지 구분해 확인하세요.

WireGuard

WireGuard는 UDP 기반의 공개 키 인증 터널 프로토콜로, 설정 구조가 일반적인 비밀번호 방식 프록시와 다릅니다. 키, 피어 주소, 터널 주소, 라우팅 범위를 함께 확인하세요. 개인 키는 민감 정보이므로 문제를 확인할 때 가리고, 전체 설정을 공개 스크린샷에 올리지 마세요.

Hysteria2

Hysteria2는 QUIC 기반이며 연결 상태는 UDP 사용 가능 여부, 네트워크 손실, 혼잡 상황에 따라 달라집니다. 인증, TLS, 서버가 요구하는 대역폭 등의 매개변수를 확인하되 대역폭 항목을 실측 속도로 해석하지 마세요. 프로토콜 자체가 속도를 보장하지 않으므로 같은 네트워크 조건에서 실제 작업으로 판단해야 합니다.

프로토콜 필드와 선택 안내 보기 →

03 / Rule keywords

규칙 키워드

규칙은 먼저 일치 대상을 지정하고 그다음 처리 정책을 정합니다. 규칙은 위에서 아래 순서로 검사하며 처음 일치한 규칙이 처리 방식을 결정합니다. 일반적으로 적용 범위가 좁고 구체적인 규칙을 더 넓은 규칙보다 앞에 배치하세요.

문법을 읽기 위한 예시이며 그대로 대체해 사용할 수 있는 완성된 Config는 아닙니다

DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

이 예시에서는 api.example.com이 첫 번째 줄에 먼저 일치하므로 두 번째 줄이 정책을 결정하지 않습니다. 예시 도메인은 일치 범위를 설명하기 위한 것입니다.

DOMAIN

DOMAIN은 지정한 도메인과 정확히 일치합니다. 예: DOMAIN,example.com,PROXY. 이 규칙에는 www.example.com 등의 하위 도메인이 자동으로 포함되지 않습니다. 하나의 서비스가 여러 도메인을 사용한다면 실제 연결 기록을 바탕으로 일치 범위를 추가하세요.

DOMAIN-SUFFIX

DOMAIN-SUFFIX는 도메인 접미사를 기준으로 루트 도메인과 하위 도메인에 일치합니다. 예를 들어 example.com은 해당 도메인과 api.example.com에 일치하지만 같은 문자열이 들어간 임의의 도메인에는 일치하지 않습니다. 특정 하위 도메인에 다른 정책을 적용하려면 더 구체적인 규칙을 앞에 배치하세요.

DOMAIN-KEYWORD

DOMAIN-KEYWORD는 도메인에 지정된 문자열이 포함되는지 확인하며, 일반적으로 DOMAIN보다 적용 범위가 넓습니다. 의도하지 않은 도메인에도 문자열이 포함될 수 있으므로 편리함과 오탐 위험을 함께 고려하세요. 수정한 뒤에는 대상 하나만 시험하는 데 그치지 말고 실제 일치 결과를 확인하세요.

IP-CIDR

IP-CIDR은 CIDR 표기법으로 IPv4 주소 범위를 지정합니다. 예: 192.168.0.0/16. 슬래시 뒤의 접두사 길이가 네트워크 범위를 정하므로 단일 주소로 해석하면 안 됩니다. 도메인 요청이 이 규칙의 판단 대상이 되는지는 DNS 해석 결과와 관련 규칙 옵션에도 영향을 받습니다.

IP-CIDR6

IP-CIDR6은 IPv6 주소 범위를 대상으로 하며 IP-CIDR의 IPv4 범위와 별도로 처리됩니다. 대상이 IPv4와 IPv6 주소를 모두 제공한다면 IPv4 규칙만으로 모든 연결을 처리하지 못할 수 있습니다. 같은 도메인의 연결 경로가 서로 다를 때는 실제 연결에 어떤 주소 유형이 사용되었는지 확인하세요.

GEOIP

GEOIP는 IP 지리 데이터베이스의 분류 결과를 기준으로 일치시키며, 판단 대상은 주소이지 웹페이지에 쓰인 문자가 아닙니다. 데이터베이스 업데이트가 늦을 수 있으며 서비스 운영 주체의 소재지를 직접 나타내지도 않습니다. 정확한 처리가 필요한 서비스에는 실제 대상을 기준으로 더 구체적인 도메인 또는 주소 규칙을 추가하세요.

FINAL

FINAL은 앞선 규칙에 하나도 일치하지 않을 때 적용되는 기본 규칙으로, 보통 마지막에 둡니다. FINAL,PROXY는 일치하지 않은 연결을 PROXY로 보내며, 앞에서 이미 일치한 연결을 다시 처리한다는 뜻은 아닙니다. 기본 정책은 넓은 범위에 영향을 주므로 수정 전에 어떤 연결이 여기에 해당하는지 확인하세요.

04 / Policies

정책 및 그룹

규칙 키워드는 “무엇과 일치하는가”를, 정책은 “어떻게 처리하는가”를 나타냅니다. Global Routing의 Proxy / Direct와 규칙 텍스트의 PROXY / DIRECT를 구분하세요.

PROXY

PROXY는 일치한 연결을 프록시 경로로 보냅니다. 실제 연결 경로는 현재 선택 항목과 Config에서 참조하는 정책에 따라서도 달라집니다. PROXY에 일치한다고 해서 서버 사용 가능 여부가 확인된 것은 아닙니다. 정책은 올바르게 적용되는데 요청이 실패한다면 인증, 전송 방식, 대상 접속 가능 여부를 계속 확인하세요.

DIRECT

DIRECT는 선택한 프록시 서버를 거치지 않고 대상에 직접 연결합니다. 이 정책에 일치한 연결에만 적용되며 VPN 연결 전체를 끄는 것은 아닙니다. 직접 연결도 현재 네트워크와 DNS가 정상적으로 작동해야 하므로 실패 원인을 모두 규칙 탓으로 돌리지 마세요.

REJECT

REJECT는 일치한 연결을 차단하므로 적용 범위가 명확한 조건과 함께 사용하세요. 범위가 지나치게 넓은 도메인 키워드 규칙은 정상 기능에 필요한 요청까지 차단할 수 있습니다. 특정 기능이 갑자기 작동하지 않으면 규칙 범위를 조정하기 전에 REJECT에 일치했는지 확인하세요.

정책 및 그룹

정책 그룹은 규칙에서 참조할 처리 대상을 구성하며, 구체적인 동작은 그룹 유형과 구성원 설정에 따라 달라집니다. Home 목록에서 서버를 정리하는 그룹은 Config에서 라우팅에 사용하는 정책 그룹과 다를 수 있습니다. 규칙에서 그룹 이름을 참조한다면 이름과 대상이 실제로 존재하는지 확인하고, 정리용 이름을 출구 정책으로 혼동하지 마세요.

05 / Subscription & configuration

구독 및 Config

서버 항목, 구독 출처, 라우팅 Config, App Store 구매 기록은 각각 다른 문제를 해결합니다. 복원하거나 업데이트할 때 항목별로 확인하고, 한 가지가 성공했다고 나머지까지 모두 복원된 것으로 판단하지 마세요.

SERVER

서버 항목에는 주소, 포트, 프로토콜, 인증 등 연결 정보가 저장되며 목록 이름은 구별을 위한 표시일 뿐입니다. 이름이 서로 다르다고 반드시 다른 서버를 사용하는 것은 아니며, 이름이 같다고 모든 매개변수가 같은 것도 아닙니다. 중복 항목이나 연결 차이를 확인할 때는 실제 필드를 비교하세요.

Config

Config는 설정 파일 화면이자 Global Routing에서 설정에 따라 연결을 처리하는 모드의 이름입니다. 파일에는 규칙, DNS 등의 설정이 포함될 수 있습니다. 파일을 가져오는 것과 선택해 활성화하는 것은 별개의 작업입니다. 규칙 테스트가 의미가 있는지 판단하려면 수정 전에 백업을 보관하고, 수정 후 현재 파일과 Global Routing을 모두 확인하세요.

iCloud 동기화

iCloud 동기화는 지원되는 앱 데이터를 기기 간에 동기화하는 기능이며 실제 동기화 범위는 앱 내 옵션에서 확인해야 합니다. 기기를 바꾸기 전에 계정과 동기화 상태를 확인하고 필요한 Config 백업도 별도로 보관하세요. 동기화가 모든 데이터를 복원하는 것은 아니므로 새 기기에서 서버 항목, Config, 현재 선택 항목을 하나씩 확인해야 합니다.

구입 항목

구입 항목은 App Store에서 구매 기록을 확인하고 앱을 다시 받는 곳이며, 원래 구매한 계정으로 확인해야 합니다. 앱 구매 복원과 앱 내 Config 복원은 별개의 작업이므로 재설치 후에도 데이터를 확인하세요. 구매 적용 범위, 기기 호환성, 시스템 요구 사항은 App Store 페이지 표기를 기준으로 확인하세요.

다음 / 문제별 안내

사용 및 확인 안내

용어 안내를 통해 개념을 파악하고, 실제 조작은 튜토리얼을 따라 진행하세요. 문제가 생기면 연결 상태와 규칙 일치 결과를 기준으로 단계별로 확인하세요.