공식 사용 매뉴얼 · 첫 설정
Shadowrocket 빠른 시작
서버 정보 입력, 모드 선택, 연결, 확인, 문제 해결 순서로 진행합니다. 이 문서는 iPhone과 iPad에서 처음 사용하는 경우를 대상으로 한 번의 연결 과정을 안내합니다. 규칙의 작동 방식과 복잡한 문제는 별도 페이지에서 설명합니다.
아래 스크린샷은 화면과 입력 항목을 확인하기 위한 공식 App Store 자료입니다. 실제 표시되는 항목은 선택한 Type과 앱 화면에 따라 달라질 수 있으므로, 입력값은 항상 본인의 원본 연결 정보를 기준으로 하세요.
1단계 · Add Server / Subscribe
서버 추가 또는 구독 가져오기
Shadowrocket을 열고 Home 화면에서 하단의 SERVER 섹션을 찾습니다. 여기에서 실제 연결에 사용할 서버를 선택합니다. 처음 설치해 아직 정보를 가져오지 않았다면 선택할 항목이 없는 것은 정상입니다. Add Server로 이동해 보유한 정보에 맞는 방법을 하나 선택하세요. 서버 정보를 직접 입력하는 방법과 구독을 가져오는 방법을 모두 진행할 필요는 없습니다.
서버 정보가 하나 있는 경우
Add Server에서 Type을 누르고 제공된 정보에 지정된 프로토콜을 선택한 다음 필요한 항목을 입력합니다. 스크린샷에는 Host, Port, Password, Method가 포함된 양식이 나와 있습니다. Type을 바꾸면 항목도 달라질 수 있으므로 이 양식을 모든 프로토콜에 공통으로 적용되는 입력 템플릿으로 간주하면 안 됩니다. Shadowsocks, VMess, VLESS, Trojan 등의 프로토콜 매개변수는 서로 바꿔 쓸 수 없습니다. 이름이 비슷하다고 해서 임의로 판단하지 마세요.
Host에는 서버 주소, Port에는 해당 포트, Password 등의 인증 항목에는 원본 정보를 입력합니다. Method가 필요한 경우에도 각 항목을 원본과 정확히 일치시켜야 합니다. 복사한 뒤 앞뒤 공백, 줄바꿈, 입력기에서 바뀐 기호가 없는지 확인하세요. 정보에 TLS, 서버 이름 또는 기타 전송 매개변수가 포함되어 있다면 함께 입력해야 합니다. 흔히 사용하는 항목을 입력했다는 이유로 나머지를 건너뛰지 마세요. 저장한 뒤 Home으로 돌아와 SERVER에 항목이 표시되는지 확인하고 사용할 항목을 선택합니다.
QR 코드가 있다면 Add Server 페이지의 Scan QR Code로 본인의 정보를 읽어올 수 있습니다. 인식된 후에도 Type과 주소를 확인하세요. Import from Cloud JSON은 해당 형식의 구조화된 정보를 가져오는 기능으로, 일반 구독 입력란과는 다릅니다. 제공된 정보가 이 형식이라고 명시된 경우에만 사용하세요. 항목의 의미가 분명하지 않다면 용어 매뉴얼을 먼저 확인하고, 프로토콜 유형을 반복해서 바꾸며 추측하지 마세요.
구독 링크가 있는 경우
Add Server로 다시 이동해 Type에서 Subscribe를 선택하고, 본인의 전체 구독 링크를 해당 주소 항목에 입력합니다. 페이지에서 제공하는 저장 절차에 따라 추가하세요. 구독 링크에는 인증 정보가 포함되는 경우가 많으므로 전체 경로와 쿼리 매개변수를 빠짐없이 복사해야 합니다. 웹사이트 도메인만 복사하거나 한글 따옴표 또는 설명을 덧붙이지 마세요. 구독 링크는 민감한 정보이므로 공개 스크린샷이나 문제 해결 기록에 넣지 마세요.
Home으로 돌아가 해당 섹션과 서버 항목이 표시되는지 확인합니다. 구독 기록만 저장되고 아직 내용을 가져오지 않았다면 해당 구독을 업데이트하고 결과를 기다리세요. 구독을 가져온 뒤에는 서버 선택도 해야 합니다. 목록에 항목이 표시된 다음 사용할 항목을 선택해야 다음 단계로 진행할 수 있습니다. 가져오기에 실패하면 오류 안내를 보관하고 링크부터 확인하세요. Global Routing은 형식이 잘못되었거나 만료된 구독 주소를 해결해 주지 않습니다.
2단계 · Global Routing / Config
Global Routing 모드 선택
서버를 추가한 뒤 Home으로 돌아가 Global Routing을 엽니다. 이 설정은 요청을 처리하는 방식을 결정하며, 사용할 서버를 선택하는 것과는 다릅니다. 처음 사용할 때는 이번에 프록시 경로를 확인할지, 기존 분할 라우팅 규칙을 사용할지 먼저 정하고 적절한 모드를 선택하세요. 상단 스위치를 켰다고 해서 모든 요청이 서버를 거친다는 뜻은 아닙니다.
Config: 현재 규칙에 따라 처리
Config는 현재 선택된 설정 파일의 규칙에 따라 요청 경로를 판단합니다. 웹사이트별로 PROXY와 DIRECT를 나눠 사용하려면 이 모드를 선택하고 Config 페이지에서 실제로 활성화된 파일을 확인하세요. 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션은 서로 다른 유형의 설정을 구성합니다. 처음 연결할 때 설정을 완벽하게 갖추려고 각 섹션을 수정하거나, 현재 목적과 관계없는 기능을 활성화할 필요는 없습니다.
특히 서버 구독과 설정 파일은 서로 다르다는 점에 유의하세요. 서버 구독은 보통 서버 목록을 업데이트하고, 설정 파일은 연결 및 분할 라우팅 방식을 지정합니다. 서버 구독을 가져왔다고 해서 설정 파일도 바뀌는 것은 아닙니다. Config 페이지에서 파일을 열어 내용을 확인한 뒤 실제로 선택되어 사용 중인지 확인해야 합니다. 편집이 필요하다면 복원할 수 있는 사본을 먼저 저장하고 Rule 또는 Add Rule에서 대상 사이트의 조건, 정책, 순서를 확인하세요.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT이 예시는 example.com과 그 하위 도메인을 PROXY로 보내고, 나머지 요청은 FINAL,DIRECT로 처리합니다. example.com은 예시 도메인일 뿐 서버나 구독 주소가 아닙니다. 규칙은 위에서 아래로 적용되므로 앞에 있는 광범위한 조건이 먼저 일치하면 뒤의 규칙은 적용되지 않을 수 있습니다. 처음에는 이 관계만 이해하면 충분합니다. 전체 문법은 설정 파일 섹션 안내에서 확인하세요.
Proxy와 Direct
Proxy는 처음 문제를 점검할 때 규칙에 따른 차이를 줄여 현재 서버의 프록시 경로로 실제 접속이 가능한지 확인하는 데 적합합니다. 다만 모든 시스템 요청이 완전히 같은 경로를 사용한다고 보장하지는 않습니다. Direct는 대상에 직접 연결하므로 기본 네트워크와 비교할 때 사용할 수 있지만, 서버가 작동한다는 증거가 되지는 않습니다. 어느 모드도 잘못된 인증 매개변수를 자동으로 수정해 주지 않습니다.
사용할 설정 파일이 정해져 있다면 Config를 선택하고 기존 규칙에 따라 확인하세요. 규칙 문제인지 서버 문제인지 아직 판단하기 어렵다면 Proxy를 임시 비교 대상으로 사용한 뒤 테스트가 끝나면 원래 모드로 되돌리세요. 세 모드의 사용 범위는 프록시 모드 안내를, Direct에 관한 내용은 Direct 안내를 참고하세요. 모드를 확인한 뒤 연결 스위치를 켭니다.
3단계 · Home / VPN 구성 승인
스위치를 켜고 승인을 완료합니다
Home으로 돌아가 SERVER에서 현재 선택된 항목과 Global Routing 모드를 확인합니다. 구독을 방금 업데이트했다면 기존에 선택했던 항목이 아직 있는지, 이름이 같은 다른 항목을 잘못 선택하지 않았는지 확인하세요. 연결에는 현재 선택된 서버가 사용됩니다. 마지막으로 상세 정보를 열어 본 서버가 사용되는 것은 아닙니다.
상단의 Not Connected 옆에 있는 스위치를 찾아 켭니다. 처음 연결할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 안내에 표시된 앱 이름을 확인한 뒤 허용하고, 시스템 안내에 따라 기기 인증을 완료하세요. 이는 앱이 기기에서 해당 네트워크 연결 구성을 설정하도록 허용하는 절차이며, 구독 유효 기간이나 서버 인증과는 별개입니다.
승인이 끝나면 Shadowrocket으로 돌아와 Home 상단의 상태가 Not Connected에서 연결 상태로 바뀌었는지, 스위치가 켜져 있는지 확인합니다. 시스템 확인 창이 나타나면 먼저 절차를 마친 뒤 다음 작업을 진행하세요. 승인이 끝나기 전에 스위치를 반복해서 누르지 마세요. 앞서 승인을 거부했다면 연결을 다시 시작하고 시스템 안내에 따르세요. 필요한 경우 시스템 설정에서 VPN 구성 상태를 확인하세요. 같은 서버 정보를 다시 가져올 필요는 없습니다.
iPad에서는 화면 공간이나 시스템 안내의 배치가 다를 수 있지만 확인 순서는 같습니다. 서버 선택 → Global Routing → 상단 스위치 → 시스템 승인 순으로 진행하세요. 기기가 조직에서 관리되는 경우 시스템 정책에 따라 VPN 구성 추가가 제한될 수 있으므로 기기 관리 지침을 따르세요. 시스템 요구 사항과 호환성은 App Store 페이지의 안내를 기준으로 합니다. 스크린샷만으로 기기 지원 여부를 판단하지 마세요.
연결 후에는 네트워크 환경을 그대로 유지하고 Wi-Fi, 서버, 설정 파일을 동시에 바꾸지 마세요. 상태가 곧바로 Not Connected로 돌아간다면 승인을 받기 전인지 후인지 기록해 두세요. 이 차이는 시스템 구성 문제와 연결 매개변수 문제를 구분하는 데 도움이 됩니다. Home 화면의 각 영역에 대한 자세한 설명은 처음 실행 및 Home 화면 안내에서 확인하세요.
4단계 · Connectivity Test / 실제 접속
연결 및 규칙 작동 확인
연결 상태가 안정되면 Home에서 Connectivity Test를 눌러 현재 서버의 테스트 결과를 확인합니다. 응답이 있으면 해당 테스트 방법에서 연결 가능한 상태임을 뜻하지만, 모든 웹사이트와 프로토콜, 요청이 정상이라는 의미는 아닙니다. 테스트 값은 다운로드 속도도 아닙니다. 실제 접속 결과를 무시하고 수치만 비교하지 마세요.
이어서 브라우저로 이동해 정상 작동 여부를 알고 있는 웹페이지 중 이번 확인 목적에 맞는 곳을 엽니다. 페이지를 새로고침하거나 새 요청을 보내고, 연결 전에 표시된 캐시 내용만 확인하지 마세요. 텍스트와 필요한 리소스가 로드되는지 확인한 뒤 페이지 안의 링크도 한 번 눌러 보세요. 페이지 제목만 표시되었다고 해서 페이지의 모든 요청이 성공한 것은 아닙니다.
선택한 모드에 따라 비교 확인
Proxy에서는 먼저 실제 접속이 가능한지 확인합니다. 테스트에는 응답이 있지만 웹페이지가 계속 실패한다면 DNS, 대상 사이트 접속, 전송 매개변수를 살펴봐야 합니다. 서버가 완전히 정상이라고 단정하지 마세요. Direct에서 성공했다면 직접 연결 경로가 작동한다는 뜻일 뿐, 프록시 경로가 검증된 것은 아닙니다.
Config에서는 PROXY로 연결될 것으로 예상되는 웹사이트와 DIRECT로 연결될 것으로 예상되는 웹사이트를 각각 선택하고, 현재 파일에 설정된 규칙을 확인합니다. 두 유형의 웹페이지가 모두 열린다는 사실만으로 각 페이지의 라우팅 방향을 알 수는 없습니다. 규칙 순서와 앱에서 확인할 수 있는 요청 기록을 함께 살펴 실제로 어떤 규칙이 적용되었는지 확인하세요. 도메인 조건을 사용하는 규칙이라면 웹페이지가 다른 리소스 도메인도 요청할 수 있다는 점에 유의하세요. 기본 도메인에 규칙이 적용되었다고 모든 리소스에 같은 정책이 적용되는 것은 아닙니다.
처음 확인할 때는 간단한 대상부터 시작하세요. 명확한 연결 경로 하나가 작동하는지 확인한 다음 복잡한 분할 라우팅을 단계적으로 복원합니다. 다른 서버와 비교하려면 한 번에 항목 하나만 바꾸고 새 요청을 보내세요. 모드를 비교할 때는 같은 서버와 네트워크 환경을 유지합니다. 그래야 무엇이 달라졌는지 파악할 수 있고, 네트워크를 바꾼 뒤 우연히 성공한 결과를 특정 설정의 효과로 오해하지 않습니다.
확인이 끝나면 사용할 서버, Global Routing 모드, 현재 Config 파일 이름만 기록하세요. 비밀번호나 전체 구독 링크와 같은 민감한 정보는 기록하거나 공유하지 마세요. 기본 연결과 예상한 접속이 모두 정상이라면 빠른 시작 절차가 완료된 것입니다. 구체적인 문제가 있을 때만 아래 문제 해결 단계를 진행하세요.
5단계 · Settings / Diagnostics
자주 발생하는 문제 확인
먼저 어느 단계에서 실패하는지 확인합니다. 가져온 항목이 없음, 서버 테스트 실패, 스위치가 켜진 상태로 유지되지 않음, 연결은 되었지만 웹페이지를 사용할 수 없음 중 어디에 해당하는지 살펴보세요. 한 번에 여러 고급 설정을 바꾸는 것보다 이 순서에 따라 확인하는 편이 원인을 찾기 쉽습니다. 아래 내용은 처음 사용할 때 흔히 발생하는 문제만 다룹니다. 문제가 계속되면 문제 해결 매뉴얼에서 증상별로 확인하세요.
가져온 뒤 서버가 표시되지 않음
추가할 때 Type이 Subscribe였는지, 링크가 완전한지, 업데이트 과정에서 오류가 발생했는지 확인하세요. 일반 웹페이지 주소, 계정 페이지, 구독 주소는 서로 다른 정보입니다. 쿼리 매개변수를 임의로 삭제하거나 인증 정보가 포함된 주소를 공개 페이지에 붙여 넣지 마세요. 링크를 가져올 수 없거나 내용을 인식하지 못한다면 본인의 서비스 제공자에게 원본 정보와 지원 형식을 확인하세요. 잘못된 주소를 반복해서 저장해도 결과는 달라지지 않습니다.
테스트 실패 또는 연결 끊김
직접 추가한 경우 Type, Host, Port, 인증 항목, 필요한 전송 매개변수를 하나씩 다시 확인합니다. 구독을 가져온 경우에는 내용이 정상적으로 업데이트되었는지 먼저 확인하세요. 이어서 현재 기본 네트워크가 작동하는지 확인하고 동일한 환경에서 기존의 다른 서버 항목도 테스트합니다. 여러 항목이 동시에 실패한다면 현재 네트워크 환경도 원인으로 고려해야 합니다. 모든 서버가 작동하지 않는다고 바로 단정하지 마세요.
Settings에서 Test Method를 확인해 현재 어떤 테스트 방법을 사용하는지 알아보세요. 테스트 방법을 바꾸면 결과의 의미도 달라지므로 전후 수치를 직접 비교할 수 없습니다. UDP 등 전송 관련 문제에서 Settings의 TCP 또는 UDP 항목을 무작정 바꾸는 것은 일반적인 해결 방법이 아닙니다. 먼저 서버 프로토콜 요구 사항을 확인한 뒤 관련 문서에 따라 점검하세요.
스위치 이상 또는 웹페이지 접속 불가
스위치가 켜지지 않으면 시스템 VPN 승인이 완료되었는지, 다른 VPN 구성이 사용 중인지, 기기 관리 제한이 있는지 확인하세요. 스위치는 켜져 있지만 웹페이지가 열리지 않는다면 Global Routing과 현재 Config를 확인합니다. Proxy에서는 접속되고 Config에서는 되지 않는다면 서버 정보를 모두 다시 입력하기보다 규칙, 현재 파일, DNS 설정을 먼저 살펴보세요. 연결 관련 절차는 연결 문제 해결을 참고하세요.
Connectivity Test에 응답이 있는데 도메인 접속에 실패한다면 DNS 조회 실패 안내를 먼저 확인하세요. dns-server라는 항목이 보인다고 익숙하지 않은 주소로 무작정 바꾸지 마세요. DNS 조회와 연결은 별개의 단계입니다. 설정을 바꾸기 전에 기존 값을 저장하고 한 번에 하나씩 변경한 뒤 다시 테스트하세요.
자동 연결 및 진단 기록
수동으로 연결을 끊은 뒤 다시 연결된다면 Settings에서 On Demand에 자동 실행 조건이 설정되어 있는지 확인하세요. 처음 사용할 때는 먼저 수동 연결이 안정적인지 확인한 뒤 자동 동작을 설정하는 것이 좋습니다. 기존 On Demand 규칙이 있다면 원래 설정을 기록한 다음 조건을 잠시 비활성화해 비교하세요. Wi-Fi와 셀룰러 네트워크 전환도 별도로 확인해 네트워크 변화와 자동 실행이 뒤섞이지 않게 하세요.
추가 분석이 필요하다면 Settings의 Diagnostics를 확인하세요. 단순히 사용할 수 없다고 설명하는 것보다 오류가 발생한 단계, 네트워크 유형, 오류 문구를 기록하는 편이 도움이 됩니다. 기록을 공유하기 전에 서버 주소, 인증 항목, 구독 내용을 가리세요. 문제 해결 후에는 필요한 Global Routing 및 On Demand 설정을 복원하고 실제 접속을 다시 확인해 전체 과정을 마무리하세요.
