공식 매뉴얼 · 용어 찾아보기

Shadowrocket 용어집

glossary

인터페이스 이름부터 프로토콜 유형, 규칙 키워드까지 사용 단계별로 용어를 찾아볼 수 있습니다. 영어 표기는 앱에서 사용하는 그대로 두고, 한국어로 기능과 적용 범위, 혼동하기 쉬운 점을 설명합니다. 구체적인 위치와 사용 가능한 옵션은 현재 플랫폼의 앱 화면을 기준으로 확인하세요.

용어 33개 인터페이스 용어 ≠ 규칙 정책 각 항목의 앵커 링크 제공

인터페이스 및 스위치

interface · 06

먼저 어떤 설정을 변경하는지 확인하세요. 전역 모드 변경, 구성 파일 선택, 연결 스위치 켜기는 서로 다른 작업입니다.

Home
추가한 서버 항목을 확인하고 연결 대상을 선택하거나 연결 스위치를 점검하는 주요 작업 화면입니다. 항목을 선택해도 연결이 시작된 것은 아닙니다. 연결에 성공하더라도 모든 요청이 프록시를 사용하는 것은 아니며, 실제 경로는 Global Routing과 구성 규칙에 따라 달라집니다.
Global Routing
Config(구성), Proxy(프록시), Direct(직접 연결) 세 가지 모드가 있는 전역 라우팅 설정입니다. 먼저 전체 처리 방식을 정하고, 해당 설정에서 세부 경로를 결정합니다. 규칙을 바꿨는데 Config 모드로 전환하지 않았다면 실제 결과가 규칙 내용과 다를 수 있습니다. 규칙 동작을 확인할 때는 먼저 이 설정을 살펴보세요.
Config
Global Routing에서 Config는 구성 모드를 뜻하며, 현재 활성화된 구성 파일의 규칙에 따라 연결을 처리합니다. 화면 이름으로 쓰일 때 Config는 구성 파일을 관리하고 선택·편집하는 메뉴를 가리킵니다. 같은 단어라도 위치에 따라 의미가 다릅니다. 모드는 규칙 사용 여부를 결정하고, 화면은 규칙이 저장된 파일을 관리합니다.
Proxy / Direct
Global Routing에서 Proxy는 프록시 모드, Direct는 직접 연결 모드를 뜻합니다. 전체 라우팅 방식을 선택하는 설정이지, 개별 도메인에 적용하는 조건이 아닙니다. Proxy를 선택해도 잘못된 서버 매개변수가 수정되지는 않으며, Direct를 선택해도 기존 구독이 삭제되지 않습니다. 대문자로 시작하는 인터페이스 용어와 규칙 행의 대문자 PROXY, DIRECT는 서로 다른 계층의 설정입니다.
On Demand
설정한 조건에 따라 연결을 시작해 반복적인 수동 조작을 줄이는 온디맨드 기능입니다. 연결을 언제 시작할지 결정할 뿐, 특정 도메인에 어떤 규칙을 적용할지는 정하지 않습니다. 해당 경로는 라우팅 모드와 구성에 따라 결정됩니다. 연결 자동 복구나 네트워크 전환 후 동작을 확인할 때는 On Demand 조건과 시스템 VPN 설정을 함께 살펴보세요.
Add Server
서버 정보를 직접 추가하는 메뉴로, 서버 주소와 인증 매개변수를 이미 보유한 경우에 사용합니다. 먼저 올바른 프로토콜 유형을 선택한 다음 서비스 정보에 맞게 주소, 포트, 해당 유형에 필요한 항목을 입력하세요. 저장이 완료되어도 항목이 로컬에 기록된 것뿐이므로, 연결 대상을 선택한 뒤 실제 연결을 확인해야 합니다.

프로토콜

protocols · 07

프로토콜 유형은 사용자가 보유한 서버와 일치해야 합니다. 클라이언트에서 이름만 바꾼다고 서버가 다른 프로토콜을 지원하는 것은 아닙니다. 프로토콜 이름만으로 속도나 배터리 소모를 판단할 수도 없습니다.

