공식 매뉴얼 · 기능 및 설정

Shadowrocket 기능 및 설정 방법

먼저 트래픽 처리 방식을 정한 다음 연결 및 진단 옵션을 조정하세요. 이 페이지에서는 iPhone / iPad 사용을 중심으로 주요 기능이 무엇인지, 어디에서 설정하는지, 설정 방법과 주의사항을 안내합니다. 구체적인 메뉴 위치와 사용 가능한 옵션은 앱에 표시되는 내용을 기준으로 확인하세요.

  • Global Routing
  • 규칙 및 서버
  • 연결 및 진단

처음 사용한다면 먼저 App Store 정품 확인을 마친 뒤 사용 안내에 따라 보유한 설정을 가져오세요. 앱은 일회성 구매이며 연결 서비스 요금제와는 별개입니다. 구독 링크나 서버 정보는 이용 중인 서비스 제공업체에서 확인하세요.

Global Routing: 트래픽 처리 방식 선택

기능: Global Routing은 Shadowrocket이 연결을 처리할 때 적용할 전체 라우팅 방식을 정합니다. Config, Proxy, Direct는 서로 다른 선택지이며 연결 품질 등급이나 프로토콜을 뜻하지 않습니다. 평소처럼 규칙에 따라 대상별로 처리하려면 Config를 사용하세요. 규칙의 영향을 분리해 확인할 때는 Proxy 또는 Direct를 임시로 선택할 수 있습니다.

위치 및 설정 방법: Home에서 Global Routing을 찾아 Config, Proxy 또는 Direct를 선택하세요. Config를 사용하려면 먼저 Config에서 현재 활성화된 설정을 확인하세요. Proxy를 사용하기 전에는 Home에서 사용할 서버를 선택하세요. 변경 후에는 같은 대상에 다시 연결해 확인하고, 이미 열려 있는 페이지의 상태만 보지 마세요.

화면 표시 처리 방식 사용 사례 먼저 확인할 항목
Config 현재 설정의 규칙과 정책에 따라 연결 경로를 결정합니다. 평소 규칙에 따라 라우팅하며 도메인이나 주소별 처리 방식을 구분해야 할 때 사용합니다. 현재 설정, 규칙 순서, 규칙에서 참조하는 정책을 확인합니다.
Proxy 전체적으로 프록시 라우팅을 적용하지만, 로컬 네트워크와 시스템에서 유지하는 경로도 고려해야 합니다. 특정 대상이 규칙 라우팅 때문에 다른 경로를 이용하는지 임시로 확인할 때 사용합니다. 현재 서버의 프로토콜, 인증 정보 및 전송 매개변수를 확인합니다.
Direct 선택한 프록시 서버를 거치지 않고 직접 연결합니다. 로컬 네트워크에서 직접 연결할 수 있는지 비교할 때 사용합니다. 현재 네트워크에서 대상에 직접 연결할 수 있는지 확인합니다.

주의사항: Proxy를 선택해도 서버 인증 실패가 해결되는 것은 아니며, Direct를 선택해도 모든 네트워크 기능이 꺼지는 것은 아닙니다. Global Routing 선택과 Home의 연결 스위치는 별개입니다. 테스트가 끝나면 기존 모드로 되돌려 임시 점검 설정이 계속 적용되지 않도록 하세요. 자세한 절차는 Global Routing 사용 방법을 참고하세요.

규칙 라우팅: 매칭 조건과 정책 구분

기능 및 위치: Config 모드에서는 현재 설정의 매칭 조건에 따라 규칙 라우팅이 처리 정책을 선택합니다. Config를 열어 활성화된 설정을 먼저 확인한 뒤 규칙 내용을 살펴보세요. 규칙 키워드는 무엇을 매칭할지 판단하고, 행 끝의 정책은 어떻게 처리할지 정합니다. 두 역할을 혼동하지 마세요.

