Shadowrocket 사용법:
가져오기, 연결 및 확인

단계 01 / 연결할 서버 정보 준비

서버를 추가하거나구독 가져오기

먼저 보유한 정보의 종류를 파악한 후 해당 메뉴로 이동하세요. 단일 서버 정보에는 보통 프로토콜 유형, 주소, 포트, 인증 정보가 포함됩니다. 구독은 서버 목록을 가져오는 전체 링크입니다. 겉모양이 비슷하다고 서로 바꿔 쓸 수 있는 것은 아니며, 구독 주소를 일반 서버의 Host에 입력해서도 안 됩니다. Shadowrocket을 열고 Home의 SERVER 영역에서 Add Server를 찾거나 화면의 추가 메뉴를 통해 Add Server로 이동합니다.

직접 입력: Type을 선택하고 항목 확인

Add Server에서 먼저 Type을 누르고 보유한 정보와 일치하는 프로토콜을 선택합니다. Type에 따라 필요한 항목이 달라지므로 입력을 줄이려고 임의로 바꾸면 안 됩니다. 예를 들어 Shadowsocks는 Host, Port, Password, Method를 확인해야 합니다. 다른 유형은 별도의 인증 정보나 전송 매개변수가 필요할 수 있습니다. 스크린샷은 한 가지 입력 양식의 예이며 모든 프로토콜에 같은 항목이 적용되는 것은 아닙니다.

항목을 입력할 때 Host에는 서버 주소, Port에는 서버가 실제로 수신 대기하는 포트, Password와 Method에는 각각 보유한 원본 정보를 입력합니다. 복사한 뒤 앞뒤 공백, 줄바꿈, 전각 문자가 섞이지 않았는지 확인하세요. 특히 주소와 설명 문구를 함께 붙여 넣지 않도록 주의합니다. 추가 매개변수가 있다면 해당 설정을 펼쳐 하나씩 확인하세요. 필요한 정보가 없다면 추측해서 입력하지 말고 본인의 서버 설정을 확인하거나 기존 서비스 제공업체에 문의하세요.

입력이 끝나면 화면의 저장 기능을 사용하고 Home으로 돌아갑니다. SERVER에 방금 저장한 항목이 표시되는지 확인한 뒤 사용할 서버를 선택하세요. Scan QR Code는 본인이 보유한 지원 형식의 QR 코드를 가져올 때 적합합니다. Import from Cloud JSON은 해당 형식의 데이터가 있어야 사용할 수 있으며, 임의의 링크를 가져오는 일반 메뉴가 아닙니다.

구독 가져오기: Subscribe를 선택하고 전체 링크 유지

구독 링크를 보유한 경우 Add Server의 Type에서 Subscribe를 선택한 다음 전체 링크를 해당 URL 항목에 붙여 넣습니다. 필요하면 알아보기 쉬운 이름을 입력하고 저장하세요. 링크의 경로, 물음표 뒤의 매개변수, 대소문자는 원래대로 유지해야 합니다. 도메인만 복사하거나 링크 뒤에 붙은 마침표나 따옴표까지 포함하지 마세요.

https://example.com/sub?token=xxxx

위 내용은 명백한 가짜 값으로 만든 형식 예시이며 실제로 사용할 수 있는 구독이 아닙니다. 저장하고 구독 내용을 가져온 뒤 Home으로 돌아와 SERVER에 실제 서버 항목이 표시되는지 확인하세요. 구독 이름만 보인다고 내용까지 정상적으로 가져온 것은 아닙니다. 앱에서 제공하는 구독 업데이트 기능으로 다시 가져온 다음 항목이 빠짐없이 표시되는지도 확인하세요. 이 단계에서는 모드를 반복해서 바꾸지 말고, 다음 단계에서 Global Routing을 한꺼번에 확인합니다.

단계 02 / 요청 처리 방식 선택

Global Routing 선택

서버를 가져온 뒤 Home으로 돌아와 Global Routing을 누릅니다. 여기서는 요청의 라우팅 방식을 정합니다. 사용할 서버를 선택하는 것과는 별개의 설정입니다. 처음 사용할 때는 세 가지 모드인 Config / Proxy / Direct를 먼저 알아두세요. 스위치가 켜져 있다고 해서 모든 요청이 선택한 서버를 거치는 것은 아닙니다.

Config: 현재 설정에 따라 트래픽 분기

규칙에 따라 요청을 구분하려면 Config를 사용합니다. 먼저 Config로 이동해 현재 활성화된 구성 파일을 확인하세요. 파일 목록에 익숙한 이름이 있는지만 확인해서는 안 됩니다. 해당 구성을 열어 Rule과 마지막 처리 방식을 확인합니다. 구성의 규칙에 따라 요청이 PROXY, DIRECT 또는 REJECT로 처리됩니다. 일반적으로 규칙은 순서대로 적용되므로, 범위가 넓은 규칙이 앞에 있으면 뒤의 구체적인 규칙이 적용되지 않을 수 있습니다.

