Home
Home은 서버 항목을 확인하고 연결 스위치를 조작하는 메뉴입니다. 목록에 항목이 보인다는 것은 매개변수가 저장되었다는 뜻일 뿐, 인증에 성공했거나 연결이 실행 중이라는 뜻은 아닙니다. 가져온 뒤에는 선택한 항목을 확인하고, Global Routing을 확인한 다음 연결을 켜 실제 요청이 처리되는지 검증하세요.
OFFICIAL GUIDE · TERMS
인터페이스 이름으로 기능을 찾고, 규칙 키워드로 매칭 범위를 확인하세요. 이 페이지는 용어를 영어 원문 그대로 표기하고 각 항목의 차이를 설명합니다. 버튼 위치와 사용 가능한 항목은 현재 기기의 Shadowrocket을 기준으로 확인하세요.
다운로드 및 설치는 두 가지 방식으로 나뉩니다. iPhone/iPad 버전은 App Store에서 $2.99 일회성 결제이며, Mac/Windows/Android/Linux 버전은 무료입니다. Mac 버전은 Apple 실리콘용과 Intel용으로 제공됩니다. 다운로드 경로와 설치 방법은 전체 플랫폼 다운로드에서 확인하세요. 컴퓨터 및 Android 설치 파일은 이 사이트의 /dl/ 경로를 사용합니다.
INTERFACE / 01
‘어떤 서버를 선택했는지’, ‘어떤 라우팅 모드를 사용하는지’, ‘연결이 설정되었는지’를 구분해야 합니다. 각각 연결 대상, 요청의 처리 경로, 현재 상태에 영향을 주며 서로 대신할 수 없습니다.
Home은 서버 항목을 확인하고 연결 스위치를 조작하는 메뉴입니다. 목록에 항목이 보인다는 것은 매개변수가 저장되었다는 뜻일 뿐, 인증에 성공했거나 연결이 실행 중이라는 뜻은 아닙니다. 가져온 뒤에는 선택한 항목을 확인하고, Global Routing을 확인한 다음 연결을 켜 실제 요청이 처리되는지 검증하세요.
Global Routing은 요청의 전체 처리 방식을 결정합니다. Config는 설정, Proxy는 프록시, Direct는 직접 연결에 해당합니다. Config는 현재 설정에 따라 트래픽을 분기하고, Proxy는 요청을 프록시 경로로 전달하며, Direct는 직접 연결합니다. 규칙이 적용되지 않는 문제를 확인할 때는 규칙을 바로 수정하기보다 먼저 Config 모드인지 확인하세요.
Config는 설정 관리 메뉴이자 Global Routing의 모드 이름으로도 사용됩니다. 설정 파일에는 규칙, DNS 등의 설정이 포함될 수 있지만 서버 목록과 설정 파일은 서로 다른 데이터입니다. 설정 파일을 가져왔더라도 현재 사용 중인 설정이 되었다는 뜻은 아닙니다. 수정하기 전에 현재 선택 항목을 기록하고 백업을 보관하세요.
On Demand를 사용하면 설정한 조건에 따라 시스템이 VPN 연결을 시작합니다. 연결 시점을 제어하는 기능이며 비밀번호, 서버 주소, 규칙 내용을 수정하지는 않습니다. 켜기 전에 수동 연결이 가능한지 확인하세요. 수동으로 연결을 끈 뒤 다시 연결된다면 전체 스위치를 반복해서 조작하기보다 기존 On Demand 조건을 확인하세요.
Add Server는 보유한 서버 정보를 직접 입력하는 메뉴입니다. 먼저 프로토콜 유형을 선택한 뒤 주소, 포트, 해당 프로토콜의 인증 항목을 입력하세요. TLS와 전송 방식 등의 추가 옵션은 서버 설정과 일치해야 합니다. 프로토콜마다 필요한 항목이 다르므로 다른 유형의 항목에 있는 매개변수를 그대로 입력하지 마세요.
Connectivity Test는 지정된 테스트 조건에서 연결 가능한지 확인합니다. 결과는 테스트 대상, 로컬 네트워크, 서버 상태의 영향을 받습니다. 테스트에 성공해도 모든 웹사이트나 앱에 접속할 수 있다는 뜻은 아니며, 수치가 낮다고 다운로드 속도가 반드시 더 빠른 것도 아닙니다. 결과를 비교할 때는 테스트 방식과 네트워크 환경을 동일하게 유지하세요.
PROTOCOLS / 02
프로토콜 이름은 양쪽이 통신하는 방식을 설명할 뿐, 속도 순위를 나타내지 않습니다. 실제 사용 가능 여부는 서버 설정, 로컬 네트워크와 전송 조건에 따라 달라집니다. 설정할 때는 보유한 서버 정보를 기준으로 입력하세요.
Shadowsocks는 암호화 프록시 프로토콜입니다. 일반적인 매개변수는 서버 주소, 포트, 암호화 방식, 비밀번호입니다. 암호화 방식은 서버와 일치해야 합니다. 비밀번호가 맞더라도 암호화 방식이 다르면 연결이 실패할 수 있습니다. 기존 항목에 다른 전송 옵션이 있다면 함께 확인하고 주소와 비밀번호만 입력하지 마세요.
VMess는 프록시 프로토콜로, 인증 식별 정보와 전송 설정이 함께 맞아야 연결됩니다. UUID, 전송 방식, 경로, TLS 등의 항목은 서로 다른 계층에 속하므로 한 항목이 같다고 전체 설정도 같다고 볼 수 없습니다. 가져온 뒤 각 항목을 기존 정보와 대조하세요. 인증 문제가 발생하면 기기 시간이 정확한지도 확인할 수 있습니다.
VLESS는 프록시 프로토콜입니다. 인증 방식과 하위 전송 보안은 별도로 이해해야 합니다. VLESS를 선택했다고 해서 TLS나 다른 보안 설정이 자동으로 맞춰지는 것은 아닙니다. UUID, 서버 이름, 전송 관련 항목은 실제 서버 설정에 맞춰 입력하고, 다른 항목의 매개변수를 섞어 쓰지 마세요.
Trojan은 일반적으로 TLS와 함께 사용합니다. 비밀번호 인증과 TLS 핸드셰이크는 별도로 확인해야 합니다. 주소, 포트, 비밀번호와 서버 이름이 기존 설정과 일치하는지 확인하세요. 인증서 또는 서버 이름 관련 오류가 발생하면 도메인과 기기 시간을 먼저 확인하고, 인증서 검증 건너뛰기를 일반적인 해결 방법으로 사용하지 마세요.
Hysteria2는 QUIC 기반이며 하위 네트워크에서 UDP 통신이 가능해야 합니다. 패킷 손실이 큰 일부 연결 환경에서 유용할 수 있지만, 네트워크에서 UDP를 제한하거나 경로가 불안정하면 연결되지 않을 수 있습니다. 프로토콜 이름만으로 속도를 보장할 수는 없습니다. 테스트할 때는 네트워크를 전환하기 전후의 연결 가능 여부와 실제 서비스 이용 상태를 함께 확인하세요.
WireGuard는 키 인증 기반 터널 프로토콜입니다. 엔드포인트, 인터페이스 주소, 피어의 공개 키와 라우팅 범위를 함께 설정해야 합니다. 개인 키는 민감 정보이므로 공개 스크린샷, 로그 또는 공유 자료에 포함하지 마세요. 터널이 연결되어도 모든 대상에 도달할 수 있는 것은 아니므로 라우팅 범위와 DNS 설정도 확인해야 합니다.
HTTP와 SOCKS5는 서로 다른 프록시 프로토콜 유형입니다. 필요한 인증 방식과 사용 가능한 기능은 서버 구현에 따라 달라집니다. 프로토콜 이름만으로 동일한 암호화 보호를 제공한다고 볼 수 없으며, HTTP 프록시를 이름만 보고 HTTPS 연결로 간주해서도 안 됩니다. 서버가 실제로 제공하는 유형을 정확히 선택하고 보안 설정을 따로 확인하세요.
전송 조건에 대해 더 알아보려면 Hysteria2와 QUIC의 사용 조건을 읽어보세요.
RULE KEYWORDS / 03
일반적인 규칙은 매칭 유형, 매칭 대상, 처리 방식으로 구성됩니다. 규칙의 순서에 따라 결과가 달라질 수 있습니다. 아래 설명은 문법을 이해하기 위한 것이며, 예시를 모두 현재 설정에 추가해야 한다는 뜻은 아닙니다.
Rule은 ‘어떤 조건을 만족할 때 어떤 방식으로 처리할지’를 지정합니다. 순서대로 확인하는 규칙 목록에서는 앞쪽의 유효한 매칭이 먼저 처리 경로를 결정하는 경우가 많으므로, 더 구체적인 규칙의 위치에 유의하세요. 규칙을 추가한 뒤에는 실제로 매칭되는지 확인해야 합니다. 파일에 해당 줄이 있다는 이유만으로 적용되었다고 판단할 수는 없습니다.
DOMAIN-SUFFIX는 도메인 접미사로 매칭합니다. 예를 들어 example.com은 해당 도메인과 하위 도메인에 적용될 수 있습니다. URL 경로나 쿼리 매개변수가 아니라 도메인을 대상으로 합니다. 적용 범위를 확인해 범위가 넓은 접미사 규칙이 별도 처리가 필요한 하위 도메인보다 먼저 매칭되지 않도록 하세요.
DOMAIN은 도메인 전체를 매칭하고, DOMAIN-KEYWORD는 도메인에 지정한 키워드가 포함되어 있는지 확인합니다. 후자는 적용 범위가 더 넓어 이름이 비슷하지만 용도가 다른 도메인까지 매칭할 수 있습니다. 특정 호스트만 처리하려면 전체 도메인 매칭의 범위를 확인하고, 키워드 규칙을 접미사 규칙처럼 사용하지 마세요.
GEOIP는 IP 지리 데이터베이스를 기준으로 주소의 위치를 판단합니다. 예를 들어 GEOIP,CN,DIRECT는 매칭된 주소를 DIRECT로 처리한다는 뜻입니다. 데이터베이스 결과는 회사 등록 국가 또는 현재 사용자의 실제 위치와 같지 않습니다. 도메인 해석 결과와 데이터베이스 내용이 모두 판단에 영향을 주므로 결과가 예상과 다르면 실제 대상 IP를 확인하세요.
IP-CIDR은 IPv4 주소 범위에, IP-CIDR6은 IPv6 주소 범위에 사용합니다. 슬래시 뒤의 숫자는 네트워크 접두사 길이입니다. 도메인 텍스트가 아니라 IP 범위를 기준으로 매칭합니다. 같은 서비스도 여러 주소를 반환하거나 IPv4와 IPv6를 함께 사용할 수 있으므로, 하나의 주소 범위만으로 모든 연결을 처리하지 못할 수 있습니다.
FINAL은 앞선 규칙에 매칭되지 않은 요청에 적용하는 기본 처리 방식으로, 보통 규칙 맨 끝에 둡니다. 특정 도메인을 매칭하는 것이 아니라 나머지 요청의 처리 경로를 결정합니다. FINAL을 수정하기 전에 기존 처리 방식이 적절한지, 규칙에서 제외되는 요청의 범위가 어디까지인지 확인하세요. 몇몇 웹사이트만 확인하고 검토를 끝내지 않도록 주의해야 합니다.
이 대문자 단어들은 규칙의 처리 방식을 나타냅니다. PROXY는 프록시 경로로 전달, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. Global Routing 화면의 Proxy, Direct와는 서로 다른 계층의 용어입니다. DIRECT도 요청이 클라이언트의 처리 과정을 전혀 거치지 않는다는 뜻은 아니므로, 현재 설정의 DNS 및 라우팅 동작을 함께 살펴보세요.
USER-AGENT는 식별 가능한 요청의 User-Agent 정보를 기준으로 매칭합니다. 모든 연결에서 이 정보를 확인할 수 있는 것은 아니며, 앱 식별 정보를 안정적으로 대신하지도 않습니다. 같은 앱에서도 다양한 요청이 발생할 수 있습니다. 암호화된 요청에서 확인 가능한 정보는 처리 조건에 따라 달라지므로, 이 규칙을 추가하면 앱의 모든 트래픽을 식별할 수 있다고 가정하지 마세요.
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
SUBSCRIPTION & CONFIGURATION / 04
구독은 기존 서버 항목을 관리하고, 설정은 규칙과 관련 동작을 구성하는 데 사용합니다. 둘을 함께 사용할 수도 있지만 가져오기, 업데이트, 백업 시에는 각각의 대상을 확인해야 합니다.
Subscribe를 사용하면 보유한 구독 주소에서 서버 항목을 일괄로 가져오거나 업데이트할 수 있습니다. 업데이트로 이름, 매개변수 또는 항목 수가 바뀔 수 있으므로 로컬에서 직접 수정한 내용이 항상 유지된다고 볼 수 없습니다. 구독 주소에는 접근 자격 정보가 포함될 수 있으므로 민감 정보로 취급하세요. 업데이트에 실패하면 주소가 완전한지와 현재 네트워크 상태를 먼저 확인하세요.
SERVER는 일반적으로 서버 주소 필드나 관련 항목 식별 정보를 가리키며, 도메인 또는 IP 주소를 입력할 수 있습니다. 서버 항목을 연결에 사용하려면 프로토콜, 포트와 인증 정보도 필요하므로 주소만으로는 충분하지 않습니다. 표시 이름은 항목을 구분하기 위한 라벨일 뿐, 서버의 실제 위치나 연결 품질을 알려주지 않습니다.
Scan QR Code는 QR 코드에 인코딩된 가져오기 데이터를 읽습니다. QR 코드 자체는 프록시 프로토콜이 아닙니다. 인식한 내용이 단일 서버 정보인지, 구독 주소인지, 다른 텍스트인지 확인한 다음 저장하세요. 비밀번호나 구독 자격 정보가 포함된 QR 코드는 공개하지 마세요. 가져오기에 성공한 뒤에도 연결을 확인해야 합니다.
DNS는 도메인을 IP 주소로 변환하며, 연결을 설정하기 전에 거치는 중요한 단계입니다. DNS 요청이 처리되는 경로와 이후 서비스 연결의 경로는 별도로 살펴봐야 합니다. DNS를 변경해도 모든 라우팅 문제가 자동으로 해결되는 것은 아닙니다. 도메인에 접속할 수 없다면 DNS 조회 실패, 주소에 연결할 수 없는 문제, 서버 인증 실패를 구분하세요.
URL Rewrite는 지정된 조건에 따라 URL 요청을 처리합니다. 요청을 PROXY 또는 DIRECT로 보내는 라우팅 규칙과는 다릅니다. 요청을 처리할 수 있는지는 규칙, 요청 유형과 관련 조건에 따라 달라집니다. 수정 전에 기존 설정을 보관하고, 매칭 범위를 정확히 이해한 경우에만 사용해 정상적인 서비스 요청에 영향을 주지 않도록 하세요.
지연 시간은 특정 테스트 조건에서의 응답 대기 시간을 나타내며, 대역폭이나 지속적인 다운로드 속도와는 다릅니다. 테스트 대상, 네트워크 혼잡, 프로토콜 핸드셰이크가 결과에 영향을 주므로 서로 다른 방식으로 측정한 수치를 직접 비교하기는 어렵습니다. 항목을 선택할 때는 한 번의 순위만 보지 말고 안정성, 실제 앱 사용 상태와 여러 차례의 테스트 결과를 함께 살펴보세요.
IPAD & APP STORE / 05
구매 기록, 앱 설치, 설정 데이터는 서로 다른 항목입니다. iPad에서 앱을 다시 받은 뒤에도 기존 서버 정보와 설정이 복원되었는지 따로 확인해야 합니다.
Apple ID는 App Store 구매 기록과 연결된 계정입니다. 구입 항목을 확인할 때는 ‘미디어 및 구입 항목’에 사용 중인 계정을 확인하세요. 이 계정과 기기의 iCloud 로그인 상태는 각각 확인해야 하며, iCloud에 로그인되어 있다는 사실만으로 구매 계정을 판단할 수 없습니다. 스토어 국가 또는 지역에 따라 앱을 검색하거나 다운로드할 수 있는지도 달라질 수 있습니다.
구입 항목에서 기존 구매 계정으로 취득한 앱을 찾을 수 있습니다. 같은 구매 계정으로 iPhone과 iPad에서 Shadowrocket을 찾아 다시 다운로드할 수 있습니다. 앱 구매 기록은 서버 데이터 백업과 다르므로 다시 다운로드한 뒤 설정이 남아 있는지 확인하세요. 다시 구매하라는 메시지가 나오면 계정과 해당 앱 항목을 먼저 확인하세요.
iCloud 동기화 여부는 앱이 실제로 지원하는 동기화 항목, 계정 및 시스템 설정에 따라 달라집니다. 모든 로컬 설정이 자동으로 복사된다고 볼 수는 없습니다. App Store 구매 기록 복원과도 별개이므로 앱을 복원했다고 해서 설정 동기화까지 완료된 것은 아닙니다. 기기를 바꾸기 전에 동기화할 수 있는 항목을 확인하고, 보관할 설정은 별도로 백업하세요.
앱 항목을 확인하려면 Shadowrocket App Store 페이지를 참고하세요. 계정 국가 및 지역, 구입 항목 복원, 플랫폼별 다운로드 방법은 다운로드 안내에서 확인할 수 있습니다.
이 페이지는 Shadowrocket 공식 가이드의 용어 색인입니다. 실제 연결 문제가 발생하면 현재 모드, 선택한 항목과 오류 메시지를 기록한 뒤 문제 해결에서 하나씩 확인하세요. 문제 해결 자료를 공유하기 전에 비밀번호, 개인 키, 전체 구독 주소를 삭제하세요.