Shadowrocket
사용 가이드

Shadowrocket을 연 뒤 Home에 머무르고, 상단 스위치를 바로 켜지 마세요. 먼저 보유한 정보의 종류를 확인합니다. 구독 링크는 업데이트할 수 있는 서버 항목을 가져오는 데 사용하고, 단일 공유 링크는 보통 서버 하나에 해당합니다. Host, Port, Password처럼 나뉜 텍스트 정보는 수동 입력에 사용합니다. 각 정보는 해당하는 경로로 입력해야 합니다. 구독 주소를 Host에 넣거나 공유 링크 전체를 Password로 입력하면 안 됩니다.

기존 구독: Subscribe 사용

Home에서 오른쪽 위의 추가 버튼을 누르고 Add Server로 이동합니다. Type 목록에서 Subscribe를 찾아 본인의 구독 링크와 구분하기 쉬운 메모를 입력한 뒤 저장합니다. 화면 구성에 따라 구독이 별도 항목으로 표시될 수 있으므로 실제 화면에 표시된 Subscribe를 선택하세요. 링크 전체를 붙여 넣고, 특히 물음표 뒤의 매개변수를 유지합니다. 채팅 메시지에 포함된 설명, 공백 또는 줄바꿈은 함께 복사하지 마세요.

저장한 뒤 Home으로 돌아와 항목이 불러와질 때까지 기다립니다. 서버가 표시되지 않으면 해당 구독의 업데이트 기능을 사용한 뒤 네트워크와 링크가 유효한지 확인합니다. SERVER 그룹에 선택 가능한 항목이 나타나야 가져오기가 완료된 것입니다. 구독 이름이 표시된다고 해서 내용까지 정상적으로 가져온 것은 아닙니다. 링크 만료, 형식 불일치 또는 요청 실패로 빈 그룹이 남을 수 있습니다. 같은 링크를 반복해서 추가하지 말고 기존 항목의 업데이트 결과부터 확인하세요.

수동 입력: 서버 정보에 맞춰 각 항목 입력

개별 매개변수만 있다면 Add Server의 Type에서 제공된 정보에 맞는 프로토콜을 선택한 뒤 Host와 Port를 입력합니다. 스크린샷에 표시된 Password와 Method는 현재 유형에 해당합니다. 다른 프로토콜을 선택하면 인증 및 전송 필드가 달라집니다. Host에는 보통 도메인이나 IP를 입력하며 웹페이지 경로를 덧붙이지 않습니다. Port에는 서버에서 제공한 포트를 입력합니다. Password, Method, TLS 및 전송 관련 매개변수는 원본 정보에 따라 입력하고, 이름이 비슷하다는 이유로 임의로 바꾸지 마세요.

QR 코드가 있다면 Scan QR Code에서 읽을 수 있습니다. 공유 링크가 있다면 앱에 표시되는 클립보드 가져오기 안내에 따라 내용을 확인하고, 분석된 유형과 주소가 올바른지 살펴보세요. Import from Cloud JSON은 해당 형식의 구성 정보를 위한 기능이며 임의의 구독 링크를 가져오는 범용入口가 아닙니다. 가져온 뒤 알아보기 쉬운 메모를 서버에 추가하고 Home으로 돌아갑니다. 이 단계에서는 테스트할 항목 하나를 명확히 선택하고, 많은 그룹을 한꺼번에 정리하지 마세요.

확인 항목: SERVER에 항목이 있고 서버 하나가 선택되어 있습니다. 구독 업데이트, 일괄 정리 및 백업은 서버 관리 매뉴얼에서 확인하세요. 지금은 다음 단계에서 트래픽 모드를 선택합니다.

서버를 추가한 뒤에는 어떤 트래픽이 서버를 사용할지 정해야 합니다. Home으로 돌아가 Global Routing을 눌러 현재 모드를 확인합니다. 먼저 세 가지를 구분하세요. 구성(Config), 프록시(Proxy), 직접 연결(Direct)입니다. 화면에 Scene이 표시되더라도 기본 연결을 확인한 뒤 설정할 수 있습니다. 첫 작업에서 모드, 장면, 자동 연결 조건을 동시에 바꾸면 문제가 발생했을 때 원인을 파악하기 어렵습니다.

Config: 구성 규칙에 따라 경로 결정

Config는 현재 구성의 규칙에 따라 요청을 처리합니다. 모든 요청이 선택한 서버를 통과한다는 뜻은 아닙니다. 하단의 Config 페이지로 이동해 사용할 구성이 선택되어 있는지 확인합니다. 구성을 열면 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 구역을 확인할 수 있습니다. 옆의 공식 스크린샷은 구성 편집 화면을 보여 주며 Global Routing의 모드 선택 화면은 아닙니다.

