공식 매뉴얼 · 문제별 안내

Shadowrocket 문제 해결

문제가 발생한 단계에 따라 찾아보세요: 스토어 확인, 설치 및 첫 실행, 기존 구독 가져오기, 연결 및 규칙.

스토어 관련 내용은 iPhone / iPad에 해당하며, 설치 안내는 Mac, Windows, Android, Linux도 다룹니다. 연결 안내는 iPhone / iPad의 메뉴명을 예로 사용합니다.

01 스토어

정품 확인 및 구매

먼저 제품 항목을 확인하고 호환성, 스토어 지역, 구매 내역을 살펴보세요.

다운로드 페이지의 확인 안내 보기
App Store에서 Shadowrocket 정품을 확인하는 방법은?

App Store 제품 페이지에서 세 가지를 확인하세요. 개발자 이름이 Shadow Launch Technology Limited인지, 아이콘이 이 페이지 상단의 공식 아이콘과 일치하는지, 제품 페이지 주소 끝에 id932747118이 있는지 확인합니다. 앱 이름이나 검색 결과의 아이콘만으로는 같은 앱인지 확인하기 어렵습니다. 구매 전에 현재 스토어에 표시된 가격과 기기 호환성도 확인하세요.

컴퓨터와 Android에서도 사용할 수 있나요? 구매한 앱에 서버가 포함되나요?

사용할 수 있습니다. iPhone / iPad 버전은 미국 App Store에서 $2.99 일회성 결제이며, 정확한 가격은 스토어 페이지를 확인하세요. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료입니다. 컴퓨터와 Android 설치 파일은 사이트 다운로드 페이지를 통해 /dl/shadowrocket/에서 제공됩니다. 앱의 일회성 구매와 서버 이용 요금제는 별개입니다. 가져오려면 이미 보유한 구독 또는 서버 정보를 사용하세요.

iPad에 설치할 수 있나요? 시스템 요구 사항은 어떻게 확인하나요?

가능합니다. iPhone과 iPad는 같은 App Store 제품 항목을 사용합니다. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 확인하세요. iPad에서 제품 페이지의 ‘호환성’을 확인한 다음, 시스템 ‘설정’의 ‘정보’에서 설치된 iPadOS 버전을 확인하세요. 기기가 호환되지 않는다는 안내가 나오면 먼저 시스템을 업데이트할 수 있는지 확인하세요. 같은 이름의 앱을 반복해서 검색할 필요는 없습니다.

App Store에서 Shadowrocket이 검색되지 않을 때 먼저 확인할 것은?

기기의 언어와 지역이 아니라 구매 계정의 스토어 국가 또는 지역을 먼저 확인하세요. 시스템 ‘설정 → Apple ID → 미디어 및 구입 항목 → 계정 보기 → 국가/지역’을 엽니다. 앱의 표시 여부는 해당 스토어에 따라 달라집니다. 변경이 필요하다면 같은 화면에서 국가 또는 지역 변경을 선택하고, Apple 안내에 따라 잔액, 기존 구독, 결제 방법을 먼저 확인하세요.

새 iPhone 또는 iPad로 바꾸면 다시 구매해야 하나요?

기존 구매 계정을 사용하고 앱을 다시 다운로드할 수 있다면 재구매할 필요가 없습니다. 새 기기에서 App Store를 열고 프로필 사진을 눌러 구입 항목에서 Shadowrocket을 찾으세요. 찾을 수 없다면 ‘미디어 및 구입 항목’에 로그인한 계정과 현재 스토어를 먼저 확인하세요. 앱을 다시 다운로드해도 모든 설정이 자동으로 복원되지는 않으므로, 기기를 바꾸기 전에 보관할 Config를 별도로 백업하세요.

02 기기

설치 및 첫 실행

운영체제와 칩에 맞는 버전을 선택한 뒤 호환성, 권한, 연결 관련 안내를 확인하세요.

