공식 매뉴얼 · 첫 연결

Shadowrocket 사용법
구독 가져오기와 연결 확인

iPhone 및 iPad용 안내입니다. 먼저 기존 서버 정보를 저장하고, Global Routing을 선택한 뒤 시스템 권한을 허용하세요. 마지막으로 연결 상태와 실제 접속을 각각 확인합니다.

  • 01기존 정보 가져오기
  • 02라우팅 선택
  • 03연결 및 확인

STEP 01 / ADD SERVER

서버 추가 또는 Subscribe 가져오기

Shadowrocket을 열고 Home으로 이동하세요. 이 화면에서 기존 서버를 확인하고, 사용할 서버를 선택하며 연결을 제어할 수 있습니다. 처음 사용하는 경우 보유한 정보에 맞춰 추가 방법을 선택하세요. 서버 목록을 갱신할 수 있는 구독 주소가 있다면 Subscribe를 사용하고, 주소·포트·암호·프로토콜 정보가 각각 있다면 수동으로 추가합니다. 둘 중 한 가지 방법만 선택하면 됩니다. 가이드를 따라 하기 위해 같은 정보를 반복해서 가져올 필요는 없습니다.

구독 링크가 있는 경우: Subscribe 선택

Home 오른쪽 위의 추가 버튼을 누르고 Add Server를 여세요. Type에서 Subscribe를 선택한 다음 전체 구독 링크를 URL에 붙여 넣습니다. 메모 입력란이 있다면 알아보기 쉬운 이름을 입력해도 됩니다. 구독 링크에는 계정 정보가 포함되는 경우가 많으므로 복사할 때 물음표 뒤의 매개변수를 빠뜨리지 말고, 웹페이지 제목이나 설명, 끝부분의 공백은 함께 붙여 넣지 마세요.

내용을 확인하고 저장한 뒤 구독 정보를 가져올 때까지 기다렸다가 Home으로 돌아가 목록을 확인하세요. 성공 여부는 주소를 입력했는지가 아니라 선택 가능한 서버 항목이 표시되는지로 판단합니다. 구독 그룹만 보이고 서버가 없다면 가져오기가 진행 중인지, 현재 네트워크에서 구독 주소에 접속할 수 있는지, 링크가 유효한지 확인하세요. 같은 정보를 연속해서 다시 추가하지 마세요. 같은 구독이 여러 그룹으로 표시되면 이후 선택과 업데이트 과정에서 혼란이 생길 수 있습니다.

구독 주소는 서비스 제공업체가 클라이언트에 제공한 주소여야 하며, 계정 로그인 페이지나 주문 페이지 또는 일반 안내 페이지가 아니어야 합니다. 구독 정보 대신 웹페이지가 열리는 경우 Global Routing을 바꿔도 올바른 구독 주소가 되지는 않습니다. 서비스 제공업체에서 올바른 링크를 확인한 뒤 Add Server로 돌아가 URL을 수정하세요.

단일 서버 정보를 보유한 경우: 프로토콜을 선택하고 정보 입력

마찬가지로 Home에서 Add Server를 열고 Type에서 보유한 정보에 맞는 프로토콜을 선택하세요. 예를 들어 Shadowsocks, VMess, VLESS, Trojan 또는 WireGuard를 선택할 수 있습니다. 그런 다음 서비스 제공업체가 안내한 정보를 입력합니다. 프로토콜마다 필요한 항목이 다릅니다. 포트와 암호는 UUID를 대신할 수 없으며, WireGuard 키를 다른 프로토콜의 암호 입력란에 넣어서도 안 됩니다. 서버 이름만으로 프로토콜을 추측하지 마세요.

TLS 연결이 필요하다면 TLS, SNI 등의 관련 설정도 확인하세요. 전송 방식, 경로, 호스트 이름도 원래 제공된 정보와 일치해야 합니다. 인증서 검증 설정은 유지하고, 검증을 끄는 방법을 일반적인 문제 해결책으로 사용하지 마세요. 입력을 마치고 저장한 다음 Home으로 돌아가 사용할 서버를 누르고 선택 표시가 바뀌었는지 확인합니다. 여기까지는 정보를 저장한 단계이며, 다음 단계에서 요청이 이 서버를 어떻게 거칠지 결정합니다.

