공식 매뉴얼 / 기능 및 설정

Shadowrocket 기능 및 설정

먼저 트래픽 경로를 확인한 다음 연결 조건과 진단 설정을 조정하세요. Home, Config, Data, Settings의 기능별로 살펴봅니다. 화면 용어는 영어 원문을 유지합니다.

Global Routing Config / Proxy / Direct 규칙 및 정책 기존 구독 관리 Settings 참고

기능 목차

여섯 가지 기능의 범위

기능을 선택해 요약을 확인하세요. 구체적인 조작 방법과 점검 절차는 아래 해당 항목을 참고하세요. 규칙 예시는 구문 설명용이며, 기존 설정을 그대로 대체할 수 있는 완성 파일이 아닙니다.

Global Routing 및 규칙 매칭

트래픽 분할 규칙은 매칭 조건에 따라 요청의 처리 정책을 지정합니다. 먼저 Home에서 Global Routing을 확인하고 Config에서 현재 사용 중인 구성 파일을 확인하세요. Config를 선택한 경우에만 해당 구성의 규칙에 따라 트래픽 경로를 판단해야 합니다. 수정하기 전에 기존 구성을 저장하고 규칙 순서, 정책 이름, 최종 매칭 항목을 확인하세요. 범위가 넓은 규칙이 앞에 있으면 뒤의 구체적인 규칙보다 먼저 적용될 수 있습니다. 확인할 때는 단일 대상 요청을 로그와 대조하고, 연결 스위치 상태만으로 규칙 적용 여부를 판단하지 마세요.

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

Home / Global Routing

Config, Proxy, Direct 세 가지 모드

Global Routing은 Shadowrocket이 처리하는 트래픽의 경로를 결정합니다. Home에서 Global Routing을 열고 현재 선택된 항목을 확인한 다음 전환 여부를 결정하세요. 구성, 프록시, 직접 연결은 화면에서 각각 Config, Proxy, Direct로 표시됩니다. 실제 조작 시 영어 이름으로 구분하세요. 모드를 전환해도 서버가 바뀌거나 서버 정보의 오류가 수정되는 것은 아닙니다.

화면 항목트래픽 처리사용 시점먼저 확인할 항목
Config현재 구성 파일의 규칙에 따라 정책을 선택합니다.대상 주소나 다른 조건에 따라 트래픽을 분할해야 할 때 사용합니다.현재 구성, 규칙 순서, 정책 참조 및 FINAL.
Proxy선택한 프록시 경로로 처리 대상 트래픽을 처리합니다.선택한 서버의 프록시 연결을 일시적으로 확인하거나 모든 트래픽에 프록시를 적용해야 할 때 사용합니다.현재 서버와 프로토콜 매개변수가 올바른지 확인합니다.
Direct처리 대상 트래픽을 직접 연결로 처리합니다.현재 네트워크의 직접 연결 상태를 확인하거나 직접 연결이 필요한 경우 사용합니다.현재 네트워크와 DNS를 사용할 수 있는지 확인합니다.

일상적인 사용과 일시적인 문제 점검을 구분하세요

트래픽 분할 구성이 준비되어 있다면 Config를 사용하고 요청 기록으로 규칙이 적용되는지 확인하세요. 규칙이 문제를 일으킨다고 의심되면 기존 모드를 기록한 뒤 같은 대상으로 Proxy 또는 Direct를 사용해 비교 테스트하세요. 테스트가 끝나면 원래 모드로 복원해 임시 상태가 일상 설정으로 남지 않도록 하세요. 특정 대상이 한 모드에서 열렸다는 사실만으로 DNS, 서버 또는 규칙 중 어느 하나가 반드시 잘못됐다고 단정할 수는 없습니다.

Direct는 시스템 VPN 구성을 끄는 것과 같지 않습니다. 연결이 완전히 중지됐는지 확인하려면 Home의 연결 스위치와 시스템 VPN 상태를 함께 확인하세요. 연결 경로를 정확히 확인해야 할 때는 상태 표시줄 아이콘만으로 판단하지 마세요.

Config / Rule

