인터페이스 화면
Home
Home은 서버 항목을 확인하고 연결 대상을 선택하거나 연결 토글을 조작하는 주요 화면입니다. 목록에 항목이 보인다는 것은 정보가 가져와졌다는 뜻일 뿐, 인증이나 연결 테스트가 완료됐다는 뜻은 아닙니다. 처음 사용할 때는 선택한 항목을 확인하고 Global Routing을 점검한 다음 연결을 켜세요.
공식 가이드 · 영어 원문 대조
Shadowrocket 용어집
인터페이스 용어부터 규칙 정책까지 확인하세요. 먼저 용어가 쓰인 위치를 살펴보고, 조작 화면인지 연결 방식인지 요청 처리 결과인지 구분합니다.
인터페이스와 구성
프로토콜 매개변수
규칙과 진단
01 / INTERFACE
인터페이스와 토글
인터페이스 화면과 라우팅 모드는 서로 다른 개념입니다. 영어 용어가 보이면 먼저 어느 화면이나 설정 항목에 속하는지 확인하세요. 실제 표시 위치는 현재 앱 화면을 기준으로 합니다.
수동으로 추가
Add Server
Add Server에서 기존 서버 정보를 입력합니다. 먼저 프로토콜 유형을 선택한 뒤 주소, 포트, 인증 매개변수를 입력하세요. 비밀번호 필드라도 프로토콜마다 의미가 다를 수 있으므로 이름이 비슷하다고 같은 값을 적용하면 안 됩니다. 저장 후 항목을 다시 열어 확인하면 입력 누락으로 인한 문제를 줄일 수 있습니다.
전체 라우팅 동작
Global Routing
Global Routing은 전체 라우팅 모드인 구성(Config), 프록시(Proxy), 직접 연결(Direct)을 결정합니다. Config는 현재 구성의 규칙에 따라 요청을 처리하고, Proxy는 프록시 경로를, Direct는 직접 연결 경로를 사용합니다. 트래픽 분기 문제를 확인할 때는 규칙을 수정하기 전에 이 설정부터 점검하세요.
위치에 따라 의미 구분
Config
구성 관리 화면에서 Config는 구성 파일을 확인하고 가져오거나 선택하는 곳을 뜻합니다. Global Routing에서는 구성 규칙에 따라 트래픽을 처리하는 모드를 뜻합니다. 파일을 가져왔더라도 실제로 선택해 사용 중이라는 뜻은 아닙니다. 규칙이 적용되지 않으면 파일 목록에 이름이 있는지만 보지 말고 현재 파일과 Global Routing을 함께 확인하세요.
라우팅 모드
Proxy / Direct
Proxy와 Direct는 Global Routing에서 전체 처리 방식을 바꾸는 프록시 및 직접 연결 모드입니다. 규칙 텍스트의 대문자 PROXY, DIRECT와 관련은 있지만 적용되는 단계가 다릅니다. 문제를 좁히기 위해 모드를 잠시 바꿔볼 수 있지만, 비교 테스트가 끝나면 필요한 설정으로 되돌려 테스트 상태를 일상 설정으로 착각하지 않도록 하세요.
조건에 따라 연결
On Demand
On Demand는 Wi-Fi나 셀룰러 네트워크 등 조건에 따라 시스템 VPN 연결 동작을 실행합니다. 즉, 언제 연결하거나 연결을 끊을지를 정합니다. 규칙 분기는 연결이 설정된 뒤 요청을 어떻게 처리할지 정합니다. 테스트할 때는 네트워크 조건을 한 번에 하나씩만 바꾸고 실제 연결 상태를 확인해 두 문제를 혼동하지 않도록 하세요.
설정 및 확인
Settings / Data
Settings에서는 설정 항목을 확인하고 조정하며, Data에서는 트래픽 관련 정보를 확인합니다. 표시되는 구체적인 내용은 현재 화면을 기준으로 하세요. 트래픽 수치가 변하면 데이터 활동이 있었다는 뜻이지만, 특정 웹페이지나 서비스에 접속됐다는 증거는 아닙니다. 문제를 확인할 때는 같은 시간대의 통계, 연결 기록, 실제 접속 결과를 함께 비교하세요.
02 / PROTOCOLS
프록시 프로토콜
프로토콜 유형은 기존 서버 설정에 따라 선택하며 속도 등급을 뜻하지 않습니다. 서버 정보와 같은 유형을 선택하고 인증, 전송 방식, TLS 매개변수를 하나씩 확인하세요. 자세한 비교는 프로토콜 기술 참고를 참조하세요.
프록시 프로토콜
Shadowsocks
Shadowsocks는 서버 주소, 포트, 비밀번호, 암호화 방식 등의 매개변수로 프록시 연결을 설정합니다. 암호화 방식은 서버와 일치해야 하며, 연결을 시도한다는 이유로 임의로 바꾸면 안 됩니다. 기존 정보에 플러그인이나 추가 전송 조건이 포함돼 있다면 클라이언트 설정도 서버 요구 사항과 일치하는지 확인하세요.
프록시 프로토콜
VMess
VMess는 ID 등의 매개변수로 인증하며, 일반적으로 전송 방식과 TLS 관련 옵션도 필요합니다. 서버 주소가 같더라도 다른 필드를 생략할 수 있는 것은 아닙니다. 경로와 서버 이름도 연결 과정에 사용될 수 있습니다. 핸드셰이크 오류가 발생하면 주소나 포트만 바꾸지 말고 기존 정보를 항목별로 대조하세요.
프록시 프로토콜
VLESS
VLESS는 인증과 연결 전달을 중심으로 하며, 실제 전송 보안은 사용하는 전송 계층과 TLS 설정에도 좌우됩니다. ID를 입력한 뒤에도 전송 유형, 서버 이름, 기타 필수 필드를 확인해야 합니다. VLESS와 VMess는 서로 다른 유형이므로 인증 필드 모양이 비슷하다고 서로 바꿔 사용할 수는 없습니다.
프록시 프로토콜
Trojan
Trojan은 일반적으로 TLS와 함께 사용하며, 연결하려면 인증 정보와 올바른 서버 이름 및 인증서 검증이 필요합니다. 비밀번호가 맞아도 TLS 핸드셰이크가 실패할 수 있으며, 도메인이나 기기 시간이 잘못된 경우에도 연결에 영향을 줄 수 있습니다. 인증서 오류가 발생하면 이름, 시간, 서버 설정을 확인하세요. 검증을 끄는 것은 일반적인 해결 방법이 아닙니다.
프록시 프로토콜
HTTP / SOCKS5
HTTP와 SOCKS5는 서로 다른 프록시 프로토콜입니다. 인증 방식, 주소 확인 동작, UDP 지원 여부를 서버 기능에 맞춰 확인하세요. HTTP 프록시라고 해서 프록시 서버까지의 전송이 자동으로 암호화되는 것은 아니므로 연결 설정을 별도로 확인해야 합니다. 가져올 때는 해당 유형을 선택하고 주소와 포트만 입력하면 구성이 완성된다고 생각하지 마세요.
터널 프로토콜
WireGuard
WireGuard는 키 쌍으로 통신 상대를 식별하며, 구성에는 보통 인터페이스 주소, 피어 공개 키, 엔드포인트, 라우팅 범위가 포함됩니다. 개인 키와 피어 공개 키는 역할이 다르므로 서로 바꿔 입력하면 안 되며, 공개된 기록에 노출해서도 안 됩니다. 피어와 통신이 된다는 것만 확인하지 말고 라우팅 범위와 DNS가 실제 접속 대상까지 포함하는지도 점검하세요.
QUIC 기반 프로토콜
Hysteria2
Hysteria2는 QUIC 기반이며, 연결 상태는 현재 네트워크의 UDP 연결 가능 여부와 패킷 손실, 서버 설정에 영향을 받습니다. 인증 정보, TLS 설정, 추가 매개변수가 있다면 모두 서버와 일치해야 합니다. 프로토콜 이름만 보고 특정 네트워크에서 더 빠를 것이라고 단정하지 말고, 같은 조건에서 실제 접속과 지속 전송 성능을 확인하세요.
03 / RULES & POLICIES
규칙 키워드와 정책
규칙은 일반적으로 일치 유형, 일치 내용, 정책으로 구성됩니다. 키워드는 무엇을 찾는지, 정책은 어떻게 처리하는지를 나타냅니다. 둘을 같은 필드로 혼동하지 마세요.
도메인 일치
DOMAIN / DOMAIN-SUFFIX
DOMAIN은 지정된 전체 도메인과 일치하고, DOMAIN-SUFFIX는 지정된 도메인과 하위 도메인에 일치합니다. 예를 들어 example.com에 DOMAIN-SUFFIX를 사용하면 www.example.com도 포함되지만, 해당 문자열이 들어간 모든 도메인에 적용되는 것은 아닙니다. 단일 호스트 이름만 처리하려면 더 정확한 DOMAIN을 사용해야 하는지 확인하세요.
텍스트 일치
DOMAIN-KEYWORD
DOMAIN-KEYWORD는 도메인에 지정된 텍스트가 포함돼 있는지 확인하며, 텍스트가 도메인 접미사에 위치할 필요는 없습니다. 짧은 키워드는 의도하지 않은 여러 도메인까지 포함할 수 있습니다. 잘못 일치하는 경우 키워드 범위가 너무 넓은지 먼저 확인하고 DOMAIN 또는 DOMAIN-SUFFIX로 바꾸는 방법을 고려하세요.
주소 범위 일치
IP-CIDR / IP-CIDR6
IP-CIDR은 IPv4 주소 범위를, IP-CIDR6은 IPv6 주소 범위를 나타냅니다. 슬래시 뒤의 접두사 길이에 따라 범위가 결정됩니다. 예를 들어 10.0.0.0/8은 단일 호스트가 아닌 주소 범위를 뜻합니다. 도메인 요청이 주소 규칙에 일치하는지는 DNS 조회 결과와 구성의 주소 확인 방식도 함께 고려해야 합니다.
IP 위치 일치
GEOIP
GEOIP는 IP의 지리적 위치 데이터에 따라 대상 주소를 판별하며, 웹페이지 언어나 도메인 문자열로 지역을 판단하지 않습니다. 결과는 데이터베이스 내용, 조회된 대상 IP, 서비스 배포 방식에 영향을 받습니다. 트래픽 분기 결과가 예상과 다르면 사이트 이름만으로 규칙을 추측하지 말고 실제 대상 IP를 확인하세요.
기본 규칙
FINAL
FINAL은 앞선 규칙이 모두 일치하지 않을 때 최종 정책을 지정하며, 일반적으로 규칙 목록의 마지막에 둡니다. 우선순위가 가장 높다는 표시가 아니며 너무 앞에 두면 뒤의 규칙이 적용되지 않을 수 있습니다. 요청이 기본 경로를 사용하는 이유를 확인하려면 앞선 규칙의 일치 여부를 살펴본 다음 FINAL에 지정된 정책을 확인하세요.
처리 정책
PROXY / DIRECT / REJECT
PROXY는 프록시 정책, DIRECT는 직접 연결, REJECT는 해당 요청 거부를 뜻합니다. 이 키워드는 규칙에서 사용하며 프로토콜 유형이나 서버 이름이 아닙니다. 요청이 규칙에 일치하는지 확인한 다음 정책이 의도한 처리 방식을 지정하는지, 프록시 경로에 사용하는 연결 대상이 작동하는지도 확인하세요.
일치 방식
규칙 순서
규칙은 순서대로 적용되며 먼저 일치하는 규칙이 요청의 정책을 결정합니다. 따라서 세부 예외는 일반적으로 범위가 넓은 규칙보다 앞에 둡니다. FINAL 뒤에 새 규칙을 추가해도 대개 적용되지 않습니다. 순서를 바꾸기 전에 기존 파일을 복사해 두고 한 번에 한 곳만 수정하면 기록을 바탕으로 변경 원인을 확인하기 쉽습니다.
04 / SUBSCRIPTION & CONFIGURATION
구독 및 구성 파일
이 페이지는 사용자가 이미 자신의 구독 또는 서버 정보를 보유하고 있다는 전제에서 설명합니다. 서버 목록, 규칙 파일, 구매 기록은 각각 서로 다른 용도이며, 하나를 가져와도 나머지 내용이 자동으로 채워지지 않습니다.
구독 가져오기
Subscribe
Subscribe는 기존 구독 정보를 가져오거나 업데이트할 때 사용하는 유형 또는 필드입니다. 구체적인 메뉴 위치는 현재 화면을 기준으로 확인하세요. 구독에는 일반적으로 서버 항목이 포함되지만, 실제 내용은 구독 형식에 따라 다르므로 완전한 규칙이 들어 있다고 단정할 수 없습니다. 구독 주소에 접근 자격 정보가 포함될 수 있으므로 전체 주소를 공개 스크린샷이나 문제 해결 기록에 올리지 마세요.
개별 연결 항목
Server
Server는 단일 서버 연결 항목을 뜻하며, 일반적으로 프로토콜, 주소, 포트, 인증 정보로 구성됩니다. 목록에는 SERVER 태그가 표시될 수도 있습니다. 이름은 식별을 돕는 메모일 뿐 실제 위치나 사용 가능 여부를 보장하지 않습니다. 구독으로 생성된 항목을 직접 수정하기 전에 원본 정보를 보관하고, 이후 업데이트가 로컬 변경 사항을 덮어쓸 수 있다는 점에 유의하세요.
구성 파일
.conf
.conf는 구성 파일에 흔히 사용하는 확장자이며, 파일에는 전역 매개변수, 트래픽 분기 규칙, 로컬 매핑, URL 재작성 등의 내용이 포함될 수 있습니다. 서버 항목만 제공하는 구독과는 다른 개념이며, 확장자만으로 파일이 완전한지 판단할 수 없습니다. 가져온 뒤 섹션을 살펴보고 실제 사용할 파일을 선택한 다음 Global Routing이 Config를 사용하는지 확인하세요.
구성 섹션 이름
[General] / [Rule] / [Host]
[General]은 전역 매개변수를, [Rule]은 순서대로 적용하는 트래픽 분기 규칙을, [Host]는 로컬 주소 매핑을 구성합니다. 섹션 이름에 따라 뒤에 오는 행의 해석 방식이 달라지므로 행을 잘못된 섹션에 넣으면 의도한 대로 작동하지 않을 수 있습니다. 편집할 때는 섹션 경계를 먼저 확인하고 필드 문법을 점검하세요. 서버 인증 정보를 규칙 섹션에 임의로 입력하지 마세요.
요청 처리
URL Rewrite
URL Rewrite는 일치 조건에 따라 URL을 재작성하는 등의 처리를 하며, 구성 파일에서는 [URL Rewrite] 섹션을 사용합니다. 요청 처리 방식을 변경하는 기능으로, 요청을 PROXY나 DIRECT에 할당하는 것과는 다릅니다. 암호화된 요청은 관련 처리 조건에 제한을 받을 수 있습니다. 기존 규칙을 활성화하기 전에 필요성, 일치 범위, 개인정보 영향을 확인하세요.
정보 가져오기
Scan QR Code
Scan QR Code는 QR 코드에 담긴 기존 연결 정보를 읽습니다. 스캔에 성공했다는 것은 내용을 인식했다는 뜻일 뿐, 매개변수가 실제로 사용 가능하다는 뜻은 아닙니다. 가져온 뒤 프로토콜, 주소, 인증 필드가 원본 정보와 일치하는지 확인하세요. QR 코드에 민감한 자격 정보가 포함될 수도 있으므로 조작 화면을 공유할 때는 옆의 텍스트뿐 아니라 QR 코드 자체도 가리세요.
05 / CONNECTION & DIAGNOSTICS
연결 및 진단
진단할 때는 시스템 연결, 서버 인증, DNS, 실제 서비스 접속을 나눠서 확인하세요. 한 단계가 정상이어도 다른 단계까지 확인된 것은 아닙니다. 문제 해결 방법은 자주 묻는 질문에서 더 확인할 수 있습니다.
주소 확인
DNS
DNS는 도메인을 주소 등의 레코드로 변환하며, 요청이 대상에 도달하기 전 거치는 중요한 단계입니다. 조회에 성공해도 이후 인증, 연결, 페이지 로딩까지 성공하는 것은 아닙니다. 캐시로 인해 변경 사항이 바로 반영되지 않을 수도 있습니다. 문제를 확인할 때는 먼저 주소를 가져오지 못하는 경우와 주소는 확인됐지만 연결되지 않는 경우를 구분한 뒤 관련 설정을 살펴보세요. 여러 매개변수를 동시에 바꾸지 마세요.
연결 테스트
Connectivity Test
Connectivity Test는 현재 테스트 방식과 대상을 기준으로 연결 가능 여부를 확인하므로 구체적인 설정과 함께 결과를 살펴봐야 합니다. 한 번 테스트에 성공했다고 모든 도메인이나 전송 유형이 정상적으로 작동하는 것은 아닙니다. 서버 항목을 비교할 때는 테스트 방식과 네트워크 조건을 동일하게 유지하고, 실제로 사용할 서비스에도 접속해 보세요.
테스트 지표
지연 시간
지연 시간은 일반적으로 특정 테스트 조건에서 측정한 왕복 소요 시간이며, 대역폭이나 지속 처리량, 웹페이지 로딩 속도와는 다릅니다. 수치가 낮더라도 패킷 손실, 혼잡, 대상 서비스 응답의 영향을 받을 수 있습니다. 결과를 비교할 때는 비슷한 시간대와 동일한 네트워크 및 테스트 방식으로 여러 차례 확인하고, 한 번의 수치만으로 장기적인 성능을 판단하지 마세요.
전송 및 핸드셰이크
TLS / SNI
TLS는 전송을 보호하고 SNI는 핸드셰이크 중 대상 서버 이름을 지정합니다. 서로 관련은 있지만 같은 설정은 아닙니다. 연결 주소와 서버 이름은 서로 다른 역할을 할 수 있으므로 기존 서버 정보에 따라 입력하세요. 주소가 IP라고 해서 서버 이름을 지우면 안 됩니다. 핸드셰이크 오류가 발생하면 다른 전송 매개변수보다 이름, 인증서, 기기 시간을 먼저 확인하세요.
시스템 승인
VPN 구성 승인
VPN 구성 승인은 Apple 시스템이 클라이언트의 VPN 연결을 허용하는 데 필요한 권한입니다. 처음 연결할 때 시스템에서 확인을 요청할 수 있습니다. 승인을 완료해도 서버 비밀번호가 올바르거나 모든 요청이 의도한 정책을 따르는 것은 아닙니다. 연결에 실패하면 시스템 승인 상태, 선택한 서버, 실제 요청 결과를 각각 확인하세요.