공식 매뉴얼 · 용어 한눈에 보기

Shadowrocket 용어 및 설정 색인

화면 위치를 기준으로 영어 메뉴 이름을 파악한 뒤 프로토콜, 규칙, 설정을 구분하세요. 앱에 표시되는 영어 표현은 그대로 두었습니다. 각 항목에 바로 이동할 수 있는 앵커가 있어 사용 설명에서 돌아와 확인하기 편리합니다.

용어 32개 분류 5개 화면 용어는 영어 원문 유지

Shadowrocket은 여러 플랫폼에서 사용할 수 있는 규칙 기반 프록시 클라이언트입니다. iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매하며, Mac(Apple 칩 및 Intel) / Windows / Android / Linux 버전은 무료입니다. 클라이언트의 일회성 구매와 회선 요금제는 별개입니다. 아래 가져오기 안내는 사용자가 이미 보유한 구독 또는 서버 정보를 기준으로 합니다. 플랫폼별 다운로드 방법은 전체 플랫폼 앱 다운로드에서 확인하세요.

화면 및 스위치

Global Routing 및 연결 메뉴

화면과 모드, 스위치를 먼저 구분하세요. 같은 이름도 표시되는 위치에 따라 의미가 다를 수 있습니다. 아래에서는 자주 쓰이는 화면 맥락을 기준으로 설명합니다.

전체 라우팅 방식

Global Routing

요청 전체를 어떤 방식으로 처리할지 정하는 설정입니다. 일반적인 선택 항목은 Config, Proxy, Direct입니다. 설정 파일의 규칙에 따라 요청을 나누려면 Config를 선택하고 올바른 설정 파일이 선택되어 있는지 확인하세요. 이 설정을 바꾸면 규칙이 적용되는 전제도 달라지므로, 라우팅 결과를 확인할 때는 서버 매개변수보다 이 항목을 먼저 점검하세요.

화면 이름 / 라우팅 모드

Config

화면 이름으로 표시되는 Config는 설정 파일과 관련 작업을 관리하는 메뉴입니다. Global Routing에 표시되면 설정에 따라 요청을 처리하는 모드를 뜻합니다. 파일을 가져왔다고 해서 그 파일이 현재 사용 중인 것은 아닙니다. 현재 선택된 설정 파일과 Global Routing이 Config인지 함께 확인하세요.

라우팅 모드

Proxy

여기서는 Global Routing의 프록시 모드를 뜻합니다. 요청을 설정 파일의 개별 규칙에 따라 나누는 대신 프록시 경로로 처리합니다. Shadowsocks나 Trojan 같은 프로토콜 이름도 아니며 서버가 반드시 작동한다는 뜻도 아닙니다. 화면의 Proxy와 규칙에 대문자로 표시되는 PROXY를 구분하세요. 앞의 것은 모드이고 뒤의 것은 정책 식별자입니다.

라우팅 모드

Direct

여기서는 Global Routing의 직접 연결 모드를 뜻합니다. 요청은 현재 네트워크의 직접 연결 경로를 이용합니다. 직접 연결도 정상적인 네트워크와 DNS가 필요하며 대상 서비스에 접속할 수 없는 경우가 있습니다. 규칙의 DIRECT와 관련은 있지만 적용 범위가 다릅니다. 모드는 전체 처리 방식을 바꾸고 규칙 정책은 해당 규칙에 매칭된 요청만 처리합니다.

조건에 따라 연결 시작

On Demand

미리 설정한 조건에 따라 연결을 시작합니다. 네트워크 환경에 맞춰 연결 동작을 설정할 때 유용합니다. 이 설정은 ‘언제 연결할지’를 정하고, 규칙 기반 라우팅은 ‘요청을 어떻게 처리할지’를 정하므로 서로 다른 기능입니다. 설정 후 Wi-Fi와 셀룰러 네트워크를 각각 전환해 결과를 확인하세요. 조건을 수정하기 전에는 기존 트리거 방식을 기록해 두세요.

서버 추가 메뉴

Add Server

