공식 매뉴얼 / 기능 안내

기능과 주요 설정

먼저 Global Routing을 선택한 다음 규칙과 서버를 확인하세요. 자동 연결, 통계, 진단은 각각 다른 문제를 다룹니다.

01 / 트래픽 처리

Global Routing의 세 가지 모드

모드는 트래픽 처리 방식을, 서버는 프록시 연결의 출구를 결정합니다. 두 항목을 따로 확인해야 합니다.

Global Routing은 전체 트래픽의 처리 모드를 선택하는 메뉴이며, 보통 Home에서 열 수 있습니다. 여기서는 Config, Proxy, Direct 세 가지 모드를 구분합니다. 이는 연결 품질 등급이 아니며 서버 주소나 인증 정보를 변경하지 않습니다. 평소 사용 전에는 현재 모드를 확인한 뒤 선택한 서버와 Config를 살펴보세요. 모드 문제를 서버 오류로 잘못 판단하는 일을 줄일 수 있습니다.

화면에 표시되는 모드처리 방식사용 시점확인할 항목
Config · 구성현재 구성의 규칙과 정책에 따라 트래픽을 처리합니다.도메인, IP 또는 다른 조건에 따라 연결을 다르게 처리할 때 사용합니다.현재 구성 파일, 규칙 순서, 정책 참조 및 FINAL을 확인합니다.
Proxy · 프록시클라이언트가 처리하는 트래픽을 현재 프록시 경로로 보냅니다.서버가 프록시 요청을 처리할 수 있는지 잠시 확인하거나 모든 연결을 프록시로 보내야 할 때 사용합니다.서버 선택, 프로토콜 매개변수, 프록시 경로의 사용 가능 여부를 확인합니다.
Direct · 직접 연결클라이언트가 처리하는 트래픽을 직접 연결로 처리합니다.로컬 네트워크 문제를 확인하거나 직접 연결이 필요한 경우 사용합니다.현재 네트워크에서 대상에 직접 접속할 수 있는지, 자동 연결이 계속 활성화되어 있는지 확인합니다.

설정 방법: 모드를 선택한 뒤 새 요청 보내기

Home에서 Global Routing을 열고 원하는 모드를 선택한 다음 표시된 값을 다시 확인합니다. Config를 사용할 때는 Config에서 사용할 구성을 선택해야 합니다. Proxy를 사용할 때는 Home에서 선택된 서버를 확인하세요. 변경 후에는 대상 페이지를 다시 열거나 새 연결을 요청해 확인합니다. 이미 연결된 장시간 연결은 기존 경로를 계속 사용할 수 있으므로, 기존 페이지가 여전히 응답하는지만으로 판단하지 마세요.

주의: Direct를 선택해도 클라이언트 연결 스위치가 꺼지는 것은 아니며, Proxy를 선택해도 기기의 모든 트래픽이 시스템 제한을 우회하는 것은 아닙니다. 실제 처리 범위는 시스템 네트워크 구조와 앱 동작에 따라 달라집니다. 화면에 Scene이 표시되는 경우에는 해당 설정을 실제 사용 상황에 맞게 별도로 확인하세요. 이 표의 세 가지 기본 모드와 동일하게 취급하면 안 됩니다.

02 / 매칭 및 정책

규칙 기반 트래픽 분기와 Config

규칙은 “무엇을 매칭할지”, 정책은 “매칭된 후 어떻게 처리할지”를 정합니다.

규칙 기반 트래픽 분기는 연결마다 다른 처리 경로를 지정하는 기능입니다. Config에서 현재 구성을 열어 규칙을 확인하거나 수정할 수 있습니다. 여기서 설명하는 구성 규칙에 따라 분기하려면 Global Routing에서 Config 모드를 선택해야 합니다. 수정 전에는 기존 구성을 백업하고 현재 선택된 파일을 확인한 다음, 범위가 명확한 규칙 하나를 추가하세요. 규칙, DNS, 서버 설정을 한꺼번에 바꾸지 마세요.

