[Glossary]

Shadowrocket
용어 가이드

인터페이스, 프로토콜, 규칙 및 설정별로 용어를 살펴보세요. 먼저 설정 메뉴와 규칙 키워드를 구분한 뒤 개별 요청의 처리 방식을 확인합니다. 영문 명칭은 클라이언트와 설정 파일 표기를 따릅니다.

[Interface]

인터페이스 및 스위치

스위치가 연결 상태, 전체 트래픽 모드 또는 일회성 진단 중 무엇을 제어하는지 먼저 확인하세요. 연결이 켜져 있어도 모든 요청이 프록시 서버를 거치는 것은 아닙니다.

Global Routing

Routing Mode

전체 트래픽 처리 방식을 정하는 설정입니다. 모드는 Config, Proxy, Direct 세 가지입니다. Config는 현재 설정의 규칙에 따라 정책을 선택하고, Proxy는 트래픽을 프록시로 보내며, Direct는 직접 연결합니다. 트래픽 분기 결과를 확인할 때는 먼저 이 설정이 Config인지 확인하세요. 다른 모드에서는 Rule 섹션을 수정해도 기대한 결과가 나타나지 않을 수 있습니다.

On Demand

Connection

설정한 네트워크 조건에 따라 연결하거나 연결을 끊습니다. 즉, ‘언제 연결할지’를 정하는 기능입니다. Rule 섹션에서 정하는 ‘요청을 어떤 정책으로 처리할지’와는 별개이므로 도메인별 트래픽 분기를 대신할 수 없습니다. 수동으로 연결을 끊은 뒤 다시 자동 연결된다면 먼저 On Demand 조건을 확인하고 다른 연결 설정도 살펴보세요.

Add Server

Server Entry

기존 서버 정보를 직접 추가하는 메뉴입니다. 먼저 프로토콜을 선택한 다음 주소, 포트 및 해당 인증 정보를 입력하세요. TLS, SNI 및 전송 설정도 서버 측 정보와 일치해야 합니다. 주소와 포트만으로 입력이 완료되지는 않습니다. 단일 공유 링크를 가져온 뒤에도 해당 항목에서 각 설정을 확인할 수 있습니다.

Connectivity Test

Diagnostics

선택한 테스트 방식으로 서버가 응답하는지 확인합니다. 표시되는 지연 시간은 해당 테스트에서 측정한 결과입니다. 지연 시간은 다운로드 속도가 아니며 모든 대상 사이트의 접속 품질을 나타내지도 않습니다. 테스트 대상, 네트워크 환경 및 테스트 방식에 따라 결과가 달라질 수 있습니다. 문제가 있으면 실제 요청의 성공 여부와 적용된 정책도 함께 확인하세요.

DNS

Name Resolution

도메인 이름을 IP 주소로 변환하는 기능으로, 대상에 연결하기 전에 거치는 중요한 단계입니다. 도메인 변환에 성공했다고 해서 대상 연결까지 성공한 것은 아닙니다. 잘못된 변환 결과는 도메인 접속은 실패하지만 IP 주소로는 접속되는 현상으로 나타날 수 있습니다. DNS 설정을 바꾸기 전에 현재 설정과 네트워크 환경을 확인하세요. 캐시 때문에 기존 요청에는 새 설정이 즉시 적용되지 않을 수 있습니다.

[Protocol]

프로토콜

프로토콜은 클라이언트와 서버의 통신 방식을 정하며, 속도나 사용 가능성의 등급을 뜻하지 않습니다. 이미 보유한 서버에서 제공한 정보를 기준으로 설정하고, 연결을 시도하려고 프로토콜 유형을 임의로 바꾸지 마세요.

Shadowsocks

Protocol

프록시 프로토콜의 한 종류입니다. 일반적으로 서버 주소, 포트, 암호화 방식 및 비밀번호가 필요합니다. 암호화 방식과 비밀번호는 서버 설정과 일치해야 합니다. 주소가 맞더라도 인증 정보가 다르면 정상적으로 사용할 수 없습니다. 서버에서 추가 전송 설정을 요구한다면 제공된 정보를 따르세요. 다른 프로토콜의 항목을 그대로 적용하면 안 됩니다.

VMess

Protocol

사용자 식별 정보 등으로 인증하는 프록시 프로토콜입니다. 주소, 포트, UUID 및 전송 옵션을 함께 확인해야 하는 경우가 많습니다. WebSocket 등의 전송 방식을 사용한다면 Host와 Path도 연결 설정에 포함됩니다. 가져온 뒤에도 연결되지 않는다면 UUID만 반복해서 바꾸지 말고 서버 정보를 기준으로 TLS와 전송 계층을 확인하세요.