사용자가 보유한 서버 정보를 추가합니다. 보통 유형을 선택하고 주소, 포트, 인증 매개변수를 입력해야 합니다. 포트나 이름만 보고 프로토콜을 추측하지 말고, 제공된 정보에 맞춰 각 항목을 입력하세요. 저장은 정보가 클라이언트에 기록되었다는 뜻일 뿐, 원격 서비스 연결이 확인되었다는 뜻은 아닙니다. 전체 절차는 사용 설명에서 확인하세요.

주요 조작 화면

Home

서버 항목, 현재 선택된 항목, 연결 스위치 등 주요 정보를 확인하는 화면입니다. 문제를 확인할 때는 먼저 예상한 항목이 선택되어 있는지 확인한 다음 연결 상태를 점검하세요. 다른 항목의 테스트 결과와 혼동하지 않도록 주의해야 합니다. 스위치에 연결됨으로 표시되어도 연결 절차가 해당 상태에 도달했다는 의미일 뿐이며, 실제 접속은 별도로 확인해야 합니다.

프로토콜

프로토콜 유형과 매개변수 범위

프로토콜 유형은 보유한 서버 정보와 일치해야 합니다. 속도, 배터리 소모, 안정성은 전송 방식과 서버 부하, 네트워크 상태에도 좌우되므로 프로토콜 이름만으로 우열을 판단할 수 없습니다.

프록시 프로토콜

Shadowsocks

암호화 방식과 비밀번호 등의 매개변수로 프록시 연결을 설정합니다. 클라이언트와 서버가 서로 호환되는 설정을 사용해야 합니다. 주소와 포트뿐 아니라 암호화 방식도 정확히 일치하는지 확인하세요. 추가 전송 매개변수가 제공된 경우 원래 안내에 따라 입력해야 합니다. 비밀번호만 입력하면 설정이 모두 끝난다고 볼 수 없습니다.

프록시 프로토콜

VMess

사용자 ID 등의 정보로 인증하며 다양한 전송 방식과 함께 사용할 수 있습니다. 인증 항목 외에도 전송 유형, 경로, TLS 설정이 연결에 영향을 줄 수 있고 기기 시간이 크게 어긋나면 인증에 문제가 생길 수 있습니다. 링크를 가져온 뒤에도 주요 매개변수를 확인하세요. 특히 다른 프로토콜의 정보를 VMess로 이름만 바꾸면 안 됩니다.

프록시 프로토콜

VLESS

인증과 전송 보안을 별도로 설계한 프로토콜입니다. 사용자 ID는 인증에 쓰이며 서비스 데이터가 암호화되었다는 의미는 아닙니다. 서버에서 지정한 전송 방식과 보안 계층 설정을 함께 확인하세요. TLS, 서버 이름 등 제공된 관련 매개변수도 유지해야 합니다. 사용자 ID가 같다는 이유만으로 두 설정이 동일하다고 판단할 수 없습니다.

프록시 프로토콜

Trojan

일반적으로 TLS로 연결한 뒤 비밀번호로 인증하므로 비밀번호가 맞는 것만으로는 충분하지 않습니다. 주소와 포트, TLS 검증에 사용할 서버 이름, 인증서 상태 모두 핸드셰이크에 영향을 줄 수 있습니다. 인증서 오류가 발생하면 서버 정보와 기기 시간을 확인하세요. 인증서 검증을 끄는 것은 일반적인 해결 방법이 아닙니다.

QUIC 기반 프로토콜

Hysteria2

QUIC 전송을 기반으로 하며 실제 동작은 UDP 사용 가능 여부, 네트워크 패킷 손실, 대역폭 설정에 따라 달라집니다. 네트워크를 바꾸면 TCP를 사용하는 항목과 결과가 다를 수 있습니다. 대역폭 매개변수는 실제 회선 성능에 맞춰 입력하세요. 과도하게 높게 설정해도 처리량이 늘지 않을 수 있으며, 고속 전송을 계속하면 배터리 소모가 커지는지도 따로 확인해야 합니다.

터널 프로토콜

WireGuard

