공식 매뉴얼 · 용어 찾기

Shadowrocket 용어 가이드

인터페이스 용어, 프로토콜, 규칙 키워드의 의미를 확인하세요. 연결 대상, 라우팅 모드, 처리 동작을 구분한 뒤 필요한 설정을 변경하세요.

이 페이지에서는 앱에 표시되는 영어 용어를 그대로 사용하며, 각 용어는 제목 옆 링크로 바로 이동할 수 있습니다. 인터페이스 메뉴와 사용 가능한 옵션은 플랫폼마다 다를 수 있으니 현재 앱에 표시되는 내용을 기준으로 하세요. 연속된 조작 절차는 시작 가이드를, 설정 안내는 설정 매뉴얼을 확인하세요.

Shadowrocket은 iPhone / iPad / Mac(Apple 칩 및 Intel) / Windows / Android / Linux에서 사용할 수 있습니다. iPhone / iPad 버전은 App Store에서 $2.99에 1회 구매하며, Mac / Windows / Android / Linux 버전은 무료입니다. 플랫폼별 이용 방법은 전체 플랫폼 다운로드 안내를 확인하세요.

01 · 인터페이스 및 스위치

화면 메뉴와 연결 모드

화면 이름은 조작 위치를, 모드 이름은 요청 처리 방식을 뜻합니다. 두 가지를 혼동하지 마세요.

Home #
Home은 서버 항목을 확인하고 연결 대상을 선택하거나 연결 스위치를 조작하는 주요 화면입니다. 항목을 선택해도 연결이 자동으로 설정되는 것은 아니므로 연결 스위치와 시스템 권한 상태를 확인해야 합니다. 문제를 해결할 때는 먼저 여기서 실제로 선택된 항목을 확인한 뒤 규칙을 살펴보세요. 잘못 선택한 서버를 구성 오류로 오인하지 않도록 주의하세요.
Global Routing #
Global Routing에서는 전체 라우팅 모드를 선택하며, 개별 서버를 고르는 기능은 아닙니다. 구성, 프록시, 직접 연결은 각각 화면의 Config, Proxy, Direct에 해당합니다. 규칙 파일이 적용되지 않는 것 같다면 먼저 Config 모드인지 확인한 뒤 해당 파일이 선택되어 있는지 살펴보세요.
Config / Proxy / Direct #
Config는 현재 구성의 규칙에 따라 요청을 처리하고, Proxy는 프록시 모드로, Direct는 직접 연결 모드로 처리합니다. 이는 전체 라우팅 모드이며, 규칙 행에 쓰이는 대문자 동작 키워드와는 다른 단계입니다. 문제 범위를 좁히기 위해 모드를 임시로 바꿨다면 테스트 후 필요한 원래 모드로 되돌리세요.
On Demand #
On Demand는 네트워크 환경 등의 조건에 따라 연결 동작을 실행하며, 조건에 맞춰 연결하거나 연결을 끊어야 할 때 유용합니다. 연결 시점을 제어하는 기능이지, 도메인이나 IP 규칙처럼 요청의 경로를 정하는 기능은 아닙니다. 연결이 자동으로 다시 시작된다면 주 스위치를 반복해서 조작하기보다 먼저 조건에 맞는 On Demand 설정이 있는지 확인하세요.
Add Server #
Add Server는 서버 항목을 직접 추가하는 메뉴입니다. 사용자가 보유한 서버 정보에 맞는 프로토콜을 선택하고 주소, 포트, 인증 필드를 하나씩 입력하세요. 필드의 모양만 보고 유형을 추측하지 마세요. 저장이 완료되어도 항목이 기록된 것일 뿐이므로, 실제 연결을 통해 매개변수가 올바른지 확인해야 합니다.
Settings #
Settings는 클라이언트 설정을 확인하고 조정하는 화면입니다. 설정에 따라 테스트, 로그, 동기화 또는 연결 동작이 달라질 수 있으며, 모든 항목이 모든 플랫폼에서 제공되는 것은 아닙니다. 변경하기 전에 기존 값을 기록하고, 현재 문제와 관련된 항목만 한 번에 하나씩 바꾸면 효과를 확인하고 원래대로 복구하기 쉽습니다.

02 · 프로토콜

연결 방식과 인증

프로토콜 이름은 속도 등급이 아닙니다. 클라이언트 유형, 인증 정보, 전송 설정은 서버 측 설정과 일치해야 합니다.

