OFFICIAL MANUAL / GLOSSARY

Shadowrocket 용어집

인터페이스와 스위치, 프로토콜, 규칙 키워드, 구독과 구성, 스토어 및 정품 관련 용어를 살펴봅니다.

용어를 찾아 뜻을 확인한 뒤, 표시된 위치를 기준으로 역할을 판단하세요. 인터페이스 용어와 규칙 키워드는 영어 원문으로 표기합니다. 각 카드의 주소창 앵커를 통해 해당 항목을 바로 가리킬 수 있습니다. 처음 설정한다면 사용 가이드를 먼저 읽어 보세요. 용어는 순서대로 읽지 않아도 됩니다.

01 / CONTROLS

인터페이스와 스위치

용어가 표시된 위치부터 확인하세요. 같은 Config라도 라우팅 모드와 파일 관리 페이지에서 맡는 역할이 다릅니다.

인터페이스와 스위치 / 라우팅 메뉴

Global Routing

전체 라우팅 모드를 선택하는 곳으로, 주로 Config, Proxy, Direct 세 가지 모드를 사용합니다. Config는 구성 파일의 규칙에 따라 요청을 처리하고, Proxy와 Direct는 전체 라우팅 방향을 지정합니다. 모드 선택과 연결 스위치 조작은 별개의 작업입니다. 모드를 선택한 뒤에는 기본 서버와 실제 연결 상태를 확인하세요.

Config의 의미 구분하기
인터페이스와 스위치 / 구성 모드

Config

Global Routing에 표시되는 Config는 현재 구성 파일에 따라 트래픽을 분기하는 모드이지, 모든 요청을 한 방향으로 고정하는 모드가 아닙니다. 페이지 이름에 쓰인 Config는 구성 파일을 관리하는 메뉴를 뜻합니다. 문제를 확인할 때는 Config 모드가 선택되어 있는지, 의도한 파일이 활성화되어 있는지, 파일 안의 규칙 순서가 올바른지 함께 점검하세요. 이름만 보고 분기가 적용되었다고 판단하면 안 됩니다.

인터페이스와 스위치 / 라우팅 모드

Proxy / Direct

첫 글자가 대문자인 이 두 인터페이스 용어는 각각 프록시 모드와 직접 연결 모드를 뜻하며, 라우팅 방식에 따른 접속 결과를 비교할 때 사용합니다. 규칙에서 대문자로 쓰는 PROXY, DIRECT와는 다른 계층의 설정입니다. Proxy로 바꿔도 비밀번호, 포트, TLS 설정이 자동으로 수정되지 않습니다. Direct에서 접속된다고 해서 규칙 파일에 문제가 있다는 뜻도 아닙니다.

인터페이스와 스위치 / 자동 연결

On Demand

네트워크 환경 등의 조건에 따라 연결을 시작하는 기능입니다. 예를 들어 특정 Wi-Fi에 따라 처리 방식을 다르게 지정할 수 있습니다. 이 기능은 연결 시점을 제어하며 서버 인증 정보를 바꾸지는 않습니다. 설정하기 전에 수동 연결이 가능한지 확인하고 조건을 하나씩 추가하세요. 여러 조건을 함께 설정했다면 적용 순서와 현재 네트워크가 예상한 조건에 해당하는지도 점검하세요.

인터페이스와 스위치 / 서버 정보 입력

Add Server

서버 항목을 추가하는 메뉴입니다. 먼저 프로토콜을 선택하고 주소, 포트, 해당 프로토콜의 인증 정보를 입력하세요. 입력할 값은 서비스 제공업체가 안내한 정보를 기준으로 하며, 프로토콜마다 필드의 의미가 다릅니다. 저장하면 항목만 추가됩니다. Home에서 기본 서버를 선택하고 연결 스위치를 켠 뒤 실제 연결이 되었는지 확인하세요.

인터페이스와 스위치 / 진단

Connectivity Test

연결 가능 여부와 응답 상태를 확인하는 기능으로, 처음 연결하거나 서버를 바꾼 뒤 실행하면 좋습니다. 지연 시간은 특정 테스트 조건에서의 응답을 나타낼 뿐 다운로드 속도와 같지 않으며, 모든 도메인이 예상대로 분기되는지도 보장하지 않습니다. 테스트가 실패하면 테스트 방식과 오류 내용을 기록한 뒤 서버 설정, 현재 네트워크, DNS를 각각 확인하세요.

02 / PROTOCOLS

