공식 매뉴얼 · 설정 안내

Shadowrocket 기능 및 설정

먼저 요청의 라우팅 방식을 정한 다음 연결, DNS, 진단 옵션을 조정하세요.

이 페이지는 iPhone / iPad 사용을 중심으로 설명합니다. 각 항목에서 기능, 메뉴 위치, 설정 방법과 단일 스위치만으로 판단하기 어려운 상황을 차례로 다룹니다. 기기와 앱 업데이트에 따라 화면 구성이 달라질 수 있으므로, 세부 옵션은 현재 앱에 표시되는 내용을 기준으로 확인하세요.

Global Routing

Config, Proxy, Direct: 세 가지 라우팅 모드

Global Routing은 연결이 활성화된 상태에서 요청을 어떤 방식으로 처리할지 결정합니다. 서버 목록이 아니며, 누락된 연결 정보를 자동으로 채워 주지도 않습니다.

메뉴 위치 및 설정: Home에서 Global Routing을 열고 Config, Proxy, Direct 중 하나를 선택한 다음 돌아와 현재 SERVER와 연결 스위치를 확인합니다. 여기서 Config, Proxy, Direct는 각각 해당 영어 옵션을 뜻합니다. Config 모드는 파일 관리용 하단 Config 페이지와 관련이 있지만, 두 항목은 같은 메뉴가 아닙니다.

모드처리 방식사용 상황확인할 항목
Config · 구성 규칙현재 활성화된 구성의 규칙과 정책에 따라 요청을 처리합니다.웹사이트, 도메인 또는 주소별로 요청을 나눠 처리할 때 사용합니다.구성이 활성화되어 있는지, 규칙 순서와 최종 정책이 올바른지 확인합니다.
Proxy · 프록시클라이언트가 가로챈 요청을 현재 프록시 정책에 따라 처리합니다.선택한 서버가 특정 요청을 처리할 수 있는지 임시로 확인할 때 사용합니다.서버가 사용 가능한지 확인하세요. 테스트 결과만으로 모든 앱의 동작을 판단할 수는 없습니다.
Direct · 직접 연결가로챈 요청을 직접 연결 방식으로 처리합니다.로컬 네트워크를 비교 점검하거나 일시적으로 직접 연결 경로를 사용할 때 적합합니다.모드 선택은 시스템 VPN 연결을 끄는 것과 다릅니다.

권장 순서: 사용할 수 있는 구성이 있다면 먼저 Config를 선택하세요. 특정 대상에 문제가 생기면 Proxy 또는 Direct로 잠시 전환해 같은 네트워크와 같은 대상을 비교합니다. 테스트를 마친 뒤에는 원래 모드로 되돌려 임시 점검 설정이 일상 설정으로 남지 않게 하세요.

주의: Proxy로 사용할 수 없는 인증 정보, 잘못된 포트 또는 연결할 수 없는 서버를 해결할 수는 없습니다. Direct를 선택해도 클라이언트 연결이 중지되는 것은 아닙니다. 연결을 끊으려면 Home의 연결 스위치와 시스템 VPN 상태를 확인하세요. 모드를 바꾼 뒤에도 기존의 장시간 연결에는 이전 경로가 유지될 수 있으므로, 필요하면 대상 앱에서 연결을 새로 설정한 뒤 확인하세요.

Rule / Config

규칙 기반 라우팅: 매칭 조건과 정책

규칙은 “요청이 조건에 맞는가?”를 판단하고, 정책은 “조건에 맞으면 어떻게 처리하는가?”를 정합니다. 두 요소를 함께 알아야 특정 웹사이트가 PROXY 또는 DIRECT로 연결되는 이유를 파악할 수 있습니다.

메뉴 위치 및 설정: Config에서 현재 사용 중인 구성을 찾아 먼저 백업한 뒤, 구성 편집 메뉴에서 규칙을 확인합니다. Home으로 돌아와 Global Routing을 Config로 설정하세요. 파일을 Config 목록에 가져온 것만으로는 해당 파일이 적용 중이라고 볼 수 없습니다. 현재 활성화된 항목도 확인해야 합니다.

