공식 매뉴얼 · 용어와 기능

Shadowrocket 용어집
화면, 프로토콜, 규칙 키워드

먼저 화면 위치, 연결 프로토콜, 매칭 조건, 처리 정책을 구분한 다음 세부 매개변수를 확인하세요. 이 페이지에서는 Home, Config, Global Routing 등의 영문 표기를 그대로 사용합니다. 같은 용어도 위치에 따라 의미가 달라질 수 있으므로 해당 기능의 단계에 맞춰 이해하고, 서버 목록·구성 파일·시스템 연결 상태를 혼동하지 마세요.

iPhone / iPad / Mac(Apple 실리콘 및 Intel) / Windows / 안드로이드 / Linux용 Shadowrocket 용어 안내입니다. 화면 구성은 플랫폼마다 다를 수 있으므로 실제 조작 경로는 현재 앱 화면을 기준으로 확인하세요.

사용하려면 본인이 보유한 구독 정보나 서버 정보가 필요합니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 클라이언트 앱의 일회성 구매는 회선 요금제가 아닙니다. iPhone / iPad 버전은 App Store에서 $2.99에 일회성으로 구매할 수 있으며, Mac / Windows / 안드로이드 / Linux 버전은 무료입니다. 자세한 내용은 전체 플랫폼 다운로드를 확인하세요.

화면 및 스위치

단계별 사용법 보기 →

이 용어들은 ‘어디에서 조작하는지’와 ‘현재 어떤 방식으로 처리하는지’를 설명합니다. 스위치가 켜진 상태, 서버가 선택된 상태, 규칙이 적용된 상태는 서로 다르므로 각각 확인해야 합니다.

화면 및 스위치

Home

Home은 서버와 구독 항목을 확인하고, 사용할 서버를 선택해 연결을 조작하는 주요 화면입니다. 항목을 선택하면 사용할 프록시가 정해질 뿐, 어떤 요청에 그 프록시를 적용할지는 Global Routing과 구성에 따라 달라집니다. 문제를 확인할 때는 먼저 목록에서 선택된 항목을 확인하고 연결 상태를 살펴보세요. 항목이 있다는 것만으로 연결된 것은 아닙니다.

화면 및 스위치

Add Server

Add Server에서는 기존 서버 정보를 직접 입력합니다. 먼저 프로토콜을 선택하고 해당 항목을 입력하세요. 주소와 포트가 같더라도 프로토콜이 다르면 나머지 매개변수를 공유할 수 없습니다. 인증 방식, 전송 방식, TLS 설정을 각각 맞춰야 합니다. 정보가 부족하다면 항목 이름만 보고 값을 추측하지 말고 원래 서비스 제공자에게 확인하세요.

화면 및 스위치

Global Routing

Global Routing은 전체 트래픽 처리 모드를 정합니다. 구성 사용은 Config, 프록시 사용은 Proxy, 직접 연결은 Direct입니다. Config는 현재 구성의 규칙에 따라 요청을 처리하고, Proxy와 Direct는 각각 전체 트래픽을 프록시 또는 직접 연결 경로로 보냅니다. 도메인 규칙을 확인할 때는 먼저 Config 모드인지 확인하세요. Config가 아니라면 규칙 파일을 수정해도 현재 요청 경로에 영향을 주지 않을 수 있습니다.

화면 및 스위치

Proxy / Direct

Proxy와 Direct는 Global Routing의 화면 옵션이며 서버 프로토콜 이름이 아닙니다. Proxy는 전체 트래픽을 프록시 경로로, Direct는 직접 연결 경로로 보냅니다. 이 모드를 바꾸면 문제 범위를 좁히는 데 도움이 되지만, 접속 결과는 DNS, 대상 서비스 및 네트워크 조건에도 영향을 받습니다. 규칙 파일의 대문자 PROXY와 DIRECT는 정책 키워드입니다. 자세한 내용은 정책 안내를 확인하세요.