프로토콜

프로토콜은 클라이언트와 서버가 데이터를 주고받는 방식을 정합니다. 프로토콜 이름이 같아도 인증, 전송 방식, TLS 등의 설정을 하나씩 맞춰야 합니다.

프로토콜 / 암호화 방식과 비밀번호

Shadowsocks

정해진 암호화 방식과 비밀번호로 프록시 트래픽을 전송하는 프로토콜입니다. 서버 주소와 포트뿐 아니라 암호화 방식도 서버 요구 사항과 일치해야 합니다. 다른 프로토콜의 인증 정보를 그대로 사용하지 마세요. 서비스 제공업체가 추가 설정을 안내했다면 모두 확인해야 합니다. 주소에 접속할 수 있어도 인증에 실패하면 요청을 정상적으로 전달할 수 없습니다.

프로토콜 / 인증과 전송

VMess

사용자 인증을 지원하는 프록시 프로토콜입니다. 설정에는 보통 UUID가 포함되며 전송 방식, 경로, TLS 관련 항목이 추가될 수 있습니다. UUID는 중요한 인증 정보지만 구성의 전부는 아닙니다. 가져온 뒤 연결되지 않는다면 서버 이름만 반복해서 바꾸지 말고 원본 안내와 전송 계층, 인증서 조건을 비교하세요.

프로토콜 / 설정 조합

VLESS

사용자 식별 정보로 인증하는 프록시 프로토콜입니다. 이름만으로 실제 연결의 전송 보안 구성을 알 수는 없습니다. UUID, 전송 방식, TLS, 서버가 요구하는 다른 옵션을 함께 확인하세요. 가져오기에 성공했다는 것은 텍스트가 항목으로 해석되었다는 뜻일 뿐, 설정이 호환되거나 현재 네트워크에서 서버에 연결할 수 있다는 의미는 아닙니다.

프로토콜 / TLS

Trojan

TLS를 통해 프록시 트래픽을 전달하며 일반적으로 비밀번호 인증을 사용합니다. SNI는 TLS 핸드셰이크에서 서버 이름을 표시하는 값으로, 연결 주소와 다를 수 있으니 서버 안내에 따라 입력하세요. 인증서 오류가 발생하면 도메인, 기기 시간, 인증서 조건을 먼저 확인하세요. Allow Insecure는 인증서 검증을 완화하므로 일반적인 해결 방법으로 사용하지 마세요.

프로토콜 / QUIC 및 UDP

Hysteria2

QUIC 기반 프록시 프로토콜로, 작동하려면 해당 UDP 통신이 가능해야 합니다. 인증 정보와 TLS 설정 외에도 네트워크가 관련 UDP 통신을 허용하는지 확인하세요. 일반 웹페이지에 직접 접속할 수 있어도 이 프로토콜의 연결이 된다는 뜻은 아닙니다. 지연 시간만으로 결론 내리지 말고 서버 주소와 포트, 현재 네트워크 환경을 함께 살펴보세요.

프로토콜 / Peer 및 주소 범위

WireGuard

공개 키와 개인 키, Peer 설정으로 터널을 만드는 프로토콜입니다. Private Key, 공개 키, Endpoint, 로컬 주소, Allowed IPs 등의 정보가 필요합니다. Private Key는 로컬의 민감한 정보이므로 진단 화면을 공유할 때 공개하지 마세요. Allowed IPs는 터널에 적용되는 IP 주소 범위를 지정하는 항목입니다. 도메인 분기 목록이 아니며 도메인 접미사로 대체할 수도 없습니다.

03 / MATCH → POLICY

규칙 키워드

일반적인 규칙은 매칭 유형, 매칭 값, 정책으로 구성됩니다. 먼저 무엇을 매칭하는지 파악한 다음, 일치한 요청을 어떻게 처리하는지 확인하세요.

규칙 키워드 / 전체 도메인

DOMAIN

전체 도메인을 기준으로 매칭합니다. 예를 들면 DOMAIN,example.com,DIRECT입니다. 모든 하위 도메인을 포함하는 것은 아니므로 하위 도메인까지 적용하려면 DOMAIN-SUFFIX가 필요한지 확인하세요. 도메인 항목에는 프로토콜 접두사, 포트, 웹 경로를 입력하지 않습니다. 전체 URL을 붙여 넣어도 페이지 경로별로 매칭되지는 않습니다.

규칙 키워드 / 도메인 접미사

DOMAIN-SUFFIX

