공식 매뉴얼 · 용어 참고

Shadowrocket 용어집

먼저 현재 화면을 확인한 다음 용어의 용도를 살펴보세요. 화면 용어, 프로토콜 이름, 규칙 키워드는 영어 원문으로 유지하고, 한국어 설명으로 연결·트래픽 분기·구성에서의 역할을 구분합니다.

INTERFACE / ROUTING

화면 및 스위치

화면 이름, 전체 모드, 연결 상태 중 무엇을 가리키는지 먼저 확인하세요. 스위치가 켜져 있다고 해서 대상 웹사이트에 연결할 수 있는 것은 아닙니다. 선택한 서버, 현재 모드 및 규칙도 확인해야 합니다.

Home

기존 서버를 확인하고 연결 대상을 선택한 뒤 연결 스위치를 조작하는 주요 화면입니다. 정보를 추가할 때 Add Server 또는 Scan QR Code를 사용하는 경우가 많습니다. 가져온 후에는 항목을 확인하고 연결을 시도하세요. Home에 표시되는 이름은 구분을 위한 라벨일 뿐, 서버 상태나 품질을 보장하지 않습니다.

Global Routing

전체 요청의 처리 방식을 결정하는 모드 선택 항목입니다. 구성, 프록시, 직접 연결에 해당하는 Config, Proxy, Direct가 있습니다. 서버 선택과는 다릅니다. 모드는 처리 방식을, 서버 선택은 프록시 연결에 사용할 원격 대상을 결정합니다. 트래픽 분기가 예상대로 동작하지 않으면 먼저 이 항목이 Config인지 확인하세요.

Global Routing에서 Config는 현재 구성의 규칙에 따라 처리 정책을 선택한다는 뜻입니다. 요청은 PROXY로 전달되거나 DIRECT 또는 REJECT로 처리될 수 있으므로, Config를 선택했다고 모든 요청이 프록시를 통하는 것은 아닙니다. 하단 탭 이름으로 쓰이는 Config는 구성 파일 관리 화면을 가리키기도 합니다. 위치에 따라 의미를 구분하세요.

Proxy

Global Routing의 프록시 모드입니다. 일반 연결 요청을 일상적인 웹사이트 분기 규칙에 따라 하나씩 처리하는 대신 선택한 프록시 대상으로 전달합니다. 실제 동작은 시스템에서 처리되는 트래픽 범위와 관련 제외 설정의 영향을 받을 수 있습니다. 규칙 행 끝에 쓰이는 대문자 PROXY와는 다릅니다. PROXY는 해당 규칙에 일치했을 때의 동작을 나타냅니다.

Direct

Global Routing의 직접 연결 모드로, 일반 요청을 프록시 서버를 거치지 않고 처리합니다. Direct로 전환해도 클라이언트 연결 스위치가 꺼지는 것은 아니며 DNS 등의 설정이 시스템 기본 상태로 복원되는 것도 아닙니다. 전환 전후의 네트워크 동작을 비교하려면 모드와 연결 스위치 상태를 각각 기록하세요.

Data

현재 화면에서 제공하는 보기로 업로드 및 다운로드 등의 클라이언트 트래픽 통계를 확인할 수 있습니다. 클라이언트 통계와 시스템의 셀룰러 데이터 통계는 집계 범위, 시간 및 초기화 시점이 다를 수 있습니다. 특정 동작의 트래픽 양을 확인할 때는 같은 화면에서 실행 전후를 비교하고, 집계 기준이 다른 누적값을 섞어 비교하지 마세요.

SETTINGS / DIAGNOSIS

Settings 항목

각 설정의 용도를 설명하며, 모든 네트워크에 적합한 고정값을 제시하지는 않습니다. 변경 전에 기존 값을 기록하고 한 번에 하나씩 바꾸세요. 자세한 조작 방법은 설정 자세히 알아보기를 참고하세요.

DNS