규칙 유형매칭 대상확인할 사항
DOMAIN전체 도메인 이름입니다.특정 호스트 이름 하나만 매칭하려는 것인지 확인하세요.
DOMAIN-SUFFIX도메인 자체와 하위 도메인입니다.접미사 범위가 예상보다 넓지 않은지 확인하세요.
DOMAIN-KEYWORD도메인에 포함된 키워드입니다.이름이 비슷하지만 용도가 다른 도메인까지 매칭되는지 확인하세요.
IP-CIDR / IP-CIDR6IPv4 / IPv6 주소 범위입니다.주소 범위와 마스크, 도메인 확인이 필요한지 점검하세요.
GEOIP주소 데이터베이스의 지역 분류입니다.데이터베이스의 분류가 서비스의 실제 용도나 소속을 뜻하는 것은 아닙니다.
FINAL앞선 규칙에 매칭되지 않았을 때 적용되는 최종 처리입니다.기본 정책이 예상한 대로 설정되어 있는지 확인하세요.

설정 방법: 범위가 명확한 규칙을 범위가 넓은 규칙보다 앞에 두고, FINAL을 최종 기본 처리로 지정하세요. 아래는 규칙 문법 예시일 뿐입니다. example.com은 설명용 도메인이며 일상적으로 바로 적용할 수 있는 완성된 설정이 아닙니다. PROXY는 프록시 정책, DIRECT는 직접 연결, REJECT는 매칭된 연결 거부를 뜻합니다. 설정에서 사용자 지정 정책 이름을 참조한다면 해당 정책이 실제로 존재하는지도 확인하세요.

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN,blocked.example.com,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

주의사항: 하나의 대상이 여러 도메인과 주소를 사용할 수 있으므로 대표 도메인만 수정해도 모든 연결에 적용되지 않을 수 있습니다. 규칙을 확인할 때는 연결 기록을 함께 살펴 실제 요청과 적용된 정책을 확인하세요. Config 파일에는 DNS나 정책 그룹 등 다른 내용도 포함될 수 있습니다. 원격 설정을 업데이트한 뒤에는 로컬에서 수정한 내용이 유지됐는지 다시 확인하고, 중요한 변경 사항은 먼저 백업하세요.

구독 및 서버: 연결 정보와 규칙 설정 구분

기능 및 위치: Home의 서버 항목에는 연결 주소, 포트, 인증 정보, 프로토콜 매개변수를 저장합니다. Subscribe에서는 기존 구독 주소를 관리하고 업데이트합니다. Config는 규칙 및 관련 설정을 담당합니다. 서버 목록을 가져왔다고 규칙 라우팅까지 설정된 것은 아니며, 규칙 파일을 활성화했다고 연결 가능한 서버가 준비된 것도 아닙니다.

설정 방법: 기존 구독이 있다면 서비스 제공업체에서 링크를 받아 추가 메뉴에서 Subscribe를 선택하고, 링크를 입력해 저장한 뒤 업데이트하세요. 직접 추가하려면 Add Server로 이동해 원본 정보와 일치하는 프로토콜을 선택하고 주소, 포트, 인증 항목을 확인하세요. Shadowsocks, VMess, VLESS, Trojan, WireGuard, Hysteria2 등은 프로토콜마다 필요한 매개변수가 다릅니다. 한 프로토콜의 항목을 다른 프로토콜에 그대로 적용하지 마세요.

정보를 QR 코드나 클립보드로 받았다면 해당 가져오기 메뉴를 사용할 수 있습니다. 가져온 뒤에도 항목을 열어 프로토콜과 서버 주소를 확인하세요. 구독이 여러 개라면 용도에 따라 알아보기 쉽게 이름과 그룹을 정리한 다음 Connectivity Test로 동일한 조건에서 결과를 비교하세요. 정렬은 목록을 정리하는 방법일 뿐입니다. 테스트 한 번만으로 나머지 항목을 삭제하지 마세요.

주의사항: 구독을 업데이트하면 서버가 추가·삭제되거나 교체될 수 있으며, 구독 항목을 직접 수정한 내용도 다음 업데이트에서 바뀔 수 있습니다. 삭제하기 전에 단일 항목을 지우는 것인지 구독 그룹 전체를 삭제하는 것인지 확인하세요. 구독 주소에는 접근 정보가 포함되는 경우가 많으므로 로그나 스크린샷을 공유하기 전에 가리세요. 자세한 절차는 Subscribe 관리와 QR 코드 및 클립보드에서 가져오기를 참고하세요.

