Shadowrocket 공식 매뉴얼

Shadowrocket 사용법

서버 또는 구독을 추가하고 라우팅 모드를 선택한 뒤 첫 연결을 확인합니다.

시작하기 전에: 이 안내는 iPhone / iPad 화면을 기준으로 합니다. 먼저 Shadowrocket을 설치하세요. iPhone / iPad는 App Store에서 $2.99에 한 번만 결제해 이용할 수 있으며, 시스템 요구 사항은 App Store 페이지를 기준으로 합니다. Mac / Windows / Android / Linux 버전은 무료이며, 이 사이트의 다운로드 페이지에서 받으세요. 컴퓨터나 Android 시스템에서 설치를 차단하면 파일 출처를 확인한 뒤 해당 시스템의 설치 안내를 따르세요.

기존 구독 링크 또는 서버 정보 중 하나를 준비하세요. 이 사이트는 서버나 구독을 제공하지 않습니다. 앱의 일회성 구매는 회선 요금제와 별개입니다.

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

Shadowrocket을 열고 먼저 Home에서 SERVER를 확인합니다. 여기에 사용할 항목이 이미 있으면 선택하면 되며 다시 가져올 필요는 없습니다. 목록이 비어 있다면 보유한 정보에 맞는 방법을 선택합니다. 단일 서버 연결 정보는 Add Server에서 직접 입력하고, 여러 항목을 가져오는 구독 링크는 Subscribe를 선택합니다. 두 방법을 모두 사용할 필요는 없습니다.

단일 서버 정보가 있는 경우

Add Server를 누르고 먼저 Type에서 정보에 표시된 프로토콜을 선택한 뒤 Host와 Port를 입력합니다. 스크린샷의 입력 양식에서는 Password와 Method가 각각 정보에 기재된 비밀번호와 암호화 방식을 뜻합니다. 프로토콜에 따라 표시되는 필드가 다르므로 Type을 변경한 뒤 현재 양식에 맞춰 입력하세요. 프로토콜 접두사와 경로가 포함된 전체 링크를 Host에 입력하지 말고, 필드 이름만 보고 비밀번호나 암호화 방식을 추측하지 마세요. 정보가 누락되었다면 원본 정보를 다시 확인하세요.

단일 서버의 QR 코드가 있다면 Add Server에서 Scan QR Code를 사용할 수도 있습니다. 인식한 뒤 Type과 주소를 확인하고 저장하세요. 연결 자격 증명이 포함된 QR 코드를 공개 그룹에 공유하지 말고, 출처를 알 수 없는 QR 코드로 현재 사용할 수 있는 항목을 덮어쓰지 마세요.

구독 링크가 있는 경우

Home에서 추가 버튼을 누른 다음 추가 화면의 Type에서 Subscribe를 선택합니다. 전체 구독 링크를 주소 입력란에 붙여 넣고, 기존 경로와 매개변수는 그대로 둡니다. 앞뒤에 불필요한 공백이 없는지 확인한 뒤 저장하세요. Home으로 돌아가 구독을 불러올 때까지 기다린 다음 SERVER에서 선택할 항목을 찾습니다. Import from Cloud JSON은 다른 입력 형식이며 일반 구독 링크를 붙여 넣는 곳이 아닙니다.

저장한 뒤 테스트할 서버를 선택하세요. 목록에 이름이 표시된다는 것은 항목을 가져왔다는 뜻일 뿐, 모든 항목을 사용할 수 있다는 의미는 아닙니다. 선택할 항목이 보이지 않으면 연결 스위치를 켜지 말고 5단계에서 가져오기 결과를 확인하세요.

Add Server 화면에 표시된 Type, Host, Port, Password 및 Method 입력란
Add Server: Type을 선택한 다음 해당 프로토콜에 필요한 항목을 입력합니다.

Global Routing 모드 선택

