Shadowrocket 공식 가이드 · 용어 색인

Shadowrocket 용어집

대상에 따라 인터페이스 용어, 프로토콜 이름, 규칙 문법을 구분해 확인하세요. 먼저 해당 이름이 어디에 표시되는지 파악한 뒤 기능과 적용 범위를 읽어 보세요. 비슷한 영어 이름이라도 같은 설정 단계에 속하지 않을 수 있습니다.

인터페이스 옵션 Config / Proxy / Direct

Global Routing의 전체 작동 방식을 결정합니다.

매칭 조건 DOMAIN-SUFFIX

연결이 특정 규칙에 해당하는지 판단합니다.

규칙 동작 PROXY / DIRECT / REJECT

규칙에 매칭된 뒤 적용할 처리 방식을 지정합니다.

이 페이지는 용어를 찾기 위한 자료이며, 연속된 작업 절차를 안내하지는 않습니다. 처음 설정한다면 사용 가이드를 확인하세요. 기존 구독의 업데이트, 정렬, 백업 방법은 서버 관리 가이드에서 볼 수 있습니다.

인터페이스 및 스위치

연결 화면과 작동 모드

같은 이름이 화면 메뉴와 모드 옵션을 모두 가리킬 수 있습니다. 아래 설명은 표시 위치를 기준으로 합니다. 플랫폼이나 앱 상태에 따라 메뉴 순서는 달라질 수 있습니다.

Home: 서버 목록을 확인하고 연결 대상을 선택한 뒤 연결 스위치를 조작하는 화면입니다. 서버를 선택하면 연결 대상만 지정되므로, 연결을 켜고 실제 접속 여부도 확인해야 합니다. 스위치가 켜져 있어도 대상 서비스에 반드시 접속할 수 있는 것은 아닙니다.

Global Routing: 연결 전체에 적용할 처리 방식을 결정합니다. 구성, 프록시, 직접 연결에 해당하는 인터페이스 용어는 Config, Proxy, Direct입니다. 규칙에 따라 대상을 구분하려면 Config를 사용하세요. 문제를 확인하기 위해 모드를 임시로 변경할 때는 원래 설정을 기록하고 테스트 후 복원하세요.

Config: 화면 이름으로 표시될 때는 구성 파일을 가져오고 선택하고 관리하는 메뉴를 뜻합니다. Global Routing에 표시될 때는 현재 구성 규칙에 따라 연결을 처리한다는 의미입니다. 파일을 저장했다고 해서 활성화된 것은 아니므로 선택된 구성과 현재 모드를 함께 확인하세요.

Proxy / Direct: Global Routing의 Proxy는 프록시 방식을, Direct는 직접 연결 방식을 뜻합니다. 전체 작동 방식을 제어하는 옵션으로, 특정 서버의 프로토콜 유형이 아닙니다. 규칙 행에 표시되는 대문자 동작 PROXY, DIRECT와 같은 설정 단계로 혼동하지 마세요.

On Demand: 설정한 조건에 따라 시스템이 자동으로 연결하도록 요청하는 기능으로, 조건을 만족할 때 수동 조작을 줄일 수 있습니다. 분기 규칙을 선택하거나 잘못된 비밀번호·주소를 수정하지는 않습니다. 수동으로 연결을 끊은 뒤 다시 연결될 때는 작동 조건이 여전히 충족되는지 확인하세요.

DNS: 도메인 이름을 IP 주소로 변환하는 조회 방식으로, 도메인 접속과 일부 규칙 판단에 사용될 수 있습니다. 도메인은 열리지 않지만 주소로 직접 접속하면 응답이 있을 때는 DNS를 따로 확인할 수 있습니다. DNS 설정을 바꿔도 프로토콜 인증 실패나 서버 연결 불가 문제가 바로 해결되지는 않습니다.

Connectivity Test: 선택한 방식으로 서버 연결 가능 여부를 확인하는 테스트 화면입니다. 결과는 로컬 네트워크, 테스트 대상, 연결 프로토콜에 따라 달라집니다. 결과를 비교하기 전에 테스트 조건을 통일하세요. 한 번 테스트에 성공해도 모든 앱과 대상이 정상이라는 뜻은 아닙니다.

프로토콜