키 쌍과 가상 네트워크 인터페이스를 사용해 터널을 구성합니다. 설정에는 보통 키, 엔드포인트, 인터페이스 주소, 허용할 라우팅 주소 범위가 포함됩니다. 개인 키는 민감 정보이므로 공개 스크린샷이나 게시물, 문의 내용에 포함하지 마세요. 터널이 연결된 뒤에도 대상에 접속할 수 있는지는 라우팅 범위와 DNS, 원격 네트워크 설정에 따라 달라집니다. 핸드셰이크 상태만으로 판단하지 마세요.

프록시 유형

HTTP

서버 유형에서 HTTP는 HTTP 프록시를 뜻하며 일반 웹사이트만 접속할 수 있다는 의미는 아닙니다. HTTPS 대상에 접속할 때 CONNECT로 터널을 만들 수 있지만, 클라이언트와 프록시 서버 사이에도 TLS가 적용된다는 뜻은 아닙니다. 프록시 연결 암호화 여부는 항목의 실제 보안 설정과 서버 지원 여부를 확인하세요.

범용 프록시 프로토콜

SOCKS5

TCP 연결을 전달하고 클라이언트와 서버가 모두 지원하며 설정에서 허용하는 경우 UDP도 처리할 수 있습니다. SOCKS5 자체는 전송 암호화를 제공하지 않습니다. 사용자 이름과 비밀번호를 입력해도 연결 내용이 암호화되는 것은 아닙니다. 도메인을 어느 쪽에서 해석하는지와 대상 서비스에 UDP가 필요한지도 확인하세요. 이런 차이가 사용 결과에 영향을 줄 수 있습니다.

전송 방식과 항목 의미, 사용 사례를 비교하려면 프로토콜 상세 설명을 참고하세요. 보유한 정보에 프로토콜이 지정되어 있다면 먼저 그대로 설정한 뒤 연결을 확인하세요.

규칙 키워드

매칭 조건과 처리 정책

일반적인 규칙 행은 유형, 매칭 내용, 정책으로 구성됩니다. 보통 목록 순서대로 확인하므로 앞에 있는 범위가 넓은 규칙이 뒤의 구체적인 규칙보다 먼저 적용될 수 있습니다. FINAL은 대개 목록 맨 아래에 둡니다.

정확한 도메인 매칭

DOMAIN

지정한 전체 도메인 하나와 정확히 일치하는 항목을 찾습니다. 예를 들어 DOMAIN,example.com,DIRECT과 같이 설정합니다. 이 규칙은 모든 하위 도메인을 자동으로 포함하지 않으므로 api.example.com은 별도로 고려해야 합니다. 특정 호스트 이름 하나만 처리하려면 범위가 넓은 규칙보다 정확한 매칭을 사용하면 확인하기 쉽습니다.

도메인 접미사 매칭

DOMAIN-SUFFIX

지정한 도메인과 하위 도메인을 매칭합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 example.com과 그 하위 도메인에 적용될 수 있습니다. 임의의 문자열 포함 여부를 검사하는 방식은 아니므로 도메인 계층 경계를 확인해야 합니다. 관련 서비스를 함께 처리할 때는 모두 같은 도메인 체계에 속하는지 먼저 확인하세요.

도메인 문자열 매칭

DOMAIN-KEYWORD

도메인에 지정한 문자열이 포함되어 있는지 확인합니다. 예를 들어 DOMAIN-KEYWORD,example,PROXY와 같이 설정합니다. 같은 문자열이 포함된 다른 도메인도 매칭될 수 있어 예상보다 범위가 넓을 수 있습니다. 특정 서비스를 정확히 지정하려면 먼저 DOMAIN 또는 DOMAIN-SUFFIX를 고려하고, 키워드 매칭이 꼭 필요한지 판단하세요.

대상 IP 지역 매칭

GEOIP

대상 IP가 지리 데이터베이스에서 어느 지역으로 분류되는지에 따라 매칭 여부를 판단합니다. 예를 들어 GEOIP,CN,DIRECT와 같이 설정합니다. 웹페이지 언어나 사이트 브랜드, 사용자의 현재 위치를 기준으로 판단하지 않으며 데이터베이스상 지역이 실제 서버 위치와 다를 수도 있습니다. 도메인이 다른 IP로 해석되면 매칭 결과도 달라질 수 있습니다.

