공식 매뉴얼 · 기능 및 설정

Shadowrocket 프록시 모드
와 자주 쓰는 설정

요청을 어떤 방식으로 처리할지 먼저 정한 다음 규칙, 연결 및 진단 옵션을 조정합니다. Global Routing은 전체 처리 방식을 결정하고, Config는 규칙 세부 사항을 정하며, 서버 정보는 실제 연결 대상을 결정합니다.

Shadowrocket은 Apple 플랫폼에서 App Store를 통해서만 제공되는 유료 상용 앱입니다. 이 페이지에서는 주로 iPhone과 iPad에서의 사용 방법을 설명합니다. 시스템 요구 사항은 App Store 페이지의 안내를 확인하세요.

01 · 요청 처리 방식

Global Routing:Config / Proxy / Direct

먼저 전체 처리 방식을 선택하고 개별 요청을 확인하세요. 모드 선택과 연결 스위치는 서로 다른 설정입니다.

기능과 설정 위치

Global Routing은 전체 라우팅 방식을 선택하는 메뉴로, 일반적으로 Home에서 열 수 있습니다. 여기서는 자주 사용하는 세 가지 방식을 구성 기반, 프록시, 직접 연결이라고 부르지만, 실제 화면의 옵션명은 각각 Config, Proxy, Direct입니다. 이 옵션을 바꿔도 서버 주소가 입력되거나 유효하지 않은 인증 정보가 복구되지는 않습니다. Global Routing은 ‘요청을 어떤 방식으로 처리할지’를 정하며, ‘연결 정보를 어디에서 가져올지’를 정하는 설정은 아닙니다.

옵션의 Config와 하단의 Config 페이지는 서로 관련되어 있지만 역할은 다릅니다. 전자는 현재 구성에 따라 트래픽을 처리한다는 뜻이고, 후자는 구성 파일을 관리하고 편집하는 메뉴입니다. 규칙 파일을 저장해 두었다고 해서 현재 연결에 그 파일의 분기 규칙이 적용된다는 뜻은 아닙니다. 선택된 파일과 Global Routing 상태를 모두 확인해야 합니다.

화면 옵션 처리 방식 사용 시점 확인할 항목
Config 현재 구성의 규칙과 정책에 따라 요청을 처리합니다. 도메인, 주소 또는 기타 조건에 따라 일상적으로 트래픽을 분기할 때 사용합니다. 현재 구성, 규칙 순서, 정책 대상 및 최종 기본 규칙을 확인합니다.
Proxy 트래픽을 프록시 방식으로 처리합니다. 실제 동작은 앱과 시스템 네트워크의 제약에도 영향을 받습니다. 선택한 서버가 대상 요청을 처리할 수 있는지 임시로 확인할 때 사용합니다. 서버의 사용 가능 여부와 해당 서버에서 대상 서비스까지의 연결 상태를 확인합니다.
Direct 트래픽을 직접 연결 방식으로 처리합니다. 로컬 네트워크 경로와 비교해 프록시 경로 관련 문제를 확인할 때 사용합니다. 로컬 네트워크에서 대상에 직접 접속할 수 있는지, DNS에 사용자 지정 설정이 적용되어 있는지 확인합니다.

전환하고 결과 비교하기

먼저 Home에서 선택된 서버를 확인한 다음 Global Routing에서 필요한 방식을 선택하세요. 비교할 때는 같은 대상과 같은 유형의 요청을 사용하고, 기존 연결이 재사용되어 결과에 영향을 주지 않도록 필요하면 연결을 다시 설정하세요. Proxy에서는 되지만 Config에서 문제가 생기면 규칙이 일치했는지와 정책 선택을 확인합니다. 두 방식 모두 문제가 생기면 규칙을 계속 바꾸기보다 서버 정보, 로컬 네트워크, DNS를 점검하세요.

Direct는 네트워크 경로를 비교하는 데 유용하지만, 모든 네트워크 관련 설정을 끄는 옵션은 아닙니다. DNS, 기존 연결, 시스템 동작이 결과에 영향을 줄 수 있습니다. 임시 테스트를 마치면 원래 사용하려던 방식으로 되돌리고 연결 스위치도 확인하세요. 테스트 상태를 일상 설정으로 계속 사용하지 않도록 주의합니다.

02 · 일치 조건과 정책

규칙 분기: 먼저 일치 여부를 확인한 뒤 처리 방식 결정

규칙 유형은 ‘무엇과 일치하는지’를, 정책은 ‘일치한 요청을 어떻게 처리하는지’를 나타냅니다.

