공식 매뉴얼 · 용어 빠른 참조

Shadowrocket 용어집

인터페이스 용어, 프로토콜, 규칙 키워드의 의미를 확인하세요. 먼저 ‘어느 화면에서 설정하는지’와 ‘어떤 규칙이 처리하는지’를 구분한 뒤 자신의 설정을 살펴보세요.

01 / Interface

인터페이스 및 스위치

화면에 표시되는 영어 명칭은 그대로 사용합니다. 같은 용어가 화면 이름과 모드 옵션에 쓰일 경우 위치에 따라 의미를 구분해야 합니다.

인터페이스 및 스위치

Home

Home은 서버 목록을 확인하고 사용할 서버를 선택하거나 연결 스위치를 조작하는 기본 화면입니다. 연결하기 전에 선택된 항목을 확인하고 Global Routing도 살펴보세요. 스위치가 켜져 있다는 것은 연결 기능이 활성화되었다는 뜻일 뿐, 모든 대상에 정상적으로 접속할 수 있다는 의미는 아닙니다.

인터페이스 및 스위치

Config

Config는 구성 파일을 관리하는 화면 이름이자 Global Routing의 ‘구성’ 모드에 해당하는 영어 옵션입니다. 화면에서는 파일을 선택하고 편집하며, 모드 옵션은 현재 구성 규칙에 따라 트래픽을 처리한다는 뜻입니다. 파일을 가져오기만 해서는 해당 파일이 선택되거나 그 규칙에 따라 트래픽이 분배되지 않습니다.

인터페이스 및 스위치

Global Routing

Global Routing은 전체 트래픽 처리 방식을 결정하며, 주로 Config, Proxy, Direct 세 가지 모드를 사용합니다. Config는 규칙에 따라 트래픽을 분배하고, Proxy는 프록시 경로를, Direct는 직접 연결 경로를 사용합니다. 규칙이 적용되지 않는 문제를 확인할 때는 먼저 현재 모드가 Config인지 살펴보세요.

인터페이스 및 스위치

On Demand

On Demand는 설정한 네트워크 조건에 따라 연결 동작을 실행합니다. 네트워크 환경에 맞춰 연결을 관리할 때 사용할 수 있습니다. 특정 도메인에 어떤 규칙을 적용할지 결정하거나 서버 매개변수를 채우는 기능은 아닙니다. 자동 연결을 확인할 때는 조건 설정과 현재 연결 상태를 함께 점검하세요.

인터페이스 및 스위치

Add Server

Add Server에서는 사용자가 이미 보유한 서버 정보를 연결 항목으로 저장합니다. 프로토콜에 따라 필요한 매개변수가 달라지므로 주소, 포트, 인증 정보, 전송 설정을 서버 정보와 일치하게 입력하세요. 저장이 완료되어도 항목만 만들어진 상태이므로 테스트하고 실제로 연결해 확인해야 합니다.

인터페이스 및 스위치

Connectivity Test

Connectivity Test는 현재 네트워크에서 서버에 연결할 수 있는지 확인하는 기능입니다. 결과는 테스트 방식, 네트워크 경로, 서버 응답에 따라 달라지므로 웹페이지 속도 순위처럼 볼 수 없습니다. 테스트에 성공한 뒤에도 실제로 이용할 대상에 접속해 이름 확인, 연결, 콘텐츠 로딩을 확인하세요.

인터페이스 및 스위치

DNS

DNS는 도메인 이름을 IP 주소로 변환하며, 도메인에 접속할 때 중요한 역할을 합니다. 이름 확인에 실패하면 연결이 시작되기 전에 중단될 수 있지만, 성공했다고 해서 대상 서비스에 접속할 수 있는 것은 아닙니다. DNS를 변경하기 전에 기존 설정을 기록하고 같은 대상을 다시 테스트하세요. 여러 설정을 동시에 바꾸지 않는 것이 좋습니다.

02 / Protocols

프로토콜

프로토콜은 클라이언트와 서버가 통신하는 방식을 설명하며 속도 등급을 뜻하지 않습니다. 아래 내용은 사용자가 자신의 서버 정보를 이미 보유한 경우를 전제로 합니다.

