공식 매뉴얼 · 이름으로 찾아보기

Shadowrocket 용어집

인터페이스 용어, 프로토콜명, 규칙 키워드는 영어 원문을 유지합니다. 먼저 용어가 어느 설정 단계에 속하는지 파악한 다음 연결 모드, 서버 매개변수, 구성 파일 중 무엇을 수정할지 판단하세요.

조작 순서는 빠른 시작에서 확인하고, 전체 규칙 예시가 필요하면 구성 필드를 참고하세요. Shadowrocket을 받으려면 먼저 App Store 다운로드 안내를 확인하세요.

Interface / Switches

인터페이스와 연결 옵션

이 용어는 조작 메뉴나 연결 모드를 가리키며, 서버 프로토콜이나 특정 Rule을 뜻하지 않습니다.

Global Routing: 전체 연결 방식을 선택하는 설정입니다. 일반적인 모드는 Config, Proxy, Direct입니다. 규칙에 따라 트래픽을 분기하려면 먼저 Config가 선택되어 있는지, 그다음 현재 구성 파일이 무엇인지 확인하세요. Rule만 수정하고 Proxy를 유지하면 규칙별로 트래픽이 분기되지 않을 수 있습니다. 문제를 확인할 때는 기존 모드를 기록하고 한 번에 옵션 하나만 변경해 모드 차이를 서버 오류로 오해하지 않도록 하세요.

Config: Config는 구성 파일 관리 메뉴이면서 Global Routing의 모드 옵션에도 표시됩니다. 의미는 표시 위치에 따라 달라집니다. 관리 메뉴에서는 구성 파일을 확인하고 편집하거나 선택할 수 있으며, 연결 모드에서는 현재 구성을 기준으로 요청을 처리합니다. 파일을 가져왔더라도 현재 사용 중인 구성으로 선택된 것은 아닐 수 있으므로 작업 후 선택 상태를 다시 확인하세요.

Proxy: Proxy는 Global Routing의 프록시 모드입니다. 주로 현재 선택한 프록시를 통해 요청을 처리하며, 시스템 트래픽과 우회 설정도 확인해야 합니다. Shadowsocks나 VLESS 같은 프로토콜을 통칭하는 항목이 아니며, 서버를 사용할 수 있다는 뜻도 아닙니다. 규칙의 영향을 확인할 때 이 모드로 잠시 테스트할 수 있지만, 테스트가 끝나면 원래 설정으로 되돌리세요.

Direct: Direct는 Global Routing의 직접 연결 모드입니다. 주로 현재 네트워크를 통해 대상에 직접 접속합니다. 같은 대상에 대한 현재 네트워크의 접속 상태를 비교하는 데 활용할 수 있지만, 직접 연결에 성공했다고 프록시 서버 설정이 올바른 것은 아닙니다. 인터페이스의 Direct와 규칙 텍스트의 DIRECT는 서로 다른 단계의 설정이므로 한쪽을 바꿔도 다른 쪽이 자동으로 바뀌지 않습니다.

On Demand: On Demand는 미리 설정한 네트워크 조건에 따라 시스템에 VPN 연결을 요청합니다. 예를 들어 네트워크 환경별로 연결 조건을 적용할 수 있습니다. 언제 연결할지를 처리하는 기능이지, 특정 도메인에 PROXY와 DIRECT 중 무엇을 사용할지 결정하는 기능은 아닙니다. 활성화한 뒤에는 시스템 VPN 구성과 실행 조건도 확인하세요. 수동으로 연결을 끈 경우에도 현재 조건을 함께 고려해 상태를 판단해야 합니다.

Connectivity Test: 서버 연결 상태를 확인하는 테스트 메뉴입니다. 결과는 테스트 방법, 대상 주소, 현재 네트워크에 따라 달라집니다. 표시된 지연 시간은 특정 테스트에 걸린 시간이며 다운로드 속도를 뜻하지 않고 모든 대상에 접속할 수 있다는 보장도 아닙니다. 결과를 비교할 때는 같은 테스트 방법을 사용하세요. 테스트에 실패하면 주소, 포트, 인증 정보와 실제 요청을 각각 확인해야 합니다.