자주 쓰는 DOMAIN은 전체 도메인과 매칭하고, DOMAIN-SUFFIX는 도메인 접미사를 기준으로 매칭하며, DOMAIN-KEYWORD는 도메인 안의 키워드를 확인합니다. IP-CIDR과 IP-CIDR6은 IP 주소 대역을 대상으로 하고, GEOIP는 주소의 지역을 지역 데이터베이스와 비교합니다. USER-AGENT는 요청에서 관련 정보를 확인할 수 있어야 하므로 모든 암호화 연결을 식별하는 방법으로 간주해서는 안 됩니다.

키워드확인 내용설정 시 주의사항
DOMAIN전체 도메인명확한 호스트 이름만 처리할 때 적합합니다.
DOMAIN-SUFFIX도메인 접미사와 하위 도메인접미사가 적용되는 범위를 확인해 매칭 범위가 불필요하게 넓어지지 않도록 하세요.
IP-CIDRIPv4 주소 대역대상의 DNS 조회 결과와 규칙 순서에 따라 판단이 달라질 수 있습니다.
FINAL앞선 규칙에 매칭되지 않은 요청마지막에 배치해 기본 처리 방식을 명확히 지정하세요.

DIRECT는 직접 연결, PROXY는 해당 프록시 정책 사용, REJECT는 매칭된 요청 거부를 뜻합니다. 사용자 지정 정책 이름을 사용하는 경우 구성에 실제로 정의된 이름과 일치해야 합니다. 규칙은 일반적으로 순서대로 매칭되므로 구체적인 조건을 범위가 넓은 조건보다 앞에 배치하세요. 규칙 내용을 수정하는 것보다 위치를 옮기는 편이 결과를 더 직접적으로 바꾸는 경우도 있습니다.

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

위 내용은 학습용 최소 규칙 예시입니다. example.com과 하위 도메인은 PROXY로 처리하고, 그 밖의 요청은 FINAL,DIRECT로 처리합니다. 완전한 구성 파일이 아니며 서버 정보도 포함하지 않습니다. 수정한 내용을 저장한 뒤 대상 도메인으로 요청을 다시 보내고 연결 기록에서 매칭 결과를 확인하세요. 브라우저 페이지가 열리는지만으로 판단하지 마세요.

자세한 규칙 작성 방법은 특정 웹사이트를 PROXY로 연결하는 규칙 작성법에서 확인할 수 있습니다. 원격 구성을 수정하기 전에는 업데이트 방식도 고려하세요. 파일을 다시 가져오면 로컬에서 수정한 내용이 덮어써질 수 있습니다.

Subscribe / Add Server

구독 및 서버 관리

서버 항목에는 연결에 필요한 설정값이 저장되고, Subscribe는 기존 항목들을 업데이트하며, Config는 규칙과 관련 설정을 관리합니다. 각 기능의 용도가 다르므로 이름이 비슷하다고 서로 대체해서는 안 됩니다.

사용 전 확인: 구독 또는 서버 정보를 이미 가지고 있어야 합니다. 클라이언트의 일회성 구매는 연결 서비스 이용권과 다릅니다. Shadowrocket을 구매하면 클라이언트 사용 권한을 얻는 것이며, 유효한 연결 정보는 별도로 준비해야 합니다. 이 매뉴얼은 이미 보유한 정보를 가져오고 정리해 사용하는 방법만 안내합니다.

메뉴 위치 및 설정: Home에서 추가 메뉴를 통해 Add Server로 이동합니다. 수동으로 추가할 때는 보유한 정보를 기준으로 Type을 선택한 다음 Address, Port와 프로토콜에 필요한 인증 항목을 입력하세요. Shadowsocks, VMess, VLESS, Trojan은 필요한 항목이 서로 다르므로 Type만 바꾸고 기존 값을 그대로 사용하면 안 됩니다. 전송 방식, TLS, 서버 이름 등 추가 설정도 각각 맞춰 입력하세요.

구독을 가져오려면 Subscribe를 선택하고 본인의 전체 구독 주소를 입력한 뒤 저장하세요. 지원되는 공유 정보는 Scan QR Code 또는 클립보드로 가져올 수도 있습니다. 가져온 뒤에도 Type, 주소, 포트를 확인하세요. 정보가 인식되었다고 해서 연결까지 성공한 것은 아닙니다. 구독 주소에는 접근 정보가 포함될 수 있으므로 공개 스크린샷이나 문의 내용에 붙여 넣지 마세요.

