Shadowrocket 사용법

구독 링크 사용: Subscribe 선택

Home으로 이동해 추가 항목을 눌러 Add Server를 연 다음 Type에서 Subscribe를 선택합니다. 서비스 제공자에게 받은 구독 링크를 URL 항목에 빠짐없이 붙여 넣고 알아보기 쉬운 메모를 입력한 뒤 저장합니다. 붙여 넣기 전후에 공백, 줄바꿈 또는 채팅 앱에서 덧붙인 설명이 있는지 확인하세요. 링크의 쿼리 매개변수도 주소의 일부이므로 임의로 삭제하지 마세요.

저장한 다음 구독이 로드될 때까지 기다리고 Home으로 돌아가 SERVER 영역에 서버 항목이 표시되는지 확인합니다. 이름이 표시되면 자료를 읽어온 것이며, 모든 서버에 연결할 수 있다는 뜻은 아닙니다. 사용할 항목을 눌러 현재 선택으로 지정하세요. 구독을 목록에 추가했더라도 서버를 선택하지 않았다면 이후 연결 단계가 완료된 것이 아닙니다. 가져온 뒤 목록이 비어 있다면 먼저 구독에서 유효한 내용이 반환되는지 확인하고 Config 규칙부터 변경하지 마세요.

나중에 구독을 새로고침하려면 해당 구독 항목의 작업 메뉴에서 업데이트를 실행하고 결과가 돌아올 때까지 기다립니다. 업데이트하면 원격에서 제공하는 서버 정보를 다시 읽기 때문에 항목 이름이나 매개변수가 달라질 수 있습니다. 업데이트 후 현재 선택 항목을 다시 확인하세요. 구독 링크에는 접근 자격 증명이 포함되는 경우가 많으므로 문제 해결 스크린샷을 공유할 때는 메모뿐 아니라 전체 링크와 인증 매개변수도 가려야 합니다.

단일 서버 정보 사용: Type 및 인증 항목 확인

서버 하나의 매개변수를 보유한 경우 Add Server의 Type에서 해당 프로토콜을 선택한 다음 Host와 Port를 입력합니다. Host는 서버 주소입니다. 포트, 웹 경로 또는 전체 구독 링크를 함께 입력하면 안 됩니다. Port에는 서비스 제공자가 안내한 숫자를 입력합니다. Password, Method 및 프로토콜에 해당하는 기타 항목은 서버 측 설정과 일치해야 합니다. 스크린샷은 특정 프로토콜의 항목을 보여줍니다. Type을 바꾸면 표시 항목도 달라지므로 스크린샷의 모든 항목을 억지로 입력할 필요는 없습니다.

Trojan처럼 TLS를 사용하는 프로토콜은 서비스 제공자가 안내한 SNI 및 TLS 관련 설정도 확인해야 합니다. 오류를 피하려고 인증서 확인 요구 사항을 임의로 낮추지 마세요. QR 코드가 있다면 Scan QR Code로 가져올 수 있고, 단일 공유 링크가 있다면 해당 가져오기 항목을 사용하세요. Import from Cloud JSON은 해당 형식의 자료에만 사용하며 모든 링크를 넣을 수 있는 범용 메뉴가 아닙니다. 저장 후 Home으로 돌아가 추가한 항목을 선택한 다음 다음 단계로 진행하세요.

수동 입력에서 가장 흔히 발생하는 오류는 Type을 잘못 선택하거나 Port의 숫자 하나를 빠뜨리거나 불필요한 문자를 복사하는 것입니다. 여러 프로토콜을 연달아 시도하지 말고 원본 자료와 항목별로 대조하세요. 공유 링크, Subscribe 및 Config의 차이는 용어 안내를 참조하세요.

서버를 추가하고 선택한 뒤 Home으로 돌아가 Global Routing을 누릅니다. 기본 모드는 구성(Config), 프록시(Proxy), 직접 연결(Direct) 세 가지입니다. 이름에 Config가 포함되어 있다고 해서 Home의 모드 선택과 하단의 Config 구성 파일 관리 화면을 같은 페이지로 혼동하지 마세요. 전자는 규칙에 따라 처리할지 정하고, 후자는 구체적인 구성을 선택하고 편집하는 데 사용됩니다.

구성(Config): 현재 구성에 따라 트래픽 분기

