Shadowrocket 공식 웹사이트 · 공식 매뉴얼

Shadowrocket용어 가이드

인터페이스 이름, 프로토콜, 규칙 문법을 찾아보세요. 앱에 표시되는 영문은 원문 그대로 두고, 한국어 설명에서 용도와 범위를 안내합니다. 사용 절차는 시작 가이드를 참고하고, 연결 문제가 있으면 문제 해결 가이드를 확인하세요.

INTERFACE & SWITCHES

인터페이스 및 스위치

먼저 각 설정이 어디에 있는지 확인하세요. 비슷한 영문 용어도 페이지, 실행 모드, 규칙의 처리 결과를 각각 가리킬 수 있습니다.

Home: 서버 항목과 구독 그룹을 확인하고 연결 대상을 선택하거나 연결 스위치를 조작하는 화면입니다. 가져온 뒤에는 항목이 이 화면에 표시되는지 확인하고 현재 선택된 항목도 살펴보세요. 가져오기에 성공했다는 것은 매개변수가 저장되었다는 뜻일 뿐, 서버에 연결할 수 있다는 뜻은 아닙니다. 연결 스위치를 켠 뒤 실제 요청을 보내 네트워크가 예상대로 작동하는지 확인해야 합니다.

Global Routing: 전체 트래픽 처리 모드를 제어하는 설정으로 Config, Proxy 또는 Direct를 선택할 수 있습니다. 규칙이 적용되지 않는 것 같다면 규칙을 바로 다시 작성하기보다 먼저 이 설정을 확인하세요. 전체 모드가 다르면 동일한 설정에서도 요청 경로가 달라질 수 있습니다. 이 설정은 연결 스위치와 별개이므로 모드를 선택했다고 연결이 수립되는 것은 아닙니다.

Config / Proxy / Direct: 세 가지 모드는 설정에 따른 처리, 전체 프록시 경로 사용, 전체 직접 연결을 각각 의미하며 화면에는 Config, Proxy, Direct로 표시됩니다. 규칙에 따라 트래픽을 분기하려면 Config를 사용하세요. Proxy나 Direct로 잠시 전환하면 경로를 비교하는 데 도움이 되지만, 테스트가 끝나면 원래 선택으로 되돌리세요. 첫 글자만 대문자인 화면 용어와 규칙에 쓰이는 모두 대문자 정책 키워드를 혼동하지 마세요.

On Demand: 설정 조건에 따라 VPN 연결 동작을 트리거하고 연결을 시작하거나 복구할 시점을 제어하는 옵션입니다. 연결 트리거 조건을 처리할 뿐, 특정 도메인에 적용할 규칙을 판단하지는 않습니다. 수동으로 연결을 끈 뒤 다시 연결된다면 스위치를 반복해서 조작하기보다 On Demand 조건을 확인하세요.

Add Server: 기존 서버 정보를 사용해 연결 항목을 만드는 메뉴입니다. 먼저 서버와 동일한 프로토콜을 선택한 다음 해당 항목을 입력하세요. 주소, 포트, 인증 정보는 서로 다른 매개변수이므로 표시 이름만 보고 입력이 올바른지 판단할 수 없습니다. 전송 방식, TLS 및 기타 선택 항목도 기존 서버 안내에 따라 확인하고, 여러 조합을 무작정 시도해 설정하지 마세요.

Connectivity Test: 현재 네트워크와 선택한 테스트 방식에서 항목의 연결 상태를 확인합니다. 결과는 이번 테스트가 확인한 경로에만 해당하며, 모든 웹사이트와 전송 방식이 정상임을 보장하지는 않습니다. 테스트는 통과했지만 실제 요청이 실패한다면 Global Routing, DNS 및 대상 규칙을 추가로 확인하세요. 테스트 시간 초과만으로 인증 정보가 잘못되었다고 단정할 수도 없습니다.

PROTOCOLS

프로토콜

프로토콜은 클라이언트와 서버가 통신하는 방식을 정합니다. 같은 프로토콜 이름을 사용해도 매개변수는 다를 수 있으므로 항목을 추가할 때 기존 정보를 하나씩 대조하세요.