On Demand: 조건에 따라 연결 시작

기능: On Demand는 설정한 조건에 따라 연결을 시작하도록 합니다. 연결을 언제 시도할지 정하는 기능이며, 연결 후 트래픽을 어떻게 처리할지 정하는 Global Routing과는 역할이 다릅니다. On Demand가 서버 매개변수를 자동으로 채워 주거나 모든 네트워크 환경에서 서버에 연결되도록 보장하지는 않습니다.

위치 및 설정 방법: Settings에서 On Demand 관련 옵션을 찾아 앱에 표시되는 조건에 맞게 설정하세요. 먼저 수동 연결이 정상 작동하는지 확인한 뒤 자동 연결을 활성화하세요. 네트워크 조건별로 다르게 동작하도록 설정할 때는 항목을 하나씩 점검하고, 처음부터 여러 조건을 동시에 바꾸지 마세요. 설정 후에는 연결이 시작되어야 하는 네트워크와 시작되면 안 되는 네트워크에서 각각 확인하세요.

주의사항: Wi-Fi와 셀룰러 네트워크를 전환하면 시스템이 네트워크 경로를 다시 설정하므로 잠시 연결이 끊겼다가 복구될 수 있습니다. 이것만으로 설정 오류라고 판단하지 마세요. 연결을 수동으로 끈 뒤에도 다시 연결된다면 On Demand가 활성화되어 있는지 먼저 확인하세요. 문제를 점검할 때는 재현 가능한 수동 테스트를 위해 조건을 잠시 비활성화할 수 있습니다. 점검이 끝나면 필요한 설정을 복원하세요.

Data: 트래픽 및 연결 기록 확인

기능 및 위치: Data에서는 앱이 제공하는 트래픽 통계와 관련 연결 정보를 확인할 수 있습니다. Data를 열고 먼저 통계 범위, 연결 방향, 기록 내용을 확인한 뒤 어떤 요청이 발생하는지 판단하세요. 통계는 클라이언트가 관찰한 네트워크 활동을 보여 주며 서비스 제공업체의 청구 내역은 아닙니다.

사용 방법: 특정 앱이나 페이지를 점검할 때는 현재 통계 상태를 기록한 뒤 대상 작업 하나만 수행하고 Data로 돌아와 변화를 확인하세요. 연결 세부 정보가 표시된다면 대상 주소와 처리 정책도 확인해 요청이 예상대로 처리됐는지 점검하세요. 기록을 지우거나 통계를 초기화하기 전에는 필요한 정보를 저장하고, 버튼이 실제로 영향을 미치는 범위를 확인하세요.

주의사항: 웹페이지 캐시, 백그라운드 새로 고침, 연결 재사용, 다른 앱의 트래픽이 관찰 결과에 영향을 줄 수 있습니다. 트래픽이 늘었다는 사실만으로 데이터가 해당 통계 경로를 지났다는 것 이상을 입증할 수는 없으며, 대상 콘텐츠가 정상적으로 로드됐다는 뜻도 아닙니다. 클라이언트 통계와 서비스 제공업체의 과금 기준은 다를 수 있으므로 남은 사용량은 제공업체 기록을 기준으로 확인하세요. 연결 기록에 방문 도메인이 포함될 수 있으니 내보낼 때 개인정보로 취급하세요.

Settings: 용도에 맞게 자주 쓰는 항목 조정

Settings에서는 테스트, 시스템 연동 및 일부 네트워크 동작을 관리합니다. 먼저 정상 작동하는 설정을 유지하고, 문제가 확인된 경우에만 관련 항목을 조정하세요. 일부 매개변수는 현재 Config에서 제공될 수도 있습니다. 따라서 Settings에서 값을 변경했더라도 현재 연결에 실제로 적용되는지 Config와 연결 기록을 함께 확인해야 합니다.

DNS: 도메인 확인 경로 점검