Shadowsocks
사전 공유 암호와 이에 맞는 암호화 방식을 사용하는 프록시 프로토콜입니다. 주로 서버 주소, 포트, 암호, 암호화 방식을 확인해야 합니다. 암호화 방식은 서버와 일치해야 하며 이름이 비슷하다고 임의로 바꿔서는 안 됩니다. 서비스 정보에 추가 전송 매개변수가 있다면 주소와 암호뿐 아니라 해당 항목도 확인하세요.
VMess
사용자 인증과 프로토콜 수준의 암호화를 제공하는 프록시 프로토콜입니다. UUID는 흔히 사용하는 인증 필드입니다. 전송 방식, 경로, Host, TLS 설정은 각각 확인해야 하는 별도 매개변수이며 UUID를 입력했다고 나머지 설정까지 정해지는 것은 아닙니다. 일부 인증 방식은 기기 시간에 민감하므로 연결에 문제가 있으면 시스템 시간이 정확한지 확인하세요.
VLESS
인증과 전달 방식을 간소화한 프록시 프로토콜로, 일반적으로 UUID로 사용자를 식별합니다. 데이터 기밀성은 보통 외부 보안 전송 계층이 제공합니다. VLESS와 VMess는 필드와 처리 방식이 다르므로 같은 매개변수에서 유형만 바꿔 사용할 수 없습니다. 서비스 정보에 지정된 전송 및 보안 설정을 빠짐없이 입력하세요.
Trojan
일반적으로 TLS 및 암호 인증과 함께 사용하는 프록시 프로토콜입니다. 주소, 포트, 암호, 서버 이름을 서로 맞게 입력해야 합니다. 서버 주소와 TLS 검증 이름이 다를 수 있으므로 보유한 구성 정보를 기준으로 각각의 용도를 확인하세요. 인증서 검증에 실패하면 검증을 끄기보다 이름, 기기 시간, 서버 인증서를 먼저 확인하세요.
HTTP / SOCKS5
서로 다른 두 프록시 프로토콜입니다. HTTP 프록시는 보통 CONNECT로 터널을 만들고, SOCKS5는 연결 및 데이터그램 전달을 위한 협상 방식을 정의합니다. 사용자 이름과 암호, 도메인 해석 위치, UDP 지원 여부는 서버와 클라이언트 구현에 따라 달라집니다. 프로토콜 이름만으로 연결이 암호화되는 것은 아니므로 별도의 보안 전송이 적용되는지 확인해야 합니다.
WireGuard
UDP와 공개 키·개인 키 인증을 기반으로 하는 네트워크 터널 프로토콜입니다. 터널 주소, 피어 공개 키, 엔드포인트, 라우팅 범위를 설정해야 합니다. 호스트와 암호만 입력하는 프록시 항목과 달리 주소와 허용된 라우팅 범위도 연결 가능성에 영향을 줍니다. 개인 키는 민감 정보이므로 구성을 점검하거나 공유하기 전에 삭제하세요.
Hysteria2
QUIC 기반 프록시 프로토콜입니다. 현재 네트워크에서 해당 UDP 통신을 허용해야 하며 인증 및 TLS 매개변수도 올바르게 설정해야 합니다. 성능은 패킷 손실, 혼잡, 서버 성능, 대역폭 설정에 따라 달라지므로 항상 더 빠르다고 볼 수 없습니다. 다른 유형은 작동하는데 이 유형만 실패한다면 UDP 연결 가능 여부를 별도로 확인하세요.

매개변수의 의미와 선택 조건을 확인하려면 프로토콜 해설을 읽어보세요.

규칙 키워드

rule-set · 08

규칙은 보통 일치 유형, 일치 내용, 처리 정책으로 구성됩니다. 위에서 아래로 확인하며 처음 일치한 규칙이 적용되므로 순서도 구성의 일부입니다.

