공식 매뉴얼 · 용어 정리

Shadowrocket
인터페이스 및 규칙 용어

먼저 이름을 확인하고, 그 용어가 어느 단계에서 쓰이는지 살펴보세요. 여기서는 다섯 가지 범주로 인터페이스 메뉴, 프로토콜 매개변수, 규칙 동작을 설명합니다. 영어 명칭은 그대로 두고 용도만 한국어로 안내하며, 앱에 표시되는 항목 이름을 대체하지 않습니다.

사용을 시작하려면 사용 안내를 참고하세요. 기존 구독을 정리하려면 구독 매뉴얼을 확인하세요.

INTERFACE / CONTROLS

인터페이스 및 스위치

먼저 Global Routing에서 선택한 항목을 확인한 뒤 개별 규칙을 살펴보세요. 연결 스위치, 라우팅 모드, 자동 실행 조건은 각각 다른 기능이며 서로 대신할 수 없습니다.

Global Routing: 연결의 전반적인 처리 방식을 정하는 메뉴입니다. 일반적으로 Config, Proxy, Direct 중에서 선택하며, 각각 설정에 따른 처리, 프록시 처리, 직접 연결을 뜻합니다. 규칙이 적용되지 않는다면 먼저 여기서 Config를 선택했는지 확인한 뒤 설정 내용을 살펴보세요. 모드에 따라 같은 규칙도 현재 연결 처리에 적용되지 않을 수 있습니다.

Config: Global Routing에서 Config는 현재 선택한 설정에 따라 연결을 처리한다는 뜻입니다. 일반적으로 규칙에 따라 대상별 연결 경로가 결정됩니다. 인터페이스 메뉴의 Config는 설정 파일을 관리하고 선택하는 기능을 가리킵니다. 이 용어가 보이면 위치를 확인하고, 어디서나 같은 스위치라고 생각하지 마세요.

Proxy: Global Routing의 Proxy는 연결을 프록시로 처리합니다. 프록시 경로가 작동하는지 임시로 확인할 때 사용할 수 있습니다. 이 모드로 바꿔도 서버 비밀번호 오류, TLS 매개변수 오류, 만료된 인증 정보가 해결되지는 않습니다. 규칙에 쓰이는 대문자 PROXY와는 적용 단계가 다릅니다.

Direct: Global Routing의 Direct는 대상에 직접 연결합니다. 로컬 네트워크와 프록시 경로의 동작을 비교할 때 사용할 수 있습니다. 이 모드를 선택해도 기존 구독이 삭제되거나 시스템의 VPN 설정이 제거되지는 않습니다. 테스트가 끝나면 필요한 모드로 되돌려 임시 테스트 상태가 일상 설정으로 남지 않도록 하세요.

On Demand: 설정한 네트워크 조건에 따라 연결 동작을 실행하며, 결과는 조건과 현재 시스템 상태에 따라 달라집니다. 설정 전에 어떤 네트워크 환경에서 실행할지 정하고 조건을 하나씩 확인하세요. 이는 트래픽 분기 규칙이 아닙니다. 연결 상태가 저절로 바뀐다면 서버 목록만 확인하지 말고 On Demand 조건과 수동 스위치도 함께 살펴보세요.

Data: 트래픽 통계와 연결 정보를 확인하는 메뉴입니다. 요청이 발생했는지, 트래픽이 계속 증가하는지 확인하는 데 참고할 수 있습니다. 앱과 서버의 집계 기준이나 통계 기간이 다를 수 있으므로 표시된 수치를 잔여 데이터로 단정하지 마세요. 수치를 비교하기 전에 통계 범위와 초기화 시점, 관찰 중인 연결을 확인하세요.

PROTOCOLS

프록시 프로토콜

프로토콜은 클라이언트와 서버가 데이터를 주고받는 방식을 정합니다. 아래 설명은 이미 보유한 서버 정보를 확인하기 위한 참고입니다. 연결을 시도하려고 프로토콜을 임의로 바꾸지 마세요.

