OFFICIAL MANUAL / GLOSSARY

Shadowrocket 용어 가이드

화면 위치와 설정 목적에 따라 용어를 찾아보세요. 연결 스위치, 라우팅 모드, 규칙 정책을 구분한 다음 사용자가 보유한 서버 정보와 매개변수를 대조하세요.

용어 31개
화면 메뉴는 영어 원문으로 표기
규칙 예시에는 example.com 사용

01 / INTERFACE

화면 메뉴와 스위치

먼저 현재 조작 중인 화면을 확인하세요. 연결이 켜져 있는지, 요청이 어떤 경로를 이용하는지, 조건에 따라 자동으로 연결되는지는 서로 다른 문제입니다.

Home: Home에서 서버 항목을 확인하고 사용자가 보유한 서버를 선택한 뒤 연결 스위치를 조작하세요. 스위치를 켜면 클라이언트가 연결을 설정하거나 유지하기 시작하지만, 모든 대상 요청의 성공을 의미하지는 않습니다. 처음 사용할 때는 항목의 매개변수를 확인한 다음 연결 및 접속을 테스트하세요.

Global Routing: Home에서 Global Routing을 열고 Config, Proxy, Direct 중 하나를 선택해 전체 트래픽 처리 방식을 정합니다. 이 옵션은 요청이 규칙을 거칠지 프록시 경로를 이용할지에 영향을 주며, 서버 주소나 비밀번호를 변경하지는 않습니다. 접속 결과가 달라졌다면 현재 모드를 기록해 서버 매개변수 변경과 혼동하지 않도록 하세요.

Config / Proxy / Direct: Global Routing에서 설정은 Config, 프록시 연결은 Proxy, 직접 연결은 Direct에 해당합니다. Config는 현재 설정의 규칙에 따라 요청을 처리하고, Proxy는 선택한 프록시 경로를 이용하며, Direct는 대상에 직접 연결합니다. Config를 선택하기 전에 필요한 설정이 활성화되어 있는지 확인하세요. Proxy를 선택해도 사용 가능한 서버 정보가 필요합니다.

On Demand: 관련 설정에서 On Demand를 구성하면 지정한 네트워크 조건에 따라 연결이 실행됩니다. 이 기능은 연결 시점을 정하는 것으로, 특정 도메인에 적용할 정책을 선택하지는 않습니다. 연결을 끈 뒤 다시 실행된다면 먼저 On Demand 조건을 확인한 다음 연결 이상 여부를 살펴보세요.

Data: Data에서 클라이언트에 기록된 트래픽 통계를 확인해 연결 후 데이터 활동을 살펴볼 수 있습니다. 통계 범위와 집계 시작 시점, 초기화 방식은 현재 화면에 표시된 내용을 기준으로 판단하세요. 서비스 제공업체의 과금 기준은 다를 수 있으므로 이 수치를 계정의 잔여 사용량으로 간주하지 마세요.

Settings: Settings에서 클라이언트 동작과 관련된 설정을 찾으세요. 이름과 사용 가능한 옵션은 현재 앱 화면을 기준으로 확인해야 합니다. 변경 전에 기존 값을 기록하고, 한 번에 관련 옵션 하나만 조정한 뒤 같은 네트워크에서 다시 테스트하세요. 이름이 비슷하다는 이유로 전역 설정과 개별 서버 매개변수를 같은 항목으로 취급하지 마세요.

02 / PROTOCOLS

프로토콜

Add Server에서 사용자가 보유한 매개변수와 일치하는 프로토콜 유형을 선택하세요. 프로토콜에 따라 필드의 의미가 달라지므로 Address와 Port만 복사한 뒤 유형을 임의로 바꾸면 안 됩니다.

Shadowsocks: Add Server에서 Shadowsocks를 선택한 다음 보유한 정보에 따라 주소, 포트, 암호화 방식, 비밀번호를 입력하세요. 양쪽에서 동일한 매개변수를 사용해야 하며, 비밀번호가 맞더라도 암호화 방식이 다르면 연결에 영향을 줍니다. Shadowsocks는 프록시 프로토콜 이름이지 특정 서버나 설정 파일의 이름이 아닙니다.

