공식 설명서 · 용어 참고

Shadowrocket 용어집

인터페이스 위치와 설정 용도에 따라 용어를 확인하고 연결 모드, 프로토콜 매개변수, 규칙 정책을 구분하세요.

이 페이지에서는 인터페이스 용어, 프로토콜 이름, 규칙 키워드를 영어 원문으로 표기합니다. 먼저 용어가 사용된 위치를 확인한 뒤 설명을 살펴보세요. 예를 들어 인터페이스의 Proxy와 규칙의 PROXY는 서로 관련이 있지만 적용되는 수준은 다릅니다.

인터페이스와 스위치

이 분류의 용어는 화면 메뉴, 연결 설정, 테스트 도구에서 볼 수 있습니다. 같은 단어라도 인터페이스에서 모드를 선택하는 경우인지 설정 파일에서 규칙을 편집하는 경우인지 먼저 확인하세요.

인터페이스와 스위치

Global Routing

전체 트래픽 처리 방식을 제어합니다. 주요 모드는 설정, 프록시, 직접 연결이며 인터페이스에서는 각각 Config, Proxy, Direct로 표시됩니다. Config는 설정 규칙에 따라 트래픽을 분기하고, Proxy는 해당 트래픽을 선택한 프록시로 보내며, Direct는 직접 연결합니다. 특정 규칙이 적용되지 않는다면 먼저 여기서 Config가 선택되어 있는지 확인하세요.

인터페이스와 스위치

Config

설정 파일을 관리하는 화면을 뜻할 수도 있고, Global Routing에서 설정 규칙에 따라 트래픽을 처리하는 모드를 뜻할 수도 있습니다. 화면에서는 설정을 확인·가져오기·선택하고, 모드에서는 연결이 해당 규칙에 따라 분기될지 결정합니다. 설정 파일을 가져오기만 해서는 해당 파일이 선택되거나 관련 모드로 전환되지 않습니다.

인터페이스와 스위치

On Demand

설정한 조건에 따라 VPN 연결을 시작하는 On Demand 기능입니다. 실제 동작은 기능 활성화 여부와 관련 조건에 따라 결정됩니다. 서버를 제공하거나 트래픽 분기 규칙을 대신하지 않습니다. 설정을 변경한 뒤에는 실제 사용하는 네트워크 환경에서 연결이 예상대로 시작되는지 확인하세요.

인터페이스와 스위치

Add Server

서버 정보를 추가하는 메뉴입니다. 프로토콜을 선택하고 해당하는 주소, 포트, 인증 매개변수를 입력해야 합니다. 기존 서버 정보는 서비스 제공업체에서 받으며, 링크의 모양만으로 모든 필드를 추측할 수는 없습니다. 항목을 저장해도 매개변수 입력만 끝난 것이므로, 이후 해당 항목을 선택해 연결을 확인해야 합니다.

인터페이스와 스위치

Connectivity Test

연결 가능 여부와 응답 시간을 확인하는 기능으로, Shadowrocket 지연 시간 테스트에 자주 사용됩니다. 측정값은 테스트 방식, 대상, 현재 네트워크에 따라 달라지며 지속적인 전송 속도와는 다릅니다. 결과를 비교할 때는 테스트 조건을 최대한 동일하게 유지하고, 실제로 이용하려는 서비스가 정상 작동하는지도 확인하세요.

프로토콜

프로토콜은 클라이언트와 서버가 통신하는 방식을 결정합니다. 아래 설명은 필드의 의미를 이해하기 위한 것으로, 서로 다른 프로토콜을 바꿔 쓸 수 있다는 뜻은 아닙니다. 입력하기 전에 기존 서버 정보를 기준으로 모든 매개변수를 확인하세요.

프로토콜

Shadowsocks

지정한 암호화 방식과 비밀번호로 프록시 연결을 설정합니다. 서버 주소와 포트는 원격 엔드포인트를 지정합니다. 암호화 방식은 서버 설정과 일치해야 하며 이름이 비슷하다고 서로 바꿔 쓸 수는 없습니다. 인증에 실패하면 원인을 파악하기 어렵지 않도록 매개변수를 하나씩 확인하세요.

