Home
Home에서는 저장된 서버와 구독을 확인하고, 연결 대상을 선택한 뒤 연결 스위치를 조작할 수 있습니다. 목록에 항목이 보인다는 것은 정보가 저장되었다는 뜻일 뿐, 인증에 성공했거나 터널이 연결되었다는 뜻은 아닙니다. 문제를 확인할 때는 먼저 현재 선택된 항목을 확인하고 연결 상태를 살펴보세요. ‘가져옴’을 ‘연결됨’으로 간주하지 않도록 주의하세요.
화면과 설정
화면 위치와 Global Routing부터 확인
같은 영문 용어가 화면, 모드, 규칙에 각각 나타날 수 있습니다. 먼저 어디에 표시된 용어인지 확인한 다음 현재 요청에 영향을 주는지 판단하세요.
Global Routing
Global Routing은 전체 트래픽 처리 방식을 정하며, 모드는 Config, Proxy, Direct 세 가지입니다. Config는 현재 구성 규칙에 따라 처리하고, Proxy는 프록시 경로를, Direct는 직접 연결 경로를 사용합니다. 특정 규칙이 적용되지 않는 이유를 살펴보기 전에 현재 Config 모드인지 먼저 확인하세요.
Config
Config는 화면에서 구성 관리 페이지를 뜻할 수 있고, Global Routing에서는 구성 규칙에 따라 트래픽을 처리하는 모드를 뜻합니다. Config 페이지에서 파일을 확인하는 것이 그 파일을 선택했다는 뜻은 아니며, 전체 라우팅이 Config 모드로 전환되었다는 뜻도 아닙니다. 확인할 때는 ‘현재 파일’과 ‘현재 모드’를 별개의 항목으로 살펴보세요.
Proxy
Proxy는 Global Routing에서 프록시 경로를 사용하는 모드입니다. 프록시 경로에서 요청이 어떻게 처리되는지 비교할 때 사용할 수 있습니다. 규칙 파일에 있는 도메인 규칙의 이름이 아니며, 서버 설정이 올바르다는 뜻도 아닙니다. 모드를 바꾼 결과는 문제 범위를 좁히는 데만 활용하세요. 테스트가 끝나면 필요한 원래 모드로 되돌리세요.
Direct
Direct는 Global Routing에서 직접 연결 경로를 사용하는 모드로, 현재 구성에 따른 처리 결과와 비교할 때 유용합니다. 직접 연결도 로컬 네트워크, 도메인 확인, 대상 서비스 상태에 영향을 받으므로 모든 네트워크 설정을 건너뛰는 것은 아닙니다. 직접 연결과 프록시 결과가 다르면 스위치만 반복해서 바꾸지 말고 DNS, 대상 주소, 규칙을 계속 확인하세요.
On Demand
On Demand는 설정된 조건에 따라 연결을 시작하는 기능으로, 핵심은 ‘언제 연결할지’입니다. ‘특정 도메인에 어떤 경로를 사용할지’를 정하는 기능은 아닙니다. 경로는 Global Routing과 현재 규칙에 따라 결정됩니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 서버 정보를 바로 삭제하지 말고 On Demand의 실행 조건과 시스템 VPN 설정을 확인하세요.
프로토콜
프로토콜 이름만으로는 연결 설정 전체를 알 수 없습니다
다음 내용은 기술 개념을 설명합니다. 실제 설정에는 사용자가 보유한 서버 정보를 따르세요. 프로토콜, 전송 방식, 보안 설정, 인증 정보가 서로 맞아야 합니다.
Shadowsocks
Shadowsocks는 지정된 암호화 방식과 비밀번호를 사용하는 프록시 프로토콜입니다. 서버 주소, 포트, 암호화 방식, 비밀번호가 서버 설정과 일치해야 합니다. 프로토콜 이름만 바꿔 다른 서버 구성을 Shadowsocks로 전환할 수는 없습니다. 기존 정보에 추가 매개변수가 있다면 그대로 모두 입력하세요. 메모 이름만으로 설정이 일치하는지 판단하지 마세요.
VMess
VMess는 인증 정보를 사용하는 프록시 프로토콜이며, 인증 정보는 전체 구성 중 일부입니다. 서버의 전송 방식, 경로, Host, TLS 설정도 연결에 영향을 줄 수 있으므로 보유한 정보를 항목별로 확인하세요. 시스템 시간이 크게 어긋난 경우에는 먼저 시간을 맞춘 뒤 인증 실패와 네트워크 연결 실패를 구분하세요.
VLESS
VLESS는 식별 정보를 사용해 인증합니다. 프로토콜 자체가 암호화 계층을 뜻하지 않으며, 연결 보안은 함께 사용하는 전송 방식과 보안 설정에 따라 달라집니다. 식별 정보만 같다고 연결이 보장되는 것은 아니므로 서버 포트, TLS 이름, 기타 매개변수도 일치해야 합니다. VMess 항목에서 유형 하나만 바꾸고 정상적인 VLESS 구성으로 간주하지 마세요.
Trojan
Trojan은 일반적으로 TLS와 비밀번호 인증을 함께 사용해 프록시 연결을 구성합니다. 비밀번호가 맞더라도 TLS 검증이 통과한다는 보장은 없습니다. 서버 주소, 포트, TLS 이름, 인증서 검증 설정을 함께 확인하세요. 인증서 오류가 발생하면 먼저 이름과 시스템 시간을 확인하고, 검증을 끄는 방법을 일반적인 해결책으로 사용하지 마세요.
Hysteria2
Hysteria2는 QUIC 기반 프록시 프로토콜입니다. 연결은 인증 정보와 TLS 설정, 네트워크의 UDP 지원 여부에 따라 달라집니다. 프로토콜 이름만으로 실제 처리량이나 지연 시간을 알 수 없으며, 매개변수와 네트워크 환경도 중요합니다. 네트워크에 따라 결과가 달라진다면 먼저 차이를 기록한 다음 UDP 연결 가능 여부와 서버 설정을 확인하세요.
WireGuard
WireGuard는 키 쌍을 사용해 암호화 터널을 구성합니다. 연결 정보에는 보통 상대 공개 키, Endpoint, 주소, 라우팅 범위가 포함됩니다. 공개 키와 개인 키는 용도가 다르므로 서로 바꿔 입력하지 마세요. 개인 키를 공개 로그에 붙여넣어서도 안 됩니다. 터널이 연결된 뒤에도 대상 네트워크와 DNS를 확인해야 합니다. 핸드셰이크 성공이 모든 대상에 접근할 수 있다는 뜻은 아닙니다.
규칙 키워드와 정책
먼저 매칭 조건을 확인한 다음 처리 정책을 살펴보세요
규칙은 일반적으로 위에서 아래로 확인하며, 먼저 일치한 규칙이 처리 방식을 결정합니다. 아래 예시는 문법을 알아보기 위한 조각이며, 그대로 사용할 수 있는 완전한 구성은 아닙니다.
규칙 조각 읽기 예시
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY첫 번째 항목은 매칭 방식을 나타내고, 마지막 항목은 매칭 후 처리 방식을 나타냅니다. FINAL은 최종 매칭 항목이므로 도메인이나 네트워크 대역 항목이 없습니다. 예시의 example.com은 설명용 도메인입니다.
DOMAIN
DOMAIN은 전체 도메인이 일치하는지 확인합니다. 예를 들어 DOMAIN,example.com,DIRECT는 지정한 도메인에만 적용되며 모든 하위 도메인을 자동으로 포함하지 않습니다. 규칙에는 경로가 포함된 전체 URL이 아니라 도메인을 입력하세요. 웹사이트가 여러 도메인에 요청을 보내는 경우 요청 기록을 확인해 실제로 일치한 대상을 찾아야 합니다. 주소 표시줄만 봐서는 알 수 없습니다.
DOMAIN-SUFFIX
DOMAIN-SUFFIX는 도메인 접미사의 경계를 기준으로 일치 여부를 확인합니다. example.com을 지정하면 일반적으로 해당 도메인과 하위 도메인이 포함됩니다. 전체 URL에서 같은 문자열을 무작위로 찾거나 경로를 매칭하는 기능은 아닙니다. 앞선 규칙이 먼저 일치하면 요청은 이 규칙까지 도달하지 않으므로 추가한 뒤에는 규칙 순서도 확인하세요.
GEOIP
GEOIP는 IP 지리 위치 데이터베이스를 기준으로 대상 주소를 판별합니다. 예: GEOIP,CN,DIRECT. 판별 결과는 데이터베이스와 확인된 주소에 따라 달라지며, 페이지에 쓰인 언어, 계정 지역, 운영 주체의 소재지를 뜻하지 않습니다. CDN을 사용하는 도메인은 서로 다른 주소를 반환할 수 있으므로 문제를 확인할 때 실제 대상 IP를 기록하세요.
IP-CIDR
IP-CIDR은 네트워크 대역 표기법으로 IPv4 주소를 매칭합니다. 슬래시 뒤의 숫자는 네트워크 접두사 길이를 나타냅니다. 예를 들어 192.0.2.0/24는 문서에 사용하는 예시 대역입니다. IPv6 대역에는 IP-CIDR6을 사용하며 두 형식을 섞어 쓸 수 없습니다. 도메인이 서로 다른 주소로 확인되면 적용되는 규칙도 달라질 수 있으므로 DNS 결과와 함께 확인하세요.
FINAL
FINAL은 앞선 규칙에 일치하지 않은 요청을 처리하며, 일반적으로 규칙 목록의 마지막에 둡니다. FINAL,PROXY와 FINAL,DIRECT는 서로 다른 최종 처리 경로를 지정하며 모든 구성에 공통으로 적용되는 정답은 없습니다. 많은 요청이 예상치 않게 최종 정책을 따른다면 먼저 앞선 규칙의 적용 범위와 순서를 확인하세요.
PROXY
PROXY는 규칙에서 프록시 처리 경로를 선택하는 정책 이름입니다. 실제 출구는 현재 선택 항목과 구성 정의를 함께 살펴봐야 합니다. 서버 주소나 프로토콜 이름이 아닙니다. PROXY에 일치했다면 우선 처리 방향만 확인할 수 있습니다. 연결 성공 여부를 확인하려면 선택된 서버와 인증, 전송 방식, DNS 상태도 살펴봐야 합니다.
DIRECT
DIRECT는 일치한 요청을 직접 연결 경로로 처리하며, 일반적으로 현재 로컬 네트워크를 통해 접근해야 하는 대상에 사용합니다. 모든 DNS 처리를 건너뛴다는 뜻도 아니고 대상 서비스에 연결할 수 있다는 보장도 없습니다. 규칙의 DIRECT는 매칭된 요청에 적용되고 Global Routing의 Direct는 전체 모드이므로, 확인할 때 어느 계층을 말하는지 구분하세요.
REJECT
REJECT는 규칙에 일치한 요청을 거부합니다. 처리 범위는 규칙이 식별할 수 있는 도메인, 주소 또는 기타 조건에 따라 달라집니다. 하나의 도메인에서 여러 종류의 콘텐츠를 제공할 수 있으므로 거부 범위가 지나치게 넓으면 정상 기능에도 영향을 줄 수 있습니다. 일부 화면이 표시되지 않는다면 매칭 기록을 확인하고 규칙 범위를 좁히세요. 거부 목록을 계속 늘리지 마세요.
구독과 구성
연결 정보, 규칙 파일, 동기화를 구분하세요
서버 목록은 ‘어디에 연결할지’를, 구성 파일은 ‘요청을 어떻게 처리할지’를 정합니다. 두 가지를 함께 사용할 수 있지만, 하나를 가져왔다고 다른 하나까지 설정된 것은 아닙니다.
Subscribe
Subscribe는 사용자가 이미 보유한 구독 링크를 통해 서버 항목을 가져오고 갱신합니다. 실제 내용은 링크에서 반환하는 데이터에 따라 달라집니다. 구독 링크에 접근 인증 정보가 포함될 수 있으므로 로그나 스크린샷을 공유하기 전에 전체 주소를 가리세요. 갱신 후 목록이 비어 있다면 링크 가져오기 실패, 반환 데이터 이상, 파싱 실패를 구분해서 확인하세요. 서버가 모두 작동하지 않는다고 바로 단정하지 마세요.
Server
Server는 주소, 포트, 프로토콜, 인증 매개변수가 포함된 연결 기록입니다. 보유한 정보를 사용해 Add Server에서 추가할 수 있습니다. 목록의 메모는 항목을 구분하기 위한 이름일 뿐이며, 메모를 바꿔도 실제 서버는 바뀌지 않습니다. 매개변수를 복사할 때 앞뒤 공백과 각 필드의 대응 관계를 확인해 표시 이름을 호스트 주소로 잘못 입력하지 않도록 하세요.
구성 파일
구성 파일은 규칙, DNS, 정책 등의 설정을 모아 저장하며, 포함 항목은 파일 내용에 따라 달라집니다. 파일을 가져오는 것과 선택해 사용하는 것은 별개의 작업입니다. 수정한 뒤에는 현재 어떤 파일이 적용 중인지 확인하세요. 변경 전 사용 가능한 사본을 보관하고, 관련 항목을 한 번에 하나씩 수정하면 무엇이 달라졌는지 비교하기 쉽습니다.
iCloud 동기화
iCloud 동기화는 앱이 지원하는 범위에서 iCloud를 통해 데이터를 전달하며 계정, 시스템 권한, 네트워크, 앱 내 설정에 따라 달라집니다. App Store 구입 내역과는 별개이며 앱을 다시 다운로드했다고 데이터가 복구되었다고 볼 수는 없습니다. 기기를 바꾼 뒤에는 실제로 동기화되는 항목과 현재 선택한 구성을 확인하고 중요한 정보는 안전하게 보관하세요.
DNS와 네트워크
이름 확인, 연결, 서비스 접근을 나눠서 확인하세요
한 번의 테스트로 확인할 수 있는 조건은 일부에 불과합니다. 결과를 비교하려면 테스트 네트워크, 대상, 모드를 기록하세요. 숫자 하나만 비교해서는 정확한 판단이 어렵습니다.
DNS
DNS는 도메인 이름을 IP 주소로 변환하며, 라우팅 선택과 이후 연결 과정에서 확인된 주소를 사용할 수 있습니다. 이름 확인에 성공해도 대상 포트에 연결할 수 있다는 뜻은 아니며, 연결 실패가 반드시 DNS 문제인 것도 아닙니다. 문제를 확인할 때는 도메인, 확인된 주소, 요청 경로를 각각 기록하세요. DNS 설정을 변경한 뒤에는 캐시의 영향도 고려하고 여러 변수를 동시에 바꾸지 마세요.
Connectivity Test
Connectivity Test는 테스트 조건에서 지정한 대상에 도달할 수 있는지 확인하는 기능입니다. 사용한 테스트 방식에 맞춰 결과를 해석하세요. 테스트에 성공해도 모든 웹사이트와 프로토콜이 정상 작동하거나 장시간 전송이 안정적이라는 뜻은 아닙니다. 테스트 결과와 실제 접근 결과가 다르면 반복 테스트만 하지 말고 대상 도메인, Global Routing, 규칙 매칭 여부를 확인하세요.
지연 시간
지연 시간은 요청과 응답 사이에 걸리는 시간을 나타냅니다. TCP 연결이나 HTTP 요청 등 테스트 방식에 따라 결과가 달라질 수 있습니다. 지연 시간이 짧다고 지속적인 전송 속도가 빠르거나 연결이 안정적이라는 뜻은 아닙니다. 비교할 때는 동일한 네트워크와 테스트 방식, 비슷한 시간 조건을 유지하고 실제 서비스 이용 결과도 함께 살펴보세요.
URL Rewrite
URL Rewrite는 매칭 조건에 따라 요청 URL을 바꾸는 기능으로, 프록시나 직접 연결 경로를 선택하는 것과는 다릅니다. 수정 가능 여부는 클라이언트에서 확인할 수 있는 요청 범위, 규칙 조건, 관련 구성에 따라 달라집니다. HTTPS 요청에는 추가 처리 범위도 관련됩니다. 문제가 발생하면 먼저 요청을 확인할 수 있는지 살펴본 뒤 매칭 표현식과 변경할 URL을 확인하세요.
용어를 실제 설정과 문제 해결에 적용하기
처음 기존 정보를 가져오는 경우 사용 가이드를 따라 단계별로 설정하세요. 연결은 되었지만 예상과 다르게 작동한다면 증상에 맞춰 문제 해결 매뉴얼을 확인하세요. 프로토콜 이름이나 테스트 숫자 하나만으로는 원인을 단정할 수 없습니다.
Shadowrocket은 모든 플랫폼에서 사용할 수 있는 클로즈드 소스 상용 앱입니다. iPhone / iPad 버전은 App Store에서 $2.99에 한 번 결제하며, 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료이며 설치 파일은 사이트의 /dl/에서 받을 수 있습니다. 구체적인 다운로드 경로와 처음 실행할 때 필요한 시스템 승인 절차는 다운로드 가이드에서 확인하세요.