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

Shadowrocket
인터페이스·프로토콜·규칙 용어

먼저 용어가 표시된 위치를 확인한 다음, 연결 모드와 매칭 조건 중 무엇을 제어하는지 또는 서버 매개변수인지 구분하세요. 같은 단어라도 위치에 따라 뜻이 달라질 수 있습니다. 예를 들어 Config 페이지의 Config와 Global Routing의 Config 옵션은 서로 다릅니다.

지원 기기: iPhone / iPad / Mac / Windows / Android / Linux. 플랫폼마다 화면 구성이 다를 수 있으므로 현재 앱에서 메뉴 위치를 확인하세요. 이 페이지는 공통 개념을 설명하며 단계별 사용법을 대신하지 않습니다.

분류별로 보기 시작하기

설정 위치와 용도로 찾기

영문 명칭은 원문 그대로 표기합니다. 대문자 규칙 키워드와 첫 글자가 대문자인 화면 옵션을 각각 설명해 라우팅 모드와 규칙 정책을 혼동하지 않도록 했습니다.

화면 및 스위치

연결 전에 모드와 대상을 확인하세요

페이지 메뉴는 작업 위치를 정하고, 연결 모드는 트래픽 처리 방식을 결정합니다. 테스트 도구는 특정 시점의 확인 결과만 보여 줍니다.

Home: Home은 서버 항목과 구독 그룹을 확인하고 연결 대상을 선택하는 주요 화면입니다. 서버가 목록에 보인다는 것은 정보가 가져와졌다는 뜻일 뿐, 연결이 수립되었다는 뜻은 아닙니다. 연결을 시작하기 전에 선택한 대상과 Global Routing 모드가 의도한 대로인지 확인하세요.

Global Routing: Global Routing은 트래픽 처리 모드를 정하며, 주로 Config, Proxy, Direct를 선택할 수 있습니다. 규칙에 따라 트래픽을 분기하려면 Config를 선택하고 현재 설정을 확인하세요. 규칙이 적용되지 않는 문제를 살펴볼 때는 다른 모드에서 규칙을 반복해서 수정하기 전에 이 설정부터 확인하세요.

Config: Global Routing의 Config는 현재 설정에 있는 규칙에 따라 연결 방식을 정한다는 뜻입니다. 페이지 이름으로 쓰인 Config는 설정 파일을 관리하는 메뉴입니다. 서로 관련은 있지만 같은 작업 화면은 아닙니다. 설정 파일을 내려받는 것만으로는 충분하지 않습니다. 해당 파일을 선택했는지 확인하고 마지막 규칙과 정책 참조도 점검하세요.

Proxy / Direct: Proxy는 Global Routing의 프록시 모드이고 Direct는 직접 연결 모드입니다. 두 모드를 비교해 연결 경로를 확인할 수 있습니다. 화면의 옵션과 규칙에 쓰인 대문자 PROXY, DIRECT를 혼동하지 마세요. 임시 점검을 마친 뒤 규칙 분기가 필요했다면 Config로 되돌리고 대상 요청을 다시 확인하세요.

On Demand: On Demand는 시스템에서 지원하는 네트워크 조건에 따라 연결을 시작하는 설정입니다. 구독을 업데이트하거나 잘못된 서버 매개변수를 수정하지는 않습니다. 수동으로 연결을 껐는데 다시 연결된다면 이 설정과 시스템 VPN 설정을 확인하세요. 조건과 메뉴 위치는 플랫폼별 앱 화면을 기준으로 확인하면 됩니다.

Add Server: Add Server에서는 기존 서버 정보를 직접 입력합니다. 프로토콜, 서버 주소, 포트, 인증 및 전송 매개변수가 서로 맞아야 합니다. 주소만 입력했다고 설정이 완료되는 것은 아닙니다. 수정 전에 원래 매개변수를 보관하고, 특히 서버 주소와 TLS의 서버 이름을 구분하세요.