Shadowsocks: 클라이언트와 서버 간 프록시 트래픽을 전달하는 프로토콜입니다. 서버 주소, 포트, 암호화 방식, 비밀번호가 서로 일치해야 연결할 수 있습니다. 암호화 방식은 프로토콜 매개변수이므로 이름이 비슷하다는 이유로 서로 바꿔 사용할 수 없습니다. 기존 정보에 추가 전송 설정이 있다면 함께 확인하세요. 표시 이름을 바꿔도 매개변수 불일치는 해결되지 않습니다.

VMess: 인증 기능을 포함한 프록시 프로토콜로, 일반적인 연결 정보에는 사용자 ID, 전송 방식, 보안 설정이 포함됩니다. 서버 주소에 연결할 수 있다는 사실은 네트워크 경로 일부만 정상임을 보여 줍니다. 인증 또는 전송 매개변수가 일치하지 않으면 연결이 실패할 수 있습니다. 기기 시간이 크게 어긋나도 인증에 영향을 줄 수 있으므로 다른 항목을 점검하기 전에 시스템 시간을 올바르게 설정하세요.

VLESS: 경량 프록시 프로토콜입니다. 전송 보호 수준은 실제로 설정된 보안 계층에 따라 달라지므로 프로토콜 이름만으로 연결 보호 방식을 판단할 수 없습니다. 사용자 ID, 전송 방식 및 관련 보안 매개변수는 서버 설정과 일치해야 합니다. 항목을 가져온 뒤에도 연결되지 않으면 다른 프로토콜로 바로 바꾸지 말고 원래 서버 안내를 확인하세요.

Trojan: 일반적으로 TLS와 함께 사용하는 프록시 프로토콜입니다. 인증 정보와 인증서 관련 설정이 모두 연결 성공 여부에 영향을 줍니다. 서버 주소, TLS에 사용하는 이름, 인증서가 적용되는 도메인은 각각 다른 역할을 할 수 있으므로 따로 확인하세요. 인증서 오류가 발생하면 이름, 기기 시간, 서버 인증서를 먼저 점검하세요. 검증을 끄는 방법을 일반적인 해결책으로 사용해서는 안 됩니다.

Hysteria2: QUIC 기반 프록시 프로토콜로, 하위 통신에 UDP를 사용하므로 네트워크에서 해당 UDP 트래픽을 허용하는지 확인해야 합니다. 실제 성능은 네트워크 경로에 따른 혼잡, 패킷 손실, 서버 리소스, 매개변수 설정에도 영향을 받으므로 프로토콜 이름만으로 속도를 판단할 수 없습니다. 일반 웹페이지는 열리지만 이 항목에서 계속 시간 초과가 발생한다면 하위 UDP 연결 가능성도 확인하세요.

WireGuard: 키를 사용해 암호화 터널을 구성하는 VPN 프로토콜입니다. 설정에는 일반적으로 로컬 주소, 피어 공개 키, 엔드포인트, 허용 주소 범위가 포함됩니다. 터널이 수립되어도 모든 대상에 올바른 경로가 자동으로 설정되는 것은 아니므로 라우팅 범위와 DNS도 확인해야 합니다. 개인 키는 민감한 정보입니다. 문제 해결 자료를 공유할 때 개인 키와 인증에 사용할 수 있는 다른 정보는 가리세요.

RULE KEYWORDS

규칙 키워드

규칙은 일반적으로 순서대로 확인하며, 먼저 매칭된 규칙이 처리 결과를 결정합니다. 키워드는 매칭 조건을 나타내고, 행 끝의 정책은 매칭 이후 처리 방식을 지정합니다.

DOMAIN: 전체 도메인과 정확히 일치하므로 호스트 이름 하나만 지정할 때 적합합니다. 예를 들어 DOMAIN,example.com,DIRECT는 example.com에 적용되며 모든 하위 도메인에 자동으로 적용되지는 않습니다. 대상에 별도의 API 또는 정적 리소스 도메인이 있다면 각각 고려해야 합니다. 기본 페이지가 매칭되었다고 해서 페이지 내 모든 요청의 경로도 같다고 볼 수 없습니다.

DOMAIN-SUFFIX: 도메인 접미사로 매칭하므로 지정한 도메인과 하위 도메인에 적용할 수 있습니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 example.com과 그 하위 도메인에 사용할 수 있으며, example.com 문자열이 포함된 모든 호스트 이름을 매칭하지는 않습니다. 범위가 넓은 접미사 규칙을 추가하기 전에 앞쪽에 더 구체적인 예외 규칙이 있는지 확인하세요.