VMess: VMess 항목에서 서버 주소, 포트, 사용자 ID, 전송 관련 필드를 확인하세요. 사용자 ID와 전송 설정은 서버 측 설정과 일치해야 합니다. TLS를 사용하는 경우 해당 이름과 인증서 정보도 확인하세요. 가져오기에 성공했다는 것은 항목을 인식했다는 뜻일 뿐, 실제 연결 테스트를 대신하지는 않습니다.

VLESS: VLESS 항목에는 보유한 정보에 따라 사용자 ID와 전송 매개변수를 입력하고, 다른 프로토콜의 인증 필드를 그대로 적용하지 마세요. VLESS 자체가 전송 암호화를 완전히 제공하는 것은 아니며, 연결 보안은 선택한 전송 방식과 TLS 등의 설정에도 좌우됩니다. 핸드셰이크에 실패하면 인증 정보와 전송 정보를 나누어 확인하세요.

Trojan: Trojan 항목에 주소, 포트, 비밀번호를 입력하고 TLS 관련 매개변수를 확인하세요. Trojan은 TLS를 통해 전송되므로 SNI와 인증서 이름이 일치하지 않으면 핸드셰이크 단계에서 연결에 실패할 수 있습니다. 인증서 오류가 발생하면 검증을 건너뛰기보다 먼저 이름, 기기 시간, 인증서 상태를 확인하세요.

Hysteria2: 프로토콜 유형에서 Hysteria2를 선택한 다음 보유한 인증 및 TLS 매개변수를 입력하세요. Hysteria2는 QUIC 기반이며 UDP에 의존합니다. 따라서 현재 네트워크에서 일반 웹 페이지에 접속할 수 있더라도 해당 연결 경로의 사용 가능 여부가 보장되지는 않습니다. 문제를 확인할 때는 먼저 프로토콜 유형과 매개변수를 점검한 뒤 네트워크별 결과를 비교하세요.

WireGuard: WireGuard 설정에서 로컬 개인 키, Peer 공개 키, 엔드포인트, 주소 범위 등의 정보를 확인하세요. 개인 키와 상대방의 공개 키는 용도가 다르므로 서로 바꿔 입력하면 안 됩니다. Allowed IPs는 도메인 목록도 아닙니다. 개인 키는 민감 정보이므로 문제 해결 자료를 공유할 때 삭제하고 공개 스크린샷이나 메모에 포함하지 마세요.

HTTP / SOCKS5: Add Server에서 사용 중인 서비스의 실제 유형에 따라 HTTP 또는 SOCKS5를 선택하고 인증 방식을 확인하세요. 두 유형은 서로 다른 프록시 연결 프로토콜입니다. 암호화 전송 및 UDP 지원 여부는 구체적인 구성과 서비스 기능에 따라 다릅니다. 주소와 포트가 같다는 이유만으로 두 유형을 서로 바꿔 쓸 수 있다고 판단하지 마세요.

03 / RULE KEYWORDS

규칙 키워드

먼저 매칭 조건을 확인하고 다음으로 처리 정책을 살펴보세요. 아래 구문은 문법 예시일 뿐이며, PROXY는 실제 설정에서 사용 가능한 정책 참조와 일치해야 합니다.

규칙: 현재 설정의 규칙 섹션에서 매칭 조건과 정책을 확인하세요. Global Routing에서 Config를 선택했을 때만 해당 설정에 따라 트래픽이 분기됩니다. 규칙은 일반적으로 위에서 아래로 확인하므로, 범위가 넓은 조건을 앞에 두면 뒤의 항목보다 먼저 적용될 수 있습니다. 규칙을 수정한 뒤 저장하고 변경된 설정이 사용 중인지 확인한 다음 동일한 대상으로 테스트하세요.

DOMAIN: 규칙에 DOMAIN,example.com,PROXY를 사용하면 전체 도메인으로 매칭한 뒤 지정한 정책을 적용합니다. 여기서 매칭하는 것은 도메인이며 URL 경로는 포함되지 않고 모든 하위 도메인에 자동 적용되는 것도 아닙니다. 하위 도메인까지 포함해야 한다면 DOMAIN-SUFFIX가 원하는 범위에 더 적합한지 확인하세요.

