공식 매뉴얼 · 개념 빠른 참조

Shadowrocket 용어집

인터페이스, 프로토콜, 규칙 문법의 의미를 확인하세요. 먼저 ‘언제 연결할지’, ‘어디에 연결할지’, ‘트래픽을 어떻게 나눌지’를 구분한 다음 관련 설정을 조정하세요.

이 페이지에서는 영어 인터페이스 용어와 규칙 키워드를 그대로 표기합니다. 한국어 설명은 용도를 안내하며 클라이언트에 표시되는 원래 이름을 바꾸지 않습니다. 플랫폼에 따라 메뉴 위치가 다를 수 있습니다. 조작 방법은 설정 안내에서, 전체 문법은 규칙 참고에서 확인하세요.

Interface / Controls

인터페이스와 스위치

메뉴를 확인할 때는 연결을 관리하는 기능인지, 처리 방식을 바꾸는 기능인지, 진단 정보를 표시하는 기능인지 먼저 구분하세요. 이름이 비슷해도 설정의 역할은 다를 수 있습니다.

Home
서버 목록을 확인하고 연결 대상을 선택하거나 연결 스위치를 조작하는 화면입니다. 목록에 항목이 있다는 것은 매개변수가 저장되었다는 뜻일 뿐, 연결이 실행 중이라는 의미는 아닙니다. 문제를 확인할 때는 현재 선택된 서버, 연결 스위치 상태, Global Routing 방식을 각각 점검하세요. 한 가지 항목만 확인해서는 원인을 놓칠 수 있습니다.
Global Routing
전체 라우팅 방식을 제어하며, 일반적으로 Config(설정), Proxy(프록시), Direct(직접 연결)를 선택할 수 있습니다. Config는 현재 설정의 규칙을 적용하고, Proxy와 Direct는 각각 프록시 방식과 직접 연결 방식으로 처리합니다. 실제 동작에는 시스템과 앱의 필수 처리도 영향을 줄 수 있습니다. 인터페이스의 Proxy, Direct와 규칙 행의 대문자 PROXY, DIRECT는 서로 다른 단계의 설정입니다. 규칙 분기를 테스트할 때는 먼저 Config를 선택하세요.
On Demand
미리 설정한 네트워크 조건에 따라 연결을 시작하는 기능입니다. 예를 들어 지정한 네트워크에 연결되었을 때 연결을 시작하도록 설정할 수 있습니다. 이 기능은 ‘언제 연결할지’를 다루며 ‘특정 도메인에 어떤 정책을 적용할지’를 정하지는 않습니다. 사용 전에 수동 연결이 정상인지 확인하고 조건을 하나씩 설정하세요. 그렇지 않으면 자동 연결 동작 때문에 서버나 설정의 기존 문제가 가려질 수 있습니다.
Add Server
기존 서버 매개변수를 직접 입력하는 메뉴이며, Type에서 연결 프로토콜을 선택합니다. 서버 주소, 포트, 인증 정보, 전송 옵션은 서버 측 설정과 일치해야 합니다. 이름만 보고 프로토콜을 판단해서는 안 됩니다. 매개변수는 서비스 제공업체에서 확인하세요. 이미 가져올 정보가 준비되어 있다면 같은 항목을 다시 만들기보다 가져온 결과를 먼저 확인하세요.
Connectivity Test
선택한 테스트 방식으로 서버의 응답 여부를 확인하는 진단 도구입니다. 지연 시간은 일반적으로 테스트 과정에서 한 번 주고받는 데 걸린 시간이며, 사용 가능한 대역폭이나 모든 웹사이트의 접속 속도를 뜻하지는 않습니다. 결과를 비교할 때는 테스트 방식과 현재 네트워크를 동일하게 유지하세요. 테스트에 통과해도 실제 대상에 요청을 보내 DNS, 라우팅, 앱 계층 연결을 확인해야 합니다.
Data
업로드와 다운로드 등 트래픽 수치를 확인하는 화면입니다. 클라이언트에서 제공하는 보기를 통해 서버나 앱의 사용량을 살펴볼 수 있습니다. 수치는 특정 통계 범위를 반영하므로 서비스 제공업체의 청구 내역과 동일하다고 간주해서는 안 됩니다. 초기화 여부와 통계 기간도 비교에 영향을 줍니다. 규칙이 적용되었는지 확인하려면 요청 기록과 일치한 정책을 함께 살펴보세요. 총 트래픽이 늘었다는 사실만으로 규칙 적용을 단정할 수는 없습니다.
DNS
도메인 이름을 IP 주소로 변환하는 과정으로, 대부분의 도메인 연결에 앞서 수행됩니다. 변환에 성공해도 해당 주소의 서비스를 이용할 수 있다는 뜻은 아닙니다. 반대로 도메인 변환에 실패하면 정상적인 서버도 연결할 수 없는 것처럼 보일 수 있습니다. DNS를 변경하기 전에 기존 설정을 기록하고, 도메인 변환 오류와 연결 시간 초과, 인증서 오류를 구분하세요.
Protocols

