Shadowrocket 공식 매뉴얼

Shadowrocket 용어 설명

화면에 보이는 항목이 메뉴인지 스위치인지, 설정에 적힌 내용이 조건인지 동작인지 구분해 보세요. 분류별로 찾아보거나 특정 용어의 링크를 공유할 수 있습니다.

인터페이스와 스위치

먼저 연결이 켜져 있는지 확인한 다음, 연결 시 어떤 처리 모드를 사용하는지 살펴보세요.

Home
기본 화면에는 연결 스위치, 서버 목록, 현재 상태가 표시됩니다. 서버를 선택하면 사용할 수 있는 원격 서버를 지정할 뿐, 연결 스위치가 꺼져 있으면 연결이 시작되지 않습니다. 스위치가 켜져 있는데도 접속 결과가 예상과 다르면 Global Routing을 확인하세요.
Global Routing
연결 처리 방식을 선택하는 설정입니다. Config는 현재 설정의 규칙에 따라 처리하고, Proxy는 선택한 프록시 경로를 사용하며, Direct는 프록시 서버를 거치지 않고 직접 연결합니다. 모드를 바꿔도 설정 파일의 규칙은 변경되지 않습니다.
Config
같은 단어가 두 가지 용도로 쓰입니다. 인터페이스 메뉴에서는 설정 파일을 확인하고 관리하며, Global Routing 옵션에서는 현재 설정에 따라 연결을 처리합니다. 파일을 가져온 뒤 규칙을 테스트하려면 실제로 활성화된 파일과 선택된 모드를 모두 확인하세요.
On Demand
On Demand는 설정된 조건이 충족되면 시스템이 연결을 시작하는 기능입니다. 예를 들어 네트워크 환경이 바뀌면 연결 여부를 다시 판단합니다. 연결 시점을 제어할 뿐, 특정 도메인이 어떤 경로를 사용할지는 결정하지 않습니다. 수동으로 연결을 끊은 뒤 다시 자동 연결된다면 On Demand 조건을 먼저 확인하고 분기 규칙도 살펴보세요.
Connectivity Test
연결 테스트는 테스트 요청을 보내 현재 네트워크와 서버 조합을 사용할 수 있는지 확인합니다. 표시되는 소요 시간은 테스트 방식, 대상, 당시 네트워크 상태에 따라 달라지며 다운로드 속도로 환산할 수 없습니다. 테스트에 성공해도 설정의 모든 분기 규칙이 검증된 것은 아닙니다.

프록시 프로토콜

프로토콜은 원격 서버와 통신하는 방식을 정합니다. 직접 입력할 때는 이미 보유한 서버 설정을 기준으로 하세요.

Shadowsocks
클라이언트는 정해진 암호화 방식과 인증 정보를 사용해 서버와 통신합니다. 주소와 포트는 연결 위치를 지정하고, 암호화 방식과 인증 정보는 양쪽에서 데이터를 올바르게 처리할 수 있는지 결정합니다. 서버 주소에 접속할 수 있어도 암호화 방식을 잘못 선택하면 프록시 요청이 실패할 수 있습니다.
VMess
이 프로토콜은 일반적으로 UUID로 사용자를 식별합니다. 프로토콜 이름만으로 서버의 전송 방식을 알 수는 없으므로 전송 방식과 관련 항목을 기존 설정과 맞춰야 합니다. 연결에 실패하면 사용자 식별 정보와 전송 설정을 따로 확인해 두 종류의 설정을 동시에 변경하지 마세요.
VLESS
이 프로토콜도 일반적으로 UUID로 사용자를 식별하지만, 인증 정보의 모양이 비슷하다는 이유만으로 다른 프로토콜의 설정을 적용해서는 안 됩니다. 전송 보안은 TLS와 같은 별도 보안 계층에 따라 달라집니다. 입력할 때 프로토콜, 전송 방식, 보안 옵션을 각각 확인하세요.
Trojan
일반적으로 TLS로 연결하고 비밀번호로 인증합니다. 서버 주소는 연결 위치를 지정하고, SNI는 TLS 핸드셰이크에서 알리는 서비스 이름으로 용도가 다릅니다. 인증서 이름 오류가 발생하면 인증서 검증을 끄기보다 서비스 제공업체가 안내한 이름부터 확인하세요.
Hysteria2
QUIC 기반 프록시 프로토콜로, 하위 전송 계층에서 UDP를 사용합니다. TCP 서비스에 연결할 수 있다는 사실만으로 같은 네트워크에서 UDP 트래픽도 전송된다고 볼 수는 없습니다. 문제를 확인할 때 네트워크 상태와 주소, 포트, 인증 정보를 나누어 점검하세요.
WireGuard
키로 상대 피어를 식별하고 UDP를 통해 캡슐화된 데이터를 전송하는 터널 프로토콜입니다. 상대 피어의 공개 키는 원격 피어를 식별하고, 로컬 개인 키는 로컬 사용자를 식별하므로 서로 바꿔 쓸 수 없습니다. 설정을 기록하거나 문제 해결 정보를 공유할 때 개인 키를 공개하지 마세요.

