Shadowrocket 공식 매뉴얼
Shadowrocket
사용법 및 설정 안내
iOS / iPadOS용 규칙 기반 프록시 클라이언트입니다. App Store 정품이며 일회성 구매로 이용할 수 있습니다. 먼저 기존 설정을 준비한 뒤 단계에 따라 연결하세요.
On Demand 및 DNS 설정 참고
규칙, 설정 파일 및 연결 정책
서버 정보는 연결 대상을 정하고, Config는 요청을 어떻게 분배할지 결정하며, Settings는 연결과 진단 동작을 제어합니다. 세 항목을 따로 확인하면 여러 설정을 한꺼번에 바꾸는 것보다 문제 원인을 쉽게 찾을 수 있습니다.
규칙 설정: DOMAIN-SUFFIX / GEOIP / FINAL
규칙은 요청마다 지정된 정책을 적용합니다. Config에서 현재 활성화된 설정을 확인하고 Global Routing이 Config를 사용하도록 되어 있는지 확인해야 규칙이 적용됩니다. DOMAIN-SUFFIX는 도메인 접미사를 기준으로, GEOIP는 주소가 속한 지역을 기준으로 일치 항목을 찾습니다. FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. 규칙은 보통 순서대로 확인하므로 구체적인 조건을 기본 처리 규칙보다 앞에 배치하세요. 변경한 뒤에는 저장하고 실제로 어떤 정책이 적용되는지 확인하세요. 연결 스위치가 켜져 있다는 이유만으로 규칙이 올바르게 적용된다고 판단하면 안 됩니다.
옵션 안내 보기On Demand: 조건에 따라 연결하기
On Demand는 지정한 조건에 따라 시스템 VPN 연결을 시작하는 기능이며, 서버가 정상적으로 작동한다는 보장은 아닙니다. 먼저 Home에서 수동으로 연결해 기존 설정이 유효한지 확인한 뒤 Settings에서 On Demand 관련 항목을 살펴보세요. 설정하기 전에 어떤 네트워크 조건에서 연결할지 정해 자동 연결과 규칙 분배를 혼동하지 않도록 합니다. 자동 연결은 연결을 시작할 시점을 정하고, 규칙 분배는 요청에 적용할 정책을 정합니다. 테스트를 완전히 중단하려면 이 설정도 확인해 조건에 따라 시스템이 다시 연결되지 않도록 하세요.
On Demand 설정 보기Subscribe: 기존 구독 가져오기
구독을 사용하면 기존 서버 정보 목록을 클라이언트에 한꺼번에 가져올 수 있으며, 이후 업데이트를 통해 구독에서 제공하는 항목의 변경 사항을 반영할 수 있습니다. 가져오기 전에 링크가 온전한지 확인하세요. 복사 과정에서 공백이나 줄바꿈이 들어가거나 매개변수가 만료되지 않았는지 특히 살펴보세요. Add Server에서 Subscribe를 선택하고 앱 내 항목을 입력한 뒤 저장하세요. 목록으로 돌아와 항목이 예상대로 표시되는지도 확인합니다. 목록을 가져올 수 있다고 해서 모든 서버에 연결할 수 있는 것은 아니므로 사용할 항목을 선택해 따로 확인해야 합니다. 구독 주소에는 접근 정보가 포함될 수 있으니 공개 스크린샷이나 로그에 노출하지 마세요.
가져오기 단계 보기Config: 설정 파일과 서버 항목 구분하기
Config 파일에는 General, Rule, Hosts 등의 설정이 들어갈 수 있으며, Home의 서버 항목과는 별개의 구성 요소입니다. 설정을 수정하기 전에 사용할 수 있는 사본을 보관하고 현재 선택된 파일을 확인하세요. 다른 설정을 가져온 뒤에는 규칙과 정책 참조를 살펴보고 참조된 이름에 해당하는 항목이 있는지 확인해야 합니다. 파일을 가져오는 데 성공해도 필요한 항목이 모두 준비된 것은 아닙니다. 한 번에 한 항목만 변경하고 저장한 뒤 관련 요청이 어떻게 처리되는지 확인하세요. 문제가 생기면 모든 설정을 다시 만들 필요 없이 어느 사본으로 되돌릴지 명확히 알 수 있습니다.
Config 및 설정 안내 보기Global Routing：Config / Proxy / Direct
Global Routing은 전체 요청을 처리하는 방식을 정합니다. Config는 현재 설정의 규칙에 따라 요청을 분배하고, Proxy는 요청에 프록시 정책을 적용하며, Direct는 직접 연결합니다. 규칙을 적용하려면 여기서 Config를 선택한 다음 해당 규칙을 확인하세요. 문제를 진단할 때는 처리 방식을 잠시 바꿔 같은 대상의 결과를 비교할 수 있지만, 테스트가 끝나면 원래 의도한 설정으로 되돌려야 합니다. 처리 방식을 바꾸더라도 잘못된 주소나 인증 정보, DNS 문제가 해결되지는 않습니다. 모든 앱의 요청이 같은 경로로 처리된다는 증거가 되지도 않습니다.
모드 선택 단계 보기여러 프로토콜 지원: 기존 서버 정보와 매개변수를 일치시키세요
Shadowrocket은 Shadowsocks, VMess, VLESS, Trojan, Hysteria2 등 여러 프로토콜을 지원합니다. Add Server에서 기존 서버 정보에 맞는 Type을 선택한 다음 해당 항목을 입력하세요. 프로토콜마다 필요한 인증 및 전송 매개변수가 다르므로 한 유형의 비밀번호나 UUID를 다른 유형의 설정으로 그대로 사용할 수 없습니다. 주소와 포트가 맞더라도 TLS, SNI 또는 전송 계층 설정이 올바르다는 뜻은 아닙니다. 기존 설정을 가져오는 방법을 우선 이용하세요. 직접 입력해야 한다면 원본 정보를 항목별로 대조하고 Type을 바꿔가며 추측하지 마세요.
프로토콜 개념 보기Ping / Log / Data: 서로 다른 문제를 각각 확인
Connectivity Test와 Ping은 연결 가능 여부를 확인하는 데 참고할 수 있지만, 테스트 결과가 실제 요청을 확인하는 절차를 대신하지는 않습니다. 연결에 실패하면 먼저 테스트 방법을 기록하고 Log에서 오류 단서를 확인하세요. DNS, 인증, 핸드셰이크 문제는 각각 따로 점검해야 합니다. Data는 앱에 기록된 트래픽 통계를 확인하는 기능이지 연결 서비스의 과금 내역이 아닙니다. 이상 여부를 판단할 때는 집계 범위와 시간을 확인하고 누적 기록을 현재 속도로 오해하지 마세요. 문제 해결 정보를 공유하기 전에 구독 주소, 인증 매개변수, 접근 기록이 노출될 수 있는 내용을 가리세요.
Log 문제 해결 참고 보기iCloud: 동기화 전에 백업 범위 확인
iCloud 동기화는 본인 기기 간에 설정을 이어서 사용할 때 유용하지만, 앱 구매 내역과 설정 데이터는 서로 다른 복원 대상입니다. 기기를 바꾸기 전에 앱 내 동기화 옵션과 시스템 iCloud 상태를 확인하고 중요한 설정은 별도로 백업하세요. 모든 로컬 기록이 동기화된다고 가정하면 안 됩니다. 새 기기에서 복원한 뒤에는 서버 항목, 현재 Config, Global Routing을 확인하고 실제 연결 테스트를 진행하세요. 이전 기기와 새 기기의 내용이 다르면 어느 쪽이 사용할 사본인지 먼저 확인해, 검토 없이 아직 쓸 수 있는 설정을 덮어쓰지 않도록 합니다.
iCloud 설정 참고 보기설정 안내를 읽는 순서
처음 사용할 때 Settings를 하나씩 모두 조정할 필요는 없습니다. 먼저 설정을 가져오고 수동으로 연결해 반복해서 확인할 수 있는 기준 상태를 만드세요. 그다음 필요한 경우 DNS, On Demand 또는 Proxy를 살펴보면 됩니다. DNS는 도메인 이름을 해석하고 규칙은 적용할 정책을 선택합니다. 서로 관련은 있지만 같은 기능은 아닙니다. 도메인에 접속할 수 없다면 이름 해석 실패, 예상과 다른 정책 적용, 서버 연결 실패를 구분하세요. 여러 설정을 한꺼번에 바꾸면 원인을 파악하기 어렵습니다.
규칙 예시의 example.com은 설명용 도메인이고, PROXY는 예시 정책 이름입니다. 사용하기 전에 설정에 해당 정책이 있는지 확인하세요. 이 예시는 구문을 설명하며 바로 연결할 수 있는 서버를 제공하지 않습니다. 설정 항목의 의미를 잘 모르겠다면 먼저 개념 빠르게 찾기를 읽고 옵션 안내에서 현재 화면의 항목을 확인하세요.
Config 및 Log 참고
iPhone 및 iPad에서 앱 받기
먼저 스토어에서 정품 여부를 확인한 뒤 기기에 맞게 구매하거나 복원하세요. 시스템 요구 사항과 구매 적용 범위는 App Store 페이지에 표시된 내용을 기준으로 하며, 기기에서 실제로 표시되는 스토어 화면을 따라 진행하면 됩니다.
iPhone
App Store 제품 페이지에서 개발자와 앱 ID를 확인한 뒤 Shadowrocket을 실행하세요. 처음 연결할 때 시스템 안내에 따라 VPN 구성을 허용해야 합니다. 이는 연결에 필요한 시스템 절차이며 서버 매개변수를 자동으로 설정해 주지는 않습니다.
iPhone에서 받는 방법 보기 →iPad
같은 Apple ID의 구매 내역에서 앱을 찾을 수 있습니다. iPhone과 iPad의 구매 적용 범위는 App Store 페이지에 표시된 내용을 기준으로 확인하세요. 다시 받은 뒤에도 기기에 저장된 설정을 따로 확인해야 합니다. 구매 내역을 복원해도 구독과 규칙이 자동으로 복원되지는 않습니다.
iPad에서 받는 방법 보기 →Mac 및 Apple TV에서도 같은 App Store에서 받을 수 있습니다. 호환성, 시스템 요구 사항 및 구매 적용 범위는 App Store 페이지에 표시된 내용을 기준으로 확인하세요.
기존 설정으로 빠르게 시작하기
시작하기 전에 본인이 사용할 권한이 있는 구독 링크나 서버 정보를 준비하세요. 다음 순서에 따라 먼저 정보를 입력하고, 라우팅 방식을 정한 뒤, 결과를 확인합니다. 앱을 구매했다고 해서 설정 준비까지 완료된 것은 아닙니다.
-
서버 추가 또는 Subscribe 가져오기
Home에서 Add Server를 열고 기존 정보에 맞는 Type을 선택하세요. 구독을 사용하는 경우 Subscribe를 선택하고 링크 전체를 붙여 넣습니다. 직접 입력한다면 주소, 포트, 인증 및 전송 설정을 하나씩 확인하세요. 저장한 뒤 목록으로 돌아와 항목이 나타나는지 확인하고 이번에 테스트할 서버를 선택합니다. 목록이 비어 있으면 연결 테스트로 넘어가기 전에 구독을 가져온 결과부터 확인하세요.
Scan QR Code를 사용해 본인이 이미 보유한 설정의 QR 코드를 읽을 수 있습니다. 인식한 뒤에도 유형과 내용을 확인하고, 특히 QR 코드의 출처를 신뢰할 수 있는지 살펴보세요. 설정의 의미를 모르는 상태에서 기존에 작동하는 설정을 덮어쓰지 말고, 인증 정보가 포함된 QR 코드를 공개적으로 전달하지 마세요.
-
Config, Proxy 또는 Direct 선택
규칙을 적용하려면 Config를 선택하고 현재 활성화된 Config 파일을 확인하세요. Proxy와 Direct는 처리 방식을 비교하는 데 사용할 수 있지만 서버 목록의 다른 연결 항목은 아닙니다. 처음 사용할 때는 서버의 사용 가능 여부를 확인할지, 특정 규칙이 일치하는지 확인할지 먼저 정하세요. 두 테스트는 확인해야 할 정보가 다르므로 함께 묶어 결론을 내리지 않는 것이 좋습니다.
가져온 설정이 특정 정책 이름을 참조한다면 해당 이름에 맞는 항목이 있는지 확인하세요. 규칙 문구만 복사하고 정책 참조를 준비하지 않으면 예상과 다른 결과가 나올 수 있습니다. DOMAIN-SUFFIX, FINAL, DIRECT의 의미는 개념 안내에서 각각 확인할 수 있습니다.
-
연결 스위치를 켜고 실제 요청 확인
Home에서 연결 스위치를 켜고 시스템 안내에 따라 VPN 구성 권한을 허용한 뒤 Connectivity Test로 연결 상태를 확인하세요. 이어서 확인하려는 대상에 접속하고 Log에서 처리 단서를 살펴봅니다. 연결 상태, 테스트 결과, 대상에 접속한 결과는 서로 다른 정보입니다. 스위치가 켜져 있다는 것은 연결 절차가 시작되었다는 뜻일 뿐 규칙과 도메인 해석이 올바르다는 증거는 아닙니다.
실패하면 먼저 증상을 기록한 뒤 서버 매개변수, 인증, DNS, 규칙 일치 여부를 차례로 확인하세요. 한 번에 한 항목만 변경하고 같은 테스트를 반복해 결과가 달라졌는지 기록합니다. Data에 트래픽이 표시되더라도 접속 확인을 대신할 수 없습니다. 통계가 늘어난 것과 대상 요청이 성공한 것은 서로 다른 결과입니다.
개발자, 아이콘 및 앱 ID
Shadowrocket은 소스가 공개되지 않은 유료 앱입니다. 정품 여부는 이름이 비슷한 앱, 검색 결과 순위 또는 확인되지 않은 소개가 아니라 App Store 제품 페이지에서 직접 확인할 수 있는 정보를 바탕으로 판단하세요.
제품 페이지를 확인한 뒤 구매 진행
스토어 제품 페이지를 열고 이름이 Shadowrocket인지 확인한 다음 개발자가 Shadow Launch Technology Limited인지 확인하세요. 아이콘도 이 사이트에서 사용하는 공식 아이콘과 대조합니다. 제품 링크 끝의 id932747118은 앱 ID입니다. 세 가지 정보를 함께 확인해야 합니다. 이름이나 아이콘 색상이 비슷하다는 점만으로는 정품 여부를 판단할 수 없습니다. 이 사이트의 앱 받기 안내에는 구매 전에 항목별로 확인할 수 있도록 관련 정보가 정리되어 있습니다.
일회성 구매는 클라이언트 이용 권한입니다
미국 스토어 가격은 약 2.99달러이며 일회성 결제입니다. 각 스토어에는 현지 통화로 표시되며 실제 결제 금액은 App Store 페이지와 구매 확인 화면을 기준으로 합니다. 클라이언트 일회성 구매 ≠ 연결 서비스 요금제. 앱 구매와 연결 서비스는 별개입니다. 처음 실행한 뒤에도 기존 구독이나 서버 정보를 가져와야 합니다. 이 사이트는 공식 홈페이지 및 공식 매뉴얼로, 서버나 구독을 제공하거나 판매 또는 추천하지 않으며 기존 설정을 가져오고 구성하고 문제를 해결하는 방법만 안내합니다.
구매 내역과 기기 설정은 따로 복원
iPhone과 iPad에서는 해당 Apple ID의 구매 내역으로 앱을 찾을 수 있습니다. 구체적인 구매 적용 범위는 App Store 페이지에 표시된 내용을 기준으로 확인하세요. 기기를 바꾸거나 앱을 다시 설치할 때는 먼저 스토어에 이전 구매 계정으로 로그인했는지 확인한 다음 구매 항목을 살펴보세요. 다시 받기 대신 구매 가격이 표시되면 재구매를 서두르지 말고 계정과 스토어를 먼저 확인하세요. 앱을 다시 받은 뒤에도 설정 백업, iCloud 상태, 기존 구독이 복원되었는지 각각 확인해야 합니다. 앱을 구매해도 서버 정보가 생성되지는 않습니다.
스토어 표시 여부와 계정 국가 또는 지역
제품이 현재 스토어에 표시되는지는 App Store의 실제 표시 내용과 계정 국가 또는 지역에 따라 다릅니다. 검색 결과에 나타나지 않으면 먼저 정품 제품 페이지에서 앱을 확인하고 현재 계정의 국가 또는 지역 및 스토어 안내를 살펴보세요. 계정 지역을 변경해야 한다면 기기의 Apple 계정 관련 안내를 먼저 읽고 잔액, 구독, 결제 수단 등의 조건을 확인하세요. 웹페이지가 열린다고 해서 현재 계정으로 반드시 구매할 수 있는 것은 아닙니다. 최종적으로 스토어 내 구매 절차를 기준으로 확인하세요.
업데이트, 시스템 요구 사항 및 설정 재확인
Shadowrocket은 App Store에서 받고 업데이트할 수 있습니다. 자동 업데이트 설정은 기기 시스템의 App Store 설정에서 확인하세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 업데이트 후 안내에 나온 항목 위치와 다르면 화면에 표시된 영문 이름으로 해당 항목을 찾은 뒤 현재 설정과 연결 결과를 확인하세요. 중요한 설정을 수정하기 전에 사본을 보관하면 기억에 의존해 매개변수를 다시 입력하는 것보다 복구하기 쉽습니다.
구매 내역을 더 확인하려면 구매 항목 복원 안내를 읽어보세요. 앱은 열리지만 아직 연결되지 않는다면 첫 연결 안내를 확인하세요. Subscribe와 Config의 차이가 헷갈린다면 먼저 개념 빠르게 찾기를 살펴보세요. 구독 목록 업데이트와 규칙 파일 교체는 서로 다른 작업입니다.
매개변수 입력, 첫 연결 및 기기 이전
다음 문서에서는 클라이언트 사용 방법을 다룹니다. 문제가 프로토콜 매개변수, 구매 및 연결, 설정 복원 중 어디에 해당하는지 확인한 뒤 관련 절차를 읽어보세요. 연결에 필요한 정보는 본인이 이미 보유한 서버 정보를 기준으로 합니다.
Trojan 프로토콜 안내: Shadowrocket에서 Trojan 서버를 추가할 때 입력할 매개변수
Trojan의 작동 방식을 소개하고 주소, 포트, 비밀번호, SNI, Allow Insecure 항목을 입력할 때 주의할 점을 하나씩 설명합니다. 매개변수는 기존 서버 정보와 일치해야 하며, 인증서 검사를 완화해 올바른 설정을 대신해서는 안 됩니다.
백업 및 이전Shadowrocket 설정 백업 및 새 기기로 복원: iCloud 동기화와 Config 파일 내보내기
iCloud 동기화, Config 내보내기 및 가져오기를 확인하는 순서를 정리하고 구매한 앱 복원과 설정 복원을 구분합니다. 기기를 옮기기 전에 보관할 사본을 확인하고, 이전한 뒤에는 서버와 규칙, 실제 연결 결과를 점검하세요.
시작하기Shadowrocket 초보자가 자주 묻는 질문 10가지: App Store 구매부터 첫 연결까지
정품 확인, 일회성 구매, 구독 가져오기, Global Routing 선택 등 자주 묻는 내용을 모았습니다. 구매, 설정 준비, 연결, 확인 순서로 읽고 실패하면 먼저 문제가 발생한 단계를 파악하세요.
구체적인 오류가 표시되면 문제 해결을 바로 확인하세요. 영문 설정 항목의 의미를 알고 싶다면 옵션 안내에서 이름으로 찾아보세요.