도메인 이름을 IP 주소로 변환하는 기능으로, 여러 네트워크 연결을 시작하기 전에 필요한 단계입니다. DNS 조회에 실패하면 프록시 서버에 연결할 수 있어도 웹페이지가 열리지 않을 수 있습니다. DNS 사용 방식은 IP 규칙 판정에도 영향을 줄 수 있으므로, 구성 파일의 관련 항목과 현재 적용 중인 모드를 함께 확인하세요. DNS 주소만 바꾸는 것으로 해결하려 하지 마세요.

On Demand

미리 설정한 네트워크 조건에 따라 연결 동작을 실행하는 기능입니다. 특정 웹사이트가 어떤 규칙에 일치하는지가 아니라 언제 연결할지를 다룹니다. 웹사이트 요청의 트래픽 분기는 Global Routing과 현재 구성에 따라 결정됩니다. 사용하기 전에 수동 연결이 정상인지 확인한 뒤, 앱에서 제공하는 네트워크 조건을 설정하고 네트워크 전환 후 동작을 확인하세요.

Connectivity Test

기존 서버의 연결 상태를 확인하는 기능입니다. 결과는 선택한 테스트 방식, 대상 및 당시 네트워크 상태에 따라 달라집니다. 지연 시간은 특정 테스트의 왕복 또는 응답 시간을 나타내며 다운로드 대역폭과 같지 않고, 모든 웹사이트에 접근할 수 있다는 보장도 아닙니다. 여러 결과를 비교할 때는 같은 테스트 방식을 사용하고, 이상이 있으면 실제 요청과 Log를 함께 확인하세요.

Log

실행, 연결 또는 요청 관련 정보를 기록하며 DNS 조회 실패, 인증 실패, 규칙 동작을 파악하는 데 도움이 됩니다. 재현 가능한 동작을 수행한 시간대의 기록을 확인하고, 맥락에서 떨어진 한 줄만 살펴보지 마세요. 로그에는 도메인, 주소 및 개인 구성 내용이 포함될 수 있으므로 공유 전에 인증 정보와 구독 자격 정보를 삭제하세요.

iCloud 동기화

조건에 따라 iCloud로 앱 데이터를 동기화하는 기능입니다. 구체적인 동기화 범위와 동작은 앱 내 설정을 확인하세요. App Store 구매 항목 복원과는 다른 기능입니다. 앱을 다시 받을 수 있어도 모든 로컬 구성이 복원되는 것은 아닙니다. 기기를 바꾸기 전에 복원 가능한 사본을 보관하고 새 기기에서 구성과 서버 항목을 하나씩 확인하세요.

Proxy 포트

일반적으로 로컬 프록시가 연결을 수신하는 포트를 뜻하며, Add Server에 입력하는 원격 서버 포트와는 다릅니다. 로컬 프록시를 사용하는 연결 설정과 포트 번호가 일치해야 합니다. 다른 기기의 접근 허용 여부는 수신 주소와 네트워크 접근 범위에도 달려 있습니다. 명확한 사용 사례가 없다면 웹페이지 문제를 해결하려고 수신 범위를 넓히지 마세요.

PROTOCOLS / PARAMETERS

프로토콜

프로토콜은 클라이언트와 서버가 통신하는 방식을 정의하며 성능 순위를 뜻하지 않습니다. 아래에서는 기술적 의미만 설명합니다. 설정할 때는 사용자가 이미 보유한 서버의 실제 매개변수를 기준으로 삼고, 프로토콜 이름만 바꿔 기존 항목을 변환할 수는 없습니다.

Shadowsocks

클라이언트와 서버에서 암호화 방식 및 인증 매개변수를 일치시켜야 하는 프록시 프로토콜입니다. 주소, 포트, 비밀번호 또는 암호화 방식 중 하나라도 다르면 연결에 실패할 수 있습니다. 기존 정보를 기준으로 항목별로 확인하세요. 프로토콜 이름이 같다고 서로 다른 항목의 필드를 바꿔 쓸 수 있는 것은 아닙니다.

VMess

사용자 인증 기능을 갖춘 프록시 프로토콜입니다. 일반적으로 사용자 ID와 전송 관련 매개변수를 설정해야 합니다. 하위 전송 방식, 경로 및 TLS 설정도 별도로 확인해야 하므로 서버 주소만 살펴봐서는 안 됩니다. 가져온 후에는 기존 매개변수의 의미를 유지하고, 표시용 이름을 인증 정보로 착각하지 않도록 주의하세요.