서비스 제공업체가 QR 코드를 제공한다면 Home의 추가 메뉴에서 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 권한을 허용하세요. 가져온 뒤에도 항목을 열어 프로토콜과 주소를 확인해야 합니다. 인식에 성공했다고 해서 정보가 유효하거나 연결이 완료된 것은 아닙니다. 프로토콜 항목의 자세한 의미는 Settings 설정 항목 및 옵션 매뉴얼을 참조하세요.

STEP 02 / GLOBAL ROUTING

Global Routing 모드 선택

정보를 가져온 뒤 Home에서 Global Routing을 여세요. 여기서는 클라이언트가 처리하는 요청의 라우팅 방식을 결정합니다. 사용할 서버를 고르는 것과는 별개의 작업입니다. 서버를 바꿔도 Direct가 자동으로 Proxy로 바뀌지 않으며, 구독을 가져왔다고 적절한 규칙이 활성화되는 것도 아닙니다. 처음 연결할 때마다 서버 선택과 라우팅 모드를 각각 확인하세요.

Config: 현재 규칙에 따라 처리

Config는 규칙에 따라 트래픽을 분기해야 하는 경우에 적합합니다. 요청은 현재 구성의 규칙에 따라 정책이 선택되며 PROXY를 거치거나 DIRECT로 처리되거나 REJECT될 수 있습니다. 이 모드를 선택하기 전에 하단의 Config로 이동해 현재 활성화된 구성을 확인하세요. 파일이 여러 개라면 이름만 보지 말고 실제로 선택된 항목과 규칙 내용을 확인해야 합니다.

구독과 구성 파일의 역할은 서로 다릅니다. Subscribe는 주로 서버 정보를 제공하고 Config에는 규칙과 관련 설정이 담깁니다. 목록에 서버가 있다고 해서 Config에 필요한 규칙이 있다는 뜻은 아닙니다. 서비스 제공업체가 구성 안내를 제공한다면 용도를 먼저 확인한 뒤 가져오세요. 내용을 모르는 원격 구성으로 기존 파일을 바로 교체하지 마세요. 변경 전에는 기존 구성을 보관해 두어야 복구하기 쉽습니다.

Proxy: 선택한 서버 경로 먼저 확인

Proxy에서는 클라이언트가 처리하는 요청을 프록시 모드로 라우팅합니다. 첫 테스트 때 규칙 분기로 인한 변수를 줄이는 데 유용합니다. Proxy를 선택하고 Home으로 돌아가 사용할 서버를 확인한 뒤 연결 단계로 진행하세요. Proxy는 서버 정보를 수정하는 도구가 아니며, 만료된 계정이나 잘못된 암호를 해결해 주지도 않습니다.

Proxy에서는 실제 접속이 되지만 같은 요청이 Config에서는 실패한다면, 두 요청에 서로 다른 정책이 적용되었을 수 있습니다. 이 경우 서버를 바로 삭제하지 말고 구성과 규칙 적용 결과를 확인하세요. 테스트가 끝나면 일상적인 사용에 맞춰 Config로 전환하고 다시 확인할 수 있습니다. 한 번 성공했다고 해서 모든 규칙과 대상이 올바르게 설정되었다고 볼 수는 없습니다.

Direct: 기본 네트워크 비교

Direct 모드에서는 해당 요청이 선택된 원격 프록시 서버를 거치지 않고 직접 연결됩니다. 프록시 경로와 비교할 때 사용할 수 있지만 서버 연결이 정상이라는 것을 확인하는 용도는 아닙니다. Home에서 서버를 선택했더라도 Global Routing이 Direct라면 연결 스위치를 켰다는 이유만으로 프록시 경로가 적용되었다고 판단할 수 없습니다.

세 모드 중 모든 상황에 맞는 하나의 정답은 없습니다. 첫 문제 해결 과정에서는 Proxy로 기존 서버를 확인한 다음 Config로 전환해 규칙 동작을 살펴볼 수 있습니다. Direct는 기본 네트워크 상태를 확인하는 데 사용합니다. 규칙 순서, FINAL 및 DNS의 세부 설정은 옵션 매뉴얼에서 확인하세요. 이 페이지에서는 먼저 반복 가능한 연결 확인을 진행합니다.