Config에서 현재 구성 확인

규칙 분기를 사용하면 요청마다 서로 다른 방식으로 처리할 수 있습니다. Config에서 현재 사용 중인 파일을 확인한 뒤 규칙과 정책을 살펴보세요. 일반적으로 규칙은 순서대로 평가되며, 먼저 일치하는 규칙이 해당 요청의 처리 방식을 결정합니다. 따라서 범위가 넓은 규칙을 앞에 두면 뒤에 있는 세부 규칙이 적용되지 않을 수 있습니다. 수정 전 원래 구성을 저장하고, 문제 대상과 관련된 규칙만 소수 이동하거나 수정하세요.

DOMAIN은 지정한 도메인과 일치합니다. DOMAIN-SUFFIX는 도메인 접미사와 하위 도메인에 일치합니다. DOMAIN-KEYWORD는 도메인에 포함된 키워드로 일치 여부를 판단하므로 예상보다 범위가 넓을 수 있습니다. IP-CIDR과 IP-CIDR6은 각각 주소 대역을 나타냅니다. GEOIP는 주소 위치 데이터베이스를 기준으로 판단하며, 서비스의 등록 국가나 사용 언어를 뜻하지 않습니다. 도메인과 주소 간 변환이 관련된 경우 DNS 조회 결과도 고려해야 합니다.

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

위 내용은 문법을 읽는 예시일 뿐, 완전한 구성 파일이 아닙니다. PROXY는 프록시로 처리, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 규칙에서 사용자 지정 정책 이름을 참조한다면 해당 정책이 현재 구성에 있어야 합니다. FINAL은 앞선 조건과 일치하지 않을 때 적용되는 기본 규칙이므로 위치와 대상 정책을 모두 확인하세요.

일치 조건의 적용 범위에 유의하기

USER-AGENT는 요청에서 일치시킬 수 있는 정보에 따라 작동하므로 모든 요청에서 같은 항목을 확인할 수 있다고 가정하면 안 됩니다. 규칙 이름만 보고 반드시 적용된다고 판단하지 마세요. 예상과 다르게 처리되는 요청이 있으면 확인 가능한 연결 기록에서 대상 도메인과 주소, 사용된 정책을 살펴보세요. Global Routing이 Config인지 확인한 후 규칙 순서와 참조 관계를 점검합니다. 규칙은 경로를 선택할 뿐 대상 서비스 자체의 오류를 해결하지는 않습니다.

원격 규칙과 구독 서버는 서로 다른 종류의 항목입니다. 서버 목록을 업데이트해도 규칙이 함께 업데이트되는 것은 아니며, 구성 파일을 바꾸면 정책 이름도 달라질 수 있습니다. 구성 간 관계를 체계적으로 정리하려면 구독 및 서버 관리 안내를 참고하세요. 일괄 변경에 앞서 각 항목의 출처와 용도를 명확히 기록하는 것이 좋습니다.

03 · 연결 정보

Subscribe와 Add Server

구독은 기존 서버 정보를 한곳에서 관리할 때, 수동 추가는 각 항목을 직접 확인할 때 사용합니다.

Subscribe: 기존 구독 가져오기

Home에서 추가 메뉴를 열고 Add Server로 이동해 Subscribe를 선택한 다음, 본인이 보유한 구독 URL을 붙여 넣으세요. 저장 후 업데이트를 실행해 서버 항목이 생성되었는지 확인하고 실제로 사용할 항목을 선택합니다. 구독 URL과 개별 서버 공유 링크는 서로 다른 형식입니다. 가져온 결과에 문제가 있으면 먼저 입력 메뉴가 콘텐츠 유형에 맞는지 확인하고 URL이 완전한지 점검하세요.

구독이 여러 개라면 용도를 알아볼 수 있는 메모를 지정해 순서만 보고 선택하지 않도록 하세요. 업데이트 과정에서 원격 응답에 따라 항목이 변경될 수 있으며, 직접 수정한 이름이나 매개변수가 다음 업데이트에서 덮어써질 수 있습니다. 업데이트 전에 현재 선택 항목을 기록하고, 완료 후 다시 확인하세요. ‘업데이트 완료’가 모든 서버의 연결 성공을 의미하지는 않습니다.

Add Server: 항목을 직접 확인하기

개별 서버 정보를 보유하고 있다면 Add Server에서 해당 Type을 선택한 뒤 주소, 포트와 프로토콜에 필요한 인증 정보를 입력하세요. Shadowsocks, VMess, VLESS, Trojan, WireGuard, Hysteria2 등의 매개변수는 서로 호환되지 않습니다. Type만 바꾸고 이전 정보를 그대로 사용하지 말고 보유한 자료에 따라 각 항목을 입력하세요.

