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

Shadowrocket 용어집

먼저 현재 화면을 확인한 다음 용어의 적용 범위를 살펴보세요. 이 페이지에서는 영어 화면 용어와 규칙 원문을 유지하며, 자주 쓰이는 용어를 5개 분류로 설명합니다. 순서대로 설정하는 방법은 사용 설명서에서, 연결 문제가 발생했을 때는 문제 해결 가이드에서 확인하세요.

01 · 화면 및 스위치

화면 메뉴와 연결 방식

화면 용어는 대소문자와 표시 위치에 따라 의미가 달라집니다. 특히 Config 화면, Global Routing의 Config 방식, 규칙에 쓰이는 대문자 정책을 구분해야 합니다.

Home: 서버 목록을 확인하고 현재 서버를 선택해 연결을 제어하는 주요 화면입니다. 목록에 항목이 보인다는 것은 매개변수가 불러와졌다는 뜻일 뿐, 서버에 연결할 수 있다는 의미는 아닙니다. 연결 후에는 실제 접속과 규칙 매칭 여부를 확인하세요.

Global Routing: 전체 트래픽 처리 방식을 정하는 설정입니다. 일반적인 옵션은 설정(Config), 프록시(Proxy), 직접 연결(Direct)입니다. 문제를 확인하기 전에 현재 선택 항목을 살펴보세요. 그렇지 않으면 전체 연결 방식의 영향을 특정 규칙의 오류로 오해할 수 있습니다.

Config: 화면 이름에서 Config는 설정 파일 관리 영역을 뜻합니다. Global Routing에서 Config는 현재 설정에 따라 트래픽을 처리한다는 의미입니다. Config 화면에 들어가는 것과 특정 설정을 활성화하는 것은 별개입니다. 파일을 가져온 후 실제로 어떤 설정을 사용 중인지 확인하세요.

Proxy / Direct: Global Routing에서 Proxy와 Direct는 각각 전체 트래픽을 프록시 또는 직접 연결 방식으로 처리한다는 뜻입니다. 규칙 행 끝에 쓰이는 대문자 PROXY, DIRECT와는 서로 다른 수준의 설정입니다. 전체 방식이 Direct라면 특정 규칙에 PROXY가 적혀 있다는 이유만으로 트래픽이 반드시 프록시를 통한다고 단정할 수 없습니다.

On Demand: 설정된 네트워크 조건에 따라 연결을 시작하는 기능입니다. 정기적으로 속도를 측정하거나 가장 빠른 서버를 자동 선택하는 기능은 아닙니다. 활성화한 뒤 자주 사용하는 Wi-Fi, 셀룰러 네트워크, 네트워크 전환 상황에서 각각 확인하세요. 수동으로 연결을 끊었다가 다시 연결할 때도 관련 트리거 조건을 살펴봐야 합니다.

Add Server: 사용자가 보유한 서버 정보를 직접 입력하는 메뉴입니다. 먼저 프로토콜을 선택한 다음 Address, Port 및 인증 항목을 입력하세요. 프로토콜마다 필요한 매개변수가 다르므로 항목 이름이 비슷하다고 다른 프로토콜의 입력 방식을 그대로 적용하지 마세요.

02 · 프로토콜

서버 매개변수에 맞는 프로토콜

프로토콜 이름은 연결 및 인증 방식을 나타내며 속도 등급을 뜻하지 않습니다. 사용자가 보유한 서버에서 제공한 전체 매개변수를 기준으로 입력하세요. 프로토콜 이름만 보고 전송 방식이나 TLS 설정을 추측하지 마세요.

Shadowsocks: 정해진 암호화 방식과 비밀번호로 프록시 트래픽을 전송하는 프로토콜입니다. 주소, 포트, 암호화 방식, 비밀번호는 서버 설정과 일치해야 합니다. 표시 이름을 바꿔도 인증 실패는 해결되지 않으며, 암호화 방식을 임의로 선택해서도 안 됩니다.

VMess: 인증 기능을 갖춘 프록시 프로토콜이며 UUID를 사용자 식별 정보로 사용하는 경우가 많습니다. 전송 방식, Host, Path, TLS 항목을 각각 확인하세요. UUID를 올바르게 입력해도 연결 설정 전체가 완성된 것은 아닙니다. 일부 인증 과정은 기기의 시간 정확도에도 영향을 받습니다.

VLESS: 사용자 식별과 전송 보안 설정을 별도로 다루는 프록시 프로토콜입니다. UUID가 있다는 이유만으로 연결이 암호화되었다고 볼 수는 없습니다. 서버에서 지정한 전송 및 보안 매개변수를 모두 확인해야 하며, VMess 매개변수를 VLESS에 그대로 적용할 수는 없습니다.

Trojan: 일반적으로 TLS와 비밀번호 인증을 사용하는 프록시 프로토콜입니다. 주요 확인 항목은 Address, Port, Password, SNI입니다. 서버 주소와 인증서에 사용된 도메인이 다를 수 있습니다. 인증서 오류가 발생하면 검증을 끄기보다 이름과 서버 설정을 확인하세요.

