공식 설명서 / 첫 연결

Shadowrocket 사용법

기존 구독 가져오기 → Global Routing 선택 → 연결 승인 → 결과 확인 → 문제 점검. 먼저 재현 가능한 연결을 한 번 완료한 후 규칙과 자동 연결 설정을 조정합니다.

  • 작업 범위 Home / Config / Data
  • 먼저 수동 연결 확인
  • 한 번에 설정 하나만 변경

STEP 01 / 기존 정보 가져오기

Add Server: 서버 추가 또는 Subscribe

먼저 보유한 정보의 종류를 확인한 뒤 알맞은 메뉴를 선택하세요. 구독 링크는 여러 서버 정보를 가져오는 주소이지, 개별 서버 주소가 아닙니다. 단일 서버 정보에는 보통 프로토콜, 주소, 포트 및 인증 정보가 포함됩니다. 두 종류의 정보를 한 입력란에 섞어 넣지 마세요. Shadowrocket을 열고 Home으로 이동한 다음 오른쪽 위의 추가 메뉴를 눌러 Add Server로 들어갑니다. 아래 두 방법 중 보유한 정보에 맞는 하나만 선택하면 됩니다. 중복해서 추가할 필요는 없습니다.

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

Add Server의 Type에서 Subscribe를 선택하고, 본인의 전체 구독 링크를 URL에 입력한 뒤 알아보기 쉬운 메모를 추가합니다. 붙여넣은 후 링크의 앞뒤가 온전한지, 줄바꿈이나 공백 또는 채팅 문구가 섞이지 않았는지 확인하고 저장하세요. 링크의 쿼리 매개변수는 인증에 사용될 수 있으므로 주소를 짧게 만들려고 임의로 삭제하지 마세요. 여기에 입력하는 것은 기존 구독을 가져오는 주소입니다. 서비스 소개 페이지나 계정 로그인 페이지 주소를 입력하지 마세요.

저장한 뒤 Home으로 돌아가 정보 가져오기가 완료될 때까지 기다린 다음, 해당 그룹에 서버 항목이 표시되는지 확인합니다. 구독 이름이 보인다고 해서 내용까지 가져온 것은 아닙니다. 그룹을 열 수 있는지, 안에 선택 가능한 서버가 있는지 확인하세요. 가져온 뒤 목록이 비어 있으면 안내 문구를 남겨 두고 링크 유효성과 현재 네트워크를 확인합니다. 같은 구독을 바로 반복해서 추가하지 마세요. 이후에는 기존 구독을 새로 고쳐 내용을 업데이트할 수 있으며, 보통 업데이트할 때마다 다시 추가할 필요는 없습니다.

기존 단일 서버 정보가 있는 경우: 프로토콜에 맞게 입력

Add Server로 이동해 Type에서 자료에 지정된 프로토콜을 선택한 다음 서버 주소, 포트 및 해당 인증 정보를 각각 입력합니다. 예를 들어 Shadowsocks, VMess, VLESS, Trojan은 입력 항목이 서로 다를 수 있으므로 본인의 서버 정보를 기준으로 작성하세요. 주소란에는 안내된 호스트 이름이나 주소만 입력하고 전체 구독 링크를 넣지 마세요. 이름만 보고 프로토콜을 추측하거나 다른 항목의 설정값을 합쳐 새 기록을 만들지 마세요.

자료에 TLS, 서버 이름 또는 전송 관련 옵션이 포함되어 있다면 해당 항목도 확인하세요. 주소와 포트만으로는 충분하지 않을 수 있습니다. Scan QR Code로 기존 연결 정보를 가져온 경우에도 저장 후 인식된 유형과 주소를 확인하세요. QR 코드 스캔 성공 여부만 확인해서는 안 됩니다. QR 코드는 입력 방법일 뿐 설정값 확인을 대신하지 않습니다. 해당 항목의 설정 정보가 명확하지 않다면 원본 안내를 확인하고 암호화나 인증 옵션을 임의로 바꾸지 마세요.