Protocols

프로토콜

프로토콜은 연결을 설정하는 방식을 결정합니다. Add Server에 정보를 입력할 때는 보유한 서버 정보를 기준으로 하며, 프로토콜명만 보고 인증, 전송 방식, 인증서 매개변수를 추측하지 마세요.

Shadowsocks: Shadowsocks는 지정한 암호화 방식과 인증 정보를 사용해 서버에 연결합니다. 주소, 포트, 비밀번호, 암호화 방식이 서로 일치해야 합니다. 가져온 뒤 연결되지 않으면 비밀번호만 확인하지 말고 각 필드를 하나씩 점검하세요. 보유한 정보에 추가 전송 매개변수가 포함되어 있다면 서버의 실제 설정에 맞춰 입력해야 하며, 비슷해 보이는 옵션으로 임의 대체해서는 안 됩니다.

VMess: VMess는 사용자 ID 등의 매개변수로 인증하며, 서버 정보에 전송 방식과 보안 옵션이 지정되는 경우가 많습니다. UUID가 올바르다고 구성이 완전한 것은 아닙니다. Host, 경로, TLS 설정이 일치하지 않아도 연결에 실패할 수 있습니다. 공유 링크를 가져온 뒤 원본 정보와 필드를 대조하고, 특히 웹페이지 URL의 경로를 전송 경로로 그대로 사용하지 마세요.

VLESS: VLESS는 사용자 ID로 인증하며, 프로토콜 자체는 페이로드를 암호화하지 않습니다. 연결 보안은 함께 사용하는 전송 방식과 보안 설정에 따라 달라집니다. 서버 정보의 전송 유형, TLS 관련 필드와 기타 옵션을 함께 확인해야 하며 UUID만 입력해서는 충분하지 않습니다. 누락된 필드는 보유한 정보를 확인해 채우고, 프로토콜명만으로 기본 조합을 추측하지 마세요.

Trojan: Trojan은 일반적으로 TLS와 비밀번호 인증을 함께 사용해 연결합니다. 서버 주소와 인증서에 해당하는 이름을 각각 입력해야 할 수 있습니다. 연결에 실패하면 비밀번호, 포트, 서버 이름, 기기 시간을 확인하세요. 인증서 검증 문제를 단순히 비밀번호 오류로 취급해서는 안 됩니다. 이름이나 인증서 설정을 먼저 바로잡고, 검증을 끄는 방법을 일반적인 설정으로 사용하지 마세요.

Hysteria2: Hysteria2는 QUIC 기반이며, 일반적으로 UDP를 통해 연결합니다. 인증 정보와 관련 매개변수는 보유한 서버 정보를 기준으로 설정해야 합니다. 프로토콜명에 포함된 숫자는 이름의 일부이며, 이 페이지에서 Shadowrocket 앱 버전을 나타내는 것이 아닙니다. 현재 네트워크의 UDP 처리 방식이 연결 상태에 영향을 줄 수 있으므로 TCP 테스트에 성공해도 해당 연결이 정상적으로 설정된다고 단정할 수 없습니다.

WireGuard: WireGuard는 공개 키로 통신 상대를 식별합니다. 구성에는 일반적으로 로컬 개인 키, 피어 공개 키, Endpoint, 주소, Allowed IPs가 포함됩니다. 일반적인 주소와 비밀번호 방식의 서버 항목처럼 해석해서는 안 되며, 키를 공개된 스크린샷이나 문제 해결 기록에 노출하지 마세요. Allowed IPs는 해당 터널 구성에서 처리할 트래픽 범위와 관련되며, 이것만으로 Shadowrocket의 다른 규칙 실행 결과를 판단할 수는 없습니다.