Shadowsocks: 일반적인 프록시 프로토콜로 서버 주소, 포트, 비밀번호, 암호화 방식 등을 입력합니다. 기존 서버에서 제공한 정보를 항목별로 확인하세요. 비밀번호가 맞더라도 다른 매개변수가 잘못됐을 수 있습니다. 암호화 방식이 일치하지 않으면 지연 시간 테스트나 실제 요청이 실패할 수 있습니다.

VMess: 사용자 식별자 등의 값으로 인증하는 프록시 프로토콜입니다. 전송 방식과 TLS 설정도 연결에 영향을 줍니다. 가져온 뒤에는 서버 이름만 볼 것이 아니라 사용자 식별자, 전송 유형, 서버가 요구하는 추가 매개변수를 확인하세요. 정확한 시간이 인증에 필요한 경우 기기의 날짜와 시간 설정도 살펴보세요.

VLESS: 사용자 식별자와 해당 전송 설정이 필요한 프록시 프로토콜입니다. 프로토콜 이름만으로 전송 암호화가 활성화됐다고 볼 수 없습니다. 연결을 설정하려면 서버가 요구하는 TLS, 전송 방식, 기타 매개변수가 모두 일치해야 합니다. VMess 항목의 유형만 바꾸면 VLESS 설정으로 사용할 수 있다고 생각하지 마세요.

Trojan: 일반적으로 TLS와 함께 사용하는 프록시 프로토콜입니다. 인증 비밀번호, 서버 이름, 인증서 검증 설정이 서로 일치해야 합니다. 인증서 오류가 발생하면 검증을 바로 끄지 말고 주소와 이름, 기기 시간을 먼저 확인하세요. 서버에 연결할 수 있다는 사실만으로 TLS와 인증까지 완료됐다고 볼 수는 없습니다.

Hysteria2: QUIC 기반 프록시 프로토콜입니다. 연결 시 인증 정보와 TLS 매개변수, 현재 네트워크의 UDP 연결 가능 여부를 확인해야 합니다. 특정 네트워크에서 실패했다고 구독 항목이 만료된 것은 아닙니다. 네트워크 경로 조건이 원인일 수도 있습니다. 이 프로토콜을 이전 버전과 같은 의미로 취급하지 말고 기존 서버의 실제 유형에 맞춰 가져오세요.

WireGuard: 키 쌍과 터널 주소를 사용하는 네트워크 터널 프로토콜입니다. 주요 설정 항목은 로컬 주소, 피어, 공개 키, 엔드포인트, 허용 네트워크입니다. 사용자 이름이나 비밀번호를 쓰는 항목과 필드 구성이 다르므로 그대로 적용하지 마세요. 개인 키는 민감한 정보입니다. 설정을 정리하거나 백업하고 화면을 캡처해 도움을 요청할 때 안전하게 보호하세요.

HTTP / SOCKS5: 서버 주소와 포트, 선택적 인증 정보가 필요한 서로 다른 두 프록시 프로토콜입니다. 특정 전송을 지원하는지, 암호화를 사용하는지는 프로토콜 옵션과 서버 기능을 함께 확인해야 합니다. 항목 이름만으로 모든 트래픽이 암호화된다고 판단하거나 두 유형을 서로 바꿔 쓸 수 있다고 생각하지 마세요.

RULE ENGINE

규칙 키워드

규칙은 일반적으로 매칭 조건과 처리 동작으로 구성되며, 설정에 지정된 순서대로 확인됩니다. 먼저 무엇을 매칭하는지, 다음으로 어떻게 처리하는지 확인하고, 앞선 규칙에 이미 매칭되는지도 살펴보세요.

DOMAIN-SUFFIX: 도메인 접미사로 대상 도메인과 하위 도메인을 매칭합니다. 예를 들어 example.com과 그 하위 도메인이 해당됩니다. 문자열이 어디에든 포함되는지 확인하는 방식은 아닙니다. 특정 도메인 하나만 정확히 매칭하려면 DOMAIN의 용도를 구분하세요. 설정에는 경로나 쿼리 매개변수가 포함된 전체 URL이 아니라 도메인을 입력해야 합니다.