프로토콜

Shadowsocks

Shadowsocks는 암호화 방식과 비밀번호 등의 매개변수를 사용해 프록시 연결을 설정합니다. 서버 주소, 포트, 암호화 방식, 비밀번호를 모두 확인하고 추가 설정은 서버 정보를 따르세요. 주소에 연결할 수 있어도 인증 정보나 암호화 방식이 일치하지 않으면 실제 요청이 실패할 수 있습니다.

프로토콜

VMess

VMess는 사용자 ID 등의 매개변수로 인증하며 다양한 전송 방식을 함께 사용할 수 있습니다. 가져온 뒤 주소와 포트뿐 아니라 사용자 ID, 전송 경로, TLS 관련 설정도 확인하세요. 다른 프로토콜의 항목을 그대로 옮기지 마세요. 이름이 같은 항목도 사용 조건이 다를 수 있습니다.

프로토콜

VLESS

VLESS는 사용자 ID로 인증합니다. 보안은 프로토콜 이름만으로 판단할 수 없으며 실제 전송 방식과 암호화 설정을 함께 고려해야 합니다. 서버 정보를 바탕으로 인증 매개변수, 전송 방식, 관련 보안 옵션을 확인하세요. 추가 항목이 필요한지는 양측에서 사용하는 구체적인 설정에 따라 달라집니다.

프로토콜

Trojan

Trojan은 일반적으로 TLS로 전송하고 비밀번호로 인증합니다. 주소, 포트, 비밀번호와 함께 SNI가 인증서에 대응하는 도메인인지 확인하세요. 인증서 검증 오류가 발생하면 도메인, 기기 시간, 서버 인증서를 먼저 점검하고, 검증 비활성화를 일반적인 해결 방법으로 사용하지 마세요.

프로토콜

Hysteria2

Hysteria2는 QUIC 기반이며 UDP 경로와 양측의 인증 및 TLS 설정이 일치해야 연결할 수 있습니다. 문제를 확인할 때는 서버 매개변수가 잘못된 경우와 현재 네트워크가 해당 통신 경로를 지원하지 않는 경우를 구분하세요. 대역폭 관련 매개변수를 입력해도 해당 속도가 보장되지는 않습니다. 실제 성능은 양측 설정과 네트워크 환경에 따라 달라집니다.

프로토콜

WireGuard

WireGuard는 공개 키와 개인 키, 상대 측 설정을 사용해 암호화 터널을 구성합니다. 주소와 비밀번호만 입력하는 방식과 매개변수 구조가 다릅니다. 일반적으로 로컬 키, 상대 공개 키, 엔드포인트, 주소 범위가 필요합니다. 개인 키는 민감한 정보이므로 공개 스크린샷이나 로그, 문의 글에 포함하지 마세요.

03 / Rule keywords

규칙 키워드

키워드는 ‘어떤 조건으로 일치시킬지’를 정하고, 행 끝의 정책은 ‘일치한 뒤 어떻게 처리할지’를 정합니다. 예시의 example.com은 문법 설명을 위한 도메인입니다.

규칙 키워드

DOMAIN

DOMAIN은 도메인 전체를 정확히 일치시킵니다. 예를 들어 example.com에만 처리 방식을 지정할 수 있습니다. www.example.com 같은 하위 도메인에는 자동으로 적용되지 않습니다. 기본 도메인과 하위 도메인을 함께 처리하려면 도메인 접두사를 하나씩 추측하기보다 DOMAIN-SUFFIX를 고려하세요.

DOMAIN,example.com,PROXY
규칙 키워드

DOMAIN-SUFFIX

DOMAIN-SUFFIX는 지정한 도메인과 그 하위 도메인을 일치시켜 도메인 계층 전체에 같은 정책을 적용할 때 적합합니다. example.com은 www.example.com에도 적용되지만, 해당 문자열이 포함된 모든 도메인이 일치하는 것은 아닙니다. 단순 문자열 포함 검색과 일치 범위가 다릅니다.

DOMAIN-SUFFIX,example.com,PROXY
규칙 키워드

