OFFICIAL MANUAL / GLOSSARY

Shadowrocket 용어집

인터페이스 이름으로 기능을 확인하고 규칙 키워드로 매칭 범위를 살펴보세요. 앱과 구성에서 쓰이는 영문 표기는 그대로 두고, 각 항목이 해결하는 문제와 그 용어만으로 추측할 수 없는 내용을 설명합니다.

용어 33개
인터페이스 이름과 구성 문법은 구분해서 이해하세요

01 / INTERFACE

인터페이스 및 설정

먼저 옵션의 위치를 확인한 뒤 전체 연결에 적용되는지 개별 요청에 적용되는지 살펴보세요.

Home: 서버 항목을 확인하고 연결 대상을 선택하거나 연결을 제어하는 주요 메뉴입니다. 항목을 선택했다는 것은 연결 대상을 지정했다는 뜻일 뿐, 연결이 이미 설정되어 사용할 수 있다는 뜻은 아닙니다. 처음 사용할 때는 정보를 가져온 뒤 선택 상태를 확인하고 연결 및 접속을 점검하세요.

Global Routing: 전체 트래픽 처리 방식을 정하는 옵션입니다. 주로 Config, Proxy, Direct를 선택하며 각각 구성, 프록시, 직접 연결에 해당합니다. 문제를 확인할 때는 현재 선택을 먼저 기록해 두세요. 모드 변경으로 생긴 변화를 서버 문제로 오인하지 않도록 합니다. 실제로 규칙이 적용되는지는 현재 모드에 따라 달라집니다.

Config: Global Routing에서 Config는 현재 구성의 규칙에 따라 트래픽을 처리한다는 뜻입니다. 다른 위치에서는 구성 관리 메뉴를 가리킬 수도 있습니다. 이 모드를 사용하기 전에 파일을 가져오기만 한 상태가 아니라 원하는 구성을 실제로 사용 중인지 확인하세요. 규칙 순서, 정책 이름, 최종 규칙이 처리 결과에 영향을 줍니다.

Proxy: Global Routing에서 Proxy는 프록시 정책으로 트래픽을 처리한다는 뜻이며, 보통 연결 경로를 임시로 비교할 때 사용합니다. 규칙 텍스트의 특정 행과 같은 의미가 아니며 모든 대상에 접속할 수 있다는 보장도 없습니다. 사용할 수 있는 서버 정보가 있어야 하며 DNS와 연결 환경도 확인해야 합니다.

Direct: Global Routing에서 Direct는 직접 연결 정책을 사용해 요청을 프록시 서버로 보내지 않는다는 뜻입니다. 다른 모드와 비교해 문제가 프록시 경로와 관련 있는지 확인할 때 유용합니다. Direct를 선택해도 시스템의 VPN 구성이 삭제되거나 꺼지는 것은 아니므로 두 항목을 각각 확인하세요.

On Demand: 미리 설정한 조건에 따라 연결 동작을 실행하는 On Demand 설정입니다. 도메인별 트래픽 분할 규칙과는 적용 범위가 다릅니다. 설정하기 전에 어떤 네트워크 조건에서 연결하거나 연결을 끊을지 정하세요. 수동으로 연결을 끊은 뒤 다시 연결된다면 서버 매개변수를 계속 바꾸기보다 On Demand 조건부터 확인하세요.

Connectivity Test: 현재 테스트 조건에서 서버 연결 가능 여부와 응답 시간을 확인합니다. 결과는 당시의 네트워크, 테스트 방식, 대상에만 해당하며 다운로드 속도나 모든 웹사이트의 접속 상태를 그대로 보여주지는 않습니다. 결과를 비교할 때는 조건을 동일하게 유지하고 실제 접속도 함께 확인하세요.

02 / PROTOCOLS

프로토콜

프로토콜 이름은 통신 방식을 나타낼 뿐 서비스 품질을 보장하지 않습니다. 매개변수는 사용자가 보유한 서버 정보와 일치해야 합니다.

