Shadowrocket 사용법
추가, 모드 선택, 연결, 확인, 문제 해결 순서로 진행하세요. 먼저 확인 가능한 연결 하나를 설정한 뒤 규칙이나 자동 연결 조건을 조정합니다. 이 페이지에서는 첫 사용에 필요한 설정만 다룹니다.
읽는 순서: 처음 설정한다면 01단계부터 시작하세요. 스위치를 켰는데 접속에 문제가 있다면 04단계부터 확인해도 됩니다. 프로토콜 매개변수를 알아보려면 프로토콜 매뉴얼을 참고하세요. 처음 연결하기 전에 고급 설정을 하나씩 바꿀 필요는 없습니다.
Add Server / Subscribe
보유한 정보에 맞는 메뉴를 선택하고 저장한 뒤, 연결을 켜기 전에 SERVER 항목부터 확인하세요.
Shadowrocket을 열고 Home에서 Add Server를 찾습니다. 입력하기 전에 보유한 정보가 개별 서버의 주소와 인증 정보인지, 업데이트 가능한 구독 링크인지, 서버 정보가 담긴 QR 코드인지 확인하세요. 각 정보는 용도가 다릅니다. 구독 링크 전체를 Host에 입력하거나 일반 웹페이지 주소를 구독 정보로 가져오면 안 됩니다.
기존 서버 정보 직접 입력
Add Server로 이동한 뒤 Type을 눌러 보유한 서버 정보에 해당하는 프로토콜을 선택합니다. 선택한 유형에 따라 입력해야 할 항목이 달라집니다. 스크린샷은 특정 항목의 예시이며 모든 프로토콜에 같은 매개변수가 필요한 것은 아닙니다. 제공받은 정보를 바탕으로 Host, Port와 해당 인증 정보를 입력하세요. Password, Method 등은 선택한 유형에서 요구하는 경우에만 입력합니다.
항목을 대조할 때는 주소 앞뒤에 공백이 있는지, 포트 번호가 온전한지, 인증 정보의 대소문자가 정확한지 특히 주의하세요. 서버 주소, TLS 검증에 사용하는 이름, 기타 전송 설정은 서로 다를 수 있으므로 비슷해 보인다는 이유로 바꿔 쓰면 안 됩니다. 제공된 정보에 없는 고급 항목은 우선 그대로 두세요. 모르는 항목은 추측해서 입력하지 말고 프로토콜 매뉴얼의 매개변수 안내를 확인하세요.
Subscribe로 기존 구독 가져오기
전체 구독 링크가 있다면 Add Server의 Type에서 Subscribe를 선택하고 해당 URL 항목에 링크를 입력한 다음 저장하세요. 복사한 내용이 잘리거나 안내 문구가 섞이지 않았는지 확인합니다. 구독 주소에는 개인 구독에 접근하기 위한 인증 정보가 포함될 수 있으므로 비공개로 관리하고, 공개적으로 도움을 요청하는 글이나 스크린샷에 그대로 붙여 넣지 마세요.
저장한 뒤 Home으로 돌아가 해당 구독 그룹과 서버 항목을 확인하세요. 내용이 없다면 구독 업데이트 상태를 확인하고 구독 항목의 업데이트 기능을 사용해 다시 가져온 다음 목록이 달라졌는지 살펴보세요. 저장이 완료되었다는 것은 기록이 추가되었다는 뜻일 뿐, 원격 내용을 읽을 수 있거나 응답 내용을 반드시 해석할 수 있다는 의미는 아닙니다. 계속 비어 있다면 같은 항목을 반복해서 추가하기보다 전체 링크와 구독 상태부터 확인하세요.
Scan QR Code 사용 전 유형 확인
QR 코드가 있다면 Scan QR Code를 사용하고, 시스템 안내에 따라 이번 스캔에 필요한 카메라 권한을 허용하세요. 내용을 읽은 뒤 가져온 항목이 개별 서버인지 구독인지 확인하고 프로토콜과 주소 등을 대조합니다. Import from Cloud JSON은 별도의 데이터 가져오기 메뉴이므로 해당 메뉴에 맞는 자료가 있을 때만 사용하세요. 모든 구독 링크를 붙여 넣는 공용 입력란이 아닙니다.
이 단계가 끝나면 SERVER에 보유한 정보와 일치하는 항목이 표시되고, 항목을 열어 각 필드를 확인할 수 있어야 합니다. 이때는 테스트 대상을 하나로 정해 둔 뒤 Global Routing 설정을 진행하세요. 서버 항목, 구독, 구성 파일의 차이는 용어집에서 확인할 수 있습니다.
Global Routing의 세 가지 모드
구성(Config) / 프록시(Proxy) / 직접 연결(Direct). 현재 모드를 먼저 확인한 뒤 접속 결과를 판단하세요.
서버 정보를 저장한 뒤 Home으로 돌아가 Global Routing을 여세요. 이 메뉴는 트래픽 처리 방식을 정하는 곳이지 특정 서버를 선택하는 메뉴가 아닙니다. 처음 문제를 확인할 때는 현재 선택된 항목을 기억해 두세요. 같은 서버 정보도 모드에 따라 다르게 작동할 수 있어 규칙 문제를 서버 문제로 오해하기 쉽습니다.
구성(Config): 현재 구성에 따라 처리
규칙에 따라 트래픽을 분배하려면 구성(Config)을 사용하세요. 이 모드에서는 Config에서 현재 사용하는 구성 파일을 함께 확인하고, 규칙과 정책이 의도한 대로 설정되어 있는지 살펴봐야 합니다. 구독을 가져오는 것은 서버 목록을 관리하는 방법일 뿐, 모든 용도에 맞는 규칙을 자동으로 제공하지는 않습니다. 서버 목록이 표시된다는 사실만으로 특정 요청의 처리 방식을 판단할 수는 없습니다.
공식 스크린샷의 구성 편집 화면에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 있습니다. 처음 사용할 때는 Rule과 Add Rule의 위치만 확인하면 되며, 항목을 하나씩 편집할 필요는 없습니다. 기본 연결을 설정하기 위해 현재 작업과 무관한 기능을 켜지 마세요.
규칙을 확인할 때는 먼저 순서를 살펴보고, 규칙에 일치한 뒤 적용되는 정책을 확인하세요. DOMAIN-SUFFIX는 도메인 접미사 일치에 사용되고, GEOIP는 IP의 지리적 위치를 기준으로 일치 여부를 판단합니다. FINAL은 앞선 규칙에 일치하는 항목이 없을 때 적용되는 최종 정책입니다. DIRECT, PROXY, REJECT는 요청 처리 결과에 영향을 줍니다. 여기서 PROXY는 규칙 정책 키워드이므로 Global Routing의 Proxy 모드와 구분해야 합니다.
프록시(Proxy): 서버 경로 비교에 사용
프록시(Proxy)는 트래픽을 프록시 방식으로 처리하며, 문제를 확인할 때 비교 기준으로 사용할 수 있습니다. 같은 서버를 유지한 채 이 모드로 잠시 전환하고 같은 페이지를 열어 보세요. 프록시(Proxy)에서는 접속되지만 구성(Config)에서는 되지 않는다면 현재 구성, 규칙 일치 여부와 관련 설정을 우선 확인하세요. 서버를 바꿔 입력할 필요는 없습니다. 이 모드가 모든 서버의 작동을 보장하는 것은 아니며, 실제 접속 확인을 대신할 수도 없습니다.
직접 연결(Direct): 로컬 네트워크 확인
직접 연결(Direct)은 트래픽을 직접 연결 방식으로 처리하며, 현재 Wi-Fi 또는 셀룰러 네트워크의 기본 접속 상태를 확인하는 데 도움이 됩니다. 이 모드에서 페이지가 열린다고 해서 선택한 서버가 정상 작동한다는 뜻은 아닙니다. 비교를 마치면 사용할 모드로 돌아가세요. 규칙 분배가 필요하다면 구성(Config)으로 되돌리고 현재 Config를 기록한 뒤 다음 단계로 진행합니다.
이 단계에서는 ‘어떤 모드와 구성 파일을 사용할지’만 정하면 됩니다. 규칙 키워드의 자세한 뜻은 용어집을 참고하세요. 처음 작동을 확인하는 동안 모드, 서버, 구성 파일을 동시에 바꾸면 어떤 변경이 결과에 영향을 줬는지 판단하기 어렵습니다.
Home: 항목 선택 후 스위치 켜기
시스템 권한, 스위치 상태, 실제 접속 여부는 각각 따로 확인해야 합니다.
Home으로 돌아가 SERVER 그룹에서 이번에 사용할 서버를 선택하고 선택 표시와 항목 이름을 확인하세요. 구독에 항목이 여러 개 있더라도 하나씩 모두 전환할 필요는 없습니다. 먼저 정보가 완전한 항목 하나를 골라 전체 확인을 진행하세요. 그런 다음 Global Routing을 다시 살펴보고 이전 단계에서 선택한 모드가 유지되고 있는지 확인합니다.
연결되지 않은 상태에서는 상단에 Not Connected가 표시됩니다. 상단 연결 스위치를 켜면 처음 사용할 때 시스템에서 VPN 구성을 추가하도록 허용해 달라는 메시지가 나타날 수 있습니다. 시스템 안내를 읽고 Shadowrocket을 대상으로 한 작업인지 확인한 다음 안내에 따라 승인하거나 기기 인증을 완료하세요. 이 권한은 시스템 수준의 네트워크 연결 구성을 설정하기 위한 것으로, 서버 주소를 대신 입력하거나 구독 내용을 추가하지는 않습니다.
권한을 승인한 뒤 앱으로 돌아와 상단 스위치와 상태가 연결된 상태로 유지되는지 확인하세요. 이전에 권한 요청을 취소했다면 연결을 다시 시작해 시스템 안내를 확인하면 됩니다. 가져온 서버를 먼저 삭제할 필요는 없습니다. 스위치가 곧바로 꺼진다면 오류 문구가 표시되었는지, 방금 네트워크를 전환했는지, 어떤 서버를 선택했는지 기록하세요. 계속해서 스위치를 눌러 보는 것보다 이런 정보가 문제를 찾는 데 도움이 됩니다.
iPad에서도 같은 순서로 진행합니다. 먼저 항목을 선택하고 모드를 확인한 뒤 연결을 켜세요. 화면 배치는 기기와 앱의 현재 화면에 따라 달라질 수 있으므로 화면에 표시된 메뉴 이름과 항목 내용을 기준으로 찾으면 됩니다. 첫 테스트 중에는 현재 네트워크를 유지하고 시스템 네트워크 연결 상태를 변경할 수 있는 다른 설정을 동시에 켜지 않는 것이 좋습니다.
이번 연결을 종료하려면 Home으로 돌아가 상단 스위치를 끈 다음 상태를 확인하세요. 나중에 연결이 자동으로 다시 시작된다면 05단계에서 On Demand 조건을 확인하세요. 모든 자동 연결 현상을 스위치 고장으로 판단할 필요는 없습니다.
Connectivity Test와 실제 접속
‘테스트 결과가 있음’, ‘페이지가 열림’, ‘규칙이 의도대로 적용됨’을 각각 확인하세요.
방금 선택한 서버와 모드를 유지한 채 Home에서 Connectivity Test를 실행하세요. 결과가 나올 때까지 기다린 다음 평소 사용하는 페이지를 열어 끝까지 로드되는지 확인합니다. 테스트 결과는 테스트 방식, 대상과 당시 네트워크 상태에 따라 달라집니다. 지연 시간 수치 하나가 지속적인 전송 속도를 뜻하지 않으며 동영상이나 모든 앱의 사용 경험을 바로 판단할 수도 없습니다.
테스트 결과는 나왔지만 페이지가 열리지 않는다면 테스트와 실제 접속이 같은 네트워크, 서버, 모드에서 이루어졌는지 먼저 확인하세요. 일부 페이지는 다른 도메인의 리소스도 요청하므로 첫 화면이 나타났다고 해서 모든 리소스가 정상적으로 로드된 것은 아닙니다. 평소 접속되는 다른 페이지를 비교 대상으로 열어 보고, 하나의 대상만으로 전체 연결 상태를 판단하지 마세요.
구성(Config) 모드에서는 요청이 의도한 정책으로 처리되는지도 확인해야 합니다. 앱의 연결 기록에서 요청과 규칙 일치 여부를 살펴보고 현재 Config로 돌아가 관련 규칙을 확인하세요. 기록에 요청이 DIRECT로 처리된 것으로 나오면 페이지에 접속되더라도 선택한 프록시 서버가 작동한다는 증거가 아닙니다. REJECT에 일치했다면 현재 구성에서 의도한 동작인지 먼저 확인하세요.
모드를 비교할 때는 Global Routing 항목 하나만 바꾸고 서버와 테스트 페이지는 그대로 유지하세요. 구성(Config), 프록시(Proxy), 직접 연결(Direct)에서 나타나는 차이를 기록한 뒤 테스트가 끝나면 원래 사용할 모드로 되돌립니다. 페이지의 겉모습만으로 접속 경로를 판단할 수 없으며, 특정 테스트 수치를 얻으려고 모든 설정을 연이어 바꾸지 마세요.
선택한 항목이 명확하고 스위치 상태가 안정적이며 실제 접속이 되고, 구성(Config)에서의 처리 경로도 의도와 일치한다면 이번 첫 설정 확인을 마쳐도 됩니다. 이후 필요에 따라 규칙이나 자동 연결 조건을 하나씩 조정하세요. 문제가 계속되면 비교 결과를 보관하고 다음 단계에 따라 범위를 좁혀 보세요. 더 다양한 증상은 자주 묻는 질문에서 확인할 수 있습니다.
문제가 발생한 단계별로 확인
가장 먼저 실패한 단계부터 확인하세요. 하나를 변경하고 한 번 테스트한 뒤 다음 조치를 결정합니다.
목록이 비어 있음: Subscribe 확인
SERVER 항목조차 표시되지 않는다면 먼저 트래픽 분배 규칙을 확인하지 마세요. 해당 구독을 열어 URL이 온전한지, 안내 문구까지 함께 복사하지 않았는지, 현재 유효한 링크인지 확인한 뒤 업데이트가 완료되었는지 살펴보세요. 구독에서 로그인 페이지나 오류 메시지가 반환되면 서버 목록을 만들지 못할 수 있습니다. 본인의 서비스 관리 페이지에서 구독 상태를 확인하고 내용을 점검한 뒤 업데이트하세요. 같은 항목을 연이어 다시 가져와 혼란을 키우지 않도록 합니다.
항목은 있지만 테스트 실패: 필드와 테스트 방식 확인
목록에 이름이 표시된다고 해서 매개변수가 모두 올바른 것은 아닙니다. 항목을 다시 열고 원래 받은 정보와 Type, Host, Port 및 인증 정보를 대조하세요. TLS나 다른 전송 항목이 있다면 누락된 내용이 없는지도 확인합니다. 그런 다음 Settings에서 Test Method를 살펴보세요. 테스트 방식에 따라 확인하는 조건이 다릅니다. 한 번의 시간 초과만으로 모든 접속이 실패했다고 단정하지 말고 실제 페이지 접속 결과와 함께 판단하세요.
스위치가 꺼지거나 자동으로 바뀜: 권한과 On Demand 구분
스위치 상태가 유지되지 않으면 먼저 시스템에서 VPN 구성을 허용했는지, 구체적인 오류가 표시되었는지 확인하세요. 스위치를 끈 뒤 자동으로 다시 연결되는 경우에는 Settings의 On Demand와 설정된 실행 조건을 살펴봅니다. 처음 문제를 확인할 때는 관련 자동 조건을 잠시 비활성화하고 수동 연결이 안정적인지 확인할 수 있습니다. 확인이 끝난 뒤 복원 여부를 결정하세요. 원래 설정을 기록하지 않은 채 여러 자동 동작을 반복해서 바꾸지 마세요.
프록시(Proxy)는 정상이고 구성(Config)은 실패: 규칙 확인
이런 차이가 있다면 현재 Config로 돌아가 사용 중인 파일, 규칙 순서와 최종 정책을 먼저 확인하세요. 대상이 너무 앞에서 DIRECT 또는 REJECT에 일치하는지, FINAL이 예상한 대로 설정되었는지 살펴봅니다. 연결 기록에서 해당 요청을 찾은 뒤 관련 규칙만 수정하세요. 페이지 하나가 열리지 않는다는 이유로 구성 파일 전체를 삭제하지 마세요.
일부 도메인만 문제: DNS와 네트워크 차이 확인
같은 서버에서 일부 페이지는 열리지만 특정 도메인에 계속 접속할 수 없다면 DNS와 규칙을 함께 확인해야 합니다. 최근 변경한 관련 설정을 먼저 원래대로 돌리고 현재 구성에 별도의 이름 해석 설정이 있는지 살펴보세요. Wi-Fi와 셀룰러 네트워크를 전환해 비교할 수 있지만, 전환한 뒤에는 테스트를 다시 실행하고 네트워크가 바뀌었다고 기록해야 합니다. 주소창에 임의의 IP를 입력하는 방법을 일반적인 확인 절차로 사용하지 마세요. 도메인, TLS 검증, 서버 동작이 함께 달라질 수 있습니다.
Diagnostics 사용 시 필요한 정보만 남기기
Settings의 Diagnostics에서 진단 정보를 추가로 확인할 수 있습니다. 문제가 발생한 단계, 모드, 테스트 방식, 오류 문구와 특정 요청에만 영향을 주는지 기록하면 막연히 ‘작동하지 않는다’고 설명하는 것보다 도움이 됩니다. 기록을 공개하기 전 구독 URL, 인증 항목과 개인 연결 정보를 가리세요. 문제를 설명하는 데 필요한 화면 메뉴와 오류 내용만 남기면 됩니다.
문제 확인이 끝나면 임시 변경 사항을 되돌리고 ‘서버 선택 → 모드 확인 → 연결 켜기 → 테스트 및 접속’ 순서로 다시 진행하세요. 특정 프로토콜의 매개변수를 더 알아보려면 프로토콜 매뉴얼을 읽어 보세요. 스위치나 키워드의 의미만 확인하려면 용어집 또는 자주 묻는 질문을 참고하면 됩니다. 처음 설정을 모든 항목을 다시 작성하는 작업으로 만들 필요는 없습니다.