프로토콜

프로토콜 이름은 연결 방식을 나타낼 뿐 연결 품질을 보장하지 않습니다. Type을 선택할 때는 기존 서버 정보를 기준으로 하세요. 같은 주소에 다른 프로토콜을 설정한다고 해서 연결 가능한 구성이 자동으로 만들어지는 것은 아닙니다.

Shadowsocks
지정한 암호화 방식과 비밀번호를 사용해 프록시 연결을 설정하는 프로토콜입니다. 주소, 포트, 암호화 방식, 비밀번호가 서로 맞아야 하며 서버 측에서 요구하는 추가 매개변수도 확인해야 합니다. 인증이나 핸드셰이크에 실패하면 입력값이 잘리지 않았는지, 불필요한 공백이 들어가지 않았는지 먼저 확인하세요. 규칙 정책을 바꾸는 것으로 프로토콜 매개변수 문제를 해결할 수는 없습니다.
VMess
사용자 식별자 등의 매개변수로 인증하는 프록시 프로토콜이며, 전송 및 TLS 설정이 별도로 필요할 수도 있습니다. 사용자 식별자를 입력한 뒤에도 전송 방식, 경로, 서버 이름 등의 관련 항목을 확인하세요. 포트 번호만으로는 설정을 판단할 수 없습니다. 문제를 확인할 때는 기기 시간이 정확한지도 점검하세요. 시간 오차가 인증에 영향을 줄 수 있습니다.
VLESS
사용자 인증과 전송 보안 설정을 별도로 다루는 프록시 프로토콜로, 사용자 식별자가 핵심 매개변수 중 하나입니다. 필요한 전송 방식과 보안 옵션은 서버 측 설정에 따라 달라지므로 다른 서버 항목의 값을 그대로 적용해서는 안 됩니다. 사용자 식별자가 올바른데도 연결되지 않으면 인증 정보만 반복해서 바꾸지 말고 TLS, 서버 이름, 전송 관련 항목도 확인하세요.
Trojan
일반적으로 TLS와 비밀번호 인증을 함께 사용해 연결하는 프록시 프로토콜입니다. 비밀번호, 서버 주소, 포트, 인증서 검증에 사용하는 서버 이름은 서버 측 요구사항에 맞아야 합니다. 인증서 오류와 비밀번호 오류는 서로 다른 단계에서 발생하므로 각각 확인하세요. 테스트를 통과시키기 위해 인증서 검증을 임의로 끄거나 서버 신원 확인을 무시해서는 안 됩니다.
HTTP
서버 유형에서 HTTP는 HTTP 프록시 서버에 연결하는 방식을 뜻하며, 대상 웹페이지가 HTTP만 사용한다는 의미는 아닙니다. 프록시가 지원하면 CONNECT로 대상과 연결할 수 있습니다. 사용자 이름과 비밀번호가 필요한지, 클라이언트와 프록시 사이에 TLS를 사용하는지는 서버 설정에 따라 달라집니다. 이는 대상 웹사이트가 사용하는 HTTP 또는 HTTPS와는 별개의 개념입니다.
SOCKS5
프록시 서버에 연결 요청을 전달하는 프로토콜입니다. 연결 대상은 도메인이나 주소로 지정할 수 있습니다. TCP, UDP, 인증 지원 여부는 클라이언트와 서버 양쪽의 지원을 함께 확인해야 합니다. 한 가지 테스트가 성공했다고 모든 유형의 트래픽이 작동한다고 단정할 수 없습니다. SOCKS5 자체는 암호화 터널이 아니므로 사용 시 하위 전송 환경도 고려해야 합니다.
WireGuard
키 쌍으로 암호화 터널을 구성하는 프로토콜입니다. 일반적으로 Endpoint, 양쪽 키, 터널 주소, 허용 주소 범위를 설정합니다. 비밀번호를 키 문자열로 바꾸는 것만으로 설정할 수 있는 일반적인 서버 항목이 아니며, 각 항목이 서로 맞아야 합니다. 개인 키는 민감한 인증 정보입니다. 진단 화면을 제출하거나 설정을 공유하기 전에 제거하고, 공개 키와 개인 키를 바꿔 입력하지 마세요.
Hysteria2
QUIC 기반 프록시 프로토콜로 UDP 전송을 사용하며 TLS와 관련 인증 매개변수가 필요합니다. 현재 네트워크에서 UDP가 제한되면 주소와 인증 정보가 올바르더라도 핸드셰이크 시간 초과가 발생할 수 있습니다. 먼저 네트워크 조건과 서버 연결 가능 여부를 확인한 다음 인증 및 기타 옵션을 점검하세요. 프로토콜 이름만으로 특정 속도를 보장할 수는 없습니다.
Rule Keywords