GEOIP: IP 지리 데이터베이스를 기준으로 대상 IP를 분류해 매칭하며, 결과는 데이터베이스의 내용과 업데이트 상태에 따라 달라집니다. 서버의 실제 위치가 정확히 확인됐다는 뜻도, 지연 시간이나 대역폭을 측정한다는 뜻도 아닙니다. 도메인이 최종적으로 어떤 IP로 해석되는지에 따라 이 규칙의 매칭 여부가 달라질 수 있습니다.

IP-CIDR: CIDR 표기법으로 IPv4 네트워크 대역을 매칭합니다. 예를 들어 192.0.2.0/24는 문서용 예시 주소 대역입니다. 슬래시 뒤 숫자는 네트워크 범위를 정하며 서버 포트가 아닙니다. IPv6 대역에는 IP-CIDR6를 확인하세요. 범위를 바꾸기 전에 관계없는 대상까지 함께 매칭되지 않는지 살펴보세요.

FINAL: 앞선 규칙에 매칭되지 않은 연결을 처리하며, 일반적으로 규칙 목록의 마지막에 둡니다. 이는 기본 매칭이지 ‘우선 실행’ 표시가 아닙니다. 위치가 잘못되면 뒤에 있는 규칙이 매칭되지 않을 수 있습니다. 특정 대상이 프록시나 직접 연결로 처리되는 이유를 확인할 때는 해당 규칙과 FINAL의 동작을 함께 살펴보세요.

PROXY: 규칙에서 연결을 프록시 경로로 처리하는 동작입니다. 실제로 어떤 출구를 사용할지는 현재 선택과 설정된 정책을 확인해야 하며, 규칙 한 줄만으로 단정할 수 없습니다. Global Routing에서 대문자 P로 시작하는 Proxy 모드와 구분하세요.

DIRECT: 규칙에 매칭된 대상에 현재 네트워크로 직접 접속하는 동작입니다. DIRECT를 선택해도 대상에 반드시 연결되는 것은 아닙니다. DNS, 현지 네트워크 경로, 대상 서비스 상태가 결과에 영향을 줍니다. 직접 연결해야 할 대상이 프록시를 사용한다면 앞쪽의 더 광범위한 규칙에 먼저 매칭됐는지 확인하세요.

REJECT: 규칙에 매칭된 연결을 거부해 지정한 대상에 접근하지 못하게 하는 동작입니다. 특정 앱의 일부 기능만 작동하지 않는다면 관련 도메인이나 IP가 이 규칙에 잘못 매칭됐는지 살펴보세요. 확인할 때는 필요한 범위만 조정하고 원래 설정을 보존하세요. 한 대상을 점검하려고 전체 동작을 크게 바꾸지 마세요.

RULE-SET: 규칙 모음을 참조해 여러 매칭 조건을 별도로 관리하는 데 사용합니다. 참조 위치도 규칙 순서에 포함되므로 모음을 앞이나 뒤에 두는지에 따라 결과가 달라질 수 있습니다. 모음을 업데이트한 뒤 내용이 제대로 불러와졌는지 확인하고, 규칙 모음 업데이트와 서버 구독 업데이트를 구분하세요.

프록시 모드와 규칙별 트래픽 분기 자세히 보기 →

SUBSCRIBE / CONFIGURATION

구독 및 설정

아래 안내는 본인에게 기존 구독이나 서버 정보가 있는 경우를 전제로 합니다. Shadowrocket Hub는 Shadowrocket 공식 웹사이트 및 공식 매뉴얼이며, 노드나 구독 서비스를 제공하거나 판매하거나 추천하지 않습니다.

Add Server: 서버를 직접 추가하는 메뉴입니다. 보유한 정보에 따라 프로토콜을 선택하고 주소, 포트, 인증 정보를 입력해야 합니다. 프로토콜마다 표시되는 항목이 다를 수 있으므로 이름이 비슷하다고 관계없는 매개변수를 입력하지 마세요. 저장은 설정을 기록하는 단계일 뿐이므로 항목을 선택한 뒤 연결을 확인해야 합니다.

구독: 서버 정보와 이후 업데이트를 받을 수 있는 주소 또는 데이터입니다. 내용은 관리 과정에서 바뀔 수 있습니다. 구독 링크에는 접근 인증 정보가 포함되는 경우가 있으므로 비밀번호처럼 안전하게 보관하고 공개 화면 캡처나 웹사이트 파일에 넣지 마세요. 업데이트에 실패하면 모든 항목을 반복해서 삭제하기보다 링크 유효성, 네트워크 연결, 응답 형식을 차례로 확인하세요.

