공식 가이드 / 기능 소개
Shadowrocket
기능 및 설정
먼저 트래픽 처리 방식을 정한 다음 서버, 규칙, 연결 조건을 확인하세요. 한 번에 한 종류의 설정만 변경하면 무엇이 달라졌는지 파악하기 쉽습니다.
이 페이지는 iPhone과 iPad 앱 내 메뉴를 기준으로 설명합니다. 세부 옵션은 현재 화면을 확인하고, 시스템 요구 사항은 App Store 페이지의 안내를 따르세요.
01 / 트래픽 처리 방식
Global Routing:Config、Proxy、Direct
Global Routing은 클라이언트가 처리하는 트래픽의 경로를 결정합니다. 서버의 사용 가능 여부와 시스템 연결 스위치의 상태는 각각 별도로 확인해야 합니다.
무엇인가요: Config는 설정 파일의 규칙에 따라 정책을 선택하는 모드입니다. Proxy는 클라이언트가 처리하는 트래픽을 프록시 정책으로 보내고, Direct는 직접 연결 정책을 사용합니다. 여기서 ‘전체’란 클라이언트의 처리 범위에 들어오는 트래픽을 뜻하며, 기기의 모든 시스템 통신이 반드시 처리된다는 의미는 아닙니다.
어디에서 설정하나요: Home에서 Global Routing을 열고 원하는 모드를 선택합니다. 문제를 확인하기 전에 현재 선택된 모드와 Home에서 선택한 서버를 기록해 두세요. Proxy로 바꾸는 것만으로 서버 설정이 완성되거나 서버에 연결할 수 있다는 뜻은 아닙니다.
| 화면 옵션 | 처리 방식 | 사용할 때 | 확인할 항목 |
|---|---|---|---|
| Config / 설정 | 현재 Config의 규칙과 정책에 따라 처리합니다. | 명확한 트래픽 분기 기준이 있고 평소 규칙에 따라 사용하려는 경우 | 현재 설정 파일, 규칙 순서, 정책 대상 |
| Proxy / 프록시 | 프록시 정책을 사용하며, 일반 규칙을 항목별로 적용하지 않습니다. | 프록시 연결을 잠시 확인해 규칙 문제의 범위를 좁힐 때 | 선택한 서버, 인증 정보, 실제 접속 결과 |
| Direct / 직접 연결 | 직접 연결 정책을 사용합니다. | 현재 네트워크에서 직접 접속이 가능한지 확인할 때 | 로컬 네트워크의 사용 가능 여부와 테스트 후 모드 복원 |
설정 방법: 사용할 수 있는 설정 파일이 있다면 Config를 선택한 뒤, 예상한 규칙이 적용될 대상을 열어 확인합니다. Config에서 실패하면 같은 네트워크와 서버를 유지한 채 Proxy로 바꾸고 동일한 대상에 접속해 보세요. Proxy는 성공하고 Config만 실패한다면 적용된 규칙을 확인합니다. 두 모드에서 모두 실패한다면 규칙을 더 추가하기보다 서버 정보와 네트워크 상태부터 점검하세요.
주의할 점: Direct를 선택해도 시스템 VPN 연결이 꺼지는 것은 아닙니다. 모드와 연결 스위치를 각각 확인하세요. 문제 확인이 끝나면 평소 사용하던 모드로 되돌려 임시 설정이 남지 않도록 합니다. 연결 과정을 차례로 확인하려면 사용 튜토리얼을 참고하세요. 이 페이지에서는 기능 간의 관계를 설명합니다.
02 / Config 및 정책
규칙 분기: 규칙을 일치시킨 뒤 정책 선택
규칙은 ‘이번 연결이 어떤 조건에 해당하는지’를 판단하고, 정책은 ‘조건에 해당할 때 어떻게 처리할지’를 정합니다. 규칙 키워드만 알아서는 실제 연결 경로를 파악할 수 없습니다.
무엇인가요: 규칙은 일반적으로 순서대로 확인하며, 일치하는 규칙이 있으면 지정된 정책을 적용합니다. 대표적인 정책은 직접 연결, 프록시, 차단에 사용하는 DIRECT, PROXY, REJECT입니다. 설정 파일에서 정책 그룹을 참조할 수도 있으므로 PROXY나 그룹 이름을 확인한 뒤에는 최종적으로 어떤 서버를 가리키는지 살펴보세요.
어디에서 설정하나요: Config를 열어 현재 활성화된 설정 파일을 확인한 다음 규칙을 보거나 수정합니다. 다른 파일을 저장해도 해당 파일로 자동 전환되지는 않습니다. 설정 파일의 분기 규칙을 예상대로 확인하려면 Global Routing이 Config로 설정되어 있는지도 확인하세요.
설정 방법: 먼저 현재 설정 파일을 백업한 뒤 적용 범위가 명확한 규칙을 추가합니다. 구체적인 대상을 넓은 조건보다 앞에 배치하고 마지막의 FINAL도 확인하세요. 테스트할 때는 접속 대상, 일치한 규칙, 적용된 정책을 기록합니다. 페이지가 열리는지만으로 분기 결과를 판단하지 마세요.
| 키워드 | 일치 기준 | 설정 시 확인할 점 |
|---|---|---|
| DOMAIN | 전체 도메인 | 도메인 하나만 지정할 때 사용하며, 모든 하위 도메인까지 포함하는 것은 아닙니다. |
| DOMAIN-SUFFIX | 도메인 접미사 | 해당 도메인과 하위 도메인까지 적용되므로 범위를 확인하세요. |
| DOMAIN-KEYWORD | 도메인 내 키워드 | 일치 범위가 넓으므로 짧은 키워드가 의도치 않게 일치하지 않도록 주의하세요. |
| IP-CIDR / IP-CIDR6 | IPv4 / IPv6 주소 대역 | 주소 유형과 프리픽스 길이를 확인하세요. 도메인 요청은 DNS 조회도 관련될 수 있습니다. |
| GEOIP | IP 지리 위치 데이터 | IP 주소와 데이터베이스를 기준으로 판단하며 페이지 언어에 따라 분기하지 않습니다. |
| FINAL | 앞선 규칙에 일치하지 않을 때 적용되는 기본 규칙 | 기본 정책을 확인해 규칙에 일치하지 않은 연결이 예상과 다른 경로로 가지 않도록 하세요. |
주의할 점: 한 페이지에서 여러 도메인을 요청할 수 있으므로 기본 페이지가 열려도 부가 리소스에 같은 정책이 적용됐다고 단정할 수 없습니다. 규칙 일치 결과는 DNS 응답, 설정 파일 내용, 연결 재사용 등의 영향을 받습니다. 예시 규칙 하나를 임의의 위치에 추가하는 것만으로 설정이 완료되는 것은 아닙니다. 앞선 규칙이 먼저 일치하는지 확인하세요. 키워드 설명은 용어 가이드에서 확인할 수 있습니다.
03 / Home 및 가져오기
구독 및 서버 관리
기존 구독 또는 서버 정보가 있다는 전제의 안내입니다. 클라이언트의 일회성 구매와 서버 이용 요금제는 별개이며, 구독 링크는 이용 중인 서비스 제공업체에서 받아야 합니다.
무엇인가요: 개별 서버에는 연결에 필요한 프로토콜, 주소, 포트, 인증 정보가 저장됩니다. Subscribe는 여러 서버 정보를 가져오고 갱신하는 기능입니다. Config는 규칙과 관련 설정을 관리하므로 두 기능의 용도는 다릅니다. 구독을 갱신하면 해당 구독에 포함된 내용이 업데이트될 뿐, 모든 설정 문제를 해결해 주는 것은 아닙니다.
어디에서 설정하나요: Home의 추가 메뉴에서 Add Server를 열고 해당 유형을 선택합니다. 구독 링크가 있다면 Subscribe를 사용하고, 단일 서버 정보가 있다면 프로토콜을 선택해 항목을 입력하세요. QR 코드는 Scan QR Code로 읽을 수 있으며, 클립보드 가져오기는 현재 클라이언트가 지원하는 공유 형식에 사용할 수 있습니다.
설정 방법: 먼저 가져올 자료가 구독 링크, 단일 서버 공유 링크, 설정 파일 중 무엇인지 확인한 다음 해당 메뉴를 선택합니다. 직접 입력할 때는 Address, Port와 프로토콜이 서비스 제공업체의 정보와 일치해야 합니다. Password, UUID, TLS, SNI 등의 항목은 해당 프로토콜에서 요구하는 경우에만 입력하며, 서로 다른 프로토콜의 값을 바꿔 사용하지 마세요. 가져온 뒤에는 서버나 구독에 알아보기 쉬운 이름을 붙이고 서버를 선택해 테스트합니다.
구독을 여러 개 사용할 때는 출처와 용도에 따라 이름을 정리하고, 갱신 전에 어느 구독을 선택했는지 확인하세요. 서버 하나가 작동하지 않는다고 구독 전체를 삭제할 필요는 없습니다. 먼저 구독 갱신 결과와 서비스 제공업체 측의 유효 상태를 확인하세요. 삭제하기 전에는 필요한 정보를 저장하세요. 특히 직접 수정했으며 이후 갱신 과정에서 덮어써질 수 있는 항목은 따로 보관해야 합니다.
주의할 점: 구독 링크에는 접속 인증 정보가 포함될 수 있으므로 공개 로그, 스크린샷, 문의 내용에 올리지 마세요. QR 코드가 읽힌다는 것은 내용이 인식됐다는 뜻일 뿐, 서버에 연결할 수 있다는 뜻은 아닙니다. 지연 시간 테스트도 웹페이지 접속 전체를 검증하지는 않습니다. 갱신, 정렬, 삭제, 백업 방법은 구독 및 서버 관리 가이드를 참고하세요.
04 / 연결 조건
On Demand: 조건에 따라 연결 시작
On Demand는 연결을 시작할 시점을 관리합니다. Global Routing을 대신하지 않으며 구독의 유효성을 판단하지도 않습니다.
무엇인가요: On Demand는 시스템의 주문형 연결 기능을 사용해 설정한 네트워크 조건에 따라 연결을 처리합니다. 특정 네트워크 환경에서 자동으로 연결해야 하는 경우에 적합합니다. 앱 화면에 표시되는 조건과 조합 방식은 현재 화면을 기준으로 확인하세요.
어디에서 설정하나요: Settings에서 On Demand 관련 항목을 찾아 현재 스위치와 설정된 조건을 확인합니다. 기존에 주문형 연결을 설정했다면 먼저 조건을 기록한 다음 추가하거나 수정할 필요가 있는지 판단하세요. 조건이 중복되어 서로 영향을 주지 않도록 주의해야 합니다.
설정 방법: 먼저 수동 연결 상태에서 서버와 Config가 작동하는지 확인한 뒤 주문형 연결을 설정합니다. 네트워크 조건은 한 번에 하나씩 바꾸고 저장한 후 해당 네트워크 환경에서 시스템 VPN 상태를 확인하고 알려진 대상에 실제로 접속해 보세요. Wi-Fi와 셀룰러 네트워크를 오간 뒤에도 각각 테스트해야 합니다. 같은 네트워크에서 스위치만 반복해서 켜고 끄지 마세요.
주의할 점: On Demand를 설정하면 수동으로 연결을 끊어도 조건이 충족될 때 다시 연결될 수 있습니다. 자동 연결을 잠시 중지하려면 Home의 스위치만 반복해서 누르지 말고 On Demand 조건을 확인하세요. 주문형 연결이 성공해도 트래픽 분기가 올바르다는 뜻은 아닙니다. 연결이 시작된 뒤 트래픽 경로는 Global Routing과 현재 설정 파일에 따라 결정됩니다.
05 / 사용 기록
Data: 트래픽 확인, 청구 내역은 별도 확인
Data는 클라이언트에 기록된 트래픽 변화를 확인하는 기능입니다. 데이터가 전송됐는지 점검하는 데 유용하지만 속도, 서버 품질, 요금 산정 결과를 단독으로 입증하지는 않습니다.
무엇인가요: Data는 클라이언트에서 확인할 수 있는 범위의 트래픽 통계를 표시합니다. 업로드와 다운로드는 서로 다른 방향의 데이터 전송을 뜻합니다. 구체적인 통계 기준과 기록 범위는 화면에 표시된 내용을 확인하세요. 클라이언트, 기기 시스템, 서비스 제공업체는 서로 다른 기준으로 측정할 수 있으므로 수치가 정확히 일치하지 않을 수 있습니다.
어디에서 확인하나요: Data를 열고 통계 대상과 시간 범위를 먼저 확인합니다. 화면에 서버나 연결별 분류가 있다면 현재 조회 중인 대상을 확인한 뒤 전후 수치를 비교하세요. 특정 분류의 수치를 기기 전체의 총 트래픽으로 간주하지 마세요.
설정 및 확인 방법: 대상 하나만 방문하는 등 범위가 명확한 테스트를 선택한 다음 작업 전후의 트래픽 변화를 비교합니다. 통계 초기화 메뉴가 있다면 필요한 기록을 먼저 저장한 뒤 초기화할지 결정하세요. 클라이언트 통계를 초기화해도 서비스 제공업체 측의 사용량은 초기화되지 않습니다. 장시간 관찰할 때는 같은 통계 범위를 유지하세요.
주의할 점: 소량의 트래픽이 발생했다고 해서 대상 콘텐츠가 정상적으로 로드된 것은 아닙니다. 연결 협상, 재시도, 백그라운드 요청도 데이터를 전송할 수 있습니다. Data만으로 남은 사용량을 계산할 수 없으며 서비스 제공업체의 청구 내역을 대신하지도 않습니다. 접속 실패 원인을 확인하려면 Data와 Diagnostics의 연결 정보를 함께 살펴보세요.
06 / 자주 쓰는 옵션
Settings: DNS, 테스트, 빠른 실행 및 동기화
현재 작동하는 설정을 먼저 보존한 뒤 구체적인 문제에 맞춰 변경하세요. 이름이 같은 설정이라고 해서 모든 연결 문제를 해결하는 것은 아닙니다.
DNS: 도메인 조회 실패와 연결 실패 구분
무엇이며 어디에 있나요: DNS는 도메인 이름을 IP 주소로 변환합니다. Settings에서 DNS 관련 항목을 확인할 때는 현재 Config에 DNS 설정이 포함되어 있는지도 살펴보세요. 한 메뉴만 변경하고 실제 사용 중인 설정 파일을 놓치지 않도록 합니다.
설정 방법: 먼저 현재 DNS 설정을 기록한 뒤 구체적인 필요에 따라 변경하고 같은 도메인으로 다시 확인합니다. 일부 대상만 실패한다면 DNS 조회 결과가 나오지 않는 것인지, 주소를 받은 뒤 연결에 실패하는 것인지 먼저 구분하세요. DNS 방식을 지정해야 한다면 주소 형식, 연결 가능 여부, 현재 네트워크 상태를 확인하세요. 흔히 쓰이는 주소라는 이유만으로 바로 교체하지 마세요.
주의할 점: DNS 조회 결과가 캐시될 수 있으므로 설정을 변경해도 결과가 바로 달라지지 않을 수 있습니다. DNS를 바꿔도 잘못된 서버 암호, 포트, TLS 설정은 수정되지 않습니다. 설정 우선순위와 적용 여부는 현재 설정 파일과 실제 진단 결과를 바탕으로 확인하고, DNS 변경을 무조건 첫 단계로 삼지 마세요.
Test Method: 테스트 기준 통일
무엇이며 어디에 있나요: Test Method는 Settings에서 연결 테스트 방식과 관련된 옵션입니다. Home의 Connectivity Test 결과는 선택한 테스트 방식에 따라 해석해야 합니다. 방식마다 확인하는 연결 단계가 다를 수 있으므로 결과를 같은 기준으로 비교할 수는 없습니다.
설정 방법: 현재 화면에서 지원하며 이번 문제 확인 목적에 맞는 방식을 선택한 뒤 같은 서버를 테스트합니다. 결과를 전후 비교할 때는 네트워크, 테스트 방식, 테스트 대상을 동일하게 유지하세요. 테스트 방식에 대상 주소나 시간 제한 옵션이 있다면 함께 기록해야 합니다.
주의할 점: 테스트 성공은 해당 테스트 조건이 충족됐다는 뜻일 뿐, 모든 실제 접속이 성공한다는 의미는 아닙니다. 실패 결과도 테스트 대상이나 시간 제한의 영향을 받을 수 있습니다. 서버를 정렬할 때 지연 시간 하나만 기준으로 삼지 말고, 실제 접속으로 현재 서버를 확인하세요.
Today Widget: 빠른 실행 및 시스템 지원 여부
무엇이며 어디에 있나요: Today Widget은 시스템에서 빠르게 접근할 수 있도록 하는 설정 항목입니다. Settings에서 관련 옵션을 확인한 다음 시스템의 해당 위젯 관리 화면에서 추가할 수 있는지 살펴보세요. 사용 가능한 메뉴와 표시 방식은 현재 시스템 및 앱 화면에 따라 다릅니다.
설정 방법: 시스템에서 제공하는 절차에 따라 추가한 뒤 표시되는 연결 상태와 대상 동작을 확인합니다. 처음 사용할 때는 Home으로 돌아가 연결이 의도한 대로 변경되는지 점검하세요. 위젯에 표시된 문구만으로 전환이 완료됐다고 판단하지 마세요.
주의할 점: 위젯은 빠른 실행 기능을 제공할 뿐 서버 정보나 규칙을 변경하지 않습니다. 메뉴가 나타나지 않으면 시스템 지원 여부와 위젯 설정부터 확인하세요. 위젯을 표시하기 위해 DNS, 구독, Config를 한꺼번에 변경하지 마세요.
iCloud: 동기화와 별도 백업 구분
무엇이며 어디에 있나요: iCloud 관련 옵션은 시스템 계정과 클라우드 서비스를 사용할 수 있을 때 앱에서 지원하는 데이터를 동기화합니다. Settings에서 관련 스위치를 확인하고 시스템의 iCloud 권한과 사용 가능한 저장 공간도 점검하세요. 실제 동기화 범위는 앱 내 안내를 따릅니다.
설정 방법: 기기를 바꾸기 전에 기존 기기에서 동기화 상태를 확인하고 중요한 Config와 구독 정보는 별도로 저장하세요. 새 기기에서 App Store를 통해 앱을 복원한 뒤 동기화된 내용이 모두 있는지 확인하고 서버, 설정 파일, 규칙을 각각 테스트합니다. 목록이 나타났다는 이유만으로 기존 기기의 데이터를 삭제하지 마세요.
주의할 점: 동기화는 별도의 과거 백업이 아니므로 한 기기에서 수정하거나 삭제한 내용이 다른 기기에도 반영될 수 있습니다. 구매 내역, 시스템 VPN 설정 권한, 앱 내 설정은 서로 다른 데이터입니다. 동기화가 완료된 후에도 새 기기에서 시스템 권한을 확인해야 할 수 있습니다.
07 / 진단 및 재테스트
Diagnostics: 기록을 바탕으로 문제 범위 좁히기
먼저 문제를 한 번 재현한 뒤 해당 시간대의 기록을 확인하세요. 여러 항목을 동시에 바꾸기보다 연결, DNS 조회, 규칙, 서버 정보를 따로 점검하면 원인을 찾기 쉽습니다.
무엇이며 어디에 있나요: Diagnostics는 연결 상태와 관련 기록을 확인하는 진단 메뉴이며 Settings에서 찾을 수 있습니다. 사용할 수 있는 로그와 도구는 현재 화면에 표시된 내용을 따릅니다. 진단 기록은 참고 자료이므로 문제가 발생한 시점의 네트워크, Global Routing, 현재 설정과 함께 해석해야 합니다.
사용 방법: 실패한 대상, 발생 시간, 오류 메시지를 기록한 다음 필요한 최소한의 동작으로 문제를 다시 재현합니다. 해당 기록을 확인해 DNS, 연결 수립, 인증, 후속 요청 중 어느 단계에서 문제가 발생했는지 판단하세요. Config 모드에서만 실패한다면 규칙과 정책을 중점적으로 살펴보세요. 같은 서버가 Proxy에서도 실패한다면 서버 항목과 테스트 조건부터 확인합니다.
주의할 점: 로그에는 구독 링크, 서버 주소, 접속 도메인, 인증 정보가 포함될 수 있습니다. 기록을 외부에 전달하기 전에 접속 정보와 개인정보를 삭제하고, 문제 확인에 필요한 시간, 오류 유형, 점검 내용을 남기세요. 일반적인 연결 문제를 확인하기 위해 TLS 검증 요구 사항을 함부로 낮추지 마세요.
설정 전체 점검 순서
- 현재 네트워크가 정상적으로 작동하는지 확인하고 Home에 표시된 서버와 연결 상태를 기록합니다.
- Global Routing을 확인한 뒤 같은 대상을 사용해 문제를 재현합니다.
- Config에서 규칙 순서와 정책 대상을 확인하고 서버의 프로토콜 및 인증 정보를 점검합니다.
- DNS, Test Method, Diagnostics를 확인하고 서로 다른 기준의 테스트 결과를 직접 비교하지 않습니다.
- 한 번에 한 항목만 변경하고 다시 테스트합니다. 효과가 확인된 변경 사항은 유지하고 임시 모드는 원래대로 되돌립니다.
증상에 따라 문제를 더 확인하려면 문제 해결을 참고하세요. 가져오기와 연결 과정을 처음부터 다시 진행하려면 사용 튜토리얼을 확인하세요.