공식 매뉴얼 / 용어 찾아보기

Shadowrocket
용어 가이드

먼저 용어가 표시된 위치를 확인한 다음 의미를 파악하세요. 인터페이스 모드, 구성의 정책, 서버 프로토콜은 서로 다른 단계의 개념이므로 서로 바꿔 쓸 수 없습니다.

용어 32개 분류 5개 영문 원문 대조

01 / Interface

인터페이스 및 설정

먼저 설정이 표시된 페이지를 확인하세요. 같은 용어라도 메뉴 이름과 라우팅 모드에서 서로 다른 기능을 가리킬 수 있습니다.

Home

추가한 서버나 구독 그룹 등의 연결 항목을 확인하고 선택하는 메뉴입니다. 목록에 항목이 표시된다는 것은 정보가 저장되었다는 뜻일 뿐, 인증이 유효하거나 원격 서버에 연결할 수 있다는 의미는 아닙니다. 연결하기 전에 선택 항목과 Global Routing 모드도 확인하세요.

Global Routing

전체 라우팅 방식을 정하는 설정입니다. 세 가지 모드는 Config, Proxy, Direct입니다. 규칙에 따라 트래픽을 분기하려면 일반적으로 Config를 선택합니다. 문제를 확인할 때는 모드를 바꿔 비교해 볼 수 있지만, 모드를 변경해도 유효하지 않은 서버 정보가 복구되지는 않습니다.

Config

구성 관리 메뉴에서는 구성 파일과 관련 작업을 가리킵니다. Global Routing에서는 현재 구성에 따라 요청을 처리하는 모드를 뜻합니다. 구성을 가져온 후에는 현재 활성화된 파일이 무엇인지 확인하세요. 파일이 목록에 있다는 이유만으로 규칙이 적용 중이라고 단정할 수 없습니다.

Proxy

Global Routing의 프록시 모드입니다. 일반적으로 앱이 처리하는 요청을 선택한 프록시 경로로 보냅니다. 규칙 분기가 문제의 원인인지 비교할 때 사용할 수 있지만, 구성에 있는 대문자 정책 PROXY와는 다른 개념입니다. 선택한 서버를 사용할 수 없으면 Proxy 모드에서도 연결되지 않을 수 있습니다.

Direct

Global Routing의 직접 연결 모드입니다. 선택한 프록시 서버를 거치지 않고 요청을 보냅니다. 현재 네트워크의 기본 연결 상태를 확인할 때 비교 기준으로 활용할 수 있지만, 결과는 로컬 네트워크, DNS, 대상 서비스 상태에도 영향을 받습니다. 이 결과만으로 서버 구성이 올바른지 판단할 수는 없습니다.

On Demand

설정된 조건에 따라 VPN 연결을 시작하는 기능이며, 구체적인 동작은 앱 옵션과 시스템 상태에 따라 달라집니다. 구독을 자동 업데이트하거나 만료된 인증 정보를 교체하는 기능은 아닙니다. 연결을 끊어도 다시 자동으로 연결된다면 먼저 이 설정과 시스템의 VPN 설정을 확인하세요.

Add Server

서버 정보를 추가하는 메뉴입니다. 먼저 올바른 프로토콜을 선택한 다음 주소, 포트, 인증 항목을 확인하세요. 모든 값은 사용자가 보유한 서버 정보를 기준으로 입력해야 합니다. 프로토콜 이름만 보고 나머지 매개변수를 추측하면 연결되지 않을 수 있으며, 저장한 뒤에도 실제 접속 여부를 확인해야 합니다.

프로토콜 / 연결 매개변수

프로토콜

프로토콜 이름은 통신 방식의 일부만 설명합니다. 주소, 인증, 전송 및 보안 매개변수가 서버 설정과 일치해야 합니다.

Shadowsocks

프록시 프로토콜의 하나로, 일반적으로 서버 주소, 포트, 암호화 방식, 비밀번호를 설정해야 합니다. 클라이언트와 서버의 암호화 방식이 일치해야 하며, 추가 매개변수도 원본 정보를 기준으로 입력해야 합니다. 가져오기에 성공해도 정보가 읽혔다는 뜻일 뿐, 인증이나 연결 테스트를 대신하지는 않습니다.

