공식 매뉴얼 · 기능 안내

Shadowrocket 기능 및 주요 설정

먼저 Global Routing을 확인하고, 이어서 Config와 서버를 점검하세요. 이 페이지에서는 자주 쓰는 기능을 기능 설명, 메뉴 위치, 설정 방법, 유의 사항 순으로 안내합니다. iPhone과 iPad의 일상적인 설정과 문제 해결에 활용할 수 있습니다.

01 · 연결 모드

Global Routing: 먼저 라우팅 방식을 선택하세요

Global Routing은 트래픽 전체를 처리할 방식을 정합니다. Config, Proxy, Direct는 각각 규칙 적용, 프록시, 직접 연결을 뜻하며 서로 다른 서버 세 개를 가리키는 것이 아닙니다.

화면 옵션 기능 사용 상황 먼저 확인할 항목
Config(구성) 현재 Config의 규칙과 정책에 따라 요청을 처리합니다. 도메인, 주소 또는 다른 조건에 따라 요청을 구분해야 할 때 적용 중인 Config, 규칙 순서, 최종 정책
Proxy(프록시) 클라이언트가 처리하는 트래픽을 프록시 경로로 통일합니다. 선택한 서버와 프록시 경로가 작동하는지 임시로 확인할 때 Home에서 선택한 서버, 연결 매개변수, 서비스 상태
Direct(직접 연결) 클라이언트가 처리하는 트래픽을 직접 연결 경로로 통일합니다. 현재 네트워크에서 직접 접속할 수 있는지 임시로 확인할 때 현재 네트워크에서 같은 대상에 접속할 수 있는지

모드 위치와 선택 방법

Home에서 Global Routing을 찾아 원하는 모드를 선택한 다음, 돌아와 현재 표시된 값을 확인하세요. 규칙에 따라 접속하려면 Config를 사용합니다. 서버 연결이 가능한지 확인할 때는 잠시 Proxy로 전환할 수 있고, 현재 네트워크와 비교하려면 같은 대상을 Direct로 테스트할 수 있습니다. 문제 해결이 끝나면 평소 사용하려던 모드로 되돌려 임시 테스트 설정이 남지 않도록 하세요.

Global Routing과 연결 스위치는 서로 다른 설정입니다. Global Routing은 트래픽 처리 방식을 정하고, 연결 스위치는 클라이언트의 연결 상태를 제어합니다. Proxy를 선택해도 서버가 반드시 작동하는 것은 아니며, Config를 선택해도 모든 규칙이 올바르다는 뜻은 아닙니다. Proxy에서는 접속되지만 Config로 돌아온 뒤 실패한다면 규칙과 정책을 우선 확인하세요. 다만 이는 원인을 좁히기 위한 단서일 뿐, 한 번의 테스트 결과만으로 원인을 단정할 수는 없습니다.

02 · 매칭 및 정책

규칙 기반 트래픽 분기: 먼저 매칭하고 경로를 결정합니다

규칙은 어떤 요청에 어떤 정책을 적용할지 지정합니다. Config에서 현재 적용 중인 설정을 확인한 다음 Global Routing이 Config로 선택되어 있는지 확인하세요.

규칙 유형은 매칭 대상을 지정합니다

DOMAIN은 전체 도메인을 매칭하고, DOMAIN-SUFFIX는 도메인 접미사와 하위 도메인을 매칭하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드를 기준으로 매칭합니다. IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 범위를 지정합니다. GEOIP은 IP 지리 데이터베이스를 기준으로 매칭합니다.

USER-AGENT는 매칭 가능한 User-Agent 정보를 대상으로 합니다. 모든 요청에서 이 조건을 사용할 수 있는 것은 아닙니다. 이를 모든 앱을 식별하는 범용 스위치로 이해하지 마세요. 사용할 수 있는 정보는 요청 유형과 Config에 따라 다릅니다.

정책은 요청 처리 방식을 지정합니다