DOMAIN-SUFFIX: 규칙에 DOMAIN-SUFFIX,example.com,PROXY를 사용하면 example.com과 그 하위 도메인을 매칭할 수 있습니다. URL 전체에서 문자열을 임의로 검색하는 방식이 아니라 도메인 접미사의 경계를 기준으로 판단합니다. 설정 전에 적용할 도메인 범위를 확인하고, 매칭 값에 경로나 프로토콜 접두사가 들어가지 않도록 하세요.

DOMAIN-KEYWORD: 규칙에 DOMAIN-KEYWORD와 지정 문자열을 입력하면 도메인에 해당 문자열이 포함된 요청을 매칭할 수 있습니다. 전체 도메인 매칭보다 범위가 넓어 대상 사이트가 아닌 비슷한 이름의 도메인까지 포함될 수 있습니다. 명확한 도메인 하나만 처리하려면 더 정확한 조건을 우선 고려하세요.

GEOIP: 규칙에 GEOIP,CN,DIRECT를 사용하면 IP 지리 데이터베이스의 등록 정보를 바탕으로 정책을 결정합니다. 판단 기준은 대상 IP이며 웹 페이지의 언어나 접속자의 위치가 아닙니다. 데이터베이스 기록과 실제 서비스 배포 위치가 다를 수 있으므로 문제가 생기면 DNS 조회 결과와 일치한 규칙을 함께 확인하세요.

IP-CIDR / IP-CIDR6: 규칙에서 IP-CIDR은 IPv4 주소 범위, IP-CIDR6은 IPv6 주소 범위를 매칭합니다. CIDR의 슬래시 뒤 숫자는 네트워크 프리픽스 길이이며 포트가 아닙니다. 입력 전에 대상 주소가 어느 범위에 속하는지 확인하세요. 프리픽스 범위를 지나치게 넓게 잡으면 관련 없는 요청의 경로까지 달라질 수 있습니다.

FINAL: 규칙 목록 끝에서 FINAL을 확인하세요. 예를 들어 FINAL,PROXY는 앞선 규칙에 일치하지 않을 때 해당 정책을 적용한다는 뜻입니다. 이는 기본 처리 방식이지 모든 서버를 다시 테스트하거나 응답이 가장 빠른 항목을 자동 선택하는 기능은 아닙니다. 많은 요청이 FINAL에 해당한다면 먼저 앞선 규칙이 예상한 대상을 포함하는지 확인하세요.

PROXY / DIRECT / REJECT: 규칙 끝부분의 정책 표시를 확인하세요. DIRECT는 직접 연결, REJECT는 거부를 뜻하며 PROXY는 현재 설정에서 어떤 항목을 참조하는지 확인해야 합니다. PROXY는 서버 주소나 고정된 연결 매개변수 묶음이 아닙니다. 라우팅 모드 Proxy와 규칙 표시 PROXY는 서로 다른 단계이므로 철자가 비슷하다는 이유만으로 같은 설정으로 취급하지 마세요.

04 / SUBSCRIPTION & CONFIG

구독 및 설정

아래 작업은 사용자가 구독 또는 서버 정보를 이미 보유하고 있다는 전제에서 설명합니다. 이 가이드에서는 노드나 구독 서비스를 제공하거나 판매 또는 추천하지 않습니다.

서버 / Add Server: Add Server에서 프로토콜을 선택한 뒤 Address, Port와 해당 프로토콜에 필요한 인증 매개변수를 입력하세요. 서버 항목은 연결 정보 모음이며 규칙 설정과는 다릅니다. 도메인과 포트만 입력해서는 설정을 완료할 수 없는 경우가 많으므로, 누락된 필드는 사용자가 이용 중인 서비스 제공업체에 문의하세요.

Config: Config 화면에서 설정 파일을 관리하고 활성화할 수 있습니다. 파일에는 규칙, DNS 등의 설정이 포함될 수 있습니다. Global Routing의 Config는 현재 설정에 따라 트래픽을 처리한다는 뜻으로, 두 항목은 이름이 같지만 용도가 다릅니다. 설정을 전환하기 전에 기존 활성 파일을 기록하고 새 파일의 정책 참조가 현재 선택한 서버와 일치하는지 확인하세요.