STEP 03 / VPN

스위치를 켜고 VPN 권한 허용

Home으로 돌아가 현재 서버와 Global Routing을 다시 확인하세요. 확인을 마쳤으면 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 물을 수 있습니다. 이는 클라이언트가 시스템 네트워크 처리 기능을 사용하기 위해 필요한 권한 절차입니다. 안내에 표시된 앱 이름을 확인한 뒤 시스템 지침에 따라 허용하고, 기기에서 요구하는 암호 또는 생체 인증을 완료하세요.

앞서 권한 요청을 취소했다면 연결 스위치가 켜진 상태로 유지되지 않을 수 있습니다. 이때 구독을 다시 가져올 필요는 없습니다. 연결을 다시 시도하고 시스템 안내에 응답하세요. 기기가 조직에서 관리되거나 시스템에서 VPN 구성 추가를 제한하는 경우, 서버를 계속 바꾸기보다는 먼저 기기 관리 정책을 확인해야 합니다. 시스템 권한을 허용했다는 것은 클라이언트에 필요한 권한이 부여되었다는 뜻일 뿐, 원격 서버를 사용할 수 있다는 뜻은 아닙니다.

권한을 허용한 뒤 Shadowrocket으로 돌아가 스위치가 계속 켜져 있는지, 연결 상태가 안정적인지 확인하세요. 시스템 VPN 표시는 기기와 시스템 화면 구성에 따라 위치가 다를 수 있습니다. 특정 아이콘이 계속 표시되는지만으로 판단하지 마세요. 다음으로 Connectivity Test와 실제 접속을 통해 요청을 처리할 수 있는지 확인해야 합니다.

기기에서 다른 시스템 VPN 연결도 사용 중이라면 현재 어떤 구성이 연결을 관리하는지 먼저 확인하세요. 다른 연결의 상태를 Shadowrocket의 결과로 잘못 판단하지 않도록 주의해야 합니다. 첫 테스트 중에는 On Demand 설정도 확인하세요. 자동 연결 동작 때문에 수동으로 조작한 스위치 상태를 파악하기 어려울 수 있습니다. 먼저 현재 연결의 출처를 확인한 다음 필요에 따라 주문형 연결 조건을 조정하세요.

테스트를 마치려면 Home으로 돌아가 연결 스위치를 끄고 상태가 바뀌었는지 확인하세요. Wi-Fi와 셀룰러 네트워크를 전환했다면 다시 확인해야 합니다. 두 네트워크에서 같은 서버에 접속할 수 있는지는 서로 다를 수 있습니다. 연결이 유지되는 것, 테스트 결과가 반환되는 것, 대상 페이지가 로드되는 것은 각각 다른 현상이므로 다음 단계에서 따로 기록하세요.

STEP 04 / CONNECTIVITY TEST

연결 상태와 실제 접속 확인

Home에서 Connectivity Test를 찾아 실행하고 서버 목록의 결과를 확인하세요. 테스트 방식은 현재 Settings의 관련 설정에 영향을 받을 수 있으므로 사용한 테스트 방법을 고려해 결과를 해석해야 합니다. 시간이 표시되면 일반적으로 해당 테스트가 응답을 받았다는 뜻입니다. 시간 초과는 해당 테스트가 제한 시간 안에 끝나지 않았다는 의미이며, 서버가 영구적으로 작동하지 않는다고 단정할 수는 없습니다.

Connectivity Test와 실제 앱의 요청은 완전히 같지 않습니다. 특정 탐색 테스트에서 응답을 받았더라도 TLS, 인증, DNS 또는 대상 사이트 접속이 정상이라는 보장은 없습니다. 반대로 서버가 특정 탐색 테스트에 응답하지 않아도 모든 서비스 요청이 연결되지 않는다고 볼 수는 없습니다. 지연 시간만 보고 성공 여부를 판단하지 말고 실제 로딩 속도나 안정성을 보장하는 수치로 간주하지도 마세요.