PROXY는 프록시 정책, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. Config에서 사용자 지정 정책 그룹을 참조할 수도 있습니다. 이 경우 규칙 끝에 표시된 이름만 보지 말고 해당 그룹에서 실제로 어떤 정책을 선택했는지 확인하세요.

규칙은 일반적으로 위에서 아래 순서로 매칭되므로 구체적인 조건을 포괄적인 조건보다 앞에 배치하세요. 앞선 규칙에 매칭되지 않았을 때 적용되는 기본 정책이 FINAL입니다. 이를 거부로 설정하거나 사용할 수 없는 경로를 지정하면 별도 규칙이 없는 많은 요청에 영향을 줄 수 있습니다.

설정 및 확인 방법

먼저 Config에서 적용 중인 파일을 확인하고, 수정 전에 복원할 수 있도록 사본을 보관하세요. 규칙을 추가할 때는 유형, 매칭 값, 정책을 함께 점검합니다. 저장한 뒤 대상 요청을 다시 보내고 로그에서 실제로 적용된 규칙을 확인하세요. 한 번에 규칙 하나만 조정해 DNS, 서버, 최종 정책을 동시에 바꾸지 않도록 합니다. 오른쪽 예시는 문법 설명용이며, 예시 도메인은 서버 주소가 아닙니다. PROXY를 지정해도 서버가 자동으로 제공되지는 않습니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
FINAL 앞선 규칙에 매칭되지 않을 때 적용됩니다. 이 구문은 완전한 Config를 대체하지 않습니다.

규칙 키워드 및 정책 용어 보기 ›

03 · 연결 정보

Subscribe 및 서버 관리

Subscribe는 이미 보유한 서버 항목을 가져오고 업데이트하는 데 사용합니다. 개별 서버 항목에는 연결에 필요한 매개변수가 저장됩니다. 가져오기에 성공해도 정보가 목록에 추가된 것일 뿐, 원격 연결까지 확인된 것은 아닙니다.

Add Server: 매개변수 직접 확인

Home의 추가 메뉴에서 Add Server를 연 다음, 보유한 정보와 일치하는 프로토콜 유형을 선택하고 주소, 포트, 해당 인증 항목을 입력하세요. Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2는 입력 항목과 전송 조건이 서로 다릅니다. 유형 이름만 바꾸고 나머지 매개변수를 그대로 두면 안 됩니다.

정보가 QR 코드로 제공된 경우 Scan QR Code로 가져온 뒤 각 항목을 확인할 수 있습니다. 특히 서버 주소, 인증 정보, TLS, 서버 이름이 원본 정보와 일치하는지 확인하세요. 가져오기 기능은 서비스가 여전히 유효한지 판단하지 않습니다.

Subscribe: 기존 목록 업데이트

Subscribe를 추가하려면 해당 추가 화면에서 Subscribe를 선택하고, 이미 보유한 전체 구독 주소를 입력해 저장한 다음 업데이트를 실행하세요. 이후 Home으로 돌아가 그룹에 항목이 표시되는지 확인하고 사용할 서버를 직접 선택합니다. 목록 업데이트와 서버 선택은 별개의 작업이므로, 업데이트만 한 뒤 연결 상태를 판단하지 마세요.

구독 주소에는 접속 자격 증명이 포함될 수 있으므로 민감한 정보로 취급하세요. 목록이 비어 있다면 먼저 주소가 빠짐없이 복사되었는지 확인하고 Subscribe 상태와 응답 형식을 점검하세요. 같은 주소를 반복해서 추가하지 마세요. 업데이트로 항목 이름이나 목록 내용이 바뀔 수 있으므로 중요한 수동 수정 사항은 미리 기록해 두세요.

Connectivity Test 결과가 실제 사용 결과를 뜻하지는 않습니다

