공식 매뉴얼 / 용어집

Shadowrocket 용어집
인터페이스, 프로토콜, 규칙 키워드

먼저 설정이 어느 단계에 속하는지 파악한 다음 변경할 항목을 확인하세요. 이 페이지는 인터페이스의 영문 용어를 유지하면서 용도, 적용 조건, 혼동하기 쉬운 차이를 설명합니다. 범주별로 이동하거나 각 용어의 앵커 링크를 바로 사용할 수 있습니다.

인터페이스 원문 프로토콜 매개변수 규칙 문법

처음 연결을 설정한다면 사용 가이드를 읽어 보세요. 설정은 있지만 연결에 문제가 있다면 문제 해결 매뉴얼을 참고하세요. 아래 서버 및 구독 안내는 사용자가 이미 자신의 구독 또는 서버 정보를 보유하고 있다는 전제하에 작성되었습니다.

인터페이스와 스위치

연결 메뉴와 라우팅 모드

연결 스위치는 연결을 설정하고, Global Routing은 요청 처리 방식을 결정합니다. 스위치가 켜져 있는지, 서버가 선택되었는지, 규칙이 적용되었는지는 각각 확인해야 합니다.

Home: Home은 연결 스위치, 저장된 서버, 현재 선택 항목을 확인하는 주요 화면입니다. 목록에 서버가 보인다는 것은 항목이 저장되었다는 뜻일 뿐, 인증이 완료되었거나 연결이 설정되었다는 의미는 아닙니다. 처음 사용할 때는 선택된 항목을 확인한 뒤 연결 스위치를 조작하고 실제 요청으로 결과를 검증하세요.

Global Routing: Global Routing에서는 전체 라우팅 방식을 선택합니다. Config, Proxy, Direct는 각각 구성, 프록시, 직접 연결에 해당합니다. Config는 현재 구성의 규칙에 따라 요청을 처리하고, Proxy는 프록시를 통해 처리하며, Direct는 직접 연결합니다. 특정 웹사이트의 규칙 매칭 결과를 확인하려면 먼저 현재 모드를 기록하세요. 그렇지 않으면 규칙을 수정해도 예상한 변화가 나타나지 않을 수 있습니다.

On Demand: On Demand는 설정된 네트워크 또는 접근 조건에 따라 연결을 시작합니다. 작동하지 않는 서버를 클라이언트가 자동으로 복구하는 기능은 아닙니다. 활성화하기 전에 수동 연결을 먼저 확인하고 트리거 조건을 하나씩 추가하세요. 스위치를 껐는데도 다시 연결된다면 On Demand 조건이 여전히 충족되는지 확인하세요.

Add Server: Add Server는 기존 서버 매개변수를 직접 입력하는 메뉴입니다. 먼저 프로토콜을 선택하고 원본 정보에 따라 주소, 포트, 인증 매개변수를 입력하세요. TLS와 전송 방식 등의 추가 항목도 서버와 일치해야 합니다. 이름은 항목을 구분하기 위한 것으로 실제 서버 주소를 대신하지 않습니다.

Connectivity Test: Connectivity Test는 지정된 테스트 조건에서 연결 가능 여부와 응답 시간을 확인합니다. 테스트에 성공했다는 것은 해당 탐색 요청에 응답이 있었다는 뜻이지, 모든 웹사이트, UDP 요청, 대용량 파일 전송이 정상 작동한다는 의미는 아닙니다. 결과와 실제 접속이 다르면 테스트 방식, 대상 주소, 연결 기록을 함께 살펴보세요.

Settings: Settings에는 클라이언트 관련 설정이 모여 있습니다. 세부 항목은 현재 플랫폼과 앱 화면을 기준으로 확인하세요. 문제를 진단할 때는 기존 값을 먼저 기록하고 관련 옵션을 한 번에 하나씩 변경한 뒤 동일한 요청으로 다시 검증하세요. 서버의 프로토콜 매개변수와 클라이언트의 전역 설정을 혼동하지 마세요.

프로토콜

프로토콜 유형과 연결 매개변수

프로토콜 이름은 클라이언트와 서버의 통신 방식을 나타내며 연결 속도를 직접 의미하지 않습니다. 보유한 서버 정보를 기준으로 유형을 선택하세요. 목록에서 다른 항목을 선택하는 것만으로 프로토콜을 변환할 수는 없습니다.