프로토콜

VMess

사용자 식별 정보 등의 매개변수로 인증하는 프록시 프로토콜입니다. 일반적으로 전송 방식과 TLS 옵션도 설정합니다. 프로토콜 인증, 전송 설정, 인증서 검증은 서로 다른 계층이므로 사용자 식별 정보를 올바르게 입력했다고 해서 나머지 설정까지 올바른 것은 아닙니다. 서비스 제공업체가 안내한 필드 대응 관계를 유지하세요.

프로토콜

VLESS

사용자 식별 정보로 인증하는 프로토콜입니다. 프로토콜 이름만으로 전체 연결의 보안 특성을 알 수는 없습니다. 실제 연결은 전송 방식, TLS, 서버가 요구하는 다른 매개변수에도 달려 있습니다. 다른 프로토콜 항목의 이름만 바꿔 사용하지 말고 대상 서버의 전체 안내에 따라 다시 확인하세요.

프로토콜

Trojan

일반적으로 TLS로 연결을 보호하고 비밀번호로 인증합니다. 연결 주소, TLS에 필요한 도메인, 인증서 유효성이 연결 결과에 영향을 줄 수 있습니다. 인증서 오류가 발생하면 먼저 도메인, 기기 시간, 서버 인증서를 확인하세요. 검증 기능을 끄는 것을 기본적인 해결 방법으로 삼지 마세요.

프로토콜

HTTP / SOCKS5

서로 다른 두 가지 프록시 프로토콜이며, 일부 서버는 사용자 이름과 비밀번호도 요구합니다. 클라이언트와 프록시 서버 사이의 연결이 보호되는지는 실제 연결 설정에서 확인해야 하며 프로토콜 이름만으로 판단할 수 없습니다. 입력할 때 프록시 엔드포인트와 최종 접속 대상을 구분하고, 웹사이트 주소를 서버 주소로 사용하지 마세요.

프로토콜

WireGuard

공개 키와 개인 키로 암호화 터널을 설정하며, 보통 로컬 키, 피어 공개 키, 엔드포인트, 주소 매개변수가 필요합니다. 각 필드에는 정해진 역할이 있으므로 공개 키와 개인 키를 바꿔 쓸 수 없습니다. 개인 키는 민감한 정보이므로 문제를 확인할 때 전체 설정이나 키가 포함된 스크린샷을 공개하지 마세요.

프로토콜

Hysteria2

QUIC 기반 프록시 프로토콜로, 현재 네트워크에서 UDP 트래픽이 정상적으로 전달되는지가 연결에 영향을 줍니다. 주소와 인증 정보뿐 아니라 TLS 매개변수와 서버 프로토콜 버전도 확인해야 합니다. 다른 프로토콜은 연결되는데 이 프로토콜만 실패한다고 해서 비밀번호 문제로 단정하지 말고 네트워크 상태도 확인하세요.

규칙 키워드와 정책

규칙 앞부분은 일치 조건을 설명하고 끝부분은 처리 정책을 지정합니다. 아래의 example.com과 사설 주소 범위는 문법 설명을 위한 예시입니다. 실제로 사용할 때는 원하는 접속 범위와 규칙 순서를 확인하세요.

규칙 키워드와 정책

DOMAIN

도메인 하나를 정확히 일치시키며 해당 도메인의 모든 하위 도메인으로 자동 확장되지 않습니다. 특정 호스트 이름만 처리하려면 범위가 넓은 일치 조건보다 정확한 규칙이 관리하기 쉽습니다. URL의 프로토콜 접두사와 경로를 제외하고 도메인만 입력하세요.

DOMAIN,example.com,PROXY
규칙 키워드와 정책

DOMAIN-SUFFIX

도메인 접미사를 기준으로 일치시켜 지정한 도메인과 하위 도메인에 적용할 수 있습니다. 예를 들어 example.com과 그 하위 도메인이 일치하지만 임의의 문자 조각을 기준으로 하는 규칙은 아닙니다. 특정 하위 도메인을 예외 처리하려면 더 구체적인 규칙을 앞에 두세요.