규칙 키워드

규칙 키워드는 ‘어떤 조건으로 매칭할지’를 정합니다. 아래 조각은 문법 예시일 뿐 전체 설정이 아닙니다. example.com과 하위 도메인은 매칭 범위를 설명하기 위한 예시입니다.

DOMAIN
도메인 하나를 정확히 매칭하며 하위 도메인까지 자동으로 포함하지는 않습니다. 예를 들어 DOMAIN,example.com,PROXY는 example.com에 일치하지만 api.example.com에는 일치하지 않습니다. 특정 호스트에 예외를 지정할 때 적합합니다. 도메인과 하위 도메인 전체를 포함하려면 DOMAIN-SUFFIX를 고려하고 예외 규칙의 순서도 확인하세요.
DOMAIN-SUFFIX
지정한 도메인 자체와 하위 도메인에 일치시킵니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 example.com과 api.example.com에 모두 적용됩니다. 도메인 계층의 경계를 기준으로 매칭하므로 임의의 문자열 끝부분을 비교하지 않으며 notexample.com에는 적용되지 않습니다. 특정 하위 도메인에 다른 정책을 적용하려면 더 구체적인 DOMAIN 규칙을 앞에 두세요.
DOMAIN-KEYWORD
도메인에 지정한 문자열이 포함되어 있는지 확인합니다. 예를 들어 DOMAIN-KEYWORD,ads,REJECT를 사용할 수 있습니다. 매칭 범위가 넓어 예상하지 않은 도메인까지 포함될 수 있으며, DOMAIN-SUFFIX처럼 도메인 계층 경계를 구분하지 않습니다. 추가한 뒤 실제 일치 기록을 확인하세요. 의도하지 않은 일치가 많다면 명확한 도메인이나 도메인 접미사를 사용하는 편이 좋습니다.
GEOIP
IP 지리 데이터베이스의 기록을 기준으로 대상 IP의 소속을 매칭합니다. 예를 들어 GEOIP,CN,DIRECT와 같이 설정할 수 있습니다. 웹 콘텐츠 유형나 운영 주체의 소재지를 판별하지 않으며, 데이터베이스 변경이나 대상 주소 변환 결과가 매칭에 영향을 줄 수도 있습니다. 사용 전에 관련 DNS 동작을 파악하고 지리적 소속만으로 대상을 판단하지 마세요.
IP-CIDR
IPv4 주소 범위를 매칭합니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT는 사설 주소 범위를 지정하는 데 사용할 수 있습니다. 슬래시 뒤의 숫자는 프리픽스 길이로 매칭 범위를 정하며 포트 번호가 아닙니다. 도메인 조회가 필요한지는 설정 옵션에도 영향을 받습니다. 로컬 네트워크 접속 문제를 확인할 때는 실제 서브넷, 대상 주소, 규칙 위치를 함께 점검하세요.
IP-CIDR6
IPv6 주소 범위를 매칭합니다. 예를 들어 IP-CIDR6,fc00::/7,DIRECT는 IPv6 고유 로컬 주소 범위를 나타냅니다. IPv4용 IP-CIDR 규칙은 IPv6 주소에 자동 적용되지 않으며, 하나의 도메인에서 두 종류의 주소가 모두 반환될 수도 있습니다. 요청마다 경로가 다르다면 도메인만으로 결과를 추측하지 말고 실제 연결 주소를 확인하세요.
USER-AGENT
확인 가능한 HTTP 요청의 User-Agent 정보를 기준으로 요청을 매칭합니다. 이 정보만으로 요청을 보낸 앱을 확실하게 식별할 수 있는 것은 아닙니다. 암호화된 연결에서는 해당 필드를 바로 확인할 수 없고, 앱이 값을 생략하거나 변경하거나 같은 값을 공유할 수도 있습니다. 이런 규칙을 사용하기 전에 요청 정보를 확인할 수 있는지 점검하세요. HTTPS 복호화가 필요한 경우에는 인증서와 개인정보 보호에 미치는 영향도 고려해야 합니다. 앱 이름만으로 판단 규칙을 작성해서는 안 됩니다.
FINAL
앞선 규칙에 하나도 일치하지 않을 때 적용하는 기본 규칙입니다. 예를 들어 FINAL,PROXY로 설정할 수 있습니다. 보통 Rule 섹션의 마지막에 두며 도메인이나 주소 조건을 추가하지 않습니다. FINAL을 앞에 두면 뒤에 있는 일반 규칙은 매칭되지 않습니다. 기본 정책을 선택할 때는 분류되지 않은 요청을 직접 연결할지, 프록시 경로로 보낼지 먼저 정하세요.
Policies / Order

