공식 매뉴얼 · 처음 사용하기

Shadowrocket 사용 가이드
구독 가져오기와 첫 연결

“가져오기 → 라우팅 → 연결 → 확인 → 문제 해결” 순서로 진행하세요. 먼저 재현 가능한 연결을 한 번 완료한 뒤 규칙과 자동 연결 설정을 조정하면, 여러 항목을 동시에 변경해 원인을 파악하기 어려워지는 상황을 피할 수 있습니다.

01 · Add Server: 기존 정보 가져오기

Shadowrocket을 열고 먼저 Home 화면에 머뭅니다. 아직 연결 스위치는 켜지 마세요. 처음 사용하는 경우 목록에 서버가 없을 수 있습니다. 가지고 있는 정보에 따라 가져오기 방법을 선택하면 됩니다. 서버 목록을 갱신할 수 있는 링크는 보통 구독으로 처리하고, 단일 서버의 주소, 포트 및 인증 항목은 수동으로 추가합니다. 구독 링크와 서버 주소는 서로 다른 항목이므로 구독 링크 전체를 서버 주소 칸에 입력하지 마세요.

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

  1. Home에서 오른쪽 위의 플러스 버튼을 눌러 Add Server로 이동합니다. Type을 누르고 유형 목록에서 Subscribe를 선택한 다음 입력 화면으로 돌아갑니다.
  2. 기존 구독 링크 전체를 URL에 붙여 넣습니다. Remarks를 입력해야 하는 경우 목록에서 알아보기 쉬운 이름을 사용하세요. 이 이름은 항목을 구분하는 용도이며 연결 매개변수를 변경하지 않습니다.
  3. 저장하고 Home으로 돌아와 구독 정보가 로드될 때까지 기다립니다. 구독 이름만 추가된 것이 아니라 해당 그룹에 서버 항목이 표시되는지 확인합니다. 서버 항목이 나타나면 첫 연결에 사용할 서버 하나를 선택합니다.

붙여 넣은 뒤 링크 앞뒤에 공백이나 줄바꿈이 없는지 확인하세요. 특히 복사할 때 설명 문구가 함께 들어오지 않았는지 살펴봅니다. 로드에 실패하면 먼저 기본 네트워크가 작동하는지 확인한 다음 링크가 완전하고 유효한지 확인합니다. 구독 정보를 가져오는 과정과 프록시 서버에 연결하는 과정은 서로 다릅니다. 목록을 갱신할 수 있다고 목록의 모든 서버에 연결할 수 있는 것은 아니며, 목록을 일시적으로 갱신할 수 없다고 저장된 정보를 모두 삭제할 필요도 없습니다.

단일 서버 매개변수가 있는 경우: 프로토콜에 맞게 입력

마찬가지로 Home의 플러스 버튼에서 Add Server로 이동한 뒤, 안내받은 프로토콜을 Type에서 선택합니다. 예를 들어 Shadowsocks, VMess, VLESS 또는 Trojan을 선택할 수 있습니다. 먼저 서버 주소와 포트를 입력하고 비밀번호, UUID 또는 기타 인증 항목을 하나씩 확인합니다. 프로토콜마다 필요한 항목이 다르므로 주소가 같다는 이유만으로 다른 프로토콜의 매개변수를 그대로 사용하면 안 됩니다. 항목의 대소문자, 하이픈 및 전송 설정은 보유한 정보와 일치해야 합니다.

안내에 TLS, SNI, Host, Path 또는 전송 방식이 포함되어 있다면 해당 설정을 펼쳐 하나씩 입력합니다. 서버 주소는 연결을 설정하는 데 사용되며, SNI와 Host는 서로 다른 단계에서 식별에 사용될 수 있습니다. 모두 도메인처럼 보인다고 서로 바꾸어 입력하면 안 됩니다. 제공되지 않은 매개변수를 기억에 의존해 추가하지 마세요. 항목의 의미를 모르면 먼저 서비스 제공업체에 확인한 뒤 저장하고 테스트합니다.

