Shadowrocket 사용법

Shadowrocket을 열고 Home으로 이동한 뒤 SERVER 그룹에서 Add Server를 찾습니다. 보유한 정보가 어떤 유형인지 먼저 확인하세요. 서버 주소, 포트, 인증 정보만 있다면 직접 추가하고, 서버 목록을 갱신할 수 있는 구독 링크가 있다면 Subscribe를 선택합니다. 서버 정보가 담긴 QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. 정보의 겉모양이 비슷하다고 해서 입력 경로를 바꿔 사용하면 안 됩니다. 특히 구성 파일 주소를 서버 주소로 입력하지 마세요.

기존 서버 정보를 직접 입력

Add Server를 누른 다음 Type을 선택하고, 해당 프로토콜에 표시되는 항목에 따라 Host, Port, 인증 정보를 입력합니다. 공식 스크린샷에는 Password와 Method가 포함된 양식이 표시되어 있지만, Type에 따라 입력 항목은 달라질 수 있습니다. Type은 기존 정보에 명시된 프로토콜과 일치해야 합니다. 입력 항목이 적다는 이유로 다른 Type을 선택하지 마세요. Host에는 서버 호스트 이름이나 IP 주소를, Port에는 포트 번호를 입력합니다. URL을 입력하라고 명시된 항목이 아니라면 경로가 포함된 링크 전체를 Host에 붙여 넣지 마세요.

정보에 Password와 Method가 포함되어 있다면 대소문자와 값을 항목별로 확인하세요. VLESS, VMess, Trojan 등의 Type을 사용하는 경우에는 해당 양식에 맞춰 기존 식별 정보, 인증 정보, 전송 매개변수를 입력합니다. TLS, 서버 이름, 전송 경로도 서버 측 설정과 일치해야 합니다. 처음 설정할 때 흔히 쓰는 값이라며 임의로 입력하지 마세요. 정보가 부족하면 본인의 서비스 제공자에게 먼저 확인해야 합니다. 항목을 비워 두거나 값을 추측하면 저장은 되더라도 연결되지 않을 수 있습니다.

입력이 끝나면 화면의 저장 기능을 사용해 Home으로 돌아갑니다. SERVER에 방금 추가한 항목이 표시되는지 확인하고, 알아보기 쉬운 메모를 붙이세요. 메모는 항목을 구분하기 위한 것으로 연결 기능에는 영향을 주지 않습니다. 처음부터 여러 항목을 한꺼번에 만들지 마세요. 정보가 완전한 서버 하나를 기준으로 연결과 문제 해결을 진행하면 어느 단계에서 문제가 생겼는지 파악하기 쉽습니다.

Subscribe, QR 코드 스캔 및 구성 파일 구독

기존 서버 구독을 가져오려면 Add Server의 Type에서 Subscribe를 선택하고 양식에 구독 주소를 입력한 다음 저장합니다. 붙여 넣기 전에 링크가 완전한지, 앞뒤에 공백이나 줄 바꿈이 없는지, 쿼리 매개변수가 빠지지 않았는지 확인하세요. 저장하거나 업데이트한 뒤 Home으로 돌아가 구독 그룹에 서버 항목이 표시되는지 살펴봅니다. 구독 이름만 있고 그룹에 서버 항목이 없다면 아직 연결을 확인할 수 없습니다. 링크 내용과 업데이트 결과를 먼저 점검하세요.

Scan QR Code는 본인이 보유한 서버 정보만 스캔하세요. 인식이 끝나도 Type, Host, Port를 확인해야 합니다. Import from Cloud JSON은 별도의 가져오기 경로이며 일반 구독 링크와 필요한 형식이 다릅니다. 아무 링크나 여러 입력 경로에 반복해서 넣지 마세요. QR 코드와 구독 링크에는 인증 정보가 포함될 수 있으므로 가져오는 과정에서 공개하지 말고, 일반 스크린샷처럼 공유하지 마세요.

