Home
Home은 서버 목록과 현재 선택 항목, 연결 상태를 확인하는 주요 화면입니다. 서버가 목록에 표시된다는 것은 항목이 저장되었다는 뜻일 뿐입니다. 적절한 항목을 선택하고 연결을 켜야 합니다. 문제를 확인할 때는 ‘항목이 존재함’, ‘선택됨’, ‘연결됨’ 상태를 구분하세요.
공식 가이드 · 용어 찾아보기
Shadowrocket 용어 정리
화면 메뉴, 프로토콜, 규칙, 네트워크 개념을 범주별로 살펴보세요. 먼저 용어가 속한 계층을 파악한 뒤 서버 매개변수, 구성 파일, 전체 연결 방식 중 무엇을 조정해야 할지 확인합니다. 영문 명칭은 앱 화면 및 규칙 문법에 맞춰 그대로 표기합니다.
- 화면 용어는 영어 그대로 표기
- 규칙 키워드는 대소문자 구분
- 기존 구독 또는 서버 정보가 있다는 전제
메뉴와 연결 방식
화면 및 스위치
화면 메뉴는 작업을 구성하고, 연결 상태는 현재 작동 상황을 나타냅니다. 페이지에 들어가거나 항목을 선택하는 것만으로 연결이 성립하지는 않습니다.
Global Routing
Global Routing은 전체 라우팅 방식을 결정합니다. Config, Proxy, Direct는 각각 구성, 프록시, 직접 연결 모드입니다. Config는 현재 구성의 규칙에 따라 요청을 처리하고, Proxy는 트래픽을 프록시로 처리하며, Direct는 트래픽을 직접 연결합니다. 모드 선택과 개별 규칙의 마지막 동작은 서로 다른 계층입니다.
On Demand
On Demand는 시스템의 주문형 연결 기능을 사용해 설정 조건이 충족되면 VPN 연결을 시작합니다. 연결 시도를 시작하는 시점을 관리할 뿐, 서버 유효성이나 인증 정보의 정확성, 대상 웹사이트 접속 가능성을 보장하지는 않습니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 이 설정과 네트워크 조건도 함께 확인하세요.
Add Server
Add Server에서는 서버 항목을 직접 추가할 수 있으며, 입력 내용은 프로토콜에 따라 달라집니다. 주소, 포트, 인증 정보, 전송 매개변수를 기존 서버 정보와 하나씩 대조하세요. 이름만 보고 값을 추측해서는 안 됩니다. 저장한 뒤 목록으로 돌아가 항목을 선택하고 실제 요청으로 확인하세요.
Settings
Settings는 앱 설정을 확인하고 조정하는 메뉴입니다. 서버 매개변수를 저장하는 편집 화면과는 용도가 다릅니다. 문제를 확인할 때는 먼저 기존 값을 기록한 뒤 한 번에 하나씩 변경해야 어떤 설정이 영향을 주었는지 파악할 수 있습니다. 메뉴의 구성과 위치는 기기에 표시되는 화면을 기준으로 확인하세요.
Connectivity Test
Connectivity Test는 현재 조건에서 지정된 테스트 대상에 접속할 수 있는지 확인합니다. 테스트 방법과 대상 주소, 로컬 네트워크에 따라 결과가 달라지므로 한 번 성공했다고 모든 서비스가 정상이라고 볼 수는 없습니다. 문제가 발생하면 DNS, 요청 기록, 실제 웹페이지 접속 결과를 함께 비교하세요.
연결 매개변수를 이해하는 기본 용어
프로토콜
프로토콜은 클라이언트와 서버가 데이터를 주고받는 방식을 정합니다. 같은 프로토콜을 사용해도 매개변수까지 같다는 뜻은 아닙니다. 인증, 전송 방식, TLS 설정을 각각 확인하세요.
Shadowsocks
Shadowsocks는 프록시 프로토콜의 하나로, 일반적으로 서버 주소, 포트, 암호화 방식, 비밀번호가 필요합니다. 암호화 방식도 연결 매개변수이므로 비밀번호가 맞더라도 이를 확인해야 합니다. 직접 입력하거나 가져온 뒤 문자가 빠짐없이 입력되었는지 확인하고 기존 서버 정보와 대조하세요.
VMess
VMess는 인증 기능이 있는 프록시 프로토콜로, 사용자 식별 정보와 전송 방식은 서로 다른 매개변수 계층에 속합니다. 식별 정보를 입력한 뒤에도 포트, 전송 경로, TLS 등의 설정을 확인해야 합니다. 인증 실패와 전송 연결 실패는 비슷하게 나타날 수 있으므로 같은 항목을 반복해서 바꾸기보다 계층별로 점검하세요.
VLESS
VLESS는 프록시 프로토콜의 하나로, 일반적으로 사용자 식별 정보와 서버에 맞는 전송 매개변수가 필요합니다. 식별 정보는 연결을 구분하기 위한 것이며, 전송 암호화나 인증서 검증이 완료되었다는 뜻은 아닙니다. 기존 매개변수를 빠짐없이 사용하고 인증, 전송, 보안 설정을 각각 확인하세요.
Trojan
Trojan은 일반적으로 TLS와 함께 사용하며 비밀번호 등의 정보로 인증합니다. 서버 주소와 포트, TLS 이름, 인증서 검증이 모두 연결에 영향을 주므로 비밀번호가 맞더라도 다른 문제가 있을 수 있습니다. 인증서 오류가 발생하면 검증을 건너뛰지 말고 서버 이름과 인증서 설정을 확인하세요.
Hysteria2
Hysteria2는 QUIC 기반 프록시 프로토콜이며 UDP 통신을 사용합니다. 현재 네트워크에서 UDP가 제한되면 다른 유형의 연결이 정상이어도 Hysteria2 연결은 실패할 수 있습니다. 인증, TLS 및 기타 매개변수는 기존 설정에 맞춰 입력하세요. 프로토콜 이름만으로 속도나 안정성이 정해지지는 않습니다.
WireGuard
WireGuard는 키 쌍으로 암호화 터널을 구성합니다. 로컬 개인 키와 피어 공개 키는 역할이 달라 서로 바꿔 사용할 수 없습니다. Address는 터널 인터페이스 주소이며 서버의 공인 연결 주소가 아닙니다. DNS와 MTU도 각각 이름 확인과 데이터 전송에 영향을 줍니다. 개인 키는 민감한 정보로 안전하게 보관하세요. 자세한 내용은 WireGuard 매개변수 안내를 참고하세요.
HTTP / SOCKS5
HTTP와 SOCKS5는 서로 다른 프록시 프로토콜 유형이므로 기존 서버 정보에 맞게 선택해야 합니다. 주소와 포트가 같다는 이유로 서로 바꿔 사용할 수는 없습니다. 사용자 이름과 비밀번호가 필요한지, 전송 보호 기능이 있는지는 서버 설정과 연결 방식에 따라 달라집니다. 프로토콜 이름이 암호화를 보장하거나 모든 요청 유형을 지원한다는 뜻은 아닙니다.
매칭 조건 → 실행 동작
규칙 키워드
먼저 규칙의 매칭 대상을 확인한 다음 매칭 후 실행할 동작을 확인하세요. 아래 문법은 규칙 구조를 이해하기 위한 예시이며, 도메인을 그대로 설정에 적용하라는 뜻은 아닙니다.
Rule
Rule은 매칭 조건과 실행 동작으로 구성되며 요청 처리 경로를 결정합니다. Config 모드에서는 일반적으로 위에서 아래로 규칙을 확인하며, 먼저 일치한 규칙이 최종 결과에 영향을 줍니다. 따라서 구체적인 조건을 더 포괄적인 조건보다 앞에 두는 것이 일반적입니다. 수정한 뒤에는 규칙이 저장되었는지만 보지 말고 요청이 실제로 어떤 규칙에 매칭되었는지 확인하세요.
DOMAIN
DOMAIN은 전체 도메인을 기준으로 매칭합니다. 예를 들면 DOMAIN,example.com,DIRECT와 같습니다. 지정한 도메인에만 적용되며 관련된 이름이라는 이유로 모든 하위 도메인까지 자동으로 포함하지는 않습니다. 루트 도메인과 하위 도메인을 함께 처리하려면 DOMAIN-SUFFIX가 더 적합한지 먼저 확인하세요.
DOMAIN-SUFFIX
DOMAIN-SUFFIX는 도메인 접미사를 기준으로 매칭하며, 일반적으로 지정한 도메인과 그 하위 도메인을 포함합니다. 예를 들어 example.com을 대상으로 한 접미사 규칙은 루트 도메인과 하위 도메인에 적용될 수 있지만, 이 문자열이 포함된 모든 이름을 매칭하지는 않습니다. 한 페이지가 여러 도메인에 요청을 보낼 수 있으므로 루트 도메인이 매칭되더라도 모든 리소스가 같은 경로를 사용하는 것은 아닙니다.
DOMAIN-KEYWORD
DOMAIN-KEYWORD는 도메인에 지정한 키워드가 포함되어 있는지 확인합니다. 일반적으로 전체 도메인이나 접미사 규칙보다 매칭 범위가 넓습니다. 짧고 흔한 키워드는 원하지 않는 도메인까지 매칭할 수 있으므로 이 범위가 꼭 필요한 경우에만 사용하고, 요청 기록으로 오매칭 여부를 확인하세요.
GEOIP
GEOIP는 IP 지리 정보 데이터베이스의 소속 정보를 기준으로 매칭합니다. 예를 들면 GEOIP,CN,DIRECT와 같습니다. 데이터베이스상의 소속 정보가 서버의 정확한 물리적 위치나 접속 속도를 뜻하지는 않습니다. 도메인 요청을 처리할 때는 DNS 조회 결과와 주소 선택에 따라 실제 매칭 대상 IP가 달라질 수 있다는 점도 고려하세요.
IP-CIDR / IP-CIDR6
IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 대역을 매칭합니다. 주소 뒤의 슬래시와 프리픽스 길이는 적용 범위를 나타내며 포트 번호가 아닙니다. IPv4 규칙만 추가했다고 같은 서비스의 IPv6 주소까지 처리되는 것은 아니므로 실제 연결에 사용된 주소 유형도 확인하세요.
FINAL
FINAL은 앞선 규칙에 매칭되지 않은 요청을 처리하며 보통 마지막에 두어 기본 동작을 지정합니다. FINAL,PROXY와 FINAL,DIRECT는 나머지 트래픽을 다르게 처리하므로 앞쪽의 도메인 규칙만 확인해서는 안 됩니다. 기본 규칙을 앞으로 옮기면 뒤에 있는 세부 규칙이 매칭되지 않을 수 있습니다.
PROXY / DIRECT / REJECT
PROXY는 요청을 프록시 경로로 전달하고, DIRECT는 대상에 직접 연결하며, REJECT는 요청을 거부합니다. 규칙에서 사용하는 동작이므로 Global Routing의 전체 모드인 Proxy, Direct와 구분해야 합니다. PROXY 규칙에 매칭되어도 유효한 서버와 올바른 매개변수가 필요하며, 규칙 매칭 성공이 연결 성공을 의미하지는 않습니다.
항목 기록, 업데이트 및 저장
구독 및 구성
서버 구독은 연결 항목을 관리하고, 구성 파일은 규칙 등의 설정을 구성합니다. 가져오기, 동기화, 백업은 용도가 서로 다르므로 같은 기능처럼 사용하지 마세요.
Subscribe
Subscribe는 사용자가 보유한 구독 링크를 통해 서버 목록을 관리하며, 업데이트할 때 해당 링크에서 반환된 내용을 다시 불러옵니다. 구독 링크에는 인증 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요. 업데이트 후 항목이 바뀌었다면 구독에서 반환된 내용과 먼저 대조해야 합니다. 서버 목록을 업데이트해도 규칙 구성이 함께 갱신되는 것은 아닙니다.
SERVER
SERVER는 서버 연결 정보를 담은 항목이며, 한국어 안내에서는 서버 항목 또는 서버라고도 합니다. 표시 이름은 항목을 구분하기 위한 것으로, 실제 연결에는 주소, 포트, 프로토콜, 인증 정보 및 전송 매개변수가 사용됩니다. 이름이 같아도 매개변수가 같다는 뜻은 아니며, 이름을 바꿔도 서버의 네트워크 기능은 바뀌지 않습니다.
Config
Config는 구성 파일 관리 메뉴를 뜻할 수도 있고, Global Routing의 구성 모드를 가리킬 수도 있으므로 문맥에 따라 구분해야 합니다. 구성 파일은 규칙과 DNS 등의 설정을 관리하고, 서버 구독은 주로 서버 항목을 관리합니다. 파일을 가져온 것만으로 실제 적용되는 것은 아니므로 현재 구성과 전체 라우팅 방식도 확인하세요.
Scan QR Code
Scan QR Code는 카메라로 QR 코드의 인식 가능한 연결 정보를 읽는 기능이며, 처음 사용할 때 카메라 권한이 필요할 수 있습니다. QR 코드는 정보를 담는 수단일 뿐, 내용이 완전하거나 유효하다는 보장은 없습니다. 가져온 뒤 프로토콜, 주소, 인증 정보를 확인하고 연결 자격 증명이 포함된 QR 코드는 공개하지 마세요.
공유 링크
공유 링크는 프로토콜에 맞는 형식으로 연결 매개변수를 인코딩하며 서버 주소, 인증 정보, 전송 설정을 포함할 수 있습니다. 서버 하나를 공유하는 링크와 목록 전체를 갱신하는 구독 링크는 용도가 다르므로 텍스트 링크라는 이유로 같은 메뉴에서 처리해서는 안 됩니다. 클립보드에서 가져온 뒤 특수 문자와 각 항목이 빠짐없이 보존되었는지 확인하세요.
iCloud 동기화
iCloud 동기화는 앱이 지원하는 데이터를 기기 간에 동기화하며, 실제 범위는 앱 설정과 시스템 상태에 따라 달라집니다. 동기화가 전체 백업을 뜻하지는 않으므로 기기를 바꾼 뒤 서버, 현재 구성, 연결 설정을 하나씩 확인하세요. 직접 내보낸 파일에도 민감한 매개변수가 포함될 수 있습니다. 복원하기 전에 구성 백업 및 기기 변경 안내를 참고하세요.
DNS 조회, 핸드셰이크 및 데이터 전송
DNS 및 네트워크
요청은 여러 단계를 거칩니다. 도메인 조회, 서버 연결, 인증, 콘텐츠 전송을 구분해야 실제 장애 지점에 맞춰 문제를 확인할 수 있습니다.
DNS
DNS는 도메인을 IP 주소 등의 레코드로 변환하며, 웹사이트에 접속할 때 거치는 일반적인 첫 단계입니다. DNS 응답이 왔다고 대상에 접속할 수 있는 것은 아니며, 서버 지연 시간이 정상이어도 도메인 조회에 문제가 없다는 뜻은 아닙니다. 웹페이지가 열리지 않으면 먼저 DNS 조회 단계에서 실패했는지, 조회 후 연결이나 데이터 전송 단계에서 실패했는지 확인하세요.
지연 시간
지연 시간은 지정한 테스트에 걸린 시간을 뜻하며, 구체적인 의미는 테스트 방식과 대상에 따라 달라집니다. 지연 시간이 짧다고 다운로드 대역폭이 높은 것은 아니며, 다른 웹사이트나 앱도 같은 경로를 사용한다고 보장할 수 없습니다. 항목을 비교할 때는 테스트 조건을 동일하게 유지하고 실제 요청 결과도 함께 확인하세요.
TLS / SNI
TLS는 전송을 보호하고, SNI는 TLS 핸드셰이크 중 접속할 서버 이름을 전달합니다. 연결에 사용하는 주소와 서버 이름은 서로 다를 수 있으므로 기존 서버 설정에 맞춰 각각 입력해야 합니다. 인증서 검증 오류가 발생하면 이름, 인증서 체인, 기기 시간을 확인하세요. 오류를 무시하는 것만으로 연결이 올바른지 판단해서는 안 됩니다.
UDP
UDP는 데이터그램 전송 프로토콜로, 일부 터널 프로토콜과 실시간 통신, DNS 요청에 사용됩니다. UDP를 사용하는 연결은 로컬 네트워크와 서버, 관련 설정이 모두 지원해야 합니다. 웹페이지가 열린다고 UDP 경로도 정상인 것은 아니므로 문제가 발생한 서비스에 맞는 방법으로 테스트하세요.
MTU
MTU는 링크가 전송할 수 있는 최대 전송 단위의 크기를 뜻하며, 터널 캡슐화에는 추가 공간이 필요합니다. 값을 적절히 설정하지 않으면 연결은 되지만 일부 콘텐츠 전송에 문제가 생길 수 있습니다. 그렇더라도 이 현상만으로 원인을 단정할 수는 없습니다. 값을 변경할 때는 기존 값을 기록하고 현재 설정을 따르며 동일한 서비스로 다시 테스트하세요.