일상적으로 규칙에 따라 트래픽을 분기하려면 구성(Config)을 선택합니다. 그런 다음 Config로 이동해 사용할 구성 파일이 선택되어 있는지 확인하고 Rule 부분을 살펴봅니다. 규칙은 위에서부터 순서대로 일치 항목을 찾고 해당 정책을 적용합니다. PROXY는 프록시 정책에 따라 처리하고, DIRECT는 직접 연결하며, REJECT는 요청을 거부합니다. 구성에서 정책 그룹을 참조한다면 그룹 안에서 실제로 선택된 항목도 확인해야 합니다. 서버 목록에 항목이 있다고 해서 규칙이 반드시 해당 서버를 사용한다고 볼 수는 없습니다.

아래는 “지정한 도메인과 하위 도메인은 프록시를 사용하고 나머지는 직접 연결”하는 최소 문법 예시입니다. 규칙 관계를 설명하는 예시이므로 처음부터 기존 구성을 덮어쓸 필요는 없습니다. example.com은 설명용 도메인입니다. 실제 사용 시에는 처리할 대상을 명확히 지정해 바꾸세요. 편집 전에 기존 구성의 사본을 보관하면 구독을 정상적으로 가져온 뒤 규칙을 덮어써서 새로운 문제가 생기는 일을 방지할 수 있습니다.

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

첫 번째 규칙은 example.com과 하위 도메인에 일치하며, FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. FINAL을 구체적인 도메인 규칙보다 앞에 두면 이후 규칙이 의도대로 적용되지 않습니다. 스크린샷의 General, Rule, Hosts, URL Rewrite 등은 각각 용도가 다릅니다. 첫 연결 확인을 위해 이 항목들을 한꺼번에 수정할 필요는 없습니다. 규칙을 직접 작성해야 한다면 Rule 규칙 참고를 확인하세요.

프록시(Proxy)와 직접 연결(Direct): 문제 구분에 사용

프록시(Proxy)는 문제를 점검할 때 선택한 서버의 프록시 경로를 임시로 확인하는 데 적합하며, 규칙 분기로 인한 변수를 줄일 수 있습니다. 다만 어떤 네트워크 환경에서든 모든 시스템 트래픽이 반드시 같은 경로를 통과한다는 뜻은 아닙니다. 직접 연결(Direct)은 프록시 서버를 거치지 않고 요청을 보내므로 현재 네트워크에서 대상에 직접 접속할 수 있는지 확인할 때 사용할 수 있습니다. 서버 연결이 성공했다는 증거는 아닙니다.

첫 테스트는 먼저 프록시(Proxy)로 프록시 접속을 확인한 뒤 구성(Config)으로 전환해 규칙을 확인할 수 있습니다. 전환 후에는 요청을 새로 보내고, 필요하면 테스트 페이지를 닫았다가 다시 열어 이전 연결을 재사용하지 않도록 하세요. 모드와 Config를 정한 다음 Home 상단 스위치를 켭니다.

Home으로 돌아가 SERVER 영역에서 방금 가져오거나 입력한 서버가 선택되어 있는지 확인하고 Global Routing 값도 확인합니다. 상단에 Not Connected가 표시되면 현재 연결이 설정되지 않은 상태입니다. 상단 스위치를 켭니다. 처음 사용할 때는 보통 시스템의 VPN 구성 추가 안내가 표시됩니다. 안내에 따라 허용하고 기기에서 암호 또는 생체 인증을 완료하세요. 기기 잠금 암호를 Add Server의 Password 항목에 입력하지 마세요. 서로 다른 용도로 사용됩니다.

권한을 허용한 뒤 Shadowrocket으로 돌아와 Home 상태가 바뀔 때까지 기다립니다. 시스템 VPN 구성은 기기의 관련 네트워크 요청을 클라이언트가 처리하도록 전달하기 위한 것입니다. 원격 서버에 접속할 수 있다는 뜻은 아닙니다. 스위치가 켜져 있어도 다음 단계에서 접속을 확인해야 합니다. 반대로 시스템 권한이 취소되면 클라이언트가 연결을 유지하지 못할 수 있으므로 구독을 반복해서 새로고침하기보다 먼저 권한 문제를 해결하세요.

스위치를 켜자마자 다시 꺼진다면 시스템에서 사용 중인 다른 VPN 연결이 있는지, 기기 관리 정책의 제한이 있는지, Shadowrocket의 VPN 구성이 비활성화되어 있는지 확인하세요. 문제를 점검할 때는 먼저 충돌하는 연결을 중지한 뒤 다시 시도합니다. 조직에서 관리하는 기기라면 관리 요구 사항을 따르고 제한을 우회하려고 하지 마세요. 구체적인 오류가 표시되면 오류 문구와 발생 단계를 기록한 다음 해당 단계에 맞춰 처리하세요.