Connectivity Test: Connectivity Test는 항목의 연결 상태를 확인합니다. 결과는 테스트 방식과 대상, 현재 네트워크 상태에 따라 달라집니다. 테스트에 성공해도 모든 사이트나 앱에 접속할 수 있다는 뜻은 아니며, 모든 규칙의 매칭을 보장하지도 않습니다. 실제 요청과 진단 기록을 확인해 대상 연결이 어떻게 처리되는지 살펴보세요.

지연 시간: 지연 시간은 테스트 요청을 보낸 뒤 응답을 받을 때까지 걸리는 시간으로, 보통 밀리초로 표시합니다. 값이 낮다고 파일 다운로드가 빠른 것은 아닙니다. 처리량은 대역폭, 혼잡도, 원격 서버 부하에도 영향을 받습니다. 결과를 비교할 때는 같은 네트워크와 테스트 방식으로 비슷한 시간대에 측정하세요. 시간 초과가 발생하면 원인을 더 확인해야 합니다.

프록시 프로토콜

프로토콜, 전송 방식, 보안 계층을 따로 확인하세요

프로토콜 이름만으로 연결 매개변수 전체를 알 수는 없습니다. 아래에서는 기술적 용도만 설명하며, 실제 입력값은 본인이 이용하는 서버 설정을 기준으로 해야 합니다.

Shadowsocks: Shadowsocks는 프록시 프로토콜입니다. 연결하려면 일반적으로 서버 주소, 포트, 비밀번호, 암호화 방식이 필요합니다. 암호화 방식은 양쪽 설정이 일치해야 하므로 더 최신으로 보이는 옵션으로 임의 변경하지 마세요. 가져온 뒤 연결되지 않으면 먼저 기본 항목을 확인하고, 네트워크에서 원격 포트에 접근할 수 있는지도 점검하세요.

VMess: VMess는 UUID 등의 매개변수로 사용자를 식별하며 서버 측 설정과 일치해야 합니다. 프로토콜 외에도 원래 연결 정보에 따라 전송 방식, 경로, Host, TLS 설정이 필요할 수 있습니다. UUID가 맞아도 전송 설정이 다르면 연결되지 않을 수 있으므로 인증 항목만 확인하지 말고 각 항목을 대조하세요.

VLESS: VLESS는 UUID 등의 정보로 인증합니다. 프로토콜 자체는 페이로드를 암호화하지 않으므로 실제 배포 방식에 맞춰 보안 계층과 전송 방식을 확인해야 합니다. VMess 항목의 유형만 바꾸면 사용할 수 있는 대체 방식은 아닙니다. 추가할 때는 서버에서 제공한 매개변수를 모두 확인하고 이름만으로 TLS나 다른 항목을 추측하지 마세요.

Trojan: Trojan은 일반적으로 TLS와 비밀번호 인증을 함께 사용해 프록시 연결을 설정합니다. 서버 주소, 포트, 비밀번호, 서버 이름 등의 설정이 원격 서버와 일치해야 합니다. 인증서 검증 실패도 연결 중단의 원인이 될 수 있습니다. 문제를 확인할 때는 매개변수와 기기 시간을 먼저 점검하고, 인증서 검증을 끄는 방법을 기본 해결책으로 삼지 마세요.

Hysteria2: Hysteria2는 QUIC 기반 프록시 프로토콜이며, 사용 중인 네트워크에서 UDP 통신이 가능해야 합니다. 인증, TLS 및 기타 연결 매개변수는 서버 설정에 맞춰 입력하세요. 프로토콜 이름만으로 설정을 추측해서는 안 됩니다. 네트워크를 바꿨을 때 결과가 달라진다면 비밀번호를 반복해서 바꾸기보다 UDP 연결 가능 여부와 네트워크 제한을 확인하세요.

WireGuard: WireGuard는 키 쌍과 터널 매개변수로 연결을 설정하며, 일반적으로 피어 주소, 공개 키, 터널 주소가 필요합니다. 키는 일반 비밀번호와 다르고 공개 키와 개인 키의 용도도 서로 다릅니다. 가져오거나 백업할 때 개인 키를 안전하게 보관하고, 피어 주소뿐 아니라 주소 범위와 관련 라우팅 설정도 확인하세요.