기본 개념: 자주 쓰는 규칙 유형

  • DOMAIN: 지정한 전체 도메인과 일치합니다. 특정 호스트 이름 하나만 처리할 때 적합합니다.
  • DOMAIN-SUFFIX: 도메인 접미사와 해당 하위 도메인에 일치합니다. 하나의 도메인 체계를 포함할 때 사용하며, 이름은 비슷하지만 접미사가 다른 도메인과 구분해야 합니다.
  • DOMAIN-KEYWORD: 도메인에 포함된 키워드와 일치합니다. 전체 도메인보다 범위가 넓은 경우가 많으므로 추가 전 관련 없는 요청까지 매칭되는지 확인하세요.
  • IP-CIDR / IP-CIDR6: 각각 IPv4 / IPv6 네트워크 대역을 기준으로 매칭합니다. 프리픽스 길이에 따라 적용 범위가 달라지므로 단일 주소와 전체 대역을 혼동하지 마세요.
  • GEOIP: IP 지리 데이터베이스를 기준으로 주소의 위치를 판단합니다. 데이터베이스 결과가 웹사이트의 실제 소재지를 뜻하는 것은 아니며, 확인되는 IP 주소에 따라 달라질 수도 있습니다.
  • FINAL: 앞선 규칙에 일치하지 않은 연결에 최종 처리 방식을 지정하며, 보통 규칙의 마지막에 둡니다.

설정 방법: 구체적인 규칙은 앞에, 기본 규칙은 뒤에

규칙은 보통 위에서 아래로 확인하며, 먼저 일치한 유효 규칙이 처리 방식을 결정합니다. 아래는 문법 설명용 예시이며 그대로 전체 구성을 대체하는 범용 설정이 아닙니다. example.com은 예시용 도메인입니다. PROXY는 사용 가능한 프록시 경로를 지정해야 하며, DIRECT는 직접 연결, REJECT는 일치하는 연결을 거부합니다.

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

주의: 사용자 지정 정책 그룹을 사용하는 경우 규칙 끝의 정책 이름이 구성에 정의된 이름과 정확히 일치해야 합니다. 범위가 넓은 규칙을 앞에 두면 뒤의 세부 규칙이 적용되지 않을 수 있습니다. 특정 웹사이트에 문제가 생기면 새 요청이 어떤 규칙에 매칭되었는지 먼저 확인한 뒤 유형, 순서, 정책 중 무엇을 바꿀지 결정하세요. 페이지가 열리는지만으로 규칙이 올바르다고 판단하면 안 됩니다.

규칙 키워드와 화면 메뉴 이름은 용어집에서 확인할 수 있습니다. 처음 설정할 때는 정상적으로 연결되는 구성을 백업해 복구 기준으로 보관하세요.

03 / 연결 정보

구독 및 서버 관리

Subscribe는 여러 서버의 일괄 업데이트를, Add Server는 개별 연결 설정을 관리합니다.

서버 항목에는 프로토콜, 주소, 포트, 인증 정보 등 연결 정보가 저장됩니다. 구독은 기존 링크를 이용해 서버 목록을 가져오고 업데이트합니다. 두 항목은 규칙 구성 파일과 다릅니다. Home의 추가 메뉴에서 Add Server를 열어 프로토콜에 맞게 서버 정보를 입력하세요. 자신의 구독이 있다면 해당 Subscribe 메뉴에 링크를 입력하고 저장합니다. 플랫폼에 따라 메뉴 위치가 다를 수 있으므로 실제 화면에 표시되는 항목을 기준으로 진행하세요.

설정 방법: 프로토콜을 확인한 뒤 항목 입력

서버를 직접 추가할 때는 먼저 보유한 서버 정보와 일치하는 프로토콜을 선택하고 주소, 포트, 인증 항목을 차례로 입력하세요. Shadowsocks, VMess, VLESS, Trojan, WireGuard, Hysteria2 등의 프로토콜 매개변수는 서로 바꿔 쓸 수 없습니다. 서버에서 요구하는 TLS, 전송 방식, 이름 항목도 동일하게 설정해야 합니다. 주소가 같다고 연결이 보장되는 것은 아닙니다.

보유한 공유 링크는 클립보드에서 가져올 수 있으며, QR 코드는 Scan QR Code로 읽을 수 있습니다. 가져온 뒤에도 프로토콜, 호스트, 그룹을 확인하세요. 목록에 이름이 표시된다고 정보가 모두 입력된 것은 아닙니다. QR 코드와 공유 링크에 인증 정보가 포함될 수 있으므로 캡처, 화면 녹화 또는 전달 전 민감한 내용을 가리세요.

주의 사항: 업데이트, 테스트, 삭제는 따로 진행