플랫폼별 설치 방법 보기
Mac에서는 Apple 실리콘 버전과 Intel 버전 중 무엇을 선택해야 하나요?

Apple 메뉴 → ‘이 Mac에 관하여’를 엽니다. ‘칩’에 Apple M 시리즈가 표시되면 다운로드 페이지에서 Apple 실리콘 버전을 선택하고, ‘프로세서’에 Intel이 표시되면 Intel 버전을 선택하세요. 두 설치 파일 모두 dmg 형식이므로 확장자로 칩 종류를 구분할 수 없습니다. 이 Mac에서 앱을 사용할 수 없다는 안내가 나오면 이 페이지에서 사양을 다시 확인하세요. 아키텍처가 맞지 않는 문제를 보안 차단으로 오해하지 마세요.

Mac 또는 Windows에서 위험할 수 있다는 경고가 표시되면 처음 실행을 어떻게 해야 하나요?

먼저 실행을 중단하고, 파일을 사이트 다운로드 페이지의 /dl/shadowrocket/에서 받았는지, 기기의 운영체제와 아키텍처에 맞는지 확인하세요. 출처가 분명하고 개발자 또는 게시자를 확인할 수 없다는 안내만 표시되며 기기 정책상 허용되는 경우에만 한 번 실행을 허용할지 고려하세요. macOS에서는 ‘시스템 설정 → 개인정보 보호 및 보안’에서 ‘그래도 열기’를 확인하고, Windows에서는 SmartScreen의 ‘추가 정보’에서 ‘실행’을 확인할 수 있습니다. 악성 소프트웨어, 불명확한 파일 출처 또는 조직 관리 기기라는 경고가 표시되면 차단을 우회하지 마세요.

Android와 Linux 설치 중 권한 문제와 잘못된 설치 파일을 어떻게 구분하나요?

Android에서는 기기가 arm64를 지원하는지 먼저 확인하세요. 설치 권한 안내만 표시된다면 파일 출처를 확인한 뒤, 설치 파일을 여는 앱에만 ‘알 수 없는 앱 설치’를 일시적으로 허용하고 설치 후 해제하세요. Linux는 배포판에 맞는 패키지를 선택합니다. Debian 또는 Ubuntu에서는 deb, Fedora 또는 RHEL에서는 rpm을 사용하세요. AppImage를 사용하는 경우 출처를 확인한 뒤 해당 파일에 실행 권한을 부여합니다. 아키텍처 불일치나 의존성 오류가 발생하면 배포판과 프로세서를 먼저 확인하세요. 권한을 높이는 것이 모든 문제의 해결책은 아닙니다.

iPhone 또는 iPad에서 연결 스위치가 켜지지 않을 때 먼저 확인할 것은?

먼저 Home에서 사용할 수 있는 SERVER가 선택되어 있는지 확인하세요. 처음 연결을 켤 때 시스템이 VPN 구성 추가를 허용하라고 요청할 수 있습니다. 안내에 표시된 앱 이름을 확인한 뒤 승인하세요. 이전에 거부했다면 Home으로 돌아가 다시 시도하고 시스템 안내가 다시 표시되는지 확인하세요. 다른 VPN을 사용 중이라면 잠시 연결을 끊어도 되는지 확인한 다음 다시 시도하세요. 관리 기기에 적용된 제한은 관리자에게 확인해야 합니다.

앱 화면이 영어라면 매뉴얼을 따라 할 때 어떤 단어를 찾아야 하나요?

iPhone 또는 iPad에서는 작업에 맞는 메뉴를 찾으세요. Home에서 연결 스위치와 Global Routing을, Config에서 현재 구성을, Settings에서 On Demand 등의 설정을 확인할 수 있습니다. Add Server는 이미 보유한 서버 정보를 입력하는 메뉴이고, Subscribe는 기존 구독을 가져오는 메뉴입니다. 매뉴얼에는 이 영어 메뉴명을 그대로 사용하므로 시스템 언어를 바꾸지 않아도 찾을 수 있습니다.

03 가져오기