서버를 선택한 뒤에도 Home에 머물러 Global Routing을 누릅니다. 여기서는 트래픽 처리 방식을 선택하며 서버를 변경하지 않습니다. 처음 설정하는 경우 준비된 규칙 파일이 있다면 먼저 Config를 선택한 다음 예상한 파일이 적용되어 있는지 확인하세요. 단순 비교 테스트를 하려는 경우에는 원래 선택된 모드를 기록하고 테스트 후 되돌립니다.

  • 구성(Config): 현재 구성의 규칙에 따라 정책을 선택합니다. 서버를 선택했더라도 모든 요청이 해당 서버를 통해 전달되는 것은 아닙니다. 규칙에 따라 요청이 직접 연결되거나 거부될 수 있습니다.
  • 프록시(Proxy): 처리 범위에 포함된 트래픽을 프록시 경로로 보냅니다. 서버 문제와 구성 규칙 문제를 구분해야 할 때 잠시 이 모드로 전환해 비교할 수 있습니다.
  • 직접 연결(Direct): 현재 선택한 프록시 서버를 거치지 않고 연결합니다. 원래 직접 접속할 수 있어야 하는 사이트에 현재 네트워크로 접속 가능한지 확인할 때 적합합니다. 연결 스위치를 끄는 것과는 다른 작업입니다.

구성(Config)을 선택한 뒤 하단의 Config로 이동해 구성 목록을 확인합니다. 예상한 파일 이름을 기준으로 어떤 파일이 사용 중인지 확인하세요. 파일을 열면 스크린샷처럼 General, Rule, Hosts 등의 구역이 표시됩니다. 첫 연결을 확인하기 위해 새 규칙을 추가하거나 HTTPS Decryption을 변경할 필요는 없습니다. 현재 네트워크에 적합한 구성을 판단하기 어렵다면 기존 파일을 유지하고 규칙, 이름 해석, 서버를 동시에 변경하지 마세요.

같은 서버가 프록시(Proxy)에서는 접속되지만 구성(Config)에서는 접속되지 않는다면 대상에 적용된 규칙을 먼저 확인하세요. 예를 들어 대상이 마지막 FINAL 규칙이 아니라 더 넓은 범위의 규칙에 먼저 일치할 수 있습니다. 첫 연결만 확인하려는 경우에는 현상을 기록해 두세요. 규칙의 순서와 작성 방법은 구성 안내를 참고하세요.

General, Rule, Hosts, URL Rewrite 및 HTTPS Decryption 구역이 표시된 Config 파일 편집 화면
Config: 현재 파일을 확인한 다음 Rule 구역을 살펴봅니다.

Home 상단 스위치를 켜서 연결

Home으로 돌아가 현재 Global Routing 모드를 확인한 다음 SERVER에서 선택한 항목이 방금 테스트하려던 서버인지 확인합니다. 스크린샷 상단의 Not Connected는 아직 연결되지 않았다는 뜻입니다. 해당 행의 스위치를 누르고 시스템이나 앱의 응답을 기다리세요. 스위치를 연속해서 반복 조작하지 마세요.

처음 연결할 때 시스템에서 VPN 구성을 추가하라는 안내가 표시될 수 있습니다. 방금 실행한 Shadowrocket에서 시작된 안내인지 확인한 뒤 시스템 지침에 따라 허용하세요. 기기 인증을 요청하면 인증을 마치고 Home으로 돌아가 스위치 상태를 확인합니다. 취소를 눌렀다면 앱으로 돌아와 연결을 다시 시작하고 안내를 처리하세요. 회사나 학교에서 관리하는 기기이며 시스템이 VPN 구성 변경을 제한한다면 기기 관리자에게 문의하고 관리 설정을 제거하지 마세요.

스위치를 켠 직후 다시 꺼지면 화면에 표시된 안내를 기록하고, 완료되지 않은 시스템 권한 요청이 있는지 또는 다른 VPN 구성이 실행 중인지 확인하세요. 기존 연결이 업무용이라면 용도를 먼저 확인하고 테스트를 위해 함부로 삭제하지 마세요. 스위치가 켜져 있더라도 바로 모든 것이 정상이라고 판단하지 마세요. 다음 단계에서 서버 응답과 실제 웹페이지 접속을 각각 확인해야 합니다.

상단에 Not Connected 스위치가 있고 아래에 Global Routing, Connectivity Test 및 SERVER가 표시된 Home 화면
Home: 서버와 모드를 확인한 다음 상단 스위치를 켭니다.

서버 응답과 실제 접속 확인

현재 네트워크를 그대로 유지하고 먼저 Home 상단 스위치가 켜져 있는지 확인한 다음 Connectivity Test를 눌러 선택한 항목의 결과를 살펴봅니다. 테스트에 응답이 있다는 것은 현재 방법으로 테스트 결과를 얻었다는 뜻일 뿐, 어떤 웹사이트든 접속할 수 있다는 의미는 아닙니다. 지연 시간 수치를 다운로드 속도로 해석해서도 안 됩니다. 테스트 시간이 초과되면 현재 서버와 테스트 방식을 기록하고 짧은 시간에 여러 설정을 연속해서 바꾸지 마세요.