자료에 TLS, 서버 이름 또는 전송 관련 항목이 있다면 서버 측 설정과 동일하게 입력하세요. 저장에 성공했다는 것은 로컬에 항목이 만들어졌다는 뜻일 뿐, 인증과 연결이 모두 확인된 것은 아닙니다. 먼저 Connectivity Test를 실행한 다음 실제 대상에 접속해 보세요. 문제가 생기면 원본 자료를 보관해 비교하고, 여러 항목을 동시에 바꾸지 마세요.

QR 코드, 클립보드 가져오기와 여러 구독 정리

Scan QR Code 또는 클립보드에서 가져오기 전에 콘텐츠가 본인이 보유한 서버 자료인지 확인하세요. 가져온 뒤 프로토콜, 주소, 포트와 메모를 점검합니다. QR 코드 인식에 성공해도 매개변수가 모두 포함되었다는 뜻은 아닙니다. 구독 URL, 공유 정보와 구성 백업에는 인증 정보가 포함될 수 있으므로 공개 스크린샷이나 진단 설명에 노출하지 마세요. 문제를 보여줄 때는 필요한 항목명만 남기세요.

구독이 여러 개라면 용도별로 구분한 다음 테스트하고 순서를 정리하세요. 구독을 삭제하기 전에 어떤 관련 항목에 영향을 주는지 확인하고, 보존할 개인 구성은 저장합니다. 구독 업데이트와 App Store 앱 업데이트는 각각 서버 정보와 클라이언트를 변경하는 작업으로 서로 대체할 수 없습니다.

04 · 조건에 따른 연결

On Demand: 주문형 연결

반복해서 확인할 수 있는 수동 연결을 먼저 설정한 다음 자동 연결 조건을 구성하세요.

기능과 설정 방법

On Demand는 설정한 조건에 따라 VPN 연결을 시작하는 기능입니다. 연결을 시작할 시점을 정하며, 연결 후 요청 처리 방식은 Global Routing과 Config에서 설정합니다. Settings에서 On Demand 관련 옵션을 찾을 수 있으며, 실제로 사용할 수 있는 조건은 현재 앱 화면에서 확인하세요. 어떤 네트워크 환경에서 연결을 시작할지 먼저 정한 뒤 해당 조건만 활성화하세요. 자동 연결을 위해 모든 옵션을 한꺼번에 켜지 마세요.

설정 전에 서버를 수동으로 선택하고 Global Routing을 정한 뒤 실제 접속을 한 번 확인하세요. 그런 다음 On Demand를 구성하고 Wi-Fi나 셀룰러 네트워크를 전환하면서 시스템과 앱 내 연결 상태가 예상대로인지 살펴봅니다. 테스트 당시 네트워크 조건도 기록해야 서버의 일시적인 문제를 연결 조건의 오작동으로 오해하지 않습니다.

연결 해제 후 자동 동작에 유의하기

On Demand를 활성화하면 수동으로 연결을 해제해도 계속 연결 해제 상태가 유지되지 않을 수 있습니다. 조건이 다시 충족되면 시스템이 연결을 다시 시작할 수 있습니다. 연결 해제 후 다시 연결되는 문제를 확인할 때는 구성을 반복해서 삭제하기보다 먼저 On Demand를 살펴보세요. 자동 동작을 잠시 중지해야 한다면 해당 조건을 끄고 네트워크 전환 과정을 처음부터 끝까지 확인하세요.

On Demand는 모든 웹사이트의 접속 가능 여부를 판단하지 않으며 서버가 계속 온라인 상태임을 보장하지 않습니다. 시스템의 연결 일정, 네트워크 환경, 유효한 구성의 영향을 받습니다. 규칙이나 서버를 조정할 때 자동 재연결이 비교를 방해하지 않도록 자동 연결을 잠시 중지할 수 있습니다. 확인을 마친 뒤 기존 조건을 다시 활성화하세요.

05 · 사용량 확인

Data: 트래픽 통계

통계는 앱이 기록하는 범위의 트래픽을 확인하는 용도이며 외부 요금 산정의 기준이 아닙니다.

확인 위치와 수치 변화 해석