여러 구독은 용도를 알아보기 쉬운 메모로 구분하고, 업데이트 후 항목이 추가되거나 삭제되었는지, 현재 선택한 항목이 남아 있는지 확인하세요. 구독에 포함된 항목은 보통 원격에서 관리되므로 직접 수정한 값이 다음 업데이트에서 바뀔 수 있습니다. 별도로 수정한 내용을 유지해야 한다면 먼저 백업 및 독립 저장 방법을 확인한 다음 편집하세요.

테스트 및 정리: Connectivity Test를 실행하기 전에 Test Method를 확인한 다음 서버 후보를 테스트하세요. 지연 시간은 선택한 방법과 대상에 대한 응답만 보여 줍니다. 처리량을 의미하지 않으며 특정 웹사이트의 사용 가능성을 보장하지도 않습니다. SERVER를 선택한 뒤 실제 요청을 다시 보내세요. 기존 항목을 삭제하기 전에는 현재 구성이나 일상적인 작업에서 더 이상 사용하지 않는지 확인하세요.

QR 코드, 공유 정보, 업데이트와 백업 절차는 구독 및 서버 관리 매뉴얼에서 확인할 수 있습니다. 가져온 목록이 비어 있다면 링크가 완전한지, 기존 구독이 정상인지 먼저 확인하세요. 같은 항목을 여러 번 만들지 마세요.

On Demand

주문형 연결 및 네트워크 전환

On Demand는 연결을 시작하는 조건을 설정하는 기능이지, 웹사이트 요청의 경로를 결정하는 규칙이 아닙니다. 연결이 설정된 뒤 각 요청은 Global Routing과 현재 구성의 영향을 받습니다.

메뉴 위치 및 설정: 앱에서 On Demand 관련 설정을 찾아 현재 활성화 상태와 설정된 조건을 먼저 확인한 뒤, 필요한 항목을 조정하세요. 기기마다 메뉴 위치와 선택 가능한 조건이 다를 수 있으므로 앱에 표시되는 내용을 기준으로 확인해야 합니다. 처음 사용할 때는 Home에서 서버와 구성이 정상 작동하는지 직접 연결해 확인한 다음 주문형 연결을 활성화하세요.

현재 화면에서 네트워크 종류나 Wi-Fi 조건에 따라 동작을 설정할 수 있다면, 먼저 쉽게 확인할 수 있는 조건 하나부터 설정하세요. 저장한 뒤 예상한 네트워크에서 시스템 VPN 상태를 확인하고, 다른 네트워크로 전환해 연결 상태가 설정대로 바뀌는지 확인합니다. 조건을 한꺼번에 여러 개 추가하면 어떤 조건이 연결을 시작했는지 파악하기 어려워집니다.

주의: On Demand가 활성화된 상태에서는 Home에서 직접 연결을 끊어도 조건이 다시 충족되면 재연결될 수 있습니다. 일시적으로 연결을 중지하려면 주문형 설정도 함께 확인하세요. 배터리 절약을 보장하는 기능도 아닙니다. 네트워크 품질, 재연결 빈도, 지속적인 요청이 배터리 사용량에 영향을 주므로 일정 기간 실제 사용 기록을 바탕으로 판단하세요.

Data

트래픽 통계와 확인 범위

Data에서는 클라이언트가 기록한 트래픽 변화를 확인할 수 있습니다. 연결 활동을 파악하는 데 참고할 수 있지만, 네트워크 계정의 사용량을 정산하는 기준은 아닙니다.

메뉴 위치 및 설정: Data를 열고 현재 화면에서 집계하는 대상, 방향, 시간 범위를 먼저 확인하세요. 업로드와 다운로드 변화를 살펴보기 전에 시작 값을 기록합니다. 통계를 초기화해야 한다면 필요한 기록을 먼저 저장한 뒤 현재 화면에서 제공하는 초기화 메뉴를 사용하세요. 문제를 확인하는 도중 통계를 지운 뒤 초기화 전후의 값을 바로 비교하지 마세요.

