공식 매뉴얼 · 첫 연결

Shadowrocket 사용법

가져오기, 모드 선택, 연결, 확인 순서로 진행합니다. 먼저 점검할 수 있는 연결을 만든 다음 규칙과 자동 연결 설정을 조정하세요.

작업 전에 원본 정보를 보관하고 구독 주소가 완전한지, 서버 정보가 여전히 유효한지 확인하세요. 처음 설정할 때는 On Demand를 활성화하지 마세요. 연결 확인을 마친 뒤 사용 조건을 살펴보면 자동 연결 동작으로 인해 수동 점검이 방해되는 일을 피할 수 있습니다.

단계 01 · Home / Add Server

서버 추가 또는 기존 구독 가져오기

먼저 받은 정보가 구독 링크인지, 개별 서버의 연결 정보인지 확인하세요.둘 다 Home에서 선택할 수 있는 서버 항목을 만들지만 입력 방법은 다릅니다. 구독은 일반적으로 여러 서버를 한곳에서 업데이트하는 데 사용하며, 개별 서버는 프로토콜에 맞춰 각 매개변수를 입력해야 합니다. 링크에 특정 영어 단어가 있는지만 보고 종류를 판단하지 말고, 기존 서비스 안내를 기준으로 확인하세요.

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

Shadowrocket을 열고 Home으로 이동한 다음 오른쪽 위의 더하기 버튼을 눌러 Add Server로 이동합니다. Type에서 Subscribe를 선택하고 전체 구독 링크를 URL에 붙여넣습니다. 필요하면 알아보기 쉬운 메모를 입력한 뒤 저장합니다. 복사할 때 앞뒤의 따옴표, 공백, 줄 바꿈이 포함되지 않도록 주의하고 링크의 물음표 뒤 매개변수를 삭제하지 마세요. 해당 매개변수는 구독을 식별하는 데 필요할 수 있습니다.

저장한 후 구독을 읽어 올 때까지 기다린 다음 Home으로 돌아가 결과를 확인합니다. 올바른 확인 기준은 편집 화면이 닫히는 것이 아니라 목록에 구독 그룹과 서버 항목이 표시되는 것입니다. 구독 이름만 보이고 서버가 없다면 현재 네트워크에서 구독 주소에 접근할 수 있는지, 링크가 만료되지 않았는지 먼저 확인하세요. 이후 어떤 자료를 사용 중인지 구분하기 어려워지지 않도록 같은 구독을 반복해서 새로 만들지는 마세요.

구독 업데이트와 VPN 연결은 별개의 작업입니다. 업데이트는 서비스 제공업체가 게시한 항목의 변경 사항을 가져오는 것이며, 서버를 선택하거나 연결을 설정했다는 뜻은 아닙니다. 가져오기가 완료되면 서버 항목을 눌러 현재 서버로 선택해야 합니다. 그 후 모드 설정 및 연결 단계로 진행합니다.

개별 서버 정보가 있는 경우: 프로토콜에 맞춰 매개변수 입력

Add Server의 Type에서 자료에 명시된 프로토콜(예: Shadowsocks, VMess, VLESS 또는 Trojan)을 선택한 다음 화면에 표시되는 주소, 포트, 인증 정보를 입력합니다. 프로토콜마다 필요한 필드가 다릅니다. 한 프로토콜의 비밀번호, 식별자 또는 전송 매개변수를 다른 프로토콜에 적용하지 마세요. TLS, 서버 이름, 경로 등의 필드는 원본 정보를 하나씩 대조해 입력하고 임의로 추측해 채우지 마세요.

기존 자료가 QR 코드로 제공된다면 Scan QR Code를 사용해 읽은 다음 인식된 프로토콜과 주요 필드를 확인할 수 있습니다. QR 코드는 입력 방법일 뿐 유효성을 보장하지 않습니다. 저장하기 전에 누락된 내용이 없는지 확인하고, 저장한 다음 Home으로 돌아가 해당 서버를 선택하세요. 프로토콜 이름이나 매개변수의 의미가 불분명하다면 용어 매뉴얼을 참고하되, 최종 입력 값은 서버 정보를 기준으로 해야 합니다.

이 단계의 완료 기준:Home에 선택할 수 있는 서버가 있고 테스트할 항목이 선택되어 있어야 합니다. 아직 연결을 켜지 말고 다음 단계에서 요청 처리 방식을 확인하세요.

단계 02 · Global Routing

요청의 전반적인 처리 모드 선택

