Shadowrocket 사용법
구독 가져오기와 연결 확인

먼저 보유한 연결 정보를 Home에 저장한 뒤 규칙과 연결 스위치를 설정합니다. Shadowrocket을 열고 Home으로 이동해 Add Server를 찾으세요. 보유한 정보에 따라 방법을 선택합니다. 전체 구독 링크는 Subscribe에, 개별 서버의 주소·포트·인증 정보는 해당 프로토콜의 수동 추가에 사용합니다. 두 방법을 모두 진행할 필요는 없습니다. 같은 정보를 중복으로 가져오면 잘못된 항목을 선택할 수 있습니다.

Subscribe: 기존 구독 가져오기

Add Server에서 Type을 열고 Subscribe를 선택해 해당 양식을 엽니다. URL 칸에 서비스 제공업체에서 받은 전체 구독 링크를 붙여 넣습니다. 메모 칸이 있다면 알아보기 쉬운 이름을 입력할 수 있습니다. 저장하기 전에 링크의 앞뒤와 중간에 공백, 줄바꿈 또는 메시지 앱에서 붙은 문장 부호가 섞이지 않았는지 확인하세요. 구독 링크에는 인증 정보가 포함되는 경우가 많으므로 일반 공개 URL처럼 공유해서는 안 됩니다.

Home으로 돌아가 구독 정보를 불러올 때까지 기다린 다음 해당 그룹과 서버 항목이 나타나는지 확인합니다. 구독 이름만 표시되고 서버가 보이지 않는다면 먼저 오류 안내를 확인하고 링크와 현재 네트워크를 점검하세요. 같은 이름의 구독을 곧바로 반복해서 추가하지 마세요. 나중에 서비스 제공업체가 제공하는 항목을 동기화하려면 해당 구독의 업데이트 기능을 사용합니다. 업데이트로 서버 목록이 바뀔 수 있으므로 완료 후 현재 선택된 서버를 다시 확인하세요.

Add Server: 서버 정보 직접 입력

개별 서버 정보를 가지고 있다면 스크린샷의 기본값만 보고 입력하지 말고, 제공된 정보에 명시된 프로토콜을 Type에서 선택합니다. Host에는 서버 도메인이나 주소를, Port에는 서버 측에서 제공한 포트를 입력합니다. Password, Method 등의 입력란은 Type에 따라 달라집니다. TLS, SNI 또는 기타 전송 설정이 포함된 정보도 원본을 보며 항목별로 확인하세요. 프로토콜마다 인증 방식이 다르므로 한 세트의 매개변수를 다른 Type에 그대로 적용할 수 없습니다.

서버 QR 코드가 있다면 Add Server에서 Scan QR Code를 사용하고, 시스템 안내에 따라 필요한 카메라 권한을 허용합니다. Import from Cloud JSON은 별도의 가져오기 방법이며 구독 URL을 붙여 넣는 일반 입력란이 아닙니다. 제공된 정보가 해당 형식임을 명확히 확인한 경우에만 사용하세요. 저장하기 전에 인식된 Host, Port, Type을 확인합니다. QR 코드 인식에 성공해도 서버 정보가 검증된 것은 아닙니다.

완료되면 Home으로 돌아가 SERVER에서 사용할 서버를 선택하고 선택 표시가 나타나는지 확인합니다. 이때 연결 스위치를 서둘러 켤 필요는 없습니다. 목록에 항목이 보인다는 것은 정보가 저장됐다는 뜻일 뿐이며, 다음 단계에서 요청을 어떤 모드로 처리할지 정해야 합니다. 가져온 목록이 비어 있거나 형식을 인식하지 못하는 등의 문제가 있다면 문제 해결의 구독 및 서버 가져오기 안내를 먼저 확인하세요.

서버 정보를 저장한 뒤 Home으로 돌아가 Global Routing을 엽니다. 이 설정은 요청이 현재 라우팅 절차에서 어떻게 처리될지 정하며, 서버 매개변수를 대신 입력해 주지는 않습니다. 먼저 세 가지 모드를 알아둡니다: Config / Proxy / Direct. 모드를 먼저 선택하고 연결을 켠 다음, 문제를 점검할 때마다 현재 모드를 기록하세요. 그래야 규칙 문제를 서버 문제로 오해하지 않습니다.

Config: 현재 설정의 규칙에 따라 처리

평소 규칙 분기를 사용하려면 Config를 선택하고 Config 페이지에서 현재 사용하는 구성 파일을 확인합니다. 구성 편집 화면에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 표시됩니다. 처음 익힐 때는 Rule에 집중하세요. 구성의 규칙은 일치하는 요청에 적용할 정책을 정하며, DIRECT와 프록시 정책은 결과가 다릅니다. 현재 구성과 규칙의 출처를 확인해야 특정 요청이 Direct로 처리되는 것이 예상된 동작인지 판단할 수 있습니다.

