공식 안내 / iPhone 및 iPad
Shadowrocket 시작하기
기존 정보 가져오기 → Global Routing → 연결 → 확인 → 문제 해결. 먼저 다시 확인할 수 있는 연결을 한 번 완료한 뒤 일상적인 트래픽 분할 규칙을 조정합니다.
STEP 01 / Add Server · Subscribe
서버 추가 또는 기존 구독 가져오기
먼저 보유한 정보의 종류를 확인한 뒤 적절한 메뉴를 선택합니다. 전체 구독 링크는 여러 서버를 가져올 때 사용합니다. 단일 서버 링크, QR 코드, 프로토콜과 포트가 포함된 정보는 보통 특정 서버를 추가할 때 사용합니다. 구독 링크와 일반 웹 주소는 서로 다른 정보이며, 도메인만으로 용도를 판단할 수 없습니다. 출처의 설명이 불분명하면 기존 서비스 제공자에게 먼저 확인하고, Type을 반복해서 바꾸며 추측하지 마세요.
직접 추가: Home에서 Add Server 열기
Home을 열고 SERVER 영역에서 Add Server를 찾거나 화면의 추가 메뉴를 사용합니다. Add Server 화면에서 Type을 누르고 보유한 정보에 맞는 프로토콜을 선택한 다음 해당 항목을 입력합니다. 스크린샷의 Host, Port, Password, Method는 특정 유형의 입력 항목 예시입니다. Type을 바꾸면 양식도 달라질 수 있으므로, 스크린샷의 항목 조합을 모든 프로토콜에 공통으로 필요한 정보라고 생각하지 마세요.
Host에는 자료에 기재된 서버 주소를, Port에는 포트를 입력합니다. Password와 Method는 원본 정보와 항목별로 대조합니다. 복사한 내용 앞뒤의 공백, 전각 기호, 누락된 문자를 확인하고 포트에 설명 문구가 포함되지 않도록 주의하세요. 선택한 프로토콜에 다른 매개변수가 필요하다면 원본 자료의 해당 값을 사용합니다. 저장 전에 다시 한번 대조한 뒤 Home으로 돌아가 SERVER에 새 항목이 표시되는지 확인합니다.
구독 가져오기: Subscribe 선택
기존 구독 링크가 있다면 Add Server의 Type에서 Subscribe를 선택하고 URL 항목에 전체 링크를 입력한 뒤 저장하여 가져오기가 완료될 때까지 기다립니다. 주소의 앞부분만 복사하지 마세요. 쿼리 매개변수도 구독을 식별하는 정보일 수 있습니다. 구독 링크는 민감한 정보이므로 공개 스크린샷이나 로그 댓글에 올리거나 관계없는 사람에게 보내지 마세요. 여기서는 이미 보유한 링크만 가져오며, 서비스를 찾거나 구매하는 방법은 다루지 않습니다.
구독 항목을 저장하는 것과 서버를 성공적으로 가져오는 것은 별개의 결과입니다. Home으로 돌아가 해당 그룹을 펼쳐 서버 항목이 실제로 있는지 확인하세요. 구독 이름만 보이고 서버가 없다면 바로 연결 단계로 넘어가지 말고, 로컬 네트워크에서 링크에 접근할 수 있는지, 링크가 완전한지, 구독이 유효한지 먼저 점검합니다. 나중에 Shadowrocket에서 구독을 업데이트할 때는 해당 구독 항목의 업데이트 기능을 사용하고 목록이 실제로 새로 고쳐졌는지 확인하세요. 반복해서 같은 항목을 추가하는 방식으로 업데이트를 대신하지 마세요.
보유한 자료가 QR 코드라면 Add Server에서 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 권한을 허용합니다. Import from Cloud JSON은 해당 형식의 자료를 가져오는 기능이며, 아무 구독 주소나 대신 입력하는 메뉴가 아닙니다. 이 단계의 완료 기준은 간단합니다. SERVER에 선택할 수 있는 서버가 있고, 해당 정보가 보유한 자료와 일치해야 합니다. Subscribe와 Config의 차이는 용어 설명에서 확인할 수 있습니다.
STEP 02 / Global Routing · Config
Global Routing 모드 선택
서버 목록을 준비했으면 Home으로 돌아가 Global Routing을 엽니다. 이 메뉴는 요청을 전반적으로 처리하는 방식을 정하며, 서버를 추가하거나 잘못된 서버 비밀번호를 수정하는 기능은 아닙니다. 세 가지 모드는 Config(설정)/Proxy(프록시)/Direct(직접 연결)입니다. 전환하기 전에 이번 작업이 서버 확인을 위한 것인지, 기존 규칙을 적용하기 위한 것인지 먼저 정하세요.
| 모드 | 요청 처리 방식 | 사용 목적 |
|---|---|---|
| Config | 현재 설정 파일의 규칙과 정책에 따라 처리합니다. | 규칙에 따른 트래픽 분할을 확인하거나 일상적으로 사용할 때 선택합니다. |
| Proxy | 앱이 처리하는 요청을 프록시 정책으로 보냅니다. | 규칙의 영향을 잠시 제외하고 선택한 서버를 확인할 때 사용합니다. |
| Direct | 원격 프록시 서버를 거치지 않고 대상에 직접 연결합니다. | 직접 연결 상태를 확인하거나 임시 비교 대상으로 사용할 때 선택합니다. |
기존 서버를 처음 확인할 때는 Proxy를 잠시 선택하면 설정 파일의 트래픽 분할 결과가 판단에 미치는 영향을 줄일 수 있습니다. 그렇다고 모든 대상에 접속할 수 있는 것은 아니며, 서버 정보를 확인하는 절차를 대신하지도 않습니다. 확인을 마친 뒤 요청마다 다른 정책을 적용하려면 Config로 전환합니다. 상단의 연결 상태만 보고 현재 프록시를 사용 중이라고 판단하지 마세요. Direct에서는 원격 서버가 해당 요청을 전달하지 않습니다.
Config 사용 전 현재 설정 파일 확인
Config에서 목록에 파일이 있는지만 보지 말고 현재 적용 중인 설정 파일을 확인합니다. 구독은 보통 서버 목록을 제공하고, 설정 파일에는 규칙과 다른 매개변수가 포함됩니다. 구독을 가져왔다고 해서 개인 용도에 맞는 설정 파일까지 자동으로 마련되는 것은 아닙니다. 설정 파일을 열면 General, Rule 등의 구역을 확인할 수 있습니다. 스크린샷에는 편집 화면과 Add Rule 메뉴가 표시되어 있습니다. 이미 사용할 수 있는 설정이 있다면 첫 연결 단계에서는 여러 매개변수를 동시에 바꾸지 않도록 기존 내용을 유지하세요.
규칙의 PROXY, DIRECT, REJECT는 정책 키워드입니다. Global Routing의 Proxy, Direct와 혼동하지 마세요. 예를 들어 아래 조각은 예시 도메인과 일치하는 요청에 PROXY를 적용하고 나머지 요청에는 DIRECT를 적용합니다. 문법 설명을 위한 예시일 뿐, 이 안내에서 가져오도록 요구하는 완전한 설정 파일은 아닙니다. 원격 서버를 거치는지는 현재 모드, 실제로 일치하는 규칙, 정책의 연결 대상에 따라 달라집니다. 파일에 PROXY가 있다는 사실만으로 판단할 수 없습니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
규칙 순서가 아직 익숙하지 않다면 먼저 뒤의 연결 및 확인 단계를 마친 다음 규칙 및 설정 안내를 읽어 보세요. 세 가지 모드를 따로 비교하려면 라우팅 모드 안내를 확인할 수 있습니다. 여기서 확인할 것은 하나입니다. Home에 표시된 Global Routing이 이번 테스트 목적에 맞고, Config에서 사용할 설정 파일이 실제로 지정되어 있어야 합니다.
STEP 03 / Home · SERVER
서버를 선택한 뒤 연결 스위치 켜기
Home으로 돌아가 SERVER에서 방금 가져온 그룹을 펼친 다음 사용할 서버를 선택합니다. 항목 옆에 선택 표시가 있는지 확인하여 기본 서버가 원하는 항목으로 바뀌었는지 확인하세요. 항목을 눌러 상세 정보를 여는 것과 서버를 선택하는 것은 다릅니다. 편집 화면에 들어갔다고 해서 해당 항목이 이번 연결 대상으로 선택된 것은 아닙니다. 서버가 많다면 선택한 이름을 기억해 두세요. 이후 문제를 해결할 때 같은 정보를 기준으로 확인할 수 있습니다.
Global Routing을 확인한 뒤 Home 상단의 연결 스위치를 켭니다. 연결 전에는 Not Connected가 표시될 수 있습니다. 스위치를 켠 후 상태가 바뀌는지, 스위치가 켜진 상태를 유지하는지 확인합니다. 짧은 간격으로 스위치를 반복해서 켜고 끄면 이전 연결이 처리 중인지 새 시도가 실패했는지 구별하기 어렵습니다. 시스템 권한 요청이 표시되면 먼저 처리한 뒤 앱으로 돌아와 결과를 확인하세요.
첫 권한 승인: VPN 구성 추가 허용
처음 연결할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 물을 수 있습니다. 이 권한은 앱이 시스템 네트워크 확장 기능으로 트래픽을 처리하도록 허용하는 것이며, 구매 확인이나 원격 서버 테스트 완료를 뜻하지 않습니다. 요청을 보낸 앱이 현재 사용 중인 Shadowrocket인지 확인한 뒤 시스템 안내에 따라 승인하세요. 기기에 따라 암호나 생체 인증이 필요할 수 있습니다. 완료 후 Home으로 돌아가 필요하면 연결 스위치를 다시 켭니다.
이전에 권한을 거부했다면 구독을 다시 가져오는 것만으로 연결이 복구되지는 않습니다. 연결을 다시 시도해 시스템 안내가 표시되는지 확인하세요. 기기 관리 설정이나 연결 제한이 있거나 다른 VPN 연결이 사용 중이라면 기기 설정과 해당 관리 요구 사항도 점검해야 합니다. 용도를 확인하기 전에 다른 VPN 구성을 삭제하지 마세요. iPad에서는 화면 배치가 스크린샷과 다를 수 있지만 Home, SERVER, Global Routing, 연결 스위치의 이름을 기준으로 찾으면 됩니다.
연결 스위치가 켜져 있다는 것은 로컬 연결 상태가 성립했다는 뜻일 뿐, 서버와 이름 확인, 대상 접속이 모두 정상이라는 의미는 아닙니다. 다음으로 Connectivity Test를 실행하고 실제 웹페이지에서도 확인해야 합니다. 스위치가 바로 꺼지면 마지막 절에서 권한과 로컬 연결을 먼저 점검하세요. 스위치가 켜져 있지만 접속에 실패한다면 선택한 서버, 현재 모드, 구체적인 실패 증상을 기록하세요. 곧바로 앱을 다시 설치할 필요는 없습니다.
STEP 04 / Connectivity Test · 실제 접속
테스트 응답과 실제 트래픽을 함께 확인
연결을 켠 뒤 Home에서 Connectivity Test를 누르고 이번 테스트가 끝날 때까지 기다립니다. 결과는 사용 중인 Test Method에 맞춰 해석해야 합니다. 방법에 따라 확인 대상과 조건이 다를 수 있으며, 응답이 표시되어도 모든 웹페이지, 프로토콜, 앱을 사용할 수 있다는 뜻은 아닙니다. 한 번 표시된 수치를 장기적인 성능 지표로 보지도 마세요. 여기서는 추가 확인을 진행할 수 있는 상태인지 판단하는 데만 사용합니다.
이어서 브라우저를 열고 실제로 사용하려는, 주소가 올바른지 알고 있는 페이지에 접속한 다음 정상적으로 작동하는 다른 페이지와 비교합니다. 페이지 제목이나 캐시된 이전 문구만 보이는 것이 아니라 콘텐츠가 완전히 로드되는지 확인하세요. 특정 앱에서만 문제가 생긴다면 먼저 영향 범위를 기록하고 전체 연결이 끊겼다고 단정하지 마세요. 대상 서비스 상태, 앱 자체 설정, 설정 규칙에 따라 결과가 달라질 수 있습니다.
Config 사용 시 규칙에 따른 경로도 확인
최종적으로 Config를 사용할 예정이라면 Proxy로 테스트한 뒤 Config로 전환하고 같은 대상을 다시 테스트합니다. 두 모드에서 결과가 다르면 서버 비밀번호를 계속 바꾸기보다 규칙 일치 여부나 정책 선택을 확인해야 할 수 있습니다. PROXY로 연결될 것으로 예상되는 대상 하나와 DIRECT로 연결될 것으로 예상되는 대상 하나를 각각 확인하여 단일 페이지 결과로 전체 트래픽 분할을 판단하지 마세요. 테스트 대상은 실제로 사용하는 서비스에서 선택합니다.
요청에 어떤 정책이 적용됐는지 확인하려면 Data에서 확인할 수 있는 연결 또는 요청 기록을 현재 설정 파일과 함께 살펴봅니다. 확인 가능한 항목은 앱 화면에 따라 다를 수 있습니다. 먼저 대상과 규칙의 일치 여부를 확인한 다음 최종 정책을 살펴보세요. 시스템의 VPN 상태 아이콘만으로 트래픽이 원격 서버를 거친다고 판단할 수는 없습니다. 예상한 규칙과 일치하지 않으면 규칙 순서, 도메인 조건, 기본 규칙을 점검하고 자세한 내용은 규칙 안내에서 확인하세요.
이 단계가 끝나면 세 가지를 설명할 수 있어야 합니다. 현재 선택한 서버, Global Routing 모드, 실제로 접속을 확인한 대상입니다. 테스트를 통과했다면 이 설정을 사용할 수 있는 기준으로 보관하세요. 이후 네트워크를 바꾸거나 구독을 업데이트하거나 규칙을 수정해 결과가 달라지면, 처음부터 모든 항목을 추측하는 대신 기준 설정과 하나씩 비교할 수 있습니다.
STEP 05 / Settings · Diagnostics
실패 단계부터 점검하고 한 번에 하나만 변경
가장 먼저 실패한 단계부터 문제를 확인합니다. 연결 스위치를 끄고 기기 자체에서 정상적으로 접속되는 것으로 확인된 페이지가 열리는지 확인한 다음 Shadowrocket을 다시 켭니다. 공용 네트워크에 먼저 로그인해야 한다면 네트워크 로그인을 완료하세요. 로컬 네트워크가 작동하지 않으면 Config 수정, QR 코드 재스캔, Test Method 변경으로 해결할 수 없습니다.
가져오기 실패: 링크 가져오기와 서버 연결 구분
Subscribe에서 목록을 가져오지 못하면 링크가 완전히 복사되었는지, 공백이 추가되지 않았는지, 제공자가 접속 조건을 변경했는지 확인합니다. 구독 가져오기 실패와 특정 서버 연결 실패는 서로 다른 문제입니다. 전자는 목록을 가져오지 못한 상태이고, 후자는 이미 있는 항목을 사용할 수 없는 상태입니다. 목록이 이미 있다면 구독 업데이트 후 현재 선택한 항목이 더 이상 유효하지 않게 된 것은 아닌지도 확인하세요. 비교에 사용할 기록을 잃지 않도록 모든 정보를 삭제한 뒤 다시 시도하지 마세요.
테스트 실패: 원본 서버 정보 재확인
Type, Host, Port와 선택한 프로토콜에 필요한 인증 및 전송 매개변수를 하나씩 대조합니다. 대소문자, 암호화 방식, 서버 이름 등의 요구 사항은 보유한 원본 정보를 기준으로 확인하세요. 다른 유형의 입력 방법을 그대로 적용하지 마세요. 인증서 확인이 필요한 연결은 기기의 날짜와 시간이 올바르지 않을 때 영향을 받을 수 있습니다. 문제 해결을 위해 검증을 무작정 끄면 원인을 가릴 수 있으므로 정보, 시간, 대상 이름이 맞는지 먼저 확인합니다.
일부만 접속되지 않을 때: 모드 및 규칙 확인
Proxy에서는 접속되지만 Config에서는 되지 않는다면 현재 적용 중인 설정, 대상에 일치하는 규칙, 해당 정책이 예상한 서버를 가리키는지 먼저 확인합니다. Direct에서는 접속되지만 Proxy에서는 되지 않는다면 이번에 직접 연결한 대상에 접속할 수 있다는 사실만 확인된 것이며 서버 정보가 정확하다는 뜻은 아닙니다. 모드를 전환할 때 같은 대상을 비교하고 한 번에 한 항목만 변경해야 증상과 변경 사항을 연결해 판단할 수 있습니다.
Settings에서 먼저 확인할 항목
Settings에서 먼저 Test Method를 확인하고 Connectivity Test가 어떤 방법으로 동작하는지 파악합니다. 테스트 방법이 바뀌면 이전 결과와 동일한 조건으로 직접 비교할 수 없습니다. On Demand는 조건에 따라 연결을 시작하는 기능입니다. 수동으로 조작한 것과 달리 꺼진 뒤 다시 연결되는 현상이 있다면 관련 조건이 설정되어 있는지 확인하세요. 처음 문제를 해결할 때는 기존 설정을 기록하고 자동 연결 조건의 영향을 잠시 제외한 다음, 상태가 안정되면 필요한 조건을 다시 설정합니다.
문제를 더 자세히 파악하려면 Settings의 Diagnostics를 사용하고 현재 문제와 관련된 내용만 기록합니다. Proxy, TCP, UDP 등의 항목은 모두 켜면 해결되는 만능 스위치가 아닙니다. 명확한 근거가 없다면 기존 설정을 유지하세요. 기록을 공유하기 전에는 구독 링크, 서버 인증 정보, 개인 요청 내용을 가립니다. 전체 연결 정보를 공개하지 않고도 실패 단계, 사용한 모드, 연결 유지 여부를 설명할 수 있습니다.
구독이나 서버 자체에 문제가 있는 것으로 확인되면 기존 서비스 제공자에게 유효한 정보인지 문의하세요. 규칙 문법이 문제라면 설정 파일 및 규칙 안내를 계속 확인하고, Settings의 메뉴 이름이 익숙하지 않다면 용어 설명을 먼저 살펴보세요. 연결이 안정적으로 이루어진 뒤 규칙과 On Demand 조건을 단계적으로 추가하는 편이 첫 연결에서 여러 고급 설정을 동시에 바꾸는 것보다 결과를 확인하기 쉽습니다.
확인 완료
사용 가능한 설정을 유지한 뒤 고급 항목 조정
SERVER 항목, 선택한 서버, Global Routing, 실제 접속 결과가 서로 일치하는지 확인합니다. 일상적으로 사용할 설정으로 돌아가려면 다시 한번 테스트하세요. 첫 테스트 성공만으로 이후 상태까지 확인했다고 볼 수는 없습니다.