이 단계의 완료 기준은 Home에 출처를 확인할 수 있고 입력값이 완전하며 선택 가능한 서버 기록이 있는 것입니다. 메모와 소속 그룹을 기억해 두세요. 다음 단계에서는 Global Routing을 선택해 연결 후 트래픽을 처리하는 방식을 정합니다. 첫 수동 테스트에 자동 동작이 개입하지 않도록 우선 On Demand는 켜지 마세요.

STEP 02 / 트래픽 경로 확인

Global Routing: Config, Proxy, Direct

서버를 추가했다고 해서 모든 접속이 해당 서버를 통과하는 것은 아닙니다. Home으로 돌아가 Global Routing을 눌러 현재 방식을 확인하세요. 선택지는 Config, Proxy, Direct입니다. 무엇을 확인하려는지 먼저 정한 뒤 알맞은 항목을 선택하세요. 연결 스위치가 켜진 상태와 모든 트래픽이 선택한 서버를 사용하는 상태는 서로 다릅니다.

방식설명첫 확인 항목
Config현재 활성화된 설정의 규칙과 정책에 따라 요청을 처리합니다.Config에서 활성화된 파일과 규칙이 지정하는 경로를 확인합니다.
Proxy트래픽을 프록시 경로로 보내 서버 연결 상태를 비교하는 데 사용합니다.현재 선택된 서버 또는 관련 정책을 확인합니다.
Direct트래픽을 직접 연결 경로로 처리합니다.기본 네트워크 확인에 적합하지만 서버가 사용 가능하다는 증거는 되지 않습니다.

평소 규칙을 사용할 때: 먼저 Config 확인

Config를 사용하려면 Config 페이지로 이동해 현재 활성화된 설정이 무엇인지 확인하고, 설정에 포함된 규칙과 정책을 살펴보세요. Subscribe를 가져오는 것과 Config를 활성화하는 것은 별개의 작업입니다. 구독은 주로 서버 목록을 업데이트하고, 설정은 매칭 조건과 처리 경로를 결정합니다. Home에 서버가 표시되어도 설정에 지정된 모든 정책이 자동으로 해당 서버를 사용하게 되는 것은 아닙니다. 내용을 이해하지 못하는 설정은 출처와 내용을 확인한 뒤 적용하세요.

예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 도메인 접미사가 example.com과 일치할 때 PROXY가 지정하는 프록시 방식으로 처리한다는 뜻입니다. IP-CIDR,192.168.0.0/16,DIRECT는 해당 주소 대역을 DIRECT로 보냅니다. 이는 규칙 문법의 예시일 뿐이며 입문 안내를 따라 하기 위해 현재 설정에 그대로 복사할 필요는 없습니다. 규칙은 매칭 순서대로 적용되므로 요청이 앞선 규칙과 일치하면 뒤의 규칙은 적용되지 않을 수 있습니다.

비교를 위해 Proxy를 임시 사용한 뒤 원래 설정으로 복원

기존 서버에 연결할 수 있는지 먼저 확인하려면 Proxy를 임시로 사용해 규칙 선택이 테스트 결과에 미치는 영향을 줄일 수 있습니다. 테스트 전에 원래 방식을 기록하고 Home에서 테스트할 서버가 선택됐는지 확인하세요. 테스트 후에는 Config로 되돌립니다. Direct는 기기에서 원래 접속 가능한 대상에 연결되는지 비교하는 데 적합하며, 원격 서버 상태를 확인하는 방법을 대신하지 않습니다.

이 단계가 끝나면 “현재 어떤 방식과 설정 또는 서버를 사용 중인지” 설명할 수 있어야 합니다. 확실하지 않다면 DNS와 On Demand를 동시에 변경하지 마세요. 규칙 우선순위와 정책 참조에 대한 자세한 내용은 규칙 라우팅 설정 안내에서 확인할 수 있습니다. 여기서는 경로를 명확히 유지한 채 연결 단계로 넘어갑니다.

STEP 03 / 수동 연결하기

Home: 스위치를 켜고 VPN 구성 승인