Home의 서버 목록에서 Connectivity Test를 실행하면 선택한 테스트 방식에 따른 현재 항목의 응답을 확인하는 데 도움이 됩니다. 테스트 전에 Settings의 Test Method를 확인하세요. 방식마다 측정 대상이 다르므로 결과값을 직접 비교하기는 어렵습니다. 지연 시간이 짧아도 모든 대상에 접속할 수 있는 것은 아니며, 지속적인 전송 속도가 더 빠르다는 뜻도 아닙니다. 서버를 선택한 뒤 실제로 접속하려는 대상으로 다시 확인하세요.

서버를 정리할 때는 용도를 쉽게 알아볼 수 있는 이름을 사용하고 원본 매개변수를 안전하게 백업하세요. 항목을 삭제하기 전에 직접 추가한 항목인지 Subscribe로 생성된 항목인지 확인합니다. Subscribe에서 생성된 항목은 이후 업데이트 결과를 Subscribe 관리 방식에 따라 확인하세요. Config 파일과 서버 Subscribe를 혼동하지 마세요. Config에는 규칙과 기타 설정이 포함될 수 있으며, Subscribe는 주로 서버 정보를 업데이트하는 데 사용됩니다.

04 · 연결 조건

On Demand: 조건에 따라 연결 동작 설정

기능:On Demand는 설정한 조건에 따라 연결 동작을 실행합니다. 수동 연결이 정상적으로 작동하는 것을 확인한 뒤, 네트워크 환경이 바뀔 때 원하는 방식으로 연결을 처리하고 싶을 때 유용합니다. 서버 사용 가능성을 보장하거나 잘못된 인증 정보와 규칙을 수정해 주는 기능은 아닙니다.

위치:Settings에서 On Demand 관련 메뉴를 찾아 전체 스위치와 설정 가능한 조건을 확인하세요. 구체적인 옵션은 앱 화면에 표시되는 내용을 기준으로 합니다. 시스템 VPN 설정을 처음 사용하는 경우 시스템의 권한 안내를 읽으세요. 시스템 수준의 연결 조건과 앱 내 설정을 함께 확인해야 합니다.

설정 방법:먼저 현재 상태를 기록하고 필요한 네트워크 조건만 추가한 다음, 각 조건이 어떤 연결 동작을 실행하는지 확인하세요. 설정 후 조건에 맞는 네트워크와 맞지 않는 네트워크에서 각각 테스트하고 연결 상태가 예상대로인지 살펴봅니다. 조건에 Wi-Fi 네트워크 이름이 포함된다면 철자를 확인하세요. 이름이 일치하지 않아 설정이 적용되지 않은 것으로 오해할 수 있습니다.

유의 사항:On Demand를 켜면 수동으로 연결을 끊어도 기존 조건에 따라 다시 연결될 수 있습니다. 연결을 끊은 뒤 다시 연결된다면 먼저 On Demand를 확인하고, 이어서 시스템 VPN 설정을 점검하세요. Config 전체를 바로 삭제하지 마세요. 일시적으로 비활성화할 때는 기존 스위치 상태를 기록하고, 문제 해결 후 필요에 따라 복원하세요. 네트워크 전환 중에만 문제가 발생한다면 전환 전후의 조건과 연결 상태를 각각 기록하세요.

05 · 사용량 확인

Data: 클라이언트 트래픽 기록 확인

Data에서는 클라이언트에 기록된 트래픽 변화를 확인할 수 있습니다. 데이터가 전송되었는지 파악하는 데 도움이 되지만, 이것만으로 대상 요청이 성공적으로 완료되었다고 단정할 수는 없습니다.

확인 위치와 읽는 방법

Data를 열고 통계 대상, 기간, 과거 누적 데이터 포함 여부를 먼저 확인한 뒤 업로드와 다운로드 항목을 살펴보세요. 특정 작업의 변화를 확인하려면 현재 값을 기록하고 명확한 작업을 한 번 수행한 뒤 다시 비교하세요. 누적 총량이 큰지만 보는 것보다 변화량을 확인하는 편이 좋습니다.

