Shadowrocket 공식 매뉴얼
Shadowrocket 용어 설명
인터페이스의 영어 용어로 메뉴 위치를 찾고, 규칙 행의 필드로 요청 처리 방식을 파악할 수 있습니다. 구독이나 서버 정보를 이미 갖고 있다면 이름을 기준으로 대조해 보세요. 이 매뉴얼은 해당 정보를 제공하거나 판매·추천하지 않습니다.
인터페이스 및 토글
요청 경로를 결정하는 옵션, 연결을 시작하는 토글, 정보 입력 및 테스트 메뉴를 구분해서 살펴보세요.
- Global Routing
- 클라이언트가 처리하는 요청의 출구를 선택하는 방식입니다. Config(구성)는 현재 구성을 따르고, Proxy(프록시)는 프록시 출구를 사용하며, Direct(직접 연결)는 프록시 서버를 거치지 않습니다. 특정 분할 라우팅 규칙을 점검할 때는 먼저 Config가 선택되어 있는지 확인하세요.
- On Demand
- 설정한 조건이 충족되면 연결을 시작합니다. 네트워크 조건에 따라 자동으로 연결을 시작할 때 유용합니다. 연결 시점을 정할 뿐, 개별 요청이 어느 출구를 사용할지는 판단하지 않습니다. 조건이 충족되어도 서버 자체가 사용 가능한지 확인해야 합니다.
- Add Server
- 기존 서버 정보를 추가하는 메뉴입니다. 먼저 프로토콜을 선택한 다음 해당 주소, 포트 및 인증 정보를 입력하세요. 프로토콜마다 표시되는 항목은 다를 수 있습니다. 항목을 저장해도 정보가 입력된 것일 뿐, 서버 연결이 확인된 것은 아닙니다.
- Connectivity Test
- 현재 네트워크에서 지정된 경로로 테스트를 완료할 수 있는지 확인합니다. 결과에 표시된 시간은 해당 테스트 조건에서 측정한 값이며 파일 다운로드 속도로 환산할 수 없습니다. 결과를 비교할 때는 테스트 대상, 네트워크 및 방식을 가능한 한 동일하게 유지하세요.
프록시 프로토콜
프로토콜은 클라이언트와 서버 간의 통신 방식을 설명합니다. 입력할 때는 보유한 정보를 기준으로 하며, 포트나 이름만으로 프로토콜을 추측하지 마세요.
- Shadowsocks
- 대칭 암호화를 사용하는 프록시 프로토콜입니다. 구성 정보에는 일반적으로 서버 주소, 포트, 암호화 방식 및 비밀번호가 포함됩니다. 포트에 연결할 수 있다고 해서 연결이 반드시 성공하는 것은 아닙니다. 암호화 방식이나 비밀번호가 서버와 일치하지 않으면 데이터를 정상적으로 주고받을 수 없습니다.
- VMess
- 인증을 사용하는 프록시 프로토콜로, UUID를 사용자 식별에 사용하는 경우가 많습니다. 입력할 때는 실제 전송 방식과 관련 항목도 확인하세요. UUID만으로 두 구성을 서로 바꿔 쓸 수 있는지 판단할 수 없습니다. 인증에 실패하면 원본 정보를 항목별로 대조하세요.
- VLESS
- 인증과 전송 보호를 별도로 설정하는 프록시 프로토콜입니다. 정보에 UUID가 있더라도 VMess 항목에서 프로토콜 이름만 바꿔 그대로 사용할 수 없습니다. 전송 방식과 보안 설정이 상대 측 구성과 일치해야 합니다.
- Trojan
- 일반적으로 TLS를 통해 전송하고 비밀번호로 인증하는 프록시 프로토콜입니다. 연결에 실패하면 인증 정보와 TLS에 필요한 서버 이름을 각각 확인하세요. 인증서 이름 불일치와 비밀번호 오류는 서로 다른 문제입니다.
- Hysteria2
- QUIC을 전송 기반으로 사용하는 프록시 프로토콜이며, 네트워크에서 UDP 트래픽을 전송할 수 있어야 합니다. 일반 웹페이지에 접속할 수 있어도 같은 네트워크에서 QUIC 연결이 가능하다는 뜻은 아닙니다. 문제를 확인할 때는 특정 네트워크에서만 장애가 발생하는지 기록해 두세요.
- WireGuard
- 공개 키로 상대를 식별하고 UDP를 통해 전송하는 암호화 터널 프로토콜입니다. 상대 식별에 쓰는 공개 키와 이 기기에서 안전하게 보관해야 하는 개인 키는 서로 다른 항목입니다. 문제 해결 기록을 공유할 때는 개인 키 등 민감한 정보를 삭제하세요.
규칙 키워드
규칙 행의 첫 부분에 있는 키워드는 매칭 조건을 정하고, 행 끝의 정책은 일치한 뒤의 처리 방식을 정합니다.
- DOMAIN
- 전체 도메인 이름과 일치합니다. 조건이
example.com이면www.example.com과는 일치하지 않으며 URL 경로 판별에도 사용되지 않습니다. 특정 호스트 이름 하나의 처리 방식만 바꾸려면 이와 같은 정확한 조건을 사용할 수 있습니다.
- DOMAIN-SUFFIX
- 지정한 도메인과 하위 도메인에 일치합니다. 조건이
example.com이면img.example.com과 일치하지만notexample.com과는 일치하지 않습니다. 특정 하위 도메인에 예외를 적용해야 한다면 해당 정확 일치 규칙을 접미사 규칙보다 앞에 두세요.
- IP-CIDR
- 대상 IPv4 주소를 지정된 네트워크 대역과 비교합니다. 예:
192.0.2.0/24. 슬래시 뒤의 숫자는 프리픽스 길이이며 포트 번호가 아닙니다. 요청이 처음에 도메인 이름으로 표시된다면 주소가 이미 해석되었는지와 규칙 매개변수를 함께 확인해야 합니다.
- GEOIP
- 주소 데이터베이스에 기록된 대상 IP의 지역 분류를 기준으로 매칭합니다. 웹페이지에 쓰인 언어, 도메인 접미사 또는 기기의 위치를 기준으로 하지 않습니다. 도메인은 네트워크에 따라 서로 다른 주소로 해석될 수 있으므로 같은 도메인이라도 항상 같은 지역 조건에 일치하는 것은 아닙니다.
- FINAL
- 앞선 규칙과 일치하지 않은 요청에 적용할 기본 정책을 지정합니다.
FINAL,DIRECT처럼 도메인이나 주소 조건을 별도로 지정할 필요가 없습니다. 먼저 확인해야 하는 규칙 뒤에 배치해 매칭이 너무 일찍 끝나지 않도록 하세요.
정책 및 매칭 순서
인터페이스의 Proxy와 Direct는 Global Routing 옵션이고, 규칙의 PROXY와 DIRECT는 개별 규칙의 처리 정책입니다.
- PROXY
- 일치한 요청을 프록시 출구로 처리합니다. 규칙이 일치했다는 것은 출구가 선택되었다는 뜻일 뿐, 프록시 서버가 대상에 연결할 수 있다는 뜻은 아닙니다. 진단 기록에서 규칙이 일치했는데 요청이 실패했다면 사용 중인 서버와 대상에 연결할 수 있는지 확인하세요.
- DIRECT
- 일치한 요청을 현재 네트워크를 통해 프록시 서버 없이 대상에 직접 연결합니다. 직접 연결은 DNS 조회를 건너뛰거나 클라이언트를 끄는 것과 다릅니다. 규칙 처리가 활성화되어 있으면 클라이언트는 요청마다 규칙을 적용해 서로 다른 경로를 선택할 수 있습니다.
- REJECT
- 클라이언트가 처리 대상으로 받은 요청 중 해당 정책에 일치하는 요청을 거부합니다. 규칙은 조건에 맞는 트래픽만 처리하며 웹페이지의 모든 콘텐츠 요소를 식별하지는 않습니다. 범위가 넓은 접미사 조건을 선택하기 전에 같은 도메인에서 유지해야 할 서비스까지 함께 차단하지 않는지 확인하세요.
- 매칭 순서
- 규칙은 구성된 순서대로 확인하며 가장 먼저 일치한 규칙을 적용합니다. 모든 일치 항목을 찾은 뒤 가장 구체적인 항목을 선택하는 방식이 아닙니다. 범위가 넓은 접미사 규칙이 정확한 도메인 규칙보다 앞에 있다면 순서를 조정한 다음 같은 대상으로 결과를 확인하세요.
규칙을 읽을 때는 첫 번째 쉼표 앞의 매칭 유형을 확인한 다음 마지막 정책을 살펴보세요. 예를 들어
DOMAIN-SUFFIX,example.com,PROXY는 도메인 접미사가example.com과 일치하면 프록시 출구를 사용한다는 뜻입니다.
구독 및 구성 파일
구독은 기존 서버 목록을 가져오는 데 사용하고, 구성 파일은 요청 처리 방식을 지정합니다. 목록을 업데이트해도 분할 라우팅 규칙이 바뀌는 것은 아닙니다.
- Subscribe
- 기존 구독 주소를 가져와 그 안의 서버 항목을 불러옵니다. 목록을 새로 고친 뒤에는 현재 선택한 항목이 여전히 있고 설정이 예상과 일치하는지 다시 확인하세요. 구독 주소에 접근 정보가 포함될 수 있으므로 문제 기록을 제출할 때 전체 링크를 첨부하지 마세요.
- Config
- 페이지 메뉴로 사용될 때는 구성 파일을 확인하고 관리합니다. Global Routing에 표시될 때는 현재 구성에 따라 트래픽을 처리한다는 뜻입니다. 파일을 편집해도 해당 파일이 선택되었다는 의미는 아닙니다. 규칙을 확인하기 전에 실제로 활성화된 구성이 무엇인지 확인하세요.
- DNS
- 도메인 레코드를 조회해 연결 요청의 대상 주소를 가져오는 데 사용합니다. 도메인 조회와 대상 연결은 별개의 단계이므로 주소를 찾았다고 해서 대상에 연결할 수 있다는 뜻은 아닙니다. 주소 기반 규칙을 점검할 때는 입력한 도메인만 보지 말고 실제로 가져온 주소를 확인하세요.
- URL Rewrite
- 인식 가능한 URL에 조건에 따라 재작성 등의 작업을 적용합니다. 규칙에서 요청 출구를 선택하는 작업과는 다릅니다. URL에는 경로와 쿼리 매개변수가 포함될 수 있으며, 도메인 조건만으로는 이 부분들을 구분할 수 없습니다. 조건을 작성하기 전에 현재 상황에서 클라이언트가 어떤 요청 정보를 확인할 수 있는지 살펴보세요.
관련 작업
기존 정보를 처음 가져오려면 사용 안내를 참조하세요. 규칙 필드와 우선순위를 대조하려면 설정 안내를 확인하세요.
iPhone / iPad 버전은 App Store에서 구매할 수 있으며, 가격은 $2.99 일회성 결제입니다. 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. Mac(Apple 실리콘 및 Intel) / Windows / Android / Linux 버전은 무료이며, 설치 파일은 이 사이트의 다운로드 페이지에서 제공하는 /dl/ 경로로만 받을 수 있습니다. 클라이언트 일회성 구매는 연결 서비스 요금제가 아닙니다.