규칙 키워드

규칙 한 줄을 읽을 때는 먼저 무엇을 매칭하는지, 다음으로 일치한 뒤 어떻게 처리하는지 확인하세요.

DOMAIN
전체 호스트 이름과 정확히 일치합니다. 조건을 example.com으로 지정해도 www.example.com까지 자동으로 포함하지 않습니다. 호스트 이름 항목에는 URL의 프로토콜 접두사, 경로, 쿼리 매개변수가 들어가지 않습니다.
DOMAIN-SUFFIX
도메인 접미사를 기준으로 도메인 자체와 하위 도메인을 매칭합니다. 예를 들어 조건이 example.com이면 api.example.com과 일치하지만 notexample.com과는 일치하지 않습니다. 특정 하위 도메인을 별도로 처리하려면 일반 접미사 규칙보다 구체적인 규칙을 앞에 두세요.
GEOIP
주소 데이터베이스의 국가 또는 지역 분류를 기준으로 IP를 매칭합니다. 도메인 접미사로 위치를 추정하는 방식이 아닙니다. 같은 도메인도 서로 다른 IP로 해석될 수 있어 매칭 결과가 달라질 수 있으며, 이 결과가 서버의 정확한 물리적 위치를 뜻하지는 않습니다.
IP-CIDR
주소 접두사와 접두사 길이로 IPv4 주소 범위를 나타냅니다. 예를 들어 192.0.2.0/24는 192.0.2로 시작하는 주소와 일치합니다. 슬래시 뒤의 숫자는 포트가 아닙니다. IPv6 주소 범위를 매칭할 때는 IP-CIDR6 키워드를 사용합니다.
FINAL
앞선 규칙과 일치하지 않은 연결의 처리 방식을 지정하며, 보통 규칙 목록의 마지막에 둡니다. FINAL,DIRECT는 나머지 연결을 대상에 직접 연결한다는 뜻이며, 앞에서 이미 일치한 연결을 직접 연결로 바꾸지는 않습니다. 예상치 못하게 기본 규칙이 적용되면 앞선 조건과 규칙 순서를 먼저 확인하세요.
PROXY · DIRECT · REJECT
세 항목은 규칙이 일치한 뒤 적용되는 동작입니다. PROXY는 프록시 경로로 전달하고, DIRECT는 대상에 직접 연결하며, REJECT는 연결을 거부합니다. 규칙에 대문자로 표시된 PROXY와 DIRECT는 일치한 항목만 처리하며, 인터페이스에서 선택하는 Proxy 및 Direct 모드와는 다릅니다.

구독 및 설정 파일

서버 목록은 선택할 수 있는 원격 서버를 정하고, 설정 파일은 연결을 처리하는 방식을 정합니다.