화면에서 통계 초기화를 제공한다면 실행 전에 기록을 보존해야 하는지 확인하세요. 문제를 확인할 때는 자주 초기화해 서로 다른 테스트를 섞기보다 테스트 전후에 얼마나 증가했는지 기록하는 편이 좋습니다.

다른 요금 기록과 구분하기

Data는 클라이언트 관점의 기록이며, 이동통신사나 이미 이용 중인 서비스의 과금 데이터와 같지 않습니다. 집계 범위, 프로토콜 오버헤드, 백그라운드 요청, 누적 기간에 따라 차이가 생길 수 있습니다. 두 총량이 다르다는 이유만으로 과금 오류라고 단정하지 마세요.

트래픽 증가는 다른 백그라운드 활동 때문일 수 있습니다. 트래픽이 늘지 않는다면 요청이 현재 경로를 거치지 않았거나, 연결이 설정되지 않았거나, 확인 중인 범위가 다를 수 있습니다. Global Routing, 연결 상태, 요청 기록을 함께 확인하세요.

06 · 자주 쓰는 설정

Settings: 문제에 맞는 항목을 조정하세요

아래 항목은 Settings와 관련 메뉴에서 확인할 수 있습니다. Config 파일에도 연결에 영향을 주는 매개변수가 포함될 수 있으므로 설정을 바꾸기 전에 현재 Config도 확인하세요. 서로 다른 위치의 설정을 같은 항목으로 혼동하지 않도록 합니다.

DNS: 도메인 확인 경로

기능 및 위치:DNS는 도메인을 연결에 필요한 주소로 변환합니다. Settings의 DNS 관련 설정과 현재 Config에 해석 매개변수가 지정되어 있는지 함께 확인하세요. 실제 적용 방식은 현재 앱 설정을 기준으로 합니다.

설정 방법 및 유의 사항:먼저 기존 설정을 보관한 다음 현재 네트워크 환경에 맞춰 DNS 방식을 조정하세요. 일부 도메인에 접속할 수 없다면 DNS 확인 실패인지, 주소는 확인되지만 연결에 실패한 것인지 구분합니다. DNS 옵션을 한꺼번에 여러 개 바꾸지 마세요. DNS만 변경해도 만료된 인증 정보나 사용할 수 없는 서버는 복구되지 않습니다. 잘못된 사용자 지정 값은 문제 범위를 더 넓힐 수 있습니다.

Test Method: 테스트 방식

기능 및 위치:Settings의 Test Method에서 관련 연결 테스트에 사용할 방식을 선택합니다. 이 설정은 테스트 절차를 바꾸며 서버 자체의 연결 상태를 개선하지는 않습니다.

설정 방법 및 유의 사항:현재 문제 해결 목적에 맞춰 화면에서 제공하는 방식을 선택한 다음 Home으로 돌아가 Connectivity Test를 실행하세요. 결과를 기록할 때 테스트 방식도 함께 적습니다. 서버를 비교할 때는 테스트 방식과 네트워크 환경을 동일하게 유지하세요. 시간 초과는 해당 조건에서 테스트 응답을 받지 못했다는 뜻일 뿐, 모든 실제 요청이 실패한다고 단정할 수는 없습니다.

Today Widget: 빠른 확인 및 조작

기능 및 위치:Today Widget은 시스템에서 지원하는 위젯 메뉴에서 사용할 수 있으며 관련 옵션은 Settings에서 확인합니다. 표시 여부와 사용할 수 있는 항목은 현재 시스템의 지원 여부와 시스템에서 위젯을 추가했는지에 따라 달라집니다.

설정 방법 및 유의 사항:먼저 앱에서 서버를 선택하고 연결을 확인한 다음, 시스템의 위젯 편집 메뉴에서 사용 가능한 위젯을 추가하세요. 위젯 상태가 바로 바뀌지 않으면 앱을 열어 실제 연결 상태를 확인하세요. 위젯에 표시된 문구만으로 연결 결과를 판단하지 마세요. 빠른 실행 메뉴는 최초 권한 승인을 대신하지 않으며 누락된 서버 매개변수를 채워 주지도 않습니다.