테스트할 때는 관련 없는 앱의 전면 작업을 종료하고 같은 대상으로 한 번 요청한 다음 Data로 돌아와 변화를 확인하세요. 대상 앱에서 백그라운드 새로고침이 진행 중이거나 미디어 재생 및 동기화 작업이 남아 있다면 트래픽 증가가 방금 연 페이지 때문이라고 단정할 수 없습니다. 트래픽이 표시되어도 데이터 활동이 있었다는 뜻일 뿐, 특정 요청이 예상한 규칙과 매칭되었다는 증거는 아닙니다.

주의: 클라이언트, 시스템의 셀룰러 데이터 통계, 사용 중인 서비스의 사용량 기록은 집계 범위, 기간, 계산 방식이 서로 다를 수 있습니다. 데이터 경로, 프로토콜 오버헤드, 직접 연결 요청의 포함 여부 등이 차이를 만들 수 있습니다. 잔여 사용량은 해당 계정의 기록을 기준으로 확인하고, 라우팅 문제를 점검할 때는 Data와 연결 기록을 함께 살펴보세요.

Settings

DNS, 테스트 및 동기화 설정

Settings의 옵션은 서로 다른 단계에 영향을 줍니다. 정상 작동하는 설정을 기준으로 보존하고, 특정 대상에 문제가 생겼다고 DNS, 테스트 방식, 모든 연결 정보를 한꺼번에 바꾸지 마세요.

DNS: 도메인이 조회되는 방식 확인

기능 및 메뉴 위치: DNS는 도메인 이름을 연결에 필요한 주소로 변환합니다. 관련 옵션이 Settings와 현재 Config에 나뉘어 있을 수 있으므로 문제를 점검할 때 두 곳을 모두 확인하세요. 먼저 구성에 DNS 관련 동작이 정의되어 있는지 살펴본 뒤 실제 적용되는 설정 중 무엇을 바꿀지 판단하세요.

설정 방법: 현재 DNS 설정을 기록한 다음 네트워크와 구성에 맞춰 옵션 하나를 조정하고 연결을 새로 설정해 같은 도메인을 다시 테스트하세요. IP 주소로는 접속되지만 도메인으로는 실패한다면 DNS를 점검할 필요가 있습니다. 그렇다고 DNS만 문제라고 단정할 수는 없습니다. TLS, 대상 서비스 상태, 규칙 매칭도 결과에 영향을 줄 수 있습니다.

주의: 도메인 조회 결과가 주소 기반 규칙의 매칭에도 사용될 수 있습니다. DNS 방식을 바꾼 뒤에는 대상에서 반환된 주소와 적용된 정책을 확인하세요. 도메인이 조회되었다고 해서 요청이 반드시 예상한 경로로 라우팅되는 것은 아닙니다. 캐시나 기존의 장시간 연결 때문에 변경 사항이 바로 드러나지 않을 수 있으므로 새 연결로 확인하세요.

Test Method: 테스트 결과를 일관되게 비교하기

기능 및 메뉴 위치: Test Method는 Connectivity Test에서 사용하는 테스트 방식이며 Settings에서 확인할 수 있습니다. 방식마다 대상이나 연결 단계가 다를 수 있으므로 같은 서버라도 결과가 다르게 나올 수 있습니다.

설정 방법: 서버를 비교할 때는 테스트 방식을 고정하세요. 현재 옵션에서 테스트 대상을 지정할 수 있다면 대상도 동일하게 유지해야 합니다. 같은 네트워크에서 여러 번 테스트하고 실제 웹사이트 요청 결과와 함께 안정성을 판단하세요. 한 번의 시간 초과만으로 모든 연결이 실패했다고 단정하거나, 가장 낮은 숫자 하나만 보고 장기간 서버를 고정하지 마세요.

Today Widget: 빠른 조작 및 상태 확인

기능 및 메뉴 위치: Today Widget은 시스템에서 제공하는 해당 위젯 영역에서 사용할 수 있으며 관련 설정은 Settings에서 확인할 수 있습니다. 위젯을 추가할 수 있는지, 어떤 조작 항목을 표시할 수 있는지는 기기의 시스템과 앱 지원 여부에 따라 달라집니다. 추가한 뒤 표시 내용이 예상한 대로인지 확인하세요.