Hysteria2: QUIC 기반 프록시 프로토콜입니다. 연결 상태는 서버 설정과 현재 네트워크의 UDP 처리 방식에 영향을 받습니다. 인증 정보, TLS 이름 및 기타 매개변수는 서버 안내에 따라 입력하세요. 프로토콜 이름만으로 속도가 보장되지는 않으며, 시간 초과가 비밀번호 오류를 뜻하는 것도 아닙니다.

WireGuard: 공개 키와 개인 키로 암호화 터널을 구성하는 프로토콜입니다. 피어의 공개 키와 로컬 개인 키는 용도가 다릅니다. 키의 대응 관계, 피어 주소, 라우팅 매개변수를 함께 확인하세요. 개인 키는 민감한 정보이므로 문제 해결 자료에 그대로 공개하지 마세요.

HTTP / SOCKS5: 일반적인 프록시 프로토콜 유형 두 가지입니다. 서버에 따라 사용자 이름, 비밀번호 또는 TLS 설정이 추가로 필요할 수 있습니다. HTTP CONNECT로 터널을 만들 수 있지만 프록시 서버까지의 연결 자체에 TLS가 적용된다는 뜻은 아닙니다. SOCKS5도 이름만으로 암호화 보호 여부를 판단할 수 없습니다.

03 · 규칙 키워드

매칭 조건과 적용 정책

규칙은 보통 매칭 유형, 조건, 정책 순서로 작성합니다. 규칙의 순서도 설정의 일부입니다. 앞쪽의 포괄적인 규칙이 먼저 매칭되면 뒤쪽의 구체적인 규칙은 확인되지 않을 수 있습니다.

[Rule]: 설정 파일의 규칙 섹션입니다. 매칭 조건을 순서대로 확인해 해당 정책을 선택합니다. 규칙은 서버 목록이 아니며 새로운 연결 정보를 만들지도 않습니다. 매칭 결과를 확인할 때는 현재 설정, Global Routing, 규칙의 순서를 함께 살펴보세요.

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN은 전체 도메인, DOMAIN-SUFFIX는 지정된 도메인과 하위 도메인, DOMAIN-KEYWORD는 도메인에 포함된 키워드를 매칭합니다. 조건에는 전체 웹페이지 주소가 아닌 도메인을 입력합니다. 프로토콜, 페이지 경로, 쿼리 매개변수는 포함하지 마세요. 키워드가 너무 짧으면 매칭 범위가 넓어질 수 있습니다.

IP-CIDR / IP-CIDR6: 각각 IPv4 및 IPv6 주소 대역을 매칭하며, 슬래시 뒤의 접두사 길이에 따라 적용 범위가 결정됩니다. 예를 들어 192.168.0.0/16은 단일 호스트가 아니라 IPv4 대역을 나타냅니다. 규칙을 작성하기 전에 대상 트래픽이 실제로 어떤 주소 유형을 사용하는지 확인하세요.

GEOIP: 주소 데이터베이스의 지역 분류를 기준으로 대상 IP를 매칭하며, 기기의 위치를 판별하는 기능은 아닙니다. 데이터베이스의 분류는 서비스의 실제 배포 위치나 사업상 관할 지역과 다를 수 있으므로 GEOIP를 모든 정확한 도메인 규칙의 대안으로 사용할 수는 없습니다. DNS 해석 결과가 바뀌면 매칭 결과도 달라질 수 있습니다.

FINAL: 앞선 규칙에 매칭되지 않은 트래픽을 처리하며 일반적으로 규칙 섹션의 마지막에 둡니다. 앞선 모든 규칙의 결과를 덮어쓰는 기능이 아니라 최종 경로를 지정합니다. 너무 앞에 배치하면 이후 규칙이 매칭되지 않을 수 있습니다.

PROXY / DIRECT / REJECT: 규칙 정책: PROXY는 프록시 정책을 통한 전달, DIRECT는 대상에 직접 연결, REJECT는 조건에 맞는 요청 거부를 뜻합니다. DIRECT가 시스템의 모든 네트워크 설정을 우회한다는 의미는 아니며, REJECT도 단순히 페이지 요소를 숨기는 기능이 아닙니다. 실제 적용 여부는 앞선 매칭 조건에 따라 달라집니다.

규칙 구문 예시이며 앱 화면이 아닙니다

아래 예시는 필드 구성을 보여 주기 위해 예시 도메인을 사용합니다. 실제로 적용하기 전에 필요한 접속 방식에 맞는지 확인하세요. FINAL,PROXY는 앞선 규칙에 매칭되지 않은 트래픽을 PROXY로 처리합니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-SUFFIX,example.org,REJECT
FINAL,PROXY

04 · 구독 및 설정

가져오는 콘텐츠와 복원 범위

가져온 항목이 단일 서버 공유 링크인지, 서버 구독인지, 원격 설정 파일인지 먼저 확인하세요. 모두 링크나 QR 코드로 전달될 수 있지만 같은 메뉴로 가져오는 것은 아닙니다.