Home으로 돌아가 서버 선택 상태와 Global Routing을 다시 확인합니다. 서버 이름이 비슷하다면 그룹과 프로토콜까지 함께 확인해 다른 항목을 선택하지 않도록 주의하세요. 준비가 되면 상단의 연결 스위치를 켜고 앱에 표시되는 연결 상태를 확인합니다. 처음 연결할 때 시스템 승인 메시지가 먼저 나타날 수 있습니다. 승인이 완료되기 전에 스위치 상태가 잠시 바뀌는 것을 서버 오류로 판단하지 마세요.

처음 VPN 구성 추가 요청이 표시될 때

시스템에서 VPN 구성 추가를 요청하는 것은 Shadowrocket이 기기의 네트워크 트래픽을 처리하는 시스템 연결을 만들도록 허용하기 위해서입니다. 방금 Shadowrocket에서 직접 연결을 시작한 것이 맞는지 확인한 뒤 시스템 안내에 따라 승인하고 기기 인증을 완료하세요. 이는 서버 추가와는 다른 단계입니다. 시스템 승인은 앱이 연결을 만들 수 있는지를 결정하고, 서버 설정값은 이후 통신이 성공할지를 좌우합니다.

승인한 뒤 Shadowrocket으로 돌아가 연결이 계속 진행되는지 확인합니다. 앞서 취소했다면 앱에 필요한 권한이 부여되지 않은 상태이므로 다시 연결을 시작하고 안내에 따라 처리하세요. 서버 비밀번호를 반복해서 바꾸지 마세요. 시스템 설정의 VPN 항목에서 관련 구성 상태를 확인할 수 있습니다. 시스템 버전에 따라 설정 경로가 다를 수 있으므로 설정 검색으로 VPN을 찾으세요. 복구 절차가 늘어날 수 있으니 시스템 구성을 바로 삭제하는 것부터 문제를 점검하지 마세요.

연결 상태와 실제 접속 결과 구분

스위치가 켜져 있거나 시스템에 VPN 상태가 표시되면 시스템 연결이 설정된 것입니다. 하지만 이것만으로 확인이 끝난 것은 아닙니다. 선택한 서버에 연결할 수 없거나 특정 대상의 이름 확인에 실패할 수 있고, 현재 규칙이 대상을 Direct로 보낼 수도 있습니다. 연결 후에도 현재 설정을 유지하며 결과를 확인하세요. 상태 표시만 보고 작업을 끝내거나 결과가 분명해지기 전에 여러 모드를 연달아 전환하지 마세요.

첫 수동 테스트 중에는 VPN 연결을 관리하는 다른 설정을 잠시 중지하고 같은 네트워크 환경을 유지하세요. 기기에 On Demand 자동 실행 조건이 설정되어 있다면 먼저 해당 조건을 기록한 뒤 자동 연결을 잠시 중지합니다. 그렇지 않으면 수동으로 끈 뒤 자동으로 다시 켜져 스위치가 작동하지 않는 것으로 오해할 수 있습니다. 테스트가 ‘성공한 것처럼 보이게’ 하려고 용도를 모르는 시스템 설정을 삭제하지 마세요.

이 시점에는 Wi-Fi와 셀룰러 중 어떤 네트워크인지, Home에서 어떤 서버를 선택했는지, Global Routing이 어떤 방식인지 세 가지 기본 상태를 기록하는 것이 좋습니다. 다음 단계에서 접속에 실패하더라도 명확한 테스트 조건을 바탕으로 문제 범위를 좁힐 수 있습니다. 연결이 안정된 다음 자동화 설정을 하나씩 추가하는 편이 여러 옵션을 동시에 조정하는 것보다 원인을 파악하기 쉽습니다.

STEP 04 / 단계별 확인

Connectivity Test 및 실제 접속 확인

확인할 때는 시스템 연결이 설정됐는지, 선택한 서버에 현재 테스트 방식으로 연결할 수 있는지, 실제 대상에 예상대로 접속되는지 세 가지를 따로 살펴보세요. 어느 하나도 다른 결과를 대신할 수 없습니다. 먼저 Home에서 Connectivity Test를 실행하고 사용한 테스트 방식과 각 항목의 결과를 확인한 다음, 평소 사용하는 앱이나 브라우저로 접속하려는 대상을 엽니다.

