공식 매뉴얼 / 용어 색인

Shadowrocket 용어집

인터페이스 위치와 구성 용도에 따라 용어를 찾아볼 수 있습니다. 영문 명칭은 앱의 표기를 유지하고, 설명에는 의미와 적용 범위, 혼동하기 쉬운 점을 담았습니다.

인터페이스 명칭 프로토콜 설정 규칙 문법 설정 항목 의미

이 사이트는 Shadowrocket 공식 웹사이트이자 공식 매뉴얼입니다. 이 페이지에서는 용어를 설명하며, 조작 절차를 대신하지 않습니다. 처음 설정한다면 사용 가이드를 먼저 확인하고, 설정을 항목별로 살펴보려면 설정 참고 자료를 확인하세요. 같은 용어라도 위치에 따라 의미가 다를 수 있습니다. 예를 들어 Config는 구성 파일 메뉴이자 Global Routing의 모드 중 하나를 뜻합니다.

Interface

인터페이스와 스위치

조작 메뉴와 전체 모드, 자동 연결 조건을 구분한 뒤 서버나 규칙을 확인하세요.

Home: 서버 목록을 확인하고 서버를 선택한 뒤 연결 스위치를 조작하는 주요 화면입니다. 목록에 항목이 보인다는 것은 정보가 저장되었다는 뜻일 뿐, 인증에 성공했거나 대상에 접속할 수 있다는 뜻은 아닙니다. 문제를 확인할 때는 선택된 항목, 연결 상태, Global Routing 모드를 각각 살펴보세요.

Global Routing: 트래픽을 전반적으로 어떻게 처리할지 선택하는 모드 메뉴입니다. 세 가지 모드는 Config, Proxy, Direct입니다. 모드를 바꾸면 연결 처리 방식이 달라지므로 스위치가 켜져 있다는 사실만으로 트래픽 경로를 판단할 수 없습니다. 이 메뉴는 개별 규칙의 PROXY·DIRECT 정책과 서로 다른 단계입니다.

Config: Global Routing에서 Config는 현재 구성 파일의 규칙에 따라 트래픽을 처리하는 모드입니다. 화면 이름으로는 구성 파일 관리 메뉴를 뜻합니다. 도메인별로 트래픽을 분기하려면 이 모드를 선택하는 것뿐 아니라 실제로 활성화된 파일과 규칙 내용도 확인해야 합니다.

Proxy: Global Routing의 프록시 모드로, 주요 트래픽을 프록시 경로로 처리합니다. 도메인별로 규칙을 적용하는 일상적인 분기와 같은 의미는 아닙니다. 이 모드를 선택해도 잘못된 주소나 인증 정보가 유효해지는 것은 아닙니다. 테스트할 때는 현재 서버를 사용할 수 있는지 확인하고 대상에 실제로 접속해 보세요.

Direct: Global Routing의 직접 연결 모드로, 주요 트래픽을 대상에 직접 연결합니다. 현재 네트워크에서의 접속 상태를 비교할 때 유용하지만, 모든 앱과 시스템 연결 동작을 검증하는 것은 아닙니다. 개별 규칙의 DIRECT는 해당 규칙에 매칭된 트래픽의 처리 방식만 결정합니다.

On Demand: 저장된 조건에 따라 VPN 연결을 시작하는 기능으로, 실제 동작은 조건과 시스템 상태, 설정에 따라 달라집니다. 연결을 언제 시도할지 관리하며 주소와 비밀번호, DNS 오류를 해결해 주지는 않습니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 이곳의 실행 조건도 확인하세요.

Add Server: 서버 정보를 직접 입력하는 메뉴입니다. 보유한 정보를 기준으로 유형과 주소, 포트, 인증 항목을 확인한 다음 전송 방식과 TLS 같은 추가 설정을 살펴보세요. 입력할 항목은 프로토콜에 따라 다르므로 모든 유형에 같은 매개변수 묶음을 적용해서는 안 됩니다.

Protocols

프로토콜

프로토콜 이름은 연결 방식을 식별하는 데 사용되며 서비스 품질을 판단하는 기준은 아닙니다. 설정은 사용자가 보유한 서버 정보를 따르세요.

Shadowsocks: 프록시 프로토콜의 하나로, 연결 설정에는 보통 서버 주소와 포트, 암호화 방식, 비밀번호가 포함됩니다. 암호화 방식은 서버 설정과 일치해야 하며 비밀번호가 같다는 이유로 확인을 생략해서는 안 됩니다. 추가 옵션이 제공된 경우에도 추측하지 말고 원래 정보를 기준으로 입력하세요.

VMess: 식별 정보 등의 매개변수로 인증하는 프록시 프로토콜입니다. 주소와 포트뿐 아니라 서버에서 요구하는 전송 방식과 TLS 관련 옵션도 확인해야 합니다. 가져오기에 성공했다는 것은 정보를 읽을 수 있다는 뜻이지, 모든 연결 매개변수가 검증되었다는 뜻은 아닙니다.