규칙 유형 및 처리 정책

규칙은 일반적으로 매칭 유형, 매칭 내용, 처리 정책으로 구성됩니다. 규칙 유형은 요청을 무엇을 기준으로 식별하는지, 정책은 매칭된 요청을 어떻게 처리하는지 나타냅니다. Config에서 현재 구성의 규칙 부분을 열어 구체적인 항목부터 확인한 다음 범위가 넓은 매칭과 FINAL을 살펴보세요. 규칙은 보통 순서대로 매칭되므로 특정 규칙이 존재하는지만 확인하지 말고 실제로 적용될 수 있는지도 확인해야 합니다.

대상에 맞는 매칭 조건 선택

DOMAIN은 전체 도메인을 매칭하고, DOMAIN-SUFFIX는 도메인 접미사를 매칭합니다. DOMAIN-KEYWORD는 도메인에 포함된 키워드로 매칭하므로 예상보다 넓은 범위에 적용될 수 있습니다. 접미사 규칙에는 웹페이지 경로를 붙이지 말고 도메인 자체를 입력하세요. 특정 도메인에 예외를 적용하려면 해당 도메인을 포함할 수 있는 광범위한 조건보다 정확한 조건을 앞에 두는 것이 일반적입니다.

IP-CIDR 및 IP-CIDR6은 주소 범위를 기준으로 매칭하고, GEOIP는 IP 주소의 위치 정보에 의존합니다. 도메인 규칙과 IP 주소 규칙은 서로 다른 대상을 확인합니다. 도메인 확인 결과와 IPv4 및 IPv6 경로가 점검 결과에 영향을 줄 수 있습니다. USER-AGENT는 요청에서 식별할 수 있는 관련 정보에 의존하므로 모든 앱에 적용되는 앱 단위 선택자로 이해해서는 안 됩니다.

정책 이름 및 FINAL

DIRECT는 직접 연결, PROXY는 프록시 처리, REJECT는 매칭된 요청 거부를 뜻합니다. 사용자 지정 정책 이름을 사용하는 구성이라면 해당 이름의 정의가 있고 철자가 일치하는지 확인하세요. FINAL은 앞선 규칙에 매칭되지 않은 요청을 처리합니다. 선택한 정책에 따라 별도로 지정되지 않은 많은 대상의 경로가 결정되므로 변경 전에 의도한 결과를 분명히 해야 합니다.

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,PROXY
FINAL,DIRECT

위 예시는 정확한 매칭부터 최종 처리까지의 순서를 설명합니다. 규칙을 바꾸기 전에 기존 구성을 저장하세요. 자세한 설정 범위는 설정 참고 →에서 확인하세요.

Home / Add Server / Subscribe

구독 및 서버 관리

Home에서 기존 서버를 확인하고 선택 및 관리할 수 있습니다. 단일 서버 정보는 Add Server에서 프로토콜을 지정해 입력하고, 기존 구독 링크는 Subscribe로 가져오며, 기존 QR 코드는 Scan QR Code로 스캔할 수 있습니다. 사용할 메뉴는 보유한 자료의 형식에 따라 선택하세요. 어떤 방법을 선택해도 서버 측 기능이 달라지는 것은 아닙니다. 가져오기 전에 자료가 본인이 이용 중인 서비스에서 제공된 것인지 확인하고, 대조할 수 있도록 원본 정보를 보관하세요.

가져온 뒤 먼저 확인한 다음 연결하세요

  1. 서버 목록에 예상한 항목이 실제로 나타나는지 확인하세요. 목록이 비어 있으면 규칙을 수정하기보다 구독을 가져오고 분석하는 과정부터 점검하세요.
  2. 항목을 열어 프로토콜, 주소, 포트, 인증 정보를 확인하세요. TLS 및 전송 매개변수는 보유한 자료와 일치해야 하며, 이름만 보고 추측하지 마세요.
  3. 사용할 항목을 선택하고 Connectivity Test를 실행한 다음 실제 요청으로 확인하세요. 테스트 방식에 따라 결과의 의미도 달라집니다.
  4. Global Routing과 현재 Config를 확인한 뒤 연결을 켜세요. 이 항목들이 모두 명확해야 트래픽 경로를 올바르게 파악할 수 있습니다.

