공식 가이드 · 용어 색인

Shadowrocket 용어 정리

화면 항목, 프로토콜 이름, 규칙 키워드를 확인하세요. 스위치를 찾을 수 없다면 화면 항목부터 살펴보고, 요청이 어떤 경로로 처리되는지 확인하려면 규칙 키워드와 정책부터 살펴보세요.

01 화면

화면 항목 및 스위치

연결이 언제 시작되는지 확인한 다음, 연결 후 트래픽 처리 방식을 살펴보세요.

Global Routing

클라이언트가 처리하는 트래픽을 설정 규칙에 먼저 대조할지, 모두 프록시 또는 직접 연결로 보낼지 정합니다. 트래픽 분기를 확인할 때는 먼저 이 옵션을 확인하세요. Proxy 또는 Direct가 선택된 상태라면 규칙만 수정해서는 Config의 분기 결과를 확인할 수 없습니다.

Config

Global Routing에서 Config는 현재 설정 파일의 규칙에 따라 트래픽 경로를 결정합니다. 화면 이름으로 쓰일 때 Config는 설정 파일을 관리하는 메뉴입니다. 파일이 목록에 있다고 해서 현재 사용 중인 설정이라는 뜻은 아닙니다.

Proxy / Direct

Global Routing에서 선택할 수 있는 두 가지 모드입니다. Proxy는 클라이언트가 처리하는 트래픽을 현재 프록시 서버로 보내고, Direct는 해당 프록시 서버를 거치지 않습니다. Direct는 연결 스위치를 끄거나 목록에서 서버를 삭제하는 것과 다릅니다.

On Demand

설정한 네트워크 조건에 따라 자동으로 연결을 시작합니다. 연결 시점을 정하는 기능이며, 연결 후 요청이 어떤 경로를 거치는지는 결정하지 않습니다. 수동으로 연결을 끊은 뒤 곧바로 다시 연결된다면 현재 네트워크가 On Demand 조건을 충족하는지 확인하세요.

Connectivity Test

현재 네트워크에서 지정한 서버가 테스트 대상에 연결되는지 확인합니다. 표시되는 지연 시간은 이번 테스트에 걸린 시간이지 다운로드 속도가 아닙니다. 테스트에 성공해도 모든 웹사이트에 같은 서버로 접속할 수 있다는 뜻은 아닙니다.

Add Server

서버 정보를 알고 있을 때 연결 항목을 직접 추가하는 기능입니다. 서비스 제공자가 안내한 정보에 따라 프로토콜을 선택한 뒤 필요한 항목을 입력하세요. 주소와 포트가 같더라도 프로토콜별 인증 정보를 서로 바꿔 쓸 수 있는 것은 아닙니다.

02 프로토콜

프록시 프로토콜

프로토콜은 클라이언트와 서버의 통신 방식을 정하며, 어떤 요청을 프록시로 보낼지는 결정하지 않습니다.

Shadowsocks

클라이언트와 서버 사이에서 암호화된 연결로 트래픽을 전달하는 프록시 프로토콜입니다. 서버와 클라이언트의 암호화 방식 및 비밀번호가 서로 일치해야 합니다. 연결 정보를 복사할 때는 목록에 표시된 이름만 보지 말고 주소와 포트도 확인하세요.

VMess

사용자 식별자로 인증하는 프록시 프로토콜이며, 연결에는 양쪽에서 사용하는 전송 설정도 영향을 줍니다. 정보를 확인할 때 사용자 식별자와 전송 관련 항목을 따로 점검하세요. 인증 정보가 맞아도 전송 매개변수가 일치하지 않으면 연결되지 않을 수 있습니다.

VLESS

사용자 식별자로 연결을 구분하는 프록시 프로토콜이며, 프로토콜 자체는 전송 데이터를 암호화하지 않습니다. TLS 같은 보안 계층을 사용하는지는 실제 설정에 따라 달라집니다. VLESS라는 이름만으로 보안 계층이 활성화됐다고 판단할 수는 없습니다.

Trojan

일반적으로 TLS로 연결하고 비밀번호로 인증하는 프록시 프로토콜입니다. TLS 인증서 확인과 비밀번호 인증은 별개의 절차입니다. 인증서 또는 이름이 일치하지 않는다는 안내가 나오면 비밀번호 오류로 단정하지 말고 서비스 제공자가 안내한 서버 이름부터 확인하세요.

Hysteria2

QUIC 기반 프록시 프로토콜로, 전송 계층에서 UDP를 사용합니다. 기기에서 웹페이지가 정상적으로 열리더라도 현재 네트워크가 지정 서버 포트의 UDP 트래픽을 제한할 수 있습니다. 일반 웹페이지가 열린다는 사실만으로 해당 연결을 사용할 수 있다고 단정할 수 없습니다.

WireGuard

공개 키로 상대를 식별하고 UDP로 데이터를 전송하는 네트워크 터널 프로토콜입니다. 상대의 엔드포인트는 연결 대상 위치를 나타내고, AllowedIPs는 해당 상대에 속하는 주소 범위를 지정합니다. 엔드포인트 변경과 주소 범위 수정은 서로 다른 작업입니다.

03 규칙

규칙 키워드 및 정책

규칙을 읽을 때는 먼저 매칭 조건을 확인하고, 일치한 뒤 적용되는 정책을 살펴보세요.

DOMAIN