서버 유형 및 연결 매개변수

프로토콜은 양쪽에서 인증하고 데이터를 전송하는 방식을 결정하지만, 규칙 매칭 방식은 결정하지 않습니다. 서버를 추가할 때는 사용자가 보유한 서버 정보를 기준으로 입력하고, 한 프로토콜의 필드를 다른 프로토콜에 그대로 적용하지 마세요.

Shadowsocks: 암호화 방식과 비밀번호를 사용해 프록시 연결을 설정하는 프로토콜입니다. 주소, 포트, 암호화 방식, 비밀번호가 서버 설정과 일치해야 합니다. 이름이 비슷한 암호화 방식도 서로 바꿔 쓸 수 있는 것은 아닙니다. 가져온 뒤에도 서비스 제공업체가 안내한 매개변수를 하나씩 확인하세요.

VMess: 사용자 식별 정보로 인증하는 프록시 프로토콜입니다. 서버 요구사항에 따라 전송 방식과 관련 보안 옵션도 설정해야 합니다. 사용자 식별 정보가 맞더라도 전송 경로, Host 또는 TLS 설정이 일치하지 않으면 연결에 실패할 수 있습니다.

VLESS: 사용자 식별 정보로 인증하는 프록시 프로토콜입니다. 전송 및 보안 설정을 서버 요구사항에 맞춰야 합니다. VMess와는 다른 프로토콜이므로 유형 이름만 바꾸고 모든 매개변수를 그대로 사용할 수 없습니다. TLS 및 기타 옵션은 실제 안내된 정보를 기준으로 설정하세요.

Trojan: 일반적으로 TLS를 함께 사용하는 프록시 프로토콜입니다. 주소, 포트, 비밀번호, SNI를 확인하세요. SNI는 TLS 핸드셰이크에서 서비스 이름을 알리는 정보로, 입력한 연결 주소와 다를 수 있습니다. 인증서 오류가 발생하면 도메인, 기기 시간, 서버 설정을 먼저 확인하세요.

Hysteria2: QUIC 기반 프록시 프로토콜로 UDP를 사용하며, 인증 및 TLS 매개변수를 서버에 맞춰야 합니다. 네트워크에서 UDP를 제한하면 주소와 비밀번호가 맞아도 연결에 실패할 수 있습니다. 대역폭 관련 설정은 실제 환경에 맞춰 입력하고, 값을 높이는 것으로 연결 문제를 대신 진단하지 마세요.

WireGuard: 공개 키·개인 키와 상대방 정보를 사용해 암호화 터널을 설정하는 프로토콜입니다. 터널 주소, 엔드포인트, 허용 주소 범위도 설정해야 할 수 있습니다. 개인 키는 민감한 정보이므로 문의용 스크린샷에 노출하지 마세요. 핸드셰이크는 정상이지만 접속에 문제가 있으면 라우팅과 DNS도 확인하세요.

HTTP / SOCKS5: 두 가지 프록시 프로토콜 이름입니다. 인증 방식과 처리할 수 있는 트래픽 범위는 서버 설정을 확인해야 합니다. 프로토콜 이름만으로 연결이 암호화되는지 판단할 수 없으며, SOCKS5 서비스가 UDP 전달을 지원한다고 단정할 수도 없습니다. 실제 서비스 조건을 확인하세요.

규칙 키워드

매칭 조건 및 처리 동작

일반적인 규칙은 매칭 유형, 매칭 값, 처리 동작으로 구성되며 대개 목록 순서대로 적용됩니다. 각 규칙을 확인하기 전에 현재 Config 모드인지 확인하고, 앞선 규칙의 범위가 더 넓어 먼저 매칭되는지 살펴보세요.

DOMAIN: 지정한 도메인과 정확히 일치하는 항목을 찾습니다. 예를 들어 DOMAIN,example.com,DIRECT는 example.com에 적용됩니다. 모든 하위 도메인이 자동으로 포함되지는 않습니다. www.example.com 등도 함께 처리하려면 규칙을 추가하거나 적절한 접미사 매칭을 사용하세요.