서버
서버는 클라이언트가 연결하는 원격 대상이며, 항목에는 보통 프로토콜, 주소, 포트, 인증 정보가 기록됩니다. 이 정보를 알고 있다면 Add Server를 사용해 직접 입력할 수 있습니다. 항목의 표시 이름은 구분을 위한 것으로, 이름을 바꿔도 실제 연결 주소는 바뀌지 않습니다.
구독
구독 링크는 사용자가 이미 이용 중인 서비스 제공업체에서 받아 서버 항목을 가져오고 업데이트하는 데 사용합니다. 앱에서 Subscribe로 추가할 수 있습니다. 목록을 업데이트할 수 있다고 해서 모든 서버에 접속할 수 있는 것은 아닙니다. 구독 링크에 접근 인증 정보가 포함될 수 있으므로 문제 해결 시 전체 링크를 공개하지 마세요.
설정 파일
설정 파일에는 규칙과 관련 설정이 저장되며, 흔한 확장자는 .conf입니다. [General]에는 일반 설정이, [Rule]에는 분기 규칙이 기록됩니다. 서버 구독 업데이트는 현재 설정 파일을 교체하는 것과 다릅니다. 분기 문제를 확인하기 전에 실제로 활성화된 파일을 확인하세요.
DNS
DNS는 도메인에 연결된 레코드를 조회하며, 주로 연결에 필요한 IP 주소를 가져오는 데 사용합니다. 이름 해석에 성공해도 대상 포트에 접속할 수 있다는 뜻은 아닙니다. 도메인 해석 오류가 나타나면 먼저 DNS 경로를 확인하고, 해석은 됐지만 요청 시간이 초과되면 연결 경로를 점검하세요.
URL Rewrite
설정의 [URL Rewrite]는 URL 조건에 따라 재작성하거나 리디렉션할 수 있습니다. 분기 규칙은 연결이 어떤 경로를 사용할지 정하고, 재작성 규칙은 요청 주소를 처리합니다. 암호화된 요청에서 경로를 매칭할 수 있는지는 앱이 해당 요청 정보를 읽을 수 있는지에 따라 달라집니다.

시스템 권한 및 설치

구입 내역, 시스템 권한, 앱 내 설정은 각각 별도로 관리되므로 기기를 바꿀 때 항목별로 확인하세요.

VPN 구성
iPhone 또는 iPad에서 처음 연결을 켤 때 시스템에서 VPN 구성을 추가하도록 허용해 달라는 메시지가 표시될 수 있습니다. 이 구성은 시스템에서 관리하며 앱 안의 .conf 파일과는 다릅니다. 이전에 권한을 거부했다면 Shadowrocket으로 돌아가 연결을 다시 시도하고 시스템 안내를 확인하세요.
구입 항목
App Store에서 구입 내역을 확인하고 조건에 맞는 앱을 다시 다운로드하는 메뉴입니다. 기기를 바꾸거나 앱을 재설치할 때는 현재 스토어 계정이 원래 구입한 계정과 같은지 먼저 확인하세요. 앱을 다시 다운로드해도 구입 내역을 통해 서버 항목이나 설정 파일을 복구할 수는 없으므로 앱 데이터는 별도로 옮겨야 합니다.
Apple 실리콘 및 Intel
Mac의 두 가지 프로세서 아키텍처입니다. ‘이 Mac에 관하여’에서 칩 또는 프로세서 이름을 확인한 다음 해당하는 Mac 설치 파일을 선택하세요. 처음 실행할 때 시스템에서 차단하면 먼저 다운로드 출처를 확인한 뒤 설치 안내를 참고해 알림의 유형을 구분하세요.
앱 ID
App Store에서 제품 항목을 식별하는 숫자이며, 구입에 사용하는 계정과는 다릅니다. Shadowrocket의 앱 ID는 932747118이며 제품 페이지 URL 끝에서 확인할 수 있습니다. 항목을 식별할 때는 이름만 보지 말고 개발자 Shadow Launch Technology Limited와 공식 아이콘도 확인하세요.
Shadowrocket 전체 플랫폼 다운로드