화면 및 스위치

On Demand

On Demand는 설정한 조건에 따라 연결을 시작하거나 복구합니다. 즉, 연결을 언제 시작하거나 다시 연결할지 정하는 기능입니다. 도메인별 경로를 판단하지 않으므로 규칙 분기를 대신할 수 없습니다. 수동으로 연결을 끈 뒤 다시 연결된다면 Home에서 서버 항목만 삭제하지 말고 On Demand 조건과 시스템 관련 설정을 확인하세요.

화면 및 스위치

Connectivity Test

Connectivity Test는 현재 선택한 테스트 방식과 대상으로 응답을 확인하며, 결과는 해당 테스트에만 적용됩니다. 특정 서버의 테스트가 성공해도 모든 웹사이트, UDP 요청 또는 앱 기능이 정상이라고 단정할 수 없습니다. 테스트에 실패하면 대상, 프로토콜 매개변수, 현재 네트워크를 먼저 확인하고 Log를 살펴 어느 단계에서 문제가 발생했는지 확인하세요.

프로토콜은 클라이언트와 서버가 데이터를 주고받는 방식을 설명하며, 속도 등급을 뜻하지 않습니다. 입력할 때는 본인이 가진 정보를 기준으로 하고, 프로토콜·인증·전송·보안 계층 매개변수를 한꺼번에 확인하세요.

프로토콜

Shadowsocks

Shadowsocks는 양쪽에서 합의한 암호화 방식과 비밀번호 등의 매개변수로 프록시 연결을 구성합니다. 서버 주소, 포트, 암호화 방식, 비밀번호가 일치해야 합니다. 비밀번호만 확인해서는 설정 오류를 모두 배제할 수 없습니다. 추가 매개변수가 안내되어 있다면 원래 지침에 따라 입력하고 다른 항목의 설정을 그대로 적용하지 마세요.

프로토콜

VMess

VMess는 사용자 인증 정보로 인증하며 여러 전송 방식과 함께 사용할 수 있습니다. UUID 외에도 실제 제공된 전송 방식, Host, Path, TLS 매개변수를 확인하세요. 기기 시간이 크게 어긋나면 인증에 영향을 줄 수 있으므로 핸드셰이크나 인증 오류가 발생할 때는 시스템 시간도 확인해 보세요.

프로토콜

VLESS

VLESS는 사용자 식별 정보와 전송·보안 계층 설정을 구분하며, UUID는 연결 정보의 일부일 뿐입니다. 서버에서 요구하는 전송 및 보안 매개변수를 클라이언트 설정과 일치시켜야 합니다. 프로토콜 이름이 비슷하다는 이유로 서로 바꿔 쓸 수 있다고 판단하지 마세요. 가져온 뒤 연결되지 않으면 원래 정보를 하나씩 대조하고 보안 검사를 임의로 끄지 마세요.

프로토콜

Trojan

Trojan은 일반적으로 TLS와 함께 사용하며 비밀번호로 인증합니다. 연결 주소, 인증서에 해당하는 도메인, TLS 관련 매개변수는 서로 다른 역할을 할 수 있으므로 주소가 해석된다는 이유만으로 나머지 확인을 생략하지 마세요. 인증서 오류가 발생하면 도메인, 기기 시간, 서버 인증서 상태를 확인하세요. 검증을 건너뛰는 방식은 일반적인 해결책으로 사용하지 마세요.

프로토콜

Hysteria2

Hysteria2는 QUIC 기반 프록시 프로토콜로, 해당 UDP 통신 경로가 필요합니다. 주소와 인증 정보가 맞는데도 연결되지 않는다면 현재 네트워크에서 관련 UDP 트래픽을 허용하는지 확인하세요. 대역폭 등 조정 가능한 매개변수는 네트워크 환경과 서버 안내에 따라 설정해야 합니다. 값을 높인다고 사용 가능한 대역폭이 늘어나는 것은 아닙니다.