Shadowsocks: 클라이언트와 서버의 주소, 포트, 비밀번호, 암호화 방식이 서로 일치해야 하는 프록시 프로토콜입니다. 주소만 올바르게 입력해서는 연결되지 않습니다. 직접 입력할 때는 암호화 방식을 항목별로 확인하고 이름이 비슷하다는 이유로 임의로 바꾸지 마세요.

VMess: 일반적으로 UUID 인증 정보를 사용하는 프록시 프로토콜입니다. 연결하려면 전송 계층 및 보안 계층 설정이 추가로 필요할 수 있습니다. UUID가 올바르더라도 Host, Path, TLS 매개변수가 맞다는 뜻은 아닙니다. 가져온 뒤 연결되지 않는다면 포트만 바꾸지 말고 원본 정보를 기준으로 전체 항목을 확인하세요.

VLESS: 인증 정보와 사용하는 전송 및 보안 계층 매개변수를 함께 확인해야 하는 프록시 프로토콜입니다. 프로토콜 이름만으로는 모든 연결 조건을 알 수 없습니다. 기존 정보에 Server Name이나 Path 등의 항목이 있다면 원래 값과 대조하고, 경험에 따라 임의로 입력하거나 생략하지 마세요.

Trojan: 일반적으로 TLS와 비밀번호 인증을 함께 사용하는 프록시 프로토콜입니다. 서버 주소, 포트, 비밀번호, 인증서에 대응하는 이름이 연결에 영향을 줄 수 있습니다. 인증서 검증 문제가 발생하면 먼저 주소, Server Name, 시스템 시간을 확인하세요. 검증을 끄는 것을 일반적인 해결 방법으로 삼지 마세요.

Hysteria2: QUIC 기반 프록시 프로토콜로, 연결하려면 현재 네트워크에서 해당 UDP 트래픽을 지원해야 합니다. 네트워크 환경이 바뀌면 같은 매개변수로도 연결 가능 여부가 달라질 수 있습니다. 문제를 확인할 때는 도메인 변환 여부만 보지 말고 인증, TLS 매개변수, UDP 연결 상태를 각각 확인하세요.

WireGuard: 공개 키와 개인 키로 암호화 터널을 구성하는 프로토콜입니다. 로컬 주소, 피어 공개 키, Endpoint, 라우팅 범위를 확인해야 합니다. 개인 키는 민감한 인증 정보이므로 공개 스크린샷이나 문제 해결 기록에 포함하지 마세요. 핸드셰이크 성공은 일부 연결 조건이 충족되었다는 뜻일 뿐이므로 라우팅과 DNS도 확인해야 합니다.

HTTP / SOCKS5: 자주 쓰이는 두 가지 프록시 프로토콜 이름입니다. 인증 방식과 처리할 수 있는 요청 유형은 실제 서버 설정을 기준으로 확인해야 합니다. 프로토콜 이름만으로 연결이 암호화되는지 판단할 수 없습니다. 추가할 때 Type, 주소, 포트, 인증 항목을 확인하고 한 프로토콜의 매개변수를 다른 유형에 입력하지 않도록 주의하세요.

03 / RULES & POLICIES

규칙 키워드 및 정책

키워드는 매칭 여부를 판단하고, 정책은 매칭된 요청의 처리 방식을 결정합니다.

규칙: 일반적으로 매칭 유형, 매칭 대상, 처리 정책으로 구성되며 구성에 적힌 순서대로 평가됩니다. 앞쪽의 광범위한 규칙이 뒤쪽의 구체적인 규칙보다 먼저 적용될 수 있으므로 한 줄만 확인해서는 안 됩니다. 규칙 적용 여부는 현재 Global Routing이 Config를 사용하는지에도 달려 있습니다.

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN은 전체 도메인을, DOMAIN-SUFFIX는 지정된 도메인과 하위 도메인을, DOMAIN-KEYWORD는 도메인에 포함된 키워드를 기준으로 매칭합니다. 세 규칙의 범위는 서로 다르며, 키워드 매칭은 특히 원치 않는 대상까지 포함하지 않도록 주의해야 합니다. 도메인 규칙에 URL의 경로나 쿼리 매개변수를 섞어 넣지 마세요.