VMess

인증을 사용하는 프록시 프로토콜로, 설정에 사용자 식별 정보와 전송 관련 옵션이 포함되는 경우가 많습니다. 문제를 확인할 때는 식별 정보, 주소, 포트, 전송 매개변수를 각각 점검하세요. 기기의 시스템 시간이 크게 어긋나도 인증에 영향을 줄 수 있으므로 서버 주소만 반복해서 바꾸지 마세요.

VLESS

프록시 프로토콜의 하나로, 이름만으로는 전송 방식과 보안 설정을 모두 알 수 없습니다. 서버에서 제공한 전체 매개변수를 사용하고, 같은 VLESS라고 해서 서로 다른 연결의 항목을 바꿔 쓰지 마세요. TLS 등의 옵션을 사용하는 경우 관련 이름과 검증 조건도 확인해야 합니다.

Trojan

일반적으로 TLS와 함께 사용하는 프록시 프로토콜입니다. 설정할 때 비밀번호, 서버 주소, 인증서 검증에 필요한 이름을 확인해야 합니다. 주소에 연결할 수 있다고 해서 TLS 검증이나 비밀번호 인증까지 통과한 것은 아닙니다. 연결 오류가 발생해도 인증서 검증은 끄지 말고 이름, 인증서 상태, 원본 매개변수부터 확인하세요.

Hysteria2

QUIC 기반 프록시 프로토콜입니다. 연결하려면 인증 정보와 TLS 설정을 확인하고 현재 네트워크가 UDP를 지원하는지 살펴봐야 합니다. 다른 유형의 연결이 된다고 해서 이 프로토콜도 사용할 수 있다고 단정할 수 없습니다. 네트워크를 바꿔 비교하면 전송 제한과 서버 설정 오류를 구분하는 데 도움이 됩니다.

WireGuard

키 기반 터널 프로토콜입니다. 설정에는 키, 인터페이스 주소, 피어 엔드포인트, 라우팅 범위가 포함되는 경우가 많습니다. 비밀번호 기반 프록시와 필드 구성이 다르므로 전체 설정을 기준으로 확인하세요. 개인 키는 민감한 정보이므로 로그나 스크린샷을 공유하기 전에 관련 내용을 삭제해야 합니다.

HTTP / SOCKS5

서로 다른 두 가지 프록시 프로토콜이므로 주소나 포트가 같더라도 혼용할 수 없습니다. 추가할 때 서버 유형, 인증 방식, 해당 전송 방식의 지원 여부를 확인하세요. 프로토콜 이름만으로 연결이 암호화된다고 볼 수 없으며, 보안 특성은 실제 연결 방식에 따라 판단해야 합니다.

03 / Match → Policy

규칙 키워드 및 정책

왼쪽 키워드는 매칭 조건을, 마지막 정책은 처리 방식을 나타냅니다. 일반적으로 먼저 일치한 규칙의 정책이 적용됩니다.

규칙 읽는 순서

DOMAIN-SUFFIX,example.com,PROXY

DOMAIN-SUFFIX는 조건 유형, example.com은 일치 대상의 예시, PROXY는 처리 방식입니다. 문법을 설명하기 위한 예시이며 전체 구성이나 서버 정보가 아닙니다.

DOMAIN

전체 도메인 이름으로 일치 여부를 판단하는 규칙 키워드입니다. 예를 들어 example.com을 지정해도 모든 하위 도메인이 자동으로 포함되지는 않습니다. 특정 호스트를 정확히 처리하려면 이 조건을 사용할 수 있습니다. 실제 요청이 다른 하위 도메인에서 발생한다면 로그에 표시된 전체 이름을 확인하세요.

DOMAIN-SUFFIX