SOCKS5: SOCKS5는 프록시 요청 프로토콜입니다. TCP 연결을 전달할 수 있으며, 클라이언트와 서버 양쪽에서 지원하는 경우 UDP도 처리할 수 있습니다. 이름만으로 전송이 암호화된다는 뜻은 아니며, 사용자 이름과 비밀번호가 필요한지는 서버 설정에 따라 달라집니다. 항목을 확인할 때 인증 요구 사항과 UDP 지원 여부를 각각 확인하고, HTTP 프록시 필드를 SOCKS5에 그대로 적용하지 마세요.

Rule / Policy

규칙 키워드와 정책

Rule은 조건을 순서대로 확인하고 일치하는 규칙의 정책을 적용합니다. 조건은 ‘무엇과 일치하는가’를, 정책은 ‘어떻게 처리하는가’를 나타냅니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

example.com은 문법 설명을 위한 예시입니다. 구체적인 조건을 앞에 두고 FINAL은 마지막에 배치하세요. 예시에 표시된 PROXY는 사용자가 이미 보유한 사용 가능한 서버와 연결되어 있어야 합니다.

DOMAIN: DOMAIN은 전체 도메인과 일치합니다. 예를 들어 DOMAIN,example.com,DIRECT는 example.com 자체를 대상으로 합니다. www.example.com을 비롯한 모든 하위 도메인이나 웹페이지 경로까지 자동으로 포함하지는 않습니다. 하위 도메인까지 적용하려면 전체 도메인 뒤에 와일드카드를 임의로 붙이지 말고 DOMAIN-SUFFIX를 사용하세요.

DOMAIN-SUFFIX: DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인에 일치합니다. 예를 들어 example.com과 www.example.com이 모두 대상입니다. 조건에는 도메인만 입력하고 https://, 포트, 페이지 경로는 넣지 마세요. 특정 하위 도메인에 다른 정책을 적용하려면 더 구체적인 DOMAIN 규칙을 이 접미사 규칙보다 앞에 배치하세요.

DOMAIN-KEYWORD: DOMAIN-KEYWORD는 도메인에 포함된 문자열을 기준으로 일치시킵니다. 예를 들어 example이라는 키워드는 서로 다른 여러 도메인과 일치할 수 있습니다. 지정한 접미사보다 범위가 넓어 이름은 비슷하지만 용도가 다른 대상까지 포함하기 쉽습니다. 작성 전에 적용 범위를 확인하고, 대상을 정확히 지정할 수 있다면 더 구체적인 조건을 우선 사용하세요.

GEOIP: GEOIP는 IP 지리 위치 데이터베이스를 기준으로 대상 주소를 매칭합니다. 예를 들어 GEOIP,CN,DIRECT와 같이 작성합니다. 결과는 대상 IP가 데이터베이스에 어떻게 등록되어 있는지를 나타낼 뿐, 접속자의 위치나 웹사이트 운영 주체를 뜻하지 않습니다. 도메인 조회 결과와 데이터베이스 내용이 모두 판단에 영향을 주므로 모든 정밀 도메인 규칙을 대신할 수는 없습니다.

IP-CIDR: IP-CIDR은 IPv4 주소 범위에 따라 대상을 매칭합니다. 예를 들어 192.168.0.0/16은 네트워크 범위를 나타내며, 슬래시 뒤 숫자는 포트가 아니라 접두사 길이입니다. IPv6 주소 범위에는 IP-CIDR6을 사용해야 하며 IPv4 예시를 그대로 적용하면 안 됩니다. 도메인 요청에서 대상 주소를 매칭하려면 조회 과정과 규칙 옵션의 영향도 고려하세요.

FINAL: FINAL은 앞선 규칙에 일치하지 않은 요청에 최종 정책을 지정하며, 보통 Rule 섹션의 맨 끝에 둡니다. 도메인이나 주소 조건은 필요하지 않습니다. 예: FINAL,DIRECT. 너무 앞에 배치하면 뒤에 있는 규칙이 일치하지 않은 요청을 처리할 기회가 거의 없어집니다. 규칙 순서를 확인할 때는 먼저 이 행의 위치를 점검하세요.