구독을 업데이트하면 원격 서버 항목을 다시 불러오므로 이름이 바뀌거나 항목이 추가 또는 삭제되거나 기존 선택 항목이 사라질 수 있습니다. 업데이트가 완료됐다는 알림만 보지 말고 현재 서버를 다시 확인하세요. 직접 유지해야 하는 특별한 매개변수가 있다면 업데이트 전에 기록하고, 구독 업데이트로 해당 항목이 다시 생성되는지도 확인하세요.

서버 이름은 식별을 위한 라벨이지 연결 품질을 증명하지 않습니다. 용도별로 알아보기 쉬운 이름을 지정할 수 있지만 인증 정보를 이름에 넣지 마세요. 구독 링크, QR 코드, 내보낸 자료에는 인증 정보가 포함될 수 있습니다. 문제 해결 자료를 제공할 때는 필요한 항목만 남기세요. 전체 가져오기 절차는 튜토리얼에 따라 진행하세요.

Settings / On Demand

On Demand 주문형 연결

On Demand는 저장된 조건이 충족되면 시스템이 VPN 연결을 시작하도록 합니다. On Demand는 ‘언제 연결할지’를 다루고 Global Routing은 ‘연결 후 트래픽을 어떻게 라우팅할지’를 다루므로 서로 대체할 수 없습니다. Settings에서 On Demand 관련 옵션을 열어 현재 조건을 먼저 확인한 다음 활성화 여부를 결정하세요. 구체적인 항목과 시스템 동작은 기기의 현재 화면을 기준으로 확인하세요.

수동 연결을 확인한 다음 트리거 조건을 활성화하세요

자동 연결 트리거를 먼저 끄고 서버를 직접 선택해 웹 요청이 정상적으로 처리되는지 확인하세요. 서버, DNS, 규칙이 정상 작동하는 것을 확인한 뒤 필요한 On Demand 조건을 활성화하세요. 조건을 하나씩 바꿀 때마다 해당 네트워크 환경에서 다시 테스트하세요. 연결 조건과 트래픽 분할 규칙을 동시에 수정하지 마세요. 문제가 생겼을 때 어느 단계에서 비롯됐는지 파악하기 어렵습니다.

수동으로 연결을 끊은 뒤 다시 연결되면 먼저 주문형 트리거 설정을 확인하세요. 네트워크를 전환한 뒤 바로 다시 연결되지 않으면 트리거 조건, 시스템 VPN 상태, 현재 네트워크를 확인해야 합니다. 실제 동작은 시스템 스케줄링, 네트워크 사용 가능 여부, 서버 응답에 영향을 받으므로 On Demand가 계속 온라인 상태를 보장하지는 않습니다. 연결을 끊은 상태로 유지하려면 연결을 시작할 수 있는 조건이 남아 있는지 확인한 뒤 시스템 상태를 살펴보세요.

Data

트래픽 통계 및 연결 기록

Data에서 앱에 기록된 트래픽과 연결 상태를 확인할 수 있습니다. 문제를 점검할 때는 먼저 현재 통계 범위와 시간 기준, 초기화 여부를 확인한 다음 업로드, 다운로드 또는 연결 기록을 살펴보세요. 연결에 트래픽이 발생했다는 것은 데이터가 오갔다는 뜻일 뿐입니다. 핸드셰이크, 이름 확인, 실패 후 재시도도 데이터를 발생시킬 수 있으므로 통계가 증가했다고 해서 서비스 요청이 성공했다고 단정할 수는 없습니다.

재현 가능한 요청 하나로 기록을 대조하세요

시작하기 전에 선택한 서버, Global Routing, 테스트 대상을 기록하세요. 대상 페이지를 한 번 열어 본 다음 Data로 돌아와 새 기록을 확인하고 표시된 대상, 정책, 시간을 기준으로 요청이 예상 경로를 거쳤는지 판단하세요. 더 자세한 처리 이유가 필요하면 Log를 확인하세요. 테스트하는 동안 다른 앱의 백그라운드 요청을 줄여 서로 다른 요청을 혼동하지 않도록 하세요.