iCloud: 관련 정보 동기화

기능 및 위치:iCloud 관련 메뉴에서는 앱이 지원하는 범위 내에서 동기화하거나 클라우드 정보를 관리할 수 있습니다. 먼저 Settings의 해당 옵션을 확인한 다음 시스템의 iCloud 계정과 권한 상태를 확인하세요. 정보 유형별로 따로 점검해야 합니다.

설정 방법 및 유의 사항:로컬 백업을 먼저 보관한 뒤 필요한 항목을 켜고, 동기화가 완료되면 다른 기기에서 각 정보가 제대로 표시되는지 확인하세요. 서버, Config, 통계, 모든 스위치가 전부 동기화된다고 가정하지 마세요. 클라우드 정보 동기화와 App Store에서 구매한 항목의 복원은 별개이므로 각각 확인해야 합니다.

Diagnostics: 단서를 모은 뒤 Config를 수정하세요

기능 및 위치:Diagnostics는 연결 관련 상태를 확인하는 진단 메뉴입니다. Settings에서 메뉴를 찾아 현재 화면에서 제공하는 항목을 실행하세요. 진단 정보는 문제 범위를 좁히기 위한 것이며 실제 사용 결과를 보장하지 않습니다.

설정 방법 및 유의 사항:문제가 발생했을 때 네트워크 유형, Global Routing, 선택한 서버, 증상을 기록한 뒤 관련 검사를 실행하세요. 결과를 저장할 때 필요한 오류 정보는 남기되, 공유하기 전에 Subscribe 주소, 인증 항목 및 기타 개인 정보를 삭제하세요. 검사할 때마다 네트워크나 Config를 바꾸면 결과를 비교하기 어렵습니다. 조건을 일정하게 유지하고 가설을 하나씩 확인하세요.

설정 확인 목록

일상적인 사용을 위해 모든 기능을 하나씩 켤 필요는 없습니다. 기본 연결을 먼저 확인한 뒤 규칙과 자동 연결 조건을 추가하는 편이 안전합니다. 단계마다 확인된 상태를 유지하면 이후 문제가 생겼을 때 돌아갈 기준을 마련할 수 있습니다.

  1. 정보 확인:서버 유형, 주소, 인증 매개변수가 보유한 정보와 일치하는지 확인하세요. Subscribe 업데이트가 완료되었고 Home에서 원하는 항목을 선택했는지도 확인합니다.
  2. 모드 확인:Global Routing이 현재 용도에 맞게 선택되어 있는지 확인하세요. Config를 사용하는 경우 실제 적용 중인 파일, 규칙 순서, FINAL도 점검합니다.
  3. 접속 확인:Connectivity Test나 Data 수치에만 의존하지 말고 실제 대상에 접속해 확인하세요. 테스트 시간, 네트워크 환경, 결과를 함께 기록합니다.
  4. 자동화는 나중에 설정:기본 연결이 안정된 뒤 On Demand, Today Widget, iCloud 관련 옵션을 조정하세요. 항목별로 따로 확인하고 여러 변경 사항을 한 번에 테스트하지 마세요.
  5. 복원 지점 보관:DNS나 규칙을 수정하기 전에 기존 값을 보관하세요. 새 문제가 생기면 가장 최근 변경 사항부터 되돌리고 Diagnostics로 단서를 수집합니다.

처음 실행부터 따라 하려면 Shadowrocket 사용 방법 안내를 확인하세요. 목록이 비어 있거나 연결 후 접속할 수 없는 경우 등 구체적인 문제는 자주 묻는 질문에서 확인할 수 있습니다. 구매 및 구매 항목 복원은 App Store 정식 구매 안내를 참고하세요. 앱 구매, 서버 정보, 클라우드 동기화는 서로 다른 항목입니다.

App Store에서 Shadowrocket 다운로드