Global Routing은 전반적인 처리 방식을 결정하며 서버 매개변수를 보완하지 않습니다.Home에서 Global Routing을 누르고 현재 선택 항목을 확인하세요. 세 가지 모드는 Config, Proxy, Direct입니다. 처음 작업할 때는 현재 선택을 기억하고 테스트 중에는 이 항목만 변경하세요. 그래야 모드 차이를 서버 작동 상태의 변화로 잘못 판단하지 않습니다.

Config: 현재 설정에 따라 처리

Config는 현재 활성화된 설정에 따라 요청 처리 방식을 결정하며, 규칙에 따라 대상별로 DIRECT, PROXY 또는 기타 정의된 정책을 적용할 수 있습니다. 사용하기 전에 Config로 이동해 현재 사용 중인 파일이 적용하려는 설정인지 확인하세요. 서버 구독과 Config 설정 파일은 서로 다른 자료입니다. 전자는 주로 서버를 관리하고 후자는 규칙 및 관련 설정을 다루므로, 구독을 가져왔다고 해서 라우팅 규칙까지 가져온 것은 아닙니다.

신뢰할 수 있고 용도를 이해하는 설정이 있다면 안내에 따라 활성화한 다음 Home으로 돌아가세요. 이 안내를 완료하기 위해 기존 Config를 임의로 덮어쓰지 마세요. 규칙 매칭과 DNS 설정은 이후에 확인할 내용이므로 연결을 확인한 뒤 설정 매뉴얼을 읽으면 됩니다. 지금은 어떤 파일이 사용 중인지, 대상 요청이 어떤 경로를 따라야 하는지만 확인하세요.

Proxy: 선택한 서버 경로 확인

Proxy는 처음 확인할 때 선택한 서버가 요청을 전달하는지 살펴보는 데 유용하며, 라우팅 규칙이 판단에 미치는 영향을 줄여 줍니다. 이 모드가 모든 서비스에 대한 접근을 보장하거나 인증, TLS, 원격 서버 문제를 자동으로 해결하는 것은 아닙니다. 이 모드에서도 정상적으로 접근할 수 없다면 규칙을 더 추가하기 전에 서버와 네트워크를 확인하세요. 비교가 끝난 뒤 Config로 돌아갈지는 실제 라우팅 요구에 따라 결정하면 됩니다.

Direct: 로컬 네트워크와 비교

Direct는 요청을 직접 연결 경로로 처리하므로 로컬 네트워크와 프록시 경로의 동작을 비교하는 데 도움이 됩니다. 이 모드에서 웹페이지가 열리면 해당 직접 연결이 가능하다는 뜻일 뿐, 선택한 서버가 작동한다는 증거는 아닙니다. Direct를 시스템 VPN 스위치를 끄는 기능으로 이해하지 마세요. 모드 선택과 연결 스위치는 서로 다른 제어 항목입니다.

이 단계의 완료 기준:현재 선택한 모드와 용도를 알고 있어야 합니다. Config를 선택했다면 현재 활성화된 설정 파일도 확인하세요. 이 상태를 기록한 뒤 연결 승인 단계로 진행합니다.

단계 03 · Home

연결 스위치를 켜고 시스템 승인 완료

연결하려면 시스템에서 VPN 구성을 허용해야 합니다.Home으로 돌아가 현재 서버를 확인한 다음 Global Routing이 이전 단계에서 기록한 선택과 같은지 확인하고 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성 추가를 허용할지 묻는 창이 나타날 수 있습니다. 요청한 앱이 Shadowrocket인지 확인한 뒤 허용하고, 시스템 안내에 따라 암호 또는 기기 인증을 완료하세요. 구체적인 안내는 기기의 운영체제에 따라 다릅니다.

앞서 승인을 취소했다면 앱으로 돌아와 연결을 다시 시도하고 실제로 표시되는 시스템 요청에 따라 처리하세요. 웹페이지가 즉시 바뀌지 않는다고 스위치를 연달아 여러 번 조작하지 마세요. 먼저 연결 스위치가 켜진 상태로 유지되는지와 오류 메시지가 표시되는지 확인하세요. 시스템에서 여전히 확인을 요청하면 절차를 완료한 다음 Home에서 상태를 확인합니다.