Data에서 현재 화면에 표시되는 트래픽 통계를 확인하세요. 먼저 통계 대상, 기간, 초기화 여부를 살펴본 다음 수치 변화를 비교합니다. 통계 항목마다 집계 기준이 다를 수 있으므로 한 번의 연결이나 특정 서버의 데이터가 기기 전체 네트워크 사용량과 같다고 볼 수 없습니다. 시스템 네트워크, 전송 오버헤드, 외부 서비스의 측정 방식도 차이를 일으킬 수 있습니다.

특정 작업에서 트래픽이 발생했는지 확인하려면 먼저 시작 상태를 기록하고, 명확한 접속 동작을 한 번 수행한 뒤 Data로 돌아와 변화를 확인하세요. 테스트 중에는 다른 앱의 백그라운드 활동을 최대한 줄입니다. 누적 사용량은 속도 테스트 결과가 아닙니다. 수치가 증가했다면 기록 범위 안에서 데이터가 전송된 것이지만, 이를 근거로 대역폭이나 응답 품질, 모든 요청의 규칙 분기가 정상인지 판단할 수는 없습니다.

초기화 및 문제 해결 시 유의 사항

화면에 초기화 기능이 있다면 비교에 필요한 기록을 먼저 저장한 뒤 실행하세요. 통계를 지운다고 네트워크 문제가 해결되는 것은 아닙니다. 트래픽이 계속 증가하는데 대상 페이지가 열리지 않는다면 요청이 올바른 정책과 일치하는지, DNS 조회가 성공했는지, 서버에서 대상에 접속할 수 있는지 확인해야 합니다. 반대로 통계 변화가 뚜렷하지 않더라도 확인 범위나 기존 캐시의 영향일 수 있으므로 그것만으로 연결 실패라고 단정할 수 없습니다.

06 · 자주 쓰는 설정 메뉴

Settings: DNS, 테스트 및 진단

아래 항목은 실제 용도에 맞춰 각각 조정하세요. 메뉴 위치와 사용 가능한 옵션은 현재 앱 화면을 기준으로 확인합니다.

DNS: 먼저 조회 경로 확인

DNS는 도메인을 주소로 변환합니다. Settings에서 DNS 관련 항목을 확인하고 현재 Config에 별도의 DNS 설정이 있는지도 살펴보세요. 한 곳만 바꾸고 다른 설정의 영향을 놓치지 않도록 합니다. 처음에는 정상 작동하는 설정을 유지하고, 조회 실패나 비정상적인 주소 반환이 확인되거나 조회 경로를 지정해야 할 때만 관련 항목을 조정하세요.

사용자 지정 DNS나 DNS over HTTPS를 사용하려면 접속 가능한 DNS 서비스가 필요하며, 모든 네트워크에서 시스템 DNS보다 적합한 것은 아닙니다. 설정을 바꿀 때는 한 번에 변수 하나만 변경하고 연결을 다시 설정한 뒤 같은 대상에 접속해 조회 기록을 비교하세요. DoH를 사용해도 모든 요청이 자동으로 프록시를 통과하는 것은 아닙니다. DNS 조회 경로와 대상 연결 경로를 각각 확인하세요.

Test Method: 테스트 기준 통일

Settings에서 Test Method를 찾아 현재 화면에서 제공되고 현재 네트워크에 적합한 방식을 선택한 뒤 Home으로 돌아가 Connectivity Test를 실행하세요. 방식마다 확인하는 단계가 다르므로 측정 시간은 서로 직접 비교할 수 없습니다. 대상 주소가 필요한 테스트라면 먼저 해당 대상에 접속할 수 있는지 확인한 뒤 서버별 결과를 비교하세요.

테스트 통과가 모든 서비스에 접속할 수 있다는 뜻은 아니며, 시간 초과만으로 전체 연결이 완전히 작동하지 않는다고 단정할 수도 없습니다. 여러 서버를 비교할 때는 테스트 방식, 대상, 로컬 네트워크를 동일하게 유지하고 실제 요청 결과도 함께 확인하세요. 정렬 순서는 해당 시점의 테스트 결과일 뿐 장기적인 품질을 보장하지 않습니다.

Today Widget: 빠른 실행과 상태 확인

Today Widget 관련 옵션은 시스템에서 제공하는 빠른 확인 또는 실행 메뉴를 설정합니다. Settings에서 앱이 지원하는 항목을 확인한 뒤 시스템이 허용하는 위치에 추가하세요. 표시 방식은 시스템 환경에 따라 달라지므로 실제 화면을 기준으로 확인하고, 특정 시스템 레이아웃이 모든 기기에서 동일하다고 가정하지 마세요.

