OFFICIAL MANUAL / GLOSSARY

Shadowrocket 용어 정리

먼저 인터페이스 용어를 확인한 뒤 연결 매개변수, 라우팅 선택, 진단 결과 중 어디에 해당하는지 살펴보세요. 이 페이지는 공식 매뉴얼의 용어 색인입니다. 각 항목 제목의 앵커를 눌러 바로 이동할 수 있으며, 영문 이름과 구성 키워드는 원문 그대로 표기합니다.

INTERFACE & SWITCHES

인터페이스 및 스위치

이 항목에서는 ‘어디에서 조작하는지’와 ‘스위치가 무엇을 제어하는지’를 설명합니다. 시스템 승인, 전체 라우팅 방식, 연결 상태는 서로 다른 단계이므로 별개로 확인해야 합니다.

Home

Home은 연결 상태와 서버를 선택하는 기본 화면입니다. 연결 상태, Global Routing, SERVER 등의 영역에서 현재 사용하려는 설정을 확인할 수 있습니다. 연결 스위치를 조작하기 전에 테스트할 서버가 선택되어 있는지 확인하세요. 연결됨으로 표시되어도 연결 기능이 시작되었다는 뜻일 뿐, 실제 대상에 접속할 수 있는지는 접속 테스트와 연결 기록으로 확인해야 합니다.

Global Routing

Global Routing은 전체 라우팅 방식을 제어하며, 구성·프록시·직접 연결의 세 가지 모드가 있습니다. 인터페이스에서는 각각 Config, Proxy, Direct로 표시됩니다. 특정 규칙이 적용되지 않는다면 규칙 내용을 바로 수정하기 전에 Config 모드인지 먼저 확인하세요. Global Routing은 라우팅 로직의 유형을 정하고, 구체적인 규칙 정책은 다음 단계에서 확인합니다.

Config / Proxy / Direct

Global Routing에서 Config는 현재 구성의 규칙에 따라 연결 경로를 결정하고, Proxy는 프록시 경로로 연결을 처리하며, Direct는 대상에 직접 연결합니다. 여기서 Config는 라우팅 모드를 뜻합니다. 안내 문서를 읽을 때는 문맥에 따라 구성 관리 화면을 가리키는지 구분하세요. 모드를 전환한 뒤에는 테스트 연결을 새로 시작해야 합니다. 기존 연결이 새 선택 결과를 반영하지 않을 수 있습니다.

On Demand

On Demand는 설정한 조건에 따라 VPN 연결을 시작하며, ‘어떤 도메인이 어느 경로로 연결되는지’가 아니라 ‘언제 연결을 설정하는지’를 다룹니다. Rule 섹션을 대신하지 않으며 잘못 입력한 서버 매개변수도 수정하지 않습니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 On Demand 조건을 먼저 확인한 다음 다른 연결 문제가 있는지 살펴보세요.

Add Server

Add Server는 서버 정보를 입력하는 화면입니다. 먼저 프로토콜 유형을 선택한 다음 보유한 정보에 따라 주소, 포트, 인증 정보를 입력하세요. TLS, 전송 방식 및 추가 필드도 각각 일치해야 하며, 서버 노트만으로 내용을 추측해서는 안 됩니다. 자세한 순서는 사용 안내를 참조하세요. 수정 전에 기존 항목을 남겨 두면 비교하기 쉽습니다.

VPN 구성 승인

처음 연결을 설정할 때 Apple 시스템에서 VPN 구성을 추가하도록 허용하고 기기에서 시스템 인증을 완료하라는 메시지가 표시될 수 있습니다. 이 승인을 통해 Shadowrocket이 시스템 수준의 연결을 설정할 수 있지만, 구독이 유효하거나 서버 테스트가 완료되었다는 뜻은 아닙니다. 앱을 직접 사용하는 중에 시스템 메시지를 확인한 뒤 Home으로 돌아가 상태를 확인하세요. 시스템 요구 사항은 App Store 페이지 표기를 기준으로 합니다.

PROTOCOLS

프로토콜

프로토콜은 양쪽에서 데이터를 주고받고 신원을 확인하는 방식을 정의하며, 연결 품질의 등급을 나타내지 않습니다. 서버가 사용하는 프로토콜에 맞는 유형과 매개변수를 입력해야 하며, 이름이 비슷해도 인증 정보를 서로 바꿔 쓸 수 없습니다.

Shadowsocks

Shadowsocks는 비밀번호와 암호화 방식 등의 매개변수로 프록시 연결을 설정하며, 주소와 포트로 서버를 지정합니다. 비밀번호가 맞더라도 암호화 방식이 다르면 연결되지 않을 수 있습니다. 보유한 서버 정보를 항목별로 대조하세요. 다른 프로토콜의 UUID를 비밀번호 필드에 입력하거나 이름만 보고 암호화 방식을 추측하지 마세요.

