Shadowrocket 공식 매뉴얼

Shadowrocket 용어집

인터페이스, 프로토콜, 규칙 용어를 찾아보세요. 먼저 용어가 속한 계층을 구분한 다음 연결 대상, 라우팅 방식, 설정 내용 중 무엇에 영향을 주는지 확인하세요.

인터페이스 용어와 규칙 키워드는 영어 원문으로 표기합니다. 조작 방법은 iPhone / iPad 화면을 기준으로 하며, 다른 플랫폼에서는 메뉴 위치가 다를 수 있습니다. 전체 절차는 사용 매뉴얼을 확인하세요.

인터페이스 및 스위치

이 이름은 화면, 메뉴 또는 연결 설정에 표시됩니다. 비슷한 이름이라도 적용 범위는 다를 수 있습니다.

Home: 서버 목록을 확인하고 연결 대상을 선택하거나 연결 스위치를 조작하는 주요 화면입니다. 항목을 선택해도 연결 대상만 지정된 것이며, 연결이 완료된 것은 아닙니다. 연결 스위치와 상태도 확인해야 합니다. 가져온 항목은 먼저 여기서 확인한 다음 테스트하세요.

Global Routing: 클라이언트의 연결 처리 방식을 정하는 전역 라우팅 설정입니다. Config(설정), Proxy(프록시), Direct(직접 연결) 세 가지 모드가 있으며, 서버 프로토콜을 선택하는 메뉴는 아닙니다. 트래픽이 예상대로 분기되지 않는다면 먼저 여기서 모드를 확인한 뒤 개별 규칙을 살펴보세요.

Config / Proxy / Direct: Config는 현재 설정 파일의 규칙을 적용하고, Proxy는 트래픽을 프록시로 처리하며, Direct는 대상에 직접 연결합니다. 첫 글자만 대문자인 이 이름은 Global Routing 화면의 옵션이며, 규칙에 쓰이는 대문자 PROXY, DIRECT와는 다른 계층입니다. 모드를 임시로 변경했다면 평소 사용하던 설정으로 되돌리세요.

On Demand: 설정한 네트워크 조건에 따라 연결을 시작하는 기능입니다. 연결을 언제 시도할지 제어하며, 특정 도메인에 적용할 규칙을 정하지는 않습니다. 수동으로 연결을 끈 뒤 다시 연결된다면 먼저 On Demand 조건을 확인한 다음 다른 설정을 살펴보세요.

Connectivity Test: 선택한 방법으로 서버 연결 상태를 확인합니다. 결과는 테스트 대상, 현재 네트워크, 서버 상태에 따라 달라집니다. 표시되는 시간은 다운로드 대역폭이 아니며 모든 웹사이트에 접속할 수 있다는 보장도 아닙니다. 결과를 비교할 때는 테스트 방법을 동일하게 유지하세요. 시간 초과가 발생하면 주소, 포트, 인증 정보를 추가로 확인해야 합니다.

Data: 클라이언트의 트래픽과 연결 기록을 확인하는 메뉴입니다. 요청이 발생했는지, 트래픽이 예상한 경로로 전달되는지 살펴볼 수 있습니다. 클라이언트 통계 범위는 서비스 제공자의 계정 청구 내역과 다를 수 있으므로 구독 잔여량을 추정하는 데 사용할 수 없습니다. 기록을 공유하기 전에 서버 주소, 개인 도메인, 인증 정보를 삭제하세요.

Settings: 클라이언트의 주요 옵션을 관리하는 설정 메뉴입니다. 일부 동작은 현재 Config 설정 파일의 영향을 받으므로 스위치를 변경한 뒤 관련 설정 항목이 있는지도 확인하세요. 문제를 해결할 때는 한 번에 한 항목만 바꾸고 기존 값을 기록해 두세요. 여러 설정을 동시에 바꾸면 원인을 파악하기 어렵습니다.

프로토콜

프로토콜 이름은 연결 방식을 나타낼 뿐, 회선 품질을 의미하지 않습니다. 사용자가 보유한 서버 정보를 기준으로 입력하고 이름만 보고 매개변수를 추측하지 마세요.

Shadowsocks: 서버 주소, 포트, 암호화 방식, 비밀번호 등의 매개변수로 프록시 연결을 설정하는 프로토콜입니다. 가져온 뒤에는 비밀번호뿐 아니라 암호화 방식도 서버 설정과 일치하는지 확인하세요. 항목에 추가 매개변수가 있다면 원본 정보를 그대로 유지해야 합니다. 공유 링크는 보통 ss://로 시작합니다.