프로토콜

WireGuard

WireGuard는 공개 키·개인 키와 상대 피어 매개변수로 터널을 구성합니다. PrivateKey는 안전하게 보관하고, PublicKey는 해당 피어를 식별하는 데 사용합니다. AllowedIPs는 라우팅 범위, MTU는 데이터 패킷 크기에 영향을 주며 둘 다 인증 비밀번호가 아닙니다. 일부 요청이 멈춘다면 핸드셰이크뿐 아니라 주소, 라우팅 범위, MTU도 확인하세요.

프로토콜

HTTP / SOCKS5

HTTP와 SOCKS5는 서로 다른 프록시 프로토콜이며, 주소·포트·인증 정보가 필요할 수 있습니다. 프로토콜 이름만으로 전송 암호화를 보장할 수 없으며 UDP 지원 범위도 구현과 설정에 따라 달라집니다. 프록시 진입점으로 사용할 때는 접근 범위를 제한해 불필요한 기기에서 포트에 접속하지 못하도록 하세요.

규칙을 이해하려면 매칭 조건과 마지막에 지정된 정책을 함께 확인해야 합니다. 아래 예시는 문법만 보여 줍니다. example.com은 예시 도메인이며 서버나 구독 주소가 아닙니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
규칙 키워드

규칙

규칙은 요청 매칭 조건과 처리 정책을 연결합니다. 일반적으로 구성에 적힌 순서대로 확인해 먼저 일치하는 항목을 적용합니다. 대체로 구체적인 조건을 넓은 조건보다 앞에 두어야 뒤의 세부 규칙이 실제로 적용됩니다. 문제를 확인할 때는 파일에 특정 도메인이 있는지만 검색하지 말고, 현재 파일과 규칙 순서, 실제 매칭 기록을 확인하세요.

규칙 키워드

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD

DOMAIN은 전체 도메인, DOMAIN-SUFFIX는 지정 도메인과 하위 도메인, DOMAIN-KEYWORD는 도메인에 포함된 키워드를 기준으로 매칭합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 example.com과 하위 도메인에 적용됩니다. 키워드 매칭은 범위가 넓으므로 관련 없는 도메인까지 함께 매칭되지 않는지 고려하세요.

규칙 키워드

GEOIP

GEOIP는 IP 지리 정보 데이터베이스의 지역 표기를 기준으로 대상 주소를 매칭합니다. 페이지 표시 언어나 사용자의 위치를 기준으로 판단하는 기능은 아닙니다. 데이터베이스 기록, DNS 응답, 서비스의 주소 분포에 따라 매칭 결과가 달라질 수 있습니다. 한 도메인이 여러 주소를 사용한다면 요청마다 결과가 달라질 수 있으므로 실제로 해석된 주소를 확인하세요.

규칙 키워드

IP-CIDR / IP-CIDR6

IP-CIDR은 IPv4 주소 대역을, IP-CIDR6은 IPv6 주소 대역을 기준으로 매칭합니다. 슬래시 뒤의 접두사 길이가 범위를 결정하며, 접두사가 짧을수록 일반적으로 더 넓은 범위를 포함합니다. 대역을 잘못 지정하면 많은 요청에 영향을 줄 수 있습니다. 도메인이 IPv4와 IPv6 주소를 모두 반환한다면 한 종류의 규칙만 확인해서는 모든 연결을 설명할 수 없습니다.

규칙 키워드

USER-AGENT

USER-AGENT는 요청에서 확인할 수 있는 User-Agent 필드를 기준으로 매칭하며, 모든 앱 프로세스를 식별하는 범용 기능은 아닙니다. 암호화된 요청의 관련 필드는 보통 직접 읽을 수 없으므로 이 규칙만으로 특정 앱의 모든 트래픽이 매칭된다고 판단하지 마세요. 사용하기 전에 프로토콜, 필드 확인 가능 여부, 실제 매칭 기록을 살펴보세요.

