Global Routing
전체 트래픽 처리 방식을 정하는 인터페이스 메뉴입니다. 주요 옵션은 설정, 프록시, 직접 연결이며, 인터페이스에는 각각 Config, Proxy, Direct로 표시됩니다. 개별 규칙의 정책과는 적용 단계가 다르며, 옵션을 바꾸면 현재 설정의 규칙 적용 여부가 달라질 수 있습니다. 트래픽 분기가 예상과 다르면 먼저 이 메뉴를 확인한 다음 규칙 내용을 살펴보세요.
공식 매뉴얼 · 용어 참고
Shadowrocket 용어 설명
먼저 인터페이스 옵션, 매칭 조건, 처리 정책을 구분한 뒤 세부 매개변수를 확인하세요. 이 페이지는 인터페이스에 표시되는 영문 용어를 그대로 두고 사용 위치에 따라 설명합니다. 각 항목은 앵커 링크로 바로 이동할 수 있습니다.
Shadowrocket은 Apple 플랫폼용 유료 클라이언트이며, 유일한 다운로드 경로는 App Store입니다. 클라이언트는 1회 구매이며, 연결 서비스 요금제와는 별개입니다. 아래 연결 안내는 사용자가 자신의 구독 또는 서버 정보를 보유하고 있다는 전제하에 작성되었습니다.
01 / INTERFACE
인터페이스 및 스위치
이 명칭은 조작 메뉴 또는 전체 동작 방식을 나타내며, 설정 파일에 그대로 붙여 넣을 수 있는 문법이 아닙니다.
Config
Global Routing에서는 현재 활성화된 설정에 따라 트래픽을 처리한다는 뜻이며, 다른 위치에서는 설정 파일 관련 메뉴를 가리킬 수도 있습니다. Config를 선택했다고 모든 요청이 프록시를 통과하는 것은 아닙니다. 실제 결과는 일치하는 규칙과 정책에 따라 달라집니다. 확인할 때는 현재 설정, 규칙 순서, 마지막의 FINAL을 함께 살펴보세요.
Proxy
Global Routing에서 전체 트래픽을 프록시 경로로 처리하는 옵션입니다. 구체적인 적용 범위는 앱 설정도 함께 확인해야 합니다. 같은 요청을 처리 방식별로 비교하는 데 쓸 수 있지만, 서버 매개변수 오류를 해결해 주지는 않습니다. 이 옵션을 규칙에 쓰는 대문자 PROXY와 혼동하지 마세요.
Direct
Global Routing에서 전체 트래픽을 직접 연결 경로로 처리하는 옵션입니다. 일치하는 요청에만 적용되는 DIRECT 규칙 정책과 다르며, 네트워크 관련 설정을 모두 끄는 것과도 다릅니다. 연결 결과를 비교할 때는 대상 주소와 로컬 네트워크를 동일하게 유지해 여러 조건을 동시에 바꾸지 않도록 하세요.
On Demand
설정된 네트워크 또는 접근 조건에 따라 연결 동작을 실행해 수동으로 전환하는 횟수를 줄입니다. Wi-Fi, Cellular 등은 확인해야 할 인터페이스 조건명이며, 독립적인 설정 파일 문법이 아닙니다. 설정한 뒤 해당 네트워크로 각각 전환해 확인하고, 예상한 수동 조작과 충돌하지 않는지도 살펴보세요.
Add Server
사용자가 보유한 서버 정보를 입력하는 메뉴입니다. 일반적으로 유형을 선택한 뒤 주소, 포트, 인증 매개변수를 입력합니다. 선택한 프로토콜에 따라 표시되는 필드가 다를 수 있으므로 주소만 입력하지 말고 자신의 서버 안내와 항목별로 대조하세요. 항목을 저장해도 입력만 완료된 상태이므로, 서버를 선택해 연결을 확인해야 합니다.
Connectivity Test
지정한 테스트 조건에서 연결 상태를 확인합니다. 결과는 테스트 대상, 현재 네트워크, 서버 상태에 따라 달라집니다. 테스트에 한 번 성공했다고 모든 앱에 정상적으로 연결할 수 있는 것은 아니며, 테스트에 걸린 시간이 지속적인 다운로드 속도를 나타내지도 않습니다. 문제를 확인할 때는 테스트 결과를 실제 요청, 일치한 규칙, 연결 기록과 함께 살펴보세요.
02 / PROTOCOLS
프록시 프로토콜
프로토콜은 양쪽 장치의 통신 방식을 결정합니다. 선택 기준은 프로토콜 이름이 아니라 사용자가 보유한 서버의 실제 설정입니다.
Shadowsocks
프록시 프로토콜의 하나로, 일반적인 연결 매개변수에는 서버 주소, 포트, 비밀번호, 암호화 방식이 포함됩니다. 암호화 방식은 서버 측 설정과 일치해야 하며, 클라이언트에서 임의로 바꾼 뒤에도 연결될 것으로 기대해서는 안 됩니다. 기존 정보에 다른 매개변수가 있다면 원래 안내와 대조해 복사 과정에서 빠뜨리지 않도록 하세요.
VMess
사용자 식별 정보 등의 매개변수로 인증하는 프록시 프로토콜이며, 연결에 전송 방식과 TLS 설정이 필요할 수 있습니다. 사용자 식별 정보가 같더라도 전송 매개변수를 다른 연결에 그대로 사용할 수 있는 것은 아닙니다. 경로와 서버 이름 등의 필드도 핸드셰이크에 영향을 줄 수 있으므로, 가져온 뒤에는 프로토콜 유형만 확인하지 말고 원래 정보를 대조하세요.
VLESS
사용자 식별 정보로 인증하는 프록시 프로토콜입니다. 이름만으로 전송 계층의 보호 방식을 판단할 수 없습니다. 실제 연결에서는 전송 설정, TLS, 서버 측 요구사항을 함께 확인해야 하며, 관련 필드는 사용자가 보유한 설정 정보에서 가져와야 합니다. 다른 프로토콜의 매개변수를 VLESS 항목에 그대로 적용하지 마세요.
Trojan
일반적으로 TLS와 함께 사용하는 프록시 프로토콜이며, 비밀번호는 연결 매개변수 중 하나일 뿐입니다. 포트, 서버 이름, 인증서 검증 설정도 연결에 영향을 줄 수 있습니다. 인증서 오류가 발생하면 먼저 도메인, 인증서, 기기의 시간을 확인하세요. 검증 생략을 기본 해결 방법으로 사용하지 마세요.
Hysteria2
QUIC 기반 프록시 프로토콜이며, 연결에 필요한 UDP 통신이 가능해야 합니다. 문제를 확인할 때 주소와 인증 정보뿐 아니라 TLS 및 로컬 네트워크의 UDP 통신 가능 여부도 살펴보세요. Wi-Fi와 셀룰러 네트워크에서 같은 항목의 동작이 다르면 네트워크 경로가 원인일 수 있으므로, 프로토콜 이름만으로 원인을 단정하지 마세요.
WireGuard
키 쌍으로 인증하는 터널 프로토콜이며, 설정에 로컬 키, 피어 공개 키, Endpoint, 주소 등이 필요합니다. 공개 키와 개인 키는 용도가 다르므로 서로 바꿔 입력할 수 없으며, 개인 키는 민감한 자격 증명으로 안전하게 보관해야 합니다. 연결이 설정된 뒤에도 라우팅과 DNS를 확인하세요. 핸드셰이크에 성공해도 모든 대상에 연결할 수 있는 것은 아닙니다.
HTTP / SOCKS5
흔히 쓰이는 프록시 프로토콜 두 가지로, 주소, 포트, 계정과 비밀번호를 모두 사용할 수 있지만 통신 방식은 서로 다릅니다. 서버 주소가 같다고 유형을 바꿔 쓸 수 있는 것은 아니며, UDP 지원과 인증 방식도 실제 설정에 따라 확인해야 합니다. 프로토콜 이름만으로 암호화 전송이 보장되지는 않으므로 별도의 보호 기능이 있는지 확인하세요.
03 / MATCH & POLICY
규칙 키워드 및 정책
규칙의 앞부분은 매칭 조건을 설명하고 뒷부분은 처리 정책을 지정합니다. 일반적으로 위에서 아래로 확인해 먼저 일치하는 항목이 적용됩니다.
DOMAIN
전체 도메인과 일치시키는 규칙입니다. 예: DOMAIN,example.com,PROXY. 이 규칙은 모든 하위 도메인과 자동으로 일치하지 않으므로 www.example.com은 별도로 고려해야 합니다. 특정 호스트 이름 하나만 처리하려면 먼저 범위가 좁은 이 조건을 사용하세요.
DOMAIN-SUFFIX
도메인 접미사와 일치시키는 규칙입니다. 예: DOMAIN-SUFFIX,example.com,PROXY. 일반적으로 해당 도메인과 하위 도메인을 함께 처리합니다. 여기서 접미사는 도메인 계층을 기준으로 일치하며, 임의의 문자열이 포함되는지를 확인하는 방식이 아닙니다. 특정 하위 도메인을 별도로 처리하려면 이 규칙보다 구체적인 규칙을 앞에 두세요.
DOMAIN-KEYWORD
도메인에 포함된 키워드와 일치시키는 규칙입니다. 예: DOMAIN-KEYWORD,example,PROXY. 범위가 예상보다 넓을 수 있으며, 해당 문자열이 들어간 서로 다른 도메인이 모두 일치할 수 있습니다. 사용 전에 처리할 대상을 정리하고, 더 명확한 DOMAIN 또는 DOMAIN-SUFFIX로 바꿀 수 있는지 확인하세요.
GEOIP
대상 IP가 지리 데이터베이스에 등록된 지역을 기준으로 일치시킵니다. 예: GEOIP,CN,DIRECT. 페이지에 표시되는 언어, 계정 지역, 사용자의 현재 위치를 기준으로 판단하지 않으며, 결과는 조회된 주소와 데이터베이스 내용에 따라 달라질 수 있습니다. 특정 도메인을 정확하게 처리해야 한다면 지역 규칙에만 의존하지 마세요.
IP-CIDR / IP-CIDR6
각각 IPv4와 IPv6 주소 범위에 적용되며, 슬래시 뒤의 접두사 길이가 범위를 결정합니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT는 IPv4 사설 주소 범위를 나타냅니다. 규칙을 추가하기 전에 대상 주소의 유형을 확인하세요. IPv4 규칙은 해당 IPv6 주소에 대한 판단을 대신할 수 없습니다.
USER-AGENT
요청에서 식별할 수 있는 User-Agent 정보를 기준으로 일치시키며, 기기에 설치된 모든 앱의 신원을 읽는 기능은 아닙니다. 트래픽 유형, 요청 정보의 가시성, 실제 처리 방식에 제한이 있으므로 일반적인 앱 식별 기능으로 볼 수 없습니다. 사용하기 전에 현재 요청에 매칭에 필요한 정보가 실제로 포함되어 있는지 확인하세요.
FINAL
앞선 규칙이 일치하지 않을 때 적용하는 기본 규칙으로, 보통 규칙 목록 마지막에 둡니다. 예를 들어 FINAL,PROXY는 나머지 요청을 PROXY로 전달한다는 뜻이며, 앞에서 이미 일치한 규칙을 강제로 덮어쓰지 않습니다. 요청 경로가 예상과 다르면 FINAL을 수정하기 전에 앞선 규칙부터 확인하세요.
PROXY
규칙에서 프록시 경로를 사용하도록 지정하는 정책 키워드입니다. 실제 연결 여부는 현재 선택한 서버나 관련 정책 설정에도 좌우됩니다. 규칙에 PROXY가 적용되었다는 것은 처리 방향만 나타내며, 서버 인증과 전송, 대상 접근까지 성공했다는 뜻은 아닙니다. 사용 위치에 따라 Global Routing의 Proxy 옵션과 구분하세요.
DIRECT
규칙에서 대상 주소에 직접 연결하도록 지정하는 정책 키워드입니다. 예: DOMAIN-SUFFIX,apple.com,DIRECT. 직접 연결 요청도 로컬 네트워크, DNS, 대상 서비스가 정상적으로 작동해야 하며, 요청이 반드시 성공하는 것은 아닙니다. 일치한 요청의 처리 방식만 나타내며 Global Routing 전체가 Direct로 전환되었다는 뜻은 아닙니다.
REJECT
규칙에서 일치한 요청을 거부하는 정책 키워드입니다. 조건 범위가 지나치게 넓으면 페이지에서 사용하는 이미지, 로그인 인터페이스, 기타 리소스도 거부되어 일부 내용이 표시되지 않을 수 있습니다. 추가할 때는 명확한 도메인 조건부터 시작하고, 문제가 생기면 일치 기록과 규칙 순서를 먼저 확인하세요.
04 / CONFIGURATION
설정 파일 섹션
섹션 이름은 매개변수의 용도를 구분합니다. 같은 도메인이라도 서로 다른 섹션에 있으면 완전히 다른 단계에 영향을 줄 수 있습니다.
[General]
설정 파일에서 공통 매개변수를 모아 두는 섹션입니다. 예: dns-server = system. 공통 매개변수는 여러 유형의 요청에 영향을 줄 수 있으므로 특정 도메인 하나에만 적용되는 규칙으로 취급하면 안 됩니다. 수정 전 현재 설정의 사본을 저장하고, 한 번에 하나씩 변경해 확인하세요. 여러 매개변수를 동시에 바꾸면 되돌리기 어려울 수 있습니다.
DNS
도메인을 IP 주소로 변환하는 메커니즘으로, 이후의 실제 연결과는 별개의 단계입니다. 주소를 조회했다고 해당 주소에 연결할 수 있는 것은 아니며, 프록시 연결에 성공했다고 DNS 설정이 반드시 올바른 것도 아닙니다. 문제를 확인할 때는 조회 결과, DNS 조회 경로, 최종 연결 경로를 각각 살펴보세요.
[Rule]
매칭 규칙과 처리 정책을 지정하는 섹션입니다. 흔히 다음과 같이 작성합니다: DOMAIN-SUFFIX,example.com,PROXY. 규칙은 일반적으로 위에서 아래로 적용되므로, 구체적인 예외 규칙을 범위가 넓은 조건보다 앞에 둡니다. 수정한 뒤 문법뿐 아니라 해당 규칙이 포함된 설정이 활성화되어 있는지도 확인하세요.
[Host]
도메인과 지정 주소의 매핑을 선언하는 섹션입니다. 예: localhost = 127.0.0.1. 이 매핑은 주소 해석에 적용되며, 해당 도메인에 PROXY 또는 DIRECT를 선택하는 것과는 다릅니다. 대상 서비스의 주소가 바뀔 수 있으므로 고정 매핑은 사용 목적을 분명히 하고, 더 이상 필요하지 않을 때 다시 확인하세요.
[URL Rewrite]
매칭 표현식에 따라 요청 URL을 처리하는 섹션입니다. 매칭 패턴과 대체 대상이 서로 맞는지 확인해야 합니다. [Rule]에서 연결 정책을 선택하는 도메인 규칙과 다르며, 이 섹션이 있다고 해서 모든 암호화 요청을 수정할 수 있는 것도 아닙니다. 작성할 때 이스케이프, 매칭 범위, 적용 대상 요청을 살펴 중복 리디렉션을 방지하세요.
05 / SUBSCRIPTION & ACCOUNT
구독 및 계정
앱 구매 내역, 서버 접근 자격 증명, 구독 목록은 서로 다른 항목이므로 복원 및 업데이트도 각각 처리해야 합니다.
Subscribe
사용자가 보유한 서버 목록을 가져오거나 업데이트하는 구독 관련 유형 또는 메뉴입니다. 링크는 본인의 서비스 제공업체에서 받아야 합니다. 구독을 업데이트하면 목록을 다시 가져오며 항목의 주소, 이름, 개수가 달라질 수 있습니다. 이는 Shadowrocket 앱 업데이트와는 다릅니다. 구독 링크에는 인증 정보가 포함될 수 있으므로 공개하거나 함부로 전달하지 마세요.
서버 정보
연결에 필요한 주소, 포트, 프로토콜, 인증 매개변수 등의 정보입니다. 개별 항목을 흔히 노드라고도 합니다. 여러 항목을 포함하는 구독 목록과는 다르며, 항목을 하나씩 입력했다고 구독 업데이트가 설정되는 것은 아닙니다. 문제 해결 정보를 공유할 때는 비밀번호, 개인 키 및 기타 인증 정보를 숨기고 필요한 오류 설명만 남기세요.
지연 시간
특정 테스트 조건에서 응답을 기다리는 데 걸리는 시간으로, 의미는 테스트 방식과 대상에 따라 달라집니다. 지연 시간은 대역폭과 다르며, 수치가 낮다고 지속적인 전송 속도나 안정성이 더 좋다고 단정할 수 없습니다. 여러 항목을 비교할 때는 가능한 한 같은 네트워크와 테스트 방법을 사용하고 실제 사용 결과도 함께 확인하세요.
Apple ID
App Store 구매 내역을 확인하고 앱을 다시 받는 데 사용하는 계정입니다. 구매할 때 현재 스토어에 로그인된 계정을 확인하세요. 사용자가 보유한 연결 서비스 계정과는 별개이며, 앱을 구매해도 서버 정보가 자동으로 입력되지는 않습니다. 시스템 요구사항, 호환 범위, 통합 구매 적용 여부는 App Store 페이지의 안내를 기준으로 확인하세요.
구입 항목
App Store에서 원래 계정의 구매 내역을 확인하고 앱을 다시 받는 메뉴입니다. 정확한 메뉴 이름은 현재 시스템에 표시되는 내용을 기준으로 확인하세요. 기기를 바꾸거나 앱을 다시 설치할 때는 재구매하기 전에 원래 구매 계정과 스토어 상태를 먼저 확인하세요. 앱 복원은 구독, 서버 항목, Config 복원과 별개이며, 후자는 본인의 백업 또는 원래 정보에서 복원해야 합니다.