DOMAIN-SUFFIX: 지정한 도메인과 그 하위 도메인을 매칭해 동일한 동작을 적용할 때 사용합니다. DOMAIN-SUFFIX,example.com,PROXY는 example.com과 그 하위 도메인을 포함하지만, example이라는 문자열이 들어간 모든 도메인을 뜻하지는 않습니다.

DOMAIN-KEYWORD: 도메인에 지정한 문자열이 포함되어 있는지 확인하며, 일반적으로 접미사 매칭보다 범위가 넓습니다. 키워드가 너무 짧으면 원치 않는 도메인까지 매칭될 수 있으므로 적용 범위를 먼저 확인하고 더 구체적인 예외 규칙을 앞에 배치하세요.

GEOIP: IP 지리 데이터베이스의 분류를 기준으로 대상 주소를 매칭합니다. 예를 들어 GEOIP,CN,DIRECT는 해당 분류에 매칭되면 DIRECT를 적용합니다. 데이터베이스 결과는 사용자 위치나 서버 신원을 증명하지 않습니다. 주소 분류 업데이트와 조회 결과에 따라 매칭 여부가 달라질 수 있습니다.

IP-CIDR / IP-CIDR6: IPv4 및 IPv6 주소 대역을 각각 매칭합니다. 슬래시 뒤의 접두사 길이에 따라 적용 범위가 달라집니다. 규칙을 확인할 때 대상이 실제로 어떤 주소 체계를 사용하는지도 살펴보세요. IPv4 규칙이 해당 IPv6 규칙을 자동으로 대신하지는 않습니다.

FINAL: 앞선 규칙에 매칭되지 않은 연결에 기본 동작을 지정합니다. 예를 들어 FINAL,PROXY를 사용합니다. 보통 규칙 목록 맨 마지막에 배치해야 합니다. 너무 앞에 두면 이후의 구체적인 규칙이 적용되지 않을 수 있습니다.

PROXY / DIRECT / REJECT: 규칙의 처리 동작으로, 프록시 경로로 전달, 직접 연결, 연결 거부를 뜻합니다. PROXY의 최종 연결 경로는 현재 서버나 관련 정책 설정에 따라 달라집니다. DIRECT는 해당 프록시 경로를 거치지 않는다는 뜻이지, 대상에 반드시 연결된다는 뜻은 아닙니다.

URL Rewrite: 표현식으로 요청 URL을 매칭해 설정에 따라 다시 쓰거나 처리합니다. 대상별 연결 경로를 선택하는 규칙 분기와는 다릅니다. 해당 메커니즘으로 처리할 수 있는 요청에만 적용되므로, 표현식 한 줄을 추가했다고 모든 암호화 요청에 적용되는 것은 아닙니다.

구독 및 서버

가져오기, 테스트 및 데이터 복원

아래 항목은 사용자가 자신의 구독 또는 서버 정보를 보유하고 있다는 전제에서 설명합니다. 구독 주소는 이용 중인 서비스 제공업체에서 받으세요. 주소에 포함된 인증 정보, 서버 비밀번호, 개인 키는 민감한 정보로 안전하게 보관해야 합니다.

Add Server: 서버를 직접 추가하는 화면입니다. 먼저 프로토콜을 선택한 뒤 안내된 정보에 따라 해당 필드를 입력하세요. 주소, 포트, 인증, 전송, TLS 정보는 서로 다른 항목입니다. 필요하지 않은 필드를 임의로 채우지 말고 저장 후 연결을 테스트하세요.

SERVER: 서버 객체 또는 주소 필드를 가리킬 수 있으므로 화면에서 표시된 위치를 기준으로 의미를 확인하세요. 서버 주소는 일반적으로 도메인이나 IP이며 구독 링크와 다릅니다. 주소 필드에 구독 URL 전체를 입력해도 Subscribe 가져오기를 대신할 수 없습니다.

Scan QR Code: QR 코드 내용을 인식하고 해당 정보를 가져오는 화면입니다. QR 코드에는 단일 서버 링크나 구독 주소가 포함될 수 있습니다. 스캔 후 인식된 유형과 필드를 확인한 뒤 저장 여부를 결정하세요. 인증 정보가 포함된 QR 코드는 공개적으로 전달하지 않는 것이 좋습니다.

