공식 매뉴얼 · 첫 연결 절차
Shadowrocket 사용법구독 가져오기, 모드 선택 및 연결 확인
iPhone / iPad 화면을 기준으로 기존 정보를 준비해 추가와 연결을 차례로 진행합니다. 각 단계의 결과를 확인한 다음 진행하면 여러 설정을 동시에 조정하는 일을 피할 수 있습니다.
01정보 추가02모드 선택03연결04–05확인 및 문제 해결
정보를 확인하기 쉬운 곳에 준비한 뒤 앱을 엽니다. 구독 링크와 개별 서버 매개변수는 서로 다른 종류의 입력 정보입니다. 전자는 일반적으로 여러 항목을 가져오고 업데이트하는 데 사용되며, 후자는 특정 서버의 프로토콜, 주소 및 인증 방식을 나타냅니다. 구독 주소를 Host에 입력하거나 일반 웹 주소를 구독 링크로 사용하지 마세요. 아래 두 가지 추가 방법 중 하나만 선택하면 됩니다.
스크린샷은 화면과 필드를 구분하는 데 사용하며, 실제 표시되는 옵션은 프로토콜이나 시스템에 따라 다를 수 있습니다. 스크린샷의 항목은 사용할 수 있는 서버 정보가 아닙니다. 화면이 다르면 현재 앱에 표시된 영문 항목명을 기준으로 찾아보세요.
STEP 01 · Add Server / Subscribe
서버 추가 또는 기존 구독 가져오기
Shadowrocket을 열고 Home으로 이동한 다음 SERVER 그룹에서 Add Server를 찾습니다. 추가 화면에 들어간 뒤 다른 필드를 입력하기 전에 Type을 확인하세요. Type에 따라 항목의 종류와 입력해야 할 매개변수가 달라집니다. 완전한 구독 링크가 있다면 Subscribe 경로를 사용하고, 서버 주소와 포트 및 인증 정보가 있다면 직접 추가합니다.
기존 구독: Subscribe 선택
Add Server에서 Type을 열고 Subscribe를 선택한 뒤 돌아와 URL 필드에 전체 구독 링크를 붙여넣고 식별하기 쉬운 메모를 입력합니다. 복사할 때 링크의 앞뒤가 온전한지 확인하고, 특히 대화 내용의 문장 부호, 줄바꿈 또는 설명이 함께 들어가지 않도록 주의하세요. 링크의 쿼리 매개변수도 주소의 일부이므로 임의로 삭제하거나 수정하면 안 됩니다. 서비스 제공자가 준 정보가 구독 링크가 아니라면 먼저 정보 유형을 확인하세요.
저장한 뒤 Home으로 돌아와 구독 내용이 로드될 때까지 기다린 다음 해당 그룹과 서버 항목이 표시되는지 확인합니다. 저장 성공은 기록이 추가되었다는 뜻일 뿐, 내용이 실제로 가져와졌는지는 별도로 확인해야 합니다. 목록이 비어 있다면 원래 링크를 확인한 뒤 해당 구독을 업데이트해 보세요. 같은 구독을 여러 번 연속으로 만들면 이후 관리할 데이터 그룹을 구분하기 어려워집니다. 항목이 표시되면 기존 그룹을 유지한 채 다음 단계로 진행합니다.
기존 서버 매개변수: Type에 따라 입력
직접 추가하는 경우 정보에 따라 Shadowsocks, VMess, VLESS, Trojan 또는 해당 프로토콜을 선택합니다. Host에는 서버 도메인이나 IP를, Port에는 포트를 입력합니다. Password, Method 및 다른 인증·전송 필드는 원래 정보에 맞게 입력합니다. 예를 들어 Shadowsocks에서는 Method와 Password가 서버 설정과 일치해야 하며, 주소와 포트만으로 연결할 수 없습니다. Type마다 입력 필드가 다르므로 한 프로토콜의 입력 방법을 다른 프로토콜에 그대로 적용하지 마세요.
정보에서 TLS, 특정 전송 방식 또는 서버 이름을 요구한다면 각 항목도 확인해야 합니다. Host는 일반적으로 경로가 포함된 웹 URL이 아니므로 웹 페이지 경로를 덧붙이지 마세요. QR 코드 정보는 Scan QR Code로 읽을 수 있습니다. Import from Cloud JSON은 해당 형식의 정보를 위한 기능이며 모든 링크를 가져오는 범용 진입점은 아닙니다. 정보를 읽은 뒤에도 Type과 주요 매개변수를 확인하고 저장한 다음 Home으로 돌아갑니다.
구독 링크에는 접근 자격 증명이 포함될 수 있으므로 전체 주소를 공개하거나 링크가 모두 보이는 스크린샷을 보내지 마세요. 추가 후 파싱에 실패하면 질문과 답변 페이지의 구독 문제 해결 안내에서 형식을 확인하세요. 목록에 내용이 있는 것을 확인한 뒤 트래픽 처리 방식을 선택합니다.
STEP 02 · Global Routing / Config
Global Routing의 세 가지 모드 선택
서버 항목을 준비한 뒤 Home으로 돌아와 Global Routing을 탭합니다. 이 설정은 요청을 처리하는 방식을 결정하며 서버 암호를 수정하거나 구독을 업데이트하지는 않습니다. 처음 사용할 때는 세 가지 옵션을 이해한 뒤 목적에 맞게 선택하세요: Config, Proxy 또는 Direct. 선택 후 Home으로 돌아와 Global Routing 행에 방금 선택한 모드가 표시되는지 확인합니다.
Config: 현재 구성 규칙에 따라 트래픽 분기
Config는 현재 활성화된 구성 파일을 기준으로 요청을 일치시킵니다. Config로 이동해 사용 중인 파일을 확인하고 그 안의 규칙을 살펴보세요. 공식 스크린샷에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션이 표시된 구성 파일 편집 화면이 있습니다. 처음 연결할 때 각 섹션을 수정할 필요는 없으며, 연결을 위해 모든 기능을 활성화할 필요도 없습니다.
규칙은 순서대로 판단하며 먼저 일치한 규칙이 요청의 처리 방식을 결정합니다. 마지막에 있는 규칙은 일반적으로 앞선 규칙에 일치하지 않은 요청을 FINAL로 처리합니다. 아래는 문법 예시일 뿐, 기존 구성을 통째로 바꾸라는 뜻이 아닙니다. 자신의 구성을 사용할 때는 규칙의 대상이 현재 구성에서 올바르게 해석되는지 확인하고, 예시를 그대로 옮기기 위해 기존 설정을 덮어쓰지 마세요.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
예시에서는 example.com과 그 하위 도메인에 일치하는 요청은 PROXY를 사용하고, 나머지 일치하지 않은 요청은 FINAL에 따라 DIRECT로 처리합니다. DIRECT는 직접 연결, PROXY는 프록시를 통한 처리, REJECT는 요청 거부를 뜻합니다. 특정 웹사이트가 열리지 않을 때 모든 서버가 작동하지 않는다고 바로 판단하지 말고, 실제로 어떤 처리 규칙이 적용되었는지 먼저 확인하세요.
Proxy 및 Direct: 명확한 비교 테스트에 사용
Proxy는 일반적으로 해당 모드의 영향을 받는 요청을 선택한 프록시로 처리하므로 Config의 결과와 임시로 비교할 때 적합합니다. Proxy에서는 접속되지만 Config에서는 되지 않는다면 규칙, 정책 선택 또는 DNS 관련 설정을 먼저 확인하세요. 이 옵션은 잘못된 인증 정보를 수정하지 않으며 모든 앱의 요청이 같은 결과를 얻도록 보장하지도 않습니다.
Direct는 요청을 직접 연결로 처리하므로 현재 기본 네트워크가 정상인지 확인하는 데 적합합니다. Direct를 선택한 뒤 웹 페이지가 열린다고 해서 방금 가져온 서버를 사용할 수 있는 것은 아닙니다. 비교 테스트가 끝나면 평소 사용할 모드로 되돌리고 현재 구성 파일을 기록해 두세요. 복잡한 일치 순서나 정책을 조정해야 한다면 전체 사용 매뉴얼을 참고하세요. 이 페이지에서는 첫 연결에 필요한 판단만 다룹니다.
STEP 03 · Home / SERVER
서버를 선택하고 연결 스위치 켜기
모드를 결정한 뒤 Home으로 돌아가 SERVER 그룹에서 이번에 사용할 서버를 선택합니다. 구독이 여러 개라면 선택 표시가 어떤 항목에 해당하는지 확인하세요. 구독 그룹 이름은 관리 메뉴일 뿐, 그 안의 특정 서버가 선택되었다는 뜻은 아닙니다. 처음 확인할 때는 서버 하나만 선택하고 테스트 결과를 현재 설정과 연결해 판단할 수 있도록 연속으로 서버를 바꾸지 마세요.
Global Routing을 확인한 뒤 Home 상단의 스위치를 켭니다. 아직 연결되지 않은 상태에서는 Not Connected가 표시될 수 있습니다. 처음 활성화할 때 시스템에서 VPN 구성을 추가하라는 요청이 표시될 수 있습니다. 요청이 현재 실행 중인 Shadowrocket에서 온 것인지 확인한 뒤 시스템 안내에 따라 승인하고, 필요한 경우 기기 인증을 완료하세요. 구성 요청을 거부한 경우 구독을 다시 가져오는 것만으로 시스템 연결을 만들 수 없으므로 먼저 권한 문제를 해결해야 합니다.
Home으로 돌아와 상단 연결 상태가 바뀌었는지, 스위치가 켜진 상태로 유지되는지 확인합니다. 시스템의 VPN 표시는 터널 상태를 판단하는 데 도움이 될 수 있지만, 기기마다 상태 표시줄이 다를 수 있습니다. 앱에 표시되는 상태와 시스템 VPN 설정을 함께 확인하세요. 스위치가 바로 꺼지면 규칙 파일을 수정하지 말고 시스템 권한, 기존 VPN 구성 및 앱에서 보고한 오류부터 확인합니다.
기기에 다른 VPN 연결이나 시스템 관리 구성이 있으면 새 연결에 영향을 줄 수 있습니다. 현재 활성화된 구성이 무엇인지 먼저 확인하세요. 회사나 학교에서 관리하는 기기라면 관리 정책을 따르고 용도를 모르는 구성을 삭제하지 마세요. 또한 기본 네트워크가 작동해야 합니다. 웹 로그인을 요구하는 Wi-Fi라면 먼저 네트워크 접속 페이지에서 필요한 절차를 완료하세요.
처음 연결한 뒤 잠시 기다렸다가 테스트를 진행하세요. 구독 업데이트, 구성 변경, 네트워크 전환을 동시에 하지 마세요. 결과가 달라졌을 때 원인을 파악하기 어려워집니다. 연결을 끊으려면 Home으로 돌아가 상단 스위치를 끄면 됩니다. 다음에 사용할 때도 서버 선택과 Global Routing이 이전 문제 해결 과정에서 바뀌지 않았는지 확인하세요.
STEP 04 · Connectivity Test / Data
연결 상태와 실제 접속을 각각 확인
연결 스위치가 켜져 있으면 먼저 Home에서 Connectivity Test를 실행합니다. 테스트는 현재 테스트 방법에 따른 연결 결과를 확인하기 위한 것이며 모든 웹사이트, 프로토콜 또는 앱에 공통으로 적용되는 결론은 아닙니다. 한 번의 결과도 테스트 대상, 네트워크 변화, 테스트 방법에 영향을 받습니다. 하나의 수치만으로 구성이 올바른지 판단하지 말고, 서로 다른 방법의 결과를 그대로 비교하지도 마세요.
그런 다음 브라우저를 열고 평소 내용이 표시되는지 확인할 수 있는 페이지에 접속한 뒤 실제로 새로고침합니다. 네트워크가 바뀐 뒤에도 브라우저 캐시에 이전 페이지가 남아 있을 수 있으므로 페이지가 열려 있다는 사실만으로 이번 요청이 성공했다고 볼 수는 없습니다. 프록시를 사용해야 하는 대상과 직접 연결해야 하는 대상을 각각 확인하고, 현재 Global Routing을 다시 살펴 테스트 조건이 평소 사용할 모드와 일치하는지도 확인하세요.
Data로 보조 확인하되 누적값을 실시간 결과로 간주하지 않기
Shadowrocket으로 돌아가 Data를 확인하고 이번 접속에 해당하는 트래픽 변화가 있는지 살펴봅니다. 통계에는 집계 범위 내 다른 요청도 포함될 수 있으며 백그라운드 동기화로 트래픽이 발생할 수도 있습니다. 따라서 누적 숫자 하나를 방금 연 페이지의 정확한 사용량으로 간주해서는 안 됩니다. 현재 화면에서 서버별 조회가 가능하다면 선택된 서버와 함께 확인하세요. 특정 규칙의 일치 여부를 알아야 한다면 관련 기록과 진단 정보를 함께 확인합니다.
판단할 때는 다음 세 가지 질문을 구분하세요. 시스템 연결이 설정되었는가, 대상 요청이 완료되는가, 처리 방식이 규칙에 맞는가. 앞의 두 가지가 정상이어도 세 번째가 다를 수 있습니다. 예를 들어 Config에서 대상이 정상적으로 열리더라도 실제로는 DIRECT 규칙에 일치했을 수 있습니다. 반대로 Proxy에서는 사용할 수 있지만 Config에서는 실패한다면 같은 서버를 반복해서 추가하기보다 트래픽 분기 경로를 먼저 확인해야 합니다.
- Connectivity Test 결과는 있지만 실제 페이지가 열리지 않음: 대상, DNS 및 규칙을 확인하고 전체 연결이 정상이라고 바로 판단하지 않습니다.
- 실제 접속은 정상이지만 테스트에 실패함: 테스트 방법과 대상이 현재 네트워크에 적합한지 확인하고, 한 번의 테스트 때문에 전체 구성을 변경하지 않습니다.
- Wi-Fi와 셀룰러 네트워크를 전환한 뒤 결과가 달라짐: 서버와 모드는 그대로 두고 비교해 설정을 동시에 변경한 영향을 배제합니다.
첫 확인이 끝나면 사용할 수 있는 서버, 현재 모드 및 구성 파일 이름을 기록해 두세요. 나중에 문제가 생겼을 때 이 정보가 기준이 됩니다. 특정 테스트 수치를 얻기 위해 이미 확인된 매개변수를 자주 바꾸지 마세요. 사용에 문제가 계속되면 아래 순서에 따라 발생 위치를 확인합니다.
STEP 05 · Settings / Diagnostics
문제가 발생한 위치를 확인하고 모든 설정을 한꺼번에 초기화하지 않기
먼저 문제가 어느 단계에서 발생하는지 파악한 다음 확인할 화면을 정합니다. “구독을 불러올 수 없음”, “상단 스위치가 켜진 상태로 유지되지 않음”, “특정 웹사이트가 열리지 않음”을 모두 연결 실패로 뭉뚱그리면 확인 방향이 혼란스러워집니다. 한 번에 변수 하나만 변경하고 네 번째 단계의 확인을 다시 진행하세요. 개선되지 않으면 원래 값으로 되돌린 뒤 다음 항목을 확인해야 변경 사항을 추적하기 쉽습니다.
목록이 비어 있거나 업데이트 실패: 구독 정보 확인
링크가 완전한지, 유형이 Subscribe인지 확인하고 현재 기본 네트워크에서 업데이트가 가능한지 점검합니다. 구독 내용을 가져올 수 있는지와 그 안의 서버에 연결할 수 있는지는 별개의 문제입니다. 링크가 만료되었다면 Global Routing을 변경해도 해결되지 않습니다. 업데이트를 반복해도 서비스 제공자 측에서 사용할 수 없는 정보가 복구되지는 않습니다. 본인의 서비스 제공자에게 링크 상태, 내용 형식 및 관련 이용 상태를 확인하세요. 문의할 때 공개 페이지에 전체 자격 증명을 올리지 마세요.
항목은 있지만 연결 실패: 매개변수와 시스템 상태 확인
직접 추가한 항목은 Type, Host, Port, 인증 정보와 정보에서 요구하는 TLS 및 전송 설정을 우선 확인합니다. 구독 항목은 한 번 업데이트한 뒤 현재 용도에 맞는 것으로 확인된 서버 하나를 선택해 테스트합니다. 스위치가 바로 꺼지면 시스템 VPN 권한과 다른 활성 구성부터 확인하세요. 스위치가 켜진 상태로 유지되는데도 접속할 수 없다면 그때 서버 연결, 규칙 및 대상 접속 문제를 구분합니다. 모든 데이터를 바로 삭제하지 마세요.
테스트와 실제 접속 결과가 다름: Test Method 확인
Settings로 이동해 Test Method를 확인하고 현재 어떤 테스트 방법이 사용 중인지 살펴봅니다. 테스트 방법마다 확인하는 범위가 다르므로 테스트 결과가 반환되더라도 대상 웹사이트의 전체 요청이 검증된 것은 아닙니다. 원래 설정을 유지하면서 항목 하나씩 비교하고 실제 접속 결과와 함께 판단하세요. 특정 대상만 문제가 있다면 “작동하지 않음”이라고만 기록하기보다 도메인, 발생 시각, 현재 모드 및 오류 현상을 적어 두는 것이 원인 파악에 도움이 됩니다.
자동 연결 또는 네트워크 전환 문제: On Demand 확인
Settings의 On Demand는 조건에 따른 연결과 관련된 설정입니다. 수동으로 연결을 끈 뒤 다시 연결되거나 네트워크를 바꾼 뒤 동작이 달라진다면 해당 조건이 설정되어 있는지 먼저 확인합니다. 처음 사용할 때는 수동 연결 절차가 정상적으로 작동하는지 확인한 뒤 On Demand 동작을 설정하세요. On Demand는 서버 인증 실패를 해결하는 스위치가 아닙니다. 연결을 시도할 시점을 정할 뿐 사용할 수 있는 서버 정보를 대신하지 않습니다.
원인을 더 자세히 확인해야 한다면 Diagnostics에서 이번 작업에 해당하는 기록인지 먼저 확인한 뒤 오류 유형을 살펴봅니다. 기록을 공유하기 전에 구독 URL, 암호, 인증 식별자 및 기타 민감한 정보를 가리세요. Settings의 Proxy, TCP, UDP 등은 서로 다른 네트워크 동작과 관련되어 있으므로 이름만 보고 하나씩 전환하지 않는 것이 좋습니다. 구체적인 의미는 전체 사용 매뉴얼을, 흔한 증상과 해결 방법은 질문과 답변 페이지를 참고하세요.