테스트 중 다른 VPN 앱이나 기존 VPN 구성이 연결되어 있다면 연결을 끊은 뒤 다시 시도하세요. 서로 다른 연결 상태가 결과에 영향을 줄 수 있습니다. 조직에서 관리하는 기기는 VPN 구성이 제한될 수 있으므로 앱을 반복해서 삭제하기보다 기기 관리 정책을 확인하세요. 시스템 승인을 완료할 수 없다면 질문과 답변 페이지에서 설치 및 최초 실행 관련 문제를 계속 확인할 수 있습니다.

시스템에 VPN 상태가 표시되면 해당 시스템 연결이 설정되었거나 사용 중이라는 뜻입니다. 원격 서버 인증, 도메인 확인 및 모든 대상 웹사이트까지 성공적으로 검증되었다는 의미는 아닙니다. 반대로 상태 표시줄에 특정 표시가 계속 나타나지 않더라도 그것만으로 실패를 판단하지 마세요. 앱 스위치와 시스템 VPN 상태를 함께 확인해야 합니다. 다음 단계에서 실제 요청을 테스트하세요.

이 단계의 완료 기준:필요한 시스템 승인을 완료하고 앱의 연결 스위치가 켜진 상태로 유지되어야 합니다. 현재 서버와 모드를 그대로 둔 채 DNS, On Demand 또는 기타 고급 옵션을 서둘러 변경하지 말고, 동일한 조건으로 한 차례 테스트를 진행하세요.

단계 04 · Connectivity Test

서버와 실제 접속을 각각 확인

테스트 결과는 단계별로 판단해야 합니다. 서버 테스트 가능 여부, 웹페이지 접속 여부, 규칙이 예상대로 적용되는지는 서로 다른 결론입니다.먼저 Home에서 Connectivity Test를 사용해 서버 항목을 확인한 다음 이번에 사용할 서버를 선택합니다. 테스트 방식에 따라 결과의 의미가 달라집니다. 특정 수치는 해당 테스트 시점의 상태만 보여 주며 웹페이지 로딩 속도를 직접 나타내지는 않습니다. 더 작은 수치를 얻기 위해 서버를 계속 바꿀 필요도 없습니다.

그런 다음 브라우저를 열고 평소에 사용하며 정상 작동하는 것을 알고 있는 페이지에 접속해 로드와 후속 동작이 가능한지 확인합니다. 가능하면 새로 연 페이지를 사용하고 이미 캐시된 텍스트나 이미지를 새 요청의 성공으로 간주하지 마세요. 특정 앱에서만 문제가 생긴다면 먼저 브라우저에서 같은 서비스에 접속해 비교하세요. 곧바로 전체 설정을 변경하지 말고 문제가 해당 앱에 국한되는지 판단합니다.

Config에서 웹페이지가 열리더라도 규칙이 DIRECT를 선택했을 수 있습니다. 프록시 경로를 확인하려면 현재 설정에서 대상에 적용될 것으로 예상되는 정책을 먼저 파악하세요. 필요한 경우 같은 서버와 네트워크를 유지한 채 Proxy로 잠시 전환하고 같은 대상에 접속합니다. 비교가 끝나면 원래 필요한 모드로 되돌리세요. Wi-Fi, 서버, 모드를 동시에 바꾸면 결과가 달라져도 어떤 조건이 영향을 미쳤는지 확인하기 어렵습니다.

Connectivity Test에 결과가 있지만 웹페이지에 접속할 수 없다면 실제 요청에 사용된 프로토콜, 인증, DNS 또는 대상 서비스 상태를 더 확인해야 합니다. 테스트는 실패했지만 실제 웹페이지가 정상이라면 테스트 방식과 요청이 실제로 프록시 경로를 통과했는지 먼저 확인하세요. 단일 테스트만으로 결론을 내리지 말고 서버 테스트, 브라우저 접속, 현재 라우팅 선택을 함께 판단해야 합니다.

추가 확인이 필요하면 앱에서 이번 요청과 관련된 Log를 열어 대상, 연결 오류 및 처리 경로를 확인할 수 있습니다. 로그에는 접속 기록과 서버 정보가 포함될 수 있으므로 안전하게 보관하고 전체 내용을 공개하지 마세요. DNS와 Log를 읽는 방법은 DNS 설정 참고 및 설정 매뉴얼에서 확인할 수 있습니다.

이 단계의 완료 기준:어떤 서버, Global Routing 모드, 네트워크를 사용했는지와 실제 페이지가 정상적으로 열렸는지 설명할 수 있어야 합니다. 확인을 마친 뒤 필요한 규칙이나 On Demand 설정을 한 항목씩 추가하고, 추가할 때마다 같은 테스트를 반복하세요.

