공식 가이드 · 용어 정리

Shadowrocket
화면·프로토콜·규칙 용어

용어가 어느 단계에 해당하는지 먼저 구분한 다음 설정을 변경하세요. 화면 메뉴는 작업 위치를, 프로토콜은 연결 방식을, 규칙은 요청 경로를 결정합니다. 한 번의 테스트로는 당시 일부 연결 상태만 확인할 수 있습니다.

이 페이지에서는 앱 화면 용어, 프로토콜 이름, 규칙 키워드를 영어 원문으로 표기합니다. 이름이 비슷해도 기능은 다를 수 있습니다. 예를 들어 Global Routing의 Proxy는 전체 라우팅 모드이고, 규칙 끝에 쓰는 PROXY는 현재 설정을 확인해야 의미를 알 수 있습니다. 항목별 설명을 확인한 뒤 시작하기에서 순서대로 따라 하는 방법을 볼 수 있습니다.

화면과 스위치

메뉴, 라우팅 모드, 연결 동작

전체 모드, 서버 항목, 자동 연결 조건 중 무엇을 변경하는지 먼저 확인하세요. 메뉴 위치는 플랫폼마다 다를 수 있으므로 현재 앱 화면을 기준으로 하세요.

Home

Home은 서버 목록을 확인하고 서버를 선택하거나 연결 스위치를 조작하는 화면입니다. 먼저 현재 사용 중인 항목을 확인할 때 유용합니다. 목록에 서버가 있거나 특정 행에 선택 표시가 있어도 연결이 완료된 것은 아닙니다. 연결 스위치와 시스템의 연결 상태를 확인한 뒤 실제로 접속해 보세요.

Global Routing

Global Routing에서 전체 라우팅 방식을 정합니다. 구성, 프록시, 직접 연결은 각각 Config, Proxy, Direct에 해당합니다. Config는 현재 구성에 따라 요청을 처리하고, Proxy는 해당 요청을 선택된 프록시 정책으로 전달하며, Direct는 직접 연결합니다. 규칙이 적용되지 않을 때는 먼저 이 설정이 Config인지 확인한 다음 개별 규칙을 점검하세요.

On Demand

On Demand는 미리 설정한 조건에 따라 연결을 요청하는 기능이며 서버 성능 설정은 아닙니다. 작동 여부는 시스템 권한, 네트워크 상태, 설정된 조건을 함께 고려해야 합니다. 이름만 보고 모든 상황에서 자동 재연결된다고 판단하지 마세요. 수동으로 연결을 끊은 뒤 다시 연결된다면 이 설정부터 확인하세요.

Add Server

Add Server에서 서버 정보를 직접 입력합니다. 일반적으로 유형을 선택한 다음 주소, 포트, 인증 항목을 입력합니다. 원격 서버와 동일한 프로토콜 유형을 선택해야 하며, 속도 테스트를 위해 임의로 다른 유형으로 바꾸면 안 됩니다. 입력을 마친 뒤에는 전송 방식, TLS, 서버 이름 등의 추가 매개변수도 확인하세요.

Settings

Settings에는 앱 동작에 관한 설정이 모여 있으며 개별 서버의 편집 화면과는 다른 단계입니다. 문제를 확인하기 전에 기존 값을 기록하고 한 번에 하나의 옵션만 변경한 뒤 같은 대상으로 다시 테스트하세요. 버전이나 플랫폼에 따라 항목이 다를 수 있으므로 다른 화면의 절차를 그대로 따라 하지 않아도 됩니다.

프로토콜

서버 유형과 전송 조건

서비스 제공자가 안내한 정보를 기준으로 프로토콜 유형을 선택하세요. 프로토콜 이름만으로 연결 품질을 알 수 없으며, 전체 연결 매개변수를 대신할 수도 없습니다.

Shadowsocks

Shadowsocks는 미리 공유한 인증 정보를 사용하는 프록시 프로토콜입니다. 서버 주소, 포트, 암호화 방식, 비밀번호가 일치해야 연결할 수 있습니다. 주소가 정상적으로 확인되더라도 비밀번호나 암호화 방식이 다르면 통신이 실패할 수 있습니다. 가져온 뒤에는 기존 매개변수를 유지하고 서로 다른 서버 항목의 값을 섞지 마세요.

VMess