Shadowsocks #
Shadowsocks는 프록시 프로토콜로, 연결에 일반적으로 서버 주소, 포트, 비밀번호, 암호화 방식이 필요합니다. 비밀번호가 맞더라도 암호화 방식이 일치하지 않으면 연결이 실패할 수 있습니다. 직접 입력할 때는 원본 정보를 항목별로 확인하고, 다른 프로토콜의 사용자 식별자를 여기에 비밀번호로 입력하지 마세요.
VMess #
VMess는 사용자 식별자 등의 값으로 인증하며, 연결에 전송 방식과 보안 설정이 추가로 필요할 수 있습니다. 가져온 뒤에는 항목 이름만 보지 말고 주소, 포트, 사용자 식별자와 관련 전송 필드를 확인하세요. 인증에 실패하면 기기 시간도 확인해 시간 오차가 원인 분석에 영향을 주지 않도록 하세요.
VLESS #
VLESS는 사용자 식별자를 사용하는 프록시 프로토콜입니다. 프로토콜 이름만으로 전송 암호화가 활성화된 것은 아닙니다. 실제 연결의 보안과 호환성은 함께 사용하는 전송 및 보안 계층 설정에도 달려 있습니다. 사용자 식별자를 사용한다는 이유만으로 VMess 항목과 VLESS 항목을 서로 바꾸지 마세요.
Trojan #
Trojan은 일반적으로 TLS와 함께 사용하며, 올바른 비밀번호와 서버에 맞는 보안 설정이 필요합니다. 서버 이름과 인증서 검증이 연결에 영향을 주므로, 서버 IP를 입력했다고 이름 필드를 생략할 수 있는 것은 아닙니다. 인증서 오류가 발생하면 검증을 바로 끄기보다 도메인, 기기 시간, 서버 설정부터 확인하세요.
Hysteria2 #
Hysteria2는 QUIC 기반 프록시 프로토콜이며 UDP 통신이 가능한 환경이어야 합니다. 현재 네트워크의 UDP 연결 가능 여부와 인증 필드, 서버 설정이 모두 연결에 영향을 줍니다. 일반 웹페이지가 열린다고 해서 이 프로토콜에 필요한 통신 경로까지 정상이라고 단정할 수는 없습니다.
WireGuard #
WireGuard는 공개 키와 개인 키, 상대방 설정으로 암호화 터널을 구성합니다. 설정할 때 로컬 개인 키, 상대방 공개 키, 엔드포인트, 주소 범위를 구분하고 공개 키와 개인 키의 위치를 바꾸지 마세요. 개인 키는 민감 정보이므로 문제 화면을 제출하거나 구성을 공유하기 전에 삭제하세요.
HTTP / SOCKS5 #
HTTP와 SOCKS5는 일반적인 프록시 프로토콜 유형이며, 서버가 실제로 지원하는 방식에 맞춰 설정해야 합니다. 포트가 같아도 프로토콜이 호환되는 것은 아니며, 인증이 필요한지는 서버 설정에 따라 다릅니다. SOCKS5라는 이름만으로 전송 암호화가 보장되는 것은 아니므로 실제 연결 방식을 확인하세요.

03 · 규칙 키워드

매칭 조건과 처리 동작

먼저 매칭 대상을 확인하고, 매칭된 뒤의 동작을 살펴본 다음 규칙 순서를 확인하세요.