단계 05 · 단계별 점검

가져오기 결과부터 일반적인 문제 확인

문제 해결은 재설치가 아니라 가장 먼저 완료되지 않은 단계부터 시작합니다.가져오기, 선택, 승인, 접속 중 어디에서 문제가 발생했는지 먼저 판단하세요. 한 번에 한 항목만 변경하고 직전과 같은 서버, 대상 페이지, 테스트 방법을 사용해 다시 확인합니다. 변경 전 값을 보관해 기존에 사용할 수 있었던 기준을 잃지 않도록 하세요.

구독은 저장됐지만 목록에 서버가 없음

URL 전체를 복사했는지, 구독 주소가 아닌 일반 웹페이지 주소를 복사한 것은 아닌지, 링크가 줄 바꿈으로 잘리지 않았는지 확인하세요. 다음으로 현재 네트워크에서 구독을 읽을 수 있는지 확인하고 기존 서비스 제공업체에 링크 상태와 형식을 문의하세요. 구독에는 민감한 자격 증명이 포함될 수 있으므로 공개 토론 공간에 붙여넣지 마세요. 가져오기 오류를 확인하는 대신 구독을 반복해서 새로 만들지 마세요. 사용 가능한 기존 항목이 있다면 업데이트 문제를 처리하기 전에 먼저 보존하세요.

서버는 표시되지만 테스트와 접속이 모두 실패

서버를 직접 추가했다면 Add Server에서 해당 항목을 편집해 프로토콜, 주소, 포트, 인증 필드를 차례로 확인한 뒤 TLS 및 전송 매개변수를 확인하세요. 구독 항목이라면 먼저 구독 자료가 여전히 유효한지 확인한 다음 업데이트하세요. 항목 하나만 실패한다면 본인이 보유한 다른 항목과 비교할 수 있습니다. 모든 항목이 실패하면 로컬 네트워크가 정상인지, 원격 서비스에 공통 문제가 있는지 추가로 확인하세요.

연결 스위치가 켜진 상태로 유지되지 않음

먼저 시스템 VPN 구성 승인을 완료했는지 확인하고 다른 VPN 연결이나 기기 관리 제한이 있는지 살펴보세요. 처리할 시스템 안내가 없는지 확인한 뒤 다시 시도합니다. 수동으로 끈 뒤 스위치가 자동으로 다시 켜진다면 On Demand가 활성화되어 있는지 확인하세요. 자동 연결 조건을 일시 중지하고 수동으로 테스트해 자동 동작을 스위치 오류로 오해하지 않도록 합니다. 결과를 이해하지 못한 채 기기의 다른 구성을 삭제하지 마세요.

연결은 켜져 있지만 일부 페이지에서만 문제가 발생

Proxy와 Config의 결과를 먼저 비교하세요. Proxy에서는 정상이고 Config에서 문제가 생기면 현재 Config, 규칙 순서 및 관련 DNS 설정을 중점적으로 확인합니다. 두 모드 모두 문제가 있으면 서버와 네트워크를 다시 점검하세요. 특정 웹사이트 자체가 정상인지도 확인해 단일 사이트의 장애를 클라이언트 전체 문제로 확대하지 않도록 합니다. DNS를 무조건 첫 번째로 변경하지 마세요. 이름 확인과 관련된 근거가 있을 때만 기존 값을 기록하고 필요한 부분을 조정합니다.

문제를 문의하기 전에 최소 재현 정보 정리

기기 운영체제, 가져오기 방식, 프로토콜 이름, Global Routing 선택, Wi-Fi 또는 셀룰러 네트워크 사용 여부, 문제가 발생한 단계와 표시된 안내를 기록하세요. Log를 인용할 때는 오류와 관련된 부분만 남기고 구독 링크, 인증 정보, 비밀번호 및 기타 개인 정보를 삭제하세요. 전체 설정이나 QR 코드를 공개할 필요는 없으며, 바로 사용할 수 있는 서비스 자격 증명을 보내지 마세요.

기본 연결 확인을 마치면 이 안내의 작업은 완료됩니다. 일반적인 질문은 질문과 답변에서, 프로토콜과 규칙 키워드는 용어 매뉴얼에서 확인하세요. DNS, On Demand, Connectivity Test 및 기타 설정을 하나씩 살펴보려면 설정 매뉴얼을 참고하면 됩니다. 첫 연결 단계에서 모든 옵션을 한꺼번에 변경할 필요는 없습니다.