VMess는 사용자 식별 정보 등의 매개변수로 인증하며, 실제 연결에는 다양한 전송 방식을 사용할 수 있습니다. 서버 유형이 올바르다는 것은 프로토콜 계층을 제대로 선택했다는 뜻일 뿐입니다. 전송 경로, Host, TLS 등의 항목도 각각 일치해야 합니다. 가져온 뒤 연결되지 않으면 사용자 식별 정보만 확인하지 말고 각 항목을 원본 정보와 대조하세요.

VLESS

VLESS는 사용자 식별 정보로 인증하는 경량 프록시 프로토콜입니다. 자체적으로 데이터를 암호화하지 않으므로 전송 보안 설정도 함께 확인해야 합니다. VMess와 유형 및 입력 항목이 다르므로 유형만 바꾼다고 변환이 완료되는 것은 아닙니다. TLS 사용 여부와 전송 방식은 원격 설정에 맞춰 입력하세요.

Trojan

Trojan은 일반적으로 TLS를 통해 연결합니다. 비밀번호는 인증에 사용하며 서버 이름과 인증서 검증은 별도로 확인해야 합니다. 주소에 연결할 수 있어도 TLS 핸드셰이크가 성공하는 것은 아닙니다. 이름이 일치하지 않거나 기기 시간이 잘못된 경우에도 문제가 생길 수 있습니다. 인증서 오류가 발생하면 먼저 원인을 확인하고 검증 기능을 바로 끄지 마세요.

Hysteria2

Hysteria2는 QUIC 기반 프록시 프로토콜로, 현재 네트워크에서 UDP를 사용할 수 있는지 확인해야 합니다. 인증 정보와 TLS 매개변수가 올바르더라도 모든 네트워크에서 동일하게 연결되는 것은 아닙니다. 네트워크를 바꾼 뒤 결과가 달라지면 같은 항목으로 비교 테스트해 네트워크 조건의 영향인지 확인하세요.

WireGuard

WireGuard는 키 쌍을 사용하는 터널 프로토콜입니다. 설정에는 보통 인터페이스 주소, 피어 공개 키, 엔드포인트, 허용 IP 범위가 포함됩니다. 엔드포인트 주소는 피어를 찾는 데 쓰이며, 키와 라우팅 범위도 통신 결과에 영향을 줍니다. 개인 키는 민감 정보이므로 문제 확인 자료를 제출할 때 가리고 공개 예시로 공유하지 마세요.

HTTP

서버 유형에서 HTTP는 HTTP 프록시를 뜻하며, 웹페이지 주소를 서버 입력란에 넣는다는 의미가 아닙니다. 처리 가능한 요청과 사용자 이름 및 비밀번호 필요 여부는 서버 기능과 설정에 따라 달라집니다. 접속 대상이 HTTPS라고 해서 클라이언트와 프록시 서버 사이의 전송도 자동으로 암호화되는 것은 아닙니다.

SOCKS5

SOCKS5는 연결 요청을 전달하는 프록시 프로토콜입니다. 인증 필요 여부와 UDP 사용 가능 여부는 클라이언트와 서버 양쪽에서 확인해야 합니다. 프로토콜 이름만으로 암호화 터널이나 전송 보안이 보장되는 것은 아닙니다. 문제를 확인할 때 인증, 대상 연결, UDP 지원 여부를 각각 점검하세요.

규칙 키워드

일치 조건과 처리 정책

규칙은 일반적으로 위에서 아래로 확인하며, 일치 항목을 찾으면 해당 정책을 적용합니다. 아래 예시는 문법 설명용이며 기존 설정을 그대로 대체할 수 있는 완성된 구성은 아닙니다.

DOMAIN

DOMAIN은 전체 도메인과 일치하는 규칙으로, 특정 호스트 이름 하나에만 적용할 때 적합합니다. 규칙에는 도메인만 입력하고 프로토콜 접두사, 웹 경로, 쿼리 매개변수는 붙이지 마세요. 실제 접속 주소가 다른 하위 도메인이라면 이 규칙과 일치하지 않을 수 있으므로 연결 기록에서 요청된 이름을 확인하세요.

DOMAIN,example.com,DIRECT

DOMAIN-SUFFIX

DOMAIN-SUFFIX는 도메인 접미사를 기준으로 일치 여부를 판단하며, 도메인과 하위 도메인에 적용할 때 자주 사용합니다. 전체 도메인만 지정하는 규칙보다 적용 범위가 넓으므로 추가하기 전에 관련 하위 도메인에도 같은 정책을 적용할지 확인하세요. 규칙이 올바른데도 적용되지 않는다면 앞선 규칙이 먼저 일치했는지도 살펴보세요.