HTTP / SOCKS5: HTTP와 SOCKS5는 연결 협상 방식과 인증 방식이 서로 다른 프록시 프로토콜입니다. 프로토콜 이름만으로 클라이언트와 프록시 서버 사이의 연결이 암호화된다고 볼 수는 없으므로 별도로 보안 설정을 확인해야 합니다. 대상 사이트의 HTTPS와 프록시 연결의 암호화 여부는 각각 따로 이해해야 합니다.

TLS: TLS는 연결 암호화와 인증을 위한 보안 계층이며 Global Routing 모드는 아닙니다. 연결 주소, 서버 이름, 인증서의 신원 정보가 각각 입력될 수 있지만 서버 구성과 일치해야 합니다. 핸드셰이크 오류가 발생하면 기기 시간, 이름, 인증서 매개변수를 확인한 뒤 네트워크 연결 문제인지 판단하세요.

규칙 키워드

조건을 먼저 매칭한 뒤 정책을 적용하세요

규칙은 보통 위에서 아래로 확인합니다. 범위가 넓은 규칙을 앞에 두면 뒤에 있는 구체적인 규칙이 적용되지 않을 수 있습니다.

규칙: 규칙은 일반적으로 매칭 유형, 매칭 값, 처리 정책으로 구성되어 요청의 연결 방식을 결정합니다. 보통 순서대로 확인하며 처음 일치하는 항목이 처리 결과를 정합니다. 문제를 살펴볼 때는 대상 도메인이 파일에 있는지만 검색하지 말고 규칙 내용과 순서, 현재 라우팅 모드도 함께 확인하세요.

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN은 도메인 완전 일치, DOMAIN-SUFFIX는 도메인 접미사 일치, DOMAIN-KEYWORD는 도메인 키워드 일치에 사용합니다. 접미사 규칙은 해당 도메인과 하위 도메인에 적용될 수 있으며 키워드 매칭 범위는 더 넓을 수 있습니다. 매칭 값에는 필요한 도메인이나 키워드만 입력하고 전체 웹페이지 경로를 도메인으로 넣지 마세요.

GEOIP: GEOIP는 대상 IP의 지역 데이터베이스 등록 정보를 기준으로 매칭합니다. 웹페이지 언어나 사용자의 현재 위치를 판단하는 기능은 아닙니다. 데이터베이스와 대상 주소가 달라지면 결과도 달라질 수 있으며, 도메인으로 접속할 때는 DNS 조회 결과도 고려해야 합니다. 특정 도메인에 고정된 처리가 필요하다면 더 앞에 정확한 도메인 규칙을 둘지 검토하세요.

IP-CIDR / IP-CIDR6: IP-CIDR은 IPv4 주소 대역, IP-CIDR6은 IPv6 주소 대역을 매칭합니다. 슬래시 뒤의 프리픽스 길이로 주소 범위를 지정합니다. 프리픽스 길이를 잘못 입력하면 범위가 커지거나 작아질 수 있으므로 일반 포트 번호처럼 생각해서는 안 됩니다. 듀얼 스택 연결을 확인할 때는 IPv4와 IPv6 규칙을 각각 점검하세요.

FINAL: FINAL은 앞선 규칙이 하나도 일치하지 않을 때 적용하는 최종 규칙으로, 보통 규칙 목록 맨 아래에 둡니다. PROXY로 처리하는 것처럼 적용할 정책도 지정해야 합니다. 의도한 대로 기본 처리가 되는지 확인하려면 앞선 규칙도 함께 살펴보세요. FINAL을 너무 앞에 두면 이후 규칙 매칭에 영향을 줍니다.