DOMAIN-KEYWORD: 도메인에 지정한 문자열이 포함되어 있는지 매칭합니다. 전체 도메인이나 접미사 매칭보다 범위가 넓은 편입니다. 서로 관련 없는 여러 도메인이 동시에 매칭될 수 있으므로 짧은 문자열을 정확한 조건처럼 사용하지 마세요. 예상하지 못한 트래픽 분기가 발생하면 범위가 지나치게 넓은 키워드 규칙이 있는지, 더 구체적인 규칙보다 앞에 놓였는지 확인하세요.

GEOIP: IP 지리 데이터베이스의 할당 정보를 기준으로 대상 주소를 매칭합니다. 결과는 데이터베이스 내용과 조회된 IP에 따라 달라집니다. 기기의 실시간 위치를 나타내거나 서버의 물리적 위치를 정확히 보여 주는 것은 아닙니다. 분산 서비스를 이용하는 대상은 네트워크에 따라 조회 주소가 달라질 수 있으므로 도메인에 대한 인상만으로 GEOIP 규칙이 매칭될지 판단하지 마세요.

IP-CIDR / IP-CIDR6: IPv4 및 IPv6 주소 범위를 각각 매칭하며, 슬래시 뒤의 접두사 길이가 범위를 정합니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT는 IPv4 사설 주소 범위를 나타내며 단일 주소만 매칭하지는 않습니다. 주소 범위 규칙을 작성할 때 IPv6 경로도 고려하세요. IPv4만 확인하고 모든 요청이 처리된다고 판단하지 않도록 주의해야 합니다.

FINAL: 앞선 규칙이 하나도 매칭되지 않을 때 적용하는 기본 규칙으로, 일반적으로 규칙 목록 끝에 둡니다. FINAL,DIRECT는 나머지 요청을 직접 연결하고, FINAL,PROXY는 나머지 요청에 프록시 경로를 사용합니다. 이 규칙을 바꾸면 구체적인 규칙이 적용되지 않는 많은 요청에 영향을 주므로 기존 규칙을 먼저 파악한 뒤 기본 정책을 조정하세요.

PROXY / DIRECT / REJECT: 자주 사용하는 규칙 정책 키워드로, 프록시 경로 사용, 직접 연결, 요청 거부를 각각 의미합니다. 규칙 끝의 PROXY는 특정 서버의 고정된 이름이 아닙니다. 실제 연결 대상은 현재 선택 항목과 설정에 따라 달라집니다. DIRECT도 클라이언트의 모든 처리 과정에서 벗어난다는 뜻은 아닙니다. 해당 요청의 연결 경로를 나타내며 DNS 동작은 설정과 함께 확인해야 합니다.

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

예시의 대상 요청이 먼저 다른 규칙과 매칭되면 뒤에 있는 같은 종류의 규칙은 해당 요청의 정책을 결정하지 않습니다. 전체 문제 해결 절차는 규칙 분기 및 연결 문제 해결을 참고하세요.

SUBSCRIPTION & CONFIGURATION

구독 및 설정

구독은 연결 항목을 관리하고, 설정은 트래픽 처리 방식을 관리합니다. 가져오기, 업데이트, 선택, 연결은 서로 다른 작업이므로 각각 결과를 확인해야 합니다.

서버 항목: 클라이언트에 저장되는 연결 매개변수 모음으로, 일반적으로 서버 주소, 포트, 프로토콜, 인증 정보와 전송 및 TLS 설정이 포함될 수 있습니다. 항목의 표시 이름은 알아보기 위한 라벨일 뿐 서버 위치, 속도, 사용 가능 여부를 보장하지 않습니다. 구독으로 생성된 항목을 수정하기 전에 기록을 남겨 두세요. 이후 구독 업데이트에서 해당 매개변수가 바뀔 수 있습니다.

Config: 인터페이스 이름으로는 규칙과 관련 네트워크 설정을 관리하는 설정 파일을 뜻하며, Global Routing 옵션으로는 현재 설정에 따라 요청을 처리한다는 의미입니다. 설정 파일과 서버 구독은 용도가 다르므로 한쪽을 업데이트해도 다른 쪽까지 업데이트되는 것은 아닙니다. 파일을 가져왔더라도 실제로 선택된 것은 아닐 수 있으니 문제를 확인할 때 현재 사용 중인 파일을 확인하세요.

