공식 매뉴얼 · 빠른 시작
Shadowrocket 가져오기 및 연결 가이드
‘정보 → 모드 → 연결 → 확인’ 순서로 진행하세요. 처음 설정할 때는 먼저 수동 연결을 완료한 다음 규칙과 자동 연결 조건을 조정합니다.
시작 전: 앱과 연결 정보를 각각 준비하세요이 가이드는 App Store에서 Shadowrocket을 설치했고 본인의 구독 링크 또는 서버 정보를 보유한 사용자를 대상으로 합니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 클라이언트 앱의 일회성 구매와 회선 요금제는 별개입니다.
아직 설치하지 않았다면 먼저 App Store 정식 다운로드 안내를 확인하세요. 개발자 Shadow Launch Technology Limited와 앱 ID
932747118을 대조하세요. 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요.
아래 내용은 주로 iPhone과 iPad에서의 사용 방법을 설명합니다. 이미지는 App Store 공식 스크린샷으로, 화면을 확인하는 데 참고하세요. 실제 항목과 배치는 기기에서 실행 중인 앱을 기준으로 하며, 스크린샷의 연결 정보를 그대로 입력하지 마세요.
단계 01 · 연결 정보
Add Server: 서버 추가 또는 구독 가져오기
Shadowrocket을 열고 Home으로 이동합니다. 아래의 SERVER 그룹에 서버 항목이 표시되며, Add Server에서 새 항목을 추가할 수 있습니다. 먼저 보유한 정보가 전체 구독 주소인지, 단일 서버 공유 링크인지, 주소·포트·인증 항목이 적힌 정보인지 확인하세요. 종류마다 추가 방법이 다릅니다. 구독 주소를 Host에 입력하거나 단일 서버 링크를 구독 주소처럼 반복 업데이트하지 마세요.
구독이 있는 경우: Subscribe 선택
서비스 제공업체에서 본인의 전체 구독 링크를 받은 뒤 Home에서 Add Server를 누르고 Type을 연 다음 Subscribe를 선택합니다. 주소를 URL 필드에 붙여 넣으세요. 처음과 끝, 쿼리 매개변수가 온전한지 확인하고, 복사할 때 공백이나 줄바꿈, 메신저의 문장부호가 함께 들어가지 않았는지 살펴보세요. 화면에서 저장한 뒤 Home으로 돌아가 구독 항목이 로드될 때까지 기다립니다.
가져오기가 완료되면 Home에 해당 그룹과 서버 항목이 표시되어야 합니다. 그룹을 펼쳐 사용할 항목을 선택하고 선택 상태인지 확인하세요. 구독 주소를 저장했다는 것은 앱이 주소를 기억했다는 뜻일 뿐입니다. 항목이 로드되지 않았다면 연결 단계로 넘어가지 말고 업데이트 결과를 확인하세요. 구독 업데이트는 원격 목록을 다시 가져오는 기능으로, 연결 스위치와는 다르며 기존 서버가 여전히 유효하다는 보장도 없습니다.
직접 입력: Type과 프로토콜 항목부터 확인
서버 정보를 보유하고 있다면 Add Server에서 올바른 Type을 먼저 선택한 뒤 Host, Port와 해당 프로토콜에 필요한 인증 정보를 차례로 입력합니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2 등은 필요한 항목이 서로 다릅니다. Type을 바꾸면 화면의 입력 항목도 달라질 수 있으므로 프로토콜을 먼저 선택해 잘못된 위치에 정보를 입력하지 않도록 하세요.
이미지에 나온 입력 항목을 예로 들면 Host는 서버 주소, Port는 포트이며 Password와 Method는 보유한 정보를 하나씩 대조해 입력해야 합니다. 다른 프로토콜에서 UUID, TLS, Server Name 또는 전송 매개변수를 요구하는 경우에도 제공된 정보와 일치시킵니다. 기억에 의존해 암호화 방식을 임의로 추가하거나 인증 항목을 생략하지 마세요. 저장한 뒤 Home으로 돌아가 새 항목을 찾아 선택합니다. 수정이 필요하면 해당 항목의 편집 화면을 다시 열고, 비슷한 이름의 항목을 여러 개 만들지 마세요.
QR 코드가 있다면 적절한 추가 화면에서 Scan QR Code를 사용하고 필요한 경우 카메라 접근을 허용하세요. Import from Cloud JSON은 별도의 가져오기 방법으로, 해당 형식의 파일이 있을 때만 사용합니다. QR 코드, 단일 공유 링크, 구독 주소, JSON 파일은 모두 연결 정보를 담고 있더라도 서로 바꿔 쓸 수 없습니다.
이 단계의 완료 기준: Home에 서버 항목이 표시되고 그중 하나가 선택되어 있습니다. 다음으로 Global Routing을 선택한 뒤 연결 스위치를 켭니다.
단계 02 · 요청 경로
Global Routing: Config, Proxy 또는 Direct 선택
Home으로 돌아가 Global Routing을 눌러 현재 모드를 확인합니다. 이 가이드에서는 Config, Proxy, Direct를 사용합니다. 여기서 요청에 적용할 경로 유형을 결정하며, SERVER에서 선택한 항목은 프록시가 필요한 요청에 사용할 서버를 정합니다. 둘의 역할은 다릅니다. 서버를 선택했다고 모든 요청이 그 서버를 거치는 것은 아닙니다.
- Config: 현재 설정의 규칙에 따라 요청에 PROXY, DIRECT, REJECT 또는 설정에 포함된 다른 정책을 적용합니다. 평소 규칙에 따라 사용하려면 먼저 설정 내용과 정책 참조를 확인하세요.
- Proxy: 일반 요청을 선택한 프록시 경로로 처리합니다. 서버가 기본적인 연결을 지원하는지 처음 확인할 때 적합합니다. 연결 문제를 해결하는 버튼은 아니므로 서버 정보가 잘못되면 연결에 실패할 수 있습니다.
- Direct: 일반 요청을 직접 접속시켜 비교할 때 사용합니다. 이 모드에서 대상에 접속할 수 있더라도 프록시 서버가 정상적으로 작동한다고 판단할 수는 없습니다.
Config: 설정 파일과 Rule 확인
Config 모드를 사용하려면 Config로 이동해 현재 선택되었거나 활성화된 설정 파일이 의도한 파일인지 확인한 다음 Rule을 살펴보세요. 이미지에는 설정 파일 편집 화면이 표시되어 있으며 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 서로 다른 콘텐츠 섹션입니다. Add Rule은 규칙을 추가하는 기능입니다. 파일을 열었다고 해서 현재 설정으로 적용된 것은 아닐 수 있으니 파일 목록으로 돌아가 선택 상태를 다시 확인하세요.
규칙은 설정에 지정된 순서에 따라 매칭됩니다. 아래 내용은 문법 예시일 뿐, 완전한 설정 파일을 대체할 수 없습니다. 첫 번째 줄은 도메인 접미사 매칭을, 두 번째 줄은 최종 매칭을 나타냅니다. PROXY, DIRECT, REJECT는 정책 키워드이지 서버 주소나 구독 정보가 아닙니다.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT처음 연결할 때 여러 규칙을 동시에 바꾸지 마세요. 먼저 Proxy 모드로 기본 접속을 확인한 다음 Config로 돌아와 분기 결과를 점검할 수 있습니다. Proxy에서는 접속되지만 Config에서 특정 대상에 접속할 수 없다면 서버 정보를 바로 다시 입력하기보다 규칙 매칭과 정책을 확인하세요. 복잡한 규칙을 조정하는 순서는 규칙 분기 및 문제 해결에서 확인하세요.
이 단계의 완료 기준: 현재 선택한 모드가 무엇인지, 프록시가 필요한 경우 어떤 서버를 사용할지 설명할 수 있습니다. 이 상태를 유지한 채 다음 단계에서 연결합니다.
단계 03 · 시스템 연결
Home: 스위치를 켜고 VPN 설정 승인
Home으로 돌아가 두 가지를 먼저 확인합니다. SERVER 그룹에서 올바른 서버가 선택되어 있는지, Global Routing이 앞 단계에서 사용할 모드로 설정되어 있는지 확인하세요. 그런 다음 상단 스위치를 켭니다. 연결 전에는 Not Connected가 표시될 수 있습니다. 스위치를 눌렀다는 사실만으로 연결에 성공했다고 판단하지 말고 이후 상태를 확인하세요.
처음 연결할 때 시스템에서 VPN 설정 추가를 요청할 수 있습니다. 이는 앱이 관련 네트워크 연결을 설정하도록 시스템이 허용하는 절차로, Config에서 규칙 파일을 추가하는 것과는 다릅니다. 요청을 시작한 앱이 Shadowrocket인지 확인한 뒤 시스템 안내에 따라 승인하고, 필요한 경우 기기 인증을 완료하세요. 앱으로 돌아와 상태가 바뀔 때까지 기다린 다음 실제 접속을 테스트합니다.
이전에 거부를 선택했다면 연결 스위치를 다시 켜 권한 요청이 다시 표시되는지 확인하세요. 그래도 설정을 만들 수 없다면 시스템 설정의 VPN 관리에서 관련 항목과 기기 제한을 점검합니다. 조직에서 관리하는 기기에는 추가 정책이 적용될 수 있으므로 기기 관리 지침을 따르고, 현재 문제와 무관한 설정을 반복해서 삭제하지 마세요.
시스템에 VPN 상태가 표시되면 터널이 설정되었거나 활성 상태라는 뜻입니다. 하지만 이것만으로 서버 인증, 도메인 확인, 대상 접속이 모두 정상이라고 단정할 수는 없습니다. 반대로 일부 규칙은 요청을 직접 접속시키므로 특정 페이지가 열린다는 사실만으로 모든 트래픽이 프록시를 거친다고 볼 수도 없습니다.
이번에는 수동 연결을 유지하고 On Demand는 사용하지 않습니다. 연결 직후 끊긴다면 표시된 안내와 발생 시간을 기록하고 뒤의 문제 해결 단계로 이동하세요. 스위치가 켜진 상태로 유지된다면 Connectivity Test와 실제 접속을 확인합니다. 어느 경우든 클라이언트를 다시 구매할 필요는 없습니다.
단계 04 · 결과 확인
Connectivity Test: 테스트와 실제 접속 결과를 구분해 판단
Home에서 Connectivity Test를 실행하고 테스트가 끝날 때까지 기다립니다. 결과는 선택한 테스트 방법과 대상의 응답 상태를 보여줄 뿐, 모든 웹사이트와 앱이 정상 작동한다는 의미는 아닙니다. 특정 항목에서 결과가 표시되지 않으면 먼저 상황을 기록하세요. 한 번의 테스트 결과만으로 구독 전체를 삭제하지 마세요.
이어서 접근 권한이 있고 정상적으로 이용할 수 있어야 하는 대상 페이지를 엽니다. 먼저 일반 웹페이지를 테스트한 다음 실제로 사용할 기능을 확인하세요. 페이지는 표시되지만 이미지, 로그인 또는 다른 요청이 실패한다면 각 요청을 따로 살펴봅니다. 한 페이지에서도 여러 도메인을 호출할 수 있으며 Config 규칙에 따라 각기 다른 정책이 적용될 수 있습니다.
- 연결 상태 확인: Home으로 돌아가 스위치가 계속 켜져 있고 연결 상태가 반복해서 바뀌지 않는지 확인합니다.
- 서버 경로 확인: 서버를 바꾸지 않은 채 Proxy로 기본 접속을 확인하고, 사용할 예정인 Config 설정과 비교합니다.
- 규칙 결과 확인: Config에서만 차이가 발생한다면 관련 도메인 규칙, 최종 매칭 규칙, 참조된 정책을 확인합니다.
비교할 때는 한 번에 조건 하나만 바꾸세요. 예를 들어 서버를 그대로 두고 Global Routing만 전환하거나, 모드를 유지한 채 보유한 다른 서버를 선택합니다. 각 변경 후 요청을 다시 보내고 필요한 경우 대상 페이지를 새로 여세요. 이전 연결과 캐시가 판단에 영향을 줄 수 있습니다. 구독 업데이트, 서버 변경, DNS 변경, 규칙 수정을 한꺼번에 하면 결과가 달라진 원인을 파악하기 어렵습니다.
확인이 끝나면 평소 사용할 모드로 되돌립니다. Data의 업로드·다운로드 수치는 트래픽이 발생했는지 확인하는 데 참고할 수 있지만, 수치가 증가했다고 대상 접속에 성공한 것은 아니며 모든 요청이 프록시를 거쳤다는 증거도 아닙니다. 연결이 유지되고 대상에 접속할 수 있으며 규칙이 예상대로 작동하는 상태를 안정적으로 재현할 수 있어야 기본 설정을 마친 것입니다.
단계 05 · 단계별 문제 해결
Settings: 실패 원인을 먼저 찾고 설정 변경하기
문제가 발생하면 먼저 연결을 끄고 현재 Wi-Fi 또는 셀룰러 네트워크에서 기본 접속이 가능한지 확인합니다. 로그인이 필요한 Wi-Fi라면 네트워크 인증을 먼저 완료하세요. 기본 네트워크가 작동하지 않는 상태에서 구독을 반복해서 업데이트하거나 규칙을 바꿔도 대개 해결되지 않습니다. 먼저 기본 접속을 복구한 다음 문제가 발생한 단계에 따라 점검하세요.
구독 항목이 표시되지 않음: 주소와 업데이트 결과 확인
서비스 페이지 주소나 단일 공유 링크가 아니라 전체 구독 주소를 사용했는지 확인하세요. 만료 여부, 잘린 매개변수, 현재 네트워크에서 구독 내용을 가져올 수 있는지도 점검합니다. 주소는 저장했지만 항목이 없다면 주소 추가와 콘텐츠 로드를 각각 확인해야 합니다. 계정 상태나 원격 콘텐츠와 관련된 오류라면 기존 서비스 제공업체에 문의하고, 개인 구독 주소를 공개 토론 게시판에 올리지 마세요.
스위치가 켜진 상태를 유지하지 못함: 권한과 인증 정보 확인
먼저 ‘시스템에서 VPN 설정을 허용하지 않음’과 ‘서버에 연결할 수 없음’을 구분하세요. 전자는 연결 권한 단계로 돌아가 확인하고, 후자는 Type, Host, Port와 인증 항목을 다시 대조합니다. 주소가 확인되더라도 포트에 연결할 수 있다는 뜻은 아니며, 포트에 연결되더라도 비밀번호나 다른 인증 정보가 올바르다는 뜻은 아닙니다. 명확한 오류가 표시되면 원문을 먼저 기록한 뒤 보유한 정보와 하나씩 대조하세요. 무작위로 항목을 바꿔가며 해결을 시도하지 마세요.
테스트와 웹 탐색 결과가 다름: Test Method와 규칙 확인
Settings에서 Test Method를 확인하고 현재 테스트 방식을 먼저 파악하세요. 테스트 방식에 따라 확인하는 대상이 다르므로 실제 서비스 요청 전체를 대신할 수는 없습니다. Proxy에서는 접속되지만 Config에서 실패한다면 Config로 돌아가 Rule을 확인하세요. 두 모드 모두 실패한다면 서버 정보, 기본 네트워크, 대상 서비스 상태를 점검합니다.
Settings에는 Diagnostics와 Proxy, TCP, UDP 관련 설정도 표시됩니다. 이를 모두 켜야 하는 ‘연결 향상’ 옵션으로 생각하지 마세요. 처음 문제를 점검할 때는 기존 설정을 유지하고, 확인된 근거가 특정 항목을 가리킬 때만 변경한 뒤 원래 값을 기록합니다. TCP 요청이 정상이라고 해서 UDP 요청도 정상이라고 단정할 수 없으므로 실제로 문제가 발생한 기능에 따라 구분해 확인하세요.
추가 분석이 필요하면 Diagnostics를 사용해 관련 정보를 수집할 수 있습니다. 발생 시간, 현재 네트워크, Global Routing, 선택한 서버와 오류 현상을 기록하면 원인을 좁히는 데 도움이 됩니다. 로그나 스크린샷을 공유하기 전에는 구독 주소, 비밀번호, UUID, 접근 토큰 및 기타 개인 정보를 가리세요. 진단 정보에는 접속한 도메인이 포함될 수도 있으므로 전체 내용을 공개하지 않는 것이 좋습니다.
이 페이지에서는 처음 사용하는 사용자를 위한 문제 해결 순서만 다룹니다. 더 자세한 내용은 Shadowrocket 연결 문제 및 규칙 문제 해결을 확인하세요. 구매 복원이나 App Store 국가·지역 문제는 App Store 가이드를 참고하세요. 계정 구매 문제는 연결 설정에서 해결하지 마세요.
단계 06 · 선택 설정
On Demand: 수동 연결이 안정된 뒤 활성화
On Demand는 조건에 따라 연결을 시작하는 기능으로, 잘못된 서버 정보나 만료된 구독을 수정하지는 않습니다. 앞 단계에서 수동 연결과 접속을 확인한 뒤 Settings에서 On Demand를 살펴보세요. 특정 네트워크에서 연결할지, 특정 조건에서 연결을 유지하지 않을지 등 원하는 동작을 먼저 정한 다음 현재 화면에 표시된 조건과 동작을 확인합니다.
처음 설정할 때는 확인하기 쉬운 조건 하나만 추가하세요. 저장한 뒤 조건이 일치하는 경우와 일치하지 않는 경우를 각각 테스트하고 Home으로 돌아가 연결 상태를 확인합니다. Wi-Fi 이름 조건에는 실제 네트워크 이름을 입력하고, 도메인 조건은 앱에서 안내하는 규칙 형식에 맞춰 입력하세요. 전체 웹페이지 주소와 도메인을 혼용하지 마세요. 조건이 여러 개라면 순서와 동작이 서로 충돌하지 않는지도 확인합니다.
수동으로 끈 뒤 연결이 다시 시작된다면 스위치 고장이라고 판단하기 전에 On Demand가 여전히 적용 중인지 확인하세요. 다른 연결 문제를 점검할 때는 On Demand를 잠시 중지해 수동으로 제어되는 상태에서 테스트할 수 있습니다. 기본 연결이 복구되면 자동 조건을 하나씩 다시 적용하세요.
이제 기본 사용 흐름을 마쳤습니다. 보유한 정보가 로드되고, 사용할 모드가 정해졌으며, 시스템에서 연결을 허용하고, 대상 접속까지 확인했습니다. 이후 문제가 발생하면 모든 설정을 처음부터 다시 하기보다 변경이 발생한 단계부터 확인하세요. 구독 내용이 바뀌었다면 업데이트를, 모드가 바뀌었다면 규칙을, 네트워크를 바꾼 뒤 실패한다면 기본 네트워크를 먼저 점검합니다.