VLESS

Protocol

사용자 식별 정보를 사용하는 프록시 프로토콜입니다. 프로토콜 자체와 사용하는 전송 방식 및 보안 계층을 구분해서 이해해야 합니다. VLESS라는 이름만 보고 구체적인 암호화 방식을 단정하거나 VMess의 모든 설정을 그대로 적용해서는 안 됩니다. 서버에서 제공한 UUID, 전송 방식 및 보안 설정을 한 묶음으로 확인하고 서로 다른 항목의 설정을 섞지 마세요.

Trojan

Protocol

일반적으로 TLS와 함께 사용하며 비밀번호로 인증하는 프록시 프로토콜입니다. 비밀번호와 인증서 관련 설정 모두 연결에 영향을 줍니다. SNI는 TLS 핸드셰이크에서 사용하는 서버 이름으로, 실제 연결 주소와 다를 수 있으므로 서버 정보를 기준으로 입력하세요. 인증서 오류가 발생하면 이름, 기기 시간 및 인증서 상태를 먼저 확인하세요. Allow Insecure를 일반적인 해결 방법으로 사용해서는 안 됩니다.

Hysteria2

Protocol

QUIC 기반 프록시 프로토콜로, 연결하려면 적절한 UDP 네트워크 환경과 서버 지원이 필요합니다. 인증, TLS, 포트 및 난독화 등의 설정을 서버 측과 일치시켜야 하며 다른 프로토콜의 경험을 바탕으로 항목을 생략해서는 안 됩니다. 연결 테스트에 문제가 있으면 설정 오류인지 현재 네트워크의 UDP 처리 문제인지 구분하세요. 프로토콜 이름만으로 실제 속도가 보장되지는 않습니다.

WireGuard

Protocol

공개 키와 개인 키 등의 정보를 사용해 암호화 터널을 구성합니다. 설정에는 Endpoint, 주소 및 허용할 주소 범위도 포함됩니다. 개인 키는 민감한 정보이므로 공개 스크린샷, 게시물 또는 문의 내용에 노출하지 마세요. 터널 핸드셰이크가 성공해도 모든 대상 주소에 접속할 수 있는 것은 아닙니다. 라우팅 범위, DNS 및 서버 측 전달 설정도 확인해야 합니다.

공유 링크와 구독의 차이는 공유 링크 형식 안내에서 확인하세요.

[Rule]

규칙 키워드 및 정책

규칙은 일치 조건과 일치 후 적용할 정책으로 구성되며, 위에서부터 순서대로 확인합니다. 아래의 example.com은 설명용 도메인으로, 서버나 구독을 제공한다는 의미가 아닙니다.

[Rule]

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

이 예시는 지정한 도메인을 PROXY로 보내고, 로컬 네트워크 주소에는 DIRECT를 적용하며, 나머지 요청은 FINAL,DIRECT로 처리합니다. 사용하려면 이 규칙이 포함된 설정을 선택하고 Global Routing을 Config로 설정하세요.

PROXY DIRECT REJECT

DOMAIN

Rule Type

전체 도메인 이름과 일치시킵니다. 예를 들어 DOMAIN,example.com,PROXY는 해당 도메인에만 적용되며 모든 하위 도메인을 자동으로 포함하지 않습니다. 하나의 호스트 이름만 처리할 때 적합합니다. 입력할 때 URL의 경로나 프로토콜 접두사는 넣지 마세요. 같은 서비스가 여러 도메인에 분산되어 있다면 실제 요청에 사용되는 호스트 이름을 각각 확인해야 합니다.

DOMAIN-SUFFIX

Rule Type

지정한 도메인과 그 하위 도메인에 일치시킵니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 example.com과 api.example.com에 적용됩니다. 도메인 계층을 기준으로 일치시키며 임의의 문자열 포함 여부를 확인하는 방식은 아닙니다. 하위 도메인을 하나씩 입력하는 것보다 간편하지만 해당 도메인 전체에 같은 정책을 적용해도 되는지 확인하세요.

DOMAIN-KEYWORD

Rule Type

도메인에 지정한 키워드가 포함되어 있는지 확인합니다. 예를 들어 DOMAIN-KEYWORD,example,PROXY와 같이 사용합니다. 일치 범위가 DOMAIN 또는 DOMAIN-SUFFIX보다 넓어 의도하지 않은 다른 도메인까지 포함될 수 있습니다. 키워드 기반 처리가 꼭 필요한 경우에만 사용하고 실제 요청으로 잘못 일치하는 항목이 있는지 확인하세요.

GEOIP

Rule Type