Rule
규칙은 도메인이나 IP 대역 등의 특성으로 연결을 구분하고 처리 정책을 지정하는 조건입니다. 더 구체적인 규칙을 앞에, 적용 범위가 넓은 규칙을 뒤에 배치해 앞의 조건이 먼저 적용되도록 하세요. 규칙은 연결 경로를 정할 뿐 서버 인증 정보를 수정하거나 사용할 수 없는 서버를 복구하지는 않습니다.
DOMAIN
지정한 도메인과 정확히 일치시키는 키워드입니다. 예를 들어 example.com에 일치해도 api.example.com은 자동으로 포함되지 않습니다. 특정 호스트 하나의 처리 방식만 변경할 때 적합합니다. 여러 하위 도메인에 적용하려면 정확히 일치하는 규칙을 반복해서 추가하기보다 DOMAIN-SUFFIX를 고려하세요.
DOMAIN-SUFFIX
지정한 도메인과 그 하위 도메인을 일치시킵니다. 예를 들어 example.com과 api.example.com을 같은 접미사 규칙으로 처리할 수 있습니다. 임의의 문자열 포함 여부가 아니라 도메인 계층을 기준으로 일치시킵니다. 서비스의 기본 사이트는 정상인데 일부 리소스만 문제가 있다면 리소스가 다른 도메인에서 제공되는지도 확인하세요.
DOMAIN-KEYWORD
도메인에 지정한 문자열이 포함되어 있는지 확인합니다. 정확한 도메인 일치나 접미사 규칙보다 넓은 범위에 적용될 수 있습니다. 짧거나 흔한 문자열은 관련 없는 도메인에도 일치할 수 있으므로 먼저 영향 범위를 확인하세요. 서비스의 전체 도메인을 알고 있다면 이후 문제를 찾기 쉽도록 범위가 더 명확한 조건을 우선 사용하세요.
IP-CIDR / IP-CIDR6
IPv4 및 IPv6 네트워크 대역에 따라 대상 주소를 각각 일치시킵니다. 슬래시 뒤의 숫자는 네트워크 프리픽스 길이입니다. 도메인 표기가 아니라 주소 범위를 판단하며, 도메인 연결은 IP 규칙을 확인하는 과정에서 해석된 주소가 사용될 수 있습니다. IPv4 규칙만 설정해도 IPv6 연결이 일치하는 것은 아닙니다.
GEOIP
IP 지리 데이터베이스의 지역 정보를 바탕으로 대상 주소를 일치시킵니다. 예를 들어 GEOIP,CN,DIRECT는 해당 지역으로 분류된 주소를 DIRECT로 처리한다는 뜻입니다. 데이터베이스 분류는 서버의 실제 위치를 실시간으로 측정한 결과가 아니며 서비스의 대상 언어나 사용자 지역을 의미하지도 않습니다. 예상과 다르게 처리되면 실제 대상 IP를 함께 확인하세요.
FINAL
앞선 조건에 일치하지 않은 연결을 처리하는 기본 규칙으로, 보통 목록의 마지막에 둡니다. FINAL,PROXY는 남은 연결을 PROXY로 보낸다는 뜻이지 앞선 DIRECT 규칙이 적용되지 않는다는 의미가 아닙니다. FINAL을 앞에 두면 뒤에 있는 구체적인 조건은 일반적으로 확인되지 않습니다.
PROXY / DIRECT / REJECT
규칙에 일치한 뒤 적용하는 대표적인 세 가지 정책으로, 프록시 사용, 직접 연결, 연결 거부를 뜻합니다. 처리 작업이지 일치 조건이나 서버 프로토콜이 아닙니다. PROXY가 실제로 어떤 연결 대상을 사용하는지는 현재 선택된 대상을 함께 확인해야 합니다. REJECT는 해당 요청에 의존하는 페이지 기능에 영향을 줄 수 있으므로 적용 범위를 확인한 뒤 추가하세요.

구독 및 구성

profiles · 06

다음 설명은 사용자가 자신의 구독 또는 서버 정보를 이미 보유하고 있다는 전제에서 작성했습니다. 서버 항목은 “어디에 연결할지”, 구성 파일은 “연결을 어떻게 처리할지”를 정하며, 구입 내역은 앱을 받는 절차와 관련됩니다.

Subscribe
서버 항목을 가져오고 업데이트하는 구독 유형입니다. 구독 주소는 사용자의 서비스 제공업체에서 받아야 합니다. 업데이트는 일반적으로 원격 콘텐츠를 다시 읽는 기능이며 계정 이용 기간을 연장하거나 사용 가능한 항목을 보장하지 않습니다. 구독 주소에는 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷, 게시글, 공유 진단 기록에 노출하지 마세요.
SERVER
서버 호스트 주소 입력란에는 보통 도메인이나 IP 주소를 입력합니다. 서버 항목은 흔히 노드라고도 합니다. 포트는 별도 입력란에 작성하며 전체 웹 주소나 구독 주소를 호스트 주소로 입력하면 안 됩니다. 보유한 서비스 정보를 항목별로 확인하고 붙여넣을 때 공백이나 줄바꿈이 들어가지 않았는지도 살펴보세요.
구성 파일
규칙, DNS 및 관련 처리 설정을 저장하는 파일입니다. 서버 목록을 제공하는 구독과는 역할이 다릅니다. 파일을 가져온 뒤 현재 어떤 파일이 활성화되어 있는지, Global Routing이 Config 모드인지 확인하세요. 구성을 바꾸면 많은 요청의 경로가 달라질 수 있으므로 작업 전에 기존 파일을 보관해 비교하거나 복원할 수 있도록 하세요.
Scan QR Code
QR 코드를 스캔해 가져올 내용을 읽는 메뉴입니다. QR 코드에는 단일 서버 정보나 구독 주소가 포함될 수 있습니다. 스캔은 내용을 읽어올 뿐 출처와 입력 항목을 확인해 주지는 않으므로 완료 후 프로토콜, 주소, 인증 매개변수를 살펴보세요. QR 코드 자체에 접근 인증 정보가 들어 있을 수 있으므로 저장하거나 전달할 때 민감 정보로 취급해야 합니다.
iCloud 동기화
앱에서 지원하는 범위 내에서 iCloud로 관련 데이터를 동기화하는 기능입니다. 실제 동기화 항목은 현재 앱 설정을 확인하세요. App Store 구입 내역, 시스템 VPN 권한, 현재 연결 상태와는 별개입니다. 기기를 바꾼 뒤 데이터가 동기화되었더라도 선택한 구성, 연결 대상, 필요한 시스템 권한을 다시 확인해야 합니다.
구입 항목
App Store에서 해당 Apple ID의 구입 내역을 확인하고 앱을 다시 다운로드하는 메뉴입니다. 기기를 바꿀 때는 기존에 구입한 계정으로 로그인했는지 먼저 확인하세요. iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제로 제공되며, Mac / Windows / Android / Linux 버전은 무료입니다. 구입 내역은 앱 구매를 증명할 뿐 서비스 제공업체의 회선 이용 권한은 포함하지 않습니다.