호환되는 QR 코드나 공유 링크가 있다면 Scan QR Code 또는 클립보드 가져오기 기능을 사용할 수도 있습니다. QR 코드를 스캔하려면 카메라 권한이 필요합니다. 클립보드에서 가져올 때는 시스템 안내에 따라 확인하세요. 어떤 방법을 사용하든 가져온 뒤 항목을 열어 Type, 주소 및 포트를 확인해야 합니다. 서버 링크, QR 코드 및 구독 URL에는 인증 정보가 포함될 수 있으므로 공개 게시판에 붙여 넣거나 보내지 마세요.

이 단계의 완료 기준:Home 목록에 실제 서버 항목이 있고 그중 하나가 선택되어 있어야 합니다. 가져오기만으로는 연결이 시작되지 않습니다. 여러 구독 정리, 갱신 및 백업 등은 구독 및 서버 관리 매뉴얼에서 확인할 수 있습니다. 처음 사용하는 경우 다음 단계에서 라우팅 모드를 선택하세요.

02 · Global Routing: 트래픽 처리 방식 선택

Home으로 돌아와 Global Routing을 찾아 엽니다. 이 설정은 클라이언트가 가로챈 연결을 처리하는 방식을 정합니다. 서버를 가져오거나 잘못된 인증 매개변수를 수정하는 기능은 아닙니다. 기본 모드는 Config / Proxy / Direct 세 가지입니다. 전환하기 전에 이번 목적이 서버 작동 여부 확인인지, 각 대상을 규칙에 따라 다르게 처리하는 것인지 명확히 하세요.

Config: 현재 구성의 규칙 사용

Config는 현재 활성화된 구성 파일을 기준으로 연결을 매칭하며, 규칙에 따라 트래픽을 분할할 때 적합합니다. 하단의 Config 페이지로 이동해 사용할 구성이 저장되어 있고 선택되어 있는지 확인합니다. 파일을 목록에 가져오기만 한 것은 적용된 상태와 다릅니다. 구성마다 정책과 규칙이 다를 수 있으므로 Home에서 특정 서버를 선택했다고 모든 요청이 그 서버를 통한다고 판단할 수 없습니다.

규칙은 일반적으로 위에서 아래 순서로 매칭되며, 일치하는 규칙을 찾으면 해당 정책을 사용합니다. PROXY는 프록시 정책으로 처리하고, DIRECT는 직접 연결하며, REJECT는 거부합니다. FINAL은 앞선 규칙과 일치하지 않은 연결을 처리합니다. 처음 사용할 때는 규칙을 바로 편집하지 않아도 됩니다. 먼저 활성 구성의 용도를 확인하세요. 준비된 구성이 없다면 출처를 모르는 파일을 문제 해결의 출발점으로 삼지 마세요.

Proxy: 프록시 연결 경로 확인

Proxy는 클라이언트가 가로챈 트래픽을 프록시 정책으로 전달하며, 선택한 서버의 연결 상태를 잠시 확인할 때 사용할 수 있습니다. 흔히 “전체 프록시 모드”라고 부르기도 하지만, 앱이 모든 시스템 제한을 우회하거나 기기의 모든 트래픽을 처리한다는 뜻은 아닙니다. 테스트할 때 서버 하나와 동일한 접속 대상을 유지하세요. 이 상태에서 접속할 수 있지만 Config로 돌아간 뒤 실패한다면 구독을 다시 가져오기보다 구성과 규칙을 먼저 확인해야 합니다.

Direct: 대상에 직접 접속

Direct는 클라이언트가 가로챈 요청을 프록시 서버를 거치지 않고 대상에 직접 접속하게 합니다. 기본 네트워크 상태를 비교할 때 사용할 수 있지만 프록시 서버가 정상인지 확인하는 용도는 아닙니다. 기존 서버를 테스트하려는 경우 Direct가 잘못 선택되지 않았는지 확인하세요. 잠시 비교한 뒤 Global Routing을 사용할 예정인 모드로 되돌리고 다음 단계로 진행합니다.

이 단계의 완료 기준:현재 Config, Proxy, Direct 중 어떤 모드를 선택했는지 설명할 수 있어야 합니다. Config를 사용한다면 어떤 구성이 활성화되어 있는지도 알아야 합니다. 우선 자동 연결 설정은 그대로 두고 On Demand는 서둘러 조정하지 마세요. 첫 연결 과정을 관찰하기 쉽습니다.