IP 지리 데이터베이스의 분류 결과를 기준으로 일치시킵니다. 예를 들어 GEOIP,CN,DIRECT와 같이 사용할 수 있습니다. 데이터베이스 분류가 대상 사이트의 언어나 운영 기관을 뜻하는 것은 아니며, CDN이나 IP 주소 변경에 따라 결과가 달라질 수 있습니다. 앞선 도메인 규칙에 이미 일치한 요청은 이후 GEOIP 규칙에서 정책을 다시 선택하지 않습니다.

IP-CIDR / IP-CIDR6

Rule Type

IPv4 및 IPv6 주소 대역을 기준으로 각각 대상에 일치시킵니다. 슬래시 뒤의 숫자는 네트워크 접두사 길이입니다. 예시 IP-CIDR,192.168.0.0/16,DIRECT는 해당 사설 주소 범위에 적용됩니다. 도메인 문자열이 아닌 주소에 일치하므로, 도메인 요청을 처리할 때는 변환된 주소와 앞선 규칙에 이미 일치했는지도 고려해야 합니다.

USER-AGENT

Rule Type

인식 가능한 User-Agent 내용을 기준으로 일치시킵니다. 예를 들어 USER-AGENT,ExampleApp*,DIRECT와 같이 사용합니다. 앱 프로세스 식별 정보를 기준으로 트래픽을 나누는 방식은 아닙니다. 같은 앱의 요청도 서로 다른 식별 정보를 사용할 수 있고, 다른 프로그램이 같은 식별 정보를 사용할 수도 있습니다. 암호화된 요청에서는 관련 내용을 확인할 수 없을 수 있으므로 앱 트래픽 전체에 적용된다고 가정하지 마세요.

FINAL

Fallback

앞선 규칙에 하나도 일치하지 않은 요청에 기본 정책을 지정하며, 보통 Rule 섹션의 마지막 줄에 둡니다. FINAL,DIRECT는 나머지 요청을 직접 연결하고, FINAL,PROXY는 나머지 요청을 프록시로 보냅니다. 두 설정의 기본 동작은 서로 다릅니다. 특정 도메인이 ‘왜 프록시로 연결되는지’ 확인할 때는 해당 도메인에 일치한 규칙과 FINAL을 함께 살펴보세요.

PROXY

Policy

규칙의 정책 키워드로, 일치한 요청을 프록시 정책으로 처리한다는 뜻입니다. 특정 프로토콜 하나를 가리키지는 않습니다. 요청이 성공하려면 실제로 선택한 서버, 인증 정보 및 연결 상태도 정상이어야 합니다. Global Routing의 Proxy 모드와는 다릅니다. 전자는 개별 규칙의 처리 결과이고, 후자는 전체 트래픽 처리 방식입니다.

DIRECT

Policy

일치한 요청을 프록시 서버를 거치지 않고 대상에 직접 연결합니다. Config 모드에서도 DIRECT 규칙은 적용될 수 있으므로 연결 스위치가 켜져 있다고 해서 해당 요청이 프록시를 거치는 것은 아닙니다. 직접 연결 성공 여부는 로컬 네트워크, DNS 변환 및 대상 서비스 상태에 달려 있습니다. 정책 이름만으로 접속 가능성이 보장되지는 않습니다.

REJECT

Policy

일치한 요청을 거부해 연결을 차단합니다. 사용하기 전에 일치 범위를 명확히 설정하세요. 도메인 키워드나 주소 대역의 범위가 너무 넓으면 정상 기능에도 영향을 줄 수 있습니다. 페이지 일부가 표시되지 않는다면 먼저 요청이 REJECT에 일치했는지 확인하고, 전체 정책을 바꾸기보다 규칙 범위를 좁히세요.

일치 순서, 섹션 구성 및 추가 규칙 작성법은 Rule 규칙 참고 자료에서 확인하세요.

[Config]

구독 및 설정 파일

구독은 주로 서버 목록을 가져오고 업데이트하는 데 사용하며, 설정 파일은 규칙과 관련 설정을 구성합니다. 둘 다 링크 형태일 수 있지만 URL이라는 이유만으로 가져올 메뉴를 판단할 수는 없습니다.

Subscribe

Subscription

구독 URL을 통해 서버 목록을 가져오고 업데이트하는 메뉴입니다. 구독 정보는 서비스 제공업체에서 받으세요. 업데이트하면 출처에 따라 목록 내용이 바뀔 수 있으므로 항목을 직접 수정하기 전에 다음 업데이트에서 변경 내용이 덮어써질지 확인하세요. 구독 URL에 인증 정보가 포함될 수 있습니다. 문의할 때는 URL의 민감한 부분을 가리고, 바로 사용할 수 있는 링크를 공개하지 마세요.

SERVER

Connection Record

