OFFICIAL MANUAL / FIRST CONNECTION

Shadowrocket 구독 가져오기 및 첫 연결

가져오기, 모드 선택, 승인, 확인 순서로 진행하세요. 먼저 반복해서 사용할 수 있는 연결을 만든 뒤 규칙과 자동 연결 설정을 조정합니다. 이 안내는 iPhone과 iPad를 중심으로 하며, 메뉴 이름은 앱 화면의 영어 표기를 그대로 사용합니다.

STEP 01 / IMPORT

서버 추가 또는 기존 구독 가져오기

먼저 가진 정보가 구독 주소인지, 개별 서버 정보인지, QR 코드인지 확인합니다. 한 번에 한 가지 방법만 사용해 중복으로 가져온 항목 중 잘못된 것을 선택하지 않도록 하세요.

기존 구독이 있는 경우: Subscribe 항목 확인

Shadowrocket을 열고 Config 페이지에서 Subscribe 관련 항목을 찾습니다. 본인이 보유한 전체 구독 링크를 해당 주소 입력란에 붙여 넣고 확인한 뒤 가져오기 또는 업데이트를 실행합니다. 현재 화면에서 Add Server를 통해 Subscribe 유형을 추가할 수 있다면 그 항목에 같은 정보를 입력하세요. 화면 배치가 달라도 Subscribe 표시와 실제 입력란을 기준으로 확인하고, 구독 주소를 개별 서버의 Host에 입력하지 마세요.

주소를 복사할 때는 물음표 뒤의 매개변수까지 전체 내용을 유지하세요. 메신저에서 생긴 줄바꿈, 앞뒤 공백, 잘려 나간 끝부분 때문에 정상적인 주소를 인식하지 못할 수 있습니다. 주소는 개인 설정 정보이므로 공개 페이지에 게시하거나 문제 해결을 이유로 모르는 사람에게 함부로 보내지 마세요. 가져오기가 끝나면 Home으로 돌아가 SERVER 그룹에 항목이 표시되는지 확인합니다. 먼저 이름과 개수의 변화를 살펴본 뒤 다음 단계로 진행하세요.

기존 서버 정보가 있는 경우: Add Server 사용

Home의 SERVER 그룹에서 Add Server를 누르고 Type을 선택한 뒤 Host, Port와 해당 인증 정보를 차례로 입력합니다. 공식 스크린샷에는 Password와 Method가 포함된 입력 방식이 표시되어 있습니다. 다른 Type을 선택하면 입력 항목이 달라질 수 있으므로 스크린샷이 모든 프로토콜에 공통으로 적용되는 양식이라고 생각하지 마세요. Host에는 서버 주소를, Port에는 해당 포트를 입력하고 인증 방식과 암호화 매개변수는 보유한 정보를 기준으로 정확히 확인합니다.

정보에 TLS, SNI 또는 다른 전송 설정이 포함되어 있다면 해당 옵션을 열어 확인하세요. 주소와 포트만 입력했다고 설정이 완료된 것은 아닙니다. 익숙한 방식이라는 이유로 Method를 바꾸거나 테스트를 통과시키려고 인증서 확인 설정을 임의로 변경하지 마세요. 입력 후 저장하고 Home으로 돌아와 해당 항목을 다시 열어 중요한 정보가 빠지지 않았는지, 다른 유형으로 자동 인식되지는 않았는지 확인합니다.

QR 코드와 클립보드: 가져온 뒤에도 내용 확인

QR 코드가 있다면 Scan QR Code를 사용하고 시스템 안내에 따라 필요한 권한을 허용하세요. QR 코드에는 인식할 수 있는 설정 정보가 들어 있어야 합니다. 개별 설정 링크가 있다면 복사한 뒤 앱의 클립보드 인식 안내를 통해 가져올 수 있습니다. Import from Cloud JSON은 해당 JSON 설정 정보를 위한 기능이며, 임의의 구독 주소를 대신 가져오는 기능이 아닙니다. 형식을 알기 어렵다면 정보에 포함된 설명부터 확인하고 같은 내용을 여러 항목에서 반복해서 시도하지 마세요.