규칙 키워드

FINAL

FINAL은 앞선 규칙과 일치하지 않은 요청에 최종 처리 정책을 지정하며, 일반적으로 규칙 목록의 마지막에 둡니다. FINAL,DIRECT는 나머지 요청을 직접 연결 경로로 보낸다는 뜻이지, 앞서 이미 매칭된 요청까지 직접 연결로 바꾼다는 뜻은 아닙니다. 최종 정책을 바꾸면 별도 규칙이 없는 많은 대상에 영향을 줄 수 있으므로 복구할 수 있도록 기존 파일을 보관하세요.

규칙 키워드

PROXY / DIRECT / REJECT

PROXY, DIRECT, REJECT는 규칙에서 사용하는 정책 키워드로 각각 프록시 경로로 전달, 직접 연결, 요청 거부를 뜻합니다. 도메인 매칭 조건이나 서버 프로토콜 세 가지를 의미하지 않습니다. 요청이 거부되면 먼저 매칭된 REJECT 규칙을 찾고, 연결 출구가 예상과 다르면 적용된 정책과 실제 경로를 확인하세요.

구독 관리 및 구성

가져오기 절차 보기 →

서버 항목은 연결 정보를 관리하고, 구독은 여러 항목을 묶어 업데이트하며, Config는 구성 내용을 관리합니다. 가져오기에 성공했다는 것은 정보가 읽혔다는 뜻일 뿐입니다. 연결 상태와 규칙이 예상대로 작동하는지 별도로 확인하세요.

구독 관리 및 구성

Subscribe

Subscribe는 서버 항목을 묶어 저장하고 업데이트하는 기능이며, 링크는 본인이 보유한 서비스 정보에서 가져옵니다. 업데이트로 항목 이름, 개수 또는 매개변수가 바뀔 수 있지만, 현재 Config까지 함께 교체되었다고 단정할 수는 없습니다. 구독 링크에는 개인 접속 정보가 포함될 수 있으므로 화면 캡처, 로그 또는 문의 내용에 전체 링크가 노출되지 않도록 하세요.

구독 관리 및 구성

서버 / 노드

여기서 서버 또는 노드는 클라이언트에서 사용할 수 있는 원격 연결 정보 묶음을 뜻하며, 보통 주소, 포트, 프로토콜 및 인증 정보를 포함합니다. 목록의 표시 이름은 항목을 알아보기 위한 것이며 실제 위치, 대역폭, 사용 가능 여부를 보장하지 않습니다. 구독으로 생성된 항목을 직접 수정하기 전에는 다음 업데이트에서 변경 내용이 덮어써질 수 있는지 고려하세요.

구독 관리 및 구성

Config

Config는 구성 파일을 관리하는 화면을 가리키기도 하고, Global Routing에서 구성에 따라 요청을 처리하는 모드를 뜻하기도 합니다. 구성 파일에는 규칙, DNS 및 기타 설정이 포함될 수 있지만 구체적인 내용은 파일마다 다릅니다. 구독 목록을 전체 구성으로 간주하지 마세요. 전환하거나 원격 업데이트하기 전에 현재 파일을 백업하고 참조 리소스와 최종 정책을 확인하세요.

구독 관리 및 구성

Scan QR Code

Scan QR Code는 QR 코드에서 연결 정보를 읽어옵니다. QR 코드에는 단일 서버 정보나 인식 가능한 링크가 담길 수 있습니다. 스캔은 연결을 검증하는 절차가 아니므로 가져온 뒤 프로토콜, 주소, 포트, 인증 항목을 확인하세요. QR 코드에는 민감한 정보가 포함될 수 있으므로 실제 사용 중인 코드 전체를 공개하지 마세요.

구독 관리 및 구성

URL Rewrite