DOMAIN-SUFFIX,example.com,PROXY
규칙 키워드와 정책

DOMAIN-KEYWORD

도메인에 지정한 키워드가 포함되어 있는지 확인하며 접미사 일치보다 범위가 훨씬 넓을 수 있습니다. 너무 짧거나 흔한 키워드는 관련 없는 도메인까지 일치시킬 수 있습니다. 사용 전에 대상 목록을 확인하세요. 특정 도메인과 하위 도메인만 필요하다면 더 명확한 일치 조건을 선택하세요.

DOMAIN-KEYWORD,example,PROXY
규칙 키워드와 정책

GEOIP

IP 지리 위치 데이터베이스를 기준으로 대상 주소가 지정된 지역에 속하는지 판단합니다. 이는 데이터베이스가 대상 IP를 분류한 결과일 뿐, 방문자나 웹사이트 운영 주체의 소재지를 뜻하지 않습니다. 도메인 해석 결과나 데이터베이스 내용이 달라지면 최종 일치 여부도 바뀔 수 있습니다.

GEOIP,CN,DIRECT
규칙 키워드와 정책

IP-CIDR / IP-CIDR6

IPv4 및 IPv6 주소 범위를 각각 일치시키며 슬래시 뒤의 숫자는 포트가 아닌 네트워크 프리픽스 길이입니다. 예시의 IPv4 규칙은 사설 주소 범위 하나를, IPv6 규칙은 로컬 루프백 주소를 포함합니다. 주소 범위가 넓을수록 다른 대상에 영향을 주는지 꼼꼼히 확인해야 합니다.

IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,::1/128,DIRECT
규칙 키워드와 정책

FINAL

앞선 규칙에 일치하지 않은 트래픽에 최종 정책을 지정하며 보통 규칙 목록의 마지막에 둡니다. 이미 일치한 결과를 다시 덮어쓰는 규칙이 아니라, 일치 항목이 없을 때 적용되는 기본 처리입니다. 너무 앞에 두면 뒤에 있는 구체적인 규칙이 일치하지 않을 수 있습니다.

FINAL,PROXY
규칙 키워드와 정책

PROXY

일치한 연결을 프록시로 처리하도록 지정하는 규칙 정책 키워드입니다. 사용할 서버는 현재 선택 항목과 설정의 정책 참조를 함께 확인해야 합니다. Global Routing의 Proxy와는 다른 설정입니다. PROXY는 개별 규칙의 결과이고 Proxy는 전체 처리 모드입니다.

규칙 키워드와 정책

DIRECT

일치한 대상 연결을 해당 규칙이 지정한 프록시 서버를 거치지 않고 직접 보냅니다. 연결 성공 여부는 로컬 네트워크, DNS 결과, 대상 서비스 상태에 따라 달라집니다. 규칙의 DIRECT는 일치한 트래픽에만 적용되며 Global Routing을 Direct로 바꾸는 것과는 다릅니다.

규칙 키워드와 정책

REJECT

일치한 연결을 거부하며, 보내지 않아도 되는 요청을 차단하는 데 사용합니다. 일치 범위가 잘못되면 로그인, 인증, 콘텐츠 로드에 필요한 연결까지 차단할 수 있습니다. 이 규칙을 추가하기 전에 기존 설정을 보관하고, 변경 후 관련 기능이 정상 작동하는지 확인하세요.

DOMAIN,example.com,REJECT

설정 파일 섹션

대괄호 안의 이름은 설정 파일 섹션을 표시하며 서로 다른 종류의 내용을 구분합니다. 키워드가 올바르더라도 잘못된 섹션에 규칙을 쓰면 예상대로 작동하지 않습니다. 편집하기 전에 복원할 수 있는 사본을 저장하세요.

설정 파일 섹션

[General]

설정 파일에서 지원하는 일반 옵션을 담는 섹션으로, 요청을 하나씩 일치시키는 규칙 목록과는 용도가 다릅니다. 필드 이름, 값, 구분 방식은 해당 문법을 따라야 합니다. 인터페이스의 임의 스위치 이름을 필드로 그대로 입력하거나 모든 옵션이 현재 설정에 적용된다고 가정하지 마세요.