03 · Home: 스위치를 켜고 권한 승인

Home으로 돌아가 서버 선택과 Global Routing을 다시 확인한 뒤 상단의 연결 스위치를 켭니다. 처음 연결할 때 iPhone / iPad에 VPN 구성을 추가하라는 시스템 안내가 표시됩니다. 이 안내는 Shadowrocket이 시스템 네트워크 터널을 만들도록 허용하는 절차입니다. 구독을 가져오라는 안내가 아니며 서버 연결이 가능한지 시스템이 확인했다는 뜻도 아닙니다. 방금 실행한 Shadowrocket에서 표시된 안내인지 확인하고 요청에 따라 허용한 뒤 기기 암호 또는 생체 인증을 완료하세요.

권한 승인이 끝나면 Shadowrocket으로 돌아와 스위치와 연결 상태를 확인합니다. 이전에 권한을 취소했다면 연결 스위치를 다시 켜고 시스템 안내에 따라 진행하면 됩니다. 서버를 모두 삭제할 필요는 없습니다. 시스템 안내가 다시 표시되지 않으면 “설정 → 일반 → VPN 및 기기 관리”에서 관련 VPN 구성을 확인한 다음 앱으로 돌아와 다시 시도하세요. 기기에 관리 정책이 적용된 경우 사용자가 직접 권한을 변경하지 못할 수 있으므로 기기 관리 요구 사항에 따라 처리해야 합니다.

기기에서 다른 VPN 연결을 사용 중이라면 Shadowrocket을 테스트하기 전에 먼저 해당 연결을 종료하세요. 연결이 서로 대체되면서 상태가 바뀌는 일을 방지할 수 있습니다. 문제를 확인하는 동안 여러 네트워크 도구를 반복해서 켜고 끄지 마세요. 연결 스위치를 켜자마자 꺼짐, 시스템 구성이 제거됨, 백그라운드 자동 연결 조건이 작동함은 서로 다른 문제입니다. 실제로 발생한 현상을 기록하고 모두 “구독 만료”로 뭉뚱그리지 마세요.

VPN 표시나 시스템의 연결 상태는 네트워크 터널이 특정 단계까지 만들어졌다는 뜻일 뿐, 모든 대상에 접속할 수 있음을 증명하지 않습니다. 인증 오류, 서버에 도달할 수 없는 상태, DNS 이상은 터널이 만들어진 뒤에도 요청에 영향을 줄 수 있습니다. 따라서 스위치가 켜진 것을 확인하는 데서 멈추지 말고 다음 단계에서 실제 접속을 테스트하세요.

나중에 On Demand를 사용하려면 수동 연결과 연결 해제가 모두 정상인지 확인한 다음 설정하는 것이 좋습니다. 자동 실행 조건은 연결이 시작되거나 복구되는 시점에 영향을 줍니다. 처음 문제를 확인할 때는 수동으로 제어해야 서버 문제와 연결 조건 변경을 구분하기 쉽습니다. 시스템 안내에 대한 자세한 설명은 VPN 구성 추가 및 시스템 권한 안내에서 확인하세요.

이 단계의 완료 기준:시스템 권한 승인이 완료되고 연결 스위치가 켜진 상태이며, 즉시 오류 안내가 표시되지 않아야 합니다. 다음 단계에서는 스위치를 반복해서 바꾸지 말고 실제 요청으로 연결 경로와 규칙을 확인합니다.

04 · Connectivity Test: 적용 결과 확인

방금 선택한 서버와 라우팅 모드를 유지하고 Home에서 Connectivity Test를 사용해 먼저 서버에 도달할 수 있는지 확인합니다. 테스트 결과는 초기 진단에 활용하는 것으로 접속 속도를 보장하지 않습니다. 결과가 표시되면 테스트에 사용된 방식으로 응답을 받은 것이며, timeout은 정해진 시간 안에 이번 테스트가 완료되지 않았다는 뜻입니다. 테스트 방식과 실제 앱 요청은 서로 다른 연결 경로를 사용할 수 있으므로 한 번의 결과만으로 모든 용도의 상태를 판단할 수 없습니다.