정책과 매칭 순서

키워드는 매칭 조건을 정하고 정책은 일치한 요청의 처리 방식을 정합니다. 구체적인 조건이 자동으로 앞에 배치되지는 않으므로 규칙 작성 순서도 설정의 일부입니다.

PROXY
일치한 트래픽을 프록시 경로로 보내는 규칙 정책입니다. 실제 서버는 현재 선택 항목과 관련 설정에 따라 결정됩니다. 특정 프로토콜을 뜻하거나 특정 서버 주소를 고정해서 사용한다는 의미는 아닙니다. 규칙이 PROXY에 일치했는데 요청이 실패하면 매칭이 되지 않았다고 단정하지 말고 선택한 서버, 인증 매개변수, 대상 연결 상태를 확인하세요.
DIRECT
일치한 트래픽을 선택한 프록시 서버를 거치지 않고 대상에 직접 연결하는 규칙 정책입니다. 직접 연결도 현재 네트워크의 DNS, 시스템 라우팅, 대상 서비스 상태에 따라 달라지므로 DIRECT가 연결 성공을 보장하지는 않습니다. Global Routing의 Direct 방식과도 다릅니다. DIRECT 규칙 하나는 해당 규칙에 일치한 요청에만 적용됩니다.
REJECT
일치한 요청을 거부하는 규칙 정책입니다. 서버 항목을 삭제하거나 구독을 비우는 기능은 아닙니다. 범위가 지나치게 넓은 조건은 앱에 필요한 요청까지 차단해 일부 콘텐츠가 표시되지 않거나 기능이 작동하지 않는 원인이 될 수 있습니다. 이런 문제가 발생하면 먼저 일치 기록을 확인하고 조건 범위를 좁히거나 구체적인 예외를 조정하세요. 거부 규칙을 계속 추가하는 방식은 피해야 합니다.
매칭 순서
Rule의 일반 규칙은 위에서 아래로 확인합니다. 처음 일치한 규칙의 정책을 적용하며, 더 구체적으로 보이는 다음 규칙을 계속 찾지 않습니다. 일반적으로 구체적인 예외를 범위가 넓은 규칙보다 앞에 두고 FINAL은 마지막에 배치합니다. 수정 후에는 현재 설정이 활성화되어 있는지, Global Routing이 Config인지 확인한 다음 새 연결 요청의 매칭 결과를 확인하세요.
Subscribe / Config