설정 파일 섹션

[Rule]

트래픽 분기 규칙을 저장하는 섹션입니다. 보통 위에서 아래로 확인하며 먼저 일치한 규칙이 해당 트래픽의 정책을 결정합니다. 구체적인 예외는 넓은 조건보다 앞에 두고 FINAL은 보통 마지막에 배치하세요. 문제를 확인할 때는 각 행의 문법뿐 아니라 앞선 규칙이 이미 일치하는지도 살펴보세요.

[Rule]
DOMAIN,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
설정 파일 섹션

[Host]

정적 도메인 매핑을 정의해 지정한 이름이 설정된 주소를 가리키도록 합니다. 이름 해석 결과에 영향을 주지만 PROXY, DIRECT, REJECT 정책을 직접 지정하지는 않습니다. 대상 서비스의 주소가 바뀌면 기존 매핑 때문에 접속 문제가 생길 수 있으므로 확인되지 않은 고정 주소를 계속 사용하지 마세요.

설정 파일 섹션

[URL Rewrite]

URL 재작성 규칙을 구성하는 섹션으로, 일치하는 URL을 처리하는 것이 목적이며 프록시 서버를 선택하지 않습니다. [Rule]에서 도메인이나 IP를 기준으로 트래픽을 분기하는 규칙과 서로 대체할 수 없습니다. 요청 유형과 관련 설정에 따라 처리 가능 여부가 달라지므로 표현식 하나만으로 모든 트래픽이 재작성된다고 판단하지 마세요.

구독과 계정

구독 콘텐츠, 서버 인증 정보, App Store 구입 기록은 각각 용도가 다릅니다. Shadowrocket은 Apple 플랫폼에서만 제공되며 주로 iPhone과 iPad에서 사용할 수 있습니다. 유일한 다운로드 경로는 App Store이며, 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요.

구독과 계정

구독 / Subscribe

링크를 통해 여러 항목을 가져오고 업데이트하는 관리 방식입니다. 반환되는 내용은 서버 목록일 수도 있고 설정 파일일 수도 있습니다. 구독 링크는 이용 중인 서비스 제공업체에서 받으며, 가져오기 전에 사용할 메뉴와 콘텐츠 유형을 확인하세요. 링크에 접속 정보가 포함될 수 있으므로 문제를 확인할 때 민감한 부분을 가리세요.

구독과 계정

서버 / SERVER

클라이언트가 실제로 연결하는 원격 엔드포인트와 매개변수 기록입니다. 보통 주소, 포트, 프로토콜, 인증 정보가 포함됩니다. 규칙이나 요청의 이동 경로를 결정하는 정책과는 다릅니다. 서버 목록의 이름은 항목을 구별하기 위한 것이며, 이름만으로 프로토콜 매개변수나 연결 상태가 올바르다고 판단할 수 없습니다.

구독과 계정

구입 항목

구입 당시 사용한 Apple 계정에 연결된 App Store 앱 기록으로, 기기를 바꾸거나 다시 설치할 때 Shadowrocket을 찾는 데 사용할 수 있습니다. 앱을 다시 받을 수 있어도 앱 내 서버 매개변수와 설정 파일까지 복원되는 것은 아닙니다. 여러 기기에서의 구매 적용 여부는 App Store 페이지를 기준으로 확인하고, 절차는 구입 항목 복원 안내를 참고하세요.

구독과 계정

일회성 구매

Shadowrocket 앱 자체를 한 번 구매하는 것을 뜻하며, 구체적인 가격은 App Store 페이지에서 확인하세요. 앱의 일회성 구매는 연결 서비스 요금제와 다릅니다. 앱을 구입한 뒤에도 기존 구독이나 서버 정보가 필요합니다. 이 사이트는 공식 설명서를 제공하며 서버나 구독 서비스를 제공·판매·추천하지 않습니다.

문제별로 더 알아보기

용어 설명으로 뜻을 확인하고, 사용 절차와 문제 해결 방법은 해당 안내에서 살펴보세요. 구매할 때는 App Store에서 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 확인할 수 있습니다.