구독 업데이트: 구독 링크에 다시 요청을 보내고 응답 내용에 따라 해당 항목을 업데이트하는 작업입니다. App Store에서 Shadowrocket을 업데이트하는 것과는 별개입니다. 업데이트는 링크 접속, 서버 응답, 내용 인식 단계에서 실패할 수 있으므로 단계별로 원인을 찾고 기존 그룹을 바로 삭제하지 마세요. 업데이트 후에는 현재 선택 항목을 다시 확인하고, 기존 항목이 삭제되었거나 매개변수가 바뀌었는지도 살펴보세요.

구독 가져오기 및 첫 연결 가이드 보기 →

DNS & NETWORK

DNS 및 네트워크

도메인 조회, 서버 연결, 대상 서비스 접속을 나누어 확인하세요. 한 단계가 성공해도 나머지 단계까지 정상이라고 단정할 수 없습니다.

DNS: 도메인을 IP 주소 등의 레코드로 변환하는 시스템으로, 많은 네트워크 요청은 연결을 시작하기 전에 이 과정을 거칩니다. 조회에 실패하면 요청이 대상 연결 단계에 도달하지 못했을 수 있습니다. 조회에 성공해도 포트에 연결할 수 없거나 인증에 실패하거나 대상 서비스에 오류가 발생할 수 있습니다. 문제를 확인할 때는 “조회 결과가 없음”과 “결과는 있지만 연결되지 않음”을 구분하세요. 두 경우에 확인할 설정은 서로 다릅니다.

시스템 DNS / 사용자 지정 DNS: 시스템 DNS는 일반적으로 현재 네트워크에서 제공하는 조회 설정을 사용하며, 사용자 지정 DNS는 사용자가 직접 설정한 리졸버를 사용합니다. 실제 조회 경로는 설정 파일, 도메인 규칙, 네트워크 환경의 영향도 받을 수 있으므로 입력한 주소만 보고 판단하지 마세요. 리졸버를 바꾼 뒤에는 같은 대상을 다시 테스트하고 이전 결과가 캐시에 남아 사용되는지도 고려하세요.

DNS over HTTPS: HTTPS를 통해 DNS 쿼리를 전송하는 방식으로, DoH라고 줄여 부르기도 합니다. 이는 조회 요청의 전송 방식을 바꾸는 것이지 프록시 프로토콜이 아닙니다. 리졸버 엔드포인트 자체에 연결할 수 있어야 하며 엔드포인트 도메인의 조회와 연결 경로도 올바르게 설정되어야 합니다. DNS over HTTPS로 바꿔도 서버 인증, 규칙 선택, 대상 웹사이트 문제까지 자동으로 해결되지는 않습니다.

지연 시간 / 시간 초과: 지연 시간은 특정 테스트에서 응답을 기다린 시간이며, 의미는 테스트 방식에 따라 다릅니다. 시간 초과는 제한 시간 안에 예상한 응답을 받지 못했다는 뜻입니다. 지연 시간이 낮다고 지속 전송 속도가 빠르거나 모든 대상에 접근할 수 있는 것은 아닙니다. 테스트 방식, 네트워크, 대상을 동일하게 유지해야 결과를 비교할 수 있습니다. 조건이 다르면 수치를 직접 비교하기 어렵습니다.

TCP / UDP: 자주 쓰이는 두 가지 전송 계층 프로토콜입니다. TCP는 순서가 보장되는 신뢰성 있는 바이트 스트림을 제공하고, UDP는 데이터그램을 전달하며 신뢰성은 상위 프로토콜에서 구현할 수 있습니다. TCP 테스트에 성공해도 같은 네트워크에서 UDP 통신이 가능하다는 뜻은 아닙니다. 특히 QUIC 등의 전송을 사용할 때는 두 방식을 구분해야 합니다. 문제를 확인하기 전에 현재 프로토콜이 어떤 하위 통신 방식에 의존하는지 확인하고 그에 맞는 대상을 테스트하세요.

문제 해결 가이드 보기 → 자주 묻는 질문 보기 → 범주 목록으로 돌아가기 ↑