VLESS

인증과 전송 보안을 각각 설정하는 프록시 프로토콜입니다. VLESS라는 이름만으로 어떤 보호 방식이 적용되는지 판단할 수 없습니다. 사용자 ID, 전송 방식 및 관련 보안 매개변수를 서버에 맞춰야 합니다. 문제를 해결할 때는 인증 오류와 전송 핸드셰이크 오류를 구분하고 같은 주소 필드만 반복해서 바꾸지 마세요.

Trojan

일반적으로 TLS와 함께 사용하는 프록시 프로토콜입니다. 비밀번호와 서버 이름, 인증서 등 관련 매개변수를 확인해야 합니다. 서버 주소와 TLS 검증에 사용되는 이름은 역할이 다를 수 있으므로 원래 구성에 맞게 입력하세요. 인증서 오류가 발생하면 이름, 기기 시간 및 인증서 상태를 먼저 확인하고, 검증 비활성화를 일반적인 해결 방법으로 사용하지 마세요.

Hysteria2

QUIC 기반 프록시 프로토콜로, UDP 연결 가능 여부와 올바른 인증 및 TLS 매개변수가 필요합니다. 특정 네트워크에서 연결되지 않는다면 비밀번호 오류가 아니라 로컬 네트워크의 UDP 처리 방식이 원인일 수 있습니다. 프로토콜 이름에 포함된 숫자는 이름의 일부이며, 이를 근거로 다른 프로토콜과 속도나 품질을 단순 비교할 수 없습니다.

WireGuard

공개 키 방식으로 암호화 터널을 구성하는 프로토콜입니다. 설정에는 로컬 키, 피어 공개 키, 터널 주소 및 원격 엔드포인트 등이 포함됩니다. 개인 키는 민감한 인증 정보이므로 공개 스크린샷이나 로그에 포함하지 마세요. 핸드셰이크 성공과 특정 대상에 연결할 수 있는지는 별개의 확인 단계입니다. 라우팅 범위와 DNS 설정도 함께 살펴보세요.

HTTP

프록시 유형으로서 HTTP는 HTTP 프록시 방식으로 요청을 전달한다는 뜻이며, 웹 주소 앞부분의 프로토콜 표기만을 의미하지 않습니다. 프록시 서버까지의 연결이 TLS로 보호되는지는 실제 연결 방식과 설정에 따라 달라집니다. 대상 웹페이지가 HTTPS를 사용한다는 이유만으로 보호 여부를 판단할 수 없습니다. 인증 정보와 포트도 기존 서버 안내에 맞춰 입력하세요.

SOCKS5

네트워크 연결을 전달하는 프록시 프로토콜입니다. 사용자 이름과 비밀번호 인증을 사용할 수 있지만, 인증이 된다고 전송 내용이 암호화되는 것은 아닙니다. UDP 사용 가능 여부는 서버 기능, 클라이언트 설정 및 네트워크 조건에 따라 달라집니다. 항목을 확인할 때는 프록시 유형을 확인하고, 주소와 포트가 같다는 이유만으로 HTTP 프록시로 사용하지 마세요.

RULES / MATCHING

규칙 키워드

규칙은 먼저 일치 조건을 지정하고 그다음 처리 정책을 정합니다. 아래 예시는 예약된 예시 도메인 또는 문서용 주소 대역만 사용하며 구문 설명을 위한 것입니다. 규칙은 현재 활성화된 구성의 [Rule] 섹션에 넣고 순서에 유의하세요.

DOMAIN

지정한 도메인과 정확히 일치시키며 하위 도메인은 자동으로 포함하지 않습니다. 예를 들어 아래 규칙은 example.com에 적용되며, 도메인 계층이 같다는 이유만으로 www.example.com에도 적용되지는 않습니다. 기본 도메인과 하위 도메인을 모두 포함하려면 DOMAIN-SUFFIX를 고려하고 더 앞선 규칙이 있는지도 확인하세요.

DOMAIN,example.com,PROXY

DOMAIN-SUFFIX