도메인 전체가 일치하는지 확인합니다. 예를 들어 DOMAIN,example.com,DIRECT는 example.com과 일치하지만 끝부분이 같다는 이유로 www.example.com과 일치하지는 않습니다. 하위 도메인까지 포함하려면 DOMAIN-SUFFIX를 사용하세요.

DOMAIN-SUFFIX

도메인 접미사를 기준으로 일치 여부를 확인하며 접미사 자체와 하위 도메인도 포함합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 example.com 및 www.example.com과 일치하지만 다른 도메인인 myexample.com과는 일치하지 않습니다.

DOMAIN-KEYWORD

도메인 문자열에 지정한 키워드가 포함되어 있는지 확인하며 웹페이지 경로나 내용은 검사하지 않습니다. 키워드가 짧을수록 의도하지 않은 다른 도메인과 일치할 가능성이 커집니다. 특정 사이트 하나만 대상으로 할 때는 전체 도메인이나 명확한 도메인 접미사를 우선 고려하세요.

IP-CIDR / IP-CIDR6

IPv4와 IPv6 대상 주소를 각각 네트워크 대역으로 매칭합니다. 슬래시 뒤의 숫자는 네트워크 프리픽스 길이입니다. 예를 들어 192.168.0.0/16은 192.168로 시작하는 IPv4 주소를 포함합니다. 포트 범위가 아니며 도메인 접미사 매칭에도 사용할 수 없습니다.

GEOIP

대상 IP의 주소 데이터베이스상 위치를 기준으로 분류해 매칭하며, URL의 최상위 도메인으로 판단하지 않습니다. CDN을 사용하는 도메인은 네트워크에 따라 서로 다른 IP로 해석될 수 있으므로 같은 도메인도 매칭 결과가 달라질 수 있습니다.

FINAL

앞선 규칙에 일치하지 않은 나머지 요청에 적용할 정책을 지정합니다. 예를 들어 FINAL,DIRECT는 어떤 규칙에도 일치하지 않은 요청을 직접 연결합니다. 앞선 규칙에 이미 일치한 요청에는 FINAL이 적용되지 않습니다.

PROXY / DIRECT / REJECT

규칙에 지정할 수 있는 세 가지 정책입니다. PROXY는 프록시로 처리하고, DIRECT는 대상에 직접 연결하며, REJECT는 요청을 거부합니다. 규칙 키워드는 조건에 맞는 요청을 찾고, 정책은 일치한 요청을 어떻게 처리할지 정합니다.

04 설정

구독 및 설정 파일

서버 목록 업데이트와 트래픽 분기 설정 변경은 서로 다른 작업입니다.

Subscribe

서비스 제공자로부터 받은 구독 링크를 가져오고, 업데이트할 때 제공자가 반환한 서버 목록을 불러옵니다. 가져오기에 성공했다는 것은 클라이언트가 목록을 읽었다는 뜻일 뿐입니다. 사용할 서버를 선택하고 연결도 테스트해야 합니다.

서버(노드)

연결 목록에서 노드는 보통 선택 가능한 서버 연결 항목을 뜻하며 프로토콜, 주소, 포트와 해당 프로토콜에 필요한 매개변수를 포함합니다. 표시 이름은 항목을 식별하기 위한 메모일 뿐입니다. 이름이 같아도 서로 다른 엔드포인트를 가리킬 수 있습니다.

설정 파일(.conf)

트래픽 분기 규칙과 관련 네트워크 설정을 기술하는 텍스트 파일로, General, Rule, Host 등의 섹션을 포함할 수 있습니다. 트래픽 처리 방식을 정하는 파일이며 서버 연결 항목을 제공하는 구독과는 다릅니다. 수정한 뒤에는 앱에서 어떤 설정을 사용 중인지 확인하세요.

URL Rewrite

설정에서 URL 매칭 조건에 따라 요청을 다시 쓰거나 리디렉션합니다. 요청 주소와 동작을 처리하는 기능으로, DOMAIN-SUFFIX를 사용해 도메인의 프록시 정책을 지정하는 것과는 다릅니다. 문제를 확인할 때 주소가 바뀌는 것과 트래픽 경로가 바뀌는 것을 구분하세요.

05 네트워크

DNS 및 네트워크

DNS 응답을 받는 것, 대상 주소를 확인하는 것, 대상에 연결하는 것은 각각 따로 점검할 수 있는 단계입니다.

DNS

도메인을 IP 주소 등의 레코드로 변환하는 시스템입니다. IP 주소가 조회됐다는 것은 DNS 응답을 받았다는 뜻이지 해당 주소와의 연결까지 성공했다는 뜻은 아닙니다. 문제를 확인할 때는 도메인 해석과 그 이후의 연결을 나눠 점검하세요.

DoH

DNS over HTTPS는 HTTPS를 통해 DNS 해석 서비스로 조회를 전송하는 방식입니다. 클라이언트와 해석 서비스 사이의 조회 전송을 보호하지만, 대상 웹사이트에 접속할 때 사용하는 연결 프로토콜을 대신하지 않으며 요청에 적용될 트래픽 분기 규칙도 결정하지 않습니다.

IPv6

IPv4와 함께 사용되는 IP 주소 체계로, 도메인의 AAAA 레코드는 IPv6 주소를 반환할 수 있습니다. 도메인에 IPv4와 IPv6 주소가 모두 있으면 각 연결의 매칭 결과가 다를 수 있습니다. IP-CIDR만 작성해서는 IPv6 대역을 포함할 수 없습니다.