PROXY / DIRECT / REJECT: 대문자 키워드는 규칙이 일치했을 때 적용할 처리 정책을 나타냅니다. PROXY는 프록시로 처리, DIRECT는 직접 연결, REJECT는 연결 거부를 뜻합니다. 매칭 조건이나 프로토콜 이름을 나타내는 것은 아닙니다. 사용자 지정 정책 그룹을 사용한다면 그룹에서 실제로 선택된 대상도 확인하세요. 규칙 끝의 이름만으로 최종 연결 경로를 판단할 수는 없습니다.

DNS: DNS는 도메인을 IP 주소로 변환하며, 여러 연결을 시작하기 전에 거치는 과정입니다. DNS 조회 실패와 프록시 핸드셰이크 실패는 서로 다른 단계에서 발생합니다. DNS 조회 경로를 이후 앱 트래픽의 연결 경로와 동일하게 보아서도 안 됩니다. 일부 도메인에서 문제가 생기면 조회 결과, 캐시, 규칙 기록을 차례로 확인하세요.

URL Rewrite: URL Rewrite는 매칭 조건에 따라 요청 URL을 변경합니다. 예를 들어 조건에 맞는 주소를 다른 주소로 리디렉션할 수 있습니다. 프록시 또는 직접 연결을 선택하는 라우팅 규칙과는 역할이 다르며, 암호화된 요청 내용을 임의로 수정할 수 있다는 뜻도 아닙니다. 규칙에 따른 트래픽 분기만 필요하다면 출처를 알 수 없는 재작성 설정을 추가할 필요가 없습니다.

규칙 구조 예시: 왼쪽은 매칭 조건, 마지막은 처리 정책입니다. 아래 내용은 문법 예시일 뿐 모든 기기에 적용되는 완전한 설정이 아닙니다.

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

프록시 모드와 규칙 분기 안내 이어서 보기 ›

구독 및 설정

서버 목록과 로컬 설정 구분하기

구독은 서버 정보를 업데이트하고, 설정은 트래픽 처리 방식을 정합니다. 동기화, 구매 복원, 구독 업데이트는 각각 다른 데이터를 다룹니다.

구독 / Subscribe: 구독은 서버 정보를 가져오고 업데이트하는 메뉴이며, 주소는 본인이 이용하는 서비스 제공자에게 받아야 합니다. 계정 식별 정보가 포함될 수 있으므로 화면을 공개하거나 게시판에 붙여 넣지 마세요. 추가한 뒤 목록이 비어 있지 않은지, 항목이 예상한 내용인지 확인하세요. 구독이 완전한 규칙 설정을 대신하지는 않습니다.

서버 / SERVER: 서버 항목은 연결 매개변수의 모음으로, 보통 주소, 포트, 프로토콜, 인증 및 선택적 전송 설정을 포함합니다. 목록에 표시되는 이름은 구분을 위한 라벨일 뿐이며, 이름을 바꿔도 원격 주소나 연결 기능은 달라지지 않습니다. 직접 추가하거나 구독에서 가져와 항목을 만들 수 있지만 이후 관리와 업데이트 방식은 다를 수 있습니다.

설정 파일: 설정 파일에는 규칙, DNS, 정책 및 관련 설정을 저장할 수 있습니다. 주로 서버 목록을 제공하는 구독과는 용도가 다릅니다. 파일을 가져온 뒤 실제로 선택되어 있는지, 파일의 정책 이름이 사용할 수 있는 대상과 일치하는지 확인하세요. 설정을 교체하기 전에 현재 정상 작동하는 사본을 보관하면 문제가 생겼을 때 원래 설정으로 복구할 수 있습니다.

구독 업데이트: 구독 업데이트는 같은 주소를 다시 읽어 서비스 제공자의 최신 정보를 로컬에 동기화합니다. 구독 항목을 직접 수정해도 다음 업데이트에서 내용이 덮어써질 수 있으므로 수정 전에 독립 항목을 편집하는 것인지 구독 내용을 바꾸는 것인지 확인하세요. 업데이트에 실패하면 네트워크, 주소의 완전성, 서버 상태부터 확인하세요. 여러 그룹이 생기지 않도록 연속해서 다시 가져오지는 마세요.