VMess: UUID 등의 정보로 사용자를 식별하는 프록시 프로토콜입니다. 공유 링크는 보통 vmess://로 시작합니다. 주소와 포트 외에도 전송 방식, 경로, Host, TLS 설정이 연결에 영향을 줄 수 있습니다. UUID가 올바르더라도 전송 매개변수가 일치하지 않으면 연결에 실패할 수 있습니다.

VLESS: UUID를 사용자 식별 정보로 사용하는 프록시 프로토콜입니다. 공유 링크는 보통 vless://로 시작합니다. 프로토콜 이름만으로 특정 보안 설정이 자동 적용되는 것은 아니므로 서버가 지정한 전송 및 보안 매개변수를 확인해야 합니다. 주소가 같더라도 다른 항목의 설정을 그대로 적용하지 마세요.

Trojan: 일반적으로 TLS와 함께 사용하며 비밀번호로 인증하는 프록시 프로토콜입니다. 공유 링크는 보통 trojan://으로 시작합니다. 연결하려면 서버 주소, 포트, 비밀번호, 해당 TLS 매개변수가 필요합니다. 서버 이름 등의 정보도 원본과 일치해야 합니다. 인증서 오류가 발생하면 도메인과 기기 시간을 확인하고, 검증을 바로 건너뛰지 마세요.

Hysteria2: QUIC 기반 프록시 프로토콜로, 연결하려면 현재 네트워크에서 UDP를 지원해야 합니다. 인증 정보, 서버 이름, 기타 추가 매개변수를 서버 설정과 일치시켜야 합니다. 특정 네트워크에서 연결할 수 없다고 해서 프로토콜 이름만으로 서버 장애를 단정하지 말고, 네트워크 환경과 실제 테스트 결과를 함께 확인하세요.

WireGuard: 키 쌍과 Peer 정보를 사용해 암호화 터널을 구성하는 프로토콜입니다. 일반적으로 개인 키, 공개 키, 엔드포인트, 주소 범위를 설정하며 각 필드의 역할은 서로 달라 바꿔 쓸 수 없습니다. 개인 키는 민감 정보이므로 공개 스크린샷, 로그 또는 문의 내용에 포함하지 마세요.

HTTP / SOCKS5: 자주 사용되는 두 가지 프록시 프로토콜입니다. 일반적으로 서버 주소와 포트를 사용하며, 서버에 따라 사용자 이름과 비밀번호가 필요할 수 있습니다. 인증 방식, 전송 암호화, UDP 지원 여부는 해당 서버의 기능을 확인해야 합니다. 프로토콜 이름만으로 암호화가 보장되는 것은 아닙니다. 항목 유형은 사용자가 보유한 서버 안내와 일치하게 선택하세요.

규칙 키워드

먼저 일치 조건을 작성한 다음 처리 정책을 지정하세요. 규칙을 읽을 때는 순서도 함께 확인해야 합니다. 일반적으로 더 앞에 있는 규칙이 먼저 일치 결과를 결정합니다.

Rule: 연결 대상과 처리 정책을 연결하는 규칙입니다. 일반적인 형식은 '유형, 일치 조건, 정책'입니다. 예: DOMAIN,example.com,DIRECT. Global Routing이 Config로 설정된 경우 현재 설정의 규칙 순서대로 적용됩니다. 규칙이 존재한다고 해서 모든 연결에 해당 규칙이 적용되는 것은 아닙니다.

DOMAIN: 지정한 도메인과 정확히 일치시킵니다. 예: DOMAIN,example.com,DIRECT. 이 규칙은 www.example.com 등의 하위 도메인까지 자동으로 포함하지 않습니다. 도메인 전체와 하위 도메인에 적용하려면 정확히 일치하는 규칙을 반복해서 추가하지 말고 DOMAIN-SUFFIX를 확인하세요.

DOMAIN-SUFFIX: 지정한 도메인과 하위 도메인을 일치시킵니다. 예: DOMAIN-SUFFIX,example.com,PROXY. example.com과 www.example.com을 포함하지만, 임의의 문자열이 포함된 도메인과 일치하는 것은 아닙니다. 규칙을 추가한 뒤에는 앞쪽에 더 먼저 일치하는 규칙이 있는지도 확인하세요.