서버 연결 한 건을 나타내는 항목으로, 한국어 안내에서는 ‘노드’라고도 부릅니다. IP 주소 하나만으로 구성되는 것은 아닙니다. 프로토콜, 포트, 인증, 전송 및 TLS 설정을 함께 사용해야 하며 같은 주소에도 여러 설정을 구성할 수 있습니다. 단일 공유 링크를 가져오면 보통 항목 하나가 추가됩니다. 이후 서버 목록을 자동으로 업데이트하는 구독 기능이 생기는 것은 아닙니다.

Config

Configuration

설정 파일 또는 설정 파일 관리 메뉴를 뜻할 수 있습니다. 파일에는 General, Rule, Host, URL Rewrite 등의 섹션이 포함될 수 있으며 각 섹션의 역할은 다릅니다. 서버 목록이 있어도 트래픽 분기 규칙이 활성화된 것은 아닙니다. 대상 설정을 선택하고 Global Routing 모드도 확인하세요. 편집 전에는 원본 파일을 보관하고, 수정 후 섹션 헤더, 쉼표 및 규칙 순서를 확인하면 문제가 생겼을 때 복구하기 쉽습니다.

URL Rewrite

Configuration Section

조건에 맞는 요청 URL을 재작성하는 등의 처리를 합니다. Rule 섹션의 PROXY 또는 DIRECT와는 다릅니다. 요청 내용이 해당 기능으로 처리될 수 있는지와 일치 조건에 따라 규칙 적용 여부가 달라집니다. HTTPS 요청에는 추가적인 가시성 및 인증서 조건이 있으므로 재작성 규칙 하나로 모든 암호화 요청이 바뀐다고 볼 수 없습니다.

[Platform]

설치 및 플랫폼

Shadowrocket은 iPhone, iPad, Mac, Windows, Android 및 Linux에서 사용할 수 있습니다. 다운로드 경로와 설치 파일 형식은 기기에 따라 다르며, 자세한 내용은 다운로드 가이드에서 확인할 수 있습니다.

App Store

Distribution

iPhone / iPad에서는 App Store를 통해 Shadowrocket을 받을 수 있습니다. 시스템 요구 사항은 App Store 페이지 표기를 기준으로 확인하세요. 이름만으로 판단하지 말고 개발자 Shadow Launch Technology Limited, 공식 아이콘 및 앱 ID 932747118을 확인하세요. iPhone / iPad 버전은 $2.99 일회성 유료이며 Mac / Windows / Android / Linux 버전은 무료입니다. 나머지 네 플랫폼의 설치 파일은 이 사이트의 /dl/에서 받으세요.

Shadowrocket App Store 페이지 열기

Apple 실리콘 / Intel

Architecture

Mac 설치 파일을 선택할 때 확인해야 하는 칩 종류입니다. ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 해당 dmg 파일을 선택하세요. Apple 실리콘 버전과 Intel 버전은 서로 다른 제품이 아니며, 컴퓨터 구입 연도만으로 판단해서는 안 됩니다. Mac을 처음 열 때 ‘개발자를 확인할 수 없습니다’라는 메시지가 표시되면 출처를 확인한 뒤 ‘개인정보 보호 및 보안’에서 ‘그래도 열기’를 선택하세요.

Mac 칩 종류별 다운로드 보기

설치 허용

System Permission

이 사이트의 설치 파일 출처를 확인한 뒤 운영체제 안내에 따라 처음 실행하거나 설치를 허용하는 과정입니다. Windows SmartScreen에서는 파일 출처를 확인한 다음 ‘추가 정보 → 실행’을 선택할 수 있습니다. Android에서는 apk를 실제로 다운로드하고 여는 앱에 ‘알 수 없는 앱 설치 허용’ 권한을 부여해야 합니다. Mac의 ‘손상됨’ 경고와 Linux AppImage 실행 권한은 처리 방법이 다르므로 다른 플랫폼의 안내를 적용하지 마세요.

운영체제별 설치 허용 안내 보기

구입 항목

Purchase History

iPhone / iPad를 바꾸거나 앱을 다시 설치할 때는 기존 구입 계정으로 App Store의 구입 항목에서 Shadowrocket을 찾으세요. 메뉴 이름은 운영체제 버전에 따라 달라질 수 있습니다. 다시 구입 가격이 표시되면 결제를 반복하기 전에 현재 계정과 App Store 국가 또는 지역을 확인하세요. iPhone / iPad 버전은 $2.99 일회성 구매이며 Mac / Windows / Android / Linux 버전은 무료이므로, 해당 플랫폼은 설치 파일을 다시 받으면 됩니다.

재다운로드 및 구입 기록 안내 보기