지연 시간: 지정된 테스트 조건에서 측정한 응답 시간으로, 같은 테스트에서 항목을 비교할 때 주로 사용합니다. 수치가 낮아도 지속적인 다운로드 속도가 빠르거나 대상 웹사이트가 더 빨리 응답한다고 보장할 수는 없습니다. 정렬 전에 테스트 방식을 통일하고, 시간 초과가 발생하면 네트워크 문제와 인증 문제를 구분해 확인하세요.

iCloud 동기화: 지원되는 Apple 기기, 계정, 시스템 권한 조건에서 앱이 지원하는 데이터를 동기화합니다. 모든 연결 상태와 외부 서비스를 함께 이전하는 기능은 아닙니다. 기기를 바꾼 뒤에는 구독, 현재 Config, 연결 권한을 다시 확인하고 필요한 데이터는 별도로 백업해 두세요.

설치 및 시스템 권한

계정 기록, 아키텍처 및 권한

Shadowrocket은 iPhone, iPad, Mac, Windows, Android, Linux에서 사용할 수 있습니다. iPhone / iPad 버전은 App Store에서 받으며, 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. 다른 플랫폼용 설치 파일은 모두 이 사이트의 /dl/에서 제공됩니다. 다운로드 경로와 자세한 설치 방법은 앱 다운로드 페이지를 확인하세요.

구입 항목: App Store 계정에서 구입한 앱을 확인하고 다시 받는 화면입니다. 기기를 바꾸거나 앱을 다시 설치할 때는 구입에 사용한 계정으로 구매 내역을 확인하세요. 앱 구매 내역으로 서비스 제공업체의 구독이 자동 복원되지는 않습니다. 정품 여부를 확인하려면 개발자 Shadow Launch Technology Limited와 앱 ID 932747118도 확인하세요.

Apple 실리콘 / Intel: Mac의 두 가지 프로세서 아키텍처에 맞춰 Shadowrocket의 dmg 설치 파일도 두 종류로 제공됩니다. 먼저 이 Mac에 관하여에서 칩 또는 프로세서 정보를 확인하고 알맞은 파일을 선택하세요. 아키텍처 선택은 호환성을 위한 것이며, 첫 실행 경고가 표시되면 시스템 권한 안내도 따라야 합니다.

SmartScreen: Windows의 앱 평판 경고가 표시되어도 설치 파일 내용을 이미 확인했다는 뜻은 아닙니다. 파일을 이 사이트의 다운로드 경로에서 받았는지 확인한 뒤 해당 경고에서 자세히 보기 → 실행을 선택하세요. 조직 정책의 제한을 받는 기기라면 기기 관리 규정을 따르세요.

개인정보 및 보안: macOS에서 앱의 첫 실행 제한을 처리하는 시스템 설정 화면입니다. 개발자를 확인할 수 없다는 경고가 표시되면 이 사이트에서 받은 설치 파일인지 확인한 뒤 열기를 선택할 수 있습니다. 손상되었다는 경고가 표시되면 앱이 Applications 폴더에 있는지 확인한 다음 다운로드 페이지 안내에 따라 xattr -cr /Applications/Shadowrocket.app을 실행하세요. 출처를 알 수 없는 파일에는 명령을 실행하지 마세요.

알 수 없는 앱 설치 허용: Android에서 앱 출처별로 부여하는 설치 권한입니다. 예를 들어 APK를 다운로드한 브라우저나 파일을 여는 파일 관리자에 권한을 부여합니다. 실제로 사용할 출처에만 권한을 켜고, 설치가 끝나면 필요에 따라 끄세요. WeChat에서 다운로드할 수 없다면 시스템 브라우저로 다운로드 페이지를 여세요.

deb / rpm / AppImage: Linux의 설치 패키지 형식은 배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택하세요. AppImage는 실행 전에 실행 권한을 부여해야 합니다. chmod +x를 사용할 때는 실제로 다운로드한 AppImage 파일을 지정하세요. deb 설치 시 sudo apt install에 로컬 파일을 지정할 수 있으며, 자세한 방법은 다운로드 페이지를 확인하세요.

설치 경로를 확인하려면 전체 플랫폼 다운로드 안내를, 용어를 실제 설정에 적용하려면 사용 가이드 또는 구독 및 서버 관리 가이드를 확인하세요.