화면 항목과 스위치
Home
저장된 연결 항목과 연결 스위치를 확인하는 곳으로, 연결을 시작하기 전에 주로 확인해야 합니다. 목록에 항목이 표시된다는 것은 정보가 저장되었다는 뜻일 뿐, 인증에 성공했거나 네트워크 터널이 만들어졌다는 의미는 아닙니다. 현재 선택된 항목과 연결 상태도 확인하세요.
공식 매뉴얼 · 용어 색인
Shadowrocket
용어 가이드
영어 원문으로 용어를 찾은 다음, 표시된 위치에 따라 의미를 확인하세요. 이 페이지는 다섯 가지 분류의 용어 32개를 다룹니다. 특히 화면 옵션 Proxy와 규칙 전략 PROXY의 차이에 유의하세요.
화면 항목은 영어 원문 유지
규칙은 위에서 아래로 일치
먼저 라우팅 방식 확인
01 / INTERFACE
화면 항목과 스위치
같은 단어가 탭 이름, 라우팅 옵션, 규칙 본문에 나타날 수 있습니다. 먼저 어디에 표시되는지 확인한 다음, 어떤 범위를 제어하는지 파악하세요.
화면 항목과 스위치
Global Routing
전체 라우팅 방식을 정합니다. 일반적인 옵션인 Config, Proxy, Direct는 각각 구성, 프록시, 직접 연결 방식에 해당합니다. 사용자 지정 규칙이 예상대로 작동하지 않으면 규칙을 계속 수정하기보다 먼저 Config가 선택되어 있는지 확인하세요.
화면 항목과 스위치
Config
페이지 이름으로는 구성 파일을 관리하는 위치를 뜻하고, Global Routing 옵션으로는 현재 구성에 따라 트래픽을 처리한다는 의미입니다. 구성을 저장하는 것과 해당 구성을 활성화하는 것은 별개의 작업입니다. 문제를 확인할 때는 파일 내용, 현재 선택 상태, 전체 라우팅 방식을 함께 살펴보세요.
화면 항목과 스위치
Proxy
Global Routing에서 프록시 방식을 뜻하며, 요청을 해당 프록시 경로로 처리합니다. 규칙에 쓰이는 대문자 PROXY와는 서로 다른 설정 계층입니다. 이 항목을 선택해도 서버 주소, 비밀번호, 인증서 설정 오류가 해결되지는 않습니다.
화면 항목과 스위치
Direct
Global Routing에서 직접 연결 방식을 뜻하며, 대상 요청을 직접 연결합니다. 현재 네트워크에서의 접속 상태를 비교할 때 유용하지만, 직접 연결도 로컬 네트워크, DNS, 대상 서비스 상태에 좌우됩니다. 모든 대상에 반드시 접속할 수 있다는 의미는 아닙니다.
화면 항목과 스위치
On Demand
설정한 조건에 따라 연결 동작을 실행합니다. 네트워크 유형, 지정된 Wi-Fi, 도메인 조건 등이 확인 대상입니다. 활성화한 뒤 자동으로 연결되거나 해제되면 먼저 조건이 충족되었는지 살펴보세요. 수동 스위치만 보고 있으면 조건에 따른 자동 동작을 연결 문제로 오해하기 쉽습니다.
화면 항목과 스위치
Data
앱에 기록된 트래픽 및 연결 관련 정보를 확인해 요청이 발생했는지 판단하는 데 참고할 수 있습니다. 통계 범위와 기록 기간은 현재 화면에서 확인해야 합니다. 서비스 제공자의 사용량 청구 내역으로 간주하거나 남은 사용량을 추정하는 데 사용해서는 안 됩니다.
화면 항목과 스위치
Settings
앱 설정을 모아 둔 위치이며, 개별 서버 항목을 편집하는 화면과는 역할이 다릅니다. 문제를 확인할 때는 기존 값을 기록하고, 한 번에 하나씩 변경한 뒤 같은 대상을 다시 테스트하세요. 여러 설정을 동시에 바꾸면 원인과 되돌리는 방법을 파악하기 어려워집니다.
02 / PROTOCOLS
프로토콜 이름
프로토콜 이름은 통신 방식을 나타내며 서비스 품질을 뜻하지 않습니다. 아래 설명은 기술적 의미에 한정됩니다. 매개변수는 사용자가 보유한 서버의 요구사항과 일치해야 하며, 이름만 바꾼다고 프로토콜이 변환되지는 않습니다.
프로토콜 이름
Shadowsocks
프록시 프로토콜로, 일반적으로 서버 주소, 포트, 비밀번호, 암호화 방식 등의 정보가 필요합니다. 암호화 방식은 프로토콜 매개변수의 일부이므로 이름이 비슷하다는 이유만으로 임의로 바꾸면 안 됩니다. 주소가 조회되지만 연결에 실패한다면 포트, 인증, 서버 상태도 확인하세요.
프로토콜 이름
VMess
사용자 인증이 포함된 프록시 프로토콜이며, 실제 연결에는 여러 전송 방식과 TLS 설정이 관련될 수 있습니다. 가져온 후에는 사용자 식별자, 전송 유형, 경로, 서버 이름 등의 해당 필드를 확인하세요. 프로토콜이 VMess로 선택되었는지만 확인해서는 전체 매개변수가 완전하다고 볼 수 없습니다.
프로토콜 이름
VLESS
프록시 프로토콜입니다. 서버 측 요구사항에 따라 사용자 식별자, 전송 방식, 보안 관련 매개변수를 입력해야 합니다. VMess와 임의로 바꿔 쓸 수 있는 이름이 아닙니다. 같은 주소에서 여러 연결 방식을 제공한다면 각 방식에 맞는 전체 매개변수 조합을 사용하세요.
프로토콜 이름
Trojan
일반적으로 TLS와 함께 사용하는 프록시 프로토콜입니다. 비밀번호, 포트, 서버 이름을 주로 확인해야 합니다. IP 주소로 연결하는 것과 TLS 검증에 사용하는 이름은 서로 다른 역할을 할 수 있습니다. 인증서 오류가 발생하면 검증을 건너뛰기보다 이름과 인증서 유효성을 확인하세요.
프로토콜 이름
Hysteria2
QUIC 기반 프록시 프로토콜로, 연결 상태는 현재 네트워크에서 UDP를 사용할 수 있는지에 따라 달라집니다. 주소와 인증 외에도 TLS 관련 매개변수와 서버 측 요구사항을 확인하세요. 특정 네트워크에서 실패했다는 사실만으로 서버 정보가 더 이상 유효하지 않다고 단정할 수는 없습니다.
프로토콜 이름
WireGuard
키 쌍 기반 터널 프로토콜입니다. 키, 엔드포인트 주소, 터널 주소, 라우팅 범위 등의 각 항목은 서로 다른 역할을 합니다. 개인 키는 민감 정보이므로 공개 문제 해결 기록에 붙여 넣지 마세요. 가져온 뒤에는 기존 구성을 따라 항목별로 확인하고, 공개 키와 개인 키를 서로 바꿔 넣지 마세요.
03 / RULES
규칙 키워드와 전략
규칙은 먼저 일치 조건을 확인한 다음, 일치하는 경우 전략을 실행합니다. 일반적으로 위에서 아래로 확인하며 일치 항목을 찾으면 검색을 멈춥니다. 따라서 구체적인 조건을 포괄적인 조건보다 앞에 배치해야 합니다.
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY규칙 키워드와 전략
DOMAIN
전체 도메인 이름과 일치시킵니다. 예: DOMAIN,example.com,DIRECT. www.example.com 등의 하위 도메인까지 자동으로 포함하지 않습니다. 도메인과 하위 도메인을 모두 포함하려면 필요한 범위를 먼저 정한 뒤 접미사 일치 사용을 검토하세요.
규칙 키워드와 전략
DOMAIN-SUFFIX
지정한 도메인과 하위 도메인을 일치시킵니다. 예: DOMAIN-SUFFIX,example.com,PROXY. 도메인 경계에 따른 접미사 일치이지, 임의의 문자열 포함이 아닙니다. 더 구체적인 DOMAIN 규칙보다 앞에 두면 해당 규칙이 일치할 기회를 얻지 못할 수 있습니다.
규칙 키워드와 전략
DOMAIN-KEYWORD
도메인에 포함된 키워드를 기준으로 일치시키며, 일반적으로 전체 도메인 규칙보다 범위가 넓습니다. 예를 들어 ads라는 키워드는 용도가 서로 다른 여러 도메인에 포함될 수 있으므로, 키워드만으로 요청의 용도를 판단해서는 안 됩니다. 거부 전략을 적용하기 전에 실제로 일치한 대상을 확인하세요.
규칙 키워드와 전략
IP-CIDR
CIDR로 표기한 IPv4 주소 범위와 일치시킵니다. 예: 192.168.0.0/16. 슬래시 뒤의 숫자는 포트가 아니라 네트워크 프리픽스 길이입니다. 문제를 확인할 때는 대상의 실제 주소가 범위에 포함되는지, 그리고 IP 조건과 앞서 일치한 도메인 조건이 어떻게 다른지 살펴보세요.
규칙 키워드와 전략
IP-CIDR6
CIDR로 표기한 IPv6 주소 범위와 일치시킵니다. 문서 예시 주소 범위는 2001:db8::/32입니다. IPv4와 IPv6에는 서로 다른 주소 범위 규칙이 적용됩니다. 도메인이 서로 다른 유형의 주소를 반환할 수 있으므로 기존 IPv4 규칙이 IPv6 요청에도 적용된다고 가정해서는 안 됩니다.
규칙 키워드와 전략
GEOIP
도메인 문자열이 아니라 IP 지리 데이터베이스의 분류 결과를 기준으로 일치시킵니다. 결과는 대상의 조회 주소와 데이터베이스 기록에 영향을 받으며, 사용자의 정확한 위치를 확인하는 용도로도 쓸 수 없습니다. 예상과 다르게 일치한다면 먼저 대상의 실제 IP를 확인하세요.
규칙 키워드와 전략
FINAL
규칙 맨 마지막에 두는 기본 항목으로, 앞선 규칙이 하나도 일치하지 않을 때 처리 전략을 결정합니다. 예: FINAL,PROXY. 이미 일치한 규칙을 덮어쓰지 않으며, 반드시 프록시를 사용해야 하는 고정 구문도 아닙니다. 기본 동작을 확인할 때는 앞선 규칙의 순서도 함께 살펴보세요.
규칙 키워드와 전략
PROXY / DIRECT / REJECT
규칙에 쓰이는 전략 키워드입니다. PROXY는 프록시 처리, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 일치 조건은 “어떤 요청인지”, 전략은 “어떻게 처리할지”를 결정합니다. 프록시 요청이 최종적으로 어떤 출구를 사용하는지는 현재 선택 항목과 구성의 전략 설정 관계도 확인해야 합니다.
04 / IMPORT
구독과 구성 파일
연결 항목, 구독 출처, 규칙 구성은 서로 다른 개념입니다. 보유한 서비스 정보가 연결 매개변수를 결정하고, 현재 구성은 해당 트래픽의 처리 방식을 결정합니다.
구독과 구성 파일
Subscribe
구독을 가져오고 업데이트할 때 사용하는 화면 용어이며, 사용자가 자신의 구독 링크를 보유하고 있어야 합니다. 업데이트는 출처의 데이터를 다시 읽는 것이지 모든 연결 문제를 해결하는 기능은 아닙니다. 실패하면 링크 사용 가능 여부, 현재 네트워크, 반환된 내용이 앱에서 지원하는 형식인지 각각 확인하세요.
구독과 구성 파일
서버 정보
연결 엔드포인트를 설명하는 매개변수 모음입니다. 일반적으로 주소, 포트, 프로토콜, 인증 정보가 포함되며 전송 방식과 TLS 설정이 포함될 수도 있습니다. 직접 입력하려면 보통 Add Server로 이동합니다. 서버 이름이나 주소만으로는 연결을 설정할 수 없으므로 필요한 필드는 본인의 서비스 제공자에게 확인하세요.
구독과 구성 파일
구성 파일
규칙과 관련 처리 설정을 정리하는 파일로, 주로 연결 항목을 제공하는 구독과는 역할이 다릅니다. 새 파일을 가져온 뒤에는 실제로 어떤 파일이 활성화되어 있는지 확인하고 기존 사용자 지정 규칙이 유지되었는지도 살펴보세요. 수정 전에 원본 파일을 보관해 두면 비교하고 복원하기 쉽습니다.
구독과 구성 파일
Scan QR Code
QR 코드 내용을 인식해 가져오는 메뉴입니다. QR 코드에는 단일 연결 항목이나 그 밖의 지원되는 정보가 들어 있을 수 있습니다. 인식에 성공했다는 것은 내용을 읽었다는 뜻일 뿐이므로 프로토콜과 필드가 완전한지 확인해야 합니다. 인증 매개변수가 포함된 QR 코드는 민감 정보로 취급하고 도움을 요청할 때 공개하지 마세요.
구독과 구성 파일
Import from Cloud JSON
해당 JSON 데이터를 읽어 가져오는 메뉴입니다. 사용 가능 여부는 출처의 내용과 앱에서 지원하는 데이터 구조에 따라 달라집니다. QR 코드 스캔이나 서버 하나를 직접 입력하는 절차와는 다르며, iCloud 동기화와 혼동해서도 안 됩니다. 가져온 뒤에는 실제로 추가된 항목과 필드를 확인하세요.
05 / SYSTEM
시스템과 권한
시스템 권한, DNS 조회, 연결 테스트, 구매 기록은 각각 다른 문제를 해결합니다. 시스템 요구사항은 App Store 페이지에 표시된 내용을 기준으로 하며, 용어만 보고 호환성을 추정하지 마세요.
시스템과 권한
DNS
도메인을 IP 주소 등의 레코드로 변환하는 역할을 하며, 도메인에 접속할 때 중요한 단계입니다. 서버 자체의 도메인과 최종 접속 대상의 도메인 모두 DNS 조회가 필요할 수 있습니다. 접속할 수 없다면 DNS 조회 실패, 반환된 주소의 이상, 주소에 연결한 뒤 발생한 실패를 구분하세요. 모든 문제를 같은 시간 초과로만 판단하지 마세요.
시스템과 권한
VPN 구성
Apple 시스템이 앱 네트워크 터널을 관리하는 데 필요한 구성으로, 첫 연결 시 추가를 허용하라는 메시지가 표시될 수 있습니다. 시스템 권한을 허용해도 원격 인증에 성공했다는 뜻은 아니며, 모든 요청이 프록시를 거친다는 의미도 아닙니다. 실제 경로는 Global Routing과 현재 구성에 따라 달라집니다.
시스템과 권한
Connectivity Test
해당 테스트 대상의 연결 가능 여부를 확인하는 진단 메뉴입니다. 결과는 현재 테스트 방식과 함께 해석해야 합니다. 한 번 테스트에 성공해도 모든 웹사이트에 접속할 수 있다는 뜻은 아니며, 테스트 소요 시간도 지속적인 전송 속도를 나타내지 않습니다. 결과를 비교할 때는 네트워크, 대상, 테스트 조건을 동일하게 유지하세요.
시스템과 권한
iCloud 동기화
iCloud를 통해 기기 간에 해당 데이터를 동기화하는 기능입니다. 구체적인 동기화 범위는 앱에서 현재 제공하는 옵션을 확인하세요. 기기 전체 백업이나 App Store 구매 기록 복원과는 다릅니다. 기기를 바꾼 뒤에도 구성, 연결 항목, 시스템 VPN 권한을 각각 확인해야 합니다.
시스템과 권한
구입 항목
App Store에서 현재 구입 계정의 구매 기록을 확인하고 앱을 다시 받는 메뉴입니다. 앱을 다시 받는 것과 사용자 구성을 복원하는 것은 별개의 절차입니다. 기기 호환성, 유니버설 구입 적용 여부, 가족 공유 지원 여부는 App Store 페이지에 표시된 내용을 기준으로 확인하세요.