Shadowsocks: Shadowsocks는 프록시 프로토콜로, 일반적인 매개변수에는 서버 주소, 포트, 비밀번호, 암호화 방식이 있습니다. 암호화 방식은 서버와 일치해야 하며 이름이 비슷하다는 이유로 다른 방식을 선택해서는 안 됩니다. 원본 정보에 플러그인이나 추가 전송 매개변수가 있다면 주소와 비밀번호뿐 아니라 해당 항목도 함께 확인하세요.

VMess: VMess는 사용자 ID 등의 정보로 인증하며 여러 전송 방식을 함께 사용할 수 있습니다. 가져온 뒤에는 서버 이름만 확인하지 말고 사용자 ID, 포트, 전송 유형, TLS 설정을 모두 확인하세요. 인증 오류가 발생하면 기기의 시간이 정확한지도 점검해야 합니다.

VLESS: VLESS는 사용자 ID를 사용해 인증하며 프로토콜 유형과 전송 계층 보안 설정은 별도로 이해해야 합니다. 사용자 ID를 올바르게 입력했더라도 TLS, 서버 이름, 전송 경로 등의 항목을 생략할 수는 없습니다. 연결에 실패하면 관련 없는 DNS 설정을 반복해서 바꾸기보다 기존 설정과 항목별로 대조하세요.

Trojan: Trojan은 일반적으로 TLS와 비밀번호 인증을 함께 사용합니다. 주소, 포트, 비밀번호, 서버 이름이 서로 일치해야 합니다. 인증서 검증 실패와 비밀번호 오류는 서로 다른 문제이므로 오류 기록을 확인하세요. 테스트를 통과시키려고 인증서 검사를 바로 건너뛰지 말고 도메인, 기기 시간, 서버 인증서 설정부터 확인하세요.

Hysteria2: Hysteria2는 QUIC 기반 프록시 프로토콜이며 UDP 연결 가능 여부가 작동에 영향을 줍니다. 서버 주소와 인증 정보 외에도 기존 설정을 기준으로 TLS와 관련 매개변수를 확인하세요. 한 네트워크에서는 연결되지 않다가 다른 네트워크에서 정상화된다면 UDP 전송 조건을 점검할 수 있지만, 현상만으로 원인을 단정해서는 안 됩니다.

WireGuard: WireGuard는 키 쌍으로 암호화 터널을 구성하며, 일반적인 설정에는 엔드포인트, 터널 주소, 라우팅 범위도 포함됩니다. 공개 키, 개인 키, 사전 공유 키는 각각 용도가 다르므로 서로 바꿔 입력하면 안 됩니다. 개인 키는 민감한 정보로 안전하게 보관하세요. 핸드셰이크 성공 여부와 대상 주소가 예상대로 라우팅되는지는 별도로 검증해야 합니다.

HTTP / SOCKS5: HTTP와 SOCKS5는 서로 다른 프록시 프로토콜이므로 같은 주소를 사용한다고 해서 임의로 바꿔 쓸 수는 없습니다. HTTP 프록시는 HTTP 프록시 요청과 CONNECT 등의 경우를 처리하며, SOCKS5는 연결을 설정할 때 자체 협상 방식을 사용합니다. 인증 요구 사항과 UDP 지원 여부는 서버 구현에도 영향을 받으므로 기존 서버 안내에 맞춰 설정하세요.

규칙 키워드

매칭 조건과 처리 정책

규칙의 앞부분은 ‘무엇을 매칭할지’, 정책 부분은 ‘어떻게 처리할지’를 지정합니다. 아래의 example.com 같은 주소는 문법 설명용이며 연결 가능한 서버 정보가 아닙니다.

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN은 전체 도메인을 매칭하고, DOMAIN-SUFFIX는 지정된 도메인과 하위 도메인을 매칭하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드를 매칭합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 매칭 범위의 요청을 PROXY로 전달합니다. 도메인 입력란에는 전체 URL을 쓰지 말고 프로토콜 접두사나 페이지 경로도 포함하지 마세요.