Subscribe를 업데이트하면 구독 내용에 따라 관련 항목이 갱신됩니다. 구독 항목을 직접 수정한 경우 이후 업데이트에서 변경 사항이 덮어써질 수 있습니다. 구독이 여러 개라면 알아보기 쉬운 메모나 그룹명을 사용해 이름이 같은 항목을 잘못 선택하지 않도록 하세요. 업데이트에 실패하면 바로 그룹 전체를 삭제하지 말고 기존 링크와 현재 네트워크를 먼저 확인한 뒤 다시 시도하세요. 삭제 전에는 보관할 수동 항목이나 백업이 있는지 확인해야 합니다.

Connectivity Test로 서버에 연결할 수 있는지 먼저 확인할 수 있지만, 한 번의 테스트 수치가 실제 처리량을 나타내거나 모든 대상에 접속할 수 있음을 보장하지는 않습니다. 서버를 선택한 뒤 Global Routing 설정과 실제 요청으로 함께 확인하세요. 업데이트 정책, 정렬, 백업은 구독 및 서버 관리 매뉴얼을 참고하세요.

04 / 자동 연결

On Demand 자동 연결

연결을 언제 시도할지 정하며, 웹사이트에 어떤 규칙을 적용할지는 결정하지 않습니다.

On Demand는 네트워크 조건에 따라 연결을 시작합니다. 지정한 Wi-Fi 또는 셀룰러 네트워크에서 자동 연결이 필요한 경우에 사용할 수 있습니다. Settings에서 On Demand를 찾아 사용 가능한 네트워크 조건과 현재 규칙을 확인한 뒤 필요에 맞게 설정하세요. Global Routing과 역할이 다릅니다. On Demand는 연결을 시작하는 조건을, Global Routing은 연결 후 트래픽 처리 방식을 정하므로 서로 대체할 수 없습니다.

설정 방법: 네트워크 조건을 하나씩 확인

먼저 수동 연결이 가능한지 확인한 다음 On Demand를 활성화하세요. Wi-Fi와 셀룰러 네트워크 조건을 각각 확인하고, 화면에 Wi-Fi 이름 매칭 항목이 있다면 정확한 네트워크 이름을 입력합니다. 저장 후 설정 화면을 나가 테스트할 네트워크로 전환하고 시스템 VPN 상태와 클라이언트 연결 상태를 확인하세요. 한 번에 조건 하나씩 테스트해야 여러 규칙이 겹쳤을 때 어떤 규칙이 적용됐는지 파악하기 쉽습니다.

주의: 활성화된 상태에서는 조건이 충족될 때 수동으로 연결을 끊어도 다시 연결될 수 있습니다. 잠시 사용하지 않으려면 Home의 연결 스위치만 반복해서 끄지 말고 On Demand 설정도 확인하세요. 웹 로그인이 필요한 공용 Wi-Fi에서는 먼저 네트워크 인증을 완료한 뒤 연결을 테스트해야 합니다. 시스템에 다른 VPN 구성이 있다면 자동 연결이 함께 설정되어 있는지도 확인해 서로 전환되는 일을 방지하세요.

On Demand는 만료된 구독, 잘못된 비밀번호, 연결할 수 없는 서버를 해결하지 않습니다. 네트워크 전환 직후의 일시적인 중단도 서버 장애와 구분해야 합니다. 문제를 확인할 때는 자동 연결을 잠시 비활성화하고 같은 서버에 수동으로 연결해 보세요. 수동 연결이 안정적이라면 On Demand를 다시 켜고 기존 조건을 하나씩 테스트합니다.

05 / 사용 결과 확인

Data 트래픽 통계

클라이언트에 기록된 트래픽을 확인하는 기능이며, 통신사나 서비스 제공업체의 청구 내역을 대신하지 않습니다.

Data에서는 클라이언트가 제공하는 트래픽 통계와 기록을 확인할 수 있습니다. Data를 열고 먼저 통계 범위, 방향, 시간 정보를 확인한 뒤 업로드와 다운로드 수치를 살펴보세요. 제공되는 세부 정보와 보관 방식은 플랫폼마다 다를 수 있습니다. 한 번의 연결에서 누적된 값을 하루 사용량으로 간주하거나, 클라이언트 통계를 기기 전체 네트워크 사용 기록으로 여기지 마세요.

사용 방법: 기준값을 기록한 뒤 한 가지 항목만 테스트

작업으로 트래픽이 발생했는지 확인하려면 현재 표시된 값을 먼저 기록한 다음 대상 페이지 하나만 열거나 요청을 한 번 보내고 돌아와 변화를 확인하세요. 설정 전후를 비교할 때는 테스트 대상, 네트워크 조건, 작업 과정을 동일하게 유지합니다. 설정 변경, 백그라운드 앱 활동, 기존 연결도 통계에 영향을 줍니다. 숫자가 증가했다는 사실만으로 특정 규칙이나 서버가 실제 경로였다고 단정할 수 없습니다.