PROXY: PROXY는 규칙 텍스트에서 사용하는 프록시 정책입니다. 일치한 요청을 프록시로 처리하며, 실제 서버는 현재 선택과 구성에 따라 달라집니다. 프로토콜 유형이 아니며 주소, 포트, 인증 정보도 포함하지 않습니다. 대문자 표기를 유지하고 Global Routing의 인터페이스 용어 Proxy와 구분하세요. 하나는 개별 규칙의 결과이고, 다른 하나는 전체 연결 모드입니다.

DIRECT: DIRECT는 규칙 텍스트에서 사용하는 직접 연결 정책입니다. 일치한 요청을 대상에 직접 연결합니다. 현재 네트워크, DNS, 대상 서비스 상태의 영향을 받으므로 요청이 반드시 성공한다는 뜻은 아닙니다. 로컬 네트워크 주소 범위에 자주 사용하지만, 실제 네트워크 범위에 맞춰 조건을 입력해 지나치게 넓은 주소 범위가 직접 연결로 설정되지 않도록 하세요.

REJECT: REJECT는 거부 정책으로, 일치한 요청에 대해 정상적인 대상 연결을 진행하지 않습니다. Proxy를 대신하는 서버도 아니고 네트워크 오류를 자동으로 해결하는 옵션도 아닙니다. 페이지의 일부 리소스가 로드되지 않으면 관련 도메인이 거부 규칙에 일치하는지 확인한 뒤 조건 범위가 너무 넓거나 규칙 순서가 적절하지 않은지 살펴보세요.

Subscription / Configuration

구독과 구성 파일

서버 목록은 ‘어디에 연결할지’를, 구성 파일은 ‘요청을 어떻게 처리할지’를 정합니다. 한 종류의 자료를 가져왔다고 다른 종류까지 준비된 것은 아닙니다.

SERVER: 서버 항목에는 주소, 포트, 프로토콜, 인증 매개변수 등 연결에 필요한 정보가 기록되며, 구체적인 필드는 프로토콜에 따라 달라집니다. 서버를 사용할 수 있어야 연결할 수 있고, 표시 이름은 구분을 위한 라벨일 뿐입니다. 개별 공유 링크와 구독 모두 서버 항목을 만들 수 있지만 업데이트 방식은 다릅니다. 직접 수정한 경우 구독 업데이트가 변경 내용을 덮어쓰지 않는지도 확인하세요.

구성 파일: 구성 파일은 General, Rule, Host, URL Rewrite 등 다양한 설정을 구성하는 텍스트이며, 각 섹션의 역할은 서로 다릅니다. 서버 구독과 같은 것이 아니며, 파일에 PROXY가 있다고 사용 가능한 서버 정보까지 포함된 것은 아닙니다. 편집 전에 복원할 수 있는 사본을 보관하고, 저장 후 Config에서 현재 파일을 확인하세요. Global Routing에서 Config가 선택되어 있는지도 점검해야 합니다.

General: General은 구성 파일의 일반 설정 섹션입니다. DNS와 우회 동작 관련 필드가 포함되며, 예를 들어 dns-server = system과 같이 작성할 수 있습니다. 각 필드 값은 해당 문법에 맞춰 입력해야 하며 Rule의 쉼표 구분 형식을 여기에 적용하면 안 됩니다. 한 항목을 수정한 뒤 영향을 확인하고 다음 항목을 조정하면 문제를 파악하고 되돌리기 쉽습니다.

Host: Host 섹션에서는 특정 호스트 이름과 주소의 매핑을 설정합니다. 예: localhost = 127.0.0.1. 이름과 주소의 관계를 처리하는 설정이지 PROXY나 DIRECT를 지정하는 규칙은 아닙니다. 고정 매핑은 대상 주소가 바뀌면 작동하지 않을 수 있으므로 특정 도메인에 계속 접속 문제가 발생할 때 오래된 매핑이 있는지도 확인하세요.