VMess

VMess는 인증 기능을 포함하며, 일반적인 인증 정보는 UUID입니다. alterId, 전송 방식, TLS 설정이 추가로 필요할 수 있습니다. alterId는 보유한 서버 정보에 따라 입력해야 하며, 이전 안내의 예시 값을 일반적인 값으로 간주하면 안 됩니다. UUID가 일치해도 전송 매개변수가 다르면 연결에 실패할 수 있습니다. 기기 시간이 잘못 설정되었는지도 인증 문제를 점검할 때 확인하세요.

VLESS

VLESS는 UUID로 신원을 식별하며, 프로토콜 자체는 데이터를 암호화하지 않습니다. 전송 보호 방식은 실제 서버 구성에 따라 확인해야 합니다. TLS, flow, 전송 방식은 서버 측 설정과 서로 일치해야 하며, UUID가 같다는 이유만으로 VMess 설정을 그대로 사용하면 안 됩니다. 필드별 차이는 VMess와 VLESS 필드 안내에서 확인할 수 있습니다.

Trojan

Trojan은 일반적으로 TLS와 함께 사용하며 비밀번호로 인증합니다. 주소, 포트, 비밀번호뿐 아니라 서버 이름과 인증서 검증에 필요한 정보도 확인해야 합니다. TLS 오류가 발생하면 이름, 시간, 인증서 체인을 먼저 점검하세요. 인증서 검증을 끄는 것은 일반적인 해결 방법이 아닙니다.

Hysteria2

Hysteria2는 QUIC 기반이며 UDP 네트워크 경로를 통해 연결합니다. 인증 및 TLS 매개변수는 서버 측 설정과 일치해야 합니다. 도메인이 조회되더라도 UDP 경로가 제한되면 연결을 설정하지 못할 수 있습니다. 보유한 정보에 난독화 설정이 있다면 해당 매개변수도 확인하세요. 프로토콜 이름만으로 지연 시간이 더 짧거나 처리량이 더 높다고 단정할 수는 없습니다.

WireGuard

WireGuard는 키를 사용해 암호화 터널을 설정하며, 로컬 키와 터널 주소, 피어 정보가 필요합니다. 공개 키는 상대 피어를 식별하는 데 사용하고, 개인 키는 민감한 인증 정보이므로 공개 스크린샷이나 문제 해결 자료에 포함하면 안 됩니다. 비밀번호나 UUID를 사용하는 프로토콜과 매개변수 구성이 다르므로 서버 주소만 복사하지 말고 기존의 전체 구성을 사용하세요.

RULES & POLICIES

규칙 키워드 및 정책

규칙의 왼쪽은 ‘무엇과 매칭할지’를 판단하고, 마지막 정책은 ‘어떻게 처리할지’를 정합니다. 먼저 Global Routing을 확인한 다음 매칭 순서를 살펴보세요. 범위가 넓은 규칙보다 구체적인 규칙을 앞에 두는 것이 일반적입니다.

규칙

규칙은 매칭 조건과 실행 정책을 한 항목에 함께 작성합니다. 예를 들면 DOMAIN-SUFFIX,example.com,PROXY와 같습니다. Rule 섹션은 일반적으로 위에서 아래로 확인하며, 처음 일치한 유효 규칙이 처리 방식을 결정합니다. 이후 항목은 해당 매칭의 처리 방식을 바꾸지 않습니다. 편집할 때는 규칙 내용이 맞는지뿐 아니라 앞선 광범위한 규칙이 이미 대상에 적용되는지도 확인하세요.

DOMAIN

DOMAIN은 전체 도메인을 기준으로 매칭합니다. 예를 들어 DOMAIN,example.com,DIRECT는 해당 도메인만 대상으로 합니다. 이름에 example.com이 포함되어 있다고 해서 api.example.com까지 자동으로 포함하지는 않습니다. 도메인과 모든 하위 도메인을 처리하려면 DOMAIN-SUFFIX로 범위를 확인하고, 전체 도메인 매칭 방식을 임의로 추측하지 마세요.

DOMAIN-SUFFIX

DOMAIN-SUFFIX는 도메인 접미사의 경계를 기준으로 매칭합니다. example.com을 입력하면 해당 도메인과 api.example.com 등의 하위 도메인이 포함됩니다. 임의의 문자열이 포함되는지를 확인하는 방식은 아니므로 notexample.com은 같은 접미사 범위에 속하지 않습니다. DOMAIN-SUFFIX,example.com,PROXY는 문법을 설명하는 예시일 뿐, 사용할 수 있는 서버 구성을 뜻하지 않습니다.

DOMAIN-KEYWORD

