Shadowrocket 사용법:
구독 가져오기 및 연결 확인
추가, 라우팅, 연결, 확인, 문제 해결 순서로 진행하세요. 먼저 재현 가능한 연결을 한 번 완료한 뒤 규칙과 자동 연결 설정을 조정합니다.
SERVER에 서버 기록이 이미 표시된다면 2단계부터 진행하세요. 연결된 것으로 표시되지만 접속할 수 없다면 4단계와 5단계를 확인하면 됩니다.
Add Server: 서버 추가 또는 구독 가져오기
먼저 가지고 있는 정보가 구독 링크인지, 서버 매개변수인지 확인하세요. 구독은 서버 기록을 한꺼번에 가져오고 이후 업데이트할 때 사용합니다. 서버를 직접 추가하려면 개별 서버 정보를 하나씩 입력합니다. 두 방법 중 하나만 선택하면 되며, 같은 정보를 중복으로 입력할 필요는 없습니다. 구독 주소에는 보통 접속 정보가 포함되므로 본인 기기와 신뢰할 수 있는 입력 화면에서만 사용하고, 문제를 문의할 때도 전체 주소를 공개하지 마세요.
직접 추가: Type에 맞는 필드 입력
Shadowrocket의 Home에서 SERVER 영역의 Add Server를 여세요. 화면에 있는 추가 버튼을 이용해도 됩니다. Type을 누르고 보유한 정보와 일치하는 프로토콜 유형을 선택하세요. 그런 다음 Host와 Port를 입력하고 해당 유형에서 요구하는 Password, Method 또는 기타 인증·전송 필드를 채웁니다. 공식 스크린샷에 표시된 필드는 당시 선택된 Type에 해당하며, 모든 프로토콜이 같은 매개변수를 사용하는 것은 아닙니다.
Host에는 보통 서버 도메인이나 IP 주소를, Port에는 제공받은 포트 번호를 입력합니다. 경로가 포함된 구독 링크 전체를 Host에 넣거나 비밀번호를 Method에 입력하지 마세요. TLS, 서버 이름, 전송 경로 등의 설정이 있다면 원래 정보를 그대로 입력합니다. 필드의 의미가 불분명하면 출처를 확인하고 임의의 값으로 채우지 마세요. 입력을 마치면 화면 오른쪽 위의 저장 버튼을 누르고 Home으로 돌아가 SERVER에 기록이 표시되는지 확인합니다.
구독 가져오기: Subscribe를 선택하고 저장
본인의 구독 링크가 있다면 Add Server의 Type에서 Subscribe를 선택하고 해당 URL 필드에 전체 주소를 입력한 뒤 알아보기 쉬운 메모를 추가하세요. 붙여넣은 후 주소 앞뒤에 공백, 줄바꿈 또는 채팅 내용이 들어가지 않았는지 확인합니다. 주소의 대소문자, 매개변수, 기호는 원래대로 유지해야 합니다. 저장하고 가져오기가 끝날 때까지 기다린 다음 Home으로 돌아가 구독 그룹과 서버 기록이 표시되는지 확인하세요.
Subscribe 주소와 Config 구성 파일 주소는 용도가 다릅니다. 전자는 주로 서버 기록을 제공하고, 후자는 규칙과 구성 내용을 담으므로 링크라는 이유만으로 같은 메뉴에서 가져오면 안 됩니다. 가져온 뒤 목록이 비어 있다면 먼저 정보의 형식과 용도를 확인한 다음 구독이 유효한지 점검하세요. Global Routing을 바꿔도 잘못된 형식이 서버 목록으로 변환되지는 않습니다.
화면 아래의 Scan QR Code는 호환되는 QR 코드를 스캔할 때, Import from Cloud JSON은 해당 클라우드 JSON 가져오기 절차에 사용하며, 모든 구독을 가져오는 범용 메뉴는 아닙니다. 사용하기 전에 보유한 정보가 해당 방식에 맞는지 확인하세요. 가져오기가 끝나면 Home의 SERVER에서 사용할 기록을 선택하고 선택 표시가 나타나는지 확인한 뒤 다음 단계로 이동합니다.
완료 기준: SERVER에 알아볼 수 있는 기록이 표시되고 필요한 필드가 저장되어 있으며, 항목 하나가 선택되어 있어야 합니다. 프로토콜 필드의 의미는 용어 설명에서 확인할 수 있습니다.
Global Routing: Config, Proxy 또는 Direct 선택
서버 기록은 ‘어떤 연결 경로를 사용할지’를 정하고, Global Routing은 ‘트래픽을 어떻게 처리할지’를 정합니다. 가져오기를 마치면 Home으로 돌아가 Global Routing을 열고 사용 목적에 따라 Config, Proxy 또는 Direct를 선택하세요. 라우팅 모드를 변경해도 서버 정보가 대체되지는 않으며, 만료된 인증 정보가 복구되지도 않습니다.
Config: 현재 규칙에 따라 처리
규칙에 따라 트래픽을 분기하려면 일상적으로 Config를 사용합니다. 선택한 뒤 Config에서 실제로 활성화된 구성 파일을 확인하고 Rule 내용을 열어 보세요. 편집 화면에서 파일이 보인다고 해서 반드시 현재 구성으로 적용된 것은 아닙니다. 수정 사항을 저장한 뒤에도 목록에서 현재 선택 상태를 확인해야 합니다. 서버 구독을 성공적으로 가져왔더라도 필요한 규칙 파일이 함께 제공된다는 뜻은 아닙니다.
규칙은 위에서 아래로 확인하며, 처음 일치하는 규칙의 정책이 적용됩니다. 따라서 범위가 구체적인 조건을 넓은 조건보다 앞에 두고, 나머지 요청을 처리하는 FINAL은 마지막에 배치하는 것이 일반적입니다. 아래 예시는 ‘지정한 도메인은 PROXY, 나머지는 DIRECT’로 처리하는 방식만 보여 주며, 그대로 가져와야 하는 완성된 구성은 아닙니다. 도메인은 설명용 예시이므로 실제 사용 목적에 맞게 조정하고 기존 구성은 먼저 보관하세요.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT이 예시에서는 example.com과 그 하위 도메인이 PROXY에 일치하고, 나머지 미일치 트래픽은 FINAL,DIRECT가 처리합니다. PROXY, DIRECT, REJECT는 정책 키워드이지 직접 입력할 서버 이름이 아닙니다. 문제를 확인할 때는 규칙 순서, 현재 파일, 현재 라우팅 모드를 함께 살펴보세요. 특정 규칙 한 줄이 있다는 이유만으로 실제 적용을 단정할 수 없습니다.
Proxy와 Direct: 목적에 따라 비교하기
Proxy는 일반 트래픽을 선택한 프록시를 통해 처리하므로 규칙 선택이 문제의 원인인지 임시로 확인할 때 유용합니다. 다만 서버가 반드시 사용 가능하다는 뜻은 아닙니다. Direct는 일반 트래픽을 대상에 직접 연결하므로 기본 네트워크 상태를 비교할 수 있지만, 선택한 서버의 연결 가능 여부를 확인해 주지는 않습니다. 실제 동작은 앱 설정에 있는 예외 처리도 고려해야 합니다.
처음에는 General, Hosts, URL Rewrite, HTTPS Decryption을 동시에 변경할 필요가 없습니다. 현재 구성의 기본 라우팅이 예상대로인지 확인한 다음 연결을 진행하세요. 테스트 중 Proxy나 Direct로 잠시 바꾼다면 원래 라우팅 모드를 기록해 두었다가 비교가 끝난 뒤 복원하세요. 그래야 다음 사용 때 규칙이 작동하지 않는다고 오해하지 않습니다. 규칙 키워드의 자세한 범위는 용어 설명에서, 체계적인 문제 해결은 문제 해결 가이드에서 확인할 수 있습니다.
완료 기준: 현재 Global Routing 선택을 알고 있으며, Config를 사용하는 경우 현재 파일과 기본 처리 정책을 확인할 수 있어야 합니다.
Home: Not Connected 스위치 켜기
서버와 Global Routing을 설정한 뒤 Home으로 돌아가세요. 먼저 SERVER에서 이번에 사용할 기록이 선택되어 있는지 확인하고, Global Routing에 표시된 모드도 확인합니다. 이때 상단에 Not Connected가 표시될 수 있습니다. 이는 아직 연결을 시작하지 않았다는 뜻이지, 가져오기에 실패했다는 뜻은 아닙니다.
첫 연결 시 VPN 구성 추가 승인
상단의 연결 스위치를 켜세요. 처음 사용할 때 시스템에서 VPN 구성 추가를 허용할지 묻습니다. Shadowrocket을 대상으로 작업 중인지 확인한 뒤 허용하고, 기기 암호나 생체 인증 등 시스템이 요구하는 절차를 완료하세요. 이 권한은 시스템이 로컬 VPN 터널을 만들고 처리 대상 트래픽을 앱으로 전달하는 데 사용됩니다. 서버 계정이 아니며 누락된 구독이나 인증 정보를 대신 추가하지 않습니다.
이전에 승인을 취소했다면 앱으로 돌아가 다시 연결을 시도하고 실제로 표시되는 시스템 안내에 따르세요. 기기가 관리 대상이거나 시스템 제한이 있는 경우 구성 추가 허용 여부는 기기 관리 정책에 달려 있으므로 먼저 해당 기기에서 이 작업을 허용하는지 확인해야 합니다. 용도를 알 수 없는 관리 구성을 삭제해 가이드를 계속 진행하지 마세요. 판단하기 어렵다면 변경을 중단하세요.
상태가 바뀌는지 확인한 뒤 접속 테스트 진행
승인 후 Home으로 돌아가 상단 상태와 스위치가 안정적으로 유지되는지 살펴보세요. 기기에 따라 시스템 상태 영역에 VPN 표시가 나타날 수도 있습니다. 연결 상태가 계속 켜져 있으면 시스템 터널이 설정된 것이지만, 선택한 서버와 DNS 및 모든 웹사이트의 작동까지 확인된 것은 아닙니다. 다음 단계에서 실제 접속을 테스트해야 합니다.
스위치가 곧바로 꺼지면 오류 메시지와 발생 단계를 먼저 기록하세요. 승인 전인지, 승인 후인지, 연결을 시도한 뒤인지 확인합니다. 다른 VPN 연결이 사용 중이라면 먼저 해당 연결을 중지하고 단독으로 테스트해 전환으로 인한 간섭을 줄이세요. 스위치를 빠르게 반복해서 누르거나 연결 도중 여러 매개변수를 한꺼번에 변경하지 마세요.
이번에는 기존 On Demand 설정을 그대로 두고 수동 연결 과정을 먼저 완료하세요. 수동으로 연결을 끈 뒤 자동으로 다시 연결된다면 5단계에서 On Demand 조건을 확인합니다. 스위치가 안정적으로 유지되는지 확인한 뒤 VPN 표시만으로 점검을 끝내지 말고 Connectivity Test와 브라우저 접속을 진행하세요.
완료 기준: 필요한 시스템 승인을 마쳤고 Home의 연결 상태가 안정적이며, 현재 서버와 라우팅 모드를 확인할 수 있어야 합니다.
Connectivity Test: 테스트 후 실제 접속 확인
연결이 유지되면 Home에서 Connectivity Test를 누르고 이번 테스트가 끝날 때까지 기다리세요. 테스트 결과는 선택한 기록이 현재 테스트 방식으로 응답하는지 판단하는 데 도움이 됩니다. 전체 웹사이트 접속을 검증하거나 특정 규칙이 일치했음을 직접 증명하지는 않습니다. 먼저 현재 선택된 기록을 확인하고 다른 기록은 그다음에 살펴보세요. 목록의 다른 항목 결과를 현재 연결 결과로 오인하지 않도록 주의해야 합니다.
테스트 조건을 먼저 확인한 뒤 결과 해석
Connectivity Test 결과는 Settings의 Test Method, 현재 네트워크, 서버의 테스트 방식 지원 여부에 따라 달라집니다. 시간 초과가 발생해도 실제 요청이 모두 실패한다고 단정할 수 없으며, 테스트에 성공해도 모든 앱 트래픽, UDP 또는 모든 대상이 작동한다는 보장은 없습니다. 두 결과를 비교할 때는 가능한 한 같은 네트워크, 같은 기록, 같은 테스트 방식을 사용하세요. 조건이 다른 수치를 그대로 비교해 우열을 판단하지 마세요.
두 종류의 접속으로 예상 경로 확인
브라우저를 열고 PROXY를 사용할 것으로 예상되는 대상에 접속한 다음, DIRECT를 사용할 것으로 예상되는 대상에도 접속하세요. Config에서는 아무 페이지나 무작위로 여는 대신 현재 규칙에 맞춰 테스트 대상을 정해야 합니다. 앞의 예시 규칙을 사용한다면 example.com에 일치하는 요청만 PROXY로 처리됩니다. 다른 대상에 직접 접속할 수 있다고 해서 프록시 서버가 정상이라는 뜻은 아닙니다.
앱의 Data 또는 관련 요청 기록에서 이번 요청의 처리 정보를 확인할 수 있다면 대상 도메인, 시간, 정책을 함께 살펴보세요. 화면에 표시되는 정보는 앱의 실제 버전을 기준으로 합니다. 페이지 로딩 속도만으로 어떤 경로를 사용했는지 추측할 수는 없습니다. 일부 페이지는 다른 도메인에도 추가 요청을 보내므로 처음 입력한 주소만 보지 말고 실패한 요청을 확인하세요.
간단히 비교하려면 Global Routing을 Config에서 Proxy로 잠시 바꾸고 같은 서버를 유지한 채 같은 대상을 다시 로드하세요. Proxy에서는 접속되지만 Config에서 실패하면 규칙, 현재 구성 파일, DNS를 우선 확인합니다. 둘 다 실패하면 서버 정보와 기본 네트워크를 먼저 점검하세요. 테스트가 끝나면 원래 라우팅 모드로 복원합니다.
완료 기준: 연결 스위치가 켜져 있을 뿐 아니라, 조건을 알고 있는 상태에서 접속 결과를 재현하고 현재 라우팅 모드와 규칙에 맞는지 판단할 수 있어야 합니다.
Settings 및 자주 발생하는 문제: 발생 단계별 확인
먼저 문제가 가져오기, 연결 설정, 연결 후 접속 중 어느 단계에서 발생했는지 판단하세요. 각 단계의 점검 항목은 다릅니다. 구독을 읽지 못하면 주소를 확인하고, 스위치가 켜진 상태를 유지하지 못하면 승인을 확인합니다. 일부 대상만 실패하면 규칙과 DNS를 점검하세요. 여기서는 기본 원인만 확인하면 됩니다. 여러 설정이 관련되거나 문제가 계속되면 문제 해결 종합 가이드를 참고하세요. 처음 설정할 때 모든 고급 매개변수를 살펴볼 필요는 없습니다.
가져오기에 실패하거나 SERVER에 기록이 없음
구독 주소가 완전하고 아직 유효한지, 실제로 서버 구독에 사용하는 주소인지 다시 확인하세요. 네트워크 또는 인증서 오류가 표시되면 현재 네트워크에서 구독 주소에 정상적으로 접속할 수 있는지와 기기 시간이 정확한지 먼저 확인합니다. 전체 주소를 공개 검색창이나 스크린샷에 올리지 마세요. 서비스 제공자에게 문의해야 한다면 필요한 오류 정보만 전달하고 인증 정보는 가리세요.
직접 추가한 뒤 작동하지 않으면 Add Server로 돌아가 Type, Host, Port, 인증 필드를 확인하세요. 비밀번호가 같아 보여도 앞뒤에 공백이 포함될 수 있습니다. 포트, 암호화 방식, TLS 관련 매개변수가 일치하지 않아도 연결이 실패할 수 있습니다. 수정한 뒤 저장하고 Home으로 돌아가 해당 기록을 다시 선택해 테스트하세요. 이전 기록을 계속 사용하지 않도록 주의합니다.
스위치가 켜지지 않거나 자동으로 꺼지거나 다시 연결됨
먼저 시스템의 VPN 구성 승인이 완료됐는지 확인하고 다른 VPN 연결이 동시에 작동 중인지 살펴보세요. 수동으로 연결을 끈 뒤 다시 연결된다면 Settings에서 On Demand의 활성화 상태와 실행 조건을 확인합니다. On Demand는 자동 연결 시점을 제어하며, Config에서 연결 후 트래픽을 어떻게 라우팅하는지 설정하는 것과는 별개입니다. 조정하기 전에 기존 상태를 기록하고 문제 해결 후 사용 목적에 맞게 복원하세요.
Wi-Fi와 셀룰러 네트워크를 전환한 뒤에만 문제가 나타난다면 두 네트워크에서 각각 다시 테스트하세요. 바로 앱 자체의 문제라고 단정하지 마세요. 구성과 기록은 그대로 두고 네트워크만 바꿔 동일한 대상에서 같은 결과가 나타나는지 확인합니다. 그래야 기본 네트워크 차이와 서버 매개변수 오류를 구분할 수 있습니다.
연결됐지만 접속할 수 없거나 일부 대상만 실패
먼저 정상 작동하는 일반적인 대상에 접속해 기본 네트워크를 확인한 다음 현재 서버와 Global Routing을 점검하세요. Proxy는 정상인데 Config에서 문제가 생기면 실제 활성화된 구성, 규칙 순서, FINAL을 우선 확인합니다. 일부 도메인만 실패한다면 DNS 응답과 관련 요청을 살펴보세요. 처음부터 DNS, TCP, UDP, 모든 전송 설정을 한꺼번에 바꾸지 마세요.
Settings의 Test Method는 연결 테스트 조건을 이해하는 데, Diagnostics는 문제를 찾는 데 참고할 정보를 제공합니다. Proxy, TCP, UDP 등의 항목은 더 구체적인 동작과 관련되므로 처음 사용할 때는 기존 값을 유지하세요. 진단 정보를 공유하기 전에 구독 주소, 서버 정보, 접속 기록이 포함되어 있는지 확인하고 문제 해결에 필요한 부분만 남기세요.
구독을 업데이트한 뒤 이전에 선택한 기록이 사라졌다면 SERVER로 돌아가 현재 선택을 다시 확인하세요. 구성을 수정한 뒤 문제가 생겼다면 먼저 보관해 둔 이전 구성을 복원하고 같은 대상으로 다시 테스트합니다. 설정을 계속 추가하기보다 ‘기준 상태 복원, 한 항목만 변경, 다시 확인’ 순서로 진행하는 편이 원인을 찾기 쉽습니다.
이제 첫 사용 절차가 끝났습니다. 화면에 표시되는 용어는 용어 설명에서 확인하세요. 지속적인 시간 초과, DNS, 배터리 소모, 업데이트 후 발생한 문제 등은 문제 해결 가이드에서 해당 증상을 찾아 점검할 수 있습니다.
사용 가능한 구성을 보관하고 필요한 내용을 더 알아보기
마치기 전에 세 가지를 확인하세요. SERVER에서 예상한 기록이 선택되어 있는지, Global Routing이 계속 사용할 라우팅 모드로 복원되어 있는지, 실제 접속 결과가 규칙의 예상과 일치하는지 확인합니다. 현재 사용할 수 있는 구성을 보관하고, 이후 설정을 변경할 때마다 같은 대상으로 다시 테스트하면 변화의 원인을 파악하기 쉽습니다.
자동 연결, 프로토콜, 구성의 용도를 알아보려면 기능 소개를 참고하세요. 지정한 웹사이트만 PROXY로 보내는 규칙 작성법은 특정 웹사이트 라우팅 가이드에서 확인할 수 있습니다.