Home
Home은 서버 항목과 연결 상태를 확인하는 시작 화면입니다. 연결하기 전에 현재 선택된 항목을 확인하고 Global Routing 설정을 점검하세요. 항목이 표시된다고 해서 인증이 완료되었거나 사용할 수 있다는 뜻은 아닙니다. 정보를 추가하려면 Add Server 또는 기존 구독 가져오기 절차를 이용하세요.
OFFICIAL MANUAL · GLOSSARY
Shadowrocket
용어 및 규칙 빠른 참조
먼저 용어가 어느 단계에 해당하는지 확인한 다음 관련 설정을 수정하세요. 이 페이지에서는 영어 인터페이스 용어, 프로토콜 이름, 규칙 키워드의 의미를 설명합니다. 작업 순서를 따라 설정하려면 사용 설명서를 확인하세요.
UI · 인터페이스 단계
RULE · 규칙 단계
대소문자를 구분하세요. Proxy는 인터페이스 설정이고 PROXY는 규칙 정책입니다. 두 항목을 같은 설정으로 보지 마세요.
01 / INTERFACE & SWITCHES
인터페이스 및 설정
인터페이스 메뉴는 작업을 구성하고, Global Routing은 전체 처리 방식을 결정합니다. 구체적인 규칙이 매칭되는지 확인하기 전에 메뉴 위치와 현재 설정부터 확인하세요.
Global Routing
Global Routing은 전체 트래픽 처리 방식을 결정하며, 설정은 Config(구성), Proxy(프록시), Direct(직접 연결) 세 가지입니다. Config는 현재 구성에 따라 경로를 판단하고, 나머지 두 설정은 전체 트래픽에 프록시 또는 직접 연결 경로를 사용합니다. 점검을 시작하기 전에 현재 설정을 기록해 두면 설정 변화와 규칙 변화를 혼동하지 않을 수 있습니다.
Config
Config는 구성 관리 화면을 뜻하기도 하고, Global Routing에서 구성에 따라 트래픽을 처리하는 설정을 뜻하기도 합니다. 화면 위치에 따라 의미를 구분하세요. 이 설정을 선택하면 트래픽 경로는 현재 적용 중인 구성에 따라 결정됩니다. 파일을 가져오는 것만으로 활성화되는 것은 아니므로 현재 구성과 Rule 내용을 확인하세요.
Proxy
Proxy는 Global Routing에서 프록시 경로를 사용하는 설정으로, 현재 서버 연결 상태를 점검할 때 활용할 수 있습니다. Proxy에서는 접속되지만 Config에서는 문제가 생긴다면 규칙과 이름 해석 설정을 추가로 확인하세요. 규칙 행의 대문자 PROXY와는 다른 항목입니다. 테스트를 마치면 필요한 원래 설정으로 되돌리세요.
Direct
Direct는 Global Routing에서 직접 연결 경로를 사용하는 설정으로, 현재 네트워크에서 직접 접속할 때의 상태를 확인할 수 있습니다. 저장된 서버나 구성을 삭제하지 않으며 시스템 VPN 상태를 끄는 것과도 다릅니다. 진단할 때는 라우팅 설정, 연결 스위치, 대상 접속 결과를 각각 기록하세요.
On Demand
On Demand는 설정된 조건에 따라 연결을 시작하며, Wi-Fi, 셀룰러 네트워크, 도메인 등이 조건에 포함될 수 있습니다. 수동으로 연결을 끊었는데 다시 연결된다면 먼저 연결 조건이 여전히 충족되는지 확인하세요. 조건과 순서를 하나씩 점검하고 실제로 네트워크를 전환한 뒤 동작을 확인하세요. 스위치 모양만 보고 판단하지 마세요.
Settings
Settings는 앱 관련 설정을 관리하는 메뉴이며, 세부 옵션은 현재 앱에 표시되는 문구를 기준으로 확인하세요. 문제가 생기면 먼저 기존 값을 기록하고 한 번에 하나씩 변경해야 원인을 판단하기 쉽습니다. 구성 파일의 관련 설정도 함께 확인하세요. 메뉴 이름만으로 최종 동작을 단정할 수는 없습니다.
Data
Data에서는 트래픽과 요청 관련 기록을 확인할 수 있어 실제 접속 후 상태를 점검할 때 유용합니다. 트래픽 수치가 늘었다는 사실만으로 요청이 의도한 정책을 따랐다고 볼 수는 없습니다. 대상 도메인, 매칭된 규칙, 연결 결과를 함께 살펴보세요. 기록을 공유하기 전에 민감한 정보를 삭제하세요.
02 / PROTOCOLS
프로토콜
프로토콜은 양쪽에서 연결을 맺고 데이터를 주고받는 방식을 정합니다. 기존 서버 정보와 일치하는 유형을 선택해야 합니다. 이름이나 필드가 비슷해도 매개변수를 서로 바꿔 쓸 수 있는 것은 아닙니다.
Shadowsocks
Shadowsocks는 양쪽에서 동일한 암호화 방식과 인증 정보를 사용해야 하는 프록시 프로토콜입니다. 주소, 포트, 비밀번호와 서버에서 요구하는 추가 매개변수를 모두 확인하세요. 비밀번호만 점검해서는 안 됩니다. 가져온 뒤 연결되지 않으면 원본 정보를 항목별로 대조하고 암호화 방식을 임의로 바꾸지 마세요.
VMess
VMess는 사용자 정보를 사용해 인증하며, 전송 방식과 TLS 설정도 연결에 영향을 줍니다. 서버 주소, 사용자 ID, 경로, 서버 이름은 서로 다른 역할을 할 수 있으므로 대체할 수 없습니다. 인증 정보가 맞는데 연결에 실패한다면 기기 시간과 해당 전송 매개변수도 확인하세요.
VLESS
VLESS는 인증 정보와 전송 보안 설정을 별도로 다루므로, 사용자 ID만으로 연결이 완전히 보호된다고 볼 수는 없습니다. 항목을 추가할 때 전송 유형, TLS, 서버에서 지정한 매개변수를 함께 확인하세요. 주소와 포트가 같더라도 다른 프로토콜의 구성을 그대로 사용하지 마세요.
Trojan
Trojan은 일반적으로 TLS와 비밀번호 인증을 함께 사용해 프록시 연결을 설정합니다. 인증서 검증은 연결 상대의 신원을 확인하는 중요한 절차입니다. 주소, 포트, 비밀번호 외에도 서버 이름과 전송 설정을 점검하세요. 인증서 오류가 발생하면 이름, 시간, 구성 출처를 먼저 확인하고 검증 건너뛰기를 일반적인 해결책으로 사용하지 마세요.
HTTP
서버 유형으로 선택하는 HTTP는 HTTP 프록시를 뜻하며, 주소창에 웹페이지 URL을 입력하는 항목이 아닙니다. 서버 필드에는 일반적으로 호스트 이름이나 IP를 입력하고 포트와 인증 정보는 각각 설정합니다. 프록시 연결의 TLS 사용 여부와 대상 웹사이트의 HTTPS 사용 여부는 별개이므로 기존 구성을 기준으로 따로 확인하세요.
SOCKS5
SOCKS5는 프록시 서버를 통해 연결을 전달하며 서버 설정에 따라 사용자 이름과 비밀번호로 인증할 수 있습니다. 프로토콜 이름만으로 연결이 암호화되었다고 볼 수 없고, UDP 지원 여부도 양쪽 설정과 네트워크 환경에 따라 달라집니다. 인증이 필요한지 확인하고 빈 비밀번호가 모든 서버의 기본값이라고 가정하지 마세요.
Hysteria2
Hysteria2는 QUIC 기반으로 UDP를 통해 연결하므로, 네트워크에서 UDP를 사용할 수 있는지가 핸드셰이크와 데이터 전송에 영향을 줍니다. 주소, 인증, TLS 매개변수를 확인한 뒤 네트워크 환경을 점검하세요. TCP 테스트 하나가 성공했다고 해서 이 프로토콜의 연결 경로도 정상이라고 볼 수는 없습니다.
WireGuard
WireGuard는 공개 키와 개인 키, 피어 구성을 사용해 터널을 설정하며 일반적인 사용자 이름과 비밀번호를 입력하는 방식은 사용하지 않습니다. 인터페이스 주소, 개인 키, 피어 공개 키와 관련 라우팅 매개변수가 서로 맞는지 확인하세요. 개인 키는 민감한 인증 정보입니다. 진단 정보를 제출하거나 구성을 공유할 때 삭제하고, 전체 구성을 공개하지 마세요.
03 / RULE KEYWORDS
규칙 키워드
규칙은 ‘무엇을 매칭할지’와 ‘매칭 후 어떻게 처리할지’를 한 줄에 지정합니다. 아래 구문은 문법 설명용이며, 기존 설정을 대체해 바로 사용할 수 있는 완성된 구성은 아닙니다.
Rule
Rule은 구성에서 트래픽 경로를 결정하는 매칭 규칙이며, 일반적으로 위에서 아래 순서로 판단합니다. 구체적인 조건은 포괄적인 조건보다 앞에 두고 기본 규칙은 마지막에 배치하세요. 규칙을 추가한 뒤에는 실제 요청 기록으로 매칭 결과를 확인해야 합니다. 문장이 맞아 보인다는 이유만으로 검증을 끝내지 마세요.
DOMAIN
DOMAIN은 전체 도메인을 매칭하므로 특정 호스트 이름 하나를 처리할 때 적합합니다. 해당 도메인의 모든 하위 도메인에 자동 적용되지는 않습니다. 도메인 필드에 URL 프로토콜, 경로, 쿼리 매개변수를 넣지 마세요. 아래 규칙은 지정한 도메인 하나만 대상으로 합니다.
DOMAIN,example.com,PROXYDOMAIN-SUFFIX
DOMAIN-SUFFIX는 도메인 접미사를 기준으로 매칭해 지정한 도메인과 하위 도메인에 적용할 수 있습니다. 단일 DOMAIN 조건보다 범위가 넓어 관련 도메인 여러 개를 같은 방식으로 처리할 때 적합합니다. 수정하기 전에 하위 도메인에도 같은 정책을 적용해야 하는지 확인해 예외 요청까지 함께 매칭되지 않도록 하세요.
DOMAIN-SUFFIX,example.com,PROXYDOMAIN-KEYWORD
DOMAIN-KEYWORD는 도메인에 포함된 키워드를 기준으로 매칭하며, 키워드가 특정 접미사 위치에 있어야 하는 것은 아닙니다. 이름이 비슷하지만 관련 없는 도메인까지 포함될 수 있으므로 적용 범위를 신중히 정하세요. 전체 도메인이나 접미사를 명확히 지정할 수 있다면 매칭 범위를 확인하기 더 쉽습니다.
DOMAIN-KEYWORD,adservice,REJECTIP-CIDR
IP-CIDR은 IPv4 대역을 기준으로 매칭하며, 슬래시 뒤의 접두사 길이가 주소 범위를 결정합니다. 예시 대역은 로컬 네트워크 주소의 직접 연결 규칙을 설명하기 위한 것으로, 모든 네트워크에 그대로 적용할 수는 없습니다. IPv6 주소에는 해당하는 IP-CIDR6 규칙을 사용하세요. 수정하기 전에 대상 주소 유형을 확인하세요.
IP-CIDR,192.168.0.0/16,DIRECTGEOIP
GEOIP는 IP 지리 데이터베이스의 분류 결과에 따라 대상 주소를 매칭하며, 웹페이지 언어나 사용자의 위치를 기준으로 판단하지 않습니다. 데이터베이스의 분류와 실제 서비스 배포 위치가 다를 수 있으므로 웹사이트 신원을 증명하는 용도로 사용할 수 없습니다. 트래픽 분기 결과가 예상과 다르면 실제로 해석된 주소와 규칙 순서를 대조하세요.
FINAL
FINAL은 앞선 규칙에 매칭되지 않은 트래픽을 처리하는 구성의 기본 규칙입니다. 일반적으로 규칙의 마지막에 배치하며, 선택한 정책은 조건에서 누락된 모든 요청에 영향을 줍니다. 많은 트래픽이 FINAL에 도달한다면 서버를 바로 바꾸기보다 앞선 조건이 지나치게 좁거나 빠져 있지 않은지 확인하세요.
FINAL,PROXYPROXY / DIRECT / REJECT
이 대문자 키워드 세 가지는 규칙 매칭 후 적용되는 처리 정책입니다. PROXY는 프록시 경로, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 매칭 조건을 정의하는 키워드는 아니며 Global Routing의 인터페이스 설정과도 다릅니다. 규칙을 확인할 때 키워드, 매칭 대상, 마지막 처리 정책을 함께 살펴보세요.
04 / SUBSCRIPTION & CONFIGURATION
구독 및 구성
서버 항목에는 연결 매개변수를 저장하고, 구성 파일에는 처리 규칙을 정리하며, 구매 기록은 앱을 이용할 수 있는지 확인합니다. 세 가지는 각각 관리해야 하며 서로 대체할 수 없습니다.
Add Server
Add Server에서는 사용자가 보유한 서버 정보를 직접 추가할 수 있습니다. 먼저 정보와 일치하는 프로토콜 유형을 선택하세요. 그런 다음 주소, 포트, 인증 및 전송 매개변수를 각각 입력하고 불필요한 공백과 대소문자를 확인하세요. 저장 후 연결을 테스트해야 합니다. 저장에 성공했다는 것은 항목이 기록되었다는 뜻이지 원격 서버 인증이 완료되었다는 뜻은 아닙니다.
Subscribe
Subscribe는 사용자가 보유한 서버 항목을 가져오고 업데이트하는 기능입니다. 구독 링크는 본인이 이용하는 서비스 제공업체에서 받아야 합니다. 항목을 업데이트해도 특정 항목이 자동으로 선택되거나 모든 항목이 사용 가능해지는 것은 아닙니다. 링크에 인증 정보가 포함될 수 있으므로 공개하지 마세요. 업데이트에 실패하면 기존에 사용할 수 있던 정보를 먼저 보존한 뒤 원본 링크를 확인하세요.
.conf
.conf는 구성 내용을 정리하는 파일 형식으로, General, Rule, Host 등의 섹션을 포함할 수 있습니다. 각 섹션은 전체 동작, 규칙, 주소 매핑을 다루며 서버 구독과는 다릅니다. 가져오기 전에 내용을 확인하고 기존 구성을 보존하세요. 가져온 뒤에는 활성화 상태도 점검하세요. 전체 구조는 시스템 가이드에서 확인할 수 있습니다.
URL Rewrite
URL Rewrite는 매칭 조건에 따라 요청 URL을 수정하거나 처리하며, 연결 경로를 결정하는 Rule과는 적용 단계가 다릅니다. 대상 주소가 바뀌는 문제를 점검할 때는 관련 재작성 조건이 있는지도 확인하세요. 모든 접속 실패를 해결하는 만능 옵션은 아니므로, 규칙의 용도를 확인한 뒤 활성화 여부를 결정하세요.
iCloud 동기화
iCloud 동기화는 해당 설정과 권한이 허용된 경우 iCloud를 통해 앱 관련 데이터를 동기화하는 기능입니다. 구체적인 동기화 범위는 앱 내 옵션을 확인하세요. 동기화는 구매 복원과 다르며 서버 서비스의 유효성에도 영향을 주지 않습니다. 기기를 옮기기 전에 동기화가 완료되었는지 확인하고 중요한 구성은 별도로 보관하세요. 한 번의 동기화를 완전한 백업으로 간주하지 마세요.
구입 항목
구입 항목은 App Store에서 구매한 앱을 찾는 메뉴입니다. 기기를 바꾸거나 앱을 다시 설치할 때는 먼저 기존에 구매한 계정을 사용하고 있는지 확인하세요. 앱을 복원해도 모든 로컬 구성이 복원되는 것은 아니므로 서버 정보는 따로 확인해야 합니다. 시스템 요구 사항과 구매 적용 범위는 App Store 페이지의 안내를 기준으로 확인하세요. 자세한 절차는 구입 항목 복원 안내를 참조하세요.
05 / CONNECTION & DIAGNOSTICS
연결 및 진단
문제를 이름 해석, 연결, 인증, 규칙, 실제 접속 단계로 나눠 확인하세요. 한 단계의 성공은 해당 단계에 대한 근거일 뿐, 전체 연결 경로가 정상적으로 검증되었다는 뜻은 아닙니다.
DNS
DNS는 도메인을 IP 주소로 변환하며, 대부분의 연결이 시작되기 전에 이루어집니다. 도메인 이름 해석은 성공했지만 접속에 실패한다면 이후 연결 또는 인증 단계에 문제가 있을 수 있습니다. 이름 해석 실패만으로 서버를 사용할 수 없다고 단정할 수도 없습니다. DNS 설정을 바꾸기 전에 기존 값을 기록하고 요청 기록을 함께 확인하세요. 규칙과 서버 설정을 동시에 변경하지 마세요.
Connectivity Test
Connectivity Test는 지정한 테스트 방식과 대상에 대해 연결 항목의 통신 상태를 확인하며, 결과는 해당 테스트 조건에서만 유효합니다. 테스트에 성공해도 모든 대상 서비스에 접속할 수 있다는 보장은 없고, 실패 원인도 프로토콜과 네트워크 환경을 함께 확인해야 합니다. 테스트 후에는 실제 대상에 접속해 보고 Global Routing 설정과 매칭된 정책을 확인하세요.
지연 시간
지연 시간은 특정 테스트 방식으로 측정한 응답 시간이며 다운로드 대역폭이나 장시간 연결의 안정성을 직접 나타내지는 않습니다. 테스트 대상, 접속 네트워크, 측정 시각에 따라 결과가 달라지므로 서로 다른 조건의 결과를 단순 비교하지 마세요. 비교할 때는 테스트 조건을 통일하고 실제 요청 성공 여부도 함께 확인하세요.
VPN 구성 승인
VPN 구성 승인은 앱이 해당 네트워크 구성을 만들도록 시스템에서 허용하는 단계입니다. 처음 연결할 때 사용자 확인과 기기 인증이 필요할 수 있습니다. 승인 후 연결 상태가 표시되더라도 원격 서버에 접속할 수 있다는 뜻은 아닙니다. 연결을 시작할 수 없다면 시스템 권한을 먼저 확인하세요. 연결되었지만 접속에 문제가 있다면 서버, 이름 해석, 규칙을 점검하세요.
서버
서버 항목에는 원격 주소, 프로토콜, 인증 매개변수가 저장됩니다. 연결 항목 하나를 노드라고 부르는 경우도 있습니다. 항목 이름은 구분을 위한 표시일 뿐, 실제 주소나 기능 또는 상태를 보증하지 않습니다. 문제를 점검할 때는 원본 정보와 매개변수를 대조하고 통신 상태, 인증, 대상 접속을 각각 확인하세요. 이름이나 한 번의 지연 시간 결과만으로 판단하지 마세요.