이 단계의 완료 기준은 ‘항목이 저장되어 매개변수를 확인할 수 있음’이지 ‘네트워크를 사용할 수 있음’이 아닙니다. 구독에는 여러 서버가 포함될 수도 있고, 서버 목록만 제공되며 트래픽 분할 규칙은 포함되지 않을 수도 있습니다. 다음으로 Global Routing 방식을 정한 뒤 목록에서 사용할 서버를 선택하세요. 구독 업데이트가 실패했지만 기존 항목이 남아 있다면 비교 자료를 잃지 않도록 현재 상태를 먼저 보존하세요.

Type, Host, Port, Password, Method 및 Scan QR Code 항목이 표시된 Shadowrocket 공식 Add Server 화면
Add Server 입력 항목은 Type에 따라 달라집니다. 그림은 항목을 확인하기 위한 것으로, 모든 프로토콜이 같은 매개변수를 사용한다는 뜻은 아닙니다.

STEP 02 / GLOBAL ROUTING

Global Routing 처리 방식 선택

서버는 프록시 요청에 사용할 연결을 정하고, Global Routing은 요청을 어떤 방식으로 처리할지 결정합니다. 두 설정은 서로 다릅니다.

Home으로 돌아가 Global Routing을 눌러 현재 선택을 확인합니다. 세 가지 모드는 Config, Proxy, Direct입니다. 연결 스위치가 켜져 있는지만 보고 라우팅이 올바르다고 판단하지 마세요. 스위치가 켜져 있어도 Direct 모드나 규칙의 DIRECT에 따라 관련 요청이 직접 접속할 수 있습니다. 테스트를 시작하기 전에 현재 모드를 기록해 두면 결과를 비교하기 쉽습니다.

Config: 현재 설정의 규칙 사용

Config를 선택했다면 Config 페이지에서 현재 적용 중인 설정 파일을 확인한 뒤 Rule 섹션을 살펴봅니다. 공식 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 설정 편집 섹션이며, 처음 연결할 때 모두 하나씩 켜야 하는 항목이 아닙니다. 처음에는 Rule 내용과 현재 설정을 확인하는 데 집중하세요. 관련 없는 항목을 불필요하게 수정하거나 연결 확인을 위해 HTTPS Decryption을 활성화할 필요는 없습니다.

규칙은 일반적으로 위에서 아래로 일치 여부를 확인하고, 일치하면 지정된 정책을 적용합니다. 예를 들어 DOMAIN-SUFFIX는 도메인 접미사를 기준으로 일치시키고, DIRECT는 직접 접속, PROXY는 프록시 정책 적용, REJECT는 요청 거부를 뜻합니다. FINAL은 앞선 규칙에 모두 일치하지 않을 때 적용되는 기본 처리입니다. 아래 내용은 구문 예시일 뿐, 현재 네트워크에 맞춘 완성된 설정이 아닙니다. 이해를 위한 예시이므로 현재 파일을 교체할 때 그대로 복사하지 않아도 됩니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

Proxy와 Direct: 명확한 비교를 위한 모드

Proxy를 선택하면 현재 모드의 처리 대상 요청이 프록시 경로를 사용합니다. 서버 연결이 정상인지 잠시 비교할 때 유용하지만 모든 웹사이트에 접속할 수 있다는 뜻은 아닙니다. Direct는 직접 접속을 비교할 때 사용하며 서버가 유효한지 확인하는 용도로는 적합하지 않습니다. 모드를 바꿀 때는 이 설정만 변경하고 같은 웹페이지에서 다시 테스트해야 규칙과 프록시 연결 중 어느 쪽에 문제가 있는지 구분할 수 있습니다.

Proxy에서는 접속되지만 Config에서 같은 웹페이지가 열리지 않는다면 구독을 바로 다시 가져오기보다 현재 설정에서 일치한 규칙과 정책을 확인하세요. 두 모드 모두 실패하면 연결 상태와 서버 매개변수를 점검합니다. 비교가 끝나면 평소 사용할 모드로 되돌리세요. 규칙 순서, 정책, DNS에 관한 자세한 내용은 용어 설명과 문제 해결 안내를 참고하세요. 이 안내에서는 복잡한 설정을 더 다루지 않습니다.

