공식 매뉴얼 / 용어 설명

Shadowrocket 용어 설명

먼저 설정이 속한 단계를 확인한 뒤 매개변수와 규칙을 점검하세요. 인터페이스 용어, 프로토콜 이름 및 규칙 키워드는 영어 원문을 유지하고, 한국어 설명에서는 각 항목의 기능과 그 의미만으로 단정할 수 없는 내용을 안내합니다.

구체적인 조작 순서는 시작 가이드에서 확인하고, 기기에 맞는 앱을 받으려면 전체 플랫폼 다운로드 페이지를 이용하세요. 이 페이지는 노드나 구독을 제공·판매·추천하지 않습니다.

01 / 인터페이스와 스위치

연결 상태와 트래픽 처리 방식

목록, 스위치, 라우팅 방식은 각각 역할이 다릅니다. 항목이 표시되는 것, 항목을 선택하는 것, 연결을 설정하는 것은 서로 다른 상태입니다.

인터페이스와 스위치

Home

Home에서는 저장된 서버 항목과 연결 관련 상태를 확인할 수 있으며, 보통 선택한 항목을 점검할 때도 이 화면을 사용합니다. 목록에 항목이 있다는 것은 정보가 저장되었다는 뜻일 뿐, 서버에 연결할 수 있다는 뜻은 아닙니다. 문제를 확인할 때는 현재 선택 항목과 연결 스위치, 실제 요청 결과도 살펴보세요.

인터페이스와 스위치

Global Routing

Global Routing은 전체 트래픽 처리 방식을 정합니다. 설정은 Config, 프록시는 Proxy, 직접 연결은 Direct에 해당합니다. Config는 현재 설정된 규칙에 따라 연결을 처리하고, Proxy와 Direct는 각각의 전체 처리 방식을 사용합니다. 이는 개별 규칙 끝에 지정하는 PROXY, DIRECT 동작과 다른 단계이므로 트래픽 분할 문제를 점검하기 전에 먼저 이 설정을 확인하세요.

인터페이스와 스위치

On Demand

On Demand는 기존 조건에 따라 시스템에 연결을 요청하는 기능이며, 모든 연결 문제를 계속 감지하고 해결해 주는 기능은 아닙니다. 서버 비밀번호, 포트 또는 전송 설정이 잘못되어도 수정되지 않습니다. 설정을 바꾸기 전에 수동 연결이 가능한지 확인한 다음 조건과 시스템 권한을 점검하세요.

인터페이스와 스위치

Add Server

Add Server는 서버 항목을 수동으로 추가하는 메뉴입니다. 사용자가 보유한 서버 정보를 항목별로 입력하세요. 먼저 올바른 프로토콜 유형을 선택한 뒤 주소, 포트, 인증 및 전송 설정을 확인합니다. 이름이 비슷하다는 이유만으로 한 유형의 값을 다른 유형에 적용해서는 안 됩니다.

인터페이스와 스위치

Connectivity Test

Connectivity Test는 현재 지정된 테스트 대상과 방식으로 연결할 수 있는지 확인합니다. 결과는 로컬 네트워크, 서버 응답 및 대상 상태에 따라 달라집니다. 표시되는 시간은 파일 다운로드 속도가 아니며, 테스트에 성공해도 모든 앱 요청이 성공하는 것은 아닙니다. 실제로 실패한 대상을 기준으로 다시 확인하세요.

인터페이스와 스위치

DNS

DNS는 도메인 이름을 IP 주소로 변환하며, 조회 결과는 이후 연결과 일부 주소 규칙의 판단에 영향을 줍니다. 도메인에 접속할 수 없는 원인은 DNS 조회 단계일 수도 있고 연결 단계일 수도 있습니다. DNS를 변경하기 전에 두 경우를 구분하고, 여러 설정을 동시에 바꾸지 않아야 결과를 비교하기 쉽습니다.

02 / 프로토콜

유형, 인증 및 전송

프로토콜 이름은 연결 방식의 일부만 설명합니다. 사용자가 보유한 정보로 전체 매개변수를 확인하고, 프로토콜 이름만으로 속도나 사용 가능 여부를 판단하지 마세요.

프로토콜

Shadowsocks

Shadowsocks는 프록시 프로토콜의 한 종류로, 기본 정보는 서버 주소, 포트, 암호화 방식 및 비밀번호입니다. 클라이언트 설정은 서버 측 설정과 일치해야 합니다. 주소와 포트가 같아도 암호화 방식이 다르면 통신할 수 있으므로 항목 이름만 보고 설정이 올바르다고 판단하지 마세요.

프로토콜

VMess

VMess는 식별자와 관련 인증 정보를 사용하며, 실제 연결에는 다양한 전송 방식과 TLS 설정이 함께 적용될 수 있습니다. 식별자, 전송 경로, 서버 이름 등을 나누어 확인하세요. 시스템 시간이 크게 어긋나도 인증에 영향을 줄 수 있으므로 포트만 계속 바꾸지 마세요.

프로토콜

VLESS