GEOIP: 웹페이지 언어, 도메인 접미사, 사용자 위치가 아니라 IP 지리 데이터베이스의 등록 정보를 기준으로 매칭합니다. 결과는 데이터베이스와 실제로 변환된 주소의 영향을 받습니다. 같은 도메인도 서로 다른 주소를 사용할 수 있어 적용되는 규칙이 달라질 수 있으므로 연결 기록과 함께 확인하세요.

IP-CIDR / IP-CIDR6: IPv4 및 IPv6 주소 대역을 각각 매칭하며, 주소와 프리픽스 길이로 범위를 나타냅니다. 프리픽스 길이에 따라 적용 범위가 달라지므로 단일 주소와 전체 대역을 혼동하지 마세요. 구성할 때는 대상에서 실제로 사용하는 주소 유형을 확인해 한쪽만 적용되는 일이 없도록 하세요.

FINAL: 앞선 규칙에 매칭되지 않았을 때 적용되는 최종 규칙이며, 보통 규칙 목록의 맨 끝에 둡니다. 나머지 요청의 처리 방식을 결정하지만 앞에서 이미 매칭된 요청을 덮어쓰지는 않습니다. 모든 대상이 FINAL에 해당한다면 앞선 규칙의 매칭 내용과 순서를 먼저 확인하세요.

PROXY / DIRECT / REJECT: 규칙의 처리 정책입니다. PROXY는 프록시 경로로 전달하고, DIRECT는 직접 연결하며, REJECT는 요청을 거부합니다. 대문자로 표시된 정책 이름과 Global Routing의 Proxy, Direct는 같은 설정으로 혼동하면 안 됩니다. REJECT는 매칭 가능한 요청 범위에 적용되며 같은 도메인의 임의 항목만 골라 삭제하지는 못합니다.

USER-AGENT: 읽을 수 있는 요청의 User-Agent 정보를 기준으로 매칭하며 앱에 표시된 이름을 기준으로 하지는 않습니다. 암호화된 요청에서는 관련 정보가 직접 보이지 않을 수 있으므로 모든 요청에 적용되는 앱 식별 방식은 아닙니다. 예상과 다르게 매칭된다면 먼저 요청에 매칭 가능한 정보가 있는지 확인하세요.

규칙 문법 예시이며 완전한 구성은 아닙니다

아래 내용은 매칭 유형과 정책의 관계만 보여주는 예시입니다. example.com은 설명을 위한 예시 도메인입니다. 사용하기 전에 현재 구성의 정책 정의와 순서를 확인하세요.

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

04 / SUBSCRIPTION & CONFIG

구독 및 구성

가져오기, 업데이트, 규칙 구성, 데이터 동기화는 서로 다른 작업이며 서로 대체할 수 없습니다.

Add Server: 사용자가 보유한 서버 정보를 바탕으로 항목을 직접 만드는 메뉴입니다. 보통 Type을 선택한 다음 Address, Port 등의 해당 항목을 입력합니다. 프로토콜마다 필요한 항목이 다릅니다. 저장하기 전에 원본 정보와 대조하고, 모든 항목을 입력했다고 해서 매개변수가 올바른 것은 아니라는 점에 유의하세요.

Scan QR Code: QR 코드로 기존 서버 또는 구독 정보를 읽는 방식이며, 실제로는 인코딩된 내용을 가져오는 작업입니다. 코드를 읽은 뒤에도 유형, 주소, 이름을 확인해야 합니다. QR 코드에 인증 정보 전체가 들어 있을 수 있으므로 이미지를 공유하기 전에 수신 범위를 확인하고, 장식용 이미지처럼 공개하지 마세요.

구독 업데이트: 원격 구독 내용을 다시 읽어 해당 서버 항목을 로컬에서 새로 고치는 작업입니다. Shadowrocket 앱을 업데이트하는 것이 아닙니다. 원격 내용이 바뀌면 항목이 추가, 삭제되거나 매개변수가 변경될 수 있습니다. 업데이트 전에 이름 지정과 정리 방식을 기록해 두고, 업데이트 후 현재 선택이 여전히 의도한 상태인지 확인하세요.