VLESS: 프록시 프로토콜의 하나로, 보통 식별 정보와 전송 방식, 보안 설정을 확인해야 합니다. 다른 프로토콜과 이름이 비슷해도 설정을 서로 바꿔 쓸 수는 없습니다. 기존 항목을 수정할 때는 Type만 바꾸고 이전 필드를 그대로 두지 말고 원래 정보를 전체적으로 대조하세요.

Trojan: 일반적으로 TLS와 함께 사용하는 프록시 프로토콜로, 주소와 포트, 비밀번호가 주요 매개변수입니다. 서버에서 요구하는 TLS 이름도 정확히 일치해야 하므로 연결 주소만 확인해서는 안 됩니다. 인증서 검증 오류가 발생하면 먼저 설정과 기기 시간을 확인하고 검증 요구사항을 바로 낮추지 마세요.

Hysteria2: QUIC 기반 프록시 프로토콜로, 연결 상태는 현재 네트워크의 UDP 처리 방식과 관련이 있습니다. 인증, TLS, 선택적 난독화 설정은 서버 정보를 기준으로 확인하세요. 이 프로토콜을 사용한다고 반드시 더 빨라지는 것은 아니며, 실제 결과는 네트워크와 서버 환경에 따라 달라집니다.

WireGuard: 키 기반 터널링 프로토콜로, 설정에는 로컬 주소와 키, 피어, 라우팅 범위가 포함됩니다. 서버 비밀번호 하나를 입력하는 방식과 다르므로 관련 항목을 묶어서 확인해야 합니다. 개인 키는 민감한 정보이므로 공개 스크린샷이나 문제 해결 자료에 포함하지 마세요.

HTTP / SOCKS5: 서로 다른 두 가지 프록시 프로토콜이므로 주소와 포트가 같다는 이유로 유형을 바꿔서는 안 됩니다. 서버에서 사용자 이름과 비밀번호 또는 특정 TLS 설정을 요구할 수 있으니 제공된 정보를 기준으로 입력하세요. 이 프로토콜은 프록시 연결 방식을 나타내며 브라우저 주소창의 웹 주소 프로토콜과는 다릅니다.

Matching & policies

규칙 키워드

먼저 매칭 조건을 확인하고 그다음 처리 정책을 살펴보세요. Config 모드에서는 현재 구성 파일과 규칙 순서를 함께 확인해야 합니다.

규칙: 매칭 조건과 처리 정책으로 이루어져 특정 연결의 경로를 결정하는 설정 항목입니다. 일반적인 트래픽 분기 규칙은 순서대로 적용되므로 앞쪽의 넓은 조건이 뒤쪽의 구체적인 항목에 영향을 줄 수 있습니다. 문제를 확인할 때는 규칙 자체와 순서, 마지막 기본 처리 정책을 함께 살펴보세요.

DOMAIN: 전체 도메인을 기준으로 매칭하는 규칙 키워드입니다. 예를 들어 example.com에만 처리 방식을 지정할 수 있습니다. 해당 도메인의 모든 하위 도메인에 자동으로 적용되는 것은 아닙니다. www.example.com 같은 주소도 포함하려면 항목을 명시적으로 추가하거나 DOMAIN-SUFFIX 사용을 고려하세요.

DOMAIN-SUFFIX: 도메인 접미사를 기준으로 매칭하며, 보통 지정한 도메인과 하위 도메인에 적용됩니다. 매개변수에는 도메인을 입력하고 웹 주소의 경로나 쿼리 매개변수는 포함하지 마세요. 단일 전체 도메인보다 범위가 넓으므로 추가한 뒤 관련 하위 도메인에 같은 정책을 적용해도 되는지 확인하세요.

DOMAIN-KEYWORD: 도메인에 지정한 키워드가 포함되어 있는지에 따라 매칭합니다. 웹페이지 본문에 해당 단어가 있는지를 뜻하지 않으며, 예상보다 넓은 범위에 적용될 수 있습니다. 특정 사이트만 처리하려면 DOMAIN 또는 DOMAIN-SUFFIX가 목적에 더 적합한지 먼저 확인하세요.

GEOIP: 웹페이지 언어가 아니라 IP 지리 위치 데이터베이스의 결과를 기준으로 매칭합니다. 결과는 대상 IP와 데이터베이스 내용, DNS 조회 결과에 따라 달라집니다. 분산형 서비스를 사용하는 사이트는 이름만으로 특정 GEOIP 조건에 매칭된다고 판단할 수 없습니다.

IP-CIDR / IP-CIDR6: IPv4 및 IPv6 주소 대역을 각각 매칭하며, 주소 뒤의 CIDR 접두사가 범위를 결정합니다. 접두사를 바꾸면 표기만 달라지는 것이 아니라 포함되는 주소 수가 달라집니다. 도메인 접속 문제를 확인할 때는 실제 DNS 조회 결과도 확인해 IPv6를 놓치지 마세요.