Config의 Subscribe도 구분해야 합니다. 이 기능은 구성 파일 구독을 통해 규칙과 관련 설정을 가져오는 것으로, Home의 서버 목록 가져오기와는 다릅니다. 구성 파일을 가져왔다고 해서 연결 가능한 서버가 생긴 것은 아닙니다. 먼저 Home의 SERVER에 선택할 수 있는 항목이 있는지 확인한 다음, 다음 단계에서 Global Routing을 선택하세요. 가져온 뒤에도 목록이 비어 있다면 문제 해결의 구독 및 서버 가져오기 안내를 확인하세요.

가져오기를 마친 뒤 Home으로 돌아가 Global Routing을 눌러 현재 선택된 항목이 Config, Proxy, Direct 중 무엇인지 확인합니다. 이 세 가지는 서버가 세 그룹으로 나뉜 것도, 연결 품질 등급도 아닙니다. 방식을 바꿔도 잘못된 포트나 비밀번호가 자동으로 수정되지는 않습니다. 테스트 전에 현재 선택을 기록해 서로 다른 경로의 접속 결과를 혼동하지 마세요.

Config: 현재 규칙에 따라 처리

Config는 현재 구성 파일의 규칙에 따라 요청에 PROXY, DIRECT, REJECT 등의 정책을 적용합니다. 규칙 기반으로 트래픽을 분기하려면 Config로 이동해 사용 중인 구성 파일을 확인한 뒤 파일 내용을 살펴보세요. 편집 화면에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 표시됩니다. 섹션마다 용도가 다르며, 첫 연결을 위해 모두 수정할 필요는 없습니다.

Rule의 규칙은 일반적으로 위에서 아래 순서로 확인합니다. 구체적인 도메인 규칙은 더 넓은 범위의 규칙보다 앞에 두고, FINAL은 앞선 규칙에 해당하지 않는 요청을 처리합니다. 아래 예시는 순서만 설명합니다. example.com과 하위 도메인에 접속할 때 DIRECT를 사용하고, 나머지 요청은 FINAL에 지정된 PROXY로 보냅니다. 예시 도메인은 서버 주소가 아니며, 현재 구성 파일을 그대로 교체하라는 의미도 아닙니다.