URL Rewrite는 매칭 조건에 따라 요청 URL을 처리하는 기능으로, 요청을 프록시 또는 직접 연결 경로로 보낼지 결정하는 규칙 분기와는 다른 기능 단계입니다. 적용 범위는 프로토콜, 암호화 상태, 구체적인 설정 조건에 따라 달라지므로 모든 요청에 적용된다고 볼 수 없습니다. 기존 구성을 사용할 때는 각 규칙의 적용 범위를 이해하고, 내용이 불분명한 규칙이 정상 요청을 바꾸지 않도록 주의하세요.

설정을 변경하기 전에 원래 값을 기록하고 한 번에 하나의 변수만 바꾸세요. 기본값과 사용 가능한 옵션은 현재 앱 화면을 기준으로 확인해야 합니다. 용어 설명만으로 실제 네트워크 환경에 대한 판단을 대신할 수는 없습니다.

Settings 항목

DNS

DNS는 도메인을 주소로 변환합니다. DNS 해석 성공과 대상 서버 연결 성공은 서로 다른 단계입니다. DNS 조회에 사용된 경로만으로 실제 트래픽의 최종 출구를 판단할 수도 없습니다. 규칙과 연결 기록을 각각 확인하세요. 도메인으로 접속할 수 없지만 주소로는 접속된다면 DNS 응답, 캐시, 구성의 DNS 설정부터 확인해 보세요.

Settings 항목

Ping / 지연 시간

Ping 또는 지연 시간은 지정된 테스트 조건에서 응답에 걸린 시간을 나타내며 다운로드 속도를 직접 보여 주지는 않습니다. 테스트 방식, 대상, 네트워크 부하에 따라 결과가 달라지므로 비교할 때는 같은 방식을 사용하세요. 한 번의 시간 초과만으로 서버를 완전히 사용할 수 없다고 단정하지 말고 실제 요청과 Connectivity Test 결과도 확인하세요.

Settings 항목

Log

Log에는 연결, 규칙 매칭, 오류 정보가 기록되어 DNS 해석 실패, 인증 실패, 대상 서버의 거부 등을 구분하는 데 도움이 됩니다. 문제를 재현한 다음 비슷한 시각의 기록을 찾으면 과거 오류와 혼동을 줄일 수 있습니다. 로그를 공유하기 전에 서버 주소, 인증 정보, 구독 링크, 개인 접속 내용을 알아볼 수 있는 데이터를 삭제하세요.

Settings 항목

Widget

Widget은 시스템에서 앱 상태를 표시하거나 조작 기능을 제공하는 위젯입니다. 사용할 수 있는 내용은 플랫폼과 현재 앱 기능에 따라 다릅니다. 새로 고침 시점은 시스템이 결정하므로 표시 내용이 실시간 상태와 다를 수 있습니다. 연결 여부를 판단할 때는 위젯의 한 번 표시만 보지 말고 앱과 시스템 연결 상태를 확인하세요.

Settings 항목

iCloud 동기화

iCloud 동기화는 사용 가능한 기기와 계정 조건에서 앱이 지원하는 데이터를 동기화하며, 기기 전체 백업을 뜻하지는 않습니다. 시스템 권한, 연결 승인, 일부 로컬 설정은 새 기기에서 다시 확인해야 할 수 있습니다. 기기를 바꾸기 전에 동기화가 완료됐는지 확인하고 중요한 Config 파일은 별도로 내보내세요. 복원 후 서버 선택과 규칙 작동도 확인해야 합니다.

Settings 항목

Proxy 포트

Proxy 포트는 프록시 서비스를 제공할 때 로컬에서 연결을 수신하는 포트이며, 원격 서버에서 사용하는 포트와는 별개의 매개변수입니다. 다른 기기에서 접속할 수 있는지는 수신 주소, 로컬 네트워크 권한, 방화벽 설정에도 달려 있습니다. 여러 기기에서 사용할 필요가 없다면 접근 범위를 제한하세요. 포트를 변경한 뒤에는 해당 프록시에 연결하는 기기의 주소와 포트도 확인해야 합니다.