General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시된 Shadowrocket 공식 Config 설정 편집 화면
Config 편집 화면에서는 설정 섹션을 확인할 수 있으며, Global Routing 선택 항목은 Home에 있습니다.

STEP 03 / CONNECT

서버를 선택하고 연결 스위치 켜기

먼저 사용할 항목을 선택한 다음 상단 스위치를 조작하세요. 처음 연결할 때는 시스템의 VPN 구성 승인이 필요합니다.

Home의 SERVER 그룹에서 이번에 사용할 서버를 선택하고 선택 표시가 올바른 항목에 있는지 확인하세요. 구독에 이름이 비슷한 서버가 여러 개 있다면 이름만 보고 판단하지 말고 상세 정보를 열어 주소와 유형을 확인합니다. 그런 다음 Global Routing을 다시 확인해 앞서 세운 테스트 계획과 일치하는지 살펴보고 Home 상단의 연결 스위치를 켭니다.

연결 전에는 Not Connected와 같은 상태 문구가 표시될 수 있습니다. 처음 연결을 켜면 Shadowrocket이 VPN 구성을 추가하도록 요청한다는 시스템 안내가 표시될 수 있습니다. 이 단계는 앱에서 사용할 시스템 네트워크 구성을 기기에 설정하는 과정이며, 구독을 가져오거나 서버 정보를 자동으로 채우는 과정은 아닙니다. 현재 작업에 따른 요청인지 확인한 뒤 허용하고 기기 인증을 완료하세요. 그런 다음 앱으로 돌아와 상태를 확인합니다.

앞서 승인을 취소했다면 Home으로 돌아가 스위치를 다시 켜고 안내가 다시 표시되는지 확인하세요. 스위치가 곧바로 꺼지거나 상태가 바뀌지 않으면 시스템 설정의 VPN 구성에서 관련 항목이 있는지 확인합니다. 시스템 버전에 따라 설정 메뉴의 위치가 다를 수 있으므로 시스템 설정 검색에서 VPN을 찾아보세요. 기존 구성을 기록하지 않은 상태에서 여러 항목을 한꺼번에 삭제하지 마세요.

iPhone과 iPad의 시스템 승인 방식은 같지만 화면이 넓은 기기에서는 목록과 상세 정보의 배치가 다를 수 있습니다. 판단 기준은 선택한 서버, 현재 Global Routing, 연결 상태이며 버튼이 화면 어디에 있는지는 중요하지 않습니다. 조직에서 관리하는 기기라면 일부 네트워크 권한이 관리 정책의 제한을 받을 수 있습니다. 먼저 기기 관리 요구 사항을 확인하고 시스템 권한 문제를 해결하려고 서버 정보를 반복해서 바꾸지 마세요.

상단 상태가 바뀌었다는 것은 앱과 시스템의 연결 과정이 진행되었다는 뜻일 뿐, 특정 웹페이지가 정상적으로 열린다는 증거는 아닙니다. 스위치를 켠 직후 연속해서 누르면 연결과 해제 작업이 겹칠 수 있으니 피하세요. 상태가 바뀔 때까지 기다리고 현재 서버와 모드를 유지한 다음 Connectivity Test와 실제 접속으로 각각 확인합니다.

Not Connected, Global Routing, Connectivity Test, SERVER 그룹 및 Add Server가 표시된 Shadowrocket 공식 Home 화면
Home에서 연결 상태, Global Routing, 서버 선택을 한눈에 확인할 수 있습니다. 선택 내용을 확인한 뒤 상단 스위치를 켜세요.

STEP 04 / VALIDATE

테스트와 실제 접속으로 결과 확인

‘스위치가 켜짐’, ‘테스트 응답이 있음’, ‘웹페이지에 접속할 수 있음’을 각각 기록하세요. 하나의 결과를 전체 상태로 간주하지 않도록 주의합니다.