도메인 접미사로 일치 여부를 판단하는 규칙 키워드입니다. 지정한 도메인과 하위 도메인을 함께 적용할 수 있습니다. DOMAIN보다 범위가 넓지만, 임의의 문자열이 포함되는지 확인하는 조건은 아닙니다. 정책을 설정하기 전에 적용 범위를 확인해 서로 다른 정책을 적용해야 할 하위 도메인까지 함께 처리되지 않도록 하세요.

IP-CIDR

IPv4 대역으로 일치 여부를 판단합니다. 주소 뒤 슬래시의 숫자는 접두사 길이를 나타냅니다. 예를 들어 192.168.0.0/16은 하나의 주소 대역을 뜻합니다. 도메인 문자열이 아닌 IP 주소에 적용됩니다. IPv6 주소에는 해당하는 IP-CIDR6을 사용해야 하며, IPv4 대역 규칙을 그대로 적용할 수 없습니다.

GEOIP

IP 지리 데이터베이스의 정보를 기준으로 일치 여부를 판단합니다. 예를 들어 GEOIP,CN,DIRECT와 같이 사용할 수 있습니다. 데이터베이스에 기록된 지역은 사용자의 위치, 페이지에 표시되는 텍스트, 서비스 운영 주체의 소재지와 같지 않습니다. 예상과 다른 결과가 나오면 페이지 내용만 보지 말고 대상 IP와 데이터베이스 정보를 확인하세요.

FINAL

앞선 규칙과 일치하지 않는 요청에 지정한 기본 정책을 적용합니다. 보통 규칙 목록의 맨 아래에 둡니다. FINAL,PROXY는 나머지 요청에 PROXY를 적용한다는 뜻입니다. 앞선 규칙과 이미 일치한 요청은 FINAL을 수정해도 경로가 바뀌지 않습니다.

PROXY

규칙에서 사용하는 프록시 정책으로, 조건에 일치한 요청을 프록시 경로로 보냅니다. 프로토콜 이름이 아니며 특정 서버 항목에 자동으로 연결되는 것도 아닙니다. 요청이 실제로 어디로 향하는지 확인하려면 현재 선택한 서버, 구성의 정책 설정, 연결 로그를 함께 살펴보세요.

DIRECT

규칙에서 사용하는 직접 연결 정책으로, 조건에 일치한 요청을 선택한 프록시 서버를 거치지 않고 보냅니다. 대문자 DIRECT는 개별 규칙의 동작을 뜻하며 Global Routing의 Direct 모드와는 다른 단계입니다. 직접 연결도 DNS 및 현재 네트워크 상태에 영향을 받을 수 있습니다.

REJECT

규칙에서 사용하는 거부 정책으로, 조건에 일치한 요청을 차단합니다. 매칭 범위가 지나치게 넓으면 로그인, 이미지 로딩 또는 다른 정상 기능에 영향을 줄 수 있습니다. 문제를 확인할 때는 차단된 요청과 일치한 규칙부터 살펴보고 조건의 범위를 좁히세요. 모든 규칙을 바로 삭제하는 방식은 피해야 합니다.

DNS

도메인 이름을 IP 주소로 변환하는 시스템으로, 도메인 접속 과정의 한 단계입니다. 이름 확인에 성공해도 이후 연결까지 성공한다는 뜻은 아니며, 연결 시간 초과가 반드시 DNS 문제를 의미하지도 않습니다. 문제를 확인할 때는 이름 확인 오류, 주소 연결 실패, TLS 검증 실패, 앱 계층의 응답 오류를 구분하세요.

Subscription / Configuration

구독 및 구성

구독은 서버 정보를 관리하고, 구성은 요청 처리 방식을 정합니다. 한 종류의 정보를 가져왔다고 해서 다른 종류도 설정된 것은 아닙니다.

링크를 통해 여러 서버 정보를 가져오고 업데이트하는 방식입니다. 링크는 사용자가 이용 중인 서비스 제공업체에서 받아야 합니다. 구독 링크에 접속 인증 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요. 업데이트 성공은 정보를 가져왔다는 뜻일 뿐, 그룹의 모든 서버를 정상적으로 사용할 수 있다는 의미는 아닙니다.

서버