DOMAIN-SUFFIX,example.com,PROXY

DOMAIN-KEYWORD

DOMAIN-KEYWORD는 웹페이지 본문이 아니라 도메인에 포함된 키워드로 일치 여부를 판단합니다. 짧거나 흔한 키워드는 관련 없는 도메인까지 포함할 수 있으므로 적용 범위를 먼저 확인하세요. DOMAIN 또는 DOMAIN-SUFFIX로 정확하게 지정할 수 있다면 대개 확인과 관리가 더 쉽습니다.

DOMAIN-KEYWORD,example,DIRECT

GEOIP

GEOIP는 IP 주소 데이터베이스의 지역 정보를 기준으로 일치 여부를 판단하며, 사용자의 실제 위치를 읽어오는 기능은 아닙니다. 데이터베이스 기록, 대상의 DNS 결과, 서비스 배포 변경 등이 결과에 영향을 줄 수 있습니다. 예상과 다르게 일치한다면 웹사이트 이름만으로 지역을 판단하지 말고 실제 대상 IP를 확인하세요.

GEOIP,CN,DIRECT

IP-CIDR

IP-CIDR은 CIDR 표기법으로 IPv4 주소 대역을 지정합니다. 슬래시 뒤의 숫자는 네트워크 접두사 길이입니다. 접두사 길이가 길수록 일반적으로 적용 범위가 좁아지며, 포트 번호나 우선순위를 뜻하지 않습니다. 이 규칙을 관리할 때는 주소 대역이 정확한지, 대상이 실제로 IPv4를 사용하는지 함께 확인하세요.

IP-CIDR,192.0.2.0/24,DIRECT

IP-CIDR6

IP-CIDR6은 IPv6 주소 대역을 지정하며 IPv4 주소 대역 규칙과 기능은 비슷하지만 주소 형식이 다릅니다. 대상에서 IPv4와 IPv6를 모두 제공한다면 IP-CIDR만 조정해서는 모든 연결에 적용되지 않을 수 있습니다. 듀얼 스택 접속 문제를 확인할 때는 먼저 현재 요청에 사용된 주소 체계를 살펴보세요.

IP-CIDR6,2001:db8::/32,DIRECT

FINAL

FINAL은 앞선 규칙에 일치하는 항목이 없을 때 적용하는 기본 규칙이며, 보통 규칙 목록의 마지막에 둡니다. 구체적인 규칙보다 앞에 두면 뒤에 있는 규칙이 적용되지 않을 수 있습니다. 정책을 바꾸면 앞선 규칙에 포함되지 않은 모든 요청에 영향을 주므로 기본 연결 경로를 먼저 정하세요.

FINAL,DIRECT

PROXY / DIRECT / REJECT

이 세 이름은 규칙 끝에서 자주 사용됩니다. PROXY는 일반적으로 프록시 정책을 참조하고, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. PROXY가 실제로 무엇을 가리키는지는 현재 구성의 정책 정의를 확인해야 하며 이름만 보고 특정 서버라고 단정할 수 없습니다. 대문자 규칙 이름을 Global Routing의 Proxy, Direct 설정과 혼동하지 마세요.

URL Rewrite

URL Rewrite는 일치 조건에 따라 요청 URL을 바꾸는 기능이며 프록시 서버 선택이나 전체 라우팅 변경과는 다릅니다. 규칙 작성 방식과 요청 내용을 확인할 수 있는지에 따라 적용 여부가 달라지며, HTTPS에서는 추가 조건이 필요할 수 있습니다. 일반적인 연결 문제를 확인할 때는 이해하지 못한 URL Rewrite 규칙을 함부로 활성화하지 마세요.

구독과 설정

서버 출처와 구성 파일

서버 목록은 '어디에 연결할지'를, 구성 파일은 '요청을 어떻게 처리할지'를 정합니다. 한쪽을 업데이트해도 다른 쪽까지 함께 바뀌지는 않습니다.

Subscribe

Subscribe는 구독 URL을 통해 서버 항목을 가져오고 업데이트합니다. 구독 링크는 서비스 제공자에게 받으세요. 업데이트 후 항목이 추가, 삭제되거나 매개변수가 바뀔 수 있으며, 직접 수정한 내용이 다음 업데이트에서 덮어써질 수도 있습니다. 링크에 접속 인증 정보가 포함되는 경우가 많으므로 스크린샷이나 로그를 공유하기 전에 전체 주소와 인증 매개변수를 가리세요.