IP-CIDR / IP-CIDR6: IP-CIDR은 IPv4 주소 범위를 매칭하고 IP-CIDR6은 IPv6에 사용됩니다. 범위는 주소와 슬래시 뒤의 프리픽스 길이로 표시합니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT는 IPv4 네트워크 범위의 처리 방식을 나타냅니다. 이 규칙은 도메인 이름이 아니라 주소를 매칭하므로 실제 대상 IP를 확인해 매칭 결과를 점검하세요.

GEOIP: GEOIP는 IP 데이터베이스에 기록된 지역 정보를 기준으로 대상 주소를 매칭합니다. 예를 들면 GEOIP,CN,DIRECT와 같습니다. 데이터베이스 기록, DNS 응답 주소, 대상이 사용하는 콘텐츠 전송 네트워크에 따라 결과가 달라질 수 있습니다. 웹사이트 운영자의 소재지를 정확히 판별하는 용도가 아니며, 특정 도메인의 규칙을 직접 확인하는 절차를 대신할 수도 없습니다.

FINAL: FINAL은 앞선 규칙과 일치하는 항목이 없을 때 적용할 최종 정책을 지정하며, 일반적으로 규칙 목록의 마지막에 둡니다. 예를 들어 FINAL,PROXY는 나머지 요청을 PROXY로 전달합니다. 앞에 더 넓은 범위의 규칙이 이미 일치했다면 마지막에 FINAL을 적어도 요청의 정책을 다시 선택하지 않습니다.

PROXY / DIRECT / REJECT: 이 세 가지 대문자 키워드는 규칙의 처리 정책입니다. PROXY는 프록시로 전달, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 이들은 Global Routing의 Proxy, Direct 인터페이스 옵션과는 다른 단계입니다. REJECT 규칙이 적용되었다면 서버 시간 초과로 바로 판단하지 말고 해당 규칙의 용도를 확인하세요.

Rule: Rule은 매칭 조건과 처리 정책으로 구성된 규칙입니다. 일반적으로 설정 순서대로 확인하며 일치한 항목에 따라 요청을 처리합니다. 더 구체적인 예외 규칙은 이를 포괄하는 넓은 규칙보다 앞에 두세요. 수정한 뒤에는 저장하고 현재 Config를 확인한 다음 동일한 대상에 요청을 보내 매칭 결과를 점검하세요. 여러 항목을 한꺼번에 바꾸면 원인을 파악하기 어려워집니다.

구독과 설정

가져오기, 해석, 검증

서버 항목에는 연결 매개변수가 저장되고, 구독은 내용을 가져오거나 업데이트하며, Config에는 규칙 등의 설정이 포함됩니다. 가져오기에 성공해도 전체 과정이 완료된 것은 아니므로 선택 상태와 실제 접속을 확인해야 합니다.

SERVER: SERVER는 클라이언트가 연결하는 원격 서버 항목으로, 보통 프로토콜, 주소, 포트, 인증 정보가 포함됩니다. 한국어 설명에서 ‘노드’는 이러한 연결 항목을 가리키며 구독 자체를 뜻하지 않습니다. 항목 이름과 지역 표시는 구분을 위한 정보일 뿐이며 실제 연결 가능 여부는 매개변수와 테스트 결과를 기준으로 판단하세요.

Config: Config는 규칙, DNS 등의 설정을 저장하는 구성 파일을 뜻할 수도 있고, Global Routing에서 구성에 따라 요청을 처리하는 모드를 뜻할 수도 있습니다. 파일이 존재하는 상태, 파일이 선택된 상태, 전체 모드가 Config인 상태는 서로 다릅니다. 수정 전에 기존 구성을 보관하고 저장 후 현재 사용 항목을 확인한 다음 대상 요청의 규칙 매칭을 검증하세요.

DNS: DNS는 도메인을 IP 주소로 변환합니다. 이름 확인 과정과 프록시 연결 설정은 별개의 단계입니다. 도메인 접속에 실패하면 DNS 시간 초과, 반환된 주소 이상, 서버 연결 실패를 구분하세요. DNS를 변경하기 전에 기존 설정을 기록하고 같은 도메인으로 다시 테스트하세요. 한 번 이름 확인에 성공했다고 이후 연결이나 라우팅까지 정상이라고 볼 수는 없습니다.