먼저 Connectivity Test 실행

방금 선택한 서버와 모드를 유지한 채 Home에서 Connectivity Test를 누르고 결과가 표시되는지 확인합니다. 테스트 시간 초과는 문제 해결의 단서이지만 모든 서비스 요청이 실패한다는 뜻은 아닙니다. 테스트에 응답이 있어도 인증, DNS, 규칙, 대상 웹사이트가 모두 정상이라고 단정할 수 없습니다. 테스트 방식과 대상에 따라 결과가 달라질 수 있으니 우선 현재 상태를 기록하고, 이를 근거로 모든 항목을 한꺼번에 삭제하지 마세요.

그다음 브라우저를 열어 평소 이용하며 현재 필요한 웹페이지에 접속합니다. 페이지가 끝까지 로드되는지 확인하고 일반 링크도 계속 열리는지 살펴보세요. 캐시에 저장된 홈페이지만 표시되는 것으로는 새 요청이 확인되지 않으므로 페이지를 새로고침하거나 같은 사이트의 다른 페이지를 열어보세요. 앱 안에 캐시된 화면만 보고 네트워크가 복구되었다고 판단하지 마세요.

웹페이지에는 접속되지만 특정 앱 기능이 작동하지 않는다면 현재 설정을 유지하고 문제가 발생한 앱, 작업, 네트워크 환경을 각각 기록하세요. 개별 서비스 문제는 로그인 상태나 대상 서비스의 상태 등 다른 요인의 영향을 받을 수 있으므로 모든 이상을 곧바로 서버 연결 문제로 돌리지 마세요. 같은 네트워크에서 같은 작업을 반복해 증상이 재현되는지 확인한 뒤 문제 해결을 진행합니다.

결과가 현재 모드와 일치하는지 확인

Config에서 특정 웹페이지가 열려도 DIRECT 규칙이 적용되었을 수 있으므로, 접속에 성공했다는 사실만으로 프록시 경로가 작동한다고 볼 수 없습니다. 프록시 경로를 확인하려면 앞 단계의 방법대로 잠시 Proxy로 전환한 뒤 같은 서버와 네트워크에서 같은 대상에 접속하세요. 비교가 끝나면 원래 모드로 되돌리고 두 결과가 달랐는지 기록합니다.

앱의 연결 기록을 확인할 수 있다면 요청 도메인과 적용된 정책을 함께 살펴보세요. 현재 문제와 관련된 부분만 기록하면 됩니다. 규칙에 PROXY가 있어도 모든 요청이 해당 행과 일치하는 것은 아니며, 앞선 규칙에서 이미 처리되었을 수 있습니다. ‘테스트는 정상이지만 특정 도메인에 접속할 수 없는’ 경우에는 연결을 반복해서 켰다 끄기보다 먼저 규칙 적용 여부와 DNS를 구분한 뒤 대상 자체를 확인하세요.

이 단계의 완료 기준은 사용한 서버, Global Routing 모드, 실제 접속 결과를 설명할 수 있는 것입니다. Wi-Fi와 셀룰러 네트워크를 비교하려면 먼저 한 조건에서 기록을 마친 다음 네트워크를 바꾸고 같은 절차를 반복하세요. 테스트 도중 서버, 네트워크, 모드를 동시에 바꾸면 결과를 비교하기 어렵습니다.

STEP 05 / SETTINGS & DIAGNOSTICS

실패한 단계에 따라 설정 확인

먼저 어느 단계에서 실패했는지 찾은 다음 해당 항목만 조정하세요. Settings는 확인을 위한 메뉴이지, 모든 항목을 변경하라는 목록이 아닙니다.

가져오기 실패: 정보와 입력 항목 확인

항목이 생성되지 않았다면 먼저 정보 유형과 가져오기 항목이 맞는지 확인한 뒤 링크의 전체 내용, 유효 상태, 현재 일반 네트워크를 점검하세요. 구독 주소가 열려도 인식 가능한 설정 내용이 반환된다는 보장은 없습니다. 로그인 페이지, 오류 메시지, 빈 내용이 표시되면 가져오기에 실패할 수 있습니다. 구독의 비공개 매개변수가 포함된 화면을 공개하지 마세요. 정보의 유효성을 확인해야 한다면 기존 서비스를 제공한 곳에 문의하세요.