VLESS는 인증과 전송 계층 설정을 별도로 다루므로 식별자와 함께 사용하는 전송 매개변수를 모두 확인해야 합니다. 프로토콜 이름만으로 데이터가 암호화된다고 볼 수 없으며, 실제 보안 방식은 함께 사용하는 보안 설정에 따라 달라집니다. 가져온 뒤 보안 옵션을 이름이 비슷한 값으로 임의 변경하지 마세요.

프로토콜

Trojan

Trojan은 일반적으로 TLS와 함께 사용하며 인증 비밀번호, 포트 및 서버 이름이 연결 결과에 영향을 줄 수 있습니다. 인증서 검증에 실패하면 검증을 끄는 것을 상시 대책으로 삼지 말고 기기 시간, 서버 이름 및 인증서가 일치하는지 확인하세요. 매개변수는 사용자가 보유한 서버 정보를 기준으로 입력해야 합니다.

프로토콜

Hysteria2

Hysteria2는 QUIC 기반이며, 연결에 필요한 UDP 통신 조건과 인증 및 TLS 설정을 확인해야 합니다. 일반 웹페이지가 열린다고 해서 같은 네트워크에서 필요한 UDP 통신도 허용된다는 뜻은 아닙니다. 문제를 점검할 때 로컬 네트워크, 서버의 수신 설정 및 구성 내용을 각각 확인하고 프로토콜 이름만으로 전송 성능을 예측하지 마세요.

프로토콜

WireGuard

WireGuard는 공개 키와 개인 키로 상대를 식별하는 터널 프로토콜입니다. 키, 피어 주소, 터널 주소 및 라우팅 범위가 서로 일치해야 합니다. 핸드셰이크가 완료되는지와 대상 주소에 도달할 수 있는지는 별도로 확인해야 합니다. 개인 키는 민감 정보이므로 공개된 문제 해결 자료에서 삭제하고 전체 설정을 그대로 공유하지 마세요.

프로토콜

HTTP

서버 유형으로 HTTP를 선택하면 HTTP 프록시를 뜻합니다. 대상 웹페이지 주소를 서버 주소 입력란에 넣는 것이 아닙니다. 사용자 이름, 비밀번호 및 TLS 필요 여부는 프록시 설정에 따라 달라집니다. 대상 웹페이지가 HTTPS를 사용해도 클라이언트와 프록시 사이의 연결까지 반드시 TLS를 사용하는 것은 아닙니다.

프로토콜

SOCKS5

SOCKS5는 서버 설정에 따라 사용자 이름과 비밀번호 인증을 사용할 수 있는 범용 프록시 프로토콜이지만, 프로토콜 자체는 데이터를 암호화하지 않습니다. UDP 사용 가능 여부는 양쪽 구현과 네트워크 조건에 따라 달라집니다. TCP 요청이 된다고 해서 UDP에 의존하는 모든 요청도 가능하다고 단정할 수 없습니다.

03 / 규칙 키워드

일치 대상과 작성 범위

규칙은 위에서 아래로 확인하며, 처음 일치한 규칙의 동작이 적용됩니다. 예시는 문서용으로 예약된 도메인과 주소를 사용하며 형식을 설명하기 위한 것입니다.

규칙 키워드

DOMAIN

DOMAIN은 지정한 도메인과 정확히 일치합니다. 예: DOMAIN,example.com,DIRECT. 이 규칙은 www.example.com까지 자동으로 포함하지 않습니다. 하위 도메인도 포함하려면 일치 범위를 추측하기보다 DOMAIN-SUFFIX가 적절한지 확인하세요.

규칙 키워드

DOMAIN-SUFFIX

DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인을 일치시킵니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인과 그 아래의 도메인을 모두 포함합니다. 도메인 경계를 기준으로 판단하므로 다른 도메인에 비슷한 문자열이 들어 있어도 일치하지 않습니다. 같은 도메인 계층에 공통 동작을 적용할 때 적합합니다.

규칙 키워드

DOMAIN-KEYWORD

DOMAIN-KEYWORD는 도메인에 지정한 문자열이 포함되어 있는지 확인합니다. 예: DOMAIN-KEYWORD,ads,REJECT. 전체 도메인이나 도메인 접미사가 일치할 필요가 없으므로 짧은 키워드는 정상 요청까지 차단할 수 있습니다. 추가하기 전에 연결 기록에서 전체 도메인을 확인하세요.

규칙 키워드

GEOIP

GEOIP는 IP 지리 데이터베이스의 분류를 기준으로 대상 주소를 일치시킵니다. 예: GEOIP,CN,DIRECT. 데이터베이스 결과는 웹사이트의 언어, 운영 주체 또는 사용자의 소재지를 판단하지 않습니다. 같은 웹사이트가 여러 주소를 사용하면 분류가 달라질 수 있으므로 실제 대상 주소를 확인하세요.

규칙 키워드

IP-CIDR / IP-CIDR6

