Shadowrocket 가져오기 및 연결
추가, 모드 선택, 연결, 확인, 문제 해결 순서로 진행합니다. 먼저 확인 가능한 연결을 하나 설정한 다음 규칙과 자동 연결 조건을 조정하세요.
이 문서는 iPhone 및 iPad 사용 방법을 중심으로 설명합니다. 화면의 항목명은 영어 그대로 표기하며, 스크린샷은 메뉴 위치를 찾는 데 참고하세요. 실제 레이아웃과 사용 가능한 옵션은 현재 앱 화면을 기준으로 확인하세요.
01 · Add Server 및 Subscribe
가지고 있는 정보 유형에 맞는 추가 방법을 하나 선택하세요. 중복으로 가져올 필요는 없습니다.
Shadowrocket을 열고 하단의 Home으로 이동합니다. SERVER 그룹에서 Add Server를 찾거나 화면의 추가 메뉴를 사용해 편집 화면으로 이동합니다. 먼저 보유한 정보가 단일 서버 항목인지, 전체 구독 링크인지, 호환되는 QR 코드인지 확인하세요. 각 유형에 맞는 가져오기 방법이 다릅니다. 구독 링크는 서버 Host가 아니므로 전체 링크를 Host와 Port에 나누어 입력하면 안 됩니다.
서버 정보가 있는 경우: Type을 선택한 뒤 항목 입력
Add Server 화면에서 Type을 열고 보유한 정보와 일치하는 프로토콜 유형을 선택합니다. Shadowsocks를 예로 들면 원본 정보에 따라 Host, Port, Password, Method를 입력합니다. Host에는 서버 도메인 또는 주소를, Port에는 포트 번호를 입력합니다. Method는 서버 측 설정과 일치해야 하며, 이름이 비슷하다는 이유로 선택하지 마세요. Type에 따라 표시되는 항목이 다르므로 스크린샷의 입력 항목이 모든 프로토콜에 적용되는 것은 아닙니다.
입력할 때는 복사한 내용의 앞뒤에 공백이 없는지, 포트 번호에 전각 숫자를 잘못 사용하지 않았는지, 입력기가 비밀번호의 문장 부호를 바꾸지 않았는지 확인하세요. TLS, 전송 방식 또는 기타 추가 매개변수가 있다면 원본 안내에 따라 하나씩 확인해야 합니다. 기본 항목 네 개만 입력했다고 구성이 완전하다고 단정하지 마세요. 입력을 마치면 화면의 저장 또는 완료 버튼을 누르고 Home으로 돌아가 SERVER에 해당 항목이 표시되는지 확인합니다.
구독 링크가 있는 경우: Subscribe 사용
전체 구독 링크가 있다면 Type에서 Subscribe를 선택하고 링크 전체를 URL 항목에 붙여 넣은 다음 알아보기 쉬운 메모를 입력해 저장합니다. 링크의 쿼리 매개변수에는 접근 자격 정보가 포함될 수 있으므로 임의로 삭제하거나 공유하지 마세요. 저장 후 내용이 불러와질 때까지 기다립니다. 현재 화면에 업데이트 기능이 있다면 구독을 한 번 업데이트한 뒤 서버 항목이 펼쳐지거나 목록에 표시되는지 확인합니다.
구독 항목은 여러 서버를 관리하기 위한 것으로, 목록의 모든 항목이 연결 테스트를 통과했다는 뜻은 아닙니다. Home에서 실제 테스트에 사용할 서버 하나를 선택하고 이름을 기억하세요. 테스트 도중 서버를 바꾸지 마세요. 목록이 비어 있다면 링크가 유효한지, 전체 내용이 복사되었는지, 현재 네트워크에서 구독 내용을 가져올 수 있는지 먼저 확인합니다. 같은 링크를 반복해서 추가하지 마세요.
QR 코드가 있는 경우: Scan QR Code
Add Server 화면에서 Scan QR Code를 사용하고 시스템 안내에 따라 필요한 카메라 권한을 허용한 다음, 보유한 호환 QR 코드 전체가 화면에 들어오도록 맞춥니다. 인식 후에는 가져온 항목이 단일 서버인지 구독인지 먼저 확인하고 Type, Host 또는 URL 등 주요 정보를 점검합니다. QR 코드는 정보를 입력하는 방법일 뿐, 정보의 유효성을 검증해 주지는 않습니다. 인식에 실패하면 원본 링크나 항목을 직접 입력할 수 있습니다. QR 코드 내용을 임의로 수정해 해결하려고 하지 마세요.
화면 하단의 Import from Cloud JSON은 별도의 정보 가져오기 메뉴이며, 모든 구독 링크를 대신할 수 있는 일반적인 방법은 아닙니다. 보유한 정보가 해당 형식을 사용한다고 명확히 확인된 경우에만 이용하세요. 어떤 방법으로든 추가를 마쳤다면 다음 단계에서 여러 고급 설정을 바로 변경하기보다 Global Routing의 트래픽 처리 방식을 먼저 정합니다.
02 · Global Routing 선택
서버는 연결 대상을 정하고, Global Routing은 트래픽 처리 방식을 정합니다.
Home으로 돌아가 Global Routing을 엽니다. 여기에서 선택할 수 있는 세 가지 모드는 Config, Proxy, Direct입니다. 이는 서버 프로토콜 세 종류가 아니며 연결 스위치를 대신하지도 않습니다. 모드를 선택한 뒤 실제 경로를 확인하려면 다음 단계에서 연결을 시작해야 합니다.
Config는 현재 활성화된 구성의 규칙에 따라 트래픽을 처리합니다. 대상마다 PROXY, DIRECT 또는 기타 지정된 정책을 적용할 수 있습니다. 평소 규칙에 따라 트래픽을 분기하려면 구성의 출처와 내용을 확인한 뒤 이 모드를 사용하세요. SERVER에서 서버를 선택했다고 해서 모든 요청이 해당 서버를 통과하는 것은 아닙니다. 특정 대상에 DIRECT가 적용된다면 규칙에 따라 직접 연결되는 것입니다.
Proxy는 일반적인 트래픽 처리 과정에서 선택한 프록시 경로를 사용합니다. 서버가 작동하는지 잠시 확인하거나 규칙의 영향을 분리해 살펴볼 때 유용합니다. 모든 앱 요청이 반드시 동일하게 관찰 가능한 경로를 통과한다는 뜻은 아니므로 실제 대상과 연결 기록을 함께 확인해야 합니다. Direct는 대상에 직접 연결할 때 사용하며 기본 네트워크와 비교하는 기준이 될 수 있습니다. Direct에서 대상이 열리더라도 프록시 서버가 정상이라는 뜻은 아닙니다.
Config 사용 전 현재 구성을 확인하세요
하단의 Config로 이동해 사용할 구성을 확인한 뒤 내용을 엽니다. 공식 스크린샷은 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 구역이 있는 구성 파일 편집 화면을 보여 줍니다. 이 화면은 Global Routing 선택 메뉴가 아닙니다. 구성을 편집하는 메뉴와 모드를 선택하는 메뉴를 혼동하지 않도록 두 메뉴의 위치를 먼저 확인하세요.
처음 사용할 때는 Rule을 중점적으로 확인하면 됩니다. 도메인 규칙, 네트워크 대역 규칙, 최종 규칙이 각각 어떤 정책을 적용하는지, 참조된 정책이 실제로 존재하는지 살펴보세요. Add Rule로 규칙을 추가하기 전에 원본 구성을 복사해 저장하세요. 규칙은 일반적으로 순서대로 매칭되며, 먼저 일치한 규칙이 이후 처리를 좌우합니다. 예를 들어 DOMAIN-SUFFIX는 도메인 접미사를 기준으로 매칭하고 FINAL은 앞선 규칙과 일치하지 않은 트래픽을 최종 처리합니다.
첫 연결을 위해 URL Rewrite나 HTTPS Decryption을 조정할 필요는 없습니다. 변경 범위를 좁게 유지해야 서버, 규칙, 네트워크 중 어디에 문제가 있는지 파악하기 쉽습니다. 확인된 규칙 구성이 없다면 Proxy로 잠시 연결을 테스트한 다음 Config로 돌아와 항목별로 확인할 수 있습니다. 규칙 개념과 프로토콜 항목에 대한 자세한 설명은 프로토콜 상세 안내를, 사용 관련 질문은 자주 묻는 질문을 참고하세요.
03 · Home에서 연결 및 시스템 권한 허용
선택한 서버와 모드를 확인한 뒤 상단 스위치를 켭니다.
Home으로 돌아가 SERVER에서 방금 입력하거나 가져온 서버가 선택되어 있는지 확인한 다음, 이번 테스트 목적에 맞는 모드가 Global Routing에 표시되는지 살펴봅니다. Config를 사용한다면 방금 확인한 구성이 활성화되어 있는지도 확인하세요. 세 항목의 설정을 모두 확인한 뒤 Not Connected 상태 근처에 있는 상단 연결 스위치를 켭니다.
처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. 이 안내는 Shadowrocket이 시스템 네트워크 확장을 통해 해당 트래픽을 처리해야 한다는 뜻이며, 이 단계에서는 네트워크 권한만 부여합니다. 앱 이름과 권한 안내를 확인한 뒤 원하는 경우 허용하고 시스템 안내에 따라 기기 인증을 완료하세요. 권한을 취소하면 이번 연결은 완료되지 않습니다. 앱으로 돌아가 연결을 다시 시작하면 되며 서버를 반복해서 가져올 필요는 없습니다.
권한 절차가 끝나면 Home으로 돌아가 연결 스위치와 상태 문구가 바뀌었는지 확인합니다. 화면에 Not Connected가 계속 표시되면 현재 요청이 끝날 때까지 기다린 후 처리해야 할 시스템 안내가 남아 있는지 확인하세요. 상태 표시줄의 아이콘 하나만으로 판단하지 마세요. 표시 방식은 기기와 현재 화면에 따라 달라질 수 있으므로 앱 내 상태와 실제 요청 결과를 함께 확인해야 합니다.
연결 상태만으로 대상에 접근할 수 있는 것은 아닙니다
스위치가 켜져 있다는 사실은 시스템 연결 절차가 시작되었거나 작동 중임을 나타낼 뿐, 선택한 서버, DNS, 대상 서비스가 모두 정상임을 보장하지 않습니다. 다음으로 Connectivity Test를 실행하고 실제로 사용할 페이지를 열어야 합니다. 기기의 네트워크 연결을 관리하는 다른 구성이 있다면 테스트에 영향을 주지 않도록 현재 어떤 설정이 적용 중인지 먼저 확인하세요.
첫 확인이 끝날 때까지 On Demand 조건을 그대로 두고, 네트워크와 서버를 동시에 바꾸지 마세요. 테스트를 종료하려면 Home으로 돌아가 연결 스위치를 끈 다음 상태가 복구되었는지 확인합니다. 연결 정보는 계속 보관되며 스위치를 끈다고 구독이나 서버가 삭제되지는 않습니다.
04 · Connectivity Test 및 실제 연결 확인
테스트 결과, 대상 접근 여부, 규칙 기록을 서로 대조해야 합니다.
Home에서 Connectivity Test를 열거나 실행한 뒤 결과가 표시될 때까지 기다립니다. 이 테스트는 현재 조건에서의 연결 상태를 확인하기 위한 것으로 모든 대상 서비스에 대한 보장은 아닙니다. 결과는 테스트 방식, 테스트 대상, 현재 네트워크, 서버 상태에 따라 달라집니다. 따라서 한 번 시간 초과가 발생했다고 모든 요청이 실패했다고 단정할 수 없으며, 한 번 성공했다고 모든 규칙이 올바르다는 뜻도 아닙니다.
이어서 실제로 사용하려는 대상 페이지를 열고 요청을 다시 보내 예상한 내용이 표시되는지 확인합니다. 캐시된 내용 때문에 현재 경로가 적용된 것으로 착각하지 않도록 새 페이지를 열어 테스트하는 것이 좋습니다. 대상에 직접 접속할 수 있는 경우 페이지가 열렸다는 사실만으로 프록시와 직접 연결을 구분할 수는 없습니다. Global Routing과 기록을 함께 확인하세요.
Data에서 정책 및 연결 정보 확인
앱으로 돌아와 Data를 열고 현재 화면에서 확인할 수 있는 연결 또는 요청 기록을 살펴봅니다. 대상, 매칭 규칙, 정책이 표시된다면 예상한 내용과 일치하는지 확인하세요. Config에서 DIRECT에 매칭된 요청을 프록시 연결 실패로 오해하면 안 됩니다. PROXY에 매칭된 요청이 실패했다면 서버와 대상도 추가로 확인해야 합니다. 기록의 명칭과 상세 정보는 기능 및 화면에 따라 다르므로 실제 표시 내용을 기준으로 확인하세요.
문제가 어디에 있는지 여전히 불분명하다면 원래 모드를 기록한 뒤 Proxy로 잠시 전환해 같은 대상을 다시 테스트합니다. 이어서 Direct로 바꿔 기본 네트워크와 비교합니다. 결과를 의미 있게 비교하려면 매번 모드 하나만 변경하고 서버, 네트워크, 대상은 동일하게 유지해야 합니다. Proxy에서는 작동하지만 Config에서 작동하지 않는다면 구성 규칙과 참조된 정책을 먼저 확인하세요. 둘 다 실패한다면 서버 입력 항목과 기본 네트워크를 살펴봅니다.
테스트가 끝나면 평소 사용할 모드로 되돌립니다. Config로 돌아가는 경우 활성화된 구성을 다시 확인하세요. 임시 문제 해결 모드를 이유를 잊은 채 계속 사용하지 않도록 합니다. 이번에 사용한 서버 이름, 모드, 네트워크 유형, 실패 현상을 기록해 두는 것이 좋습니다. 구독 링크나 비밀번호 같은 인증 정보는 저장하거나 공개할 필요가 없습니다. 여기까지 마친 다음 On Demand 등 자동 연결 기능을 설정할지 결정하세요.
05 · Settings 및 자주 발생하는 실패 원인
네트워크, 정보, 권한, 규칙 순서로 확인하고 매번 한 항목만 변경하세요.
구독 목록이 비어 있는 경우: 내용을 가져오는 과정부터 확인
Subscribe를 저장한 뒤에도 SERVER에 서버 항목이 없다면 연결을 잠시 중단하고 기기의 현재 네트워크가 정상적으로 작동하는지 확인합니다. 구독 URL 전체가 복사되었는지, 안내 페이지 주소를 잘못 복사하지 않았는지, 링크가 만료되지 않았는지, 구독 내용이 현재 가져오기 방식과 호환되는지 살펴보세요. 보유한 정보의 제공처에서 상태를 확인하면 됩니다. 이 사이트에서는 대체 구독을 제공하지 않습니다. 기존 항목은 유지하고 결과를 확인할 수 있도록 한 번 업데이트하세요. 같은 구독을 여러 번 반복해서 추가하지 마세요.
항목은 있지만 연결이 실패하는 경우: 원본 입력 정보 확인
Type, Host, Port, Password와 해당 프로토콜의 추가 항목을 차례로 확인합니다. Shadowsocks는 특히 Method가 일치하는지 살펴보세요. 다른 프로토콜에도 추가 식별자, 전송 방식 또는 TLS 설정이 필요할 수 있습니다. 테스트 수치를 표시하려고 매개변수를 임의로 바꾸지 마세요. 구독을 방금 업데이트했다면 현재 선택한 서버 정보가 변경되거나 제거되어 더 이상 유효하지 않은 것은 아닌지도 확인합니다.
테스트 시간 초과: Test Method와 실제 접속 결과 확인
Settings에서 Test Method를 확인해 현재 테스트 방식을 파악한 뒤 실제 대상에 접속한 결과와 비교합니다. 특정 테스트 방식이 실패하더라도 모든 앱 요청이 실패한 것은 아닐 수 있습니다. 반대로 테스트 결과가 표시되더라도 페이지가 열리지 않는다면 대상, DNS 또는 규칙이 원인일 수 있습니다. DNS, TCP, UDP를 한꺼번에 변경하지 말고 먼저 어떤 테스트와 대상에서 실패했는지 구체적으로 확인하세요.
상태가 반복해서 바뀌는 경우: On Demand 확인
On Demand는 조건에 따라 연결을 시작하며, Global Routing의 트래픽 분배와는 다른 기능입니다. 수동으로 끈 뒤 다시 연결되거나 네트워크를 바꾼 뒤 상태가 달라진다면 On Demand 조건이 설정되어 있는지 먼저 확인하세요. 반복 가능한 수동 테스트를 하려면 기존 설정을 기록한 뒤 관련 자동 연결 조건을 잠시 끄고 연결 확인을 마친 다음 실제 사용 목적에 맞게 복원할 수 있습니다.
일부 대상만 실패하는 경우: 규칙과 진단 정보 확인
대부분의 대상은 정상인데 특정 대상만 실패한다면 Config에서 해당 Rule과 최종 정책을 확인한 뒤 Data에서 관련 기록을 살펴봅니다. Settings의 Diagnostics는 추가 문제 해결을 위한 메뉴입니다. 진단 정보는 문제가 발생한 시각, 선택한 서버, 모드와 함께 확인해야 의미가 있습니다. 스크린샷이나 기록을 공유하기 전에 구독 URL, 비밀번호, 접근 자격 정보 및 불필요한 개인 네트워크 정보를 삭제하세요.
모드를 바꿀 때 차이가 반복적으로 나타난다면 그 비교 결과를 기록하세요. 앱을 먼저 다시 설치할 필요는 없습니다. 재설치하면 정보를 복구하는 작업이 늘어나며 잘못된 입력 항목이나 만료된 구독이 자동으로 수정되지는 않습니다. 구매, 구독, 설정에 대한 추가 질문은 자주 묻는 질문을 참고하세요. 프로토콜 매개변수와 선택 방법을 알아보려면 Shadowsocks 및 프로토콜 참고 안내를 읽어 보세요.