DOMAIN-KEYWORD: 도메인에 지정한 키워드가 포함되어 있는지 일치시킵니다. 예: DOMAIN-KEYWORD,example,PROXY. 일치 범위가 도메인 접미사 지정 방식보다 넓어 의도하지 않은 도메인까지 적용될 수 있습니다. 특정 사이트와 하위 도메인에만 적용하려면 더 명확한 일치 조건을 사용할 수 있는지 먼저 확인하세요.

GEOIP: IP 지리 데이터베이스에 등록된 국가 또는 지역을 기준으로 대상을 일치시킵니다. 예: GEOIP,CN,DIRECT. 페이지에 쓰인 문자, 도메인 접미사, 사용자의 현재 위치를 판단하는 것은 아닙니다. DNS 조회 결과, 데이터베이스 내용, 규칙 순서가 최종 일치 결과에 영향을 줄 수 있습니다.

IP-CIDR / IP-CIDR6: IPv4 및 IPv6 주소 대역을 각각 일치시킵니다. 슬래시 뒤의 숫자는 프리픽스 길이입니다. 예를 들어 IP-CIDR,192.0.2.0/24,DIRECT는 하나의 IPv4 주소 대역을 지정합니다. 도메인이 서로 다른 주소로 해석되면 적용되는 규칙도 달라질 수 있으므로 DNS 결과와 함께 주소 대역 규칙을 확인하세요.

FINAL: 앞선 규칙이 모두 일치하지 않을 때 적용되는 최종 규칙입니다. 예: FINAL,PROXY. 일반적으로 규칙 목록 맨 아래에 두어 나머지 연결의 처리 방식을 지정합니다. FINAL은 특정 도메인을 지정하는 규칙이 아닙니다. 많은 요청이 여기에 해당한다면 앞쪽 규칙의 조건이 실제 대상에 맞는지 확인하세요.

PROXY / DIRECT / REJECT: 규칙의 처리 정책입니다. PROXY는 프록시로 처리하고, DIRECT는 직접 연결하며, REJECT는 연결을 거부합니다. 규칙의 정책 위치에 사용되며 서버 프로토콜을 설명하지는 않습니다. 대문자 DIRECT는 해당 규칙과 일치하는 연결에만 적용되며, Global Routing을 Direct로 변경하는 것과는 다릅니다.

구독 및 설정

서버 목록, 규칙 파일, 동기화 데이터를 구분하세요. 가져오기 전에 본인의 구독 또는 서버 정보를 보유하고 있어야 합니다.

Server / Add Server: Server는 프로토콜, 주소, 포트, 인증 정보 등의 매개변수로 구성된 서버 항목이며, Add Server는 항목을 수동으로 추가하는 메뉴입니다. 중국어 안내에서 사용하는 '노드'는 보통 이러한 항목을 뜻하며 앱 구매에 포함된 서비스가 아닙니다. 추가한 뒤에는 필드를 확인하고 연결 테스트를 진행한 다음 연결 대상을 선택하세요.

Config: 설정 파일에서 Config는 규칙과 DNS 등의 설정을 담으며 서버 구독 목록과는 다릅니다. Global Routing에서 같은 이름의 Config는 설정에 따라 트래픽을 분기하는 모드를 뜻합니다. 파일을 가져온 뒤 실제로 선택되어 있는지도 확인하세요. 파일이 존재하더라도 활성화하지 않았다면 규칙이 적용 중이라고 볼 수 없습니다.

DNS: 도메인을 IP 주소로 변환하는 기능입니다. 변환 결과는 이후 IP 관련 규칙의 일치 여부에 사용될 수 있습니다. 서버에는 연결되지만 일부 도메인이 열리지 않는다면 DNS도 점검해야 합니다. DNS 설정을 변경할 때는 기존 값을 기록하고 도메인 조회와 대상 접속을 각각 확인하세요. 모든 연결 실패를 서버 탓으로 돌리지 마세요.

Scan QR Code: QR 코드를 스캔해 서버 또는 구독 정보를 가져오는 메뉴입니다. 카메라로 스캔하려면 관련 권한이 필요합니다. QR 코드는 정보를 전달하는 수단일 뿐, 내용이 완전하거나 유효하며 현재 클라이언트에 적합하다는 보장은 없습니다. 가져오기 전에 출처를 확인하고, 가져온 뒤에는 항목 유형을 살펴보세요. 인증 정보가 포함된 QR 코드를 공개적으로 전달하지 마세요.