규칙을 확인하려면 먼저 현재 구성의 Rule을 열어 기존 항목을 읽어 보세요. 첫 연결을 완료하려고 Add Rule을 임의로 사용하거나 여러 섹션을 한꺼번에 변경하지 마세요. URL Rewrite와 HTTPS Decryption은 기본 연결에 필요한 단계가 아니므로 기존 설정을 유지하고, 용도를 이해한 뒤 별도로 살펴보세요. Subscribe를 가져와 서버 목록을 얻는 것과 자신에게 맞는 Config를 확보하는 것은 별개의 작업입니다. 서버 수가 늘어도 규칙 분기가 자동으로 설정되는 것은 아닙니다.

Proxy와 Direct: 경로를 명확하게 비교

Proxy는 현재 라우팅 절차에서 처리되는 요청을 프록시 모드로 보냅니다. 기본 문제 해결 시 선택한 서버의 프록시 경로를 비교하는 데 유용합니다. 다만 사용 가능한 서버와 올바른 매개변수가 필요하므로 Proxy를 선택해도 비밀번호, 포트 또는 TLS 설정 오류가 해결되지는 않습니다. Direct는 직접 연결 모드로, 현재 네트워크에서 대상에 접속할 수 있는지 비교할 때 적합합니다. Direct에서 접속에 성공해도 해당 요청이 직접 연결로 성공했다는 뜻일 뿐, 프록시 경로가 정상이라고 증명하지는 않습니다.

아래 예시는 Rule 구문을 알아보기 위한 것으로, 그대로 붙여 넣어 사용할 완성된 설정이 아닙니다. 첫 번째 줄은 도메인 접미사로 일치시키고 두 번째 줄은 최종 처리 규칙입니다. 정책 이름과 규칙 순서는 실제 설정과 함께 확인해야 합니다.

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

처음에는 확인된 Config를 그대로 사용하세요. 결과가 명확하지 않다면 Proxy로 잠시 전환해 비교한 뒤 원래 사용할 모드로 복원합니다. ‘모든 요청을 프록시로 보내는 것’이 유일한 정답이라고 생각하지 마세요. 규칙 순서, 정책 참조 및 DNS의 관계는 문제 해결 매뉴얼에서 자세히 확인할 수 있습니다. 먼저 이 페이지의 연결 절차를 계속 진행하세요.

이제 Home으로 돌아가 연결 전에 확인합니다. SERVER에서 서버를 선택했고, Global Routing에 방금 정한 모드가 표시되며, 기기 자체가 네트워크에 정상적으로 연결되어 있어야 합니다. 다른 네트워크로 막 전환했다면 Wi-Fi 또는 셀룰러 네트워크가 안정될 때까지 기다린 뒤 다음 단계로 진행하세요. 이렇게 하면 문제가 발생했을 때 기기 네트워크가 아직 연결되지 않은 것인지 클라이언트의 연결 절차에 문제가 있는지 구분하기 쉽습니다.

Home 상단의 연결 스위치 사용

Home 상단의 연결 스위치를 누릅니다. 처음 연결할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 직접 시작한 작업이 맞는지 확인한 뒤 시스템 안내에 따라 허용하고 기기 인증을 완료하세요. 이 승인은 시스템 네트워크 연결 구성을 만들기 위한 것으로, 서비스를 구매하거나 서버를 추가하는 절차가 아닙니다. 시스템 승인을 완료하지 않으면 서버 정보가 저장되어 있어도 정상적인 연결을 설정할 수 없습니다.

승인이 끝나면 Home으로 돌아와 상단 상태가 Not Connected에서 바뀌었는지 확인합니다. 스위치가 계속 꺼져 있다면 시스템 안내를 모두 처리했는지 먼저 확인한 후 다시 연결해 보세요. 스위치를 빠르게 연속해서 누르지 마세요. 스위치가 바로 꺼지거나 연결되지 않은 상태가 계속되면 화면 안내를 기록하고, 기기에서 다른 VPN 구성이 연결 중인지 또는 기기 관리 정책으로 제한되는지 확인합니다. 이 단계에서는 스위치와 승인 문제를 먼저 해결하고 구독 전체를 다시 입력할 필요는 없습니다.

연결 상태와 실제 사용 가능 여부 구분

상단 연결 상태와 시스템의 VPN 표시는 연결 절차의 상태를 나타낼 뿐, 모든 대상 서비스에 접속할 수 있음을 보장하지 않습니다. 잘못된 서버 정보, 연결할 수 없는 포트 또는 예상과 다른 규칙은 스위치를 켠 뒤에야 문제가 드러날 수 있습니다. 따라서 이 단계의 완료 기준은 시스템 승인이 끝났고, Home의 연결 상태가 안정적이며, 서버와 모드가 방금 선택한 값으로 유지되는 것입니다. 실제 요청의 성공 여부는 다음 단계에서 따로 확인해야 합니다.

처음에는 연결 스위치를 직접 켜고 On Demand는 함께 활성화하지 않아도 됩니다. 주문형 연결 조건은 네트워크가 바뀔 때 연결을 시작할 수 있으므로 수동 테스트와 함께 사용하면 ‘왜 다시 연결됐는지’ 판단하기 어려워집니다. 테스트를 마치려면 Home으로 돌아가 스위치를 끄고 상태가 복원됐는지 확인하세요. 앱을 강제 종료하는 것으로 시스템 연결이 중지됐다고 판단해서는 안 됩니다.