IPv4 네트워크 대역 매칭

IP-CIDR

IPv4 주소와 프리픽스 길이로 네트워크 대역을 지정합니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT와 같이 설정합니다. 슬래시 뒤의 숫자는 네트워크 프리픽스 길이이며 포트 번호가 아닙니다. 숫자가 클수록 일반적으로 매칭 범위가 좁습니다. 로컬 네트워크 규칙을 설정할 때는 실제 네트워크 대역을 확인해 관련 없는 주소까지 포함하지 않도록 하세요.

IPv6 네트워크 대역 매칭

IP-CIDR6

IPv6 주소 범위를 매칭합니다. IP-CIDR6,2001:db8::/32,DIRECT의 주소는 문서용 예시입니다. IPv4 규칙이 IPv6에 자동 적용되지는 않으며 한 도메인에서 두 유형의 주소가 모두 반환될 수 있습니다. 접속 결과가 예상과 다르면 IPv4 설정만 확인하지 말고 두 주소 유형의 실제 라우팅을 각각 점검하세요.

마지막 처리 정책

FINAL

앞선 규칙에 매칭되지 않은 요청의 최종 처리 방식을 지정합니다. 예를 들어 FINAL,PROXY와 같이 설정합니다. 분류되지 않은 요청의 처리 경로를 정하도록 보통 규칙 목록 맨 아래에 둡니다. 요청이 계속 FINAL에만 매칭된다면 서버 문제라고 단정하기 전에 앞선 규칙의 유형과 도메인, 순서를 확인하세요.

규칙 동작

PROXY / DIRECT / REJECT

PROXY는 프록시 처리, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 실제 프록시 출구는 현재 선택된 항목과 설정을 함께 확인해야 합니다. 이 값들은 규칙 정책이지 통신 프로토콜이나 대역폭·연결 상태 테스트 결과가 아닙니다. 규칙에서 사용자 지정 정책 그룹 이름을 참조할 수도 있으므로 사용 전에 설정 파일에 해당 이름이 정의되어 있는지 확인하세요.

구독 및 설정

정보 가져오기와 설정 적용

서버 항목, 구독, 설정 파일은 각각 용도가 다릅니다. 가져오기 성공, 업데이트 성공, 연결 성공은 서로 다른 단계를 나타내므로 알림 하나만으로 판단하지 마세요.

구독 작업

Subscribe

사용자가 보유한 구독 내용을 가져오거나 업데이트하는 기능입니다. 정확한 동작은 메뉴 위치와 정보 유형에 따라 다를 수 있습니다. 업데이트하면 원격 내용을 다시 불러오므로 항목 수와 이름, 매개변수가 바뀔 수 있습니다. 업데이트 전에 직접 수정한 내용이 덮어써지는지 확인하세요. 업데이트 후에는 기존 항목이 계속 선택되어 있다고 가정하지 말고 현재 선택을 다시 확인하세요.

업데이트 가능한 정보 출처

구독

주소를 통해 업데이트 가능한 서버 정보나 설정 내용을 가져옵니다. 링크는 이미 이용 중인 서비스 제공업체에서 받아야 합니다. 주소마다 반환 형식이 다를 수 있으며 서버 구독에 규칙과 DNS 설정이 모두 포함된다고 볼 수는 없습니다. 링크에 포함된 인증 매개변수는 민감 정보입니다. 문제를 확인할 때는 전체 주소를 숨기고 공개 페이지에 게시하지 마세요.

연결 매개변수 모음

서버

클라이언트에서 서버는 보통 연결 가능한 원격 서비스 매개변수 모음을 뜻합니다. 프로토콜과 주소, 포트, 인증 정보 등이 포함됩니다. 항목에 표시되는 이름은 구분을 위한 라벨일 뿐 실제 위치나 속도, 사용 가능 여부를 나타내지 않습니다. 주소가 같아도 프로토콜과 포트, 인증 설정이 다르면 연결 결과가 달라질 수 있습니다.

규칙 및 설정 구성 방식

설정 파일