URL Rewrite: URL Rewrite는 지정한 패턴에 따라 요청 URL을 처리하며, 연결 정책을 선택하는 Rule과는 역할이 다릅니다. 규칙에는 보통 매칭 패턴, 대상, 처리 방식을 함께 지정해야 하며 정규식의 마침표 같은 문자도 올바르게 이스케이프해야 합니다. HTTPS 요청은 암호화와 관련 설정으로 인해 확인할 수 있는 범위가 제한되므로 Rewrite 규칙 하나만으로 모든 주소를 처리할 수 있다고 가정해서는 안 됩니다.

System / Account

시스템과 계정

앱 구매, 시스템 권한, 네트워크 정보를 구분하세요. 앱을 복원해도 서버 정보가 복원되는 것은 아니며, 시스템에 연결됨으로 표시되어도 대상에 접속할 수 있는지 확인된 것은 아닙니다.

DNS: DNS는 도메인 이름을 IP 주소로 변환합니다. 조회에 실패하면 웹페이지가 열리지 않거나 특정 대상에 접속하지 못할 수 있습니다. DNS와 프록시 서버 인증은 서로 다른 단계이므로 DNS 설정을 바꿔도 잘못된 비밀번호나 사용할 수 없는 서버는 해결되지 않습니다. 문제를 확인할 때 현재 DNS 설정을 기록한 다음 연결 모드와 도메인 규칙을 고려해 DNS 요청이 어떤 경로로 처리되는지 확인하세요.

VPN 구성: 처음 연결을 켤 때 시스템에서 VPN 구성 추가를 허용할지 요청할 수 있습니다. 이 구성은 Shadowrocket의 네트워크 연결을 저장하고 관리하는 데 사용됩니다. 시스템에 표시된 항목은 서버 정보가 아니며 사용 가능한 회선이 준비되었다는 뜻도 아닙니다. 항목을 삭제했다면 앱에서 다시 연결을 시작하고 시스템 권한을 승인한 뒤 서버와 대상 접속을 별도로 확인해야 합니다.

Apple ID: Apple ID는 App Store에서 앱을 구매하고 구매 내역을 확인하는 데 사용되며, 현재 스토어 국가 또는 지역에 따라 앱 표시 여부와 통화가 달라질 수 있습니다. 구매 전에 기기의 iCloud 로그인 상태만 보고 판단하지 말고 App Store에서 사용 중인 계정을 확인하세요. Shadowrocket은 App Store에서만 제공됩니다. 시스템 요구 사항과 기기 호환성은 App Store 페이지의 안내를 기준으로 확인하세요.

구입 항목: 구입 항목은 App Store에서 이전 구매 내역을 확인하고 앱을 다시 받는 메뉴입니다. 이름과 위치는 시스템 인터페이스에 따라 달라질 수 있습니다. 기기를 바꾸거나 앱을 다시 설치할 때는 기존 구매 계정으로 내역을 확인하세요. 앱을 다시 받아도 앱 내 구독과 구성 파일이 자동으로 복원되지는 않습니다. 정품 여부는 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118도 함께 확인하세요.

iCloud 동기화: iCloud 동기화는 클라우드를 통해 기기 간에 앱 데이터를 저장하거나 전달합니다. 구체적인 동기화 범위는 Shadowrocket에 표시되는 옵션을 기준으로 확인하세요. App Store 구매 기록과는 별개의 기능이며, 동기화를 켜도 모든 자료가 백업되었다는 뜻은 아닙니다. 기기를 바꾸기 전에 동기화 상태와 필요한 자료를 복원할 수 있는지 확인하고, 구독 주소와 인증 매개변수는 안전하게 관리하세요.

규칙 및 구성 참고 자료 더 보기 →

용어 분류로 돌아가기 ↑