구독 및 서버 가져오기

이미 보유한 구독 또는 서버 정보를 사용하세요. 먼저 입력 형식을 확인한 다음 가져온 결과를 점검하세요.

Subscribe 사용 방법 보기
Shadowrocket 구독을 가져오지 못할 때 어느 단계에서 문제가 생겼는지 확인하는 방법은?

먼저 Subscribe에 입력한 주소가 서비스 제공자로부터 받은 전체 구독 주소인지 확인하세요. 로그인 페이지 주소나 단일 서버 공유 링크와 혼동하지 마세요. 원본에서 주소를 다시 복사하고 끝부분이 잘렸거나 공백이 붙지 않았는지 확인한 뒤 현재 네트워크에서 다시 시도하세요. 권한이 없거나 링크가 만료되었다는 안내가 나오면 구독이 아직 유효한지 확인하세요. 형식을 인식할 수 없다는 안내가 나오면 원래 서비스 제공자에게 응답 형식을 확인하세요. 전체 링크를 공개된 페이지에 게시하지 마세요.

Shadowrocket 구독을 업데이트하려면 다시 추가해야 하나요?

주소가 바뀌지 않았다면 Home에 이미 있는 구독 항목을 업데이트하세요. 같은 이름의 항목을 새로 추가할 필요는 없습니다. 업데이트 후 구독을 펼쳐 이전에 선택했던 서버가 목록에 남아 있는지 확인한 다음 연결을 테스트하세요. 주소가 실제로 변경됐다면 새 주소를 가져오고 새 항목이 선택되는 것을 확인할 때까지 기존 항목을 유지하세요. 그런 다음 기존 항목을 삭제할지 결정하면 됩니다.

서버 정보만 있다면 Subscribe를 사용해야 하나요?

아니요. 단일 서버 정보를 이미 보유했다면 Add Server를 열고, 원래 정보와 일치하는 프로토콜을 선택한 다음 주소, 포트 및 해당 프로토콜에 필요한 항목을 원래 값대로 입력하세요. 주소에는 보통 프로토콜 접두어나 경로를 포함하지 않습니다. 별도로 입력하는 항목을 주소에 합치지 마세요. 예를 들어 VLESS와 Trojan은 필요한 인증 정보가 서로 다르므로 바꿔 사용할 수 없습니다. 저장한 뒤 Home으로 돌아가 해당 항목을 선택하고 테스트하세요.

QR 코드를 스캔했는데 예상한 서버 항목이 표시되지 않는 이유는 무엇인가요?

스캔 실패와 가져오기 실패를 구분하세요. 카메라가 인식하지 못하면 Shadowrocket의 카메라 권한과 QR 코드의 전체 표시 여부 및 선명도를 확인하세요. 인식은 됐지만 예상한 항목이 나타나지 않는다면 QR 코드에 구독 주소가 들어 있는지, 단일 서버 정보가 들어 있는지 확인하세요. 두 정보는 Home에서 표시되는 방식이 다릅니다. 웹 주소가 스캔됐다면 원본 정보로 돌아가 가져오기에 사용하는 주소인지 확인하세요. QR 코드에 인증 정보가 포함될 수 있으므로 문제를 확인하는 동안 공개적으로 전달하지 마세요.

구독 업데이트는 성공했는데 이전에 선택한 서버가 보이지 않으면 어떻게 해야 하나요?

업데이트 성공은 클라이언트가 이번 구독 내용을 읽었다는 뜻일 뿐, 이전 항목이 모두 유지됐다는 뜻은 아닙니다. 같은 구독을 펼쳐 목록을 확인하고 기존 항목이 삭제되거나 이름이 바뀌었는지 살펴보세요. 현재 선택할 수 있는 항목이 없다면 본인의 구독에서 서버를 다시 선택해 테스트하세요. Config의 규칙이 특정 정책이나 서버 이름을 참조한다면 참조 대상이 여전히 일치하는지도 확인하세요. Config 전체를 먼저 삭제할 필요는 없습니다.

