공식 매뉴얼 / 용어 색인

Shadowrocket 용어집

화면에 표시된 용어와 구성 키워드로 찾아보세요. 먼저 연결이 설정되었는지, 요청이 어떤 규칙에 매칭되었는지, 매칭 후 어떤 정책이 적용되었는지 구분해야 합니다.

01 / Interface

화면 및 스위치

스위치는 연결을 제어하고, Global Routing은 요청 처리 방식을 결정합니다. 두 항목을 따로 확인하세요.

Home
연결 스위치, 서버 목록, Global Routing의 현재 옵션을 확인하는 화면입니다. 서버를 선택했다고 연결이 켜진 것은 아닙니다. 연결이 켜져 있어도 모든 요청이 프록시를 통하는 것은 아닙니다.
Global Routing
구성, 프록시, 직접 연결의 세 가지 모드를 제공하며 화면에는 각각 Config, Proxy, Direct로 표시됩니다. Config는 현재 구성에 따라 정책을 판단하고, Proxy는 프록시 경로를, Direct는 직접 연결 경로를 사용합니다. 규칙 매칭을 확인할 때는 먼저 Config가 선택되어 있는지 확인하세요.
On Demand
설정한 조건에 따라 연결을 시작하는 기능입니다. 예를 들어 사용 중인 네트워크에 따라 연결 여부를 정할 수 있습니다. 연결 시작 시점을 관리하며, 연결 후 요청 처리 방식은 Global Routing과 현재 구성에서 결정됩니다.
Add Server
보유 중인 서버 정보를 입력하는 기능입니다. 정보와 일치하는 프로토콜을 먼저 선택한 다음 주소, 포트 및 해당 프로토콜에서 요구하는 항목을 입력하세요. 저장에 성공했다는 것은 항목이 등록되었다는 뜻일 뿐입니다.
Connectivity Test
현재 네트워크와 테스트 조건에서 서버가 응답하는지 확인하는 기능입니다. 테스트 성공만으로 대상 앱의 연결까지 확인된 것은 아닙니다. 실패하면 테스트 대상, 서버 매개변수, 현재 네트워크를 먼저 확인하세요.
지연 시간
테스트를 시작한 시점부터 응답을 받을 때까지 걸리는 시간이며, 보통 밀리초로 표시됩니다. 지연 시간은 전송 속도와 다릅니다. 결과를 비교할 때는 같은 네트워크, 테스트 대상, 측정 방식을 사용하세요.

02 / Protocols

프로토콜

프로토콜은 클라이언트와 기존 서버가 통신하는 방식을 정합니다. 주소나 포트가 같아도 프로토콜과 매개변수를 서로 바꿔 쓸 수 있는 것은 아닙니다.

Shadowsocks
암호화된 전송을 사용하는 프록시 프로토콜입니다. 서버 정보에는 일반적으로 주소, 포트, 비밀번호, 암호화 방식이 포함됩니다. 양쪽의 암호화 방식이나 비밀번호가 다르면 주소에 연결할 수 있어도 데이터를 정상적으로 주고받지 못합니다.
VMess
사용자 식별자 등의 매개변수로 프록시 연결을 설정하는 프로토콜입니다. 기존 정보를 입력할 때는 전송 방식과 해당 보안 설정도 확인하세요. 주소와 포트만으로 항목이 완전한지 판단할 수 없습니다.
VLESS
사용자 식별자를 사용하는 프록시 프로토콜입니다. 프로토콜 이름만으로 전송 암호화 여부를 알 수는 없습니다. TLS 등의 보안 설정은 해당 서버 정보를 기준으로 확인하고, VMess 항목의 설정을 그대로 적용하지 마세요.
Trojan
일반적으로 TLS 연결에서 비밀번호로 인증하는 프록시 프로토콜입니다. 서버 주소와 인증서 검증에 사용하는 이름은 서로 다를 수 있으므로 기존 정보를 각각 확인하세요. 한 항목의 값만 보고 다른 값을 추측하지 마세요.
Hysteria2
QUIC 기반 프록시 프로토콜로, 전송에 UDP를 사용합니다. 서버 정보를 확인한 뒤 특정 네트워크에서 연결되지 않으면 해당 네트워크에서 관련 UDP 트래픽을 허용하는지 확인하세요.
WireGuard
키로 상대를 식별하는 터널링 프로토콜입니다. 구성의 상대 주소와 허용 주소 범위는 용도가 다릅니다. 전자는 연결할 대상을 지정하고, 후자는 어떤 대상 주소에 터널을 사용할지 결정하는 데 관여합니다. 개인 키를 공개 메모나 문제 화면 캡처에 포함하지 마세요.

03 / Matching

규칙 키워드 및 정책

키워드는 매칭 조건을, 정책은 매칭된 요청의 처리 방식을 결정합니다. 전체 문법은 구성 항목을 참고하세요.

