공식 매뉴얼 · 첫 설정
Shadowrocket 사용법
iPhone 또는 iPad에서 서버를 가져오고 트래픽 분기 모드를 선택한 뒤 연결을 확인합니다. 처음 설정할 때는 기존 서버 하나로 전체 과정을 진행한 다음 개별 규칙을 확인하세요.
Add Server에서 서버 또는 구독 추가
먼저 보유한 정보의 종류를 확인합니다. 구독 링크는 여러 서버를 가져오는 데 사용하며, 이후 구독을 업데이트할 수 있습니다. 단일 서버 정보는 보통 프로토콜, 주소, 포트, 인증 매개변수가 포함된 하나의 항목에 해당합니다. 둘 중 한 가지 방법만 사용하면 되며, 같은 링크를 두 입력 경로에 모두 넣을 필요는 없습니다.
구독 링크가 있는 경우: Subscribe 선택
- 서비스 제공업체에서 전체 구독 링크를 복사합니다. 계정 페이지 주소를 복사하거나 링크 앞부분만 잘라내지 마세요. 물음표 뒤에 구독에 필요한 매개변수가 포함될 수 있습니다.
- Home을 열고 Add Server를 누른 다음 Type에서 Subscribe를 선택합니다. 구독 주소 입력란에 링크를 붙여넣고 앞뒤에 불필요한 공백이 없는지 확인합니다. 메모 입력란이 있다면 출처를 알아볼 수 있는 이름을 적습니다.
- 저장한 뒤 Home으로 돌아갑니다. 해당 구독 그룹을 펼쳐 SERVER에 선택 가능한 서버가 표시되는지 확인합니다. 그룹 이름이 보인다고 서버 목록까지 가져온 것은 아닙니다. 처음 가져온 뒤에도 그룹이 비어 있다면 먼저 구독을 업데이트하고 항목이 생겼는지 확인합니다.
단일 서버 정보가 있는 경우: 프로토콜에 맞춰 입력
Home에서 Add Server를 열고 Type에서 제공된 정보에 표시된 프로토콜을 선택한 다음 해당 항목을 입력합니다. Host에는 서버 주소를, Port에는 포트를 입력합니다. 주소와 포트는 각각 입력하며, 공유 링크 전체를 Host에 넣지 마세요. Password, Method 등의 항목은 선택한 프로토콜에 따라 표시 여부가 달라집니다. 특정 프로토콜의 화면에 나온 항목을 다른 프로토콜에 그대로 적용하지 마세요.
서비스 제공업체에서 받은 단일 서버 QR 코드가 있다면 Add Server에서 Scan QR Code를 사용할 수 있습니다. 스캔한 뒤 Type, Host, Port를 확인하고 저장합니다. QR 코드나 공유 링크에는 인증 정보가 포함될 수 있으므로 공개 토론 공간에 게시하지 마세요.
Global Routing에서 트래픽 분기 모드 선택
Home으로 돌아가 Global Routing을 누릅니다. 여기서 이후 트래픽을 처리하는 방식을 결정합니다. SERVER에서 서버를 선택하는 것은 프록시 요청에 사용할 서버를 지정하는 것이며, 트래픽 분기 모드를 자동으로 Proxy로 바꾸지는 않습니다.
- 구성(Config)
- 현재 활성화된 구성 파일의 규칙에 따라 요청을 하나씩 매칭합니다. 사용할 구성 파일이 있고 일부 요청은 프록시로, 나머지는 직접 연결로 처리하려면 이 항목을 선택합니다.
- 프록시(Proxy)
- 클라이언트가 처리하는 트래픽을 프록시로 보냅니다. 구성 파일의 트래픽 분기 규칙에 따라 항목별로 결정하지 않습니다. 서버가 프록시 요청을 처리할 수 있는지 처음 확인할 때 짧게 비교 테스트할 수 있습니다.
- 직접 연결(Direct)
- 클라이언트가 처리하는 트래픽을 선택한 프록시 서버를 거치지 않고 대상에 직접 연결합니다. 비교 기준으로 사용할 수 있습니다. Direct에서도 같은 주소가 열리지 않는다면 이 결과만으로 프록시 서버에 문제가 있다고 판단할 수 없습니다.
Config를 선택하기 전에 구성 파일 확인
하단의 Config는 구성 파일을 확인하고 관리하는 메뉴입니다. Global Routing의 Config는 구성 파일을 사용해 트래픽을 분기한다는 뜻입니다. 먼저 구성 파일 목록에서 의도한 파일이 활성화되어 있는지 확인한 뒤 Home으로 돌아가 Global Routing에 Config가 표시되는지 확인합니다. 파일의 편집 화면을 열기만 해서는 해당 파일이 활성화되지 않습니다.
구성 파일에서는 Rule의 매칭 순서가 결과에 영향을 줍니다. 같은 도메인이 위쪽의 포괄적인 규칙과 아래쪽의 구체적인 규칙 모두에 해당할 수 있다면 먼저 매칭된 규칙이 처리 방향을 결정합니다. FINAL은 앞에서 매칭되지 않은 요청을 처리합니다. 처음 연결할 때는 Rule을 편집할 필요가 없습니다. 확인을 위해 사용한 구성 파일과 모드를 기억해 두세요.
모드를 선택한 뒤 Home으로 돌아가 Global Routing 행에 방금 선택한 항목이 표시되는지 확인합니다. 아직 분기 목표가 명확하지 않다면 Proxy로 서버를 테스트한 다음 Config로 돌아가 규칙을 확인할 수 있습니다.
Home에서 연결 스위치 켜기
- 먼저 서버를 선택합니다.Home의 SERVER에서 방금 가져온 항목을 누르고 선택 표시가 대상 항목에 있는지 확인합니다. 목록에 이름이 비슷한 항목이 여러 개라면 그룹과 메모를 확인해 이후 테스트에서 다른 항목을 대상으로 삼지 않도록 합니다.
- 상단 스위치를 켭니다.처음 사용할 때 iPhone 또는 iPad에 Shadowrocket의 VPN 구성 추가를 허용할지 묻는 시스템 안내가 표시될 수 있습니다. 시스템 팝업인지 확인한 다음 안내에 따라 허용합니다. 기기 인증이 필요하다면 시스템 화면에서만 완료하세요. 이전에 취소했다면 Home으로 돌아가 스위치를 다시 켭니다.
- 상태가 바뀔 때까지 기다립니다.상단 상태가 Not Connected에서 Connected로 바뀌면 기기에서 연결이 설정된 것입니다. 스위치가 다시 꺼지거나 상태가 바뀌지 않거나 시스템에서 관리 정책에 따른 제한을 알리면 같은 정보를 반복해서 가져오지 말고 5단계에 따라 확인합니다.
Connected는 기기 자체의 연결 상태를 나타내며, 모든 요청이 서버를 거친다거나 대상 웹페이지에 반드시 접속할 수 있다는 뜻은 아닙니다. 예를 들어 Global Routing에서 Direct를 선택해도 상단에 Connected가 표시될 수 있지만 요청은 직접 연결 방식으로 처리됩니다. 실제 접속이 정상인지 판단하려면 다음 단계의 테스트도 진행해야 합니다.
기기가 평소 다른 VPN에 자동으로 연결된다면 현재 시스템에서 어떤 연결을 사용 중인지 확인합니다. 기기를 직접 관리하고 해당 연결이 직장이나 학교의 필수 설정이 아닌 경우에만 다른 VPN을 일시 중지해 비교합니다. 본인 소유가 아닌 구성은 제거하지 마세요.
Connectivity Test와 웹페이지 접속으로 확인
테스트는 두 단계로 나눕니다.먼저 현재 테스트 방식에서 서버가 응답하는지 확인하고, 다음으로 브라우저에서 확인하려는 주소에 접속할 수 있는지 살펴봅니다. 첫 번째 테스트가 성공해도 두 번째 테스트까지 성공한다는 뜻은 아닙니다. 웹페이지가 열리더라도 요청이 프록시를 거쳤는지 직접 연결되었는지는 이것만으로 판단할 수 없습니다.
- 이번 테스트 조건을 기록합니다.Home에서 상단 상태, 선택한 서버, Global Routing 모드를 확인합니다. 다시 테스트할 때는 같은 Wi-Fi 또는 셀룰러 네트워크를 사용합니다. 네트워크와 서버를 동시에 바꾸면 결과가 달라질 수 있으므로 한 번에 바꾸지 마세요.
- Connectivity Test를 실행합니다.Home에서 Connectivity Test를 누르고 결과가 업데이트될 때까지 기다린 다음 선택한 서버의 결과를 확인합니다. 시간 초과가 발생하면 해당 항목 하나만 실패했는지, 기존의 다른 항목에서도 같은 현상이 나타나는지 기록합니다. 테스트 응답 시간은 이번 테스트 조건에서의 결과이며 웹페이지 로딩 속도를 의미하지 않습니다.
- 정상 작동이 확인된 주소를 다시 요청합니다.브라우저로 전환해 새 탭에서 평소 접속되는 일반 웹페이지를 엽니다. 기존에 불러온 내용을 새 요청의 성공으로 잘못 판단하지 않도록 페이지를 새로고침하거나 같은 사이트의 다른 페이지를 열어도 됩니다. 오류가 발생하면 호스트를 찾을 수 없는지, 연결 시간 초과인지, 페이지 로딩이 시작된 뒤 중단되는지 기록합니다.
- 트래픽 분기를 확인해야 할 때 모드를 비교합니다.네트워크, 서버, 대상 주소를 그대로 둔 채 Home에서 Proxy와 Direct를 각각 선택해 같은 주소에 다시 접속한 다음 Config로 돌아가 재테스트합니다. Config에서만 결과가 다르면 현재 구성 파일과 실제로 매칭된 Rule을 먼저 확인합니다. 테스트가 끝나면 평소 사용할 모드로 되돌립니다.
실패한 단계에 따라 문제 확인
먼저 서버 항목을 가져오지 못했는지, 연결을 설정하지 못했는지, 연결 후 접속에 문제가 생겼는지 구분합니다. 가장 먼저 실패한 단계부터 확인하고 설정을 하나 변경할 때마다 다시 테스트합니다. 클라이언트 재설치, 구독 변경, 구성 변경을 한꺼번에 진행하면 문제가 해결되어도 원인을 파악하기 어렵습니다.
구독을 저장했지만 SERVER에 서버가 없음
먼저 그룹이 접혀 있지 않은지 확인하고 현재 네트워크에서 일반 웹페이지가 열리는지 살펴봅니다. 구독 주소가 잘리지 않았는지, 계정 페이지 주소를 붙여넣은 것은 아닌지 확인합니다. 업데이트에 실패하고 이전 목록이 그대로 남아 있다면 기존 항목은 이전에 가져온 기록일 뿐입니다. 기존 항목을 유지한 상태에서 새 주소를 읽을 수 있는지 확인한 다음 교체하세요. 처음부터 아직 사용할 수 있는 그룹을 삭제하지 마세요.
스위치를 켜도 Not Connected가 표시됨
Home으로 돌아가 서버를 선택했는지 확인하고, VPN 구성을 처음 추가할 때 시스템 안내를 취소했는지 살펴봅니다. 시스템에서 다른 VPN이 실행 중이라면 3단계에 따라 현재 연결을 먼저 확인합니다. 수동으로 연결을 끊은 뒤 다시 자동 연결된다면 Settings에서 On Demand가 조건에 따라 작동하는지 확인합니다. 조정할 수 있는 개인 기기라면 On Demand를 먼저 끈 다음 수동 연결을 비교 테스트할 수 있습니다.
Connected가 표시되지만 테스트 시간 초과 또는 웹페이지 접속 실패
먼저 Direct와 비교합니다. Direct에서도 평소 열리는 여러 웹페이지에 접속할 수 없다면 현재 네트워크에 로그인이 필요한지 또는 기기 자체가 인터넷에 정상적으로 연결되어 있는지 확인합니다. Direct는 정상이지만 Proxy에서 실패한다면 Add Server에서 해당 항목의 프로토콜, 주소, 포트, 인증 매개변수를 확인합니다. 서비스 제공업체의 정보에서 변경을 명확히 안내하지 않은 항목은 우선 원래 값으로 둡니다.
Config 모드에서만 특정 도메인에 문제가 발생함
Config에서 활성화된 파일을 확인한 다음 Rule에서 더 앞에 있는 포괄적인 매칭이 있는지 살펴봅니다. 호스트를 찾을 수 없다는 오류가 발생하면 먼저 도메인과 발생 시간을 기록하고 현재 구성의 DNS를 확인합니다. 처음부터 모든 DNS 설정을 바꾸지는 마세요. 규칙 및 DNS의 세부 항목은 설정 매뉴얼에서 하나씩 확인할 수 있습니다.
문제가 계속되면 실패한 단계, 현재 네트워크 유형, Global Routing에서 선택한 항목, 오류 문구를 먼저 기록한 다음 문제 해결의 해당 분류를 확인합니다. 스크린샷이나 진단 기록을 공유하기 전에 구독 링크, QR 코드, 서버 인증 매개변수 및 기타 민감한 정보를 가리세요.