IP-CIDR은 IPv4 네트워크 대역을 기준으로 일치시키고, IP-CIDR6은 IPv6에 사용합니다. 슬래시 뒤의 프리픽스 길이가 적용 범위를 정합니다. IP-CIDR,192.0.2.0/24,DIRECT는 문서용 주소 예시입니다. 규칙은 웹페이지 이름이 아닌 대상 주소를 기준으로 하며, 프리픽스 길이를 바꾸면 적용 범위도 달라집니다.

규칙 키워드

FINAL

FINAL은 앞선 규칙에 하나도 일치하지 않은 연결을 처리합니다. 예를 들어 FINAL,PROXY는 최종 동작을 지정합니다. 보통 규칙 목록의 마지막에 둡니다. 앞쪽에 있으면 뒤의 규칙이 연결을 처리할 기회가 없을 수 있으므로 규칙 내용뿐 아니라 위치와 순서도 확인하세요.

04 / 정책 동작

일치 후 연결 처리

채운 원, 빈 원, 사선이 있는 원은 각각 세 가지 동작을 나타냅니다. 이 기호는 이 사이트에서 설명을 위해 사용하는 표시이며 앱 내 상태 아이콘이 아닙니다.

정책 동작

PROXY

PROXY는 규칙에서 사용하는 프록시 동작으로, 규칙에 일치하면 현재 선택된 프록시로 연결을 처리합니다. 서버를 자동으로 제공하거나 선택한 서버에 연결할 수 있음을 보장하지는 않습니다. 규칙이 일치했는데 요청이 실패하면 기존 서버 항목과 인증 정보, 연결 상태도 확인하세요.

정책 동작

DIRECT

DIRECT는 일치한 연결이 프록시 서버를 거치지 않고 로컬 네트워크를 통해 대상에 직접 접속한다는 뜻입니다. DNS, 라우팅 또는 대상 서비스 문제로 연결이 실패할 수 있으므로 반드시 성공한다고 볼 수 없습니다. 개별 규칙의 동작인 DIRECT와 Global Routing의 Direct 방식은 구분해서 이해하세요.

정책 동작

REJECT

REJECT는 일치한 연결을 거부합니다. 조건의 범위가 지나치게 넓은지, 더 구체적인 규칙보다 앞에 있는지 확인하세요. 페이지가 표시되지 않거나 앱의 일부 기능이 실패하면 기록에서 이 동작이 적용되었는지 먼저 확인하고 해당 조건을 수정하세요. 모든 규칙을 한꺼번에 비활성화하지 않는 것이 좋습니다.

05 / 구독 및 설정

항목, 설정 및 복원

구독은 항목을 업데이트하고, 설정은 처리 규칙을 구성하며, 구입 기록은 앱을 다시 찾는 데 사용합니다. 세 가지는 서로 대체할 수 없습니다.

구독 및 설정

Subscribe

Subscribe는 사용자가 보유한 구독 주소로 서버 항목을 가져오거나 업데이트합니다. 주소는 사용자가 이용하는 서비스 제공업체에서 확인해야 합니다. 업데이트로 항목의 내용이나 개수가 바뀔 수 있으며, 직접 수정한 내용이 덮어써질 수도 있습니다. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷, 로그 또는 공유 문서에 노출하지 마세요.

구독 및 설정

SERVER

SERVER는 서버 관련 항목이나 정보를 뜻하며, 일반적으로 주소, 포트, 프로토콜 및 인증 정보를 포함합니다. 서버 항목은 주로 ‘연결 방법’을 나타내며 DNS, 규칙 및 기타 설정을 포함한 전체 설정과는 다릅니다. 서버 정보를 가져와도 트래픽 분할 규칙까지 자동으로 설정된다고 볼 수 없습니다.

구독 및 설정

Config

Config는 설정 파일 관리 메뉴를 뜻하기도 하고 Global Routing의 설정 방식 이름으로도 쓰이므로 위치에 따라 의미를 구분해야 합니다. 파일을 가져오는 것과 선택해 활성화하는 것은 별개의 작업입니다. 변경하기 전에 현재 파일을 백업하고 실제 적용 항목을 확인해 가져오기에 성공한 것을 설정 전환이 완료된 것으로 오해하지 않도록 하세요.

구독 및 설정

iCloud 동기화

iCloud 동기화는 해당 기능을 지원하는 기기와 설정에서 관련 데이터를 동기화하는 방식입니다. 실제 동기화 범위는 앱과 시스템에서 제공하는 옵션에 따라 달라집니다. 동기화는 별도의 백업이 아니며, 삭제하거나 수정한 내용이 다른 기기에도 반영될 수 있습니다. 기기를 옮기기 전에 내용을 확인하고 필요한 설정 파일은 별도로 내보내 보관하세요.

구독 및 설정

구입 항목

구입 항목은 App Store에서 같은 구입 계정으로 과거에 받은 앱을 찾는 메뉴입니다. 앱을 다시 받아도 설정이 자동으로 복원되는 것은 아닙니다. iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제이며, Mac / Windows / Android / Linux 버전은 무료입니다. 앱을 다시 받는 것과 서버 서비스를 복원하는 것은 별개입니다.