주의: 클라이언트와 서비스 제공업체의 통계는 집계 기간, 프로토콜 오버헤드, 측정 기준에 따라 다를 수 있습니다. 앱 데이터 삭제, 재설치 또는 통계 초기화 후에는 이전 기록이 계속 누적되지 않을 수도 있습니다. 사용량이 비정상적으로 보이면 시간 범위와 백그라운드 요청을 먼저 확인한 다음 연결 기록을 함께 살펴보세요. 도메인 매칭이나 연결 오류를 확인하려면 요약 수치만 보는 대신 관련 기록이나 Diagnostics를 확인해야 합니다.

06 / 자주 쓰는 항목

Settings 설정 안내

현재 값을 기록한 뒤 항목 하나씩 변경하세요. 효과가 없으면 원래대로 되돌려 설정이 겹치지 않도록 합니다.

DNS: 도메인 확인과 연결 경로

기능과 위치: DNS는 도메인을 연결에 필요한 주소로 변환합니다. 관련 설정은 Settings의 DNS 항목과 현재 Config 양쪽에 있을 수 있으므로 문제를 확인하기 전에 사용 중인 구성을 파악해야 합니다. 한 곳의 메뉴만 확인하면 안 됩니다. DNS 응답이 정상이어도 반환된 주소에 현재 연결 경로로 접속할 수 있다는 뜻은 아닙니다.

설정 방법: 기존 DNS 설정과 구성 파일을 먼저 백업한 뒤 수동으로 지정한 리졸버, 도메인 오버라이드 또는 다른 DNS 규칙이 있는지 확인하세요. 현재 구성 안내에 따라 항목 하나를 수정하고 연결을 다시 설정한 다음 새 도메인 요청을 보냅니다. 서버 주소, 구독 URL, 임의의 웹 주소를 리졸버 항목에 입력하면 안 됩니다.

주의: DNS 캐시와 기존 연결 때문에 설정을 바꿔도 웹페이지에 바로 반영되지 않을 수 있습니다. 도메인 규칙, IP 규칙, DNS 응답은 서로 연관되어 있습니다. 특정 대상에 문제가 있으면 먼저 도메인이 확인되는지, 주소에 연결할 수 있는지, 어떤 규칙이 적용되는지 각각 확인한 뒤 DNS 변경이 필요한지 판단하세요.

Test Method: 테스트 방식 설정

기능과 위치: Settings의 Test Method는 관련 연결 테스트에 사용할 방식을 설정합니다. 결과는 해당 방식과 테스트 대상이 당시 어떻게 동작했는지를 보여줄 뿐, 일반적인 속도 점수는 아닙니다. Connectivity Test를 실행하기 전에 현재 테스트 방식을 확인하세요.

설정 방법: 현재 문제 확인에 적합한 테스트 방식을 선택하세요. 테스트 대상을 지정해야 한다면 연결 가능 여부를 알고 있고 안정적인 대상을 사용합니다. 여러 서버를 비교할 때는 방식, 대상, 네트워크를 동일하게 유지하고 테스트를 반복하세요. 조건이 다른 결과를 한데 놓고 순위를 매기지 마세요.

주의: 테스트 시간 초과가 모든 프록시 요청의 실패를 뜻하지 않으며, 테스트에 성공해도 특정 서비스가 작동한다고 보장할 수는 없습니다. 테스트 수치를 다운로드 속도로 직접 환산할 수도 없습니다. 실제로 이용하려는 대상에 접속해 확인하세요.

Today Widget: 시스템 바로가기

기능과 위치: Today Widget은 시스템 위젯 관련 기능입니다. 먼저 Settings에 해당 항목이 있는지 확인한 뒤 시스템 위젯 편집 화면에서 추가할 수 있는지 살펴보세요. 표시 여부는 시스템 지원 상태에 따라 달라지므로 메뉴가 보이지 않는다고 클라이언트 설정이 손상된 것은 아닙니다.

설정 방법: 먼저 클라이언트에서 서버와 모드를 선택하고 첫 연결을 완료한 다음 시스템에서 제공하는 위젯을 추가하세요. 바로가기를 사용한 후 Home으로 돌아와 실제 상태를 확인합니다. 특히 네트워크를 방금 전환했거나 구성을 방금 수정한 경우에는 다시 확인해야 합니다.