iPad에서도 같은 순서로 진행합니다. 먼저 서버와 모드를 선택하고, 시스템 승인을 처리한 뒤 상태를 확인하세요. 화면 배치나 탐색 위치는 iPhone과 다를 수 있지만 Home, SERVER, Global Routing을 확인하는 기준은 같습니다. 연결이 안정되면 현재 설정을 그대로 유지하고 Connectivity Test와 실제 접속을 비교합니다.

먼저 절차가 어느 단계에서 멈췄는지 확인한 뒤 해당 입력만 점검하세요. 가져오기 실패, 스위치가 켜지지 않는 문제, 서버 시간 초과, 일부 웹페이지 실패는 각각 관련된 단계가 다릅니다. 처음 문제를 해결할 때 프로토콜, DNS, 규칙, 테스트 방법을 한꺼번에 바꾸지 마세요. 문제가 해결돼도 어떤 변경이 효과가 있었는지 알 수 없습니다. 아래 순서는 원인 범위를 빠르게 좁히기 위한 것이며, 자세한 원리와 고급 절차는 문제 해결 매뉴얼에서 다룹니다.

구독을 가져오거나 업데이트할 수 없음

먼저 기기의 기본 네트워크가 정상인지 확인한 다음 Subscribe의 URL이 완전한지 점검합니다. 인증, 링크 만료 또는 응답 형식과 관련된 오류라면 서비스 제공업체에 원래 구독 정보를 확인하세요. 로그인이 필요한 일반 웹페이지 주소, 안내 페이지 또는 개별 서버 정보를 구독 URL로 사용하지 마세요. 오류 안내만 보관하고 전체 구독 링크를 공개된 질문에 붙여 넣지 마세요. 다음으로 구독 오류 해결 방법을 확인하면 됩니다. Global Routing을 먼저 변경할 필요는 없습니다.

스위치가 켜지지 않거나 연결이 즉시 끊김

먼저 3단계를 다시 확인해 시스템 VPN 구성 승인이 완료됐는지 살펴보고, 사용 중인 다른 VPN 연결이 있는지도 확인합니다. 기기가 조직에서 관리되는 경우 네트워크 권한이 기기 정책에 따라 제어될 수 있으므로 관리 지침을 따르세요. 이 문제는 연결을 설정하는 단계에서 발생하므로 보통 Rule을 다시 선택해도 해결되지 않습니다. 시스템 안내 원문을 보관한 뒤 문제 해결에서 설치 및 최초 실행 관련 내용을 확인하세요.

서버 시간 초과 또는 연결 후 접속 불가

해당 서버의 편집 화면을 다시 열고 제공받은 정보와 대조해 Type, Host, Port, 인증 항목, TLS 및 전송 설정을 하나씩 확인합니다. 이름이 비슷하다는 이유만으로 매개변수가 같다고 판단하지 말고, 올바른 설정 대신 보안 검증을 낮추지도 마세요. 정보를 확인한 뒤 같은 대상을 한 번 테스트합니다. Wi-Fi와 셀룰러 네트워크를 바꿔 확인할 때는 서버와 모드를 그대로 유지하세요. 한 네트워크에서만 실패한다면 차이를 기록하고 기기 네트워크와 서버 연결 가능성을 이어서 점검합니다.

일부 요청만 실패하거나 속도가 예상과 다름

먼저 Global Routing을 확인하고 같은 대상에서 Config와 Proxy의 결과를 비교합니다. Config에서만 실패한다면 현재 구성, 규칙 순서, 정책 참조를 우선 점검합니다. 두 모드 모두 실패한다면 서버 경로와 대상 서비스를 확인하세요. 도메인 관련 문제는 DNS 문제 해결에서 더 살펴볼 수 있습니다. 특정 대상 하나의 실패 때문에 DNS 설정 전체를 변경하거나 단 한 번의 테스트 수치로 장기적인 속도를 판단하지 마세요.

Settings: 필요한 진단 정보 확인

Settings에 들어가면 현재 점검 중인 단계와 관련된 항목부터 찾습니다. Test Method는 테스트 방식을 확인하는 데 사용하며 Diagnostics는 추가 점검을 시작하는 항목입니다. On Demand는 자동 연결 조건과 관련이 있고, Proxy, TCP, UDP 등의 설정은 용도를 명확히 파악한 뒤 각각 확인해야 합니다. 처음 연결할 때 이 항목을 모두 변경할 필요는 없습니다. 스크린샷은 설정 위치를 알아보기 위한 자료이지, 그대로 복사해야 할 매개변수 목록이 아닙니다.

서비스 제공업체에 문의할 때는 오류 안내, 발생 조건, 이미 수행한 비교 테스트를 전달하세요. 스크린샷이나 진단 기록을 공유하기 전에 Password, 구독 인증 정보 및 기타 개인 정보를 삭제합니다. 원인을 찾기 어렵다면 문제 해결 매뉴얼의 증상별 항목을 확인하세요. 기본 절차를 마친 뒤 기능 안내에서 On Demand와 진단 기능을 살펴보고 설정을 하나씩 확장할 수 있습니다.