구성 파일: 규칙, 정책 연결, 관련 설정을 저장하는 텍스트 구성입니다. 서버 목록만 제공하는 구독과는 다른 항목입니다. 구성을 가져온 뒤에는 실제로 해당 구성을 사용 중인지 확인해야 합니다. 변경 전에 복원 가능한 사본을 보관하고 한 항목씩 수정한 뒤 확인해 여러 조건을 동시에 바꾸지 않도록 하세요.

DNS: 도메인을 IP 주소로 변환하는 방식으로, 이후 요청이 연결되는 대상과 일부 규칙 판단에 영향을 줍니다. 변환에 성공해도 포트에 연결할 수 있거나 서버 인증을 통과한다는 뜻은 아닙니다. 도메인으로만 접속 문제가 발생한다면 DNS 결과와 실제 연결 실패를 구분해 확인하세요.

URL Rewrite: 조건에 따라 요청 주소나 관련 요청 동작을 바꾸는 구성 기능입니다. 트래픽을 특정 프록시 정책으로 전달하는 것과는 다릅니다. 요청에 적용될 수 있는지는 프로토콜, 암호화, 읽을 수 있는 정보에 따라 달라집니다. 사용 전에 매칭 범위를 이해하고, 예상치 못한 이동이나 요청 실패에 대비해 복원할 구성을 보관하세요.

iCloud 동기화: 관련 설정을 활성화하면 iCloud에서 지원하는 데이터를 동기화하며, 구체적인 범위는 앱 내 안내를 따르세요. 동기화 상태와 App Store 구매 자격은 별도로 관리됩니다. 앱을 다시 받아도 모든 구성이 복원되는 것은 아니며, 동기화가 변경 전 별도 백업을 대신하지도 않습니다.

연속된 작업 절차는 구독 및 서버 관리를 확인하세요. 처음 사용하는 경우 시작하기에서 시작할 수 있습니다.

05 / APP STORE & ACCOUNT

App Store 및 계정

구매 자격, 앱 데이터, 연결 서비스는 각각 따로 관리되므로 복원할 때도 별도로 확인해야 합니다.

App Store 정품 확인: 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118이 맞는지 모두 확인하세요. Shadowrocket은 Apple 플랫폼에서만 App Store를 통해 받을 수 있으며, 주로 iPhone 및 iPad에서 이용합니다. 기기 호환성과 시스템 요구 사항은 App Store 페이지의 안내를 따르세요.

일회성 구매: Shadowrocket 클라이언트 앱을 구매하는 결제 방식입니다. 미국 스토어 가격은 약 $2.99이며 실제 가격은 App Store 페이지를 확인하세요. 앱의 일회성 구매와 연결 서비스 요금제는 별개입니다. 연결 기능을 사용하려면 사용자가 자신의 구독 또는 서버 정보를 보유해야 합니다. 다른 기기에서의 공통 구매 자격은 App Store 페이지의 안내를 따르세요.

구입 항목: App Store 계정의 구매 내역에서 이미 구입한 앱을 찾아 다시 받는 메뉴로, 기기 교체나 재설치 후 확인할 때 사용할 수 있습니다. 먼저 현재 스토어 계정이 구매 당시 계정과 같은지 확인하세요. 앱을 다시 받아도 기존 구독 인증 정보가 자동으로 생성되지는 않으므로 앱 데이터 복원 여부는 별도로 확인해야 합니다.

스토어 지역: 계정이 이용하는 App Store 스토어프런트와 상품 표시 및 결제 조건을 정하며 시스템 표시 언어와는 다릅니다. 앱을 검색할 수 없다면 계정의 스토어프런트, 연령 등급 제한, 계정 상태를 먼저 확인하세요. 지역을 변경하면 결제 수단과 기존 계정 혜택에 영향을 줄 수 있으므로 시스템 안내를 읽은 뒤 진행하세요.

구매, 정품 확인, 구입 항목 복원 절차는 App Store 다운로드 안내에서 확인하세요. 용어를 확인한 뒤에도 연결에 문제가 있다면 자주 묻는 질문을 살펴보세요.