공식 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 구성 편집 화면의 각 섹션입니다. 처음 설정할 때는 현재 구성과 Rule을 확인하는 것이 핵심이며, 모든 섹션을 활성화할 필요는 없습니다. 첫 연결을 위해 HTTPS Decryption을 변경하거나 관련 인증서를 설치하지 마세요. 이 가이드의 사전 단계가 아닙니다.

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

이 짧은 예시는 규칙 순서를 이해하기 위한 것입니다. example.com과 하위 도메인은 첫 번째 규칙에 일치하고, 나머지 요청은 FINAL을 통해 직접 연결됩니다. 모든 용도에 적합한 완성된 구성은 아니므로 확인 없이 기존 파일을 덮어쓰지 마세요. 대상이 원래 프록시를 거쳐야 하는데 FINAL,DIRECT로 처리된다면 서버 연결이 정상이어도 트래픽 분기가 예상대로 작동한다고 볼 수 없습니다.

Proxy와 Direct: 경로 비교에 사용

Proxy는 일반 요청을 프록시 경로로 처리하므로 문제 해결 중 Rule 분기로 인한 변수를 줄이는 데 유용합니다. 단, 기기의 네트워크, 서버 기능, 필요한 시스템 우회 설정 등의 영향을 받으므로 모든 트래픽이 동일하게 작동한다고 보장할 수는 없습니다. Direct는 요청을 직접 연결하며 기본 네트워크를 확인하거나 직접 접속을 복구할 때 적합합니다. 프록시 사용 가능 여부를 판단하는 테스트 결과로 사용해서는 안 됩니다.

모드를 선택한 뒤 Home으로 돌아와 현재 Global Routing 값을 다시 확인하세요. Config를 사용할 예정이라면 현재 활성화된 구성 이름도 기억해 두어야 나중에 확인한 결과를 규칙과 대조할 수 있습니다. 더 자세한 규칙 작성법은 구성 전체 가이드에서 확인하세요. 정책과 규칙 용어가 익숙하지 않다면 먼저 용어 빠른 참조를 살펴보고 이 페이지에서 연결 절차를 이어가세요.

단계 03 / 기기에서 연결 설정

스위치를 켜고 VPN 승인 확인

Home으로 돌아와 연결하기 전에 한 번 더 확인합니다. SERVER에서 이번에 테스트할 서버를 선택했는지, Global Routing에 방금 결정한 모드가 표시되는지 살펴보세요. 구독 항목은 업데이트 후 달라질 수 있으므로 이전에 선택했던 항목을 기억에 의존해 진행하지 마세요. 준비가 되면 Home 상단의 연결 스위치를 켭니다. 연결되지 않은 상태에서는 Not Connected가 표시될 수 있습니다.

처음 연결할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 이는 앱이 기기의 네트워크 경로를 설정하기 위한 시스템 승인으로, 앱을 다시 구매하는 절차가 아닙니다. 방금 실행한 Shadowrocket에서 요청한 작업인지 확인한 다음 시스템 안내에 따라 허용하고 필요한 기기 인증을 완료하세요. 취소를 선택했다면 Home으로 돌아가 연결을 다시 시작하고 승인을 완료해야 할 수 있습니다.

승인이 완료되면 앱으로 돌아와 상단 상태가 연결되지 않음에서 연결됨으로 바뀌었는지, 스위치가 계속 켜져 있는지 확인합니다. 스위치가 곧바로 꺼져도 앱을 반복해서 재설치하거나 여러 설정을 연달아 바꾸지 마세요. 시스템 안내, 앱 오류, 연결 중단이 있었는지 먼저 기록한 다음 마지막 단계에서 발생 위치에 따라 확인하세요.

연결 상태와 서버 사용 가능 여부는 따로 확인

시스템 VPN 경로가 설정되었다는 것은 기기의 연결 기능이 시작되었다는 뜻일 뿐, 선택한 서버의 인증이 성공했거나 모든 대상에 접속할 수 있다는 의미는 아닙니다. 반대로 Connectivity Test에서 서버 응답을 확인해도 연결 스위치가 켜져 있다는 뜻은 아닙니다. 처음 사용할 때는 ‘항목 선택’, ‘모드 설정’, ‘경로 설정’을 각각 확인한 다음 실제 접속을 테스트하세요.

기기에서 직접 활성화한 다른 VPN 연결이 있다면 테스트 전에 현재 어떤 연결이 사용 중인지 확인하세요. 다른 연결의 결과를 Shadowrocket의 결과로 착각할 수 있습니다. 이번 테스트 동안은 네트워크 환경을 그대로 유지하세요. Wi-Fi와 셀룰러 네트워크를 바꾸면서 서버와 모드까지 함께 변경하면 실패 원인을 파악하기 어렵습니다.