설정 파일: 규칙, DNS 및 관련 정책 설정을 담는 파일이며 서버 정보만 포함하는 구독과 용도가 다릅니다. 서버를 가져와도 현재 규칙이 바뀌지 않을 수 있고, 설정을 전환해도 기존 구독 그룹이 바뀌지 않을 수 있습니다. 수정 전에 복구할 수 있는 사본을 보관하고, 원인을 파악하기 쉽도록 한 번에 한 종류의 설정만 변경하세요.

구입 항목: App Store에서 이전에 구입한 앱 기록을 확인할 수 있습니다. 기기를 바꾸거나 앱을 다시 설치할 때는 구입에 사용한 Apple ID부터 확인하세요. 앱을 다시 받더라도 로컬 서버, 규칙, 기타 설정이 복원되는 것은 아니므로 백업을 별도로 확인해야 합니다. 기기 호환성, 시스템 요구 사항, 통합 구입 여부는 App Store 페이지의 안내를 기준으로 확인하세요.

가져오기, 업데이트, 백업 전체 절차 확인 →

NETWORK / DIAGNOSTICS

네트워크 및 DNS

테스트 결과는 문제를 판단하는 여러 근거 중 하나입니다. 도메인 해석, 네트워크 경로, 인증, 실제 접속을 나눠 확인하면 설정을 반복해서 바꾸는 것보다 문제를 찾기 쉽습니다.

DNS: 도메인을 IP 등의 레코드로 변환하는 시스템으로, 다양한 네트워크 연결을 시작하기 전에 필요한 단계입니다. 해석에 성공해도 대상 서비스에 연결된다는 보장은 없고, 해석 실패가 반드시 프록시 인증 오류를 뜻하는 것도 아닙니다. 문제를 확인할 때 먼저 대상 도메인이 정상적인 결과를 반환하는지 살펴본 뒤 라우팅과 서버 연결을 확인하세요. 서로 다른 단계를 혼동하지 않는 것이 중요합니다.

DNS over HTTPS: HTTPS로 DNS 쿼리를 전송하는 방식이며, 보통 DoH라고 줄여 씁니다. 바뀌는 것은 DNS 요청의 전송 방식입니다. 규칙에 따른 트래픽 분기를 대신하거나 서버 인증 정보를 보완하지 않습니다. 설정 후에는 DNS 서비스 연결, 대상 도메인 해석, 실제 연결 결과를 각각 확인하세요.

Connectivity Test: 선택한 테스트 방식으로 연결 가능 여부를 확인합니다. 결과는 해당 시점의 네트워크와 테스트 대상에 대한 상태를 보여 줍니다. 테스트를 통과해도 모든 웹사이트나 앱에 접속할 수 있다는 뜻은 아니며, 시간 초과도 테스트 방식과 대상을 고려해 판단해야 합니다. 서버를 비교할 때는 같은 조건으로 테스트한 뒤 실제 요청으로 다시 확인하세요.

지연 시간: 특정 테스트 요청에 응답하기까지 걸리는 시간으로, 보통 밀리초 단위로 표시됩니다. 수치가 낮아도 처리량이 높다고 볼 수 없으며 연결이 장시간 안정적이라는 뜻도 아닙니다. 패킷 손실, 경로 변화, 대상 서버 부하도 사용 경험에 영향을 줍니다. 정렬 결과는 초기 비교에만 활용하고 같은 네트워크 환경에서 실제 접속을 확인하세요.

용어를 확인할 때 순서

먼저 해당 용어가 인터페이스 메뉴, 프로토콜 매개변수, 규칙 중 어디에 해당하는지 확인하고 현재 작업 위치를 살펴보세요. 구체적인 문제를 해결하려면 사용 안내에 따라 연결을 확인하세요. 여러 구독을 정리하거나 업데이트 또는 삭제할 때는 구독 매뉴얼에서 항목별 절차를 확인하세요.

범주 목록 맨 위로 ↑