그다음 브라우저를 열어 평소 알고 있고 접속이 허용된 페이지를 새로 불러옵니다. 이미 캐시된 페이지가 아니라 새 요청을 사용하세요. 먼저 일반 웹페이지를 테스트한 다음 로그인이나 추가 접속 조건이 필요한 기능을 확인합니다. 한 페이지만 실패하고 나머지가 정상이라면 실패 대상에서 나타난 현상을 기록하고 전체 연결이 작동하지 않는다고 바로 판단하지 마세요. 테스트 중에는 네트워크, 서버 및 구성을 동시에 바꾸지 마세요. 변경 전후 결과를 비교하기 어렵습니다.

Data에서 이번 요청 확인

Shadowrocket으로 돌아와 Data를 열고 방금 수행한 작업과 관련된 연결 기록이 있는지 확인합니다. 표시된 대상, 정책 또는 오류 정보를 함께 살펴봅니다. Config를 사용하는 경우 일부 요청이 규칙에 따라 DIRECT로 처리되는 것은 정상일 수 있습니다. 모든 요청이 PROXY를 거쳐야 성공하는 것은 아닙니다. 기록에 REJECT가 표시되면 서버를 계속 바꾸기보다 현재 구성이 요청을 의도적으로 거부했는지 먼저 확인하세요.

예상한 기록이 보이지 않으면 브라우저에서 새 요청을 보냈는지, 연결 스위치가 여전히 켜져 있는지, 현재 Global Routing이 무엇인지 확인합니다. 기록에 트래픽이 표시되어도 요청이 처리되었다는 뜻일 뿐, 접속이 완료되었는지는 페이지 결과와 함께 판단해야 합니다. 문제 해결 정보를 공유하기 전에 서버 주소, 구독 링크, 인증 항목 및 개인 계정과 연결될 수 있는 내용을 숨기고 필요한 상태와 오류 문구만 남기세요.

한 번의 비교로 서버와 규칙 구분

Config에서 실패하면 잠시 Proxy로 전환하고 서버와 대상을 그대로 둔 채 다시 시도할 수 있습니다. Proxy에서는 정상이고 Config에서 실패한다면 구성 파일 선택, 규칙 순서 및 DNS 설정을 먼저 확인합니다. 두 모드에서 모두 실패하면 기본 네트워크와 서버 매개변수를 계속 확인합니다. 비교를 마친 뒤 원래 사용할 모드로 복구하세요. 테스트를 위해 옵션을 바꾼 뒤 현재 설정을 잊지 않도록 합니다.

이 단계의 완료 기준:연결 스위치가 켜져 있는지만 보는 것이 아니라 실제 요청과 기록을 바탕으로 결과를 설명할 수 있어야 합니다. 분할 라우팅을 사용하는 기기에서는 PROXY로 처리될 것으로 예상하는 대상 하나와 DIRECT로 처리될 것으로 예상하는 대상 하나를 각각 확인하세요. 실제 매칭 결과는 현재 구성에 따라 다르며 사이트가 있는 지역만으로 추측하지 마세요.

05 · 실패 단계별 확인

문제 해결은 실패가 발생한 위치를 설명하는 것부터 시작합니다. Subscribe 정보가 로드되지 않는지, 서버에 timeout이 표시되는지, 스위치가 켜진 상태를 유지하지 못하는지, 특정 페이지만 열리지 않는지 구분하세요. 각각 다른 단계의 문제입니다. 먼저 현재 구성이나 필요한 백업을 보관하고, 한 번에 한 항목만 바꾼 뒤 같은 테스트를 반복합니다. 삭제 후 재설치를 첫 조치로 삼지 마세요. 재설치는 서버 측 매개변수를 수정할 수 없으며 유용한 진단 단서를 잃을 수도 있습니다.

