공식 매뉴얼 / 빠른 시작
Shadowrocket 구독 가져오기와 첫 연결
처음 설정할 때는 기존 정보를 가져오고, 트래픽 처리 모드를 정한 뒤, 실제 접속을 확인하면 됩니다. 먼저 구성 파일을 편집하거나 서버를 여러 개 추가할 필요는 없습니다.
서버 추가 또는 구독 가져오기
Shadowrocket을 열고 Home으로 이동한 다음 SERVER 그룹에서 Add Server를 찾습니다. 먼저 보유한 정보의 형식을 확인하세요. 주소, 포트, 인증 정보가 각각 제공된 경우 단일 서버로 추가하고, 서비스 제공자가 항목을 불러오는 링크를 제공한 경우 구독으로 가져옵니다. 둘 중 한 가지 방법을 선택하면 되며, 첫 연결을 위해 같은 정보를 중복 입력할 필요는 없습니다. 같은 정보는 어떤 방법으로 추가하더라도 기존 프로토콜과 매개변수를 유지하고, 화면 예시의 필드를 보고 추측해 입력하지 마세요.
단일 서버 정보가 있는 경우: 먼저 Type 선택
Add Server로 이동한 다음 Type에서 정보에 명시된 프로토콜(예: Shadowsocks 또는 Trojan)을 선택합니다. 선택한 프로토콜에 따라 이후에 표시되는 필드가 달라집니다. 일반적으로 Host와 Port를 먼저 입력한 뒤 화면에 따라 Password, Method 또는 해당 프로토콜에 필요한 다른 매개변수를 입력합니다. Host에는 제공된 서버 주소를, Port에는 별도로 안내된 포트 번호를 입력합니다. 전체 구독 링크를 이 두 필드에 나누어 넣지 마세요. 해당 서버의 QR 코드가 있다면 Scan QR Code로 가져온 뒤 프로토콜과 주소를 확인할 수도 있습니다. 필수 정보가 부족하면 다른 프로토콜의 매개변수를 임의로 입력하지 말고 정보 제공자에게 확인하세요.
구독 링크가 있는 경우: Subscribe 선택
Add Server에서 Type을 Subscribe로 설정하고 원본 구독 링크 전체를 링크 입력란에 붙여 넣은 뒤 저장합니다. 링크에서 물음표 뒤에 오는 부분도 항목을 불러오는 데 필요한 정보일 수 있으므로 직접 삭제하지 마세요. 링크를 공개 채팅이나 스크린샷에 공유하지 마세요. Home으로 돌아가 해당 그룹에 선택 가능한 항목이 표시될 때까지 기다립니다. 그룹 이름만 보이고 펼쳐도 항목이 없다면, 빈 그룹을 서버로 연결하려 하지 말고 먼저 구독 로드 문제를 해결하세요. 저장은 정보가 입력되었다는 뜻일 뿐, 클라이언트가 연결되었다는 뜻은 아닙니다. 선택할 수 있는 항목이 표시되면 트래픽 처리 모드를 선택합니다.
Global Routing 모드 선택
Home으로 돌아가 Global Routing을 누릅니다. 이 메뉴는 클라이언트가 요청을 처리하는 방식을 정하며, 서버를 추가하거나 연결을 켜는 기능은 아닙니다. 처음부터 규칙에 따라 사용하려면 Config를 선택하세요. 특정 요청이 프록시와 직접 접속 중 어느 경로를 사용하는지 비교하려는 경우에만 다른 두 모드를 잠시 사용합니다.
- Config: 현재 구성 파일의 규칙을 사용합니다. 요청마다 PROXY, DIRECT 또는 REJECT에 각각 매칭될 수 있으므로 스위치를 켜도 모든 요청이 선택한 서버를 통과하는 것은 아닙니다.
- Proxy: 클라이언트가 처리하는 요청을 프록시 경로로 보냅니다. 규칙에 따른 분할에서만 문제가 생기는지 접속 결과를 비교할 때 사용할 수 있습니다. 확인을 마치면 평소 사용하는 모드로 돌아가세요.
- Direct: 클라이언트가 처리하는 요청을 프록시 서버를 거치지 않고 직접 접속시킵니다. 비교 확인에 사용할 수 있지만 상단 스위치를 끄는 것과는 다릅니다. Direct로 전환해도 클라이언트 연결이 중지되는 것은 아닙니다.
Config를 선택한 뒤 Config로 돌아가 예상한 파일이 현재 활성화되어 있는지 확인합니다. 파일을 열어 General, Rule, Hosts, URL Rewrite 등의 섹션을 확인할 수 있습니다. 화면의 Add Rule은 규칙을 편집하는 메뉴이며 첫 연결에 반드시 거쳐야 하는 버튼은 아닙니다. 특히 Home의 Config 모드와 하단의 Config 페이지를 구분하세요. 전자는 규칙에 따라 트래픽을 분할하고, 후자는 파일을 확인하거나 관리하는 곳입니다. Config 페이지에서 파일을 열어 보는 것만으로 해당 파일이 현재 활성 파일로 설정되는 것은 아닙니다.
이미 사용할 수 있는 구성이 있다면 첫 연결에서는 그대로 유지하세요. 특정 대상을 확인하려고 Rule을 모두 지우거나 모든 규칙의 정책을 같게 바꾸지 마세요. 그러면 서버, 구성 또는 대상 중 어디에서 변화가 생겼는지 구분하기 어렵습니다. 규칙 순서와 FINAL을 확인하려면 구성 필드 참고 가이드를 보세요. 지금은 Home으로 돌아가 연결을 준비합니다.
Home에서 연결 스위치 켜기
Home의 SERVER에서 방금 추가한 서버를 선택합니다. 구독을 가져온 경우 해당 그룹을 펼친 다음 항목 하나를 선택합니다. 이름이나 메모가 보유한 정보와 일치하는지 확인해 이전 항목을 잘못 선택하지 않도록 합니다. 다음으로 Global Routing의 현재 값을 확인해 비교용으로만 사용하는 Direct에 설정되어 있지 않은지 확인하세요. 그런 다음 Home 상단의 스위치를 켭니다. 서버 항목을 누르는 동작과 연결 스위치를 누르는 동작은 별개이므로, 첫 번째 동작만으로는 연결이 시작되지 않습니다.
처음 스위치를 켤 때 시스템에서 VPN 구성 추가를 안내할 수 있습니다. 안내가 방금 Shadowrocket에서 스위치를 켠 동작으로 표시된 것인지 확인한 다음 기기의 지시에 따라 허용하세요. 시스템에서 본인 인증을 요청하면 기기에서 사용하는 인증 방법을 따릅니다. 완료 후 Home으로 돌아가 스위치가 안정적으로 켜져 있는지, 상단에 Not Connected가 더 이상 표시되지 않는지 확인합니다. 안내를 실수로 취소했다면 Home에서 스위치 상태를 먼저 확인한 뒤 다시 한 번 켜 보세요. 계속 바로 연결이 끊기면 일반적인 오류 점검으로 이동하고 반복해서 누르지 마세요.
연결이 설정되었다고 표시되면 기기에서 연결이 시작된 것만 확인할 수 있습니다. 선택한 서버가 특정 대상에 접속할 수 있는지, 특정 규칙이 매칭되었는지까지 확인되는 것은 아닙니다. 현재 Wi-Fi 또는 셀룰러 네트워크를 유지하고 연결 도중 네트워크를 바꾸지 마세요. 서버와 Global Routing도 그대로 둔 채 다음 단계에서 테스트 결과와 실제 접속을 각각 확인합니다.
테스트와 실제 접속으로 연결 확인
Home에서 Connectivity Test를 눌러 선택한 항목이 테스트 결과를 반환하는지 확인합니다. 두 가지 결과를 구분하세요. 스위치가 안정적으로 켜져 있으면 기기에서 연결이 시작된 것이고, 테스트 결과가 표시되면 현재 테스트 방식으로 응답을 받은 것입니다. 응답 또는 시간 초과 결과는 당시의 테스트 조건만 반영하므로 모든 사이트나 앱에 접속할 수 있는지 판단하는 데 사용할 수 없습니다. 한 번의 테스트 결과만으로 구독이나 구성을 통째로 바꾸지 마세요.
그런 다음 평소 안정적으로 접속할 수 있고 예상 트래픽 처리 방식도 알고 있는 페이지를 열어 새로 불러옵니다. 화면에 이미 표시된 이전 페이지를 성공으로 간주하지 말고, 다시 로드해 새 콘텐츠가 실제로 반환되는지 확인하세요. Config에 따른 트래픽 분할을 확인하려면 예상 경로가 DIRECT인 대상과 PROXY인 대상을 각각 선택해 테스트하는 것이 좋습니다. 두 페이지가 모두 열리더라도 접속 성공만 확인된 것입니다. 어떤 규칙이 적용되었는지 확인하려면 현재 파일의 Rule 순서를 대조해야 하며, 페이지가 열리는지 여부만으로 정책을 추정해서는 안 됩니다.
Config에서 같은 대상에 접속하지 못한다면 Proxy로 잠시 바꾸고, 같은 네트워크와 서버, 대상을 사용해 다시 테스트할 수 있습니다. 필요한 경우 Direct로 전환해 비교합니다. Config에서만 실패하면 현재 구성 파일과 규칙 매칭 순서를 먼저 확인합니다. Proxy에서도 실패하지만 Direct에서는 정상이라면 서버 정보와 테스트 결과를 먼저 확인합니다. 세 모드에서 모두 실패하면 기본 네트워크와 대상 자체를 사용할 수 있는지 확인하세요. 어떤 모드에서 성공하거나 실패했는지 기록한 다음 예상 모드로 돌아가 그 결과를 바탕으로 다음 단계로 진행합니다.
증상에 따라 점검하고 다시 테스트
구독을 저장했지만 SERVER에 항목이 없음
가져올 때 Subscribe를 선택했는지 확인한 다음, 붙여 넣은 링크에 줄 바꿈이 포함되었거나 마지막 문자가 빠지지 않았는지, 서비스 제공자의 로그인 페이지 주소를 잘못 사용하지 않았는지 확인합니다. Home으로 돌아가 그룹이 로드되었는지 살펴봅니다. 그룹이 계속 비어 있다면 원래 서비스 제공자에게 링크가 여전히 유효한지 확인하세요. 직접 추가한 항목이 표시되지만 연결되지 않는 경우 해당 항목의 편집 화면으로 돌아가 Type, Host, Port, 인증 매개변수를 확인합니다. 구독 새로고침 실패와 단일 서버 연결 실패는 서로 다른 문제이며, 클라이언트 재설치는 보통 첫 번째 해결 방법이 아닙니다.
스위치가 다시 꺼지거나 수동으로 끊은 뒤 저절로 연결됨
스위치가 켜지지 않으면 처음 VPN 구성 안내를 완료했는지 확인하고, 시스템에서 다른 VPN 연결이 실행 중인지 살펴봅니다. 스위치를 끌 수는 있지만 Wi-Fi나 셀룰러 네트워크를 전환한 뒤 연결이 다시 시작된다면 Settings에서 On Demand를 확인하세요. 기존 설정을 기록합니다. 기기에서 설정을 변경할 수 있다면 수동 테스트 중에는 직접 설정한 온디맨드 연결을 잠시 끄고, 테스트 후 원래 상태로 복원할 수 있습니다. 이렇게 하면 수동 스위치 동작과 온디맨드 조건에 따른 동작을 구분해 확인할 수 있습니다.
연결은 안정적이지만 접속 결과가 일관되지 않음
앞 단계에서 확인한 비교 결과를 바탕으로 문제 범위를 좁힙니다. Config에서만 실패한다면 현재 활성 파일과 Rule 순서를 먼저 확인합니다. Connectivity Test와 Proxy 접속이 모두 실패한다면 선택한 서버와 현재 네트워크를 다시 확인하세요. Settings에서 Test Method를 확인하고 사용 중인 테스트 방식을 기록해 서로 다른 조건에서 나온 결과를 직접 비교하지 않도록 합니다. 진단 정보를 확인해야 한다면 Diagnostics를 살펴봅니다. 스크린샷이나 진단 내용을 공유하기 전에 구독 링크와 인증 정보를 가리세요.
한 번에 한 곳만 변경한 뒤 「스위치 확인 → 테스트 실행 → 같은 페이지 다시 로드」 순서로 재검사합니다. 이렇게 하면 문제가 계속되어도 입력 정보, 기기 연결, 접속 경로 중 어느 단계에서 실패하는지 범위를 좁힐 수 있습니다. DNS, 규칙 또는 다른 연결 문제를 더 확인해야 한다면 연결 문제 Q&A를 참고하세요. 익숙하지 않은 프로토콜이나 설정 이름은 용어집에서 확인할 수 있습니다.
DOWNLOAD / 모든 플랫폼에서 이용