규칙
[Rule]에서 매칭 조건과 처리 정책을 정의하는 항목입니다. 규칙은 일반적으로 위에서 아래로 확인하며, 매칭되면 해당 정책을 적용합니다. 두 규칙이 모두 매칭될 때 더 구체적인 규칙이 자동으로 우선한다고 가정하지 마세요.
DOMAIN
완전한 호스트 이름과 매칭합니다. 예를 들어 DOMAIN,example.com,DIRECT는 example.com에는 매칭되지만 www.example.com에는 매칭되지 않습니다. URL의 경로나 쿼리 매개변수는 매칭 대상에 포함되지 않습니다.
DOMAIN-SUFFIX
도메인 접미사를 기준으로 매칭하며 해당 도메인과 하위 도메인을 포함합니다. 예를 들어 example.com 조건은 example.com과 www.example.com에 모두 적용되지만 notexample.com에는 적용되지 않습니다.
GEOIP
요청과 관련된 IP 주소가 지리 데이터베이스에 등록된 지역 정보를 기준으로 매칭합니다. 기기의 위치를 추적하는 기능은 아닙니다. 같은 도메인도 서로 다른 주소로 해석될 수 있으며, 조회 결과가 달라지면 매칭되는 규칙도 바뀔 수 있습니다.
IP-CIDR / IP-CIDR6
IPv4 또는 IPv6 네트워크 프리픽스를 기준으로 매칭합니다. 예: 192.0.2.0/24, 2001:db8::/32. 슬래시 뒤의 숫자는 프리픽스 길이이며 포트가 아닙니다. 두 주소 체계는 각각 확인해야 합니다.
FINAL
앞선 모든 항목에 매칭되지 않은 요청에 적용할 기본 정책을 지정하며, 보통 규칙 목록의 마지막에 둡니다. 예를 들어 FINAL,DIRECT는 매칭되지 않은 요청을 직접 연결하며, 앞서 이미 매칭된 규칙의 정책을 바꾸지 않습니다.
PROXY / DIRECT / REJECT
규칙에서 사용하는 세 가지 정책입니다. PROXY는 프록시를 통해 전달, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 대문자 키워드는 해당 규칙에 매칭된 뒤의 동작만 설명하며, Global Routing의 Proxy 또는 Direct 옵션을 변경하지 않습니다.

04 / Configuration

구독 및 구성 파일

서버 정보는 '어디에 연결할지', 구성 파일은 '요청을 어떻게 처리할지'를 정합니다. 기존 정보를 사용하는 방법만 안내하며, 노드나 구독을 제공·판매·추천하지 않습니다.

서버
클라이언트가 연결하는 원격 서비스입니다. 서버 항목에는 프로토콜, 주소, 포트 등 연결 매개변수가 저장됩니다. 목록에 표시되는 이름은 구분을 위한 라벨일 뿐 실제 주소를 대신하지 않으며, 항목이 사용 가능하다는 뜻도 아닙니다.
구독
기존 구독 주소로 서버 항목을 가져오거나 새로 고치는 방식입니다. 주소는 서비스 제공업체가 전달하며 접근 자격 정보가 포함될 수 있으므로 공개적으로 게시하지 마세요. 새로 고친 뒤 기존에 사용하던 항목이 삭제되었다면 현재 목록에서 다시 선택해야 합니다.
Config
탭으로 표시될 때는 구성 파일을 관리하는 기능이며, Global Routing 옵션으로 표시될 때는 현재 구성에 따라 요청을 처리한다는 뜻입니다. 수정 전에 현재 활성화된 파일을 확인해 비활성 복사본을 편집하지 않도록 하세요.
DNS
도메인 조회 주소 등의 레코드를 제공하는 메커니즘입니다. 도메인 해석 실패, 해석된 IP의 다른 규칙 매칭, 대상 주소 연결 실패는 서로 다른 문제 해결 단계입니다. DNS 항목은 General 구성 안내부터 확인하세요.
URL Rewrite
구성 파일에서 URL 조건에 따라 매칭된 요청을 처리하는 섹션으로, 리디렉션에 자주 사용됩니다. [Rule]의 경로 선택과는 다른 기능입니다. 요청 대상이 바뀌는 경우와 요청이 프록시를 통해 전달되는 경우를 각각 확인하세요.
iCloud 동기화
계정, 시스템 설정, 앱 지원 조건을 충족하면 지원되는 앱 데이터를 기기 간에 동기화합니다. 기기를 바꾸기 전에 보존할 항목이 동기화되었는지 확인하세요. 이 기능은 App Store 구매 기록과 별개입니다.

기존 정보를 클라이언트에 입력하려면 빠른 시작의 단계를 참고하세요. 입력을 마쳤는데 연결되지 않으면 연결 문제 해결을 확인하세요.

05 / Store & Account

스토어 및 계정

App Store 구매 기록, 기기에 저장된 앱 데이터, 서버 서비스는 서로 별개의 항목입니다.

App Store 스토어프런트
계정에 연결된 스토어 지역으로, 표시되는 앱, 가격 통화, 구매 조건에 영향을 줍니다. 웹에서 미국 스토어 제품 페이지가 열려도 현재 기기에 로그인한 구매 계정이 해당 스토어를 사용한다는 뜻은 아닙니다.
앱 ID
App Store 제품 항목을 구별하는 ID입니다. Shadowrocket 제품 페이지를 확인할 때는 앱 ID 932747118, 개발자 Shadow Launch Technology Limited, 공식 아이콘을 함께 확인하세요. 이름만으로 판단하지 마세요.
구입 항목
App Store 구매 기록을 찾는 메뉴입니다. 기기를 바꾸거나 앱을 다시 설치할 때는 먼저 기존 구매 계정으로 로그인한 뒤 구입 항목에서 복원하기를 참고해 앱을 다시 받으세요. 앱을 다시 받아도 서버 항목이나 구성 파일까지 복원되는 것은 아닙니다.