DOMAIN-KEYWORD는 도메인에 지정한 키워드가 포함되어 있는지 기준으로 매칭하며, 일반적으로 DOMAIN이나 DOMAIN-SUFFIX보다 범위가 넓습니다. 키워드가 너무 짧으면 관련 없는 도메인까지 같은 정책에 포함될 수 있습니다. 넓은 범위가 꼭 필요한 경우에만 사용하고, 연결 기록에서 잘못 매칭되는 항목이 있는지 확인하세요.

GEOIP

GEOIP는 IP 지리 데이터베이스의 분류 결과를 기준으로 매칭하며, 웹페이지에 쓰인 문자나 사용자의 위치를 기준으로 하지 않습니다. 도메인이 다른 주소로 조회되면 결과가 달라질 수 있고, 데이터베이스 분류에 오류가 있을 수도 있습니다. 예상과 다른 연결이 발생하면 웹사이트 이름으로 결과를 추측하기보다 실제 대상 IP와 매칭된 규칙을 먼저 확인하세요.

IP-CIDR / IP-CIDR6

IP-CIDR은 IPv4 대역에, IP-CIDR6은 IPv6 대역에 사용하며 슬래시 뒤의 프리픽스 길이가 매칭 범위를 결정합니다. 예를 들어 IP-CIDR,192.0.2.0/24,DIRECT는 IPv4 대역 규칙의 예시이며, 해당 주소는 문서용 예시입니다. 프리픽스 길이를 잘못 입력하면 처리 범위가 넓어질 수 있으므로 주소 체계, 네트워크 주소, 실행 정책을 함께 확인하세요.

USER-AGENT

USER-AGENT는 HTTP 요청의 User-Agent 정보를 기준으로 매칭하며, 기기의 모든 앱을 식별하는 범용 방법은 아닙니다. 프로토콜, 암호화, 관련 처리 설정에 따라 요청 정보를 확인할 수 있는지가 달라집니다. 매칭되지 않는다면 키워드를 더 추가하기 전에 연결 기록에서 해당 정보를 확인할 수 있는지 살펴보세요.

FINAL

FINAL은 앞선 항목에 매칭되지 않은 연결을 처리하는 기본 규칙으로, 일반적으로 Rule 섹션의 마지막에 둡니다. 예를 들어 FINAL,PROXY는 남은 연결을 PROXY 정책으로 처리한다는 뜻입니다. FINAL을 수정하면 특정 웹사이트만이 아니라 남은 모든 연결에 영향을 줍니다. 예외로 처리할 대상이 기존의 구체적인 규칙에 포함되어 있는지 먼저 확인하세요.

PROXY / DIRECT / REJECT

PROXY는 프록시 정책, DIRECT는 대상에 직접 연결, REJECT는 연결 거부를 뜻합니다. 규칙에 이 값을 작성하면 해당 규칙과 일치한 연결에 적용됩니다. 규칙의 대문자 정책 키워드와 Global Routing 인터페이스의 Proxy, Direct 옵션은 서로 다릅니다. 대상이 REJECT에 매칭된다면 서버 오류로 단정하기 전에 규칙의 의도를 먼저 확인하세요.

규칙 참고 자료 보기

SUBSCRIPTION & CONFIG FILE

구독 및 구성 파일

서버 항목에는 연결에 필요한 매개변수가 들어 있고, 구독은 항목을 가져오거나 업데이트하며, 구성 파일은 라우팅과 관련 설정을 정리합니다. 가져오기에 성공한 뒤에도 콘텐츠 유형과 현재 활성화 상태를 확인해야 합니다.

서버 / 노드

일반적으로 노드는 연결에 사용할 수 있는 서버 매개변수 모음을 가리킵니다. 프로토콜, 주소, 포트, 인증 정보, 전송 옵션 등이 포함됩니다. 표시되는 노트는 이름일 뿐이며, 이름을 바꿔도 서버의 실제 위치나 연결 방식은 바뀌지 않습니다. 문제를 점검할 때는 매개변수를 확인하고, 자료를 공유할 때는 비밀번호, UUID 및 기타 인증 정보를 가리세요.

구성 파일

구성 파일은 섹션별 텍스트로 라우팅과 관련 설정을 구성합니다. 자주 사용하는 섹션 이름은 [General], [Rule], [Host], [URL Rewrite]입니다. 서버 구독과는 다릅니다. 규칙 파일이 있어도 연결에 필요한 서버 정보가 포함되어 있다는 뜻은 아닙니다. 가져온 뒤에는 사용할 구성을 선택했는지 확인하고 DNS, 기본 정책, 재작성 내용을 먼저 살펴보세요.

Host

Host 섹션은 특정 도메인과 주소의 매핑을 정의합니다. 예를 들어 example.com = 192.0.2.1은 문서용 예시입니다. 도메인이 어느 주소로 연결되는지에 영향을 주지만, 해당 연결이 PROXY와 DIRECT 중 어느 경로를 사용할지 지정하지는 않습니다. 대상 주소가 바뀌었는데 이전 매핑을 유지하면 연결이 오래된 주소를 계속 가리킬 수 있으므로 일반 DNS 조회 결과와 구분해 확인하세요.