URL Rewrite: 일치 조건에 따라 요청 주소를 다시 쓰거나 지정된 처리를 수행하는 기능입니다. 직접 연결 또는 프록시 사용을 결정하는 일반 라우팅 규칙과는 다릅니다. HTTPS 요청 내용을 수정하려면 추가 설정과 권한이 필요할 수 있으며 Rewrite 규칙 하나를 추가한다고 바로 적용되는 것은 아닙니다. 규칙의 출처, 일치 범위, 영향을 이해한 뒤 사용하고 원래 설정으로 복구할 수 있도록 보관하세요.

iCloud 동기화: iCloud를 통해 지원되는 기기 간에 앱 데이터를 동기화합니다. 서비스 제공자의 구독을 새로 고치는 기능은 아닙니다. 동기화할 수 있는 항목은 앱에서 제공하는 옵션에 따라 달라지며 계정, 시스템 권한, 네트워크 상태의 영향을 받습니다. 동기화를 완전한 백업으로 여기지 마세요. 기기를 변경하기 전에 필요한 설정 자료를 별도로 저장하고 인증 정보를 안전하게 보호하세요.

플랫폼 및 설치

Shadowrocket은 iPhone, iPad, Mac, Windows, Android, Linux를 지원합니다. 앱을 받는 경로와 시스템 권한 설정은 별개의 단계입니다.

App Store / 구입 항목: App Store는 iPhone / iPad 버전을 받는 경로이며, '구입 항목'에서 해당 계정의 구입 내역을 확인할 수 있습니다. 제품 페이지에서 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 확인하세요. 기기를 변경하거나 앱을 다시 설치할 때는 기존 구입 계정을 먼저 확인한 뒤 구입 내역을 찾아보세요. 구입 내역과 앱 내 서버 정보는 별개의 데이터입니다.

Apple 실리콘 / Intel: Mac 설치 파일은 두 가지 프로세서 호환 유형으로 제공됩니다. '이 Mac에 관하여'에서 칩 또는 프로세서 정보를 확인한 뒤 해당 dmg를 선택하세요. 처음 실행할 때 개발자를 확인할 수 없다는 알림이 표시되면 설치 파일이 이 사이트에서 제공된 것인지 확인한 뒤 '개인정보 보호 및 보안'에서 '그래도 열기'를 살펴보세요. 손상되었다는 알림이 표시되면 먼저 다시 다운로드하세요. 문제가 계속되면 설치 허용 안내를 확인하세요. 시스템 차단은 연결 오류와 다릅니다.

SmartScreen / 알 수 없는 앱 설치 허용: SmartScreen은 Windows의 위험 알림 기능이며, 알 수 없는 앱 설치 허용은 Android에서 설치 출처를 허용하는 설정입니다. 이 사이트의 설치 파일을 사용하는지 확인한 뒤 Windows에서 해당 옵션이 표시되면 '자세한 정보 → 실행'을 선택할 수 있습니다. Android에서는 시스템 안내에 따라 현재 출처에 대해 '알 수 없는 앱 설치 허용'을 켜세요. 이 설정은 설치 권한만 처리하며 서버, 구독, DNS 문제를 해결하지는 않습니다. 자세한 절차는 설치 허용 안내를 확인하세요.

deb / rpm / AppImage: Linux에서 흔히 사용하는 소프트웨어 배포 형식입니다. deb는 주로 Debian 계열 배포판에서, rpm은 Fedora 등 해당 패키지 관리 방식을 사용하는 배포판에서 사용됩니다. AppImage는 일반적으로 실행 권한을 부여한 뒤 실행하며, 사용 가능 여부는 시스템 환경과 종속성에 따라 달라집니다. 배포판에 맞는 형식을 선택하세요. 형식을 바꾸는 것만으로 모든 실행 오류가 해결되는 것은 아닙니다. 명령어와 권한 설정은 Linux 설치 안내를 확인하세요.

VPN 구성: 클라이언트가 네트워크 트래픽을 처리하도록 시스템이 설정과 권한을 부여하며, 처음 연결할 때 확인을 요청할 수 있습니다. 이는 서버 계정이나 구독 주소가 아니며, 원격 서비스의 연결 가능 여부를 시스템이 확인했다는 뜻도 아닙니다. 관련 설정을 실수로 삭제했다면 Shadowrocket에서 연결을 시작하고 시스템 안내에 따라 다시 권한을 부여하세요. 권한을 부여한 뒤에도 연결 상태는 별도로 확인해야 합니다.