주의: 위젯은 조작 및 정보 확인을 위한 메뉴이며 독립된 규칙 구성이 아닙니다. 표시 상태가 갱신되기까지 시간이 걸릴 수 있습니다. 잠금 화면이나 화면 공유 중에는 공개하고 싶지 않은 서버 이름이 위젯에 표시되는지도 확인하세요.

iCloud: 동기화 및 백업 범위

기능과 위치: iCloud 관련 항목은 지원되는 기기와 시스템 환경에서 화면 안내에 명시된 데이터를 저장하거나 동기화하는 기능입니다. Settings에서 동기화 스위치를 확인하고 시스템 iCloud에서 Shadowrocket에 해당 기능 사용을 허용했는지도 살펴보세요. 모든 플랫폼과 항목, 과거 기록이 동기화된다고 가정하면 안 됩니다.

설정 방법: 원래 기기에서 중요한 정보를 먼저 백업한 다음 대상 기기가 같은 iCloud 계정을 사용하고 앱의 접근이 허용되어 있는지 확인하세요. 동기화가 완료되면 서버, 구성, 현재 선택 항목을 하나씩 확인합니다. 양쪽 기기에서 동시에 대량으로 수정하거나 삭제하면 어떤 변경이 데이터를 덮어썼는지 파악하기 어려울 수 있습니다.

주의: 동기화는 이전 버전 백업이 아니며 실수로 삭제한 내용도 다른 기기에 반영될 수 있습니다. 구독과 구성에는 인증 정보가 포함될 수 있으므로 시스템 계정과 기기 접근 권한을 안전하게 관리하세요. 기기 이전 후에도 시스템 연결 권한과 실제 네트워크 상태를 다시 확인해야 합니다.

Diagnostics: 오류 상황 기록

기능과 위치: Diagnostics는 문제 진단 도구나 정보를 제공하며 보통 Settings에서 찾을 수 있습니다. 문제 범위를 좁히는 기능이지 잘못된 서버 설정을 자동으로 바꾸지는 않습니다. 화면에서 해당 진단 항목을 선택하고 문제가 발생한 시간과 대상을 함께 고려해 결과를 확인하세요.

설정 및 사용 방법: 현재 네트워크, Global Routing, 서버, 구성을 먼저 기록한 뒤 문제를 한 번 재현하세요. 관련 오류 정보를 보관하고 DNS 확인 실패, 연결 시간 초과, 인증 실패, 규칙에 의한 거부를 차례로 구분합니다. 한 번에 변수 하나만 바꾸고 같은 요청을 다시 보내야 변경 효과를 판단할 수 있습니다.

주의: 진단 정보에는 접속한 도메인, 서버 주소, 인증 정보가 포함될 수 있습니다. 공유하기 전에 구독 링크, 비밀번호, 개인정보를 가리고 문제를 파악하는 데 필요한 부분만 남기세요. 진단이 끝나면 임시로 활성화한 상세 기록을 평소 필요한 수준으로 되돌립니다.

확인 목록

설정 변경 후 확인 순서

  1. 기본 네트워크 확인. 현재 Wi-Fi 또는 셀룰러 네트워크가 정상 작동하는지 먼저 확인하세요. 웹 로그인이 필요한 네트워크는 먼저 인증을 완료합니다.
  2. 서버 확인. 현재 선택된 항목, 프로토콜, 인증 정보를 확인하고 직접 추가한 항목과 Subscribe 업데이트로 가져온 항목을 구분하세요.
  3. 처리 모드 확인. Global Routing에서 Config, Proxy, Direct 중 무엇을 선택했는지 확인하세요. Config를 사용한다면 현재 구성과 적용된 규칙도 확인합니다.
  4. 새 요청 보내기. 이미 연결된 장시간 연결은 재사용하지 말고 새 요청을 보낸 뒤 Data와 Diagnostics에서 같은 테스트 결과를 살펴보세요.
  5. 자동 연결 다시 활성화. 수동 연결 테스트를 마친 뒤 On Demand를 켜고 네트워크 전환을 테스트하세요. 문제가 생겼을 때 되돌릴 수 있도록 설정 내역을 보관합니다.

문제를 계속 확인하기 어렵다면 FAQ의 문제 유형별 안내를 참고하세요. 처음 가져오기를 마치지 못했다면 사용 방법으로 돌아가 기본 연결을 먼저 확인한 뒤 규칙과 자동 연결 설정을 하나씩 추가하세요.