설정 방법 및 주의사항: 빠른 조작이 필요하면 시스템의 위젯 관리 방식에 따라 위젯을 추가하고 Home의 상태와 비교하세요. 위젯 표시가 시스템 연결 상태보다 늦게 갱신될 수 있으므로 한 번 표시된 내용만으로 연결이 설정되었다고 판단하지 마세요. 조작에 문제가 있으면 앱으로 돌아가 상태를 확인한 다음 위젯 표시를 점검하세요.

iCloud: 동기화와 백업 확인은 별개

기능 및 메뉴 위치: iCloud 관련 동기화 옵션은 지원되는 환경에서 앱 데이터를 저장하거나 동기화하는 데 사용됩니다. 먼저 시스템에서 iCloud를 사용할 수 있는지와 앱 내 관련 옵션을 확인하고, 현재 화면에 표시된 동기화 범위를 살펴보세요. 구독, 구성, 기록, 인증 정보가 모두 함께 동기화된다고 가정하지 마세요.

설정 방법 및 주의사항: 처음 활성화하거나 기기를 바꾸기 전에 별도 백업을 보관하고, 다른 기기에서 항목별로 확인하세요. 두 기기에서 같은 내용을 동시에 편집할 때는 덮어쓰기나 충돌에 주의해야 합니다. 구독과 구성에는 민감한 연결 정보가 포함될 수 있으므로 백업, 동기화, 내보내기 전에 저장 위치와 접근 권한을 확인하세요.

Diagnostics

진단 설정 및 문제 점검 순서

Diagnostics는 문제 해결에 필요한 단서를 수집하는 기능입니다. 효과적인 진단은 모든 기록을 켜 둔 채 계속 사용하는 것이 아니라, 재현 가능한 요청 한 번으로 구체적인 실패 지점을 파악하는 것입니다.

메뉴 위치 및 설정: Settings에서 Diagnostics 또는 관련 진단 메뉴를 찾아 현재 도구의 설명을 읽고 이번 점검에 필요한 기록만 활성화하세요. 네트워크 환경, Global Routing, 현재 SERVER, 구성 이름을 먼저 기록한 다음 문제를 한 번 재현합니다. 조건을 여러 차례 바꾸면 단서가 뒤섞일 수 있습니다.

  1. 먼저 연결 단계를 확인합니다. Home의 연결 스위치와 시스템 VPN 상태를 확인하고, 현재 네트워크에서 기본 요청을 처리할 수 있는지 점검하세요.
  2. 다음은 서버를 확인합니다. 현재 선택된 항목과 기존 인증 정보를 확인한 뒤, 고정한 Test Method로 Connectivity Test를 실행하세요.
  3. DNS와 규칙을 확인합니다. 같은 대상을 기준으로 도메인 조회 결과, 매칭 조건, 최종 정책을 확인하세요. 필요한 경우 모드를 잠시 전환해 비교합니다.
  4. 마지막으로 대상 앱을 확인합니다. 연결을 새로 설정해 다시 테스트하고, Data의 변화는 보조 단서로 활용하세요. 이를 성공 여부의 결론으로 삼아서는 안 됩니다.

주의: “테스트 응답이 있음”, “시스템에 연결됨으로 표시됨”, “대상 웹페이지가 열림”은 각각 서로 다른 상태를 나타내며 서로를 대신할 수 없습니다. 한 웹사이트에서만 문제가 발생한다면 먼저 해당 도메인과 관련 규칙을 확인하세요. 모든 요청에 문제가 있다면 공통으로 사용하는 서버, 네트워크, 구성을 점검합니다. 확인이 끝나면 원래 설정으로 되돌리고 더 이상 필요하지 않은 상세 진단 기록은 끄세요.

문제 해결 정보를 공유하기 전에 구독 주소, 비밀번호, 인증 정보와 불필요한 접속 기록을 가리고, 문제를 파악하는 데 필요한 오류 현상과 조작 단계만 남기세요. 상황별 안내는 자주 묻는 질문에서 확인할 수 있습니다. 가져오기부터 첫 연결까지 순서대로 진행하려면 사용 설명서를 참고하세요.