빠른 실행 메뉴를 사용하면 앱을 반복해서 여는 단계를 줄일 수 있지만, 설정 후 Home으로 돌아가 서버, Global Routing, 연결 상태를 확인하세요. 빠른 실행 메뉴와 앱 화면의 상태가 일시적으로 다르게 표시되면 서버 매개변수를 바로 바꾸기보다 앱을 열어 상태를 다시 확인합니다. 연결이 성립했는지와 대상 요청이 정상인지도 각각 확인해야 합니다.

iCloud: 동기화 범위와 복원 순서

Settings에서 iCloud 관련 동기화 또는 백업 옵션을 확인하세요. 현재 화면에 표시된 동기화 대상을 먼저 읽고 활성화 여부를 결정합니다. 구성 동기화는 구매 내역 복원과 다릅니다. 앱 구매와 이전에 구입한 항목 복원은 App Store에서 진행합니다. 기기별 시스템 권한과 현재 연결 상태까지 파일과 함께 완전히 복사된다고 가정해서는 안 됩니다.

활성화하기 전에 기기에 저장된 구성을 보관하세요. 특히 두 기기에서 모두 설정을 변경한 적이 있다면 먼저 백업하는 것이 좋습니다. 복원 후에는 구독, 서버 선택, 현재 Config를 항목별로 확인한 다음 수동으로 연결을 테스트하세요. 구독 URL이나 인증 정보가 포함된 내용은 민감 정보로 취급해야 합니다. 동기화가 편리하더라도 백업 범위와 내용을 확인하는 절차는 생략할 수 없습니다.

Diagnostics: 문제 상황에 맞춰 단서 수집

Diagnostics에서는 현재 앱에서 제공하는 진단 항목을 확인하거나 실행할 수 있습니다. Settings에서 관련 메뉴를 찾으세요. 시작하기 전에 문제가 발생하는 단계를 구분합니다. 구독 업데이트 실패, 연결 설정 실패, 도메인 조회 실패, 특정 대상 요청 실패 중 어디에 해당하는지 확인하세요. 현재 네트워크, 모드, 작업 순서를 기록한 다음 증상에 맞는 검사를 실행합니다.

한 번에 한 가지 설정만 조정한 뒤 같은 상황을 재현해 결과를 비교하세요. 진단 자료에 주소, 도메인, 요청 정보 또는 인증 관련 내용이 포함될 수 있으므로 공유하기 전에 확인하고 민감한 부분을 가리세요. 진단 도구는 단서를 제공할 뿐 자동으로 문제를 해결해 주지는 않습니다. 로컬 설정이 보유한 자료와 일치해도 서버 측 상태와 대상 서비스의 사용 가능 여부를 계속 확인해야 합니다.

07 · 실제 점검 순서

연결 정보부터 규칙 일치까지

원인을 찾기 어려워지지 않도록 여러 조건을 동시에 바꾸지 말고 단계별로 점검하세요.

  1. 연결 정보를 확인합니다. Subscribe 업데이트 결과를 확인하거나 Add Server에서 프로토콜, 주소, 포트와 인증 항목을 하나씩 점검하세요. 비교할 수 있도록 원본 정보를 보관합니다.
  2. 현재 선택 항목을 확인합니다. Home에서 실제 서버와 Global Routing을 확인하세요. 이전에 사용한 설정을 기억에 의존하지 말고 목록의 첫 번째 항목을 현재 선택된 항목으로 간주하지 마세요.
  3. 먼저 연결을 테스트한 다음 규칙 분기를 확인합니다. Connectivity Test와 실제 요청 결과를 함께 확인하세요. Config를 사용한다면 구성 파일, 정책 참조, 규칙 순서를 추가로 점검합니다.
  4. DNS와 대상 접속을 따로 확인합니다. DNS 조회 성공과 연결 성공은 별도의 단계입니다. 증거가 DNS 문제를 가리킬 때만 조회 설정을 조정하고, 다른 문제를 DNS 변경으로 덮지 마세요.
  5. 마지막으로 자동 기능을 다시 활성화합니다. 수동 상태 확인을 마친 뒤 On Demand, 동기화, 빠른 실행 메뉴를 활성화하고 네트워크 전환 후 실제 동작을 살펴보세요.

처음 실행하는 단계부터 확인하려면 시작하기를 참고하세요. 여러 구독과 구성 파일을 정리하려면 구독 안내를 확인할 수 있습니다. 구매 및 기기 호환성은 App Store 정품 확인 페이지에서 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 대조하세요. 가격, 시스템 요구 사항, 통합 구매 정보는 App Store 페이지의 안내를 기준으로 합니다.

Shadowrocket App Store에서 다운로드