기능 및 위치: DNS는 도메인 이름을 주소로 변환합니다. 관련 항목은 Settings와 현재 Config의 DNS 설정에서 확인할 수 있습니다. DNS는 프록시 서버 주소나 TLS 이름 검증과 관련이 있지만 서로 다른 매개변수입니다. 이름이 비슷하다는 이유로 해당 항목에 같은 값을 입력하지 마세요.

설정 방법 및 주의사항: 먼저 현재 DNS 설정을 기록하고, DNS 요청이 어떤 경로를 이용하는지와 설정에 관련 규칙이 지정되어 있는지 확인하세요. 도메인으로는 접속할 수 없지만 주소로는 연결되는 경우에 DNS 확인 결과를 점검하세요. 한 번에 하나만 변경하고 다시 테스트하세요. 여러 DNS 옵션을 무작정 추가하면 원인을 찾기 어려워지고, 반드시 더 빨라지는 것도 아닙니다. TLS 검증에 실패하면 DNS만 탓하지 말고 서버 이름, 인증서, 기기 시간을 함께 확인하세요.

Test Method: Connectivity Test 비교 조건 통일

기능 및 위치: Settings의 Test Method는 연결 테스트에 사용할 방법을 결정합니다. Home에서 Connectivity Test를 실행할 때 선택한 방법을 고려해 결과를 해석하세요. 테스트 방법마다 측정하는 단계가 다르므로 결과를 같은 기준으로 직접 비교하면 안 됩니다.

설정 방법 및 주의사항: 테스트 방법을 먼저 선택하고, 해당 방법에 테스트 대상이나 시간 제한 옵션이 있다면 그 값도 기록하세요. 로컬 네트워크와 테스트 조건을 동일하게 유지한 상태에서 서버를 비교하세요. 테스트 성공이 모든 대상에 접속할 수 있다는 뜻은 아니며, 지연 시간이 짧다고 지속적인 전송 속도가 더 빠른 것도 아닙니다. 시간 초과가 발생하면 로컬 네트워크, 서버 매개변수, 테스트 대상을 추가로 확인하세요. 자세한 내용은 지연 시간 테스트 및 정렬을 참고하세요.

Today Widget: 시스템에서 빠른 실행 메뉴 사용

기능 및 위치: Today Widget은 시스템 구성 요소와 연동되는 메뉴입니다. 먼저 Settings에서 앱이 제공하는 옵션을 확인한 다음, 기기에서 지원하는 시스템 구성 요소 영역에서 추가할 수 있는 항목을 찾아보세요. 추가 가능 여부와 표시 위치, 조작 방식은 현재 시스템과 앱에 실제로 표시되는 내용을 기준으로 확인하세요.

설정 방법 및 주의사항: 먼저 앱에서 연결 상태와 서버 선택이 올바른지 확인한 뒤 사용할 수 있는 위젯을 추가하고 동작을 테스트하세요. 위젯은 앱에 들어가는 단계를 줄여 주지만 Config나 서버 관리를 대신하지는 않습니다. 위젯에 표시된 상태가 앱과 다르면 앱을 열어 실제 연결 상태를 확인하고 시스템 위젯을 새로 고쳐야 하는지 살펴보세요.

iCloud: 동기화, 복구, 앱 구매 구분

기능 및 위치: iCloud 관련 기능은 앱에서 지원하는 데이터를 동기화하거나 복구합니다. 메뉴 위치는 Settings에 실제 표시되는 내용을 기준으로 확인하세요. iCloud 기능과 App Store의 구입 항목 기록은 서로 다른 역할을 합니다. 앱을 다시 받았다고 해서 서버 항목과 설정 파일까지 함께 복원되는 것은 아닙니다.

설정 방법 및 주의사항: 활성화하기 전에 필요한 iCloud 계정으로 기기에 로그인되어 있고 해당 서비스의 iCloud 사용이 허용되어 있는지 확인하세요. 여러 기기에서 사용할 때는 먼저 원래 기기에서 데이터가 저장됐는지 확인한 뒤 다른 기기에서 동기화 범위와 결과를 점검하세요. 두 기기에서 동시에 많은 항목을 삭제하거나 이름을 바꾸지 마세요. 중요한 설정은 별도로 복구 가능한 백업을 보관하세요. 동기화는 모든 변경 내역을 저장하는 과거 버전 백업과 다릅니다. 구독 인증 정보도 민감한 데이터이므로 계정 및 백업 관리에 유의하세요.