Data 통계를 서버 요금 청구 내역이나 기기의 셀룰러 데이터 통계와 동일한 기준으로 해석해서는 안 됩니다. 집계 범위, 프로토콜 추가 데이터, 재연결, 시간 구간에 따라 차이가 생길 수 있습니다. 비교하려면 먼저 관찰 시간을 일치시키고 초기화 전 데이터를 보관하세요. 기록에는 접속 대상과 주소가 포함될 수 있으므로 스크린샷을 찍거나 내보내기 전에 개인정보를 확인하세요.

Settings

자주 사용하는 설정 항목의 조정 범위

아래 내용은 설정의 용도와 점검 방법을 설명하며 모든 기기에 일괄 적용할 값을 지정하지 않습니다. 구성 파일에 관련 항목이 있을 수 있으므로 조정 전에 현재 구성과 Settings가 실제 적용되는 방식을 확인하세요.

DNS: 이름 확인 실패와 연결 실패 구분하기

DNS는 도메인 이름을 주소로 변환합니다. Settings의 DNS 관련 항목과 현재 Config에서 이름 확인 설정을 살펴보고 기존 값을 먼저 기록한 뒤 사용 목적을 확인하세요. 도메인을 확인하지 못하는 문제와 주소를 확인했지만 연결에 실패하는 문제는 서로 다릅니다. 진단 기록으로 먼저 구분한 다음 해당 단계만 조정하세요. 이름 확인 옵션을 한꺼번에 여러 개 바꾼 뒤 웹페이지가 열리는지만 보고 원인을 판단하지 마세요.

DNS 요청에도 사용할 수 있는 네트워크 경로가 필요합니다. 설정한 이름 확인 방식이 현재 프록시에 의존하는데 프록시 연결이 아직 설정되지 않았다면 서로 의존하는 문제가 발생할 수 있습니다. 점검할 때 서버 연결 가능 여부, 규칙, IPv4 및 IPv6 결과를 함께 고려하세요. 도메인 이름 확인 과정에는 조회 정보 처리가 포함될 수 있으므로 테스트 시간만 비교하지 말고 설정에 따른 경로를 이해한 뒤 선택하세요.

Test Method: 테스트 방식에 따른 결과 해석

Test Method는 연결 테스트에 사용할 방식을 지정합니다. Settings에서 해당 항목을 확인한 다음 Home으로 돌아가 Connectivity Test를 실행하세요. 여러 항목을 비교할 때는 테스트 방식, 대상, 네트워크 환경을 동일하게 유지해야 합니다. 테스트 시간 초과는 서버를 전혀 사용할 수 없다는 뜻이 아닐 수 있으며, 테스트 대상이나 방식이 적절하지 않았을 가능성도 있습니다. 테스트를 통과해도 모든 서비스 요청이 완료된다는 뜻은 아닙니다.

한 번의 결과만 보고 모든 서버 순서를 바꾸지 마세요. 먼저 테스트를 반복하고 실제 대상에 요청한 다음 로그와 함께 판단하세요. 테스트 관련 매개변수를 변경했다면 변경 전 상태를 기록해 서로 다른 조건의 결과를 혼동하지 않도록 하세요.

Today Widget: 빠른 확인 및 조작

Today Widget은 시스템 위젯과 관련된 설정 메뉴로, 관련 정보를 빠르게 표시하거나 조작하도록 설정할 수 있습니다. Settings에서 현재 사용할 수 있는 옵션을 확인한 다음 기기의 시스템에서 제공하는 방법으로 해당 위젯을 추가하세요. 표시할 수 있는 정보, 추가 방법, 새로고침 동작은 실제 화면을 기준으로 확인하세요. 위젯이 표시된다고 해서 상태가 계속 실시간으로 모니터링된다고 볼 수는 없습니다.