FINAL: 앞선 규칙에 매칭되지 않은 경우 적용되는 최종 처리 항목으로, 보통 규칙 맨 끝에 둡니다. 특정 도메인을 위한 조건이 아니라 나머지 연결에 기본 정책을 적용합니다. 개별 항목이 없는 대상이 예상과 다른 경로로 연결된다면 FINAL 값을 확인하세요.

PROXY / DIRECT / REJECT: 자주 사용하는 규칙 정책으로, 프록시 경로 사용, 직접 연결, 연결 거부를 각각 뜻합니다. 대문자 표기는 규칙 문법이므로 인터페이스 모드인 Proxy·Direct와 구분하세요. PROXY의 실제 출구는 구성에 설정된 프록시 선택 항목이나 정책 그룹에 따라서도 달라집니다.

규칙 예시 읽는 순서

아래 예시는 example.com과 그 하위 도메인에 PROXY를 적용하고, 나머지 연결은 FINAL에 따라 DIRECT로 처리합니다. 문법만 보여 주는 예시이며 완전한 구성 파일은 아닙니다. 실제 동작은 현재 모드와 다른 규칙, 프록시 설정에도 영향을 받습니다.

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

Subscription & configuration

구독과 구성

서버 정보는 연결할 대상을 결정하고 구성 파일은 트래픽 처리 방식을 결정하므로 각각 확인해야 합니다.

서버: 프로토콜과 주소, 포트, 인증 등의 매개변수를 저장하는 연결 항목으로, 노드라고도 합니다. 항목 이름은 구분을 위한 라벨일 뿐 실제 위치나 접속 가능 여부, 속도를 증명하지 않습니다. 연결에 실패하면 표시 이름만 보지 말고 항목과 서버 상태를 확인하세요.

구성 파일: 규칙과 DNS 등 동작 설정을 저장하는 파일로, 서버 구독과 용도가 다릅니다. 파일을 가져왔다고 해서 현재 사용 중인 파일이 되는 것은 아니므로 Config에서 선택 상태를 확인하세요. 전환 전에는 기존 파일을 보관해 차이가 생겼을 때 비교할 수 있도록 하세요.

Scan QR Code: 보유한 연결 정보를 QR 코드로 읽어오는 메뉴입니다. QR 코드는 정보를 담는 형식일 뿐입니다. 인식한 뒤 프로토콜 유형과 항목이 올바르게 입력되었는지 확인하고 연결을 시도하세요. 비밀번호나 기타 인증 정보가 포함된 QR 코드는 민감한 정보로 취급하고 공개하지 마세요.

Settings & diagnostics

Settings 항목

다음 용어는 설정과 테스트 결과를 이해하는 데 도움이 되며, 모든 항목을 변경해야 한다는 뜻은 아닙니다.

DNS: 도메인을 IP 주소로 변환하는 기능으로 연결 과정의 일부입니다. DNS 조회 성공과 프록시 서버 연결 성공은 별개의 문제이며, DNS를 바꿔도 트래픽 출구가 바뀌지는 않습니다. 문제를 확인할 때는 도메인 조회 여부와 결과 주소, 이후 연결 성공 여부를 각각 기록하세요.

Connectivity Test: 현재 조건에서 연결 가능 여부를 확인하는 테스트 메뉴입니다. 테스트에 성공해도 해당 테스트 경로에 응답이 있었다는 뜻일 뿐, 모든 사이트와 프로토콜, 트래픽 분기 규칙이 정상이라는 뜻은 아닙니다. 실제 접속 대상과 현재 모드, 로그를 함께 확인해 원인을 파악하세요.

Ping: 선택한 방법과 대상에 대한 응답 시간을 확인하는 테스트 관련 항목입니다. 이를 모두 ICMP 테스트로 이해해서는 안 됩니다. 방법과 대상, 네트워크 조건이 다르면 수치를 직접 비교할 수 없습니다. 지연 시간이 짧다고 전송 속도가 빠른 것은 아니며, 시간 초과도 테스트 방법을 함께 확인해야 합니다.

Log: 연결과 DNS 조회, 규칙 처리 등의 과정을 기록해 문제 해결을 돕습니다. 표시되는 항목은 로그 유형과 수준에 따라 달라집니다. 문제가 발생한 시간과 대조해 인증 실패, DNS 조회 실패, 연결 시간 초과를 구분하세요. 공유하기 전에 주소나 구독 인증 정보, 접속 기록이 포함되었는지 확인하세요.

iCloud 동기화: iCloud를 통해 조건을 충족하는 기기 사이에서 앱이 지원하는 데이터를 동기화하며, 범위는 실제 설정에 따라 달라집니다. 동기화는 별도 백업과 같지 않으며 App Store 구매 기록에도 영향을 주지 않습니다. 기기를 바꿀 때는 구매 계정과 동기화 상태, 현재 구성을 각각 확인해 혼동하지 않도록 하세요.