URL Rewrite

URL Rewrite는 매칭 조건에 따라 URL을 재작성하는 기능으로, Rule 섹션에서 연결 경로를 정하는 것과 용도가 다릅니다. 규칙 적용 여부는 요청 정보의 가시성, 매칭 표현식, 관련 설정에 따라 달라지므로 임의의 URL을 입력한다고 항상 적용되는 것은 아닙니다. 재작성 내용이 포함된 구성을 가져오기 전에 매칭 범위와 처리 결과를 이해해 콘텐츠 처리 문제와 라우팅 문제를 혼동하지 않도록 하세요.

DIAGNOSTICS & CONNECTION

진단 및 연결

‘대상 조회’, ‘연결 설정’, ‘인증 확인’, ‘규칙 매칭’을 나누어 점검하세요. 한 번에 한 종류의 매개변수만 변경하고 변경 전후의 결과를 기록해야 실제 실패 지점을 찾을 수 있습니다.

Connectivity Test

Connectivity Test는 선택한 테스트 방식으로 서버 연결 가능 여부를 확인하며, 결과는 해당 테스트에서 사용한 경로와 대상에만 적용됩니다. 테스트에 성공해도 모든 웹사이트, 프로토콜, 규칙 경로가 정상 작동한다는 뜻은 아닙니다. 실제 대상 접속, 현재 Global Routing, 연결 기록을 함께 확인하세요. 한 번의 테스트를 전체 연결의 증거로 간주하지 마세요.

지연 시간

지연 시간은 특정 테스트 조건에서 요청과 응답에 걸린 시간을 나타내며, 대역폭이나 다운로드 속도와 같지 않습니다. 테스트 방식, 대상, 네트워크 상태가 다른 수치를 단순 비교할 수 없으며, 시간 초과가 모든 조건에서 서버를 사용할 수 없다는 뜻도 아닙니다. 비교할 때는 테스트 방식과 네트워크 환경을 동일하게 유지하고 여러 번의 결과와 실제 접속 상태를 함께 살펴보세요.

DNS

DNS는 도메인을 조회해 주소 등의 레코드를 확인하는 시스템이며, 일반적으로 연결을 설정하기 전에 대상 주소를 알아내야 합니다. DNS 조회 실패와 주소를 얻은 뒤 발생하는 연결 실패는 서로 다른 단계이므로 서버 비밀번호를 바꿔도 전자의 문제는 해결되지 않습니다. 먼저 조회 결과가 반환되는지 확인하고, IPv4 또는 IPv6 주소 중 무엇을 받았는지와 이후 어떤 라우팅 규칙이 적용되었는지 살펴보세요.

TLS / SNI

TLS는 전송 데이터를 암호화하고 인증서로 신원을 확인하며, SNI는 핸드셰이크 과정에서 요청할 서버 이름을 전달합니다. 연결에 사용하는 주소와 이름 확인에 사용하는 도메인은 다를 수 있으므로 보유한 정보에 따라 각각 입력하세요. 핸드셰이크에 실패하면 서버 이름, 기기 시간, 인증서 체인, 서버 측 설정을 확인하고 인증서 검증은 유지한 채 오류 원인을 찾아야 합니다.

연결 기록

연결 기록에서는 대상 도메인이나 주소, 매칭된 규칙, 실제 적용된 정책, 오류 단서를 확인할 수 있어 연결 스위치만 보는 것보다 구체적인 문제를 파악하기 쉽습니다. 오류를 재현할 때 시간과 대상을 기록한 뒤 해당 연결을 찾아 규칙에 따른 거부, DNS 조회 실패, 연결 시간 초과를 구분하세요. 기록을 외부에 공유하기 전에는 구독 주소, 인증 정보, 공개할 필요가 없는 접속 내용을 가리세요.

문제별 추가 안내

보유한 서버 정보를 처음 추가한다면 사용 안내에 따라 가져오기, Global Routing 선택, 연결 확인을 진행하세요. 연결은 되지만 트래픽 분기가 예상과 다르면 규칙 참고 자료에서 매칭 순서와 정책을 확인하세요. 구독 업데이트나 대상 연결에 문제가 있다면 자주 묻는 질문을 따라 항목별로 점검할 수 있습니다.

구매, 구입 항목 복원, 기기 호환성은 스토어 정보이며 프로토콜 매개변수로 판단할 수 없습니다. 정품 확인 안내에서 개발자 Shadow Launch Technology Limited와 앱 ID 932747118를 확인하세요. 시스템 요구 사항과 기기 호환성은 App Store 페이지 표기를 기준으로 합니다.

용어 분류로 돌아가기 ↑