공식 매뉴얼 · 첫 연결 절차
Shadowrocket 사용법
기존 설정 추가 → Global Routing 선택 → 연결 및 확인
iPhone과 iPad에서 사용할 수 있습니다. 먼저 확인 가능한 연결을 한 번 완료한 다음 규칙, On Demand 및 기타 설정을 조정하세요. 화면에서 메뉴 위치는 공식 App Store 스크린샷을 참고하며, 실제 화면은 앱의 현재 버전에 따라 다를 수 있습니다.
01 · Add Server: 추가 및 가져오기
먼저 보유한 정보의 유형을 확인합니다. 서버 주소, 포트, 인증 정보를 알고 있다면 직접 입력하고, 구독 링크가 있다면 Subscribe를 이용하세요. 인식 가능한 설정 QR 코드가 있다면 Scan QR Code로 가져올 수 있습니다. 세 가지 방법을 모두 사용할 필요는 없으며, 보유한 정보에 맞는 방법 하나를 선택하면 됩니다. 구독 링크에 접속 정보가 포함될 수 있으므로 전체 링크를 공개 페이지나 공개 게시물에 올리지 마세요.
서버 정보 직접 입력
Shadowrocket에서 Home을 열고 SERVER 그룹의 Add Server로 이동합니다. Type을 누르고 보유한 정보에 명시된 프로토콜 유형을 선택한 다음 표시되는 항목을 입력합니다. Shadowsocks를 예로 들면 Host, Port, Password, Method를 확인하세요. Host는 서버 도메인 또는 주소, Port는 연결 포트입니다. Password와 Method는 보유한 정보와 각각 일치해야 합니다. 항목의 모양만 보고 값을 추측하지 말고, 공유 링크 전체를 Host에 입력하지도 마세요.
Type에 따라 입력 항목은 서로 다릅니다. VLESS, VMess, Trojan 등을 선택했다면 해당 인증 정보와 보유 자료에 명시된 전송 및 TLS 매개변수도 확인해야 합니다. 근거가 되는 정보가 없는 항목은 저장을 위해 임의의 값을 넣지 말고 원래 정보를 제공한 곳에 확인하세요. 입력을 마치면 페이지의 저장 기능으로 Home에 돌아와 새 항목이 목록에 표시되는지 확인한 다음 사용할 항목을 선택합니다. 저장이 완료되었다는 것은 정보 입력이 끝났다는 뜻일 뿐, 서버에 연결할 수 있다는 의미는 아닙니다.
Subscribe로 기존 구독 가져오기
구독 링크가 있다면 Add Server로 이동해 Type에서 Subscribe를 선택하고 전체 링크를 URL에 입력합니다. 필요하다면 알아보기 쉬운 메모도 추가하세요. 링크를 복사할 때 앞뒤가 잘렸는지 확인하고 안내 문구, 공백 또는 줄바꿈이 섞이지 않도록 합니다. 여기에 입력하는 것은 이미 보유한 구독 주소이지 일반 웹페이지 주소나 개별 서버의 Host가 아닙니다. 저장한 뒤 Home으로 돌아가 구독 정보가 로드될 때까지 기다리고 해당 그룹과 항목이 표시되는지 확인합니다.
구독 이름만 보이고 선택할 항목이 없다면 먼저 업데이트가 완료되었는지 확인한 다음 링크의 유효성과 해당 주소에 접속할 수 있는 기본 네트워크 상태를 점검하세요. 구독 업데이트는 서버 목록을 다시 가져오는 기능이며 Config의 규칙 파일을 업데이트하는 것과는 다릅니다. 이후 내용을 새로 가져오려면 해당 구독의 관리 메뉴에서 업데이트를 실행합니다. 직접 추가한 항목과 구독 항목을 구분해 잘못된 대상을 수정하지 않도록 주의하세요.
Scan QR Code 사용
Add Server 페이지에서 Scan QR Code를 선택하고 시스템 안내에 따라 카메라 권한을 허용한 다음 보유한 설정의 QR 코드를 스캔합니다. 인식이 완료되면 저장하기 전에 Type, Host, Port 등의 정보가 예상한 내용과 일치하는지 확인하세요. QR 코드에도 인증 정보가 포함될 수 있으므로 스크린샷을 공유하거나 도움을 요청할 때는 코드 전체를 가리세요. Import from Cloud JSON은 별도의 가져오기 메뉴이므로 해당 형식의 자료를 실제로 보유한 경우에만 사용하면 됩니다. 첫 연결을 위해 추가 작업을 할 필요는 없습니다.
이 단계의 완료 기준은 Home에 선택 가능한 서버 항목이 있고 그 매개변수가 원래 자료와 일치하는 것입니다. 다음으로 트래픽 처리 방식을 정한 뒤 연결을 켜세요. 항목이 없는 상태에서 상단 스위치만 반복해서 켜고 끄지 마세요.
02 · Global Routing: 모드 선택
Home으로 돌아가 Global Routing을 눌러 현재 모드를 확인합니다. 여기서는 클라이언트가 요청을 처리하는 방식을 정하며 서버 프로토콜을 선택하는 메뉴가 아닙니다. 세 가지 모드는 Config(설정)/Proxy(프록시)/Direct(직접 연결)입니다. 먼저 이번에 확인할 내용을 정한 뒤 적절한 모드를 선택하세요. 모드를 바꿔도 서버 매개변수가 자동으로 수정되거나 구독 내용이 변경되지는 않습니다.
Config: 현재 설정에 따라 요청 처리
평소 규칙에 따라 요청의 처리 경로를 구분하려면 Config를 선택합니다. 그런 다음 Config로 이동해 실제 활성화된 설정 파일을 확인하세요. 목록에 파일 이름이 있는지만 확인해서는 안 됩니다. 설정 파일에는 General, Rule, Hosts 등의 섹션이 포함될 수 있으며, 스크린샷에는 URL Rewrite, HTTPS Decryption 메뉴도 표시됩니다. 처음 사용할 때 이 메뉴를 하나씩 모두 활성화할 필요는 없으며, 연결을 위해 잘 모르는 내용을 추가할 필요도 없습니다.
Rule에서는 규칙의 순서가 일치 결과에 영향을 줍니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 도메인 접미사로 일치하는 요청을 PROXY로 처리한다는 뜻입니다. DIRECT는 직접 연결로 처리합니다. 앞선 규칙에 일치하지 않는 경우에는 설정의 최종 처리 방식도 확인해야 합니다. 처음 확인할 때는 출처가 명확하고 내용을 이해할 수 있는 기존 설정을 우선 사용하세요. 규칙을 조정할 근거가 있을 때 Add Rule을 이용하면 됩니다. 프로토콜 항목과 규칙은 역할이 다릅니다. 자세한 내용은 프로토콜 참고 안내를 확인하세요.
Proxy: 선택한 프록시 경로 확인
Proxy를 선택하면 클라이언트가 처리하는 요청을 해당 모드에 따라 프록시로 보냅니다. 이를 통해 문제가 Config의 분기 규칙과 관련 있는지 확인할 수 있습니다. 모드를 바꾼 뒤에도 Home에서 선택된 서버가 무엇인지 확인하고 테스트 요청을 다시 보내세요. Proxy가 속도 향상을 보장한다고 이해해서는 안 됩니다. 기본 네트워크, 서버 상태, 대상의 응답, 프로토콜 매개변수가 모두 결과에 영향을 줍니다.
Direct: 기본 접속과 비교
Direct를 선택하면 요청은 직접 연결로 처리되며, 선택한 서버를 프록시 경로로 사용하지 않습니다. 다른 모드와 비교할 때 유용하지만 시스템 VPN 구성을 끄는 것과는 다릅니다. 클라이언트 연결을 중지하려면 Home 상단의 연결 스위치를 사용하세요. 테스트가 끝나면 원래 사용하려던 모드로 돌아가 선택한 내용을 기록합니다. 문제 해결을 위해 임시로 바꾼 모드를 평소 설정으로 착각하지 않도록 하세요.
이 단계를 마치기 전에 두 가지를 확인할 수 있어야 합니다. 현재 Global Routing에서 어떤 모드를 선택했는지, Config를 선택했다면 실제로 어느 설정 파일을 사용 중인지 확인하세요. 두 항목을 확인한 다음 시스템 권한을 승인하고 연결합니다.
03 · Home: 권한 승인 및 연결 시작
Home으로 돌아와 먼저 SERVER 그룹에서 선택된 항목을 확인한 다음 Global Routing을 확인합니다. 두 항목이 올바르면 상단의 연결 스위치를 켭니다. 공식 스크린샷에 표시된 Not Connected는 촬영 당시 연결되지 않은 상태를 뜻하는 문구이며 입력해야 하는 매개변수가 아닙니다. 연결하는 동안 앱의 상태 변화를 확인하세요. 짧은 시간 안에 스위치를 반복해서 켜고 끄면 어떤 조작이 현재 결과를 만들었는지 파악하기 어려울 수 있습니다.
처음 VPN 구성 추가하기
처음 연결을 활성화할 때 시스템에서 VPN 구성 추가를 요청할 수 있습니다. 안내 창을 확인하고 요청을 보낸 앱이 현재 사용 중인 Shadowrocket인지 확인한 다음 시스템 절차에 따라 허용하고 기기 인증을 완료합니다. 이 권한은 앱이 시스템의 네트워크 기능을 통해 연결을 처리하도록 허용하는 것이며, 서버를 만들어 주거나 구독 정보를 채우거나 잘못된 매개변수를 수정해 주지는 않습니다. 권한을 승인한 뒤 앱으로 돌아와 연결이 완료되었는지 확인하세요. 연결되지 않았다면 화면의 상태를 확인한 뒤 다시 시도합니다.
이전에 요청을 취소했다면 앱으로 돌아와 연결을 다시 시작하고 시스템 확인 창이 다시 표시되는지 살펴보세요. 시스템에서 해당 구성을 삭제한 경우에도 앱과 시스템 안내에 따라 다시 설정해야 합니다. 시스템 설정에 VPN 항목이 있다는 이유만으로 연결이 성공했다고 판단하지 마세요. 구성의 존재 여부, 연결 스위치 상태, 대상 요청의 작동 여부는 각각 확인해야 합니다.
연결 후에는 현재 설정 유지
앱에 연결됨이 표시되면 바로 다른 옵션을 활성화하지 마세요. 현재 서버, Global Routing, 설정 파일을 그대로 유지하고 다음 단계에서 실제 접속을 확인합니다. 이렇게 하면 문제가 생겼을 때 확인된 설정을 기준으로 원인을 찾을 수 있습니다. iPad에서는 화면 배치에 따라 목록과 세부 정보의 위치가 달라질 수 있지만, 항목을 선택한 뒤 모드를 확인하고 마지막으로 연결을 활성화하는 순서는 같습니다.
스위치가 즉시 꺼지거나 연결 중 상태가 오래 지속된다면 같은 항목을 계속 새로 만들지 말고 설정 및 문제 해결로 이동해 시스템 권한과 다른 연결의 영향을 확인하세요. 연결 상태가 되면 Connectivity Test와 브라우저 확인을 진행합니다.
04 · Connectivity Test: 작동 확인
Home으로 돌아가 Connectivity Test를 실행하고 현재 항목의 테스트 결과를 살펴봅니다. 테스트 결과는 Settings의 Test Method와 관련이 있으며, 테스트 방식에 따라 확인하는 단계가 다릅니다. 응답 시간 값이 표시되어도 해당 테스트에서 응답을 받았다는 의미일 뿐 모든 웹페이지, 앱 또는 프로토콜 트래픽이 정상 작동한다고 단정할 수 없습니다. 반대로 테스트가 한 번 시간 초과되었다고 해서 비밀번호 오류로 바로 판단할 수도 없습니다. 실제 접속과 함께 확인하세요.
그다음 브라우저를 열어 익숙하고 결과를 확인할 수 있는 웹페이지에 접속한 뒤 새로고침합니다. 이미 캐시된 페이지를 보는 데 그치지 않도록 새 요청을 보내세요. 이어서 별개의 대상에도 접속해 비교합니다. 한 웹사이트만 실패한다면 해당 사이트 자체, 관련 규칙 또는 이름 해석 문제를 먼저 살펴보세요. 여러 대상에서 모두 실패한다면 서버, 모드, 기본 네트워크를 다시 확인합니다. 테스트 중에는 서버와 설정을 동시에 바꾸지 마세요. 결과를 비교하기 어려워집니다.
Config를 사용 중이라면 확인 가능한 연결 기록에서 대상 도메인과 일치한 규칙, 정책 또는 처리 결과를 살펴보세요. DIRECT로 처리되어야 하는 요청이 프록시를 사용하지 않는 것은 반드시 오류가 아닙니다. PROXY로 처리되어야 하는 요청이 다른 방식으로 처리된다면 활성화된 Config와 규칙 순서를 확인해야 합니다. 기록 메뉴와 항목은 현재 앱에 표시되는 내용을 기준으로 확인하고, 시스템 VPN 표시 하나만으로 트래픽 분기 결과를 판단하지 마세요.
이번 확인에 사용한 서버 메모, 모드, 설정 파일 이름을 기록해 두면 좋습니다. 인증 정보 전체를 기록하거나 공개하지 마세요. 다른 서버를 테스트하려면 우선 서버만 바꾼 뒤 같은 접속 절차를 반복합니다. 테스트 결과를 더 자세히 이해하려면 문제 해결 안내를 확인하고, 지연 시간 테스트, DNS 확인, 실제 콘텐츠 접속을 같은 지표로 혼동하지 마세요.
05 · Settings: 설정 및 문제 해결
문제가 발생하면 아래 순서대로 범위를 좁혀 보세요. 매번 조건 하나만 바꾸고 같은 대상을 다시 테스트한 뒤 결과를 기록합니다. Settings에는 Test Method, On Demand, Diagnostics, Proxy, TCP, UDP 등의 설정 메뉴가 있지만, 메뉴가 있다고 해서 전부 조정해야 하는 것은 아닙니다. 처음 연결할 때는 기본 조건부터 확인하고 필요한 경우에만 더 세부적인 매개변수를 살펴보세요.
먼저 기본 네트워크 문제와 설정 문제 구분
- 기본 네트워크: 앱 연결을 끄고 현재 Wi-Fi 또는 셀룰러 네트워크에서 원래 접속할 수 있던 페이지가 열리는지 확인합니다. 네트워크에 접속하기 전에 로그인이 필요하다면 먼저 로그인한 뒤 다시 연결하세요.
- 가져온 정보: Home에 실제 서버 항목이 있는지 확인합니다. 구독 업데이트 실패와 서버 연결 실패는 서로 다른 단계의 문제입니다. 먼저 목록을 가져오는 문제를 해결한 다음 목록에 있는 항목을 테스트하세요.
- 매개변수 및 선택 항목: Type, Host, Port, 인증 정보와 자료에 명시된 다른 항목을 확인하고, 실제로 확인한 항목을 테스트 중인지도 살펴봅니다.
- 모드 및 설정: Global Routing을 확인합니다. Config를 사용한다면 현재 설정 파일을 확인하세요. 필요한 경우 비교를 위해 Proxy로 잠시 전환한 뒤 테스트가 끝나면 원래 모드로 되돌립니다.
- 시스템 연결: 권한이 승인되었는지, 앱에 연결 상태가 유지되는지, 다른 VPN 연결이 현재 세션에 영향을 주는지 확인합니다. 충돌하는 연결을 먼저 중지한 다음 다시 확인하세요.
테스트는 응답하지만 웹페이지가 열리지 않음
먼저 별개의 대상을 확인하고, 특정 도메인에서만 실패하는지 살펴봅니다. DNS 확인, 규칙 일치, 대상 서비스 응답, 테스트 방식과 실제 요청의 차이 등이 관련될 수 있습니다. 모든 문제를 DNS 탓으로 돌리거나 모든 DNS 설정을 한꺼번에 바꾸지 마세요. 현재 Config의 관련 설정과 기록을 먼저 확인한 뒤 근거를 바탕으로 하나만 수정하고 다시 테스트합니다. 자세한 문제 해결은 규칙 분기 및 문제 해결 안내를 확인하세요.
On Demand: 기본 연결이 안정된 뒤 설정
On Demand는 설정한 조건에 따라 연결 동작을 실행하는 기능으로, Home 스위치를 수동으로 켜는 것과는 다릅니다. 처음 사용할 때는 수동 연결과 확인을 완료한 뒤 Settings에서 On Demand 조건을 살펴보세요. 수동으로 연결을 끊은 뒤 다시 자동 연결된다면 서버를 반복해서 삭제하는 대신 이 설정을 확인해야 합니다. 설정을 변경한 뒤에는 조건에 해당하는 경우와 해당하지 않는 경우를 각각 살펴 동작이 예상대로인지 확인하세요.
Diagnostics 사용 및 연결 정보 보호
문제를 더 자세히 확인해야 한다면 Settings의 Diagnostics에서 사용할 수 있는 진단 메뉴를 살펴볼 수 있습니다. 단순히 “작동하지 않음”이라고만 적기보다 발생한 현상, 네트워크 유형, 선택한 모드, 특정 대상에서만 실패하는지를 기록하면 원인을 판단하는 데 도움이 됩니다. 스크린샷이나 기록을 다른 사람에게 제공하기 전에 구독 링크 전체, 인증 항목, QR 코드 및 기타 개인 정보를 가리세요. 문제 해결을 위해 설정 파일 전체를 공개하지 마세요.
설정을 변경한 뒤 문제가 악화되었다면 먼저 이전에 확인한 설정으로 되돌린 다음 항목별로 다시 시도하세요. 정상적으로 연결되면 여기서 마쳐도 됩니다. 필요에 따라 프로토콜 참고 안내와 설정 안내를 확인하세요. 이 안내의 목표는 명확하고 반복 가능한 사용 절차를 만드는 것이며, 처음부터 모든 옵션을 바꾸는 것이 아닙니다.