규칙 #
규칙은 일반적으로 매칭 유형, 매칭 내용, 처리 동작으로 구성되어 특정 요청을 처리하는 방식을 결정합니다. 규칙 목록은 보통 순서대로 판별하므로 앞선 규칙에 매칭되면 뒤의 규칙은 판별 대상에서 제외될 수 있습니다. 규칙을 추가한 뒤에는 위치를 확인하고 Global Routing이 Config 모드인지 살펴보세요.
DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD #
DOMAIN은 정확한 도메인을, DOMAIN-SUFFIX는 도메인 접미사를, DOMAIN-KEYWORD는 도메인 키워드를 매칭합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 접미사를 기준으로 매칭한 뒤 프록시로 처리한다는 뜻입니다. 키워드 매칭 범위는 더 넓을 수 있으므로, 명확한 도메인 대신 지나치게 짧은 단어를 사용하지 마세요.
GEOIP #
GEOIP는 IP 주소 데이터베이스의 지역 정보를 기준으로 매칭합니다. 예: GEOIP,CN,DIRECT. 웹페이지 내용, 도메인 접미사, 방문자 위치를 기준으로 판별하는 기능은 아닙니다. 이름 해석 결과와 주소 데이터베이스, 서비스에서 사용하는 분산 인프라에 따라 매칭 결과가 달라질 수 있습니다.
IP-CIDR / IP-CIDR6 #
IP-CIDR은 IPv4 대역을, IP-CIDR6은 IPv6 대역을 매칭합니다. 슬래시 뒤의 프리픽스 길이가 주소 범위를 결정합니다. 대역 규칙은 주소를 대상으로 하며 도메인 문자열을 대상으로 하지 않습니다. 대상 주소가 바뀌면 매칭 결과도 달라질 수 있습니다. 단일 주소만 처리하려면 프리픽스가 의도치 않게 더 넓은 범위를 포함하지 않는지 확인하세요.
FINAL #
FINAL은 앞선 규칙에 매칭되지 않았을 때 적용하는 기본 규칙입니다. 예: FINAL,PROXY. 일반적으로 규칙 목록의 마지막에 두어야 하며, 앞에 배치하면 이후에 판별되어야 할 요청까지 먼저 처리할 수 있습니다. 기본 동작은 실제 필요에 맞게 설정하세요. 기본 규칙보다 뒤에 규칙을 계속 추가해도 앞선 기본 규칙을 바로잡을 수는 없습니다.
PROXY / DIRECT / REJECT #
PROXY는 프록시로 처리, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 규칙에 사용되는 처리 동작으로, 프로토콜 이름이나 서버 주소가 아닙니다. 규칙을 읽을 때는 대문자 표기를 그대로 유지하고 Global Routing의 Proxy, Direct 모드와 구분하세요.
USER-AGENT #
USER-AGENT는 읽을 수 있는 HTTP User-Agent 필드를 기준으로 요청을 매칭하며, 앱 이름으로 트래픽을 분리하는 것과는 다릅니다. 암호화된 연결에서는 해당 필드를 읽지 못할 수 있으므로 규칙이 있어도 모든 요청이 매칭되는 것은 아닙니다. 문제를 확인할 때는 키워드만 바꾸지 말고 요청 조건과 필드 확인 가능 여부부터 살펴보세요.

04 · 구독 및 구성

연결 정보, 파일, 복원

서버 구독, 규칙 구성, 스토어 구입 내역은 각각 다른 내용을 관리하므로 서로 대신할 수 없습니다.

Subscribe #
Subscribe는 사용자가 보유한 구독 URL을 통해 서버 항목을 가져오거나 업데이트하는 기능입니다. 구독을 업데이트하면 항목 내용이 바뀔 수 있으므로 구독으로 관리하는 기록과 직접 추가한 기록을 구분하세요. 구독 URL에는 접근 인증 정보가 포함될 수 있으니 공개 화면 캡처, 로그, 공유 문서에 넣지 마세요.
서버 항목 #
서버 항목에는 주소, 포트, 프로토콜, 인증 정보 등의 연결 매개변수가 저장되며, 흔히 노드라고도 합니다. 항목 이름은 구별을 위한 라벨일 뿐 실제 위치, 사용 가능 여부, 성능을 나타내지는 않습니다. 이름이 같은 항목이 있다면 매개변수와 소속 구독을 확인해 사용 중인 기록을 잘못 삭제하지 않도록 하세요.
Config 구성 파일 #
Config 구성 파일에는 규칙, DNS, 정책 등의 설정을 저장할 수 있습니다. 서버 항목을 제공하는 구독과는 다른 개념입니다. 파일을 다운로드했더라도 선택하지 않았다면 적용되지 않으며, 파일을 수정해도 현재 모드가 해당 파일을 사용한다는 보장은 없습니다. Config는 화면 이름과 라우팅 모드 양쪽에 나타나므로 조작 단계를 읽을 때 위치에 따라 의미를 판단하세요.
Scan QR Code #
Scan QR Code는 QR 코드에서 인식 가능한 연결 정보를 읽어오는 메뉴입니다. QR 코드에는 단일 서버 정보나 구독 URL이 포함될 수 있습니다. 스캔 후에는 인식된 유형과 주요 필드를 확인한 뒤 저장하세요. QR 코드는 정보를 인코딩하는 형식일 뿐 내용의 신뢰성을 보장하지 않으며, 인증 정보가 포함된 코드를 공개해서도 안 됩니다.
iCloud 동기화 #
iCloud 동기화는 해당 계정과 시스템 권한이 갖춰진 경우 앱에서 지원하는 데이터를 동기화합니다. 동기화 범위는 앱 안내를 확인하세요. 스위치를 켰다고 모든 내용의 업로드가 완료된 것은 아니므로 기기를 바꾸기 전에 새 기기에서 복원 결과를 확인해야 합니다. 동기화와 별도 내보내기 백업은 용도가 다르므로 중요한 구성은 복구할 수 있는 사본을 보관하는 것이 좋습니다.
구입 항목 #
구입 항목에서는 처음 구입한 계정으로 앱 구입 내역을 찾아 다운로드를 복원할 수 있습니다. 서버 정보나 규칙 파일을 복원하는 기능은 아닙니다. iPhone / iPad 버전은 App Store에서 $2.99에 1회 구매하며, Mac / Windows / Android / Linux 버전은 무료입니다. 스토어 앱 ID는 932747118이며 개발자는 Shadow Launch Technology Limited입니다. 시스템 요구 사항은 App Store 페이지 표기를 기준으로 합니다.