정상적으로 연결을 끊을 때도 Home에서 상단 스위치를 끕니다. 나중에 자동으로 다시 연결된다면 서버를 삭제하는 대신 Settings의 On Demand와 트리거 조건을 확인하세요. 우선 수동 연결을 유지하고 아래 단계를 완료한 뒤 자동 연결을 사용할지 결정합니다.

가져오기 실패: 링크와 자료 형식 확인

구독이 업데이트되지 않거나 목록이 비어 있다면 먼저 서비스 제공자의 관리 페이지가 아닌 구독 주소를 사용했는지 확인합니다. 복사한 내용이 온전한지, 구독이 아직 유효한지, 현재 네트워크에서 구독 내용을 가져올 수 있는지 살펴보세요. 일부 업데이트 요청은 특정 네트워크 조건에 따라 달라질 수 있으므로 서비스 제공자에게 문의하세요. 구독 업데이트 실패와 서버 연결 실패를 혼동하지 마세요. 서버가 표시되지만 사용할 수 없다면 매개변수와 연결 상태를 점검합니다.

연결 실패: 서버와 테스트 방법 확인

원본 자료를 확인해 Type, Host, Port, Password 및 프로토콜에 필요한 항목을 대조합니다. TLS 관련 오류라면 기기 시간과 서버에서 요구하는 이름이 일치하는지 확인합니다. 인증 옵션을 바로 느슨한 설정으로 바꾸지 마세요. Settings에서 Test Method를 확인해 현재 Connectivity Test가 어떤 방식을 사용하는지 파악합니다. 서로 다른 방법의 결과를 같은 지표처럼 비교할 수 없으며, 한 번의 응답 시간을 안정성 보장으로 해석해서도 안 됩니다.

특정 서버만 실패하고 같은 구독의 다른 서버는 사용할 수 있다면 실패한 항목의 이름과 오류를 기록한 뒤 서비스 제공자에게 해당 서버 상태를 문의하세요. 모든 서버가 같은 네트워크에서만 실패한다면 해당 네트워크의 인증, 연결 조건 및 이름 확인을 우선 점검합니다. 한 번의 테스트 실패만으로 모든 항목을 삭제하지 마세요. 삭제하면 비교에 필요한 현재 상태가 사라집니다.

연결은 되지만 트래픽 분기가 잘못됨: Global Routing 확인

직접 연결(Direct) 모드로 남아 있지는 않은지, 다른 Config를 사용하고 있지는 않은지, 앞쪽 규칙이 대상과 먼저 일치하지는 않는지 확인합니다. 규칙을 점검할 때는 명확한 테스트 대상 하나만 남기고 구체적인 도메인 규칙부터 FINAL까지 차례로 살펴봅니다. DNS, URL Rewrite, HTTPS Decryption 등은 각각 적용 조건이 있으므로 첫 연결 실패 시 한꺼번에 켜지 마세요. 자세한 문법과 우선순위는 규칙 참고를 확인하세요.

자동 연결 및 진단: 마지막에 조정

On Demand는 조건에 따라 연결을 시작하는 기능이며 잘못된 서버 매개변수를 보완하지 않습니다. 먼저 수동 연결이 정상인지 확인한 다음 Settings에서 On Demand 조건과 예상 동작을 살펴보세요. 수동으로 연결을 끊은 뒤 다시 자동 연결된다면 이 설정부터 확인합니다. Settings의 Proxy, TCP, UDP 등은 세부 네트워크 옵션입니다. 문제 원인을 명확히 파악하기 전에는 기존 설정을 유지해 추가 변수를 만들지 마세요.

문제를 더 구체적으로 파악해야 한다면 Diagnostics에서 관련 도구를 사용하고 오류 발생 당시의 네트워크 유형, 대상 및 조작 순서를 기록하세요. 진단 기록에는 도메인, 서버 주소 또는 인증 관련 정보가 포함될 수 있으므로 공유하기 전에 민감한 내용을 확인하고 가리세요. 문제 해결 후 임시로 변경한 모드와 테스트 설정을 복원한 다음 “연결—접속—규칙 확인”을 다시 진행해 점검을 마무리합니다. 그 밖의 일반적인 상황은 자주 묻는 질문에서 확인하고, 익숙하지 않은 항목은 용어 안내를 참조하세요.