스위치가 켜진 상태를 유지하지 못하는 경우: 시스템 승인 확인

연결 단계로 돌아가 시스템의 VPN 구성 승인이 완료되었는지 확인하고, 실행 중인 다른 VPN 연결이 현재 작업에 영향을 주는지도 살펴보세요. 시스템 VPN 구성을 삭제했다면 앱에서 다시 승인을 요청할 수 있습니다. 먼저 현재 구성과 안내 문구를 기록한 뒤 시스템 절차에 따라 처리하세요. 재설치를 첫 번째 해결 방법으로 선택하지 마세요. 특히 재설치 전에 기존 설정을 복구할 수 있는지 확인해야 합니다.

테스트 시간 초과 또는 웹페이지 접속 실패: 테스트와 연결을 따로 확인

Settings에서 Test Method를 열어 현재 테스트 방식을 확인한 다음 같은 조건에서 다시 테스트합니다. 특정 테스트 방식으로 결과가 나오지 않으면 실제 접속 결과도 함께 확인하세요. 특정 테스트 수치만을 유일한 판단 기준으로 삼지 마세요. 실제 접속도 여러 번 실패한다면 Add Server로 돌아가 Type, Host, Port, 인증 및 TLS 관련 매개변수를 확인합니다. 원래 받은 정보를 기준으로 하나씩 대조하고 포트나 비밀번호를 임의로 바꾸지 마세요.

Proxy에서는 정상인데 Config에서 실패한다면 현재 설정의 Rule과 DNS를 먼저 확인하세요. 네트워크를 바꾼 뒤에만 문제가 생긴다면 Wi-Fi와 셀룰러 네트워크에서의 차이를 기록하고 네트워크 연결 상태를 점검합니다. Settings의 Proxy, TCP, UDP 등은 각각 용도가 다르므로 처음 문제를 해결할 때 모두 조정하지 않는 것이 좋습니다. 기본값이나 기존 설정을 유지하면 결과를 바꾼 항목을 찾기 쉽습니다.

자동 연결 및 진단: 기록한 뒤 확인

수동으로 연결을 끊은 뒤 다시 연결된다면 Settings에서 On Demand 상태와 현재 조건을 확인하세요. On Demand는 조건에 따라 연결을 시작하는 기능입니다. 첫 확인 단계에서는 기존 값을 기록하고, 필요하다면 잠시 끈 뒤 수동 연결을 비교해 보세요. 테스트가 끝나면 필요에 따라 원래 설정으로 되돌립니다. 자동 연결을 상단 스위치의 오작동으로 오해하지 말고, 수동 연결이 확인되기 전에 복잡한 조건을 추가하지 마세요.

추가 단서가 필요하면 Diagnostics에서 현재 작업과 관련된 진단 정보를 확인하세요. 실패한 단계, 네트워크 유형, 모드, 오류 원문, 재현 방법을 기록하면 됩니다. 스크린샷이나 로그를 다른 사람에게 전달하기 전에는 구독 주소, 비밀번호, 인증 정보, 개인 네트워크 정보를 가리세요. 로그는 원인을 좁히는 데 도움이 되지만 전체 설정을 공개할 필요는 없습니다.

여전히 원인을 찾기 어렵다면 증상에 따라 연결 문제 해결 안내를 참고하세요. 구매, 승인, 기본 조작에 관한 질문은 FAQ에서, 입력 항목의 의미는 용어 설명에서 확인할 수 있습니다. 이번 테스트의 서버, 모드, 결과를 기록해 두면 자세한 문제 해결을 시작할 때 같은 단계를 처음부터 반복하지 않아도 됩니다.

Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP가 표시된 Shadowrocket 공식 Settings 화면
Settings에서 Test Method, On Demand, Diagnostics를 먼저 확인하세요. 문제를 해결할 때 여러 설정을 동시에 변경하지 마세요.