가져오기 절차는 사용법에서 확인하고, 구입 내역 문제는 기기 변경 및 구입 항목 복원을 살펴보세요.

네트워크 및 진단

diagnostics · 06

이름 해석, 전송, 보안 핸드셰이크, 앱 요청을 구분하면 문제 범위를 좁히는 데 도움이 됩니다. 한 번의 테스트 결과는 해당 조건에서의 상태만 보여줍니다.

DNS
도메인을 IP 주소로 변환하는 시스템으로, 많은 연결에서 설정 과정의 일부로 사용됩니다. 이름 해석에 성공해도 대상 포트에 연결할 수 있다는 뜻은 아니며, 연결 실패가 반드시 DNS 문제인 것도 아닙니다. 라우팅, 핸드셰이크, 서비스 상태도 확인하세요. DNS를 변경하면 캐시의 영향을 받을 수 있으므로 결과를 비교할 때는 다른 조건을 가능한 한 동일하게 유지하세요.
Connectivity Test
현재 네트워크 조건에서 서버나 지정한 테스트 대상에 연결할 수 있는지 확인하는 연결 테스트 도구입니다. 테스트에 성공해도 모든 웹사이트와 프로토콜, 지속적인 데이터 전송이 정상이라는 뜻은 아닙니다. 실패 역시 테스트 대상에만 해당할 수 있습니다. 문제를 확인할 때 사용한 테스트 방법을 기록하고 실제 문제가 발생한 앱 요청과 비교해 보세요.
지연 시간 / 처리량
지연 시간은 응답까지 기다리는 시간이고, 처리량은 단위 시간에 전송할 수 있는 데이터의 양입니다. 서로 대체할 수 없습니다. 지연 시간이 짧으면 상호작용이 원활할 수 있지만 대용량 파일 전송이 더 빠르다고 보장하지는 않습니다. 지속 속도에는 대역폭, 패킷 손실, 혼잡도 영향을 줍니다. 비교할 때는 같은 로컬 네트워크, 대상, 테스트 방법을 사용하세요.
TLS / SNI
TLS는 인증 및 전송 보호를 위한 보안 프로토콜이며, SNI는 핸드셰이크에서 대상 서버 이름을 알리는 확장입니다. SNI, 서버 연결 주소, 인증서의 이름은 서로 관련되지만 항상 같은 값으로 입력하는 것은 아닙니다. 핸드셰이크 오류가 발생하면 포트만 반복해서 바꾸기보다 서비스 정보에 따라 이름, 인증서 유효성, 기기 시간을 확인하세요.
TCP / UDP
전송 계층에서 사용하는 두 프로토콜입니다. TCP는 신뢰성 있고 순서가 보장되는 바이트 스트림을 제공하며, UDP는 데이터그램을 전송하지만 도착이나 순서를 자체적으로 보장하지 않습니다. 애플리케이션은 UDP 위에서 신뢰성 있는 전송을 구현할 수 있으므로 UDP를 단순히 불안정하다고 볼 수는 없습니다. 특정 네트워크에서 TCP 테스트가 성공해도 UDP 기반 프로토콜을 사용할 수 있다고 단정할 수 없습니다.
URL Rewrite
일치 조건에 따라 요청 URL을 바꾸거나 해당 URL로 리디렉션하는 기능입니다. 연결 경로를 정하는 라우팅 규칙과는 다른 계층입니다. 적용 여부는 규칙 유형, 처리 가능한 요청인지, 관련 설정이 무엇인지에 따라 달라지며 모든 암호화된 요청을 직접 수정할 수 있는 것은 아닙니다. 예상치 못한 이동이 발생하면 관련 변경 규칙을 잠시 비활성화해 비교한 뒤 하나씩 원인을 확인하세요.

용어를 확인한 뒤 이어서 볼 항목

next

보유한 서비스 정보를 앱에 추가하려면 사용법부터 확인하세요. 프로토콜 입력 항목은 프로토콜 해설에서, 구체적인 오류 메시지는 자주 묻는 질문에서 확인할 수 있습니다.

용어 분류로 돌아가기 ↑