구독: 사용자가 보유한 서비스에서 제공한 주소로 서버 항목을 가져오고 업데이트하는 방식입니다. 클라이언트를 구매하는 것과는 다릅니다. 구독 주소에 접근 정보가 포함될 수 있으므로 스크린샷이나 로그에 공개하지 마세요. 업데이트에 실패하면 주소 접속 오류, 콘텐츠 형식 불일치, 구독 자체의 상태 이상을 구분해 확인하세요.

서버: 프록시 연결을 처리하는 원격 서비스로 노드라고도 합니다. 목록의 각 항목에는 보통 프로토콜, 주소, 포트, 인증 매개변수가 포함됩니다. 표시 이름은 구별을 위한 레이블일 뿐이며, 이름을 바꿔도 서버 주소나 실제 연결 가능 여부는 달라지지 않습니다.

설정 파일: 규칙, DNS 및 기타 지원되는 설정을 구성하는 텍스트 파일이며 서버 구독과는 주된 용도가 다릅니다. 가져온 뒤 활성화 여부를 확인하세요. 원격 업데이트로 로컬 수정 사항이 덮어써질 수 있으므로 변경 전에 복구 가능한 사본을 보관하고, 활성화하는 각 섹션의 기능을 이해해야 합니다.

iCloud 동기화: 앱이 지원하는 범위에서 iCloud로 데이터를 동기화합니다. 동기화 항목과 메뉴는 현재 앱 화면을 확인하세요. 모든 시스템 권한과 연결 상태가 완전히 백업되는 것은 아닙니다. 새 기기로 옮긴 뒤에는 설정 파일의 존재 여부와 현재 사용 중인 설정, 서버 인증 정보의 유효성을 확인해야 합니다.

구입 항목: App Store에서 기존 구입 내역을 확인하고 앱을 다시 받는 메뉴입니다. 구매 당시 사용한 Apple 계정으로 로그인해야 합니다. 앱을 다시 받는 것과 설정을 복원하는 것은 별개의 작업이므로 Shadowrocket을 다시 받아도 서버 정보가 복구되는 것은 아닙니다. 시스템 요구 사항, 가족 공유 및 유니버설 구입의 적용 범위는 App Store 페이지를 확인하세요.

05 · DNS 및 네트워크

이름 해석, 테스트, 연결 보안

연결 스위치, 도메인 이름 해석, 서버 인증, 실제 서비스 접속은 각각 별도의 확인 단계입니다. 한 단계가 성공했다는 것은 해당 단계의 조건이 충족되었다는 뜻일 뿐, 전체 연결이 정상이라는 의미는 아닙니다.

DNS: 도메인을 IP 주소 등의 레코드로 변환하는 기능입니다. 해석 결과는 네트워크와 서비스 배치에 따라 달라질 수 있습니다. 도메인이 해석되어도 대상 포트에 연결할 수 있다는 뜻은 아닙니다. 서버 테스트가 성공해도 모든 도메인의 해석이 정상인 것은 아닙니다. 문제를 확인할 때는 이름 해석 실패와 이후 연결 실패를 구분해 기록하세요.

DNS over HTTPS: HTTPS를 통해 DNS 쿼리를 전송하는 방식으로, DoH라고도 합니다. 해당 DNS 요청의 전송을 보호할 뿐 모든 서비스 트래픽이 프록시를 통한다는 뜻은 아닙니다. 설정한 DNS 서비스에 연결할 수 없으면 서비스 연결 전에 대기하거나 실패할 수 있습니다.

Connectivity Test / 지연 시간: Connectivity Test는 지정된 테스트 조건에서 연결 상태를 확인하며, 지연 시간은 일반적으로 테스트에 걸린 시간을 뜻합니다. 결과는 테스트 방식, 대상 주소, 현재 네트워크의 영향을 받으므로 다운로드 속도로 환산할 수 없습니다. 시간 초과는 테스트 대상이나 DNS 경로 때문일 수도 있으니 실제 접속 상태와 함께 판단하세요.

TLS / SNI: TLS는 연결을 보호하며 SNI는 핸드셰이크 중 대상 호스트 이름을 지정하는 정보입니다. Address는 연결 주소일 수 있지만 SNI는 서버의 TLS 설정과 일치해야 합니다. 인증서 이름이 맞지 않으면 도메인, 인증서, 기기 시간을 확인하세요. 검증을 끄는 것으로 매개변수 오류를 대신 해결하지 마세요.

URL Rewrite: 설정 조건에 따라 요청 주소를 다시 쓰는 기능이며, 트래픽 경로를 선택하는 규칙 기반 분배와는 다릅니다. 요청 내용을 확인할 수 있는지, 매칭 조건과 관련 설정이 맞는지에 따라 적용 여부가 달라집니다. 임의의 암호화된 콘텐츠까지 처리할 수 있다고 가정하지 마세요. 용도를 이해한 항목만 활성화하세요.