DOMAIN-KEYWORD

DOMAIN-KEYWORD는 도메인에 지정한 문자열이 포함되어 있는지 확인하며, 해당 문자열이 완전한 도메인 계층을 이룰 필요는 없습니다. 일반적으로 DOMAIN이나 DOMAIN-SUFFIX보다 넓은 범위가 일치할 수 있습니다. 사용 전에 관계없는 도메인까지 일치하지 않는지 확인하고, 특히 짧고 흔한 문자열 대신 명확한 도메인을 지정하세요.

DOMAIN-KEYWORD,example,PROXY
규칙 키워드

GEOIP

GEOIP는 도메인 접미사나 사용자의 위치가 아니라 IP 지리 데이터베이스에 등록된 지역 정보를 기준으로 대상 주소를 일치시킵니다. 콘텐츠 배포 방식이나 주소 정보의 변경에 따라 결과가 달라질 수 있습니다. 특정 도메인에 항상 같은 처리를 적용하려면 더 구체적인 도메인 규칙을 먼저 확인하세요.

GEOIP,CN,DIRECT
규칙 키워드

IP-CIDR

IP-CIDR은 CIDR 표기법으로 IPv4 주소 범위를 일치시킵니다. 슬래시 뒤의 숫자는 네트워크 프리픽스 길이이며 포트가 아닙니다. 예시에서는 192.168.0.0/16 범위에 DIRECT를 적용합니다. 범위를 입력하기 전에 실제 네트워크 구성을 확인해 다른 정책이 필요한 주소까지 포함되지 않도록 하세요.

IP-CIDR,192.168.0.0/16,DIRECT
규칙 키워드

IP-CIDR6

IP-CIDR6은 IPv6 주소 범위에 사용하며 IPv4용 IP-CIDR 항목으로 대체할 수 없습니다. 듀얼 스택 네트워크에서는 같은 도메인이 두 종류의 주소를 반환할 수 있습니다. 주소 규칙이 일치하지 않는 문제를 확인할 때는 실제 연결에서 IPv4와 IPv6 중 어느 쪽을 사용하는지 확인한 뒤 해당 범위를 점검하세요.

IP-CIDR6,fc00::/7,DIRECT
규칙 키워드

USER-AGENT

USER-AGENT는 읽을 수 있는 HTTP User-Agent 필드를 기준으로 요청을 일치시키며, 기기에 설치된 앱 이름에 따라 트래픽을 분배하는 기능은 아닙니다. 암호화된 요청의 필드는 보통 직접 읽을 수 없어 모든 연결에 적용되지는 않습니다. 사용 전에 프로토콜과 처리 조건을 확인하고, 이 규칙을 적용하려고 인증서 설정을 무작정 바꾸지 마세요.

규칙 키워드

FINAL

FINAL은 앞선 규칙에 하나도 일치하지 않을 때 적용하는 최종 처리 방식으로, 일반적으로 Rule 항목의 맨 끝에 둡니다. 도메인이나 주소 조건 없이 행 끝에 최종 정책을 지정합니다. 너무 앞에 두면 뒤에 있는 구체적인 규칙이 기본 처리 전에 적용될 수 없습니다.

FINAL,DIRECT

04 / Policies and order

정책 및 일치 순서

규칙의 PROXY, DIRECT, REJECT는 처리 결과를 나타냅니다. Global Routing의 Proxy, Direct와는 서로 다른 계층의 설정입니다.

정책 및 일치 순서

Rule과 일치 순서

Rule 항목의 규칙은 위에서 아래로 확인하며, 먼저 일치한 규칙이 해당 트래픽의 처리 방식을 결정합니다. 더 구체적인 규칙이 자동으로 우선 적용되는 것은 아닙니다. 우선 처리할 예외는 더 넓은 조건보다 위에 두고 FINAL은 맨 끝에 배치하세요. 확인할 때는 예상한 구성 파일이 활성화되어 있는지도 점검해야 합니다.

DOMAIN,example.com,DIRECT DOMAIN-KEYWORD,example,PROXY FINAL,DIRECT
정책 및 일치 순서

PROXY