04 연결

규칙 분기 및 문제 해결

기기의 현재 네트워크가 작동하는지 확인한 다음 같은 웹 주소로 연결 모드와 규칙을 비교하세요.

Settings 설정 매뉴얼 보기
Global Routing의 Config, Proxy, Direct 모드는 어떻게 선택하나요?

규칙에 따라 트래픽을 분기하려면 Config를 선택하세요. 현재 Config에서 각 요청이 PROXY 또는 DIRECT 중 어디로 연결될지 결정합니다. 선택한 서버가 클라이언트에서 처리되는 요청을 처리할 수 있는지 확인하려면 잠시 Proxy로 전환하세요. 흔히 글로벌 모드라고 부르는 방식입니다. 연결 스위치를 켠 상태에서 프록시 서버를 거치지 않은 접속과 비교하려면 Direct를 선택하세요. 테스트가 끝나면 원래 사용하던 모드로 되돌리세요.

연결은 켜져 있는데 웹페이지가 열리지 않을 때 어떤 순서로 확인해야 하나요?

먼저 연결을 끄고 같은 주소로 기기의 현재 네트워크가 작동하는지 확인하세요. 공용 Wi-Fi에서 로그인이 필요하면 먼저 로그인하세요. 네트워크가 정상이라면 다시 연결한 뒤 Home에서 선택한 SERVER를 확인하고 Connectivity Test를 실행하세요. 일부 도메인만 열리지 않는다면 현재 Global Routing 모드를 기록하고 활성 Config의 규칙과 DNS를 확인하세요. 한 번에 하나씩만 변경한 뒤 같은 웹 주소로 다시 테스트하세요.

Config로 전환했는데 요청이 예상과 달리 DIRECT로 가지 않는 이유는 무엇인가요?

먼저 현재 사용 중인 Config를 수정했는지 확인한 다음 [Rule]을 위에서부터 점검하세요. 같은 요청이 앞쪽에 있는 규칙에 먼저 일치할 수 있습니다. FINAL은 앞선 규칙에 모두 일치하지 않을 때만 적용됩니다. 웹페이지를 테스트할 때는 주소 표시줄의 도메인뿐 아니라 페이지가 리소스를 불러올 때 접속하는 다른 도메인도 살펴보세요. Log에서 실제 요청을 확인하고, 어떤 규칙이 잘못 일치했는지 파악한 뒤 순서를 조정하세요.

연결 후 배터리가 더 빨리 소모되는 것 같을 때 On Demand를 어떻게 점검하나요?

먼저 시스템 ‘설정 → 배터리’의 사용 기록을 확인하세요. 연결 아이콘만으로 원인을 판단하지 마세요. 당시 Wi-Fi와 셀룰러 네트워크 중 무엇을 사용했는지, 네트워크를 자주 전환했는지 기록한 다음 Settings에서 On Demand의 활성화 조건을 확인하세요. 필요할 때 자동 연결할 필요가 없다면 On Demand를 잠시 끄고 비슷한 네트워크 사용 환경에서 비교해 보세요. 확인 후 원래 설정으로 되돌려 다른 네트워크 사용 변화가 같은 원인으로 잘못 판단되지 않게 하세요.

Connectivity Test가 통과했는데도 실제 웹 주소로 테스트해야 하는 이유는 무엇인가요?

Connectivity Test 통과는 해당 테스트에서 사용한 대상에 접속할 수 있었다는 뜻일 뿐, 실제 웹 주소 접속 결과를 보장하지 않습니다. 같은 기기의 실제 요청도 서로 다른 규칙, DNS 조회 또는 서버를 사용할 수 있습니다. 문제가 발생한 원래 주소를 다시 열고 사용한 네트워크, Global Routing 모드, 오류 발생 시간을 기록하세요. Log를 확인할 때 이 정보로 요청을 찾고, 기록을 공유하기 전에 구독 주소와 인증 정보를 삭제하세요.