단계 05 / 한 번에 한 가지씩 변경

설정 확인 및 자주 발생하는 문제

문제 해결은 ‘모두 재설정’부터 시작하지 말고 문제가 발생한 위치부터 확인하세요. 가져오기 실패, 서버 접속 불가, 연결 스위치가 꺼짐, 특정 대상 접속 실패는 서로 다른 단계의 문제입니다. 현재 작동하는 설정은 유지하고 변경 전 원래 값을 기록하세요. 한 가지를 조정할 때마다 이전 단계에서 같은 테스트를 반복해 실제로 관련이 있는지 확인합니다.

구독을 저장했지만 SERVER에 항목이 표시되지 않음

먼저 Type이 Subscribe인지 확인한 다음 URL이 완전한지, 채팅 앱에서 잘렸거나 공백 또는 문장부호가 들어가지는 않았는지 살펴보세요. 구독 업데이트 시 표시된 구체적인 오류를 확인하세요. 내용을 가져오지 못한 문제와 지원되지 않는 내용을 가져온 문제는 다릅니다. 구독 주소가 로그인 페이지나 일반 웹페이지를 반환한다면 서버 목록으로 사용할 수 없습니다. 인증 정보가 포함된 링크를 브라우저에 붙여 넣거나 함부로 공유하지 마세요. 유효 기간과 반환 형식을 확인하려면 기존 서비스 제공업체에 문의하세요.

서버는 표시되지만 테스트 또는 연결에 실패

해당 항목의 편집 화면으로 이동해 Type, Host, Port와 관련 인증 정보를 원본 자료와 대조하세요. 프로토콜마다 필요한 매개변수가 다르므로 한 프로토콜에서 쓰이는 필드의 의미를 다른 프로토콜에 그대로 적용하지 마세요. 이전에는 작동했는데 지금 실패한다면 먼저 네트워크가 바뀌었는지 확인한 다음 서버가 여전히 작동하는지 살펴보세요. 서버 하나의 실패만으로 구독의 모든 항목이 사용할 수 없다고 결론 내리지 말고, 근거 없이 모든 항목을 한꺼번에 수정하지 마세요.

테스트 결과는 있지만 웹페이지가 열리지 않음

먼저 Global Routing을 확인하고 대상에 예상한 규칙이 적용되었는지 살펴본 다음 도메인 확인, 연결 수립, 웹페이지 자체의 오류를 구분하세요. Settings에서 Test Method를 확인해 방금 Connectivity Test가 무엇을 테스트했는지 알아보세요. 특정 테스트에 응답이 왔다고 해서 인증, 전송 매개변수, 대상 서비스 문제까지 배제할 수는 없습니다. 앱에서 관련 요청 정보를 확인할 수 있다면 실패 단계에 따라 원인을 좁히세요. 더 자세한 규칙 및 DNS 분석은 구성 전체 가이드에서 항목별로 확인할 수 있습니다.

수동으로 연결을 끊었다가 다시 연결하거나 네트워크 전환 후 동작이 달라짐

Settings에서 On Demand를 찾아 연결 조건이 설정되어 있는지 확인하세요. 수동 연결 문제를 확인할 때는 직접 활성화한 On Demand 조건을 잠시 중지해 스위치를 수동으로 제어할 수 있는지 살펴봅니다. 테스트를 마친 뒤 필요한 설정으로 복원하세요. Wi-Fi와 셀룰러 네트워크를 전환하면 네트워크 조건이 달라지므로 이전 네트워크의 테스트 결과를 그대로 적용하지 말고 다시 확인해야 합니다.

Diagnostics 사용 시 확인 범위를 먼저 좁히세요

Settings의 Diagnostics는 추가 점검에 사용할 수 있습니다. 먼저 확인할 문제를 정한 뒤 현재 버전에서 제공하는 해당 항목을 사용하세요. Proxy, TCP, UDP 관련 설정은 이름이 익숙하다는 이유만으로 한꺼번에 바꾸지 마세요. 전송 방식에 따라 장애 증상이 다르며 관련 없는 설정을 조정하면 확인해야 할 변수가 늘어날 뿐입니다. 진단 자료를 정리할 때는 오류 설명과 재현 단계만 남기고 공유 전에 서버 인증 정보, 구독 매개변수, 기타 개인 정보를 삭제하세요.

다섯 단계를 모두 확인했는데도 특정 대상이나 네트워크에서만 문제가 발생한다면 ‘네트워크, 모드, 대상, 오류’를 기록해 최소 재현 절차를 남기세요. 서버 정보와 서비스 상태는 기존 서비스 제공업체에 문의하고, 규칙의 의미는 매뉴얼에서 확인하세요. 연결 복구를 위해 앱을 다시 구매할 필요는 없습니다. Shadowrocket 앱 구매와 기존 서비스의 사용 가능 여부는 별개의 문제입니다.