PROXY는 일치한 트래픽을 프록시 경로로 처리하는 규칙 정책입니다. 서버 주소, 비밀번호, 구독 정보를 포함하지 않으며 현재 서버에 연결할 수 있음을 보장하지도 않습니다. PROXY 규칙에 일치했는데도 연결할 수 없다면 서버 선택, 인증 매개변수, 현재 네트워크를 계속 확인하세요.

정책 및 일치 순서

DIRECT

DIRECT는 일치한 트래픽을 프록시 서버 없이 현재 네트워크의 직접 연결 경로로 처리합니다. DNS, 대상 서비스, 로컬 네트워크 환경의 영향을 받을 수 있으므로 반드시 성공한다는 뜻은 아닙니다. Config 모드에서 DIRECT를 지정하면 해당 규칙에 일치한 트래픽에만 적용됩니다.

정책 및 일치 순서

REJECT

REJECT는 일치한 요청이 연결을 계속 설정하지 못하도록 차단합니다. 서버 장애가 아니라 명시적인 거부 결과입니다. 페이지 일부 리소스가 누락되거나 기능이 제대로 작동하지 않으면 범위가 지나치게 넓은 거부 규칙이 있는지 확인하세요. 수정 테스트에서는 일치 조건부터 좁히고 모든 규칙을 바로 삭제하지 마세요.

05 / Subscription and configuration

구독 및 구성 파일

서버 정보는 ‘어디에 연결할지’를, 구성 파일은 ‘트래픽을 어떻게 처리할지’를 정합니다. 가져오기, 업데이트, 선택, 연결은 각각 다른 작업입니다.

구독 및 구성 파일

Subscribe

Subscribe는 사용자가 이미 보유한 구독 URL에서 서버 정보를 가져와 업데이트합니다. 어떤 정보가 포함되는지는 해당 URL의 제공자가 결정합니다. 구독 업데이트는 연결을 의미하지 않으며 Config의 규칙 파일을 업데이트하는 것도 아닙니다. 구독 URL에 접근 자격 정보가 포함될 수 있으므로 도움을 요청할 때는 민감한 내용을 모두 삭제하세요.

구독 및 구성 파일

SERVER

SERVER는 서버 정보로 만들어지는 연결 항목으로, 일반적으로 주소, 포트, 프로토콜, 인증 매개변수를 포함합니다. 한국어 설명에서는 노드라고 부르기도 합니다. 항목 이름은 구분을 위한 라벨일 뿐 실제 위치나 연결 품질을 증명하지 않습니다. 사용 가능 여부는 매개변수 확인, 테스트, 실제 요청 결과를 기준으로 판단하세요.

구독 및 구성 파일

.conf 구성 파일

.conf는 General, Rule, Host, URL Rewrite 등의 항목으로 구성할 수 있는 텍스트 설정 파일입니다. 서버 구독과 용도가 다르며 파일이 있다는 이유만으로 트래픽 분배가 적용되었다고 볼 수 없습니다. 편집 전에 원본을 보관하고 저장한 뒤 Config에서 현재 선택된 파일을 확인한 다음 Global Routing도 점검하세요.

구독 및 구성 파일

URL Rewrite

URL Rewrite는 일치 표현식에 따라 처리 가능한 요청 URL을 다시 쓰거나 리디렉션하며 Rule의 라우팅 정책을 대신하지 않습니다. 예시에서는 일치한 HTTP 주소를 HTTPS로 리디렉션하고, 302는 리디렉션 상태 코드입니다. 사용할 때는 요청이 처리 가능한 조건인지, 대상 주소가 올바른지 확인하세요.

^http://example\.com https://example.com 302
구독 및 구성 파일

지연 시간

지연 시간은 테스트에서 요청을 보낸 뒤 응답을 받기까지 걸린 시간입니다. 대역폭, 다운로드 속도, 전체 페이지 로딩 시간과는 다릅니다. 테스트 방식과 네트워크 조건이 비슷해야 결과를 비교하기 쉽습니다. 한 번 측정한 숫자만으로 서버를 선택하지 말고 여러 차례 테스트와 실제 이용 결과를 함께 살펴보세요.