공식 매뉴얼 · 첫 연결
Shadowrocket 사용법
기존 구독 또는 서버 정보로 처음 연결한 뒤 라우팅 선택, 서버 응답, 실제 접속을 각각 확인합니다.
1. Home에서 서버 추가 또는 구독 가져오기
Shadowrocket을 열고 하단의 Home을 누른 다음 오른쪽 위 더하기 버튼을 눌러 Add Server로 이동합니다. 먼저 보유한 정보의 종류를 확인하세요. 구독 링크는 여러 항목을 가져오는 데 사용하고, 단일 서버 정보는 보통 프로토콜에 따라 주소, 포트, 인증 정보를 입력하는 하나의 항목에 해당합니다. 처음 설정할 때는 한 가지 방법만 선택하면 됩니다. 구독을 가져오면서 동일한 서버를 수동으로 입력할 필요는 없습니다. 정보를 추가하는 동안에는 상단 연결 스위치를 꺼 둡니다.
구독 링크가 있는 경우: Subscribe 선택
Add Server에서 유형 선택 화면을 열고 Subscribe를 선택한 다음 전체 구독 링크를 URL 입력란에 붙여 넣습니다. 링크의 처음과 끝을 확인하고, 복사 과정에서 공백이나 줄바꿈, 주변 설명 문구가 함께 들어가지 않았는지 살펴보세요. 링크의 물음표 뒤에 있는 매개변수를 삭제하거나 전체 링크를 서버 주소와 포트로 나누지 마세요. 저장한 뒤 Home으로 돌아가 SERVER 목록에 구독과 그 아래 서버 항목이 표시되는지 확인합니다. 구독 이름만 보이고 선택할 항목이 없다면 구독을 업데이트할 수 있는지 먼저 확인한 뒤 다음 단계로 진행하세요.
단일 서버 정보가 있는 경우: 프로토콜에 맞춰 입력
Add Server에서 정보에 지정된 프로토콜(예: Shadowsocks 또는 VLESS)을 선택한 다음 주소, 포트, 해당 프로토콜에서 요구하는 인증 항목을 각각 입력합니다. 주소 입력란에는 지정된 호스트 이름이나 IP 주소만 입력하고, 포트는 별도 입력란에 입력합니다. 프로토콜 관련 전송 및 보안 옵션도 제공된 정보와 일치해야 합니다. 필수 항목이 없다면 정보를 제공한 곳에 확인하고 다른 항목의 값을 대신 입력하지 마세요. 저장한 뒤 목록으로 돌아와 새 항목이 표시되는지 확인합니다. 이름이 비슷한 항목이 여러 개라면 알아볼 수 있는 메모로 구분하되, 메모에 비밀번호를 적지 마세요.
어떤 방법을 사용하든 다음 단계는 SERVER에서 특정 서버를 선택하고 테스트하려는 항목이 선택되었는지 확인하는 것입니다. 구독 가져오기에 성공했다는 것은 목록이 불러와졌다는 뜻일 뿐, 서버에 연결할 수 있다는 의미는 아닙니다. 서버 항목을 직접 저장해도 인증이 통과된 것은 아닙니다. 현재 선택한 이름을 기억하고, 다음 단계에서 라우팅 방식을 선택할 때 해당 항목을 그대로 유지하세요. 두 조건을 동시에 바꾸지 않도록 합니다.
2. Global Routing에서 구성, 프록시 또는 직접 연결 선택
Home에서 Global Routing을 누르고 현재 작업에 맞게 구성(Config), 프록시(Proxy) 또는 직접 연결(Direct)을 선택합니다. 여기서는 연결이 설정된 뒤 트래픽을 처리하는 방식을 선택하며, 서버를 고르는 것이 아닙니다. 라우팅 방식을 바꿔도 저장된 서버 주소나 구독 링크는 변경되지 않습니다. 선택한 뒤 Home으로 돌아가 표시된 모드를 확인하고 연결을 시작합니다.
| 모드 | 트래픽 처리 방식 | 사용 시점 |
|---|---|---|
| 구성(Config) | 현재 구성 파일의 규칙과 정책에 따라 처리합니다. | 일상적인 라우팅이 구성에 맞는지 확인할 때 사용합니다. |
| 프록시(Proxy) | 클라이언트가 처리하는 트래픽을 프록시를 통해 전달합니다. | 라우팅 규칙의 영향을 잠시 제외하고 프록시 경로를 확인할 때 사용합니다. |
| 직접 연결(Direct) | 클라이언트가 처리하는 트래픽을 프록시 서버를 거치지 않고 직접 연결합니다. | 프록시 경로와 비교할 때 사용합니다. |
Config 사용 전 현재 구성 확인
하단의 Config는 구성 파일을 확인하고 관리하는 곳입니다. Global Routing의 Config는 연결에 현재 구성을 적용하는 옵션입니다. 이름은 같지만 역할은 다릅니다. 사용할 구성이 이미 있다면 먼저 하단의 Config에서 올바른 파일이 선택되어 있는지 확인한 뒤 Home으로 돌아가 Global Routing의 Config를 선택합니다. 방금 가져온 구독을 라우팅 구성으로 착각하지 마세요. 구독은 선택 가능한 서버를 제공하고, 구성은 접속 요청을 처리하는 방식을 정합니다.
서버가 작동하는지만 확인하려면 먼저 Proxy로 짧게 테스트한 뒤 원래 사용하려던 모드로 돌아갈 수 있습니다. Direct에서 웹페이지가 열린다고 해서 프록시 서버가 정상이라는 뜻은 아닙니다. 반대로 Config를 선택했다고 해서 모든 웹사이트가 프록시를 거치는 것도 아닙니다. 도메인마다 서로 다른 규칙이 적용될 수 있습니다. 첫 테스트에서는 규칙을 수정하지 말고 선택한 모드만 기록하세요.
3. Home 스위치를 켜고 VPN 구성 허용
Home으로 돌아가 SERVER에서 선택한 항목과 Global Routing의 현재 모드를 확인합니다. 두 항목이 올바르면 페이지 상단의 Not Connected 쪽 연결 스위치를 누릅니다. 처음 연결할 때 iPhone 또는 iPad에 VPN 구성 추가를 요청하는 시스템 알림이 나타날 수 있습니다. 요청한 앱이 Shadowrocket인지 확인한 뒤 허용하고 기기의 안내에 따라 인증을 완료합니다. 인증이 끝나면 앱으로 돌아가 상단 상태가 바뀔 때까지 기다립니다. 시스템 알림을 처리하는 중에 스위치를 반복해서 누르지 마세요.
시스템 알림을 취소했다면 Home으로 돌아가 다시 켜 보세요. 알림이 다시 나타나지 않고 스위치도 켜진 상태를 유지하지 못한다면 시스템 설정에서 VPN 구성 상태를 확인합니다. 기기를 회사나 학교에서 관리하는 경우에는 관리 정책에서 VPN 추가를 허용하는지도 확인해야 합니다. 기기에서 다른 VPN 연결이 활성화되어 있다면 해당 연결을 직접 관리할 수 있는 경우 먼저 연결을 해제하고 테스트하세요. 용도를 모르는 구성을 삭제하거나 기기 관리 제한을 해제하지 마세요.
상단에 연결 상태가 표시되면 클라이언트의 VPN 연결이 시작되었다는 뜻입니다. 구독 업데이트가 성공했거나 선택한 서버가 실제 요청으로 검증되었다는 의미는 아닙니다. 이 단계에서는 현재 네트워크를 유지하세요. 예를 들어 Wi-Fi에서 연결을 시작했다면 다음 단계도 같은 Wi-Fi 환경에서 진행하고, 서버를 테스트하는 도중 셀룰러 네트워크로 전환하지 마세요. 그래야 실패 원인이 네트워크, 서버, 라우팅 방식 중 어디에 있는지 판단하기 쉽습니다.
4. Connectivity Test와 실제 접속으로 확인
Home에서 Connectivity Test를 누르고 테스트가 끝날 때까지 기다린 뒤 현재 선택한 서버의 결과를 확인합니다. 목록의 다른 서버에서 응답을 받았더라도 현재 사용하는 서버가 응답한다는 뜻은 아닙니다. 현재 항목에 시간 초과가 표시되면 사용한 네트워크, 서버 이름, 테스트 결과를 기록하세요. 한 번 시간 초과가 발생했다고 항목을 삭제하지 마세요. 테스트 결과는 당시 테스트 대상의 응답만 나타내며 모든 웹사이트 접속 결과를 종합한 것이 아닙니다. 응답 시간으로 다운로드 속도를 추정할 수도 없습니다.
이어서 브라우저를 열고 정상적으로 접속되는 것을 알고 있는 비교용 웹페이지를 새 탭에서 방문합니다. 페이지에 실제 내용이 표시된 뒤 한 번 새로고침하여 이전에 열어 둔 페이지를 새 요청으로 착각하지 않도록 합니다. Config를 사용한다면 프록시를 통과할 것으로 예상되는 대상과 직접 연결될 것으로 예상되는 대상을 각각 확인하는 것이 좋습니다. 확인 전에 대상 도메인이 구성 규칙과 일치하는지 살펴보세요. 한 사이트의 첫 화면, 로그인 페이지, 리소스 파일은 서로 다른 도메인을 사용할 수 있으므로 첫 화면만 열리는지 확인해서는 전체 사이트의 접속 상태를 판단하기 어렵습니다.
결과가 예상과 다르면 서버와 네트워크는 그대로 두고 라우팅 방식만 바꿔 동일한 대상을 방문합니다. 예를 들어 현재 Config에서 접속에 실패하고 Proxy에서는 열리는 경우, 현재 구성과 해당 도메인에 적용된 정책을 먼저 확인합니다. Proxy와 Direct에서 모두 실패한다면 대상이나 현재 네트워크가 정상인지 확인합니다. 비교가 끝나면 장기적으로 사용할 모드로 돌아가 다시 접속합니다. 지연 시간 하나만 기록하는 것보다 ‘스위치 상태, 테스트 결과, 실제 접속’ 세 항목을 기록하면 이후 문제를 점검하기 쉽습니다.
5. 실패한 단계에 따라 원인 점검
예상한 결과에 처음 도달하지 못한 단계가 어디인지 확인합니다. 목록에 항목이 없는지, 스위치가 켜지지 않는지, 서버 테스트가 시간 초과되는지, 테스트 응답은 있지만 웹페이지가 열리지 않는지 구분하세요. 순서대로 확인하고 앞 단계의 문제를 해결한 뒤 다음 단계를 다시 테스트합니다. 페이지가 정상적으로 열리고 특정 대상만 라우팅 예상과 다르다면 앱을 다시 설치하거나 구독을 다시 설정할 필요는 없습니다.
구독은 저장됐지만 목록에 서버가 없음
정보 추가 단계로 돌아가 저장할 때 유형으로 Subscribe를 선택했는지, 전체 원본 링크를 입력했는지 확인합니다. 현재 저장된 내용보다 최신 링크가 있는지 확인하고 인터넷에 정상적으로 접속되는 네트워크에서 업데이트를 시도합니다. 그래도 항목을 가져오지 못한다면 정보를 제공한 곳에 링크가 유효한지, 응답 내용이 클라이언트에서 사용할 수 있는 형식인지 확인하세요. 문의할 때 오류 메시지와 발생 시각은 설명해도 되지만, 공개된 곳에 전체 링크나 인증 정보 또는 해당 정보가 포함된 화면을 붙여 넣지 마세요.
스위치를 켠 직후 바로 꺼짐
연결 단계로 돌아가 시스템의 VPN 구성 요청을 허용했는지, 기기에 다른 VPN이 활성화되어 있는지 확인합니다. 권한이나 충돌을 먼저 처리한 뒤 Home으로 돌아가 다시 시도합니다. 구성이 기기 관리 정책의 적용을 받는다면 시스템 알림을 기록하고 기기 관리자에게 확인하세요. 이 문제는 연결을 시작하는 단계에서 발생하므로 서버 포트나 라우팅 규칙을 먼저 변경할 필요는 없습니다.
서버 시간 초과 또는 응답은 있지만 웹페이지가 열리지 않음
먼저 Shadowrocket 연결을 해제하고 현재 네트워크에서 일반적으로 직접 연결되는 웹페이지에 접속할 수 있는지 확인합니다. 기본적인 접속도 되지 않는다면 네트워크 로그인, Wi-Fi 또는 셀룰러 연결 문제를 먼저 해결하세요. 기본 네트워크가 정상이라면 Shadowrocket을 다시 켜고 서버 주소, 포트, 프로토콜을 확인합니다. 목록에 사용 가능한 것으로 알려진 다른 서버가 있다면 동일한 네트워크와 모드에서 비교 테스트를 진행할 수 있습니다. 항목 하나만 시간 초과된다면 해당 항목의 정보와 사용 가능 여부를 먼저 확인하고, 여러 항목이 모두 실패한다면 네트워크나 공통 설정의 영향을 살펴봅니다.
Connectivity Test에서 응답을 받았지만 실제 접속에 실패한다면 접속 비교 단계를 다시 진행해 문제가 Config에서만 발생하는지 확인합니다. 브라우저에 도메인 이름 해석 실패가 표시되면 구체적인 도메인과 알림을 기록한 뒤 문제 해결 매뉴얼을 참고해 DNS와 규칙을 확인하세요. 특정 사이트의 이미지나 로그인 페이지에서만 문제가 발생한다면 실패한 페이지를 기록합니다. 한 번에 한 항목만 변경하고 개선되지 않으면 원래 값으로 되돌린 뒤 다음 요인을 확인합니다.