서버

서버 항목에는 원격 연결에 필요한 정보가 저장되며 노드라고도 합니다. 일반적으로 주소, 포트, 프로토콜, 인증 항목이 포함됩니다. 목록에 표시되는 이름은 구분을 위한 라벨일 뿐 지역, 속도, 연결 상태를 보장하지 않습니다. 두 항목이 같은지 확인하려면 이름이 아니라 실제 매개변수를 비교하세요.

Config

Config는 규칙, 정책 및 관련 설정을 저장하는 구성 파일을 뜻할 수도 있고, Global Routing에서 구성에 따라 요청을 처리하는 옵션을 뜻할 수도 있습니다. 파일을 가져온 다음에는 현재 어떤 구성을 사용 중인지 확인하세요. 파일이 존재한다고 해서 선택된 것은 아닙니다. 구성을 전환하기 전에 원본 파일을 보관하면 되돌리거나 규칙 차이를 비교하기 쉽습니다.

iCloud 동기화

iCloud 동기화는 iCloud를 이용해 지원 기기 간에 앱에서 지원하는 데이터를 동기화합니다. 범위는 앱 내 설정을 확인하세요. 구매 내역 복구와는 다른 기능이며 모든 시스템 권한이 자동으로 이전된다고 볼 수도 없습니다. 기기를 바꾼 뒤에는 목록이 표시되는지만 확인하지 말고 서버, 현재 구성, 연결 권한을 각각 점검하세요.

연결과 진단

DNS 확인, 테스트, 실제 접속

실패가 발생한 단계를 나눠서 살펴보세요. 도메인 확인, 테스트 성공, 대상 접속은 서로 연관되어 있지만 같은 결과는 아닙니다.

DNS

DNS는 도메인을 IP 주소로 변환하며, 대부분 연결을 시작하기 전에 필요한 과정입니다. DNS 확인에 성공해도 이후 연결까지 성공하는 것은 아니며, DNS 실패가 반드시 서버 인증 문제를 뜻하는 것도 아닙니다. 확인할 때는 DNS 설정, 확인된 주소, 이후 발생한 오류를 각각 기록하고 관련 옵션을 한꺼번에 바꾸지 마세요.

지연 시간

지연 시간은 특정 테스트에 걸린 시간이며 의미는 테스트 방식에 따라 달라집니다. 지속적인 다운로드 속도로 환산할 수는 없습니다. 서버를 비교할 때는 같은 네트워크와 테스트 방식을 사용하고 비슷한 시간대에 반복해 보세요. 한 번의 시간 초과는 해당 테스트가 완료되지 않았다는 뜻일 뿐이므로 실제 접속 결과도 함께 확인해야 합니다.

Connectivity Test

Connectivity Test는 서버 연결 상태를 확인하는 테스트 메뉴이며, 결과는 선택한 테스트 방식에 따라 해석해야 합니다. 테스트에 성공해도 모든 웹사이트와 요청이 같은 경로를 사용하는 것은 아니며 규칙 설정이 전부 올바르다는 뜻도 아닙니다. '테스트는 정상인데 접속이 안 되는' 경우 DNS, 규칙 일치 여부, 대상 연결 오류를 추가로 확인하세요.

연결 로그

연결 로그에서 요청 시간, 대상, 규칙 일치 결과, 오류 정보를 확인할 수 있습니다. 문제를 재현한 직후 확인하는 것이 좋습니다. 같은 시간대의 기록을 찾아 DNS 확인, 인증, TLS, 대상 응답 시간 초과 등 발생 단계를 구분하세요. 자료를 공유하기 전에 비밀번호, 사용자 식별 정보, 구독 인증 정보, 개인 접속 데이터를 가리세요.

같은 순서로 점검 결과 기록하기

현재 네트워크와 Global Routing 모드를 기록한 다음 선택한 서버, 현재 Config, 실제 요청 대상을 확인하세요. 한 번에 조건 하나만 바꾸고 다시 테스트한 뒤 결과를 남기면 매개변수 수정의 효과와 네트워크 환경의 우연한 변화를 구분할 수 있습니다. VMess와 VLESS의 입력 항목 차이는 VMess와 VLESS의 차이에서 확인하세요.