기본 네트워크를 확인한 뒤 구독과 매개변수 확인

  1. 기본 네트워크:연결을 끈 상태에서 Wi-Fi 또는 셀룰러 네트워크로 일반적인 접속이 정상적으로 되는지 확인합니다. 웹 인증이 필요한 네트워크는 먼저 인증을 완료해야 합니다. 비교를 위해 네트워크를 한 번 바꿀 수 있지만 전환 전후 결과를 기록하세요.
  2. 가져오기 결과:Home에 실제 서버 항목이 있고 그중 하나가 선택되어 있는지 확인합니다. Subscribe 갱신에 실패하면 URL이 완전하고 유효한지 확인합니다. 구독 이름만으로 가져오기가 완료되었다고 판단하지 말고, 갱신 중 같은 요청을 연속으로 반복 제출하지 마세요.
  3. 주소 및 인증:서버 편집 화면에서 보유한 정보와 Type, 주소, 포트, 비밀번호 또는 UUID가 일치하는지 확인합니다. 복사 중에 추가된 공백, 누락된 문자 및 잘못 선택한 프로토콜은 연결 실패의 원인이 될 수 있습니다.
  4. 전송 매개변수:TLS, SNI, Host, Path 및 전송 방식도 확인합니다. 오류를 없애려고 인증서 검증을 임의로 끄지 마세요. 먼저 도메인, 인증서 요구 사항 및 서버 정보를 확인합니다.

Connectivity Test에서 계속 timeout이 표시되면 같은 네트워크에서 이미 보유한 다른 서버를 선택해 비교합니다. 한 서버만 실패하면 해당 서버의 매개변수와 상태를 먼저 확인하고, 여러 서버가 동시에 실패하면 현재 네트워크와 공통 설정을 살펴봅니다. 항목별 확인 절차는 서버 연결 시간 초과 확인 순서에서 자세히 안내합니다.

라우팅, 시간 및 시스템 권한 확인

일부 대상만 실패하면 Global Routing이 예상한 모드인지 확인하고 Config에서 활성 파일을 확인합니다. 범위가 넓은 규칙이 앞에 있으면 뒤에 있는 구체적인 규칙보다 먼저 매칭될 수 있습니다. FINAL은 마지막 처리 규칙으로 사용해야 합니다. 처음 사용할 때는 테스트와 동시에 규칙을 대량으로 추가하지 않는 것이 좋습니다. 먼저 Proxy와 Config를 비교해 분할 라우팅 문제인지 확인한 다음 사용자 지정 규칙 및 매칭 순서를 참고하세요.

TLS 또는 인증서 관련 오류가 발생하면 기기의 날짜, 시간 및 시간대가 올바른지도 확인합니다. 시간 오차는 인증서 유효 기간 판단에 영향을 줄 수 있으므로 비밀번호만 확인해서는 안 됩니다. DNS 관련 증상은 실패한 대상 및 Data 기록과 함께 판단하고 모든 설정을 한꺼번에 바꾸지 마세요. 앱은 연결되지만 특정 서비스가 계속 실패한다면 해당 서비스의 계정 상태, 접속 조건 또는 서버 장애가 원인일 수도 있습니다.

스위치가 즉시 꺼지거나 시스템에서 VPN이 반복적으로 전환되면 VPN 구성이 남아 있는지, 다른 연결이 실행 중인지, On Demand에 자동 실행 조건이 설정되어 있는지 확인합니다. 기기에 조직 관리가 적용되어 있다면 관리 정책에서 해당 연결을 허용하는지도 확인하세요. 권한 문제는 시스템 설정에서 먼저 처리해야 하며 구독을 다시 만들거나 서버 비밀번호를 변경할 필요는 없습니다.

위 사항을 확인해도 원인을 찾지 못하면 최소한의 기록을 정리합니다. 현재 네트워크 유형, 선택한 프로토콜, Global Routing 모드, Connectivity Test 결과, 실패가 발생한 단계 및 정확한 오류 문구를 포함하세요. 전체 구독 링크나 인증 정보를 첨부하지 마세요. 매개변수와 서버 상태는 서비스 제공업체에 확인하고, 클라이언트 설정과 일반적인 시스템 문제는 자주 묻는 질문에서 추가로 확인할 수 있습니다.

문제 해결 후 유지할 항목:사용 가능한 서버, 현재 라우팅 모드 및 활성 구성을 기록합니다. 필요한 정보를 백업한 뒤 구독 갱신이나 On Demand를 조정하세요. QR 코드 및 클립보드 가져오기, 여러 구독 정리, 삭제 및 백업 절차는 서버 관리 매뉴얼에 모아 두었습니다. 첫 연결 시 모든 설정을 한 번에 완료할 필요는 없습니다.