구독과 설정 파일

서버 정보는 ‘어디에 연결할지’를, 규칙 설정은 ‘어떤 요청에 이 연결을 사용할지’를 정합니다. 서버 가져오기, 구독 업데이트, 설정 전환은 서로 다른 작업이므로 각각 확인해야 합니다.

Subscribe
구독 URL을 사용해 서버 정보 목록을 가져오고 업데이트하는 방식입니다. 구독 링크는 서비스 제공업체에서 받아야 합니다. 링크에 접속 인증 정보가 포함될 수 있으므로 스크린샷, 로그, 공유 설정에 공개하지 마세요. 구독을 업데이트하면 서버 목록이 바뀔 수 있지만 규칙 설정이 전환되는 것은 아닙니다. 이전에 선택한 서버가 목록에 남아 있다는 보장도 없으므로 업데이트 후 현재 선택 항목을 다시 확인하세요.
서버
클라이언트에 저장된 연결 항목으로, 일반적으로 프로토콜, 주소, 포트, 인증 매개변수가 포함됩니다. 흔히 노드라고도 부릅니다. 항목 이름은 식별을 위한 표시일 뿐 실제 위치, 프로토콜 기능, 연결 품질을 증명하지 않습니다. 서버는 직접 추가하거나 기존 구독에서 가져올 수 있습니다. 같은 정보를 중복으로 가져오면 관리가 번거로워질 뿐 연결이 개선되지는 않습니다.
Config
설정 파일을 관리하는 메뉴를 가리키거나, Global Routing에서 설정 규칙에 따라 트래픽을 처리하는 방식을 뜻할 수 있습니다. 어느 의미인지는 표시된 위치를 기준으로 판단하세요. 설정 파일에는 기본 동작, 매칭 조건, 정적 도메인 매핑 등을 정의하는 General, Rule, Host 등의 섹션이 포함될 수 있습니다. 파일을 저장했다고 해서 현재 사용 중이라는 뜻은 아닙니다. 수정 전에 사본을 보관하고 현재 활성화된 항목을 확인하세요.
URL Rewrite
조건에 따라 요청 URL을 바꾸거나 관련 재작성 동작을 실행하는 설정 섹션입니다. Rule에서 PROXY, DIRECT, REJECT를 선택하는 라우팅 규칙과는 다릅니다. 재작성은 요청 경로나 응답 처리 흐름을 바꿀 수 있지만 서버 인증 매개변수를 대신하지는 않습니다. HTTPS 요청을 처리할 때는 확인 가능한 정보와 관련 인증서 설정에도 제약이 있습니다. 적용 범위를 이해한 뒤 규칙을 하나씩 테스트하세요.

분류 목록으로 돌아가기 ↑