빠른 메뉴에서 조작한 뒤에도 중요한 테스트는 Home으로 돌아가 연결 스위치, 현재 서버, Global Routing을 확인하세요. 위젯이 바로 갱신되지 않으면 앱을 열어 실제 상태를 확인하세요. 이전에 표시된 내용만 보고 연결을 연속해서 전환하지 마세요.

iCloud: 동기화 범위 및 덮어쓰기 확인

iCloud 관련 설정은 앱에서 지원하는 동기화 기능에 사용됩니다. Settings에서 동기화할 수 있는 항목을 확인하고 시스템에서 해당 iCloud 사용을 허용했는지 확인하세요. 활성화하기 전에 중요한 현재 구성을 보관하고, 기기를 변경한 뒤에는 편집하기 전에 동기화 결과부터 확인하세요. 모든 데이터 종류가 동기화되는 것은 아니므로 iCloud가 켜져 있다고 해서 모든 연결 정보가 완전히 복원되었다고 볼 수는 없습니다.

여러 기기에서 동시에 수정하는 경우 각 기기에 표시된 내용을 먼저 확인하고 어느 쪽을 유지할지 결정하세요. 동기화에는 시간이 걸릴 수 있으므로 계정을 바꾸거나 기능을 끄기 전에 로컬 자료를 확인하세요. iCloud 동기화와 App Store 구매 기록은 서로 별개의 항목입니다. 구매를 복원해도 서버 정보나 구성이 동기화되었다는 뜻은 아닙니다.

Diagnostics 및 Log: 문제 한 건의 증거 수집

Diagnostics는 연결 문제를 자세히 확인하고 Log는 요청 처리 과정을 살펴보는 데 사용합니다. Settings의 관련 메뉴를 열어 실제로 사용할 수 있는 항목을 실행하세요. 기록을 모으기 전에 실패한 대상, 발생 조건, 현재 모드를 적고 문제를 한 번 재현한 다음 해당 요청과 관련된 기록을 우선 보관하세요. 오랫동안 계속 기록한 뒤 원인을 추측하는 것보다 문제를 쉽게 파악할 수 있습니다.

로그에는 도메인, 주소, 구독 정보 또는 기타 연결 세부 정보가 포함될 수 있습니다. 공유하기 전에 민감한 항목을 삭제하거나 가리고 문제를 설명하는 데 필요한 시간, 오류 정보, 정책 맥락만 남기세요. 상세 기록을 마친 뒤에는 일상적인 사용에 적합한 기록 설정으로 복원하세요. 자료가 충분하지 않은 상태에서 오류 한 건만으로 모든 연결이 작동하지 않는다고 판단하지 마세요.

문제 해결 순서

한 번에 조건 하나만 변경하세요

설정이 많을수록 여러 옵션을 동시에 시도하기보다 정해진 순서로 점검해야 변경을 되돌리기 쉽습니다. 먼저 현재 네트워크를 사용할 수 있는지 확인하고, 서버 정보와 선택 항목을 확인한 다음 Global Routing, 현재 Config, DNS를 살펴보세요. 마지막으로 On Demand와 빠른 메뉴로 인해 상태가 바뀌었는지 확인하세요. 각 단계의 기존 값을 기록하고 테스트가 끝나면 임시 변경 사항을 복원하세요.

  1. Home: 선택한 서버와 연결 스위치를 확인하고 구독 업데이트 성공, 테스트 통과, 실제 요청 성공을 구분하세요.
  2. Global Routing: 현재 모드가 Config, Proxy, Direct 중 무엇인지 확인하세요. 모드를 비교할 때는 항상 같은 대상을 사용하세요.
  3. Config: 적용 중인 파일, 매칭 규칙, 정책 참조, FINAL을 확인하세요. 대상 도메인이 있는지만 검색하지 마세요.
  4. Settings: 문제 유형에 따라 DNS, Test Method, On Demand를 확인하세요. 통계 표시 옵션을 라우팅 스위치로 착각하지 마세요.
  5. Data / Diagnostics: 재현 가능한 요청 하나로 기록을 대조하고 필요한 증거를 저장한 뒤 일상 상태로 복원하세요.