Shadowrocket 용어집
인터페이스 용어, 프로토콜 이름, 규칙 키워드를 의미별로 찾아보세요. 매칭 조건, 처리 정책, 연결 매개변수를 구분한 다음 해당 설정을 변경하세요.
- 영어 인터페이스 용어는 원문 그대로 표기
- 다섯 가지 개념 색인
- 각 용어 항목은 앵커 링크로 바로 이동할 수 있습니다
용어가 표시된 위치부터 확인하세요
같은 영어 단어라도 위치에 따라 의미가 달라질 수 있습니다. 예를 들어 Config는 설정 관리 메뉴일 수도 있고, Global Routing의 선택 항목일 수도 있습니다. Proxy는 인터페이스 옵션이고, PROXY는 규칙 정책에서 자주 사용됩니다. 의미를 판단할 때는 단어 하나만 보지 말고 화면의 위치와 주변 항목, 현재 활성화된 설정을 함께 확인하세요.
이 페이지는 용어를 설명하며 단계별 조작 방법을 안내하지는 않습니다. 처음 가져오기를 진행한다면 사용 안내를 확인하세요. DNS, On Demand, Ping, Log 등의 옵션을 확인하려면 옵션 매뉴얼을 참고하세요. 플랫폼에 따라 메뉴 위치가 다를 수 있으며, 아래 설명이 모든 플랫폼의 화면 구성이 같다는 뜻은 아닙니다.
INTERFACE & SWITCHES
인터페이스 및 스위치
스위치가 전체 연결, 라우팅 선택, 진단 중 무엇을 제어하는지 먼저 확인하세요. 연결 스위치를 켜도 모든 요청이 같은 경로를 사용한다는 뜻은 아닙니다.
- Global Routing
- 전체 라우팅 방식을 정하는 옵션입니다. 일반적으로 Config, Proxy, Direct를 선택할 수 있으며 각각 설정, 프록시, 직접 연결에 해당합니다. Config는 현재 설정의 규칙에 따라 요청을 처리하고, Proxy와 Direct는 전체 프록시 또는 직접 연결 방식을 선택합니다. 사용자 지정 규칙이 적용되지 않을 때는 먼저 여기서 Config가 선택되어 있는지 확인한 다음 규칙 자체를 살펴보세요.
- Config / Proxy / Direct
- Global Routing에 표시되는 세 가지 인터페이스 용어이며, 서버 이름이 아닙니다. Config는 설정에 따른 트래픽 분기, Proxy는 프록시 경로, Direct는 직접 연결 경로를 뜻합니다. 규칙 항목의 대문자
PROXY,DIRECT와는 서로 다른 계층입니다. 문제를 기록할 때는 해당 용어가 표시된 화면도 함께 적어두세요.
- On Demand
- 미리 설정한 조건에 따라 시스템이 VPN 연결을 시작하는 기능으로, 네트워크 환경에 맞춰 연결을 관리할 때 사용합니다. 규칙 목록이나 특정 프로토콜을 뜻하는 것은 아닙니다. 변경한 뒤에는 네트워크 전환, 잠금 화면에서 복귀, 수동 연결 해제 후의 동작을 각각 확인하세요. 조건에 따라 다시 연결되는 동작을 스위치 오류로 오인하지 않도록 주의해야 합니다.
- DNS
- 도메인 이름을 IP 주소로 변환하는 과정으로, 도메인에 접속할 때 중요한 단계입니다. DNS 조회에 성공했다는 것은 주소를 얻었다는 뜻일 뿐이며, 이후 연결은 라우팅, 서버 상태, 프로토콜 매개변수의 영향을 받을 수 있습니다. 지연 시간 테스트는 정상이지만 웹페이지가 열리지 않는다면 조회 결과와 실제 연결 기록을 따로 확인하세요. DNS 항목을 한꺼번에 변경하지 마세요.
- Connectivity Test
- 지정한 연결 경로에 도달할 수 있는지 확인하는 테스트 메뉴입니다. 결과는 테스트 방식과 대상에 따라 달라집니다. 테스트에 성공해도 모든 웹사이트, 프로토콜, 규칙이 정상이라는 뜻은 아닙니다. 여러 기록을 비교할 때는 테스트 방식과 현재 네트워크를 동일하게 유지하세요. 실패하면 Log를 함께 확인해 이름 조회, 연결 설정, 후속 요청 중 어느 단계에서 문제가 발생했는지 파악하세요.
- Ping
- 일반적으로 응답을 탐지하는 데 걸린 시간을 나타내지만, 화면에서 측정하는 구체적인 의미는 현재 테스트 방식에 따라 달라집니다. 수치가 낮다고 다운로드 속도가 더 빠르거나 장시간 연결이 안정적이라는 뜻은 아닙니다. 실제 사용 환경은 앱 접속 결과, 연속 테스트, 네트워크 전환 상황을 함께 살펴 판단하세요. 한 번의 테스트 결과만으로 전체 설정을 변경하지 마세요.
- Log
- 연결 및 진단 기록을 확인하는 메뉴로, 이름 조회 실패, 연결 오류, 규칙 적용 문제를 파악하는 데 도움이 됩니다. 문제를 확인할 때는 먼저 발생 시각을 기록한 뒤 한 번 재현하면 해당 요청과 기록을 대조하기 쉽습니다. 기록을 공유하기 전에는 서버 주소, 구독 링크, ID 등 민감한 항목을 확인하고 문제 진단에 필요한 정보만 남기세요.
PROTOCOLS
프로토콜
프로토콜 이름은 연결에 사용되는 기술을 나타내며, 연결 매개변수가 모두 입력되었다는 뜻은 아닙니다. 유형, 인증 정보, 전송 및 보안 계층 설정은 보유한 서버 정보를 기준으로 확인하세요.
- Shadowsocks
- 프록시 프로토콜의 하나로, 일반적인 연결 매개변수에는 서버 주소, 포트, 비밀번호, 암호화 방식이 포함됩니다. 클라이언트와 서버의 매개변수가 서로 일치해야 하므로 주소와 비밀번호만 맞게 입력해도 연결에 실패할 수 있습니다. 서비스 제공업체의 안내에 추가 옵션이 있다면 하나씩 확인하고, 다른 기록의 설정을 임의로 추가하지 마세요.
- VMess
- ID와 전송 설정을 함께 사용해 연결을 설정하는 프록시 프로토콜입니다. 서버 주소, 포트, ID 외에도 전송 유형, 경로, Host, TLS 관련 매개변수가 필요할 수 있습니다. 가져온 뒤 연결되지 않는다면 ID만 확인하지 말고 모든 매개변수가 같은 서버 기록에 해당하는지 살펴보세요.
- VLESS
- 전송 계층 및 보안 계층 설정과 함께 사용하는 프록시 프로토콜입니다. ID는 연결 정보의 일부일 뿐입니다. VMess와 서로 바꿔 쓸 수 있는 프로토콜이 아니며, 입력 항목이 비슷해 보여도 유형만 바꿔 기존 기록을 재사용해서는 안 됩니다. 확인할 때는 서비스 제공업체가 안내한 전체 정보를 바탕으로 전송, 보안 계층, 서버 이름 등의 설정을 검토하세요.
- Trojan
- 일반적으로 TLS를 사용해 연결하는 프록시 프로토콜입니다. 일반적인 정보에는 서버 주소, 포트, 비밀번호, 서버 이름 등이 포함됩니다. 인증서 오류와 비밀번호 오류는 서로 다른 문제이므로 따로 확인해야 합니다. TLS 오류가 발생하면 먼저 시스템 시간, 서버 이름, 인증서 정보를 확인하세요. 인증서 확인을 건너뛰는 방법을 일반적인 해결책으로 사용하지 마세요.
- Hysteria2
- QUIC 기반 프록시 프로토콜이며, 연결 상태는 현재 네트워크에서 UDP를 사용할 수 있는지에 따라 달라집니다. 인증, TLS 및 안내된 기타 매개변수가 서버 설정과 일치해야 합니다. 특정 네트워크에서만 실패하고 다른 네트워크에서는 성공한다면 같은 매개변수를 유지한 채 네트워크 조건을 비교하세요. 먼저 서버 정보 입력 오류라고 단정하지 마세요.
- WireGuard
- 공개 키·개인 키와 Peer 설정으로 터널을 구성하는 프로토콜입니다. 주요 항목에는 인터페이스 주소, 피어의 공개 키, Endpoint, Allowed IPs가 있습니다. 핸드셰이크에 성공해도 모든 대상 주소의 라우팅과 DNS가 올바르다는 뜻은 아닙니다. 개인 키는 민감한 정보이므로 설정 문제를 확인할 때 전체 개인 키나 개인 키가 포함된 QR 코드를 다른 사람에게 보내지 마세요.
- HTTP / SOCKS5
- 프록시 프로토콜 이름 두 가지입니다. 실제 사용할 프로토콜은 서버에서 제공하는 연결 정보와 일치해야 합니다. 프로토콜 이름만으로 클라이언트와 프록시 서버 간 연결이 암호화된다고 볼 수 없으며, 웹사이트가 HTTPS를 사용한다는 이유로 프록시 연결 유형을 혼동해서도 안 됩니다. 주소, 포트, 인증 요건, 서버가 지원한다고 명시한 기능을 함께 확인하세요.
RULE KEYWORDS
규칙 키워드
규칙의 앞부분은 ‘무엇을 매칭할지’를, 정책 부분은 ‘매칭된 뒤 어떻게 처리할지’를 나타냅니다. 먼저 매칭 범위를 확인하고, 다음으로 순서를 확인한 뒤, 참조하는 정책이 실제로 정의되어 있는지 살펴보세요.
- 규칙
- 매칭 조건과 처리 정책으로 구성된 설정 항목입니다. 일반적으로 위에서 아래 순서로 확인하며 조건이 일치하면 이후 규칙을 더 확인하지 않습니다. 예를 들어
DOMAIN-SUFFIX,example.com,PROXY에는 키워드, 매칭 값, 정책이 포함됩니다. 앞선 규칙에 먼저 일치하지 않도록 구체적인 조건을 더 넓은 조건보다 위에 배치하는 것이 일반적입니다.
- DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
DOMAIN은 전체 도메인과 매칭하고,DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인에 매칭하며,DOMAIN-KEYWORD는 도메인에 포함된 키워드와 매칭합니다. 세 키워드의 적용 범위는 서로 다르며 같은 표현의 약어가 아닙니다. 대상을 정확히 지정할 수 있다면 명확한 매칭 조건을 우선 사용해 다른 도메인까지 영향을 줄 수 있는 광범위한 키워드를 피하세요.
- IP-CIDR / IP-CIDR6
- IPv4 및 IPv6 주소 대역을 기준으로 매칭하며, 슬래시 뒤의 접두사 길이가 대역 범위를 결정합니다. 예를 들어
192.168.0.0/16은 IPv4 대역 표기입니다. IP 규칙과 도메인 규칙은 판단 기준이 다릅니다. 실제 매칭 결과를 확인할 때는 대상 주소와 조회 결과, 앞서 일치한 규칙을 함께 살펴보세요.
- GEOIP
- IP 주소 위치 데이터베이스를 기준으로 매칭하는 규칙 키워드입니다. 위치 판정은 데이터베이스의 내용과 업데이트 상태에 따라 달라집니다. 웹페이지의 언어, 도메인 접미사, 사용자의 위치를 직접 기준으로 판정하지 않습니다. CDN이나 공유 인프라를 사용하는 서비스는 실제 대상 IP를 확인해야 하며, 사이트 이름만으로 매칭 결과를 추측할 수 없습니다.
- FINAL
- 앞선 규칙이 모두 일치하지 않을 때 적용하는 기본 규칙으로, 보통 규칙 목록의 마지막에 둡니다. 예를 들어
FINAL,DIRECT는 아직 매칭되지 않은 요청을 DIRECT로 처리한다는 뜻입니다. 이 규칙은 다른 규칙이 다루지 않는 트래픽의 처리 방식을 결정합니다. 수정하기 전에 어떤 요청이 여기에 해당하는지 확인하고, FINAL을 모든 연결 문제를 해결하는 스위치처럼 사용하지 마세요.
- PROXY / DIRECT / REJECT
PROXY는 프록시 정책,DIRECT는 직접 연결,REJECT는 요청 거부를 뜻합니다. 이는 처리 방식이지 도메인, 프로토콜, 서버 주소가 아닙니다. PROXY가 실제로 사용하는 경로는 현재 설정과 선택 항목도 확인해야 합니다. 사용자 지정 정책 이름을 사용하려면 해당 정책이 설정에 정의되어 있어야 합니다.
- USER-AGENT
- 요청의 User-Agent 정보를 기준으로 매칭하는 규칙 키워드입니다. 현재 처리 경로에서 관련 내용을 확인할 수 있어야 합니다. 암호화된 트래픽에서 보이지 않는 정보는 규칙을 추가하는 것만으로 매칭할 수 없습니다. 따라서 모든 앱을 식별하는 방법으로 사용할 수는 없습니다. 사용하기 전에 실제 요청과 현재 기능의 조건을 확인하세요.
SUBSCRIPTION & CONFIG
구독 및 설정
구독은 서비스 정보를 가져오고 업데이트하며, 설정은 규칙과 관련 옵션을 구성합니다. 가져오기 성공, 구독 업데이트 성공, 실제 연결 성공은 각각 따로 확인해야 합니다.
- Subscribe
- 구독 내용을 가져오거나 업데이트하는 메뉴입니다. 구독 링크는 이용 중인 서비스 제공업체에서 받아야 합니다. 구독에는 서버 항목 여러 개가 포함될 수 있어 서버 하나만 지정하는 링크와 다르며, 전체 트래픽 분기 설정까지 포함하지 않을 수도 있습니다. 구독 주소에 접근 정보가 들어 있을 수 있으므로 링크를 복사하거나 캡처하거나 문의 내용을 제출할 때 전체 주소를 공개하지 마세요.
- Add Server / SERVER
- Add Server는 서버 항목 하나를 추가하는 메뉴이며, SERVER 관련 입력란에는 해당 서버 정보를 입력합니다. 서버 기록은 일반적으로 프로토콜 유형, 주소, 포트, 인증 매개변수 등으로 구성되며 이름 하나만 입력하는 것이 아닙니다. 필요한 매개변수를 모두 보유한 경우 수동으로 입력할 수 있습니다. 구독 링크만 있다면 전체 링크를 서버 주소란에 붙여 넣지 말고 해당 구독 메뉴를 사용하세요.
- Config
- 설정 관리 메뉴인 Config에서는 현재 사용하는 규칙, 정책 참조 및 기타 설정을 구성합니다. 파일을 여기에 저장했다고 해서 해당 파일이 선택되어 활성화된 것은 아닙니다. 설정 파일이 있는지와 실제로 적용 중인지 각각 확인해야 합니다. 이 메뉴는 현재 설정에 따라 라우팅한다는 뜻의 Global Routing 옵션 Config와 다릅니다.
- Scan QR Code
- QR 코드에 담긴 설정 정보를 읽는 메뉴입니다. QR 코드는 정보를 전달할 뿐, 누락된 매개변수를 자동으로 채우지는 않습니다. 같은 모양의 QR 코드라도 서버 링크 하나, 구독 주소 또는 다른 내용이 인코딩되어 있을 수 있으므로 가져오기 전에 인식된 내용과 출처를 확인하세요. QR 코드 스캔에 성공했다고 연결까지 가능하다는 뜻은 아니며, 인증 정보가 포함된 QR 코드를 공개하지 마세요.
- URL Rewrite
- 매칭 조건에 따라 요청 URL을 변경하거나 관련 리디렉션을 처리하는 기능입니다. 요청이 어떤 경로를 이용할지 결정하는 라우팅 규칙과는 다릅니다. DOMAIN-SUFFIX나 FINAL을 대신할 수 없으며 DNS 조회 실패를 해결하는 범용 방법도 아닙니다. 사용 전에 매칭 범위와 트래픽을 확인할 수 있는 조건을 파악하고, 개별 테스트를 통해 다른 요청에 영향을 주지 않는지 확인하세요.
- iCloud 동기화
- 지원되는 데이터를 iCloud를 통해 해당 기기 간에 동기화합니다. 실제 동기화 범위는 현재 앱 옵션을 기준으로 확인하세요. 서비스 제공업체의 구독 업데이트나 App Store 구입 항목 복원과는 별개의 기능입니다. 데이터가 표시되지 않으면 iCloud 계정, 동기화 스위치, 네트워크 상태, 동기화 대기 중인 항목을 각각 확인하세요.
PACKAGES & PLATFORMS
설치 패키지 및 플랫폼
운영체제와 프로세서 유형을 구분한 다음 적절한 다운로드 방법을 선택하세요. 이 사이트에서는 /dl/shadowrocket/ 경로로 설치 패키지를 제공하며, 구체적인 다운로드 링크는 다운로드 페이지에서 확인할 수 있습니다.
- .deb / .rpm / .AppImage
- Linux에서 자주 사용하는 패키지 형식은 파일 크기가 아니라 배포판, 패키지 관리자, 시스템 환경에 맞춰 선택해야 합니다. .deb는 Debian 계열 배포판에서, .rpm은 RPM 패키지 관리자를 사용하는 배포판에서 주로 사용합니다. .AppImage는 일반적으로 먼저 실행 권한을 부여한 다음 실행 의존성을 확인해야 합니다. 자세한 방법은 설치 보안 설정 안내를 참고하세요. 형식이 다른 패키지에 같은 명령을 사용하지 마세요.
- Apple 실리콘 / Intel
- Mac 설치 패키지를 선택할 때 확인해야 하는 프로세서 유형입니다. 시스템의 ‘이 Mac에 관하여’에서 확인할 수 있습니다. Shadowrocket은 두 프로세서 유형에 맞는 .dmg 설치 패키지를 각각 제공합니다. 컴퓨터 외관이나 구입 연도만으로 판단하지 마세요. 처음 열 때 ‘개발자를 확인할 수 없음’ 메시지가 표시되면 출처를 확인한 뒤 설치 보안 설정 안내에 따라 ‘개인정보 보호 및 보안’에서 처리하세요.
- App Store / 구입 항목
- App Store는 iPhone 및 iPad에서 Shadowrocket을 다운로드할 수 있는 스토어입니다. 다시 다운로드하려면 원래 구입한 계정의 구입 항목에서 찾으세요. 앱을 확인할 때 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 함께 확인하세요. 시스템 요구 사항은 App Store 페이지의 표기를 기준으로 합니다. iPhone 및 iPad 버전은 App Store에서 $2.99에 한 번 구매하며, Mac, Windows, Android, Linux 버전은 무료입니다.
- 클라이언트와 연결 서비스
- 클라이언트는 프록시 연결, 규칙에 따른 트래픽 분기, 로컬 설정을 처리합니다. 연결 서비스는 접속 가능한 서버와 인증 정보를 제공합니다. 두 가지는 별개의 항목입니다. 클라이언트 일회성 구매와 연결 서비스 요금제는 다르며, 보유한 서버나 구독의 유효성도 별도로 확인해야 합니다. 구독 업데이트, 계정 상태, 서버 유지 관리 문제는 이용 중인 서비스 제공업체가 제공한 정보를 확인하세요.
문제에 맞는 안내 확인
조작 단계를 확인하려면 사용 안내를, 설정 항목을 하나씩 확인하려면 옵션 매뉴얼을 참고하세요. 설치 패키지나 스토어 링크는 전체 플랫폼 다운로드 페이지에서 확인할 수 있습니다. 가져온 뒤 연결에 실패하면 현재 설정을 그대로 두고 테스트 결과와 오류 정보를 먼저 기록한 다음 하나씩 원인을 확인하세요. 여러 항목을 동시에 변경하면 원인을 파악하기 어려워질 수 있습니다.