지연 시간: 지연 시간은 지정된 방법과 대상을 기준으로 테스트 요청에 응답하는 데 걸린 시간이며, 보통 밀리초로 표시합니다. 수치가 낮다고 대역폭이 더 높다는 뜻은 아니며 장시간 전송, 패킷 손실, 모든 서비스의 이용 경험을 나타내지도 않습니다. 결과를 비교할 때는 같은 네트워크와 테스트 방법을 사용하고 실제 접속도 함께 확인하세요.

URL Rewrite: URL Rewrite는 매칭 표현식에 따라 URL 처리 방식을 바꾸는 기능으로, 프록시 또는 직접 연결 경로를 선택하는 라우팅 규칙과는 다릅니다. 작동 여부는 매칭 조건, 요청 유형, 관련 설정에 따라 달라지며 암호화된 모든 요청의 전체 내용을 읽을 수 있다고 단정할 수 없습니다. 수정할 때는 대상 범위를 좁게 설정하고 복구할 수 있도록 기존 구성을 보관하세요.

Scan QR Code: Scan QR Code는 QR 코드에 저장된 연결 또는 설정 정보를 읽는 기능이며 독립적인 프록시 프로토콜은 아닙니다. 스캔한 뒤에도 프로토콜, 주소, 인증 정보, 추가 매개변수를 확인하고 자신의 기존 설정에서 가져온 내용인지 확인하세요. QR 코드에 민감한 자격 증명이 포함될 수도 있으므로 그대로 캡처해 공개하지 마세요.

설치 및 플랫폼

다운로드 경로와 설치 파일 유형

Shadowrocket은 모든 주요 플랫폼에서 제공되는 클로즈드 소스 상용 앱입니다. iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제로 이용할 수 있으며, Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료입니다. 플랫폼별 다운로드 방법과 시스템 허용 절차는 다운로드 페이지에서 확인하세요.

App Store: App Store는 iPhone / iPad용 앱을 받는 곳이며, 시스템 요구 사항은 App Store 페이지의 표기를 따릅니다. 제품 페이지에서 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 확인하세요. 앱을 받으려면 다운로드 페이지의 iPhone / iPad 섹션에서 App Store 링크와 안내를 확인하세요.

구입 항목: 구입 항목은 Apple 계정에서 이미 받은 앱을 찾는 메뉴입니다. 기기를 바꾸거나 앱을 재설치할 때는 기존 구입 계정으로 Shadowrocket을 찾으세요. iPhone과 iPad는 같은 구입 계정으로 다시 받을 수 있지만, 다운로드 가능 여부는 기기 호환성과 스토어 상태에 따라 달라질 수 있습니다. 다시 결제하라는 메시지가 나타나면 결제를 반복하기 전에 스토어에서 사용하는 계정을 확인하세요.

Apple 실리콘 / Intel: 이 두 항목은 Mac의 프로세서 유형을 나타냅니다. 이 Mac에 관하여에서 확인한 뒤 해당하는 dmg 설치 파일을 선택하세요. 다운로드 페이지에는 Apple 실리콘 버전과 Intel 버전이 각각 제공되며, 설치 파일은 /dl/shadowrocket/ 경로에서 다운로드할 수 있습니다. 처음 실행할 때 개발자를 확인할 수 없다는 메시지가 나타나면 출처를 확인한 뒤 ‘개인정보 보호 및 보안’에서 ‘그래도 열기’를 선택하세요. 다른 알림은 설치 허용 안내를 참고하세요.

deb / rpm / AppImage: Linux 배포판마다 사용하는 패키지 형식이 다릅니다. Debian / Ubuntu에서는 보통 deb, Fedora 등에서는 보통 rpm을 사용하며, AppImage는 실행 환경을 확인해야 합니다. AppImage를 다운로드한 뒤에는 실행 권한을 부여해야 하며, 패키지 관리자 설치도 선택한 형식에 맞춰 진행하세요. 먼저 Linux 다운로드 섹션에서 사이트의 설치 파일을 선택한 다음 설치 표에 따라 권한과 종속성을 확인하세요.

용어 안내는 설정을 찾는 데 도움을 주며 실제 사용 절차를 대신하지 않습니다. 첫 연결 가이드를 읽거나 문제 해결 매뉴얼에서 증상에 따라 확인하세요.