테스트 결과 확인 후 실제 요청 테스트

Connectivity Test 결과는 테스트 방식, 대상, 현재 네트워크 및 서버 처리 방식에 따라 달라집니다. 숫자가 표시되더라도 해당 테스트에서 결과를 얻었다는 뜻일 뿐, 모든 웹페이지나 앱이 정상 작동한다는 보장은 아닙니다. 시간 초과도 테스트 대상을 고려해 판단하고 모든 통신이 실패했다고 단정하지 마세요. 기존 서버 두 개를 비교할 때는 같은 테스트 방식과 네트워크를 사용해야 결과를 비교할 수 있습니다.

실제 접속은 평소 정상적으로 열리는 익숙한 페이지를 기본 비교 대상으로 먼저 선택한 다음, 실제로 사용하려는 대상을 테스트하세요. 특정 앱만 실패한다면 같은 서비스의 페이지를 브라우저에서 열어 앱 자체 문제인지 연결 문제인지 구분해 볼 수 있습니다. 매번 대상을 바꾸지 말고 동일한 대상을 유지하세요. 이미 열려 있던 페이지가 표시된다는 이유만으로 새 연결이 성공했다고 판단하지 마세요. 캐시된 내용은 새 네트워크 요청을 발생시키지 않았을 수 있습니다.

Data에서 연결 기록 확인

Data로 이동해 현재 표시되는 요청 또는 연결 정보를 확인하고 방금 테스트한 대상과 관련된 기록을 찾습니다. 요청이 나타났는지, 대상 도메인이나 주소가 예상과 일치하는지, 기록에 표시된 정책 또는 처리 경로가 무엇인지 확인하세요. 표시되는 항목은 앱 내 정보를 기준으로 합니다. 충분한 정보가 기록되지 않았다면 과거 기록에서 임의로 결론을 내리지 말고 명확한 새 요청을 다시 발생시키세요.

Config를 사용하는 경우 매칭 결과가 예상한 규칙과 일치하는지 확인하세요. 대상이 Direct로 연결되어야 하는데 프록시 정책이 적용됐다면 활성화된 설정과 규칙 순서를 점검합니다. Proxy를 사용해야 하는데 DIRECT가 적용됐다면 먼저 일치한 규칙을 찾으세요. FINAL을 다른 경로로 바꾸는 것만으로 해결하려 하지 마세요. 요청이 앞선 규칙에서 이미 처리되었을 수 있어 기본 규칙을 바꿔도 영향을 받지 않을 수 있습니다.

확인 완료 기준은 연결 상태가 정상이고, 실제 대상에서 새 요청이 발생해 예상한 결과를 얻으며, 표시된 처리 경로가 현재 라우팅 선택과 일치하는 것입니다. 테스트 중 Proxy를 임시로 사용했다면 Config로 되돌린 뒤 같은 대상을 다시 테스트하세요. 그다음 사용 방식에 맞게 On Demand를 설정할 수 있습니다. 조건과 우선순위는 On Demand 설정 안내를 확인하세요.

STEP 05 / 한 번에 하나씩 점검

연결 실패: 기본 네트워크부터 규칙까지 확인

문제가 생기면 먼저 증상을 기록한 뒤 어느 단계를 확인할지 정하세요. “구독을 가져오지 못함”, “스위치가 켜진 상태로 유지되지 않음”, “테스트 시간 초과”, “특정 대상만 열리지 않음”은 서로 다른 문제이므로 같은 방법으로 해결할 수 없습니다. 현재 설정과 오류 메시지를 보존하고 조건을 한 번에 하나씩만 바꾼 뒤 같은 대상으로 다시 테스트하세요. 아래 순서대로 바깥 단계부터 확인하면 반복 작업을 줄일 수 있습니다.

첫 번째 단계: 기본 네트워크와 구독 내용