지정한 도메인과 하위 도메인에 일치하므로 도메인 범위별 정책을 설정할 때 적합합니다. 예를 들어 example.com과 www.example.com 모두 아래 예시의 범위에 들어갈 수 있습니다. 도메인 경계를 기준으로 일치시키며 문자열이 아무 위치에나 포함되는 경우와는 다릅니다. 범위가 더 넓은 문자열 일치 규칙인 DOMAIN-KEYWORD와 구분하세요.

DOMAIN-SUFFIX,example.com,PROXY

DOMAIN-KEYWORD

도메인에 지정 문자열이 포함되어 있는지 기준으로 일치시킵니다. 정확한 도메인 규칙이나 도메인 접미사 규칙보다 일치 범위가 넓어지기 쉽습니다. 예시의 example은 example.com뿐 아니라 여러 도메인에 포함될 수 있습니다. 사용하기 전에 적용하려는 대상을 명확히 하고, 원치 않는 일치가 발생하면 범위가 넓은 이 조건부터 확인하세요.

DOMAIN-KEYWORD,example,PROXY

GEOIP

IP 지리 데이터베이스의 주소 소속 정보를 기준으로 일치시킵니다. 조건은 주소에 적용되며 웹사이트가 사용하는 언어나 사용자의 위치를 뜻하지 않습니다. 데이터베이스 결과는 웹사이트 콘텐츠의 출처와 다를 수 있고 CDN 주소 변경에 따라 달라질 수도 있습니다. 도메인 요청의 DNS 조회 방식과 데이터베이스 판정 방식 모두 규칙 결과 해석에 영향을 줍니다.

GEOIP,CN,DIRECT

IP-CIDR

IPv4 주소 대역을 기준으로 일치시키며, 슬래시 뒤의 프리픽스 길이가 범위를 결정합니다. 아래에는 문서용 예시 주소 대역을 사용하며 실제 서비스를 가리키지 않습니다. 도메인 요청에 적용할 때는 일치 과정에서 DNS 조회가 필요한지 확인하세요. 도메인 규칙을 대신할 수 없으며 두 규칙은 서로 다른 기준으로 판정됩니다.

IP-CIDR,192.0.2.0/24,DIRECT

IP-CIDR6

IPv6 주소 대역을 기준으로 일치시킵니다. IP-CIDR과 개념은 비슷하지만 대상 주소 유형이 다릅니다. IPv4 규칙만 작성했다고 해당 IPv6 연결도 같은 조건에 포함되는 것은 아닙니다. 같은 도메인의 연결 동작이 일치하지 않으면 DNS 조회 결과를 확인해 실제 사용된 주소 유형을 살펴보세요.

IP-CIDR6,2001:db8::/32,DIRECT

FINAL

앞선 규칙에 일치하지 않은 요청을 처리하는 기본 규칙으로, 일반적으로 규칙 목록의 마지막에 둡니다. FINAL,DIRECT는 나머지 요청을 직접 연결한다는 뜻입니다. PROXY로 바꾸면 나머지 요청이 프록시 정책으로 전달됩니다. 이 규칙을 변경하면 다른 규칙에 포함되지 않은 전체 범위에 영향을 주므로 특정 웹사이트만을 위한 설정으로 취급하지 마세요.

FINAL,DIRECT

PROXY / DIRECT / REJECT

규칙에 일치했을 때 적용하는 정책 이름이지 프로토콜 이름이 아닙니다. PROXY는 프록시로 전달, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. PROXY가 실제로 사용할 연결 대상은 현재 선택과 구성에 따라 달라집니다. 규칙에 쓰인 대문자 표기는 그대로 유지하고 화면 모드 Proxy, Direct와 혼용하지 마세요.

DOMAIN,example.com,REJECT

SUBSCRIBE / CONFIGURATION

구독 및 구성 파일

서버를 어디에서 가져오는지, 규칙을 어디에 저장하는지, 앱 구매를 어떻게 복원하는지 먼저 구분하세요. 서로 관련은 있지만 대체할 수는 없습니다. 앱을 다시 받더라도 기존 연결 정보가 복원되지 않을 수 있습니다.