처음 사용할 때는 Rule의 규칙과 최종 처리 방식을 살펴보고, 여러 규칙을 한꺼번에 수정하지 마세요. 규칙은 위에서 아래로 확인하며 먼저 일치한 규칙이 해당 요청의 경로를 결정합니다. PROXY, DIRECT, REJECT는 서로 다른 처리 결과를 나타냅니다. Add Rule로 규칙을 추가할 수 있지만, 규칙을 추가했다고 반드시 적용되는 것은 아닙니다. 앞선 규칙이 먼저 일치하는지 확인해야 합니다. 이 가이드에서는 HTTPS Decryption을 켤 필요가 없으며 기본 연결을 위해 별도의 복호화 기능을 설정하지 않아도 됩니다.

Proxy와 Direct: 테스트 목적 구분

Proxy는 클라이언트가 처리하는 트래픽을 선택한 프록시 경로로 보냅니다. 문제 해결 중 규칙의 영향을 일시적으로 줄여 확인할 때 유용하지만, 서버 주소나 인증, 전송 매개변수를 수정해 주지는 않습니다. Direct는 직접 연결을 사용하므로 기기 네트워크와 대상에 접속할 수 있는지 확인할 때 적합합니다. Direct에서 웹페이지가 열려도 프록시 서버를 사용할 수 있다는 뜻은 아닙니다. 모드를 바꾼 뒤에는 새 요청을 보내 확인하고, 이미 열려 있는 페이지만 보지 마세요.

용도를 이해하고 있는 구성이 있다면 Config를 선택해 진행합니다. 서버의 기본 연결 상태를 먼저 확인하려면 Proxy를 잠시 사용해 이후 연결 및 접속 테스트를 마친 뒤 Config로 돌아갈 수 있습니다. 모드를 전환하기 전 현재 설정을 기록해 두면 문제 해결 후 복원하는 것을 잊지 않습니다. 규칙 키워드, DNS 및 정책의 관계는 용어집에서 확인할 수 있습니다. 첫 연결 단계에서 모든 설정을 한꺼번에 익힐 필요는 없습니다.

확인 항목: 현재 Config, Proxy, Direct 중 어떤 모드인지 알고 있으며, Config를 사용한다면 선택된 구성도 알고 있습니다. 이제 연결 스위치를 켭니다.

Home으로 돌아가 선택한 서버와 Global Routing을 다시 확인합니다. 상단에 Not Connected가 표시되면 아직 클라이언트 연결이 설정되지 않은 상태입니다. 상단 스위치를 눌러 연결을 시작합니다. 처음에는 시스템에서 VPN 구성을 추가하라는 안내가 표시되는 경우가 많습니다. 이 안내는 시스템이 표시하며, Shadowrocket이 네트워크 트래픽을 처리하는 데 필요한 VPN 구성을 허용합니다. 구독을 추가하는 과정이 아니며 앞에서 입력한 서버 정보를 대신하지도 않습니다.

안내에 표시된 앱을 확인한 뒤 허용을 선택하고, 시스템 요청에 따라 기기 암호 또는 생체 인증을 완료합니다. 그런 다음 Shadowrocket으로 돌아와 상단 상태가 바뀌었는지 확인합니다. 이전에 권한을 거부했다면 앱으로 돌아와 연결을 다시 시도합니다. 그래도 연결되지 않으면 시스템 설정의 VPN 관리 화면에 Shadowrocket 구성이 있는지 확인하세요. 시스템 버전에 따라 설정 메뉴와 안내 문구가 다를 수 있으므로 기기에 실제로 표시되는 내용을 따릅니다.

권한 허용은 클라이언트가 해당 트래픽을 처리하도록 허용하는 것이며 원격 서버가 정상적으로 전달할 수 있다는 의미는 아닙니다. 상단 스위치가 켜져 있어도 서버 인증 실패, DNS 오류 또는 규칙 차단으로 웹페이지가 열리지 않을 수 있습니다. 따라서 스위치를 켠 뒤 바로 마치지 말고 다음 단계에서 실제로 확인하세요. 상태 표시줄에 VPN 아이콘이 계속 표시되는지는 기기 화면에 따라 다르므로 아이콘 하나만으로 판단하면 안 됩니다.

스위치가 곧바로 꺼지거나 연결 중 상태가 오래 유지된다면 표시된 안내 문구를 빠짐없이 기록합니다. 시스템에서 다른 VPN이 연결되어 있는지 확인해 두 연결이 서로 상태를 반복해서 차지하지 않도록 합니다. 모든 네트워크 구성을 바로 삭제하지 마세요. Shadowrocket의 시스템 VPN 구성을 다시 만들어야 한다면 먼저 연결을 중지하고 앱에 서버 정보가 남아 있는지 확인한 뒤 해당 구성만 처리합니다. 완료되면 앱으로 돌아와 권한을 다시 허용합니다.