규칙, DNS 및 기타 관련 설정을 구성합니다. 포함된 내용의 범위는 파일마다 다릅니다. 파일 가져오기, 파일 선택, 설정 적용 여부는 각각 별도로 확인해야 합니다. 외부 설정을 사용하기 전에 주요 내용을 확인하세요. 특히 최종 정책과 원격 리소스, URL Rewrite 항목을 살펴보고 복구할 수 있도록 기존 설정을 따로 저장하세요.

기기 간 데이터 동기화

iCloud 동기화

관련 스위치와 계정 조건이 충족되면 iCloud를 통해 지원되는 데이터를 동기화합니다. 동기화 범위는 앱 설정을 확인하세요. 시스템 권한과 네트워크 상태, 클라우드 서비스 이용 가능 여부에 따라 달라지므로 즉시 완료된다고 가정하지 마세요. App Store 구매 항목과도 다릅니다. 동기화는 앱 데이터를 처리하고 구매 항목은 구매 내역을 처리하므로 기기를 변경할 때 각각 확인해야 합니다.

이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 보유한 정보를 가져오는 방법은 사용 설명에서 확인하세요. 형식이 맞지 않거나 업데이트에 실패하는 등의 문제는 문제 해결을 참고하세요.

연결 및 진단

DNS 조회, 테스트 및 접속 결과

테스트 값은 특정 조건에서 관찰한 결과입니다. 문제를 확인할 때는 한 번에 설정 하나만 바꾸고 네트워크 환경과 현재 항목, 대상 주소를 기록해야 전후 차이를 비교할 수 있습니다.

도메인 조회

DNS

도메인을 IP 주소로 변환해야 다음 연결 단계로 진행할 수 있습니다. DNS 요청 경로와 실제 서비스 요청의 연결 경로는 다를 수 있으며 조회 결과가 IP 기반 규칙의 매칭에도 영향을 줄 수 있습니다. 조회 설정을 변경한 뒤에는 캐시의 영향을 고려하고 ‘DNS 조회가 되는지’와 ‘연결이 되는지’를 각각 확인하세요. 두 문제를 혼동하지 마세요.

연결 테스트 도구

Connectivity Test

현재 테스트 방식으로 항목의 연결 상태를 확인합니다. 결과는 테스트 대상과 네트워크 상태, 사용 매개변수에 따라 달라집니다. 한 번의 테스트 성공이 모든 웹사이트에 접속할 수 있다는 뜻은 아니며 실패 원인도 테스트 방식과 함께 판단해야 합니다. 여러 항목을 비교할 때는 조건을 동일하게 유지한 뒤 실제 대상에 접속해 확인하세요. 한 번 측정한 숫자만으로 결론을 내리지 마세요.

응답 시간 지표

지연 시간

특정 테스트 조건에서 요청과 응답에 걸린 시간을 나타내며 보통 밀리초 단위로 표시됩니다. 테스트 방식마다 포함되는 과정이 다를 수 있으므로 결과를 그대로 비교해서는 안 됩니다. 지연 시간이 낮다고 대역폭이 크거나 다운로드 속도가 빠른 것은 아닙니다. 패킷 손실과 지터, 서버 부하, 실제 서비스 이용 결과도 확인하세요.

요청 URL 처리

URL Rewrite

조건에 따라 요청 URL을 수정하거나 리디렉션하는 기능으로, 요청 주소를 처리하는 방식을 정합니다. 연결 경로를 선택하는 기능은 아닙니다. 규칙 기반 라우팅과는 별개이므로 URL Rewrite를 DOMAIN-SUFFIX 같은 라우팅 규칙 대신 사용할 수 없습니다. 암호화된 요청에서 확인하거나 처리할 수 있는 범위는 관련 설정의 영향을 받습니다. 일반적인 연결 문제를 확인할 때 출처를 모르는 Rewrite 설정을 임의로 켜지 마세요.

용어에서 사용 절차로 이동

처음 사용할 때는 ‘보유한 정보 가져오기 → Global Routing 확인 → 연결 켜기 → 접속 확인’ 순서로 진행하세요. 연결은 되지만 접속 결과가 예상과 다르면 여러 매개변수를 한꺼번에 바꾸지 말고 규칙 매칭과 DNS, 현재 선택된 항목부터 확인하세요.