QUICKSTART / iPhone · iPad
Shadowrocket 사용 가이드
기존 구성을 가져온 다음 트래픽 처리 방식을 선택하세요. 연결한 뒤 테스트와 실제 접속으로 결과를 확인합니다.
01 / IMPORT
서버 추가 또는 기존 구독 가져오기
Shadowrocket을 열고 Home에서 SERVER 그룹을 찾아 Add Server를 누릅니다. 보유한 정보에 따라 다음 단계를 선택하세요. 프로토콜, 호스트, 포트 등의 정보가 있다면 서버를 하나씩 추가하고, 항목을 묶어 업데이트할 수 있는 전체 구독 주소가 있다면 Subscribe를 사용합니다. 두 방법 중 하나만 완료하면 됩니다.
직접 추가: Type을 선택한 뒤 필드 입력
Add Server에서 먼저 Type을 누르고 보유한 정보와 일치하는 프로토콜을 선택합니다. 그런 다음 Host와 Port를 입력합니다. 화면에 Password, Method 등의 필드가 표시되면 원래 제공된 정보에 맞춰 각각 입력합니다. Host와 Port는 별도의 필드입니다. 경로가 포함된 전체 링크를 Host에 입력하지 마세요. 프로토콜에 따라 표시되는 필드가 다르므로 스크린샷의 필드가 모든 프로토콜의 필수 항목은 아닙니다. 필수 정보를 받지 못했다면 추측해서 채우지 말고 구성 제공자에게 확인하세요.
구독 가져오기: 전체 링크 유지
구독 링크가 있다면 Add Server의 Type에서 Subscribe를 선택하고 표시되는 링크 필드에 전체 주소를 붙여 넣은 뒤 저장합니다. 주소 끝의 쿼리 매개변수는 접근 권한 확인에 필요할 수 있으므로 삭제하지 마세요. 붙여넣은 뒤 앞뒤에 줄바꿈이나 공백이 포함되지 않았는지 확인합니다. Home으로 돌아와 구독 그룹에 서버 항목이 표시되는지 확인하세요. 그룹 이름만 있고 선택할 항목이 없다면 연결 스위치를 켜서 시험하기 전에 구독 업데이트 결과를 확인합니다.
가져오기가 끝나면 Home에서 알고 있는 서버 항목을 선택하고 선택 표시를 확인합니다. 이름이 비슷한 항목이 여러 개라면 메모로 구분해 새로 가져온 항목과 기존 항목을 혼동하지 않도록 합니다. 이 단계에서는 정보가 저장되고 서버가 선택된 것만 확인할 수 있으며, 연결이 작동하는지는 아직 알 수 없습니다. 다음으로 Global Routing을 설정해 어떤 접속에 이 서버를 사용할지 정합니다.
02 / ROUTING
Global Routing 모드 선택
Home으로 돌아와 Global Routing을 누릅니다. 선택한 서버는 프록시가 필요한 경우 사용할 연결을 결정하고, Global Routing은 트래픽이 해당 연결을 사용할지 결정합니다. 처음 설정할 때는 테스트 목적에 맞는 모드를 선택하고 다른 조건은 그대로 둡니다.
- 구성(Config)
- 현재 활성화된 구성 파일의 규칙에 따라 트래픽을 처리합니다.
DIRECT에 일치하는 대상은 직접 연결하고, 프록시 정책에 일치하는 대상은 해당 프록시를 사용합니다. 앞선 규칙에 일치하지 않는 경우 구성의FINAL을 확인합니다. 분기 구성이 있고 여러 대상의 동작을 각각 확인해야 할 때 적합합니다. - 프록시(Proxy)
- 클라이언트가 처리하는 트래픽을 프록시 방식으로 전달합니다. 처음 문제를 진단할 때 잠시 사용하면 규칙을 동시에 변경하지 않고 선택한 서버가 테스트 접속을 처리할 수 있는지 확인할 수 있습니다. 테스트가 끝나면 필요한 모드로 되돌립니다.
- 직접 연결(Direct)
- 클라이언트가 처리하는 트래픽을 선택한 프록시 서버를 거치지 않고 직접 연결합니다. 같은 대상의 직접 연결 결과를 비교할 때 사용할 수 있습니다. 이 모드는 연결 스위치를 끄는 것이 아닙니다. 기기가 현재 연결을 완전히 사용하지 않도록 하려면 Home으로 돌아와 상단 스위치를 끕니다.
Config를 선택했다면 하단의 Config로 이동해 현재 활성화된 구성 파일을 확인합니다. 여기서 Config는 구성 관리 화면이며, Global Routing의 같은 이름 모드와는 다른 컨트롤입니다. 구성 편집 화면에서 Rule을 열어 대상과 일치할 수 있는 규칙을 살펴봅니다. 규칙 순서는 결과에 영향을 줍니다. 앞선 규칙에 이미 일치하면 뒤에 더 구체적으로 보이는 규칙이 있어도 해당 규칙으로 바뀌지 않습니다.
처음 확인할 때는 Add Rule을 누르거나 다른 분기 설정을 변경할 필요가 없습니다. 구성 이름과 테스트 대상에 예상되는 정책을 기록한 다음 Home으로 돌아와 Global Routing의 선택값을 확인합니다. 규칙 유형, 일치 범위 및 정책 용어는 용어집에서 자세히 확인할 수 있습니다.
03 / CONNECT
Home에서 연결 스위치 켜기
Home에서 두 항목을 먼저 확인합니다. SERVER에서 앞서 확인한 서버가 선택되어 있는지, Global Routing에 이번에 사용할 모드가 표시되는지 확인합니다. 그런 다음 상단의 Not Connected 옆 스위치를 누릅니다. 아래의 Connectivity Test는 연결 버튼이 아닙니다.
처음 연결할 때 시스템에서 VPN 구성 추가를 허용하라는 메시지가 표시될 수 있습니다. 메시지가 Shadowrocket에서 방금 스위치를 켠 동작으로 나타났는지 확인한 뒤 시스템 안내에 따라 허용합니다. 기기 인증을 요구할 수도 있습니다. 허용한 뒤 Home으로 돌아와 스위치가 켜져 있는지, 상단 연결 상태가 Not Connected에서 바뀌었는지 확인합니다. 스위치를 켜자마자 다시 꺼지면 메시지를 기록하고 연속해서 누르지 마세요. 조직에서 관리하는 기기에서 VPN 구성이 제한된 경우 기기 관리자에게 허용된 사용 방법을 확인하세요.
상단 상태가 바뀌면 연결이 시작되었다는 뜻이지만 원격 서버에 도달할 수 있다는 의미는 아니며, 특정 앱의 접속이 반드시 프록시를 사용한다는 뜻도 아닙니다. 예를 들어 Config에서는 테스트 대상이 DIRECT에 일치할 수 있습니다. 첫 테스트에서는 현재 네트워크, 서버 및 모드를 그대로 유지하는 것이 결과를 이해하기 쉽습니다.
04 / VERIFY
테스트 결과와 실제 접속 확인
Home에서 Connectivity Test를 누르고 결과가 표시될 때까지 기다린 다음 다른 앱으로 전환합니다. 테스트에 사용한 네트워크, 선택한 서버 및 표시된 결과를 기록합니다. 테스트 결과는 당시의 네트워크 상태와 테스트 방식만 반영합니다. 테스트 성공이 모든 대상에 접속할 수 있다는 뜻은 아니며, 시간 초과만으로 구독이 만료되었다고 판단해서는 안 됩니다. 두 번의 테스트 방식이 다르면 표시된 소요 시간을 직접 비교하지 마세요.
그다음 브라우저나 자주 사용하는 앱에서 현재 모드에 적합하고 접속 가능하다고 알고 있는 대상을 엽니다. 페이지가 새로 로드되거나 앱의 요청이 실제로 완료되는지 확인하세요. 이미 열려 있던 탭만 확인하지 마세요. 페이지가 캐시에서 표시될 수 있습니다. Config에서는 DIRECT에 일치할 것으로 예상되는 대상과 프록시를 사용할 것으로 예상되는 대상을 하나씩 확인합니다. 직접 연결 대상이 열린다는 사실만으로 프록시가 작동한다고 판단할 수는 없습니다. Proxy에서는 먼저 대상 하나만 확인해 여러 앱을 동시에 테스트하면서 실패 원인을 구분하기 어려워지는 상황을 피합니다.
비교가 필요하면 연결을 켰을 때의 결과를 먼저 기록한 다음 Home 상단 스위치를 끄고 같은 네트워크에서 같은 대상을 다시 요청한 뒤 원래 설정으로 되돌립니다. 특정 페이지가 열리는지만으로 어떤 규칙이 적용되었는지는 알 수 없습니다. 실제 접속 결과가 예상과 다르면 Config로 돌아가 규칙 순서와 기본 정책을 확인합니다. 테스트와 일상적인 접속이 모두 예상대로라면 현재 설정을 유지해도 됩니다. 테스트 시간을 줄이려고 구성을 반복해서 바꿀 필요는 없습니다.
05 / TROUBLESHOOT
실패 단계에 따라 문제 해결
먼저 문제를 가져오기, 연결 시작, 테스트 또는 실제 접속 중 어느 단계에서 발생했는지 구분합니다. 한 번에 조건 하나만 변경한 뒤 같은 동작을 반복합니다. Wi‑Fi와 모바일 네트워크를 모두 사용할 수 있다면 기존 설정을 유지한 채 네트워크만 바꿔 비교해 보세요. 서버도 동시에 바꾸면 어떤 변경이 영향을 주었는지 판단할 수 없습니다.
가져온 뒤 항목이 없거나 구독 업데이트 실패
Add Server로 돌아가 Subscribe를 선택했는지, 주소가 완전한지, 기기의 현재 네트워크에서 일반 웹사이트에 접속할 수 있는지 확인합니다. 인증 메시지가 표시되거나 링크가 만료되었거나 업데이트 후 빈 그룹만 남았다면 링크 제공자에게 주소가 여전히 유효한지, 반환된 내용이 Shadowrocket에서 사용할 수 있는지 확인합니다. 기존 항목이 작동한다면 먼저 기존 구성을 유지하고 삭제 후 재추가를 첫 해결 방법으로 삼지 마세요.
스위치가 켜진 상태로 유지되지 않거나 자동 재연결
스위치가 즉시 꺼지면 시스템 VPN 구성 확인이 완료되지 않았는지 먼저 살펴봅니다. 기기에서 다른 VPN이 실행 중인지, 관리 정책의 제한을 받는지도 확인합니다. 직접 끈 뒤 자동으로 다시 연결된다면 Settings를 열고 On Demand에 현재 네트워크와 일치하는 조건이 설정되어 있는지 확인합니다. 직접 설정한 조건이라면 원래 값을 기록한 뒤 잠시 비활성화해 수동 연결을 테스트할 수 있습니다. 테스트가 끝나면 필요한 경우 원래 설정으로 되돌립니다.
연결되었지만 Connectivity Test 시간 초과
먼저 연결을 끄고 일반적인 접속으로 기기의 네트워크가 작동하는지 확인한 뒤 Home으로 돌아와 예상한 항목이 선택되어 있는지 확인합니다. 서버를 직접 추가했다면 Type, Host, Port 및 인증 필드를 다시 확인합니다. 구독에서 가져온 항목이라면 업데이트가 필요한지 확인합니다. 그런 다음 Settings에서 Test Method를 확인하고 현재 방식을 기록한 뒤 기존 네트워크로 돌아와 다시 테스트합니다. 실제 접속은 정상이고 테스트만 실패한다면 한 번의 시간 초과만으로 모든 구성을 다시 만들지 마세요.
일부 대상이나 앱에서만 문제 발생
Proxy에서는 대상에 접속되지만 Config에서 예상대로 작동하지 않는다면 서버를 먼저 바꾸지 말고 현재 구성, 앞선 규칙 및 FINAL을 확인합니다. 두 모드에서 모두 실패하고 연결을 끈 뒤에는 다른 대상에 접속할 수 있다면 Settings의 Diagnostics에서 확인 가능한 정보를 살펴보고 실패 시간과 메시지를 기록한 다음 구성 제공자에게 문의합니다. 문제와 관련된 정보만 전달하고 공개하기 전에 구독 주소와 인증 필드를 가립니다.