도메인 접미사를 기준으로 대상 도메인과 하위 도메인을 매칭하며, 같은 도메인 체계에 정책을 적용할 때 적합합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY로 지정할 수 있습니다. 더 구체적인 예외 규칙은 보통 범위가 넓은 규칙보다 먼저 배치해야 합니다. 수정 후에는 웹페이지가 열리는지만 보지 말고 요청 기록에서 실제로 어떤 규칙이 적용되었는지 확인하세요.

규칙 키워드 / IP 지리 위치

GEOIP

IP 지리 위치 데이터베이스를 기준으로 요청의 대상 주소를 매칭합니다. 예를 들어 GEOIP,CN,DIRECT와 같이 사용합니다. 데이터베이스 기록은 웹사이트의 표시 언어, 운영 주체의 소재지, 방문자의 위치와 같지 않습니다. 특히 분산형 서비스를 사용하는 대상은 주의해야 합니다. 예상과 다르게 작동하면 사이트 이름만 보지 말고 실제 대상 IP, DNS 해석 결과, 데이터베이스 조건을 확인하세요.

규칙 키워드 / 주소 범위

IP-CIDR / IP-CIDR6

IPv4 및 IPv6 주소 범위를 각각 매칭하며, 슬래시 뒤의 프리픽스 길이가 적용 범위를 결정합니다. 192.168.0.0/16은 주소 네트워크 표기이며 서버 포트 정보가 아닙니다. IPv4 조건만 설정해도 IPv6에 자동으로 적용되지는 않습니다. 대상이 두 종류의 주소를 모두 제공한다면 실제 연결에 사용된 주소 유형을 각각 확인하세요.

규칙 키워드 / 최종 정책

FINAL

앞선 규칙에 일치하지 않은 요청에 적용할 정책을 지정하며, 보통 규칙 목록의 맨 끝에 둡니다. FINAL,DIRECT와 FINAL,PROXY의 차이는 나머지 트래픽의 라우팅 방향입니다. 규칙 사용 여부의 차이가 아닙니다. 많은 요청이 FINAL에 해당한다면 앞선 규칙의 매칭 필드와 순서, 실제 요청 도메인을 다시 확인하세요.

규칙 정책 / 프록시 처리

PROXY

대문자 PROXY는 규칙 정책으로, 일치한 요청을 프록시로 처리한다는 뜻이지 서버 프로토콜 이름이 아닙니다. 규칙이 일치하는 단계와 서버에 연결되는 단계는 다릅니다. 정책이 맞아도 서버 설정이나 네트워크에 문제가 있으면 연결에 실패할 수 있습니다. 문제를 확인할 때는 적용된 규칙, 선택된 서버, 연결 오류 정보를 함께 살펴보세요.

규칙 정책 / 직접 연결

DIRECT

프록시 서버를 거치지 않고 대상에 직접 연결한다는 뜻입니다. DIRECT를 사용해도 현재 네트워크, DNS, 대상 서비스의 제약은 그대로 적용되며 클라이언트 전체가 꺼지는 것도 아닙니다. 특정 도메인에 직접 연결할 수 없다면 먼저 실제로 해석된 주소와 로컬 네트워크 상태를 확인하고, 필요한 경우 해당 규칙을 조정하세요.

규칙 정책 / 요청 거부

REJECT

일치한 요청을 거부하며, 특정 대상에 대한 접근 제어에 사용할 수 있습니다. 조건 범위가 지나치게 넓으면 로그인, 리소스 로드 등 정상 기능에 영향을 줄 수 있으므로 먼저 해당 요청을 확인한 뒤 거부 규칙을 추가하세요. 일부 기능에 문제가 생기면 구성을 전부 삭제하기보다 REJECT가 적용된 기록부터 찾아보세요.

04 / SUBSCRIBE & CONFIG

구독과 구성

구독은 연결 정보를 업데이트하고, 구성 파일은 동작 방식을 관리합니다. 둘 중 하나를 가져왔다고 해서 다른 하나까지 준비된 것은 아닙니다.

구독과 구성 / 여러 항목 가져오기

Subscribe

구독 URL로 서버 항목을 가져오고 업데이트합니다. 구독은 서비스 제공업체에서 받으세요. URL에 계정 인증 정보가 포함될 수 있으므로 로그나 화면을 공유하기 전에 전체 주소를 가리세요. 업데이트 실패만으로 기존 서버가 모두 작동하지 않는다고 판단할 수는 없습니다. 구독 URL의 유효성, 업데이트 요청의 연결 여부, 기존 항목의 연결 상태를 따로 확인하세요.