먼저 현재 연결을 끄고 기기에서 평소 접속할 수 있는 페이지가 열리는지 확인합니다. Wi-Fi에서 네트워크 로그인이 필요하다면 먼저 로그인을 완료하세요. 셀룰러 네트워크는 통신 서비스와 앱 사용 권한을 확인합니다. 기본 네트워크 자체를 사용할 수 없다면 먼저 해당 문제를 해결하세요. Wi-Fi와 셀룰러 전환은 비교 테스트에 활용할 수 있지만 결과를 각각 기록하고 전환 전후의 테스트를 섞어 비교하지 마세요.

Subscribe 업데이트에 문제가 있다면 주소가 온전한지, 기존 구독이 유효한지, 현재 네트워크에서 해당 주소를 가져올 수 있는지 확인하세요. 구독 업데이트에 성공했다는 것은 목록을 가져왔다는 뜻일 뿐, 목록의 모든 서버가 정상이라는 보장은 아닙니다. 업데이트에 실패해도 이미 저장된 항목이 곧바로 무효가 되는 것은 아닙니다. 먼저 구체적인 안내 메시지를 확인한 뒤 본인의 구독 정보를 점검하세요. 공개된 도움 요청에 인증 정보가 포함된 전체 링크를 올리지 마세요.

두 번째 단계: 서버 설정값과 시스템 승인

목록에 항목이 있는데 테스트에 실패한다면 프로토콜, 서버 주소, 포트 및 인증 정보를 하나씩 확인하세요. TLS나 전송 옵션이 있는 항목은 관련 설정이 원본 정보와 일치하는지도 점검합니다. 기기의 날짜와 시간이 잘못되면 보안 연결에 영향을 줄 수 있으므로 시스템 시간도 확인하세요. 같은 구독에 본인이 보유한 다른 서버가 있다면 동일한 조건으로 비교할 수 있지만, 알 수 없는 설정값을 근거 없이 원래 기록에 반영하지 마세요.

스위치를 켜자마자 꺼지거나 승인 단계에 계속 머무르면 시스템에서 VPN 구성 추가를 허용했는지, 다른 연결 관리 설정이 영향을 주는지 먼저 확인하세요. 시스템 구성이 삭제되었거나 다시 만들어야 한다는 점이 확인된 경우에만 앱 안내에 따라 재설정합니다. 시스템 승인 실패와 원격 인증 실패를 혼동하지 마세요. 전자는 보통 연결이 설정되기 전에 발생하고, 후자는 실제 연결 정보와 오류 기록을 추가로 확인해야 합니다.

세 번째 단계: 라우팅, 규칙 및 DNS

Proxy에서는 대상이 정상적으로 열리지만 Config에서 실패한다면 현재 설정, 규칙 매칭 및 정책 참조를 우선 확인하세요. Direct에서는 정상이고 Proxy 경로에서 실패한다면 선택한 서버와 원격 통신을 계속 점검합니다. 이러한 비교는 점검 범위를 좁히는 데 도움이 되지만 문제 원인을 최종적으로 확정하지는 않습니다. 방식을 전환할 때마다 새 요청을 보내 이전 연결이 재사용되어 결과에 영향을 주지 않도록 하세요.

일부 도메인에만 접속할 수 없다면 Data에 표시된 정보와 함께 DNS 및 대상 관련 기록을 확인하세요. DNS 교체, 인증 확인 비활성화, 규칙 수정, 서버 전환을 동시에 하지 마세요. 일시적으로 복구되더라도 무엇이 원인이었는지 알 수 없습니다. DNS 작동 방식과 자세한 오류 안내는 자주 묻는 질문에서 확인할 수 있습니다. App Store 계정, 구매 복원 및 구매 확인은 App Store 구매 안내를 참고하세요. 연결 문제를 점검하면서 구매 절차를 다시 진행할 필요는 없습니다.

이제 첫 사용 과정이 완료됐습니다. 기존 정보를 가져오고 라우팅을 명확히 선택한 뒤 시스템 승인을 마치고 실제 요청을 확인했습니다. 이후에도 같은 방법을 따르세요. 먼저 기존 상태를 기록하고, 한 번에 하나씩 변경한 다음 같은 대상을 확인합니다. 계속 설정하려면 설정 안내에서 해당 항목을 확인하세요. 입문 단계를 처음부터 다시 진행할 필요는 없습니다.