공식 설명서 · 첫 연결
Shadowrocket 사용법
구독 가져오기 → Global Routing → 연결 권한 승인 → 테스트 → 문제 해결. 반복 가능한 연결 테스트를 먼저 완료한 뒤 규칙과 자동 연결 설정을 조정하세요.
- iPhone / iPad
- 기존 구독 또는 서버 정보 사용
- 단계별 확인
이 페이지에서는 첫 연결에 필요한 순서만 안내합니다. 구독 관리, 업데이트, 백업 등 전체 과정은 서버 관리 설명서를 참고하세요. 익숙하지 않은 프로토콜 이름이나 규칙 키워드는 용어 빠른 안내에서 확인할 수 있습니다. 첫 연결 전에 모든 설정을 바꿀 필요는 없습니다.
단계 01 · 서버 항목 만들기
Add Server / Subscribe: 기존 정보 가져오기
Shadowrocket를 열고 Home으로 이동합니다. 먼저 서버 목록에 항목이 있는지 확인한 뒤 추가 방법을 선택하세요. 구독 링크는 여러 서버 정보를 가져오고 이후 업데이트하는 데 사용합니다. 단일 서버 링크나 직접 입력하는 매개변수는 특정 연결 정보를 나타냅니다. 용도가 다르므로 URL처럼 보인다는 이유만으로 구독 항목에 입력하지 마세요.
구독 링크가 있다면 Subscribe 사용
Home 오른쪽 위의 추가 버튼을 눌러 Add Server를 엽니다. 유형 목록에서 Subscribe를 선택하고 개인 구독 링크 전체를 URL에 입력하세요. 이름을 입력해야 한다면 알아보기 쉬운 메모를 사용하면 됩니다. 붙여넣은 뒤 링크의 앞뒤가 잘리지 않았는지 확인하고, 실수로 포함된 공백·줄바꿈·설명 문구는 제거하세요. 링크의 매개변수는 임의로 수정하지 마세요.
저장한 뒤 Home으로 돌아가 구독 정보가 로드될 때까지 기다립니다. 정상적으로 가져오면 목록에 해당 구독의 서버 항목이 표시됩니다. 메모는 출처를 알아보는 데 도움이 되지만 연결 가능 여부를 결정하지는 않습니다. 구독 이름만 저장되고 서버가 보이지 않는다면 가져오기 또는 파싱 오류가 있는지 먼저 확인하세요. 곧바로 연결 스위치를 켜지는 마세요.
구독 주소에는 계정 식별에 사용되는 비공개 매개변수가 포함될 수 있습니다. 전체 링크를 공개 게시판이나 스크린샷 설명에 붙여 넣거나 다른 사람의 기기에 입력하지 마세요. 이후 정리와 업데이트는 같은 구독을 기준으로 진행해 동일한 주소가 중복 목록에 추가되지 않도록 하세요. 업데이트 방법과 여러 구독 정리는 서버 관리 설명서를 참고하세요.
단일 서버 정보가 있다면 Add Server 사용
다시 Home에서 Add Server를 열고 보유한 정보에 맞는 프로토콜 유형을 선택합니다. 서버 주소와 포트, 해당 프로토콜에 필요한 인증 정보를 항목별로 입력하세요. Shadowsocks, VMess, VLESS, Trojan, WireGuard 등은 필요한 정보가 서로 다릅니다. 다른 프로토콜의 비밀번호나 식별자를 현재 양식에 그대로 입력하지 마세요.
정보에 TLS, Server Name, 전송 방식 또는 경로 매개변수가 포함되어 있다면 원본과 대조해 입력하세요. 서버 주소와 TLS 인증에 사용하는 이름은 서로 다를 수 있습니다. 입력 항목을 줄이려고 원래 필요한 인증을 해제하지 마세요. 항목의 의미가 불분명하다면 프로토콜 및 네트워크 용어를 확인한 뒤 정보 제공자에게 해당 연결에 필요한 매개변수를 문의하세요.
서버 공유 링크가 있다면 해당 링크를 가져오는 메뉴를 사용하세요. QR 코드는 Scan QR Code로 읽을 수 있습니다. 스캔하기 전에 개인 서버 정보에서 가져온 코드인지 확인하고 시스템 안내에 따라 카메라 접근을 허용하세요. 어떤 방법을 사용하든 저장한 뒤 Home으로 돌아가 항목이 완전한지 확인합니다. 링크를 인식했다는 사실만으로 연결에 성공한 것은 아닙니다.
이 단계를 마치면 목록에서 서버 항목을 확인할 수 있고 그중 하나가 선택되어 있어야 합니다. 다음으로 트래픽 처리 방식을 선택한 뒤 연결을 시작합니다.
단계 02 · 트래픽 처리 방식 선택
Global Routing: 세 가지 모드 선택
Home에서 Global Routing을 열어 현재 선택 항목을 확인합니다. 세 가지 모드는 Config, Proxy, Direct입니다. 각 모드는 연결에 적용할 정책을 결정하며 서버 정보를 채우거나 잘못된 인증 정보를 수정하지는 않습니다.
| 모드 | 처리 방식 | 첫 테스트에서 확인할 사항 |
|---|---|---|
| Config | 현재 활성화된 설정 규칙에 따라 정책을 결정합니다. | 현재 설정과 테스트 대상에 적용된 규칙을 확인하세요. |
| Proxy | 프록시 처리 대상 트래픽을 프록시로 연결합니다. | 선택한 서버가 요청을 처리할 수 있는지 확인하세요. |
| Direct | 직접 연결합니다. | 현재 네트워크에서 직접 접속할 수 있는지 확인할 때 사용합니다. |
규칙을 적용해 일상적으로 사용하려면 Config를 선택한 다음 Config에서 실제로 활성화된 설정 파일을 확인하세요. Config 페이지는 설정 파일을 관리하고, Global Routing의 Config 옵션은 설정에 따라 트래픽을 처리합니다. 서로 관련은 있지만 같은 작업은 아닙니다. 파일을 목록에 가져오기만 해서는 해당 파일이 선택된 것이 아닙니다.
먼저 서버 연결을 확인하려면 임시로 Proxy를 선택해 테스트한 뒤 Config로 되돌릴 수 있습니다. 규칙 분기가 첫 판단에 미치는 영향을 줄일 수 있지만, 기기의 모든 앱 요청이 같은 경로로 처리된다는 뜻은 아닙니다. 시스템의 네트워크 동작과 구체적인 설정에 따라 결과가 달라질 수 있으므로 실제 요청 기록을 기준으로 판단하세요.
Direct는 서버 사용 가능 여부를 확인하는 데 적합하지 않습니다. 이 모드에서 웹사이트가 정상적으로 열려도 현재 네트워크로 직접 접속한 것일 수 있습니다. 반대로 Config를 선택했는데 웹사이트가 직접 연결되더라도 설정 오류라고 단정할 수 없습니다. 해당 요청이 DIRECT 정책에 적용되었을 수 있습니다.
첫 설정에서는 선택한 모드를 기록해 두세요. Config를 사용한다면 현재 설정 이름도 적어 두세요. 기존 DNS 및 기타 고급 설정은 그대로 두고, 이해하지 못하는 규칙을 한꺼번에 복사하지 마세요. PROXY, DIRECT, REJECT의 의미와 규칙 적용 순서는 용어 빠른 안내에서 확인할 수 있습니다. 선택을 마치면 Home으로 돌아가 연결 단계로 진행하세요.
단계 03 · 시스템 연결 설정
Home: 스위치를 켜고 승인하기
Home으로 돌아가 서버 왼쪽의 선택 표시를 확인하고 Global Routing이 앞 단계에서 선택한 항목과 같은지 확인합니다. 그런 다음 화면 상단의 연결 스위치를 켜세요. 처음 연결할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 물을 수 있습니다. 이는 앱이 시스템 네트워크 확장 기능으로 연결을 처리하는 데 필요한 권한입니다. 구독을 가져올 때 이미 완료된 단계가 아닙니다.
시스템 알림을 읽고 요청한 앱이 Shadowrocket인지 확인한 뒤 안내에 따라 추가를 허용하세요. 기기 암호나 본인 인증이 필요할 수 있습니다. 완료되면 앱으로 돌아가 연결 상태가 계속 유지되는지 확인합니다. 이미 구성을 추가하도록 허용했다면 같은 알림이 다시 나타나지 않을 수 있습니다. 알림이 반복되지 않는다는 이유만으로 연결 과정에 문제가 있다고 판단하지 마세요.
방금 권한 요청을 거부했다면 Shadowrocket로 돌아가 연결을 다시 시작하고 시스템에 승인 대기 알림이 남아 있는지 확인하세요. 스위치를 연달아 빠르게 누르지 말고 작업이 끝난 뒤 상태를 확인합니다. 기기 관리 정책이 적용된 iPhone 또는 iPad에서는 VPN 구성을 추가하지 못할 수 있으므로 기기에서 해당 시스템 기능을 사용할 수 있는지 확인하세요.
첫 테스트 결과를 명확하게 확인하려면 시스템에 다른 VPN 연결이 활성화되어 있는지 살펴보세요. 네트워크 설정끼리 영향을 줄 수 있으므로 문제를 확인하는 동안 필요한 연결만 하나 사용하세요. 자동 연결 조건과 수동 조작이 동시에 바뀌지 않도록 우선 On Demand를 활성화하지 마세요. 수동 연결이 안정된 뒤 별도로 설정하세요.
스위치가 켜져 있고 시스템에 VPN 상태가 표시되더라도 시스템 연결이 설정되었거나 실행 중이라는 뜻일 뿐, 선택한 서버가 모든 대상에 접속할 수 있다는 의미는 아닙니다. 원격 서버 인증이 잘못되어도 시스템 네트워크 확장 기능은 시작될 수 있습니다. 이 단계에서는 권한 처리가 끝나고 연결 상태가 안정적으로 유지되는지 확인하세요. 실제 연결 가능 여부는 다음 단계에서 테스트해야 합니다.
이번 연결을 종료하려면 Home으로 돌아가 상단 스위치를 끄세요. 첫 확인 단계에서는 정상적으로 연결을 끊는 대신 시스템 구성을 삭제하지 마세요. 다음 연결 때 권한을 다시 처리해야 할 수 있고 문제 해결에 고려할 변수가 늘어납니다.
단계 04 · 실제 요청으로 확인하기
Connectivity Test: 연결 적용 여부 확인
연결 상태가 안정되면 Connectivity Test를 실행해 테스트가 완료되는지, 오류가 표시되는지 확인하세요. 테스트 메뉴의 위치와 선택 항목은 현재 앱 화면을 기준으로 확인합니다. 결과를 보관하고 사용한 서버, Global Routing 모드, 현재 네트워크도 기록해 두면 같은 조건으로 다시 테스트할 수 있습니다.
이어서 브라우저를 열고 명확한 테스트 대상에 접속한 뒤 페이지를 새로 고침하세요. 먼저 대상 사이트가 정상적으로 서비스 중인지 확인한 다음 새 요청이 완료되는지 살펴봅니다. 네트워크를 사용할 수 없는 상태에서도 캐시된 페이지는 표시될 수 있으므로 이미 열려 있던 페이지에만 의존하지 마세요. 설정을 비교하려면 매번 사이트를 바꾸지 말고 같은 대상을 반복해서 방문하세요.
지연 시간이 표시되는 것과 실제 요청이 성공하는 것은 다릅니다
서버 목록의 지연 시간 테스트는 항목을 먼저 확인하는 데 유용하지만 실제 서비스 요청과 검사 방식이 완전히 같지는 않습니다. 지연 시간이 표시되어도 인증, TLS, 대상 접속까지 모두 성공했다는 뜻은 아닙니다. 반대로 특정 탐색 테스트에 응답이 없다고 해서 서버를 완전히 사용할 수 없다고 단정할 수도 없습니다. Connectivity Test와 실제 페이지 요청을 함께 확인하세요.
Config에서는 정책도 확인하기
Config를 사용한다면 앱의 연결 기록에서 방금 보낸 요청을 찾아 대상 도메인과 실제 적용된 정책을 확인하세요. DIRECT에 적용된 요청은 규칙에 따라 직접 연결되고, PROXY에 적용된 요청은 프록시로 처리됩니다. 설정에서 정책 그룹을 사용한다면 해당 그룹에서 실제로 어떤 서버가 선택되었는지도 확인하세요. Home의 기본 항목만 확인해서는 충분하지 않습니다.
출구가 바뀌지 않았다는 이유만으로 스위치가 작동하지 않았다고 판단하지 마세요. 테스트 대상이 직접 연결 규칙에 적용되었거나 기존 연결을 재사용했을 수 있습니다. 먼저 새 요청인지 확인한 다음 적용된 규칙과 정책을 살펴보세요. 서버 연결과 규칙의 영향을 나누어 확인하려면 잠시 Proxy로 전환해 같은 테스트를 반복하고 결과를 기록한 뒤 원래 모드로 되돌릴 수 있습니다.
Connectivity Test 결과, 실제 접속, 예상한 정책이 서로 일치하면 첫 연결 확인이 끝난 것입니다. 사용 가능한 설정을 유지하고 필요한 항목을 하나씩 조정하세요. 수정 전에는 복구할 수 있도록 설정을 저장해 두세요. 연결이 확인되자마자 DNS, 규칙, 서버를 한꺼번에 바꾸면 문제가 발생했을 때 원인을 찾기 어렵습니다.
단계 05 · 실패 단계별로 원인 좁히기
첫 연결 실패: 항목별 점검
먼저 실패한 단계를 확인하세요. 구독을 가져오지 못했는지, 연결 스위치가 유지되지 않는지, 연결은 되었지만 테스트에 실패했는지, 일부 대상에만 접속할 수 없는지 구분합니다. 현상에 따라 확인할 곳이 다릅니다. 설정을 한 번에 하나만 바꾸고 같은 테스트를 반복하세요. 앱을 반복해서 다시 설치하거나 여러 매개변수를 한꺼번에 바꾸며 해결을 시도하지 마세요.
Subscribe 저장 후 서버가 표시되지 않을 때
URL이 완전한지 다시 확인하고 입력한 주소가 개인 구독 링크인지 살펴보세요. 안내 웹페이지나 단일 서버 링크와 혼동하지 마세요. 오류가 가져오기 실패인지 콘텐츠 파싱 실패인지 확인합니다. 가져오기에 실패했다면 현재 네트워크에서 인터넷에 정상적으로 접속할 수 있는지 확인하세요. 파싱에 실패했다면 정보 유형과 유효성을 확인해야 합니다. 구독에 만료된 인증 매개변수가 포함되어 있을 수 있으며, 이런 문제는 Global Routing을 바꿔도 해결되지 않습니다.
이전에 정상적으로 가져왔지만 지금 업데이트에 실패했다면 기존 항목을 유지하고 목록을 바로 비우지 마세요. 업데이트 중 표시된 오류를 기록하고 개인 구독 상태를 확인하세요. 중복 항목 정리, 메모 보존, 백업 방법은 서버 관리 설명서에서 확인할 수 있습니다. 문제를 해결하는 동안 여전히 사용할 수 있는 정보가 사라지지 않도록 주의하세요.
스위치가 꺼지거나 권한 승인이 완료되지 않을 때
시스템 권한 요청이 거부되었는지, 기기에서 VPN 구성을 추가하지 못하도록 제한하는지 확인하세요. 다른 연결이 시스템 네트워크 상태를 반복해서 바꾸고 있지 않은지도 살펴봅니다. On Demand를 사용 중이라면 발동 조건을 확인하고, 첫 문제 해결 중에는 수동 연결로 전환하세요. 시스템 연결이 안정적으로 유지되어야 이후 서버와 규칙 테스트 결과를 제대로 판단할 수 있습니다.
연결되지만 Connectivity Test에 실패할 때
먼저 Home에서 테스트할 서버가 선택되어 있는지 확인하세요. 서버 정보를 직접 입력했다면 프로토콜, 주소, 포트, 인증 항목, TLS 매개변수를 다시 확인합니다. 특히 복사한 내용에 공백이 섞였거나 대소문자가 달라지지 않았는지 살펴보세요. 메모를 수정하거나 순서를 바꾸는 것만으로는 연결 매개변수 문제가 해결되지 않습니다.
사용할 수 있는 다른 항목이 있다면 같은 모드와 테스트 대상을 유지한 채 서버 항목을 바꾸어 비교하세요. Wi-Fi와 셀룰러 네트워크에서도 한 번씩 비교할 수 있습니다. 네트워크를 바꾼 뒤에는 다시 연결하고 테스트해야 합니다. 비교 결과는 문제 범위를 파악하는 데 도움이 될 뿐, 특정 네트워크나 항목이 모든 상황에서 항상 작동한다는 뜻은 아닙니다.
Proxy에서는 작동하지만 Config에서 문제가 생길 때
먼저 Config에서 실제로 활성화된 파일과 테스트 요청에 적용된 규칙을 확인하세요. 대상이 DIRECT, REJECT 또는 사용 가능한 구성원이 없는 정책 그룹으로 전달될 수 있습니다. 이 경우 서버 자체에는 문제가 없을 수 있습니다. 이전에 작동했던 설정으로 복원한 뒤 관련 규칙을 하나씩 조정하세요. 규칙 키워드의 의미는 용어 빠른 안내에서 확인할 수 있습니다.
일부 도메인에서만 실패할 때
연결 기록에 DNS 조회 오류, 연결 시간 초과, TLS 인증 오류가 있는지 확인하세요. 도메인 조회 실패가 서버 인증 실패를 뜻하는 것은 아니며, 특정 사이트에 접속할 수 없다고 모든 트래픽에 문제가 있다고 볼 수도 없습니다. 먼저 다른 대상을 확인한 다음 현재 설정의 DNS 항목을 살펴보세요. 출처를 알 수 없는 DNS 주소를 여러 개 한꺼번에 입력하거나 이름 및 인증서 문제를 숨기려고 인증서 확인을 끄지 마세요.
추가로 도움을 요청하려면 실패한 단계, 오류 원문, 사용한 프로토콜, 라우팅 모드, 네트워크 유형을 정리하세요. 기록을 공유하기 전에 구독 주소, 비밀번호, 사용자 식별자 및 기타 인증 매개변수를 삭제하세요. 단순히 사용할 수 없다고 말하기보다 어느 단계까지 성공했고 어디서 실패했는지 설명하면 원인을 파악하는 데 도움이 됩니다.