클라이언트가 연결하는 원격 엔드포인트입니다. 일반적으로 서버 항목에는 프로토콜, 주소, 포트, 인증 정보가 포함되며, 노드라고도 합니다. 구독으로 여러 서버 항목을 관리할 수 있지만 이름은 식별용일 뿐입니다. 연결이 올바른지 확인하려면 이름만 보지 말고 설정 항목과 실제 접속을 점검하세요.

규칙

매칭 조건과 처리 정책을 조합한 구성 항목입니다. 일반적으로 위에서 아래로 확인하며 조건에 일치하면 해당 동작을 적용합니다. 보통 더 구체적인 조건을 범위가 넓은 조건보다 앞에 배치해야 합니다. 규칙 적용 여부는 Config가 선택되어 있는지, 어떤 구성 파일이 활성화되어 있는지에도 달려 있습니다.

URL Rewrite

조건에 따라 URL 요청을 다시 쓰거나 리디렉션하는 구성 기능입니다. 프록시 경로를 선택하는 라우팅 규칙과는 다릅니다. 처리할 수 있는 내용은 요청 유형과 관련 설정에 따라 달라지며, 암호화된 요청을 모두 직접 수정할 수 있는 것은 아닙니다. 사용하기 전에 출처와 매칭 범위를 확인하세요.

05 / Permission & Account

시스템 권한 및 계정

시스템 승인, 구매 자격, 앱 내 구성은 서로 별개의 항목입니다. 하나를 복원해도 나머지가 자동으로 복원되지는 않습니다.

VPN 구성

Apple 시스템에서 앱의 네트워크 터널을 관리하는 구성입니다. 처음 연결할 때 구성 추가를 허용할지 묻는 안내가 표시될 수 있습니다. 승인하면 앱이 해당 네트워크 통로를 만들 수 있지만 서버를 사용할 수 있는지 검증되는 것은 아닙니다. 거부하거나 삭제한 경우 앱 안내에 따라 다시 연결을 시도하고 시스템 설정을 확인하세요.

Apple 계정

App Store 구매 내역과 연결된 계정입니다. 앱을 복원하려면 미디어 및 구입 항목에서 사용 중인 계정을 확인하세요. 현재 iCloud에 로그인한 계정과 다를 수 있습니다. 구매 내역이 표시되지 않으면 먼저 원래 구매한 계정과 스토어 상태를 확인하고 구독 인증과 혼동하지 마세요.

구입 항목

App Store에서 구매 내역을 확인하고 앱을 다시 받을 수 있는 메뉴입니다. 표시되는 이름은 시스템 인터페이스에 따라 달라질 수 있습니다. 앱을 다시 받아도 서버 정보가 모두 복원되는 것은 아닙니다. 기기 호환성, 시스템 요구 사항, 구매 적용 범위는 App Store 페이지의 안내를 기준으로 확인하세요.

iCloud 동기화

iCloud를 통해 앱에서 지원하는 데이터를 기기 간에 동기화하는 기능입니다. 동기화 범위는 앱 옵션과 시스템 설정에 따라 달라지며, 모든 구성과 인증 정보의 완전한 백업을 뜻하지는 않습니다. 기기를 변경하기 전에 동기화 항목을 확인하고, 앱을 복원한 뒤에도 구성, 서버 선택, 시스템 승인을 다시 확인하세요.

현재 문제에 맞는 다음 안내

용어 설명은 의미를 이해하는 데 도움이 되지만, 실제 조작은 순서대로 확인해야 합니다. 연결 오류가 발생하면 단순히 ‘작동하지 않음’이라고 기록하기보다 발생한 페이지, 선택한 모드, 구체적인 안내 문구를 함께 기록하면 원인을 찾기 쉽습니다.

Shadowrocket은 Apple 플랫폼 전용 유료 앱이며, App Store에서만 받을 수 있습니다. 이 사이트는 Shadowrocket 공식 웹사이트이자 공식 매뉴얼입니다. 앱 구매와 사용자가 보유한 구독 또는 서버 정보는 각각 별도로 확인해야 합니다.