05 · 설정 및 진단

이름 해석, 테스트, 실행 기록

진단 결과는 특정 조건에 대한 정보일 뿐입니다. 대상 요청, 현재 모드, 네트워크 환경을 함께 고려해 판단하세요.

DNS #
DNS는 도메인 이름을 IP 주소로 변환하며, 그 결과는 이후 연결과 일부 규칙 판별에 영향을 줍니다. 서버에는 연결되지만 특정 도메인이 열리지 않는다면 이름 해석이 성공했는지와 요청이 최종적으로 어떤 경로를 사용하는지 각각 확인하세요. 여러 DNS 설정을 무작정 겹쳐 사용하면 문제를 파악하기 어려워지므로 현재 구성에서 실제로 어떤 설정을 쓰는지 먼저 확인하세요.
Connectivity Test / 지연 시간 #
Connectivity Test는 특정 테스트 조건에서 응답을 확인하며, 지연 시간은 해당 과정에 걸리는 시간입니다. 지연 시간이 짧다고 다운로드 속도가 반드시 빠른 것은 아니며, 테스트에 성공해도 모든 대상 요청이 성공하는 것은 아닙니다. 결과를 비교할 때는 네트워크, 테스트 방식, 대상을 가능한 한 동일하게 유지하고 실제 요청도 확인하세요.
Log #
Log는 연결, 이름 해석, 요청 처리 문제를 파악하는 데 도움이 되는 실행 기록입니다. 문제를 확인할 때는 재현 시각, 대상 도메인, 현재 모드를 기록한 뒤 관련 로그를 함께 살펴보세요. 오류 한 줄만 따로 캡처하는 것보다 효과적입니다. 공유하기 전에는 구독 URL, 인증 필드, 불필요한 개인 접속 기록을 삭제하세요.
URL Rewrite #
URL Rewrite는 매칭 규칙에 따라 처리 가능한 요청 주소나 관련 동작을 수정하는 기능입니다. 프록시 또는 직접 연결을 선택하는 기능과는 다릅니다. 적용 여부는 요청 처리 가능 여부, 매칭 표현식, 관련 설정 조건에 따라 달라집니다. 표현식을 수정하기 전에 대상 범위를 확인해 정상 요청까지 다시 쓰지 않도록 하세요.
Proxy 포트 #
Proxy 포트는 이 기기의 프록시 서비스가 연결을 수신하는 포트로, 원격 서버 항목에 설정된 포트와는 다릅니다. 다른 프로그램에서 사용하려면 해당 리슨 주소, 포트, 프로토콜 유형을 입력해야 합니다. 다른 기기의 접근을 허용하면 접근 범위가 넓어지므로 활성화하기 전에 리슨 설정, 네트워크 신뢰 범위, 접근 제어를 확인하세요.
Data #
Data에서는 앱에 기록된 데이터 트래픽 정보를 확인할 수 있습니다. 집계 범위와 기간은 현재 화면에 표시되는 내용을 기준으로 해석하세요. 앱의 기록 방식은 서비스 제공자의 사용량 계산 방식과 다를 수 있으므로 계정의 잔여 용량으로 간주하면 안 됩니다. 사용량이 비정상적으로 늘었다면 집계 시간, 연결 기록, 실제 사용 내역을 함께 살펴보세요.

용어에서 조작 단계로 돌아가기

가져오기와 첫 연결은 튜토리얼을, DNS, On Demand, 진단 옵션은 설정 매뉴얼을, 자주 묻는 질문은 문답을 확인하세요. iPhone / iPad 스토어 정보는 Shadowrocket App Store 제품 페이지에서 확인할 수 있습니다.

용어 분류로 돌아가기 ↑