OFFICIAL MANUAL / GETTING STARTED
Shadowrocket 사용법: 정보 가져오기와 연결
기존 정보를 먼저 가져온 뒤 라우팅 방식을 선택하세요. 연결 후에는 실제 요청으로 적용 여부를 확인합니다. 이 페이지는 첫 사용 순서에 맞춰 구성했으며 iPhone과 iPad에서 사용할 수 있습니다.
처음 사용하는 경우 순서대로 읽어보세요. 연결은 되지만 접속에 문제가 있다면 확인 및 문제 해결 섹션으로 바로 이동할 수 있습니다. 화면에 표시되는 용어는 영어로 유지하며, 구체적인 위치와 사용 가능한 옵션은 현재 앱 화면을 기준으로 합니다.
STEP 01 / ADD SERVER
서버 추가 또는 기존 구독 가져오기
먼저 보유한 정보가 서버 목록을 제공하는 구독 링크인지, 단일 서버의 전체 연결 정보인지 확인하세요. 두 종류 모두 같은 메뉴에서 추가하지만 입력 방법은 다릅니다. 구독 링크는 일반 웹사이트나 계정 관리 페이지 주소가 아닙니다. 용도를 알 수 없다면 주소를 반복해서 바꾸지 말고 정보를 받은 곳에 먼저 확인하세요.
구독 링크가 있는 경우: Subscribe 선택
Shadowrocket을 열고 Home으로 이동한 다음 오른쪽 위의 더하기 버튼을 눌러 Add Server를 엽니다. 유형 선택 항목을 눌러 Subscribe를 선택하고 기존 구독 링크 전체를 URL에 붙여 넣습니다. 메모가 필요하면 알아보기 쉬운 이름을 입력하세요. 메모는 출처를 구분하는 용도이며 서버 연결 방식에는 영향을 주지 않습니다.
붙여 넣은 뒤 주소의 앞부분, 뒷부분, 중간이 모두 온전한지 확인하세요. 채팅 메시지의 줄바꿈, 복사 과정에서 들어간 공백, 누락된 쿼리 매개변수 때문에 읽기에 실패할 수 있습니다. 구독 링크의 인증 정보는 대개 접속 자격 증명이므로 원래대로 유지하고 임의로 삭제하지 마세요. 전체 주소를 공개된 게시판에 올려서도 안 됩니다. 확인을 마치면 화면의 저장 버튼을 누르고 Home으로 돌아가 구독 정보를 불러올 때까지 기다립니다.
불러오기가 끝나면 SERVER 목록에 구독 이름만 표시되는 것이 아니라 구독에 포함된 서버 항목도 나타나는지 확인하세요. 출처 기록만 보이고 선택할 서버가 없다면 구독 업데이트 결과와 오류 메시지를 확인합니다. 정보가 아직 불러와지지 않았다면 연결 스위치를 켜지 마세요. 라우팅 설정으로 누락된 서버 정보를 보완할 수는 없습니다.
단일 서버 정보가 있는 경우: 해당 유형에 맞춰 입력
서버 공유 링크가 있다면 전체 링크를 복사한 뒤 앱에 표시되는 가져오기 안내에 따라 항목을 추가하세요. QR 코드가 있다면 Scan QR Code로 읽을 수 있습니다. 가져온 뒤에도 유형과 주소를 확인하세요. 가져오기에 성공했다고 해서 매개변수가 올바르다는 뜻은 아닙니다. QR 코드에 포함된 인증 정보도 안전하게 관리해야 합니다.
직접 입력하려면 Add Server에서 정보와 일치하는 유형(예: Shadowsocks, VMess, Trojan)을 선택한 뒤 주소, 포트, 인증 정보를 항목별로 입력합니다. 프로토콜마다 필요한 항목이 다릅니다. 암호화 방식, 전송 방식, TLS 관련 매개변수는 원본 정보와 일치해야 합니다. 한 프로토콜의 입력 방법을 다른 프로토콜에 그대로 적용하지 마세요.
저장한 뒤 Home으로 돌아가 SERVER에서 사용할 서버를 선택합니다. 먼저 확인된 정보 하나로 전체 절차를 마친 뒤 이름과 그룹을 정리하세요. 이 단계는 정보를 클라이언트에 추가한 것이며 아직 연결이 완료된 것은 아닙니다. 다음으로 해당 정보를 요청에 어떻게 사용할지 정해야 합니다.
STEP 02 / GLOBAL ROUTING
Global Routing의 세 가지 모드 선택
Home으로 돌아가 Global Routing을 누르고 용도에 따라 Config, Proxy 또는 Direct를 선택합니다. 이 설정은 클라이언트가 요청을 처리하는 방식을 정하며 다른 서버를 선택하는 기능이 아닙니다. 변경한 뒤 Home으로 돌아와 현재 모드를 확인하세요. 서버 선택과 라우팅 선택을 혼동하지 않도록 합니다.
Config: 현재 구성에 따라 요청 처리
규칙에 따라 요청을 구분해야 한다면 Config를 사용합니다. 먼저 앱의 Config 페이지에서 필요한 구성 파일이 있는지, 현재 선택되어 있는지 확인하세요. 목록에 파일이 보인다고 해서 현재 구성으로 선택된 것은 아닙니다. 앱에 표시된 선택 상태를 기준으로 확인하세요. 이 모드에서는 파일에 포함된 규칙, 정책 및 관련 설정에 따라 요청 경로가 결정됩니다.
예를 들어 DOMAIN-SUFFIX로 도메인 접미사를 일치시키고 IP-CIDR로 주소 범위를 일치시킨 다음, 앞선 규칙에 일치하지 않는 요청을 FINAL로 처리할 수 있습니다. 처음부터 이런 내용을 편집할 필요는 없지만, 같은 서버가 연결된다고 해서 모든 규칙이 예상대로 작동하는 것은 아니라는 점을 알아두세요. 구성에서 참조하는 정책도 유효해야 합니다. 규칙 키워드만 확인해서는 충분하지 않습니다.
Proxy: 프록시 경로 먼저 확인
현재 프록시 경로만 따로 확인하려면 Proxy를 임시로 선택하고, SERVER에서 테스트할 서버가 선택되어 있는지 확인한 뒤 연결하여 같은 테스트 대상에 접속합니다. 이를 통해 서버 연결 상태와 규칙이 예상한 정책에 일치하는지를 나누어 확인할 수 있습니다. 이 모드만으로 모든 앱과 모든 종류의 트래픽이 동일하게 처리된다고 판단해서는 안 됩니다.
Proxy에서는 접속되지만 Config로 바꾼 뒤 실패한다면 서버를 바로 삭제하기보다 현재 구성, 규칙 우선순위, 최종 정책을 먼저 확인하세요. 문제를 진단한 후에는 필요한 모드로 되돌립니다. 용도를 확인하지 않은 임시 설정을 계속 사용하지 마세요.
Direct: 직접 연결 상태 확인
Direct는 선택한 프록시 서버를 거치지 않고 직접 연결 경로를 사용합니다. 기본 네트워크의 접속 상태를 확인하는 데 도움이 되지만, 프록시 연결이 성공했다는 증거로 사용할 수는 없습니다. 이 모드에서는 시스템에 VPN 상태가 표시되더라도 요청이 프록시 서버를 사용한다고 볼 수 없습니다. 시스템 연결 상태와 요청에 적용되는 정책은 서로 다른 단계입니다.
계속하기 전에 현재 Global Routing이 목적에 맞는지 확인하세요. Config를 선택했다면 구성 파일이 선택되어 있는지도 확인합니다. 규칙 문법과 구성 파일 각 부분에 대한 자세한 내용은 전체 공식 가이드에서 확인할 수 있습니다. 이 페이지에서는 먼저 확인 가능한 연결 절차를 마칩니다.
STEP 03 / VPN PERMISSION
연결 스위치를 켜고 VPN 구성 허용
이제 Home으로 돌아갑니다. 연결 스위치를 켜기 전에 SERVER에서 선택한 서버와 현재 Global Routing 값을 다시 확인하세요. 화면에 Not Connected라고 표시되면 클라이언트가 아직 해당 연결을 설정하지 않은 상태입니다. 연결 스위치를 누르고 이어지는 앱 및 시스템 안내에 따라 진행하세요.
처음 VPN 구성 추가 안내가 표시될 때
처음 연결할 때 시스템에서 VPN 구성을 추가하라는 안내가 표시될 수 있습니다. 안내에 표시된 앱 이름과 권한 설명을 읽고 Shadowrocket에서 진행 중인지 확인한 다음 시스템 안내에 따라 허용하고 기기 인증을 완료하세요. 여기서 허용하는 것은 앱이 필요한 시스템 VPN 구성을 생성하는 작업입니다. 서버를 생성하거나 구독 주소를 수정해 주는 기능이 아니며, 정보가 실제로 사용 가능한지 확인해 주지도 않습니다.
허용을 마친 뒤 Shadowrocket으로 돌아와 연결 스위치와 상태가 바뀌었는지 확인하세요. 시스템에서 거부되었다는 메시지가 표시되면 앱으로 돌아가 다시 연결을 시도하고 실제 안내에 따라 처리합니다. 필요한 경우 시스템 설정의 VPN 관련 항목에서 해당 구성이 있는지 확인하세요. 문제를 해결하려고 기기의 모든 VPN 구성을 삭제하지 마세요. 업무나 기기 관리에 필요한 구성일 수도 있습니다.
시스템 연결 상태와 서버 사용 가능 여부 구분
시스템에 VPN 표시가 나타나고 스위치가 켜져 있다면 관련 시스템 연결이 활성 상태라는 뜻입니다. 그래도 원격 서버 인증, 도메인 확인, 대상 접속은 실패할 수 있습니다. 반대로 스위치가 바로 꺼지거나 구성 오류가 표시되면 먼저 권한, 현재 구성, 앱의 오류 메시지를 확인하세요. 브라우저에서 계속 새로고침하며 여러 문제를 한꺼번에 확인하지 마세요.
첫 확인에서는 수동 연결 방식을 유지하고 On Demand 같은 자동 연결 옵션을 동시에 변경하지 않는 것이 좋습니다. 자동 실행 조건은 연결이 복구되는 시점에 영향을 주므로 기본 연결 경로를 확인하기 전에 함께 바꾸기에는 적절하지 않습니다. 다음 단계까지 마친 뒤 실제 사용 목적에 따라 이러한 설정을 살펴보세요.
앱을 나가서 접속을 테스트하는 동안에는 현재 서버와 라우팅 선택을 유지하세요. 중요한 매개변수를 변경하려면 먼저 연결을 끊고 수정 및 저장한 뒤 다시 연결합니다. 그래야 다음 테스트에서 어떤 설정을 사용했는지 분명해집니다. 이제 확인할 것은 스위치가 켜져 있는지가 아니라 대상 요청이 실제로 완료되는지입니다.
STEP 04 / CONNECTIVITY TEST
테스트와 실제 요청으로 적용 여부 확인
확인은 세 단계로 나뉩니다. 클라이언트 또는 서버 테스트 결과, 시스템 연결 상태, 실제 대상에 접속한 결과입니다. 세 가지를 함께 살펴봐야 합니다. 테스트 하나의 성공이 모든 앱의 접속을 보장하지 않으며, 대상 하나에 접속하지 못했다고 모든 연결 정보가 사용할 수 없는 것도 아닙니다.
먼저 Connectivity Test를 실행한 뒤 실제 대상에 접속
Home에서 Connectivity Test를 찾아 현재 화면에 제공되는 컨트롤로 테스트를 실행하고, 확인하려는 대상이 맞는지 확인합니다. 앱에서 여러 테스트 방법을 제공한다면 비교할 때 같은 방법을 사용하세요. 조건이 다른 테스트 결과는 직접 비교하기 어렵습니다.
테스트에 응답이 있으면 브라우저나 실제로 사용할 앱을 열고 명확한 대상 페이지에 새로 접속합니다. 이전에 열어둔 화면은 캐시에서 표시될 수 있으므로 새로고침만으로 확인하지 마세요. 먼저 대상 하나를 검증한 뒤 다른 용도를 테스트합니다. 여러 페이지를 동시에 열면 요청 기록을 구분하기 어렵고 어떤 변경이 영향을 주었는지 판단하기도 힘듭니다.
Data에서 요청과 정책 확인
Shadowrocket으로 돌아가 Data를 열고 방금 수행한 작업의 시각과 대상에 해당하는 요청 기록을 확인합니다. 기록 세부정보에 일치한 규칙, 정책 또는 연결 정보가 표시된다면 어떤 경로로 요청이 처리되었는지 판단하는 데 활용할 수 있습니다. Config를 사용한다면 총 트래픽 변화만으로 결론 내리지 말고 적용된 규칙이 예상과 일치하는지 확인하세요.
예를 들어 프록시를 사용해야 하는 요청의 기록에 DIRECT가 표시된다면 규칙 적용 여부와 순서를 확인해야 합니다. 정책은 예상대로인데 연결이 실패한다면 해당 정책이 참조하는 서버와 관련 매개변수를 확인하세요. 기록에 요청이 나타났다는 것은 클라이언트가 해당 활동을 감지했다는 뜻일 뿐, 원격 서버가 전체 콘텐츠를 반환했다는 의미는 아닙니다.
반복할 수 있는 검증 절차 만들기
페이지가 새로 로드되거나 앱에서 필요한 콘텐츠를 정상적으로 가져오는 등 실제 작업이 완료되는지 확인한 뒤, 사용한 모드와 서버, 테스트 대상을 기록해 두세요. 구독 전체 주소나 인증 정보는 저장할 필요가 없습니다. 나중에 문제가 발생하면 같은 조건으로 다시 테스트해야 결과를 비교할 수 있습니다.
Connectivity Test는 성공했지만 실제 접속이 되지 않는다면 다음 섹션에서 대상 확인, 규칙, 서버 매개변수를 하나씩 점검하세요. 실제 접속은 정상인데 특정 테스트만 실패한다면 먼저 테스트 방법과 대상을 확인합니다. 모든 테스트 결과를 같게 만들기 위해 정상 작동 중인 구성을 바꾸지 마세요.
STEP 05 / CHECK ONE CHANGE AT A TIME
오류 증상에 따라 원인을 찾고 하나씩 변경
가장 먼저 실패한 단계부터 점검하세요. 현재 증상을 기록한 뒤 조건 하나만 변경하고 같은 검증을 반복합니다. 구독 업데이트, 서버 변경, 규칙 편집, 네트워크 전환을 한 번에 모두 하면 접속이 복구되어도 원인을 알기 어렵고 다음에 문제가 생겼을 때 판단 근거가 부족해집니다.
구독을 불러오지 못했거나 업데이트 후 항목에 문제가 있는 경우
먼저 연결을 끊고 기본 네트워크에서 평소 이용하는 페이지에 정상적으로 접속할 수 있는지 확인하세요. 그런 다음 구독 주소가 완전한지, 아직 유효한지, 앱에 업데이트 오류가 표시되는지 확인합니다. 구독에 인증이 필요하거나 원래 서비스 정보가 변경된 경우 이용 중인 서비스 제공업체에 문의하세요. 주소의 인증 정보를 임의로 수정하거나 출처를 알 수 없는 정보를 시도하지 마세요.
업데이트 전에 선택된 항목의 이름을 기록해 두면 좋습니다. 업데이트 후 항목이 삭제되거나 이름이 바뀌었다면 현재 목록에서 유효한 서버를 다시 선택하세요. 구독 업데이트는 주로 서버 정보를 변경하며 현재 Config의 규칙과 정책 참조까지 자동으로 동기화하지는 않습니다.
스위치가 켜진 상태로 유지되지 않거나 시스템 구성 오류가 표시되는 경우
먼저 앱의 오류 메시지를 읽고 처음 VPN 구성을 허용했는지 확인한 뒤 시스템 VPN 관련 설정에서 해당 항목을 점검하세요. 시스템 VPN에 영향을 주는 다른 구성이 동시에 켜져 있다면 현재 활성 연결을 확인하고 동시에 작동하는 조건을 줄인 다음 다시 시도합니다. 기기 관리 제한이 적용되는 경우 해당 관리 정책을 따르고 관리 구성을 임의로 제거하지 마세요.
Shadowrocket의 시스템 VPN 구성을 다시 만들어야 한다면 먼저 앱에 저장된 서버와 구성 정보를 보존하고 해당 항목만 처리하세요. 시스템 VPN 구성과 앱 내 서버 목록은 서로 다른 정보입니다. 시스템 연결 항목을 삭제한다고 서버 매개변수가 수정되는 것은 아닙니다.
연결은 됐지만 대상에 접속할 수 없는 경우
먼저 진단을 위해 임시로 선택해 둔 Direct가 아닌지 확인한 다음 선택된 서버를 점검하세요. 직접 입력한 항목은 유형, 포트, 인증 정보, 전송 매개변수를 하나씩 대조하고 복사 과정에서 빠진 항목이 없는지 확인합니다. TLS 검증을 임의로 끄는 방식으로 매개변수 확인을 대신하지 마세요. 인증서 관련 오류는 원본 정보와 앱 안내를 바탕으로 원인을 확인해야 합니다.
그다음 같은 대상에서 Proxy와 Config의 결과를 비교하세요. 전자에서는 정상이고 후자에서 문제가 생긴다면 구성 파일이 선택되어 있는지, 규칙 순서와 정책 참조가 올바른지 먼저 확인합니다. 둘 다 실패한다면 서버, 기본 네트워크, 대상 자체를 점검하세요. 비교를 마친 뒤 평소 필요한 모드로 되돌립니다.
일부 대상에만 문제가 있거나 네트워크를 바꾼 뒤 문제가 생기는 경우
일부 대상에서 문제가 생기면 Data에서 실제 실패한 요청을 찾아 도메인 확인, 규칙 적용, 연결 오류를 점검하세요. 페이지의 대표 도메인만 보고 모든 요청이 같은 경로를 사용한다고 판단하지 마세요. 한 페이지에서도 다른 도메인에 요청할 수 있습니다. 먼저 실패한 요청을 찾아 필요한 규칙 변경 여부를 결정하세요.
특정 Wi-Fi나 셀룰러 네트워크에서만 문제가 발생한다면 서버와 구성은 그대로 둔 채 네트워크만 바꾸어 다시 테스트하세요. 네트워크를 전환한 뒤 수동으로 연결을 끊었다가 다시 연결하고 오류가 재현되는지 확인할 수 있습니다. 이 비교는 원인 범위를 좁히는 데 도움이 되지만, 특정 네트워크에 문제가 있다고 단정하거나 서버의 장기적인 사용 가능성을 보장하지는 않습니다.
위 절차를 마치면 정보 가져오기, 시스템 연결, 실제 요청의 세 단계를 구분할 수 있습니다. On Demand, 구성 파일의 각 항목, 일상적인 관리 방법을 더 알아보려면 초보자부터 고급 사용자까지 보는 공식 가이드를 읽어보세요. 기본 조작을 다시 확인하려면 이 튜토리얼의 서버 추가 및 정보 가져오기 단계로 돌아가면 됩니다.