[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY

Add Rule로 규칙을 추가하기 전에 수정하려는 파일이 현재 사용 중인 파일인지 확인하세요. 편집한 뒤 저장하고 Config에서 선택 상태를 확인합니다. 파일을 목록에 가져오기만 하고 현재 구성으로 선택하지 않았다면 요청 경로가 달라지지 않을 수 있습니다. 처음 확인할 때는 어떤 규칙이 적용될 수 있는지, 정책이 예상과 맞는지만 알면 충분합니다. 한꺼번에 많은 규칙을 추가하지 말고, 일반적인 연결 확인을 위해 HTTPS Decryption을 켜지 마세요.

Proxy와 Direct

Proxy는 일반적으로 프록시를 사용할 수 있는 트래픽을 프록시 경로로 보내며, 문제 해결 중 규칙 분기 변수를 일시적으로 줄일 때 유용합니다. 시스템 트래픽이나 일부 제외 항목에는 별도의 처리 조건이 적용될 수 있으므로 모든 데이터가 반드시 서버를 거친다고 볼 수는 없습니다. Direct는 직접 연결 경로를 사용하며 기본 네트워크 상태를 비교할 때 유용하지만, 프록시 서버 연결에 성공했다는 증거는 아닙니다. 두 방식을 사용하기 위해 서버 항목을 새로 추가할 필요는 없습니다.

분명한 트래픽 분기 요구 사항이 없다면 현재 설정을 먼저 기록하고 Proxy에서 기존 서버를 확인한 뒤 Config로 돌아가 규칙 차이를 살펴볼 수 있습니다. 확인된 구성 파일이 있다면 Config를 그대로 사용하고 확인 단계에서 대상 요청에 예상한 정책이 적용되는지 살펴보세요. 한 번에 한 가지 조건만 바꾸세요. 규칙 유형, 정책 이름, 우선순위에 관한 자세한 내용은 규칙 및 구성 전체 가이드를 참고하고, 이 글에서는 연결을 계속 진행합니다.

Home으로 돌아가 SERVER 그룹에서 사용할 서버를 누릅니다. 목록의 선택 표시를 보고 현재 항목을 확인하세요. 항목 세부 정보를 열어 편집하는 것과 목록에서 연결할 항목을 선택하는 것은 서로 다른 작업입니다. 구독에 여러 항목이 있다면 하나를 정해 테스트하세요. 실패할 때마다 서버, 규칙, 네트워크를 동시에 바꾸면 어떤 변경이 결과에 영향을 주었는지 파악하기 어렵습니다.

Global Routing을 다시 확인한 다음 Home 상단의 연결 스위치를 켭니다. 연결되지 않은 상태에서는 Not Connected가 표시됩니다. 처음 연결할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 직접 연결을 시작한 뒤 표시된 요청인지 확인하고 허용을 선택한 다음 기기 안내에 따라 암호 또는 생체 인증을 완료하세요. 이 인증은 기기 권한 확인용이며 서버의 Password와 다릅니다. 시스템 인증 화면에 서버 인증 정보를 입력하지 마세요.

이전에 권한 요청을 거부했다면 연결이 진행되지 않을 수 있습니다. 다시 연결을 시도하고 시스템 안내가 표시되는지 확인하세요. 안내가 계속 표시되지 않으면 기기 시스템 설정에서 VPN 구성이 있는지, 기기 관리 제한이 적용되는지 살펴보세요. 관리 대상 기기는 해당 관리 정책을 따라야 합니다. 권한 문제를 해결하려고 서버 입력 항목을 반복해서 수정하지 마세요. 권한 설정을 마친 뒤 Shadowrocket으로 돌아가 상단 상태와 스위치가 연결 상태를 유지하는지 확인합니다.

스위치를 켠 것은 연결 절차가 시작되었다는 뜻일 뿐, VPN 상태가 표시된다고 모든 대상에 접속할 수 있는 것은 아닙니다. 현재 연결 상태가 안정될 때까지 기다린 뒤 Connectivity Test와 실제 접속을 확인하세요. 스위치가 곧바로 다시 꺼지면 안내 내용과 발생 시각을 기록한 다음 문제 해결 단계로 이동합니다. 연결 상태가 유지되지만 웹페이지가 열리지 않으면 현재 항목과 모드를 유지한 채 요청 경로를 점검하세요.

테스트 중에는 다른 VPN 구성이 현재 연결을 대신 사용하지 않도록 하고, 복잡한 On Demand 조건도 미리 켜지 마세요. Wi-Fi에서 셀룰러 데이터로 전환하면 기존 연결을 다시 설정해야 할 수 있으므로 당시 사용한 네트워크를 기록하세요. 직접 연결을 끊으려면 Home으로 돌아가 상단 스위치를 끄고 상태가 바뀌는지 확인합니다. 이후 자동으로 다시 연결된다면 서버 항목을 반복해서 삭제하지 말고 Settings의 On Demand 조건을 확인하세요.

가져온 뒤 사용할 수 있는 항목이 없음

먼저 기기 자체가 정상적으로 인터넷에 연결되는지 확인한 뒤, 서버 구독과 구성 파일 구독 중 어떤 것을 사용하는지 확인합니다. Home의 구독 그룹이 비어 있다면 주소가 완전한지, 유효 기간이 남아 있는지, 업데이트 중 안내가 표시되었는지 점검하세요. 공개된 토론 공간에 전체 구독 링크를 붙여 넣지 마세요. 링크의 쿼리 매개변수가 접속 인증 정보일 수 있습니다. 서버 정보를 직접 입력해 저장할 수 있지만 연결되지 않는다면 Type, Host, Port, 인증 항목을 다시 확인하세요. 저장에 성공했다고 서버가 해당 매개변수를 받아들인 것은 아닙니다.

스위치가 다시 꺼지거나, 연결은 유지되지만 접속에 실패함

스위치가 곧바로 다시 꺼지면 먼저 시스템 VPN 권한과 기기 제한을 확인한 다음 앱에 표시된 연결 오류를 살펴봅니다. 연결은 유지되지만 요청이 실패하면 서버에 도달할 수 있는지, 계정에 연결 권한이 남아 있는지, 현재 네트워크에서 해당 전송 방식을 허용하는지 확인하세요. 직접 추가한 서버라면 TLS 이름, 전송 방식, 경로가 기존 정보와 일치하는지 특히 꼼꼼히 확인해야 합니다. 비밀번호만 확인하고 모든 매개변수가 맞다고 판단하지 마세요.

Settings에서 Test Method와 Diagnostics를 확인하세요. Test Method는 테스트 결과를 해석하는 방식에 영향을 주고, Diagnostics는 진단 정보를 확인하는 데 사용됩니다. 둘 다 서버를 자동으로 수정하는 버튼은 아닙니다. 오류가 연결 성립 전인지 요청 전송 후인지 기록하고, 인증, 전송, 규칙 중 무엇을 확인해야 하는지 판단하세요. 처음 문제를 해결할 때 Proxy, TCP, UDP 옵션을 한꺼번에 바꿀 필요는 없습니다. 기본 설정이나 기존의 명확한 설정을 유지하고, 현재 오류를 설명할 수 있는 항목부터 확인하세요.

규칙, DNS, On Demand

Config에서만 문제가 발생한다면 Config에서 현재 파일을 열고 대상 도메인 규칙과 FINAL 정책을 확인하세요. 더 앞에 넓은 범위의 규칙이 있으면 뒤에 있는 구체적인 규칙이 적용되지 않을 수 있습니다. DNS 문제라면 먼저 기기의 네트워크가 정상적으로 작동하는지 확인한 뒤 General의 이름 해석 설정을 살펴봅니다. 도메인 이름 확인 실패와 서버 인증 실패는 서로 다른 문제입니다. 특정 대상 하나를 해결하기 위해 모든 도메인 규칙이나 이름 해석 설정을 한꺼번에 바꾸지 마세요.

On Demand는 설정된 조건에 따라 연결을 시작하는 기능이지, 모든 상황에서 항상 연결을 유지한다는 뜻은 아닙니다. 처음 확인할 때는 먼저 수동으로 연결해 서버와 규칙이 작동하는지 확인한 다음 필요에 따라 On Demand를 설정하세요. 직접 연결을 끊은 뒤 다시 연결되거나 네트워크 전환 후 상태가 달라지면 조건을 먼저 살펴봅니다. Today Widget은 빠른 조작과 관련된 설정으로, Home에서 현재 서버와 Global Routing을 확인하는 과정을 대신할 수 없습니다.

Wi-Fi와 셀룰러 데이터에서 결과가 다르다면 같은 서버, 같은 방식, 같은 테스트 방법을 유지한 채 각각 다시 확인하세요. 한 번에 조건 하나만 바꿔야 비교에 의미가 있습니다. 설정을 변경할 때마다 저장하고 다시 연결한 뒤 확인을 반복하고, 수정 내용을 유지할지 결정하세요. 진단 기록을 보낼 때는 비밀번호, 인증 식별 정보, 전체 구독 주소, 개인 네트워크 정보를 가리고 오류 유형과 관련 작업 순서만 남기세요.

이 다섯 단계를 마치면 현재 사용 중인 서버, Global Routing 방식, 확인 결과를 명확히 파악할 수 있어야 합니다. 그래도 원인을 찾기 어렵다면 해당 정보를 바탕으로 문제 해결 안내를 확인하세요. Rule, General 또는 DNS를 조정해야 한다면 전체 설정 가이드를 참고하면 됩니다. 이후 구독을 업데이트하거나 구성을 변경한 경우에도 가져오기에 성공했다는 사실만으로 적용을 판단하지 말고, “항목 선택 → 연결 → 테스트 → 실제 접속” 순서로 다시 확인하세요.