Diagnostics: 한 번 재현해 문제 범위 좁히기

기능 및 위치: Diagnostics에서는 문제를 점검하는 데 필요한 진단 정보를 수집하거나 확인할 수 있습니다. Settings에서 관련 메뉴를 찾으세요. Home의 Connectivity Test, Data의 연결 기록과 함께 활용할 수 있습니다. Connectivity Test는 연결 조건을 점검하고, 연결 기록은 실제 요청에서 어떤 일이 있었는지 확인하는 데 도움이 됩니다.

사용 방법: 단순히 “작동하지 않음”이라고만 기록하지 말고 “특정 도메인은 실패하지만 다른 대상은 정상”처럼 증상을 구체적으로 정리하세요. 당시의 Global Routing, 선택한 서버, 로컬 네트워크 유형을 기록한 뒤 현재 화면에서 제공하는 필요한 진단 기능만 켜고 문제를 한 번 재현하세요. 문제가 발생하기 전후의 기록과 조작 시각을 맞춰 보고 DNS 확인, 연결, 인증, 규칙 선택 중 어디에 이상이 있는지 우선 점검하세요.

주의사항: 진단 기록에는 서버 주소, 구독 링크, 방문 도메인, 인증 관련 정보가 포함될 수 있습니다. 다른 사람에게 보내기 전에 내용을 확인하고 민감한 정보를 가리세요. 점검이 끝나면 임시로 변경한 로그 설정을 복원해 불필요한 기록이 계속 쌓이지 않도록 하세요. 문제를 해결하려고 서버, DNS, 규칙, 테스트 방법을 한꺼번에 바꾸지 마세요. 정상으로 돌아와도 어떤 변경이 원인이었는지 알 수 없게 됩니다.

자주 쓰는 설정 점검 순서

새로 가져온 설정은 자동화나 동기화를 고려하기 전에 재현 가능한 검증 절차부터 마련하세요. 아래 순서대로 확인하면 서버 연결 가능 여부, 규칙 적용 여부, 시스템의 조건부 연결을 나눠 점검해 서로 영향을 주는 일을 줄일 수 있습니다.

  1. 서버 확인. Home에서 서버 항목을 선택하고 프로토콜, 주소, 포트, 인증 정보를 확인하세요. Test Method를 바꾸지 않은 상태에서 Connectivity Test를 실행합니다.
  2. 모드 확인. Global Routing을 확인하세요. Config를 사용한다면 현재 설정과 대상 규칙을 점검합니다. 모드를 임시로 변경했다면 원래 값을 기록하고 테스트 후 되돌리세요.
  3. 실제 요청 확인. 연결한 뒤 명확한 대상 하나를 열고 Data 또는 사용 가능한 연결 기록에서 관련 변화를 살펴보세요. 특정 대상의 실패와 전체 연결 실패를 구분하세요.
  4. 마지막으로 자동 연결 설정. 수동 연결 테스트가 통과한 뒤 On Demand를 설정하고 네트워크 전환과 예상한 조건에서 각각 동작하는지 확인하세요.
  5. 마무리 및 백업. 구독 이름, 설정 백업, iCloud 동기화 결과를 확인한 뒤 Today Widget 등 빠른 실행 메뉴를 추가하세요.

Shadowrocket은 Apple 플랫폼에서 제공되는 클로즈드 소스 유료 앱이며, App Store에서만 받을 수 있습니다. 시스템 요구 사항과 구매 가능 여부는 App Store 페이지에 표시된 내용을 기준으로 확인하세요. 이 페이지에서는 기능의 범위를 설명하며 연결 서비스를 제공하지 않습니다. 연속된 조작 절차는 사용 안내를, 여러 구독과 서버 관리는 서버 관리 공식 매뉴얼을 참고하세요.