주요 화면
Home
연결 상태, Global Routing, Connectivity Test, SERVER 목록을 확인하는 주요 화면입니다. Not Connected는 현재 연결이 설정되지 않았다는 뜻이며, 실패 원인을 단독으로 나타내지는 않습니다. 처음 연결할 때는 시스템 안내에 따라 VPN 구성을 추가하도록 허용해야 합니다. 자세한 단계는 시작하기를 참고하세요.
공식 사용 매뉴얼 · 항목 색인
Shadowrocket 용어집
인터페이스 이름, 프로토콜 매개변수, 규칙 키워드를 용도별로 확인하세요.
영문 이름은 앱 인터페이스나 구성 파일에 표시되는 원문이며, 한국어 설명은 각 항목의 기능과 적용 범위를 안내합니다. 먼저 조정할 항목이 전체 모드인지, 서버 항목인지, 규칙인지 확인해 서로 다른 설정 단계를 혼동하지 않도록 하세요.
인터페이스 및 스위치
연결 메뉴와 라우팅 방식
먼저 설정이 있는 화면을 찾은 다음, 해당 설정이 연결 상태에 영향을 주는지 트래픽 처리 방식에 영향을 주는지 확인하세요. 아래 이름은 앱에 실제로 표시되는 항목을 기준으로 합니다.
전체 라우팅 설정
Global Routing
전체 라우팅 방식을 설정하며 구성, 프록시, 직접 연결을 선택할 수 있습니다. 이에 해당하는 인터페이스 용어는 Config, Proxy, Direct입니다. 특정 웹사이트의 규칙이나 서버 프로토콜 유형과는 다릅니다. 트래픽 라우팅이 예상과 다르면 먼저 이 설정을 확인한 다음 현재 구성 파일과 규칙 순서를 살펴보세요.
세 가지 라우팅 방식
Config / Proxy / Direct
Config는 현재 구성의 규칙에 따라 요청을 처리하고, Proxy는 해당 트래픽을 선택한 프록시로 전달하며, Direct는 직접 연결 방식으로 처리합니다. 시스템 우회 설정과 기타 네트워크 설정이 실제 경로에 영향을 줄 수 있으므로, 이 모드가 모든 시스템 트래픽을 반드시 같은 경로로 보낸다고 볼 수는 없습니다. 자세한 차이는 프록시 모드 안내를 참고하세요.
연결 자동 실행
On Demand
네트워크 유형, Wi-Fi, 도메인 등의 조건에 따라 VPN 연결 동작을 설정합니다. 연결 시점을 제어하는 기능이며, 각 요청의 라우팅을 결정하는 Rule을 대신하지 않습니다. 수동으로 연결을 끈 뒤 다시 연결된다면 활성화된 실행 조건과 현재 네트워크가 해당 조건을 충족하는지 확인하세요.
서버 항목 추가 메뉴
Add Server
기존 서버 정보를 바탕으로 연결 항목을 직접 추가하는 메뉴입니다. 먼저 올바른 프로토콜을 선택한 뒤 주소, 포트, 인증, 전송 매개변수를 하나씩 확인하세요. 필수 항목을 모두 입력했다고 해서 설정이 올바른 것은 아닙니다. 이미 구독을 보유한 경우에는 가져오기 절차를 따르세요. 구독 주소를 서버 주소 입력란에 넣어서는 안 됩니다.
진단 도구
Connectivity Test
현재 테스트 방식으로 서버 항목의 연결 상태를 확인합니다. 테스트 방식에 따라 확인하는 네트워크 단계가 다를 수 있습니다. 응답이 표시되더라도 해당 테스트를 통과했다는 뜻일 뿐, DNS와 규칙, 모든 대상 웹사이트가 정상이라는 의미는 아닙니다. 테스트는 정상이지만 웹페이지가 열리지 않는다면 DNS 응답과 실제 접속 경로를 추가로 확인하세요.
프록시 프로토콜
연결 형식과 매개변수 확인
프로토콜 이름은 통신 방식을 나타낼 뿐 회선 품질을 뜻하지 않습니다. 매개변수를 입력할 때는 보유한 서버 정보를 기준으로 하세요. 프로토콜 이름만으로 전체 설정을 추정할 수는 없습니다.
프록시 프로토콜
Shadowsocks
합의된 암호화 방식과 인증 정보로 프록시 통신을 설정하는 프로토콜입니다. 클라이언트의 주소, 포트, 비밀번호, 암호화 방식은 서버 설정과 일치해야 합니다. 추가 전송 매개변수가 있는 구성이라면 해당 항목도 모두 유지해야 합니다. 암호화 방식을 바꾸는 것은 일반적인 해결 방법이 아닙니다. 임의로 변경하면 양쪽 설정이 일치하지 않을 수 있습니다.
프록시 프로토콜
VMess
인증 정보가 필요하며 다양한 전송 설정과 함께 사용할 수 있는 프록시 프로토콜입니다. 주소와 포트 외에도 UUID, 전송 방식, 보안 전송을 사용하는 경우 관련 항목을 확인하세요. 인증 과정은 기기 시간의 영향을 받을 수 있으므로 문제를 진단할 때 시스템 날짜와 시간을 확인해 볼 수 있지만, 시간 초과만으로 시간 문제라고 단정해서는 안 됩니다.
프록시 프로토콜
VLESS
사용자 인증과 전송 보안을 별도로 처리하는 프록시 프로토콜입니다. 프로토콜 이름만으로 전송 암호화가 설정되었다고 볼 수 없습니다. UUID, 전송 방식, 보안 설정을 함께 확인해야 합니다. VMess 설정에서 프로토콜 이름만 바꿔 그대로 사용할 수 없으므로, 보유한 정보를 바탕으로 각 매개변수를 다시 확인하세요.
프록시 프로토콜
Trojan
일반적으로 TLS와 비밀번호 인증을 함께 사용하는 프록시 프로토콜입니다. 연결 주소, 인증 비밀번호, TLS 검증용 호스트 이름은 각각 역할이 다르므로 서로 대신 사용할 수 없습니다. 인증서나 핸드셰이크 오류가 발생하면 호스트 이름, 인증서 유효성, 시스템 시간을 먼저 확인하세요. 검증을 끄는 방식으로 설정 오류를 감추지 마세요.
프록시 프로토콜
Hysteria2
QUIC 기반 프록시 프로토콜이며 UDP 통신을 사용합니다. 연결에 실패하면 주소, 포트, 인증 정보뿐 아니라 현재 네트워크에서 해당 UDP 통신을 허용하는지와 TLS 매개변수도 확인해야 합니다. 프로토콜을 선택했다고 전송 속도가 보장되는 것은 아닙니다. 실제 성능은 네트워크 경로, 혼잡도, 서버 자원 등에 따라 달라집니다.
터널링 프로토콜
WireGuard
공개 키로 통신 상대를 식별하는 터널링 프로토콜입니다. 설정에는 로컬 개인 키, 피어 공개 키, 주소, 엔드포인트 등이 포함됩니다. 키는 일반적인 표시 이름이 아니며 개인 키가 문제 해결용 스크린샷이나 공개 기록에 노출되지 않도록 주의하세요. 터널 연결과 도메인 이름 확인은 별개의 단계이므로 통신이 설정된 뒤에도 DNS와 라우팅 설정을 확인해야 합니다.
프록시 프로토콜
HTTP / SOCKS5
서로 다른 두 가지 프록시 프로토콜입니다. 주소와 포트 항목을 함께 사용한다고 해서 서로 바꿔 쓸 수 있는 것은 아닙니다. 인증 필요 여부, 특정 트래픽 지원 여부, 전송 암호화 여부는 실제 프로토콜과 서버 설정을 기준으로 확인하세요. HTTP 또는 SOCKS5 프록시라는 이름만으로 전송 암호화가 보장되지는 않습니다.
규칙 키워드
매칭 조건과 처리 정책
규칙을 읽을 때는 먼저 어떤 요청을 매칭하는지, 다음으로 매칭된 뒤 어떻게 처리하는지 확인하세요. 규칙은 일반적으로 위에서 아래 순서로 평가되므로, 구체적인 조건을 범위가 넓은 조건보다 앞에 두는 것이 좋습니다.
규칙 섹션
Rule
구성 파일의 [Rule] 섹션에서 라우팅 규칙을 정의합니다. 일반적인 규칙은 유형, 매칭 내용, 처리 정책으로 구성됩니다. 보통 가장 먼저 매칭된 규칙이 적용되므로 앞쪽의 범위가 넓은 규칙이 뒤쪽의 구체적인 규칙을 가릴 수 있습니다. 수정 후에는 Global Routing이 Config로 설정되어 있고 올바른 파일을 사용 중인지도 확인하세요.
정확한 도메인 매칭
DOMAIN
지정한 전체 도메인을 매칭하며, 특정 호스트 이름만 처리할 때 적합합니다. 예를 들어 DOMAIN,example.com,DIRECT는 해당 도메인의 모든 하위 도메인을 자동으로 포함하지 않습니다. 매칭 항목에는 도메인만 입력하고, 전체 웹 주소의 프로토콜, 경로, 쿼리 매개변수는 포함하지 마세요.
도메인 접미사 매칭
DOMAIN-SUFFIX
지정 도메인과 하위 도메인을 함께 매칭합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 example.com과 그 하위 도메인에 적용됩니다. DOMAIN보다 범위가 넓지만 임의의 문자열을 부분 검색하는 규칙은 아닙니다. 같은 도메인에 예외가 있다면 더 구체적인 규칙을 이 규칙보다 앞에 두세요.
도메인 키워드 매칭
DOMAIN-KEYWORD
도메인에 지정 키워드가 포함되어 있는지 확인하며, 서로 관련 없는 여러 도메인까지 매칭될 수 있습니다. 웹페이지 본문이나 임의 URL 경로가 아니라 도메인을 대상으로 합니다. 특정 웹사이트와 하위 도메인만 대상으로 한다면 의도치 않은 매칭을 줄이기 위해 DOMAIN-SUFFIX를 먼저 고려하세요.
IP 위치 기반 매칭
GEOIP
웹사이트의 언어나 도메인 문자열이 아니라, 대상 IP의 지리 데이터베이스상 위치를 기준으로 매칭합니다. 데이터베이스 정보, 도메인 해석 결과, 콘텐츠 전송 네트워크의 영향으로 매칭 결과가 달라질 수 있습니다. 대상 서비스의 등록 위치와 같은 의미가 아니며, 동일 웹사이트의 모든 요청이 같은 위치로 분류된다는 보장도 없습니다.
주소 범위 매칭
IP-CIDR / IP-CIDR6
CIDR 표기법으로 IPv4와 IPv6 주소 범위를 각각 매칭합니다. 예를 들어 IP-CIDR,192.0.2.0/24,DIRECT와 같이 설정합니다. 슬래시 뒤의 접두사 길이는 네트워크 범위를 지정하며 포트 번호가 아닙니다. 예시 주소는 문서 설명용입니다. 실제 규칙은 대상 주소에 맞게 작성하고 두 주소 계열의 차이도 확인하세요.
기본 규칙
FINAL
앞선 모든 규칙에 매칭되지 않은 요청을 처리하며, 일반적으로 규칙 목록의 마지막에 둡니다. FINAL,DIRECT는 다른 규칙에 매칭되지 않을 때 직접 연결한다는 뜻이지, 모든 요청을 직접 연결하라는 의미는 아닙니다. FINAL을 앞쪽에 두면 뒤의 규칙이 매칭되지 않을 수 있으므로 조건을 확인하기 전에 규칙 순서를 살펴보세요.
규칙 처리 정책
PROXY / DIRECT / REJECT
PROXY는 프록시 정책으로 처리하고, DIRECT는 대상에 직접 연결하며, REJECT는 요청을 거부합니다. 이 대문자 키워드는 규칙의 처리 결과이며 Global Routing의 세 가지 방식을 단순히 바꿔 부르는 말이 아닙니다. PROXY 규칙에 매칭되더라도 후속 연결을 완료하려면 사용할 수 있는 프록시 항목이 있어야 합니다.
구독 및 구성 파일
항목 출처와 파일 구조
서버 항목은 어디에 연결할지를 정하고, 구성 파일은 요청을 어떻게 처리할지 정합니다. 구독 업데이트와 구성 전환은 서로 다른 작업이므로 대체할 수 없습니다.
기존 정보 가져오기
Subscribe
기존 구독 주소를 사용해 서버 항목을 가져오거나 업데이트하는 방식입니다. 가져오기 절차는 구독 및 서버 가져오기를 참고하세요. 업데이트 후 구독 내용이 달라질 수 있으며, 업데이트에 성공해도 모든 항목에 연결할 수 있는 것은 아닙니다. 주소에 접근 인증 정보가 포함될 수 있으므로 문제 해결 시 전체 링크를 공개하지 마세요. 구독은 일반적으로 전체 라우팅 규칙이 담긴 구성 파일과 같지 않습니다.
서버 목록 영역
SERVER
Home에서 서버 항목을 표시하는 영역입니다. 각 항목에는 해당 프로토콜, 주소, 포트, 인증 정보 등의 연결 매개변수가 저장됩니다. 항목 이름은 구분을 위한 레이블일 뿐, 프로토콜이나 실제 위치, 사용 가능 여부를 알려주지는 않습니다. 직접 추가한 항목과 구독으로 생성된 항목은 관리 방식이 다를 수 있으므로 업데이트 전에 변경 사항이 덮어써지는지 확인하세요.
구성 화면과 파일
Config / .conf
Config는 구성 파일 관리 화면을 가리킬 수 있으며, .conf는 일반적인 구성 파일 확장자입니다. 파일에는 General, Rule, Host, URL Rewrite 등의 섹션이 포함될 수 있고, 실제 동작은 각 항목과 활성화 상태에 따라 달라집니다. 파일을 저장하는 것만으로 적용되지는 않습니다. 현재 선택된 구성과 Global Routing을 확인하세요.
일반 설정 섹션
General
[General]은 DNS 설정과 같은 기본 네트워크 동작 및 공통 매개변수를 지정합니다. 요청별 매칭을 처리하는 Rule 섹션과는 역할이 다릅니다. 매개변수가 현재 구성과 네트워크 환경에 적용되는지는 별도로 확인해야 합니다. 수정 전 기존 값을 보존하고, 결과를 비교하고 되돌리기 쉽도록 증상과 관련된 항목만 한 번에 하나씩 조정하세요.
URL 처리 섹션
URL Rewrite
[URL Rewrite]는 표현식으로 URL을 매칭해 재작성이나 리디렉션 등을 수행하며, 프록시 라우팅 규칙을 대신하지 않습니다. 범위가 지나치게 넓으면 관계없는 요청도 변경될 수 있으므로 편집 전에 표현식과 대상 주소를 확인하세요. HTTPS 요청에서 확인하거나 처리할 수 있는 정보의 범위는 연결 조건에 따라 달라집니다. 모든 요청 내용을 자유롭게 수정할 수 있다고 가정하지 마세요.
DNS 및 네트워크
이름 확인, 응답, 전송 보안
도메인 이름 확인, 연결 설정, 실제 데이터 전송은 서로 다른 단계입니다. 테스트 결과는 테스트 방식을 고려해 해석하고, 숫자 하나로 전체 네트워크 상태를 판단하지 마세요.
도메인 이름 확인
DNS
도메인을 IP 주소 등의 레코드로 변환하는 메커니즘으로, 도메인에 접속하기 전에 필요한 단계인 경우가 많습니다. 프록시 서버에 연결되더라도 대상 도메인이 올바르게 확인된다는 뜻은 아닙니다. 웹페이지가 열리지 않지만 Connectivity Test에서 응답이 있다면 이름 확인 실패, 부적절한 응답, 잘못된 라우팅 경로, 대상 서비스 오류를 구분해 확인하세요.
General 설정 항목
dns-server
General에서 DNS 서버를 지정하는 설정 항목입니다. dns-server = system은 시스템의 DNS 서버 설정을 사용한다는 뜻입니다. 실제 이름 확인 경로는 다른 DNS 설정과 네트워크 환경의 영향도 받습니다. 수정 전 기존 값을 기록하고, 수정 후에는 같은 도메인으로 다시 테스트하세요. 관련 없는 매개변수를 여러 개 동시에 바꾸지 마세요.
정적 호스트 매핑
Host
[Host]는 지정한 호스트 이름에 정적 주소를 연결합니다. 예를 들어 localhost = 127.0.0.1처럼 설정할 수 있습니다. 정적 매핑은 원격 서비스의 주소 변경을 자동으로 반영하지 않으므로, 잘못되거나 오래된 항목이 있으면 계속 접속에 실패할 수 있습니다. 전송 설정의 Host 항목과는 다른 설정 단계이므로 이름이 같다는 이유만으로 용도를 판단하지 마세요.
테스트 결과 이해하기
Latency
특정 테스트 방식으로 측정한 응답 시간이며 대역폭, 다운로드 속도, 지속적인 전송 안정성과는 다릅니다. 테스트 대상, 네트워크 유형, 테스트 방식이 다르면 결과를 직접 비교하기 어렵습니다. 문제를 진단할 때는 같은 조건으로 테스트한 뒤 실제 웹페이지 접속과 연결 기록을 함께 살펴보세요. 한 번의 시간 초과만으로 원인을 단정할 수 없습니다.
전송 보안과 호스트 이름
TLS / SNI
TLS는 전송을 보호하고 통신 상대의 신원을 확인합니다. SNI는 핸드셰이크 중 접속하려는 호스트 이름을 전달해 서버가 해당 설정과 인증서를 선택할 수 있도록 합니다. 연결 주소와 인증서 확인에 사용하는 이름은 다를 수 있지만, 기존 서버 설정과 일치해야 합니다. 핸드셰이크 실패 시 이름, 인증서, 시간을 먼저 확인하고, 검증을 건너뛰는 방법을 일반적인 해결책으로 사용하지 마세요.