같은 대상을 사용해 전후 결과 비교

Shadowrocket 연결을 유지한 상태에서 브라우저를 열고, 평소 로딩 여부를 확인할 수 있는 페이지에 접속하세요. 캐시된 페이지 제목만 보이는 것이 아니라 본문과 필요한 리소스가 모두 표시되는지 확인합니다. 새 페이지를 열거나 콘텐츠를 새로고침해 기존 캐시로 인한 오판을 줄이세요. 테스트 중에는 네트워크, 서버, 라우팅 모드를 고정하고 한 번 실패했다고 여러 조건을 동시에 바꾸지 마세요.

Config를 사용한다면 요청 기록이나 로그를 통해 대상에 적용된 규칙과 실제 정책도 확인하세요. 페이지가 열렸더라도 DIRECT로 접속했을 수 있으므로, 접속이 된다는 사실만으로 PROXY를 거쳤다고 판단할 수 없습니다. 프록시 경로를 확인해야 한다면 잠시 Proxy로 전환해 같은 테스트를 반복한 뒤 원래 모드로 되돌리고 두 결과를 비교하세요. 구체적인 기록 메뉴는 현재 앱 화면에 표시되는 내용을 기준으로 합니다.

접속 지점 정보를 확인해야 한다면 신뢰할 수 있는 테스트 대상을 사용하고 규칙 기록과 함께 판단하세요. 특정 대상에서 확인한 접속 지점은 해당 요청의 경로만 보여 줍니다. 기기의 모든 요청이 같은 경로를 사용한다는 뜻은 아닙니다. 특히 Config에서는 도메인, 주소, 앱 요청마다 다른 규칙이 적용될 수 있으며 이는 트래픽 분기의 정상적인 동작입니다.

첫 연결 확인을 마치려면 올바른 서버를 저장하고 선택했는지, 현재 Global Routing 모드를 파악했는지, 시스템 연결이 유지되는지, 실제 대상 요청이 선택한 정책에 맞는 결과를 내는지 확인해야 합니다. 이후 문제 발생 시 같은 조건으로 다시 테스트할 수 있도록 당시의 네트워크 유형, 서버 메모와 라우팅 모드를 기록해 두세요. 기억에 의존해 결과를 비교하지 않는 것이 좋습니다.

STEP 05 / CHECKLIST

실패한 단계별로 자주 발생하는 문제 해결

먼저 가져오기, 연결, 접속 중 어느 단계에서 문제가 발생했는지 확인하세요. 가져오기에 실패했다면 아직 서버 정보를 가져오지 못한 상태이므로 Proxy를 반복해서 바꿔도 도움이 되지 않습니다. 스위치는 켜지지만 페이지가 열리지 않는 경우에도 앱을 먼저 재설치할 필요는 없습니다. 기존 항목과 구성을 보존하고 설정을 한 번에 하나씩만 변경한 뒤 같은 대상으로 다시 테스트해야 어떤 변경이 영향을 주었는지 확인할 수 있습니다.

구독 저장 후 서버가 표시되지 않음

구독 편집 화면으로 돌아가 URL 전체가 입력되었는지 확인하세요. 복사 과정에서 줄바꿈이 들어갔거나 매개변수가 잘렸거나 링크가 만료되지 않았는지 살펴봅니다. 현재 네트워크에서 구독 정보를 가져올 수 있는지도 확인하세요. 구독 주소에 접속할 수 없다면 먼저 접속 경로나 링크 유효성 문제를 해결해야 합니다. 서비스 제공업체의 구독 상태와 앱 구매 상태는 별도로 관리됩니다. 클라이언트를 다시 구매해도 만료된 구독은 복구되지 않습니다.

이전에 있던 서버 항목이 업데이트 후 줄어들었다면 일괄 삭제하지 말고 먼저 구독에서 반환된 내용이 바뀌었는지, 필터 조건이 있는지 확인하세요. 구독 업데이트가 관리 대상인 서버 정보를 덮어쓸 수 있으므로 수동으로 수정하기 전에 원래 값을 기록해 두세요. 여전히 확인하기 어렵다면 서비스 제공업체에 구독 유효성을 문의하되, 링크에 포함된 계정 정보는 가리고 전달하세요.