그런 다음 브라우저를 열어 평소 접속할 수 있고 로그인이 필요 없는 웹페이지를 방문한 뒤 직접 새로 고침합니다. 캐시를 새 요청으로 오인하지 않도록 하기 위한 절차입니다. 구성(Config)에서 직접 연결 규칙과 프록시 규칙을 함께 관리한다면 각 정책을 따라야 하는 것으로 확인된 사이트를 하나씩 사용해 비교할 수 있습니다. 두 페이지가 모두 열리면 이번 접속이 가능하다는 뜻입니다. 페이지가 열렸다는 사실만으로 요청이 지정된 경로를 통과했다고 입증되지는 않습니다. 경로를 확인해야 한다면 Diagnostics에서 현재 버전이 제공하는 기록을 참고해 요청과 정책을 확인하세요.

대상 하나만 실패한다면 같은 서버를 유지한 채 정상 작동이 확인된 다른 페이지와 먼저 비교하세요. 두 대상 모두 실패하면 가능한 경우 Shadowrocket을 끄고, 원래 직접 접속할 수 있다고 확인한 웹페이지로 기본 네트워크를 점검합니다. 기본 네트워크에서도 열리지 않으면 먼저 Wi-Fi 로그인이나 모바일 데이터 연결 문제를 해결하세요. 확인을 마친 뒤 테스트를 위해 임시로 변경한 모드를 평소 사용하는 설정으로 되돌리고 다시 테스트합니다.

문제가 발생한 단계에 따라 해결

가져온 뒤 선택할 항목이 없음

먼저 구독 링크를 일반 서버의 Host에 입력한 것이 아니라 Subscribe로 저장했는지 확인하세요. 원본 정보에서 링크가 완전하고 유효한지 확인하고, 현재 네트워크에서 구독을 불러올 수 있는지 확인한 뒤 다시 시도하세요. 수동으로 추가한 항목은 Type, 포트 및 해당 프로토콜의 필수 입력란을 확인합니다. 구독을 열 수 없는 문제와 단일 서버를 사용할 수 없는 문제는 서로 다른 확인 항목입니다.

스위치가 켜지지 않거나 끈 뒤 다시 연결됨

스위치가 켜지지 않으면 재설치를 서두르지 말고 시스템 권한 단계부터 다시 확인하세요. 직접 껐는데 다시 연결된다면 Settings에서 On Demand를 열어 적용 중인 조건이 있는지 확인합니다. 기기 정책상 허용된다면 기존 설정을 기록하고 관련 조건을 잠시 비활성화해 수동 스위치를 다시 테스트한 다음 필요한 설정을 복구하세요.

스위치는 켜졌지만 웹페이지가 열리지 않음

먼저 SERVER에서 올바른 항목을 선택했는지 확인한 다음 Connectivity Test와 웹페이지 결과를 비교하세요. 테스트 결과를 비교해야 한다면 Settings에서 Test Method를 확인하세요. 방식이 다르면 결과 수치를 직접 비교하기 어렵습니다. 프록시(Proxy)에서는 같은 대상에 접속할 수 있지만 구성(Config)에서는 접속할 수 없다면 현재 파일과 규칙 순서를 먼저 확인하고 REJECT 규칙에 일치했거나 예상하지 않은 DIRECT 경로를 사용했는지 살펴보세요. 기록에 도메인 이름 해석 실패가 표시된다면 구성의 DNS 설정을 확인하세요. 이름 해석 실패를 곧바로 서버 오프라인으로 판단하지 마세요.

문제를 해결할 때는 한 번에 조건 하나만 변경하고 같은 웹페이지로 반복 확인하세요. 문제를 기록할 때는 네트워크 유형, 연결 모드, 실패한 단계와 안내 내용을 적으면 됩니다. Diagnostics 기록을 다른 사람과 공유하기 전에 구독 링크, 비밀번호, 서버 주소 등 민감한 정보를 제거하세요. 더 많은 문제 해결 항목은 문제 해결을 참고하세요. 옵션이나 규칙 키워드의 의미가 궁금하다면 용어 설명을 확인하세요.

Test Method, On Demand, Diagnostics, Proxy, TCP 및 UDP 옵션이 표시된 Settings 화면
Settings: 테스트 방식, 필요 시 연결 및 진단 항목을 확인합니다.