첫 연결에서는 현재 Wi-Fi 또는 셀룰러 네트워크를 그대로 유지하고 On Demand도 잠시 사용하지 않는 것이 좋습니다. 이렇게 하면 수동 연결 자체의 실패와 네트워크 전환 후 자동 연결 조건의 영향을 구분할 수 있습니다. 시스템 권한 설정이 끝났고 스위치가 계속 켜져 있다면 Connectivity Test와 실제 접속을 확인하면 됩니다. 앱을 다시 설치할 필요는 없습니다.

확인 항목: 시스템 권한 설정을 완료했고 Home의 연결 상태가 바뀌었습니다. 다음으로 연결 성공이 대상에 접속할 수 있다는 뜻인지 확인합니다.

문제가 발생하면 현재 서버와 구성을 유지하고 여러 스위치를 한꺼번에 바꾸지 마세요. 기기의 네트워크부터 시작해 서버, 모드, 규칙, DNS를 확인하고 마지막으로 시스템 연결 상태를 점검하는 순서가 효율적입니다. 항목을 하나 변경할 때마다 같은 대상에 새 요청을 보냅니다. 한 번의 변경에 한 번의 결과가 대응되므로 문제가 해결되었는지 판단할 수 있고, 효과가 없다면 원래 설정으로 되돌릴 수 있습니다.

가져온 뒤 항목이 없거나 서버 연결이 계속 실패하는 경우

구독 내용이 비어 있다면 먼저 기기에서 인터넷에 연결되는지 확인한 다음 링크가 완전하고 유효한지, 반환된 내용이 클라이언트에서 인식할 수 있는 형식인지 확인합니다. 공개 스크린샷에 링크 매개변수가 노출되지 않도록 하세요. 수동으로 추가한 항목은 Type, Host, Port, Password, Method 및 제공된 TLS와 전송 필드를 다시 대조합니다. 시간 초과, 인증 실패, 내용 분석 실패는 서로 다른 유형의 문제이므로 원래 오류를 기록한 뒤 다음 단계를 결정합니다.

테스트와 웹 접속 결과가 일치하지 않는 경우

Settings를 열고 Test Method를 확인합니다. 테스트 방법에 따라 확인하는 네트워크 계층이 다릅니다. 테스트 하나가 실패했다고 모든 실제 요청이 실패한다고 단정할 수 없으며, 반대로 테스트 응답이 있어도 대상에 접속할 수 있다고 보장할 수 없습니다. 필요하면 Diagnostics에서 관련 진단 정보를 확인하고 실패 당시의 네트워크 및 대상을 함께 살펴봅니다. 테스트 매개변수를 조정했다면 서버를 바꾸지 말고 이전과 같은 서버로 비교하세요.

Proxy에서는 되지만 Config에서는 되지 않는 경우

먼저 Config에서 예상한 구성이 선택되어 있는지 확인하고 대상이 DIRECT 또는 REJECT와 일치했는지, 앞선 규칙이 뒤의 규칙보다 먼저 적용되었는지 살펴봅니다. 도메인 접속은 실패하지만 다른 요청은 정상이라면 현재 DNS 설정과 구성의 Hosts가 이름 확인에 영향을 주는지도 확인합니다. DNS를 임의로 바꾸는 방법을 일반적인 해결책으로 사용하지 마세요. 기존 값을 유지하고 변경 목적을 확인한 뒤 같은 도메인으로 결과를 검증합니다.

네트워크 전환 후 연결이 끊기거나 스위치 상태가 반복해서 바뀌는 경우

Settings로 돌아가 On Demand 설정을 확인합니다. 처음 문제를 해결할 때는 자동 연결 조건을 잠시 비활성화하고 고정된 네트워크에서 수동 연결을 확인할 수 있습니다. 안정적으로 연결된 뒤 Wi-Fi와 셀룰러 네트워크의 동작을 각각 설정하세요. 시스템에서 다른 VPN을 사용 중이라면 필요하지 않은 연결을 먼저 중지합니다. 그래도 문제가 계속되면 시스템 안내 문구와 Diagnostics의 관련 오류를 기록하고, 모든 구성을 반복해서 삭제해 문제 범위를 키우지 마세요.

문제 해결을 위해 정보를 정리할 때는 기기 시스템, 네트워크 유형, 모드, 작업 순서 및 민감한 정보를 제거한 오류 문구만 남깁니다. 전체 구독 링크, Password, QR 코드 및 인증 정보가 포함된 공유 링크는 가려야 합니다. 업데이트, 삭제 및 백업에 관한 자세한 내용은 서버 관리 매뉴얼을, 권한 및 네트워크 관련 문제는 FAQ에서 증상별로 확인하세요.

문제 해결 후: 임시로 바꾼 모드를 복원하고 서버 및 구성이 선택되어 있는지 확인한 뒤 같은 대상으로 다시 테스트합니다. 확인이 끝난 설정은 유지하고, 이후에는 새 기능을 한 번에 하나씩 추가하세요.