구독과 구성 / 연결 항목

Server

서버 주소, 포트, 프로토콜, 인증 정보를 저장하는 연결 항목입니다. 한국어로는 노드라고도 합니다. 표시 이름은 항목을 구분하기 위한 라벨일 뿐, 연결 방식이나 실제 위치, 성능을 나타내지 않습니다. 항목 가져오기, 기본 서버로 선택, 연결 성립은 서로 다른 상태이므로 순서대로 확인하세요.

구독과 구성 / 동작 설정

Config 구성 파일

규칙, DNS 및 관련 동작 설정을 관리하는 파일로, 서버 구독과는 다릅니다. 구성을 바꾸기 전에 현재 파일을 보관하고 새 파일의 규칙 순서와 최종 정책을 확인하세요. 파일을 활성화한 뒤에는 Global Routing이 Config로 설정되어 있는지도 살펴보세요. 출처가 다른 내용을 구분 없이 계속 덮어쓰면 어떤 변경이 동작에 영향을 줬는지 파악하기 어렵습니다.

구독과 구성 / 도메인 해석

DNS

도메인을 IP 주소로 변환하는 기본 기능입니다. 해석 결과는 실제 연결 대상과 대상 IP를 기준으로 하는 규칙 판정에 영향을 줄 수 있습니다. 서버에는 연결되지만 특정 도메인이 열리지 않는다면 DNS도 별도로 확인해야 합니다. 설정을 바꾸기 전에 기존 값을 기록하고, 변경 후에는 같은 대상을 다시 테스트하세요. 여러 조건을 한 번에 바꾸면 결과를 비교하기 어렵습니다.

구독과 구성 / 요청 처리

URL Rewrite

조건에 따라 URL을 재작성하는 등의 기능으로, 서버 선택이나 도메인별 트래픽 분기와는 다릅니다. HTTPS에서는 암호화, 인증서, 앱 자체 동작에도 제약을 받으므로 모든 요청 내용을 바로 처리할 수 있다고 가정하지 마세요. 매칭 범위와 처리 결과를 정확히 알고 있을 때만 관련 항목을 수정하세요. 문제가 생기면 해당 항목을 잠시 비활성화해 결과를 비교할 수 있습니다.

05 / STORE & IDENTITY

스토어와 정품

Shadowrocket은 iPhone, iPad, Mac, Windows, Android, Linux를 지원합니다. 플랫폼별 다운로드 방법, 구매 기록, 클라이언트 구성은 각각 구분해서 확인하세요.

스토어와 정품 / 다운로드 방법

App Store

iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제이며, 현지 통화 금액은 스토어 표기를 따릅니다. Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료이며 이 사이트의 다운로드 페이지에서 받을 수 있습니다. iPhone / iPad 시스템 요구 사항은 App Store 페이지 표기를 기준으로 합니다. 스토어 국가 또는 지역에 따라 앱이 표시되지 않을 수 있으므로 검색 결과만으로 앱을 판단하지 마세요.

전체 플랫폼 다운로드 방법 보기
스토어와 정품 / 구매 기록

구입 항목

App Store에서 이전에 구입한 앱을 찾는 메뉴입니다. 기기를 바꾸거나 앱을 다시 설치할 때는 기존 구입 계정을 사용 중인지, 현재 스토어에서 이용할 수 있는지 먼저 확인하세요. 앱 다운로드 복원과 서버, 규칙 파일 복원은 별개입니다. 구매 기록은 구성 백업이 아닙니다. PC 및 Android 사용자는 다운로드 페이지에서 다시 받으면 되며 이 스토어 기록을 이용하지 않습니다.

구입 항목 복원 안내 읽기
스토어와 정품 / 앱 확인

정품 확인

iPhone / iPad 버전은 공식 아이콘, 개발자 Shadow Launch Technology Limited, 앱 ID 932747118을 모두 확인해야 합니다. 이름이 같다는 이유만으로 판단하지 마세요. Mac, Windows, Android, Linux 버전은 이 사이트의 다운로드 페이지에서 받을 수 있으며, 설치 파일은 사이트 내 /dl/shadowrocket/ 경로를 사용합니다. 처음 실행할 때 시스템 안내가 표시되면 다운로드 페이지에서 해당 플랫폼의 설치 허용 절차를 확인하세요.

설치 허용 안내 보기