Scan QR Code: Scan QR Code 메뉴에서 사용자가 보유한 QR 코드의 연결 정보를 인식하세요. 필요한 경우 시스템 안내에 따라 카메라 접근을 허용합니다. QR 코드는 데이터를 담는 수단으로, 단일 서버 링크나 구독 주소가 들어 있을 수 있으므로 가져온 결과를 항목별로 확인해야 합니다. 인증 정보가 포함된 QR 코드도 민감 자료이므로 공개적으로 전달하지 마세요.

클라이언트 일회성 구매: App Store에서 Shadowrocket을 구매하면 클라이언트 사용 권한을 받습니다. 클라이언트 일회성 구매와 회선 요금제는 별개입니다. 구매해도 서버, 구독 주소, 인증 매개변수가 자동으로 생성되지 않으므로 기존 설정은 직접 가져와야 합니다. Shadowrocket은 상용 폐쇄형 앱입니다. 시스템 요구 사항, 호환성 및 일반적인 구매 조건은 App Store 페이지를 기준으로 확인하세요. 구매 전에 정품 확인 안내를 살펴볼 수 있습니다.

05 / DNS & NETWORK

DNS 및 네트워크

도메인 조회, 프로토콜 핸드셰이크, 대상 접속을 나누어 확인하세요. 한 번의 테스트 결과는 해당 시점과 테스트 방식에서의 상태만 보여줍니다.

DNS: 현재 설정의 DNS 관련 항목에서 조회 방식을 확인하세요. DNS는 도메인을 IP 주소로 변환합니다. 도메인 조회 실패와 프록시 서버 연결 실패는 서로 다른 단계이므로 따로 점검해야 합니다. 조회 결과는 이후 IP 규칙의 판단에도 영향을 줄 수 있으므로 DNS를 변경한 뒤에는 조회 결과와 규칙 매칭이 어떻게 달라지는지 함께 확인하세요.

DNS over HTTPS: 지원되는 DNS 설정에서 DNS over HTTPS 서비스 주소를 입력하면 HTTPS를 통해 조회 요청을 전송할 수 있습니다. 보호되는 것은 조회 전송 과정이며 모든 앱 데이터가 같은 프록시 경로를 이용한다는 뜻은 아닙니다. DNS 서비스에 계속 접속할 수 있어야 합니다. 시간 초과가 발생하면 설정을 여러 번 바꾸기보다 서비스 주소, 연결 경로, 관련 규칙을 확인하세요.

Connectivity Test / 지연 시간: Connectivity Test에서 테스트를 실행하면 현재 테스트 방식으로 측정한 응답 상태를 확인할 수 있습니다. 지연 시간은 다운로드 속도와 다르며 테스트에 성공해도 모든 도메인과 연결 방식이 사용 가능하다는 뜻은 아닙니다. 결과를 비교할 때는 네트워크, 테스트 방식, 대상을 동일하게 유지하고 실제로 이용하려는 서비스에서도 확인하세요.

TLS / SNI: 서버의 TLS 관련 필드에서 SNI를 확인하세요. SNI는 핸드셰이크 중 대상 서버 이름을 알리는 데 사용됩니다. TLS는 전송을 보호하고 인증서를 통해 상대방의 신원을 확인합니다. 연결 Address와 인증서 이름은 다를 수 있지만 실제 서버 구성과 일치해야 합니다. 인증서 오류가 발생하면 검증을 건너뛰지 말고 이름, 유효 기간, 기기 시간을 먼저 확인하세요.

MTU: 관련 프로토콜 설정에서 MTU를 확인하세요. MTU는 네트워크 인터페이스가 전송하는 단일 패킷의 최대 크기입니다. 일부 경로에서는 값이 맞지 않아 패킷이 분할되거나 일부 요청이 멈출 수 있지만, 웹 페이지가 열리지 않는 원인이 반드시 MTU인 것은 아닙니다. 변경 전에 기존 값을 기록하고 인증, DNS, 라우팅 문제를 먼저 확인한 다음 값을 한 번에 하나씩 바꾸어 다시 테스트하세요.

작업 순서에 따라 읽으려면 전체 사용 설명서를 확인하세요. 구매 페이지를 확인하려면 App Store 정품 확인을 참고하세요.