Connectivity Test 시간 초과 또는 서버를 사용할 수 없음

먼저 사용하려는 서버를 선택했는지 확인하고 Type, 주소, 포트, 인증 정보를 점검하세요. TLS가 필요하다면 SNI와 관련 전송 설정을 확인하고 도메인, 주소, 호스트 항목을 서로 바꾸어 입력하지 않았는지 살펴보세요. iPhone 또는 iPad의 시스템 날짜와 시간이 정확한지도 확인하세요. 시간이 잘못되면 인증서 검증에 영향을 줄 수 있습니다. 보안 검증을 무작정 끄는 방식으로 설정 오류를 감추지 마세요.

그런 다음 이미 등록된 서버 중 사용 가능한 것으로 확인된 다른 항목을 선택하고 라우팅 모드와 대상을 그대로 유지한 채 비교하세요. 허용되는 경우 현재 네트워크를 바꿔 다시 테스트할 수도 있습니다. 특정 네트워크에서만 실패한다면 해당 네트워크에서 서버까지의 접속 가능성을 먼저 확인하세요. 모든 네트워크에서 실패한다면 계정 상태와 서버 정보를 점검합니다. 테스트 결과는 실제 페이지 접속과 함께 판단해야 합니다.

스위치를 켜면 바로 꺼짐

먼저 시스템 VPN 권한을 허용했는지, 다른 시스템 VPN이 연결을 전환하고 있는지, 기기 관리 정책이 제한을 적용하고 있는지 확인하세요. 현재 구성을 클라이언트가 정상적으로 읽을 수 있는지도 살펴봅니다. Config를 방금 수정했다면 이전에 사용할 수 있었던 구성으로 복구한 뒤 스위치를 테스트하세요. 연결 유지 실패와 서버 응답 지연은 서로 다른 문제이므로 함께 다루지 않는 것이 좋습니다.

On Demand가 활성화되어 있다면 현재 네트워크에서 자동 연결 또는 연결 해제가 실행되는 조건인지 확인하세요. 첫 확인 단계에서는 조건을 먼저 파악하고, 필요한 경우 자동 실행을 잠시 끄면서 변경 사항을 기록한 뒤 수동 테스트를 마치고 필요에 따라 복구하세요. 스위치를 반복해서 누르면 상태 변화를 추적하기 어려우므로 한 번의 작업이 끝날 때까지 기다린 뒤 다음 조작을 진행합니다.

일부 페이지는 열리지만 다른 페이지는 실패함

먼저 같은 대상에서 Proxy와 Config의 결과를 비교하세요. Config에서만 실패한다면 규칙 순서, 적용된 정책, 대상이 REJECT되는지 확인합니다. 두 모드 모두 실패한다면 서버 정보, DNS, 대상 사이트 상태를 점검하세요. 처음부터 전체 규칙을 교체하지 말고 어떤 요청에서 문제가 발생하는지 먼저 찾아 정상적으로 작동하던 부분까지 바뀌지 않도록 하세요.

DNS는 도메인 이름을 어떻게 해석할지 정하고, 라우팅 규칙은 요청을 어떻게 처리할지 결정합니다. 서로 관련은 있지만 같은 설정은 아닙니다. 도메인 해석 오류가 발생하면 현재 구성과 Settings에서 실제로 적용 중인 DNS 설정을 먼저 확인하세요. 여러 출처의 설정을 섞어 붙여 넣지 마세요. 자세한 매개변수와 로그 확인 방법은 옵션 매뉴얼에서 안내합니다. 이 페이지에서는 첫 연결에 필요한 문제 해결 순서만 다룹니다.

문제 해결을 마친 뒤 연결 확인 단계로 돌아가 같은 테스트를 다시 진행하세요. 정상 작동을 확인한 다음 일상적인 사용에 맞춰 Config를 선택하고 설정을 하나씩 조정합니다. 이후 설정을 변경할 때마다 복구 가능한 시작점을 남겨 두면 서버, 규칙, DNS를 한꺼번에 바꾸는 것보다 관리하기 쉽습니다.