공식 매뉴얼 · 용어 안내
Shadowrocket 용어집
용어가 표시된 위치를 확인한 다음 프로토콜, 일치 조건, 실행 정책을 구분하세요. 영문 명칭은 원문 그대로 표기합니다. 각 항목 제목 옆의 링크를 누르면 해당 위치로 바로 이동할 수 있습니다.
Global Routing
DOMAIN-SUFFIX
FINAL
인터페이스 및 스위치
먼저 용어가 표시된 위치를 확인하세요. Global Routing의 모드, Config 화면, 구성 파일의 정책은 서로 다른 설정 단계입니다.
- Home
- 서버 목록과 현재 선택 항목, 연결 스위치를 확인하는 메인 화면입니다. 목록에 항목이 보인다는 것은 정보가 추가되었다는 뜻일 뿐, 연결에 성공했다는 의미는 아닙니다. 처음 사용할 때는 선택한 서버, Global Routing 모드, 연결 상태를 차례로 확인해 가져오기에 성공한 것을 접속 확인 완료로 착각하지 않도록 하세요.
- Global Routing
- 트래픽을 전반적으로 처리할 방식을 정하는 전체 라우팅 설정입니다. 모드는 Config(구성 파일), Proxy(프록시), Direct(직접 연결) 세 가지입니다. 구성 파일의 트래픽 분기 규칙을 적용하려면 Config를 선택하세요. 문제를 확인할 때는 현재 모드를 먼저 기록해 Proxy 상태에서 규칙을 수정한 뒤 규칙이 저장되지 않았다고 오해하지 않도록 하세요.
- Config
- Global Routing에서 Config는 현재 구성 파일에 따라 트래픽을 처리한다는 뜻입니다. 메뉴의 Config는 구성 파일을 확인하고 선택하는 관리 화면을 가리킵니다. 문서의 의미는 표시 위치에 따라 판단하세요. Config 화면을 여는 것과 라우팅 모드를 Config로 설정하는 것은 서로 관련은 있지만 다른 작업입니다.
- Proxy
- Global Routing의 프록시 모드로, 처리 가능한 트래픽을 선택한 프록시 경로로 보냅니다. 프록시 경로의 작동 여부를 임시로 확인할 때 유용하지만 규칙 순서를 점검하는 작업을 대신하지는 않습니다. 여기서 Proxy는 전체 모드이며, 규칙 끝에 대문자로 표기되는 PROXY 정책과는 적용 단계가 다릅니다.
- Direct
- Global Routing의 직접 연결 모드로, 트래픽을 대상에 직접 연결합니다. 문제를 점검할 때 비교 조건으로 사용할 수 있지만, 직접 연결이 정상이라고 해서 프록시 서버 주소, 인증 정보, 전송 설정까지 올바르다는 뜻은 아닙니다. 비교를 마치면 필요한 모드로 되돌린 뒤 구성 규칙을 확인하세요.
- On Demand
- 앱과 시스템에서 제공하는 조건에 따라 연결 동작을 시작하는 설정입니다. 연결을 언제 시작할지 정하며, 특정 도메인에 PROXY와 DIRECT 중 어떤 정책을 적용할지 정하는 것은 아닙니다. 설정 후 실제 네트워크 조건이 바뀔 때 동작을 확인하세요. 수동으로 연결을 끊은 뒤의 동작도 현재 조건과 함께 살펴봐야 합니다.
- Connectivity Test
- 현재 네트워크와 테스트 방식에서 서버가 응답하는지 확인하는 기능입니다. 결과는 지연 시간이나 실패 상태로 표시될 수 있습니다. 지연 시간은 한 번의 테스트에서 측정한 응답 시간으로, 파일 전송 속도와 같지 않으며 모든 대상에 접속할 수 있음을 보장하지도 않습니다. 문제가 반복되면 테스트 범위, 서버 매개변수, 기기 시간을 확인하세요.
프로토콜
프로토콜은 클라이언트와 서버가 통신하는 방식을 정합니다. 이름, 포트, 지연 시간으로 매개변수를 추측하지 말고 보유한 서버 정보를 기준으로 유형을 선택하세요.
- Shadowsocks
- 프록시 프로토콜의 하나로, 일반적인 설정 항목은 서버 주소, 포트, 비밀번호, 암호화 방식입니다. 암호화 방식은 서버 설정과 일치해야 하며 이름이 비슷하다는 이유로 임의로 바꿔서는 안 됩니다. 자료에 플러그인이나 추가 옵션이 있으면 하나씩 확인하세요. 주소와 비밀번호만 입력했다고 설정이 완성된 것은 아닙니다.
- VMess
- 프록시 프로토콜의 하나로, 사용자 ID, 서버 주소, 포트 등이 필요합니다. 실제 연결에는 전송 방식, 경로, Host, TLS 등의 설정이 필요할 수 있으므로 보유한 서버 정보를 기준으로 확인하세요. 가져온 뒤 해당 항목이 제대로 유지되었는지 확인할 수 있지만, 공개 예시 값을 자신의 구성에 덮어쓰지 마세요.
- VLESS
- 프록시 프로토콜의 하나입니다. 이름이 VMess와 비슷하지만 서로 바꿔 선택할 수 있는 동일한 유형은 아닙니다. 서버 정보를 기준으로 인증 정보, 전송 방식, 보안 설정을 확인하고 주소와 포트만 복사하지 마세요. 특정 전송 옵션의 사용 가능 여부는 현재 앱에서 제공하는 설정을 확인해야 합니다.
- Trojan
- TLS를 사용하는 프록시 프로토콜입니다. 주소, 포트, 비밀번호뿐 아니라 인증서 검증에 쓰이는 호스트 이름도 확인하세요. 연결 주소와 인증서 호스트 이름은 서로 다른 역할을 할 수 있으므로 두 값이 다르다는 이유만으로 임의로 일치시키면 안 됩니다. 인증서 오류가 발생하면 호스트 이름, 인증서 유효성, 기기 시간을 먼저 확인하세요.
- Hysteria2
- QUIC 기반 프록시 프로토콜로, 현재 네트워크에서 UDP를 실제로 지원하는지에 따라 연결이 달라질 수 있습니다. 주소와 인증 정보를 올바르게 입력해도 네트워크 환경 때문에 시간 초과가 발생할 수 있습니다. 문제를 점검할 때 현재 네트워크, 서버 상태, 프로토콜 매개변수를 각각 확인하고 한 번의 시간 초과를 곧바로 비밀번호 오류로 단정하지 마세요.
- WireGuard
- 키 기반 터널 프로토콜입니다. 로컬 키, 피어 공개 키, 피어 주소, 터널 주소 등이 필요합니다. 각 항목은 역할이 다르므로 서버 주소만으로 전체 설정을 복원할 수 없습니다. 개인 키는 민감한 정보입니다. 화면을 공유하거나 문제 해결 자료를 제출하기 전에 가리고, 공개 구성 예시에 포함하지 마세요.
- HTTP / SOCKS5
- 서로 다른 두 프록시 프로토콜이므로 서버에서 제공한 유형을 선택해야 합니다. 포트가 같아도 같은 프로토콜은 아닙니다. 사용자 이름과 비밀번호 필요 여부, 지원하는 트래픽 유형도 각각 확인하세요. HTTP 프록시라는 이름만으로 클라이언트와 프록시 서버 사이의 통신이 TLS로 암호화된다고 볼 수는 없습니다.
규칙 키워드 및 정책
규칙은 일반적으로 일치 유형, 일치 조건, 정책으로 구성됩니다. 먼저 규칙이 일치하는지 확인하고 그다음 일치한 트래픽을 어떻게 처리하는지 살펴보세요. 프로토콜 이름을 규칙 유형과 혼동하지 마세요.
규칙 읽기 예시
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
첫 번째 줄은 지정된 도메인 접미사와 일치시키고, 두 번째 줄은 IPv4 사설 네트워크 대역과 일치시킵니다. 마지막 줄은 앞선 규칙에 일치하지 않은 트래픽을 처리합니다. 문법 예시일 뿐 모든 기기에 적용할 수 있는 완성된 구성은 아닙니다.
- [Rule]
- 구성 파일에서 트래픽 분기 규칙을 지정하는 섹션입니다. 대괄호는 섹션 이름을 나타내며 도메인 일치 조건이 아닙니다. 규칙은 보통 위에서 아래로 확인하고, 일치하면 해당 규칙의 정책을 적용합니다. 따라서 구체적인 규칙은 이를 덮어쓸 수 있는 포괄적인 규칙보다 앞에 두세요. 규칙을 적용하려면 Global Routing에서 Config 모드를 사용하고 해당 구성 파일을 선택해야 합니다.
- DOMAIN
- 전체 도메인과 일치시키는 규칙 유형입니다. 예:
DOMAIN,example.com,PROXY. 지정한 도메인에만 적용되며 모든 하위 도메인이 자동으로 포함되지는 않습니다.www.example.com같은 하위 도메인까지 포함하려면 필요한 전체 도메인 규칙을 추가하거나 DOMAIN-SUFFIX를 사용하세요.
- DOMAIN-SUFFIX
- 도메인 접미사와 일치시키는 규칙 유형입니다.
DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인과 그 하위 도메인을 포함할 수 있습니다. 전체 웹 주소나 프로토콜 접두사, 페이지 경로가 아니라 도메인을 입력하세요. 도메인 경계를 기준으로 일치시키므로 임의의 위치에 있는 문자열을 찾는 방식과는 다릅니다.
- DOMAIN-KEYWORD
- 도메인에 포함된 키워드로 일치시키는 규칙입니다. 예:
DOMAIN-KEYWORD,example,PROXY. 키워드가 짧을수록 관련 없는 도메인까지 포함될 수 있으므로 단순히 입력이 간편하다는 이유로 정확한 규칙을 대체하지 마세요. 원치 않는 트래픽 분기가 발생하면 키워드의 적용 범위와 규칙 목록에서 너무 앞에 배치되었는지 확인하세요.
- GEOIP
- IP 지리 위치 데이터베이스를 기준으로 일치시키는 규칙입니다. 예:
GEOIP,CN,DIRECT. 판단 기준은 주소의 위치 정보이며 웹페이지 언어, 운영자 이름, 도메인 접미사가 아닙니다. 대상이 분산형 서비스를 사용하는 경우 확인된 IP 주소와 데이터베이스 기록이 모두 결과에 영향을 줄 수 있으므로 연결 기록도 함께 확인하세요.
- IP-CIDR / IP-CIDR6
- 각각 IPv4와 IPv6 네트워크 대역을 일치시킵니다. 슬래시 뒤 숫자는 접두사 길이이며 포트 번호가 아닙니다. 예를 들어
192.168.0.0/16은 단일 서버가 아니라 네트워크 대역입니다. IPv4 대역만 설정하면 IPv6 대상은 포함되지 않으므로 문제를 점검할 때 실제 연결에 사용된 주소 유형을 확인하세요.
- FINAL
- 앞선 규칙과 일치하지 않은 트래픽에 적용하는 기본 규칙이며, 보통 규칙 목록의 마지막에 둡니다.
FINAL,PROXY는 나머지 트래픽을 프록시 경로로 보내라는 뜻이지, 프록시 연결에 실패하면 자동으로 직접 연결하라는 뜻이 아닙니다. FINAL을 너무 앞에 두면 뒤에 있는 규칙을 확인하지 않을 수 있습니다.
- PROXY
- 규칙의 프록시 정책으로, 일치한 트래픽을 프록시 경로로 처리합니다. 처리 방향만 지정하며 서버 주소, 비밀번호, 프로토콜 매개변수를 대신 입력하지는 않습니다. 대문자 PROXY는 규칙 정책이며, 첫 글자만 대문자인 Proxy는 Global Routing의 전체 프록시 모드를 가리킬 수 있습니다.
- DIRECT
- 규칙의 직접 연결 정책으로, 일치한 트래픽을 해당 프록시 서버를 거치지 않고 대상에 직접 연결합니다. 대상에 반드시 접속할 수 있다는 뜻은 아닙니다. 결과는 현재 네트워크, DNS, 대상 서비스 상태에 따라 달라집니다. 특정 로컬 주소를 직접 연결하려면 먼저 올바른 네트워크 대역을 확인하고 구체적인 규칙을 적절한 위치에 두세요.
- REJECT
- 일치한 요청을 차단하는 규칙 정책입니다. 프록시를 사용할 수 없을 때 문제를 해결하는 옵션이 아니며, 잘못 사용하면 정상적으로 접속할 수 있는 대상도 차단됩니다. 특정 앱에서 일부 콘텐츠가 표시되지 않으면 적용 범위가 너무 넓거나 목록 앞쪽에 배치된 REJECT 규칙이 관련 도메인과 일치하는지 확인하세요.
구독 및 구성 파일
서버 목록은 어디에 연결할지를 정하고, 구성 파일은 트래픽을 어떻게 처리할지를 정합니다. 두 항목은 서로 관련될 수 있지만 하나를 업데이트해도 다른 하나까지 갱신되는 것은 아닙니다.
- Subscribe
- 구독 가져오기 및 업데이트와 관련된 용어입니다. 사용자가 보유한 구독 주소에서 서버 항목을 불러옵니다. 구독을 업데이트하면 항목 수, 이름, 매개변수가 바뀔 수 있지만 규칙 구성 파일이 업데이트되는 것은 아닙니다. 구독 주소에는 계정 인증 정보가 포함될 수 있으므로 공개하지 마세요. 업데이트에 실패하면 주소 전체가 정확한지, 현재 유효한지 먼저 확인하세요.
- Server / Add Server
- Server는 서버 설정 항목을 뜻합니다. 일상적으로 서버 항목을 노드라고 부르기도 합니다. Add Server는 서버를 추가하는 메뉴입니다. 서버 이름은 구분을 위한 표시일 뿐이며, 실제 연결에는 프로토콜, 주소, 포트, 인증 정보 등이 영향을 줍니다. 수동으로 추가할 때는 보유한 서버 정보를 기준으로 입력하세요. 저장 후에도 테스트를 거쳐 실제 접속 여부를 확인해야 합니다.
- Configuration File
- 일반 설정, 트래픽 분기 규칙, 호스트 매핑, URL 재작성 내용을 섹션별로 정리하는 파일입니다. 흔히 쓰이는 섹션 이름은 [General], [Rule], [Host], [URL Rewrite]입니다. 서버 목록과는 별개의 데이터입니다. 편집하기 전에 원본을 보관하고, 수정 후 현재 선택된 파일인지 확인해 사용하지 않는 복사본만 편집하는 일이 없도록 하세요.
- [Host]
- 특정 도메인의 이름 해석 결과를 지정할 수 있는 구성 파일 섹션입니다. 수동 매핑으로 인해 도메인이 오래된 주소를 계속 사용할 수 있으므로 도메인 접속 문제를 점검할 때 DNS 서버만 확인해서는 안 됩니다. 다른 환경의 매핑을 통째로 복사하지 마세요. 꼭 필요한 경우 용도와 원복 방법을 기록해 두세요.
- [URL Rewrite]
- URL 재작성 규칙을 구성하는 파일 섹션으로, 조건에 맞는 요청 주소를 규칙에 따라 변경하거나 처리합니다. [Rule]에서 PROXY, DIRECT, REJECT를 선택하는 트래픽 분기 방식과는 다르므로 서로 대체할 수 없습니다. 암호화된 요청에서 확인할 수 있는 범위는 연결 방식과 관련 설정의 영향을 받으므로 어떤 주소든 직접 재작성할 수 있다고 가정하지 마세요.
시스템 및 설치
도메인 이름 해석, 시스템 권한, 앱 설치를 각각 구분하세요. 시스템에 터널이 연결되었다고 표시되어도 모든 서버와 대상 서비스의 사용 가능 여부가 확인된 것은 아닙니다.
- DNS
- 도메인 이름 시스템은
example.com같은 도메인을 IP 주소로 변환합니다. 이름 해석 실패와 프록시 서버 연결 실패는 서로 다른 문제이므로 따로 확인해야 합니다. 구성의dns-server = system은 시스템 DNS를 사용한다는 뜻입니다. DNS를 변경한 뒤에는 캐시와 [Host] 매핑의 영향도 살펴보세요.
- VPN Configuration
- 네트워크 터널을 설정하기 위해 시스템에서 요청하는 권한입니다. 처음 연결할 때 시스템 안내에서 허용해야 할 수 있습니다. 구성 추가를 허용했다는 것은 앱에 필요한 권한을 부여했다는 뜻일 뿐, 원격 서버 인증에 성공했다는 뜻은 아닙니다. 권한을 허용한 뒤에도 접속할 수 없다면 서버 매개변수, Global Routing 모드, 연결 기록을 차례로 확인하세요.
- Purchased
- App Store의 구입 항목에서 원래 계정으로 구매한 앱을 찾아 스토어 규정에 따라 다시 다운로드할 수 있습니다. iPhone / iPad를 바꾸거나 앱을 다시 설치할 때는 원래 구매 계정을 사용 중인지, 앱을 계속 다운로드할 수 있는지 확인하세요. 목록에서 찾을 수 없다면 다시 구매해야 한다고 단정하기 전에 구입 기록과 계정 국가 또는 지역을 확인하세요.