Scan QR Code: Scan QR Code는 QR 코드에 담긴 연결 정보를 읽습니다. 코드에는 단일 서버나 다른 지원 콘텐츠가 포함될 수 있습니다. 인식에 성공했다는 것은 정보를 읽을 수 있다는 뜻일 뿐, 매개변수가 올바르거나 서버를 사용할 수 있다는 뜻은 아닙니다. 가져오기 전후에 유형과 항목을 확인하고 인증 정보가 포함된 QR 코드는 민감한 자료로 취급하세요.

iCloud 동기화: iCloud 동기화는 Apple 기기 간에 지원되는 데이터를 동기화하는 기능으로, 일반적으로 같은 Apple 계정과 관련 권한 설정이 필요합니다. 구독 새로 고침이나 App Store 구입 항목 기록을 대신하지 않습니다. 기기를 바꾸기 전에 구매 계정, 동기화 가능한 콘텐츠, 로컬 백업을 각각 확인하고 모든 연결 상태가 자동으로 복원된다고 가정하지 마세요.

스토어 및 계정

앱 다운로드와 연결 서비스를 구분하세요

이 분류의 스토어 용어는 주로 iPhone / iPad에 해당합니다. 다른 플랫폼의 Shadowrocket 다운로드 경로는 이 사이트의 다운로드 페이지에서 확인할 수 있습니다.

App Store 스토어프런트 및 계정 지역: App Store 스토어프런트는 구매에 사용하는 Apple 계정의 지역에 따라 앱 노출 여부, 표시 통화, 이용 가능한 구매 방식을 결정합니다. 기기 언어, 현재 위치, 프록시 출구 위치와는 별개이며 네트워크를 바꿔도 스토어프런트는 변경되지 않습니다. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 확인하세요. 앱을 찾을 수 없다면 먼저 스토어 지역과 제품 정보를 확인하세요.

정품 확인: iPhone / iPad에서는 App Store에서 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118를 확인하세요. 이름이 비슷해도 같은 제품이라는 뜻은 아니므로 세 가지 정보를 함께 대조해야 합니다. Mac, Windows, Android, Linux용 설치 파일은 이 사이트의 다운로드 페이지에서 /dl/shadowrocket/ 경로를 통해 받고, 시스템에서 실행을 허용하는 방법은 해당 페이지 안내를 따르세요.

일회성 구매: iPhone / iPad용 App Store 앱은 $2.99 일회성 결제이며, Mac / Windows / Android / Linux 버전은 무료입니다. 실제 결제 금액은 각 스토어 페이지에서 확인하세요. 앱 일회성 구매는 서버 회선 요금제가 아니며, 앱을 구매해도 사용할 서버나 구독이 자동으로 제공되지는 않습니다. iPhone과 iPad에서 구매를 복원하려면 원래 구매한 계정을 사용하세요. 연결 정보는 별도로 가져오거나 복원해야 합니다.

구입 항목: 구입 항목은 App Store에서 구매 계정과 연결된 앱 기록으로, 기기를 바꾸거나 다시 다운로드할 때 구매한 Shadowrocket을 찾는 데 사용할 수 있습니다. 이 기록은 앱 구매 내역이며 서버 목록, 구독 주소, 규칙 설정은 저장하지 않습니다. 기록을 찾을 수 없다면 먼저 원래 구매한 계정인지 확인한 다음 스토어 화면에서 구매 내역과 표시 설정을 살펴보세요.

스토어 지역, 구매 내역 또는 새 기기로 옮길 때 복원하는 방법은 App Store 안내에서 확인하세요. 기존 항목이 연결되지 않는다면 먼저 자주 묻는 질문을 참고해 가져오기, DNS 조회, 핸드셰이크, 규칙 매칭 중 어느 단계에서 문제가 발생했는지 구분하세요.

분류 목록으로 돌아가기 ↑