Shadowrocket 공식 매뉴얼
Shadowrocket 사용법
기존 구독 가져오기 → Global Routing → 첫 연결 → 작동 확인. 먼저 연결을 완료한 뒤 규칙과 자동 연결 조건을 조정하세요.
Add Server: 서버 및 구독 추가
Shadowrocket을 열고 먼저 Home에 머뭅니다. 아래의 SERVER에는 서버와 그룹이 표시됩니다. 처음 사용하는 경우 아직 항목이 없을 수 있습니다. Add Server를 눌러 추가 화면으로 이동합니다. 기존 정보에 맞는 방법 하나만 선택하세요. 구독 링크 전체가 있다면 Subscribe를 사용하고, 단일 서버의 주소·포트·비밀번호가 있다면 수동으로 입력하며, 이미 QR 코드가 있다면 스캔 기능을 사용합니다. 같은 정보를 여러 방식으로 반복해서 가져오면 중복 항목을 구분하기 어려울 수 있습니다.
기존 구독 링크: Subscribe 선택
Add Server에서 Type을 열고 Subscribe를 선택한 다음 해당 유형의 링크 입력란에 전체 구독 링크를 입력합니다. 붙여넣은 뒤 처음과 끝에 공백이나 줄바꿈이 추가되지 않았는지 확인하세요. 특히 물음표 뒤에 붙는 매개변수가 빠지지 않았는지 살펴봅니다. 구독 링크는 일반 웹 주소와 같지 않습니다. 브라우저에서 안내 페이지가 열리더라도 그 주소를 가져오기에 사용할 수 있다는 뜻은 아닙니다. 보유한 서비스에서 제공한 구독 주소를 사용하고, 웹페이지 제목이나 공유 설명을 보고 주소를 임의로 조합하지 마세요.
저장한 뒤 Home으로 돌아가 목록을 불러올 때까지 기다립니다. 구독 그룹이 표시되면 펼쳐 서버 이름이 실제로 있는지 확인합니다. 구독 이름만 있고 아래에 서버가 없다면 가져오기가 완료된 것이 아닙니다. 먼저 해당 구독을 업데이트하고 네트워크와 주소가 유효한지 확인하세요. 업데이트하면 원격 콘텐츠를 불러오며 해당 구독의 서버 필드가 바뀔 수 있습니다. 유지할 수동 변경 사항이 있다면 미리 기록해 두세요. 장기적인 정리 방법은 서버 관리 매뉴얼을 참고하세요.
기존 단일 서버: 필드별 확인
단일 서버 정보를 받았다면 먼저 Type에서 해당 프로토콜을 선택한 뒤 Host, Port와 해당 프로토콜에 필요한 인증 정보를 차례로 입력합니다. Host에는 일반적으로 호스트 이름이나 IP 주소를 입력하며 웹페이지 경로를 함께 넣지 않습니다. Port에는 해당 포트를 입력합니다. Password의 대소문자와 기호는 원래 정보 그대로 유지하세요. 선택한 프로토콜에서 Method가 필요한 경우에만 원래 정보에 따라 선택하고, 이름이 비슷하다는 이유로 다른 항목을 고르지 마세요. Type에 따라 필드가 달라지므로 스크린샷에 나온 필드가 모든 프로토콜에 공통으로 적용되는 것은 아닙니다.
이미 QR 코드가 있다면 Scan QR Code를 눌러 시스템 안내에 따라 카메라 권한을 허용하고 스캔한 다음, 해석된 프로토콜과 필드를 확인합니다. Import from Cloud JSON은 정해진 형식의 데이터를 가져오는 별도 기능이며, 일반 구독 링크를 임의로 붙여넣는 곳이 아닙니다. 저장을 마치면 SERVER로 돌아가 원하는 서버를 선택합니다. 다음 단계로 넘어가기 전에 이름과 주요 필드가 올바른지 확인하고 트래픽 처리 방식을 선택하세요.
Global Routing: 세 가지 모드 선택
서버가 목록에 표시되면 Home으로 돌아가 Global Routing을 누릅니다. 이 설정은 트래픽을 전반적으로 처리하는 방식을 정하며 서버 정보를 보완하거나 만료된 구독을 복구하지는 않습니다. 처음 사용할 때 혼동하기 쉬운 점은 서버 선택, 라우팅 모드 선택, 연결 스위치 켜기가 서로 별개의 작업이라는 것입니다. 목록에 서버가 있다고 해서 현재 트래픽이 이미 해당 서버를 통과하는 것은 아닙니다.
- 구성(Config): 현재 활성화된 구성 파일의 규칙에 따라 트래픽을 처리합니다. 대상에 따라 PROXY, DIRECT, REJECT가 각각 적용될 수 있으며 규칙별 분할 처리가 필요할 때 적합합니다.
- 프록시(Proxy): 트래픽을 프록시 방식으로 처리하며, 선택한 서버의 기본 연결 가능 여부를 잠시 확인할 때 유용합니다. 모든 규칙 점검을 대신하는 영구적인 문제 해결 설정은 아닙니다.
- 직접 연결(Direct): 기기의 네트워크를 사용해 대상에 직접 연결합니다. 직접 연결 기준을 확인할 때 적합합니다. 이 모드를 선택했을 때 웹페이지가 열린다고 해서 프록시 서버를 사용할 수 있다는 뜻은 아닙니다.
규칙에 따라 사용하려면 구성(Config)을 선택한 다음 Config 페이지에서 현재 활성화된 파일을 확인합니다. Global Routing의 Config는 라우팅 모드이며, 하단의 Config 페이지는 구성 파일을 관리하는 곳입니다. 이름은 같지만 기능이 다릅니다. 스크린샷에 보이는 General, Rule, Hosts 등은 파일 안의 서로 다른 설정 섹션입니다. 파일이 존재한다는 이유만으로 현재 필요한 규칙이 설정되어 있다고 가정하지 마세요.
처음 연결할 때 바로 규칙을 편집할 필요는 없습니다. 서버 연결 여부만 확인하려면 Proxy를 잠시 선택하고 4단계의 기본 점검을 마친 뒤 구성(Config)으로 되돌리세요. Proxy에서는 사용할 수 있지만 Config에서 특정 대상에 접근할 수 없다면 같은 서버를 다시 추가하기보다 해당 대상의 규칙이 어디로 향하는지 먼저 살펴봅니다. 변경하기 전에 원래 모드와 구성 파일을 기록해 두면 쉽게 되돌릴 수 있습니다.
Add Rule은 규칙을 추가하는 기능이지 서버를 추가하는 기능이 아닙니다. DOMAIN-SUFFIX,example.com,PROXY와 같은 항목은 도메인 접미사에 따라 정책을 선택하며, DIRECT는 직접 연결을 뜻합니다. 여기서는 규칙이 대상의 연결 경로를 바꾼다는 점만 이해하면 됩니다. 스크린샷을 따라 하기 위해 예시 규칙을 추가하지 마세요. 규칙 순서, 구독과 구성의 차이는 자주 묻는 질문에서 확인할 수 있습니다. 우선 현재 설정을 유지하고 연결을 완료하세요.
Home: 스위치 켜기 및 시스템 권한 허용
Home으로 돌아가 SERVER에서 사용할 서버가 선택되어 있는지 확인한 다음, 위쪽의 Global Routing이 방금 선택한 설정인지 살펴봅니다. 비슷한 이름의 항목이 여러 개라면 메모나 상세 정보를 참고해 구분하세요. 서버를 바꾸면서 동시에 구성을 편집하지 마세요. 확인을 마치면 화면 상단의 연결 스위치를 켭니다. 연결되지 않은 상태에서는 Not Connected 표시가 나타납니다.
처음 연결을 시작하면 시스템에서 VPN 구성을 추가하도록 허용해 달라고 요청할 수 있습니다. 팝업에 표시된 앱 이름과 권한 설명을 읽고 Shadowrocket에서 요청한 작업이 맞는지 확인한 다음 허용을 선택하세요. 기기 안내에 따라 암호 또는 생체 인증을 완료합니다. 권한을 설정하는 동안 앱에서 잠시 벗어날 수 있습니다. 완료한 뒤 Home으로 돌아가 상태를 확인하세요. 취소를 선택했다면 서버 목록을 반복해서 삭제하지 말고 연결 스위치를 다시 켜 요청을 시작합니다.
연결이 설정되면 상단 상태가 바뀝니다. 기기와 시스템 화면 구성에 따라 상태 영역이나 제어 센터에 VPN 표시가 나타날 수도 있습니다. 이 표시는 시스템 연결 구성이 활성화되었음을 뜻하지만, 모든 서버와 도메인에 접속할 수 있음을 단독으로 증명하지는 않습니다. 자동화 옵션을 더 켜지 말고 다음 단계에서 실제 접속을 확인하세요.
스위치가 바로 꺼지면 권한을 허용하기 전인지 후인지 기록합니다. 권한 설정 전이라면 먼저 시스템 권한 절차를 확인하고, 권한 설정 후라면 서버와 구성, 기본 네트워크를 차례로 점검합니다. 기기에서 다른 VPN 연결이 실행 중이라면 테스트 전에 해당 연결을 종료하세요. 기존 연결이 대체된 상황을 가져오기 실패로 오해할 수 있습니다. 조직에서 관리하는 기기는 VPN 구성이 제한될 수 있으므로 관리 관련 안내가 표시되면 기기 관리 정책을 따르세요.
Connectivity Test: 작동 여부 확인
연결 스위치가 켜진 상태에서 Home의 Connectivity Test로 서버 테스트 결과를 확인합니다. 테스트에는 시간이 걸릴 수 있으므로 이번 실행이 끝날 때까지 기다리세요. 표시되는 결과는 특정 테스트 방법으로 확인한 연결 상태를 의미하며, 대역폭이나 안정성 또는 모든 대상에 접속할 수 있다는 보장은 아닙니다. 서버 하나가 응답하지 않더라도 구독에 포함된 모든 항목을 사용할 수 없다는 뜻은 아닙니다.
이어서 브라우저를 열고 실제로 사용하려는 주소가 정확한지 확인한 뒤 해당 사이트에 접속합니다. 캐시가 결과에 미치는 영향을 줄이려면 페이지를 새로고침하거나 새 브라우저 창을 사용하세요. 먼저 한 대상을 확인한 다음 다른 대상도 확인합니다. 특정 앱만 문제가 있다면 연결 전체가 끊겼다고 바로 결론 내리지 말고 해당 앱과 브라우저의 동작을 비교하세요.
구성(Config)에서는 일부 대상이 원래 DIRECT로 연결될 수 있으므로 웹페이지가 열린다는 사실만으로 요청에 프록시가 사용되었다고 확인할 수 없습니다. 현재 구성의 규칙을 보고 연결 경로를 판단하세요. 앱에서 연결 기록을 확인할 수 있다면 대상 호스트 이름을 기준으로 규칙이 어떻게 적용되었는지 살펴봅니다. 기록에 요청이 표시되더라도 원격 서버에서 페이지가 완전히 전달되었다는 뜻은 아니므로 실제 접속 결과와 함께 확인해야 합니다.
비교가 필요하면 원래 모드를 기록하고 Proxy로 잠시 전환해 같은 대상에 접속한 다음 구성(Config)으로 되돌립니다. 두 모드에서 결과가 다르면 규칙이 향하는 경로를 더 살펴보세요. 둘 다 실패한다면 먼저 선택한 서버와 네트워크를 확인합니다. 판단 근거를 유지하려면 비교할 때 같은 대상, 네트워크, 서버를 사용하고 조건을 여러 개 동시에 바꾸지 마세요.
Settings: 문제 지점을 순서대로 확인
앞선 점검을 완료하지 못했다면 현재 구성과 증상을 기록한 다음 아래 순서대로 원인을 찾습니다. 구독, 서버, DNS, 규칙을 한꺼번에 바꾸지 마세요. 여러 설정을 동시에 변경하면 연결이 복구되더라도 실제 원인을 파악하기 어렵습니다. 반복해서 재설치하기보다 “어느 단계에서 실패했는지, 어떤 네트워크를 사용했는지, 어떤 모드였는지, 어떤 대상이었는지”를 기록하는 것이 더 도움이 됩니다.
목록이 비어 있거나 구독 업데이트에 실패하는 경우
먼저 연결을 끄고 기기의 현재 네트워크가 정상적으로 작동하는지 확인한 다음, 구독 링크 전체가 올바른지와 유효 기간이 남아 있는지 살펴봅니다. 일반 공유 안내, 웹 주소, Subscribe에 필요한 주소는 서로 다른 종류일 수 있습니다. 구독은 업데이트되지만 서버가 보이지 않는다면 그룹이 접혀 있거나 필터가 적용되어 있지 않은지 확인하세요. 그래도 비어 있다면 보유한 서비스를 관리하는 곳에 반환된 내용을 문의합니다. 잘못된 내용을 덮어쓰려고 항목을 반복해서 추가하지 말고 기존 항목과 필요한 오류 정보를 보관하세요.
서버는 있지만 테스트에 실패하는 경우
해당 서버의 상세 정보를 열고 원래 받은 자료와 비교해 Type, Host, Port 및 인증 필드를 하나씩 확인합니다. 프로토콜에 따라 필요한 필드가 다르므로 서버 이름만 보고 매개변수가 같다고 판단하지 마세요. 확인한 다음 보유한 다른 서버를 선택해 비교하고 Wi-Fi와 셀룰러 네트워크를 바꿔 시험해 볼 수 있습니다. 셀룰러 네트워크를 사용한다면 데이터 사용량을 확인하세요. 현재 네트워크에서만 실패한다면 비밀번호를 반복해서 수정하기보다 네트워크 환경을 중점적으로 점검해야 합니다.
Settings에서 Test Method를 확인합니다. 테스트 방법마다 확인하는 단계가 다르므로 방법을 바꾼 뒤 결과가 달라져도 모순이 아닙니다. 실제 접속 결과도 확인하고 특정 테스트 항목에 숫자가 표시되는 것만 목표로 삼지 마세요. 테스트 시간 초과와 실제 접속 가능 여부의 차이는 자주 묻는 질문의 연결 문제 해결 안내를 참고하세요.
연결은 성공했지만 일부 대상에 접속할 수 없는 경우
먼저 현재 모드가 직접 연결(Direct)이 아닌지 확인한 다음 Proxy와 구성(Config)에서 같은 대상에 접속한 결과를 비교합니다. Config에서만 실패한다면 Config로 돌아가 현재 활성화된 파일과 규칙 순서를 확인하고, 프록시가 필요한 대상이 DIRECT나 REJECT로 처리되지 않는지 살펴보세요. 도메인을 확인할 수 없는 문제라면 DNS 관련 설정을 점검합니다. 내용을 이해하지 못한 전체 구성을 기존 파일 대신 가져오지 마세요. 목록 정리와 구성 백업 방법은 서버 관리 매뉴얼에서 확인할 수 있습니다. 여기서는 우선 범위를 좁혀 문제를 찾으세요.
수동 연결은 되지만 자동 연결에 문제가 있는 경우
On Demand는 설정한 조건에 따라 연결을 시작합니다. 처음 설정할 때는 수동 연결을 유지하고 기본 접속이 안정된 뒤 자동 조건을 구성하세요. 연결이 끊긴 직후 다시 연결되거나 네트워크를 바꾼 뒤 상태가 달라진다면 On Demand가 이미 활성화되어 있는지 확인합니다. 문제를 해결할 때는 기존 조건을 기록하고 잠시 비활성화해 비교하세요. 자동 실행을 상단 스위치의 오류로 오해하지 않도록 주의합니다.
Diagnostics에서 진단 정보를 추가로 확인할 수 있습니다. 문제를 외부에 설명하기 전에 구독 주소, 비밀번호, 기타 인증 정보를 제거하고 필요한 오류 메시지, 네트워크 유형, 작업 순서만 남기세요. 문제 해결이 끝나면 임시로 변경한 모드와 테스트 설정을 원래대로 돌립니다. 연결이 정상적으로 작동한다면 Settings의 Proxy, TCP, UDP 항목을 더 변경할 필요는 없습니다.