공식 가이드 · 첫 연결

Shadowrocket 사용 가이드

기존 구독 또는 서버 정보에서 시작해 가져오기, Global Routing 선택, 연결 켜기, 접속 확인, 실패 원인 찾기를 순서대로 진행합니다. 처음 작업한다면 약 10분 정도 잡아두세요. 오류가 발생하면 처음부터 초기화하지 말고 해당 단계에서 내용을 확인하면 됩니다.

작업 전에 원본 구독 또는 매개변수를 보관하세요. 구독 링크에는 인증 정보가 포함되는 경우가 많으므로 공개적으로 붙여넣지 말고, 링크 전체가 보이는 스크린샷을 문의에 사용하지 마세요.

01 · Add Server: 서버 추가 또는 구독 가져오기

Shadowrocket을 열고 Home으로 이동한 다음, 보유한 정보의 유형을 구분합니다. 구독 링크 하나로 여러 서버 항목을 가져올 수 있습니다. 수동 설정에는 프로토콜, 서버 주소, 포트 및 인증 필드가 포함됩니다. 두 정보는 입력 방식이 다릅니다. 구독 링크 전체를 서버 주소에 입력하거나 관리 계정 웹페이지 주소를 구독 URL로 사용하지 마세요.

Subscribe로 기존 구독 가져오기

Home에서 오른쪽 상단의 추가 버튼을 누르고 Add Server로 이동합니다. Type을 열고 Subscribe를 선택한 다음, 이용 중인 서비스 제공업체에서 받은 전체 구독 링크를 URL에 입력합니다. 메모에는 “개인 구독”처럼 알아보기 쉬운 이름을 적고 오른쪽 상단의 완료 버튼을 눌러 저장할 수 있습니다. 링크를 복사할 때 앞뒤 공백, 줄바꿈, 잘림 여부를 확인하세요. 링크의 쿼리 매개변수도 주소의 일부이므로 표시를 짧게 하려고 삭제하지 마세요.

저장 후 Home으로 돌아가 구독 콘텐츠가 로드될 때까지 기다립니다. 이름만 표시된 것을 가져오기가 완료된 것으로 생각하지 말고, 구독 그룹 아래에 서버 항목이 나타났는지 확인하세요. 현재 화면에서 구독 업데이트 기능을 제공한다면 한 번 업데이트해 오류가 반환되는지 살펴봅니다. 가져오기에 실패하면 먼저 안내 문구를 보관하고 링크의 유효성과 클라이언트가 인식할 수 있는 구독 형식으로 콘텐츠가 반환되는지 확인하세요. 일반 웹페이지, 로그인 페이지 또는 오류 페이지는 유효한 서버 목록으로 사용할 수 없습니다.

Add Server로 매개변수 직접 입력

단일 서버의 매개변수가 있다면 Home의 추가 버튼으로 Add Server에 들어갑니다. Type에서 매개변수에 맞는 프로토콜을 선택하고 원본 정보를 보면서 주소, 포트, 인증 정보를 하나씩 입력합니다. 프로토콜에 따라 비밀번호나 UUID 등 입력 필드가 다를 수 있습니다. TLS, Server Name, 전송 방식 또는 경로가 있다면 원본 매개변수와 동일하게 입력하세요. 화면에서 요구하지 않는 필드를 경험에만 의존해 채울 필요는 없습니다. 두 프로토콜에서 주소와 포트를 입력할 수 있다는 이유만으로 서로 바꿔 사용할 수는 없습니다.

저장한 뒤 Home으로 돌아와 사용할 서버를 눌러 선택 표시가 해당 항목에 있는지 확인합니다. 처음 테스트할 때는 서버 하나를 고정하고, 항목을 바꾸거나 설정을 수정하는 작업을 동시에 하지 않는 편이 좋습니다. 목록에 서버가 나타났다는 것은 정보가 저장되었다는 뜻일 뿐, 원격 서버에 접속할 수 있거나 계정이 유효하다는 뜻은 아닙니다. 프로토콜 필드가 헷갈리면용어 빠른 확인을 읽고 서비스 제공업체에 매개변수의 의미를 확인하세요.

이 단계의 완료 기준:Home에 실제 서버 항목이 표시되고 그중 하나가 선택되어 있어야 합니다. 다음으로 트래픽 처리 방식을 선택한 뒤 연결 스위치를 켭니다.

02 · Global Routing: 트래픽 처리 방식 선택

Home에서 Global Routing을 찾아 엽니다. 여기서는 연결에 적용할 전체 처리 방식을 정합니다. 구독 업데이트 버튼이나 서버 선택기가 아닙니다. 이 문서에서는 세 가지 방식을 Config / Proxy / Direct로 표기합니다. 서버를 올바르게 선택했더라도 이 설정을 확인해야 합니다. 그렇지 않으면 스위치를 켜도 예상과 다른 접속 결과가 나올 수 있습니다.

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

일상적으로 규칙에 따라 요청을 처리하려면 Config를 선택한 다음 Config 페이지에서 현재 사용 중인 구성을 확인합니다. 구성 파일의 규칙에 따라 요청에 PROXY, DIRECT 또는 REJECT 등의 정책이 적용됩니다. 구독 가져오기와 규칙 설정은 별개의 작업입니다. 서버 목록 업데이트에 성공해도 규칙 파일이 설치된 것은 아닙니다. 화면을 “완성된 것처럼” 보이게 하려고 출처가 불분명한 원격 구성을 가져오지 마세요. 기존 구성은 용도를 먼저 확인한 뒤 적용해야 합니다.

Config에서 문제가 발생하면 구체적인 대상에 따라 판단해야 합니다. 예를 들어 어떤 도메인이 규칙에 따라 DIRECT로 처리되는데 선택한 서버를 통과할 것으로 예상했다면, 이는 서버 연결이 불가능한 문제가 아니라 규칙이나 정책 선택의 문제일 수 있습니다. 처음에는 “현재 어떤 구성을 사용 중인지, 현재 대상에 어떤 정책이 적용되어야 하는지”만 파악하면 됩니다. 전체 규칙을 다시 작성할 필요는 없습니다. 규칙 매칭 순서와 정책 참조는사용 설명서에서 더 확인할 수 있습니다.

Proxy: 프록시 경로 비교 확인

Proxy를 사용하면 규칙 분기로 인한 변수를 줄여 현재 프록시 경로가 대상 요청을 처리할 수 있는지 확인할 수 있습니다. Proxy에서 대상에 접속되지만 Config에서는 접속되지 않는다면 구독을 바로 삭제하지 말고 현재 구성의 규칙과 정책을 먼저 확인하세요. Proxy 테스트 결과도 서버 상태, 서비스 권한, 대상 웹사이트와 네트워크 환경의 영향을 받습니다. 방식을 바꾸는 것만으로 모든 문제가 해결되는 것은 아닙니다.

Direct: 기존 네트워크와 비교 확인

Direct는 요청을 직접 연결하므로 기존 네트워크에서 같은 대상에 접속할 수 있는지 비교할 때 사용할 수 있습니다. Direct를 선택한 뒤에도 연결 상태가 표시될 수 있지만, 요청이 프록시 서버를 통과하고 있다는 뜻은 아닙니다. 비교 테스트가 끝나면 실제로 필요한 방식으로 돌아가세요. 이후의 판단이 혼란스럽지 않도록 현재 서버와 Global Routing의 조합을 기록한 뒤 다음 단계로 진행합니다.

03 · Home: 연결을 켜고 시스템 권한 확인

Home으로 돌아와 선택한 서버와 Global Routing을 다시 확인한 뒤 상단의 연결 스위치를 켭니다. 처음 사용할 때는 시스템에서 VPN 구성 추가를 허용하라는 메시지가 나타날 수 있습니다. 시스템 안내를 읽고 Shadowrocket의 구성을 추가하는지 확인한 다음, 기기 소유자가 기기 암호 또는 시스템 인증 방식으로 권한을 승인합니다. 서버 비밀번호나 구독의 인증 정보를 기기 잠금 해제 안내에 입력하지 마세요.

권한을 승인한 뒤 Shadowrocket으로 돌아와 스위치와 연결 상태가 유지되는지 확인합니다. VPN 상태가 표시되는 위치는 시스템마다 다를 수 있으므로 앱의 상태와 이후 실제 접속 결과를 함께 확인하세요. 상태 표시줄 아이콘만 확인할 필요는 없습니다. 시스템 요구 사항과 호환 범위는 App Store 페이지에 표시된 내용을 기준으로 합니다. 화면의 메뉴 위치가 문서와 조금 다르면 먼저 영문 항목 이름을 확인한 뒤 조작하세요.

스위치가 바로 꺼지거나 오류 메시지가 나타나면 먼저 원문을 기록합니다. 시스템 설정으로 돌아가 처리되지 않은 VPN 권한이 있는지 또는 기기가 조직 관리 정책의 제한을 받는지 확인하세요. 다른 VPN 연결이 이미 있다면 이를 먼저 끊고 Shadowrocket만 단독으로 테스트해 여러 연결 조건이 판단에 영향을 주지 않도록 합니다. 관리되는 기기는 관리 요구 사항을 따르고, 관리 설정을 삭제해 문제를 해결하려고 하지 마세요.

이 단계에서는 On Demand를 동시에 켜거나 수정하지 않는 것이 좋습니다. 먼저 수동으로 반복할 수 있는 연결을 설정한 다음 조건별 연결을 일상 설정으로 고려하세요. On Demand는 연결 시점을, Global Routing은 연결 후 요청 처리 방식을 제어하므로 서로 다른 문제를 해결합니다. 두 설정을 나누어 진행하면 연결 실패 원인을 더 빠르게 찾을 수 있습니다.

이 단계의 완료 기준:시스템 권한 승인 후 Home의 연결 상태가 유지되고 오류가 계속 나타나지 않아야 합니다. 이 상태는 연결 절차가 시작되었다는 뜻일 뿐입니다. 서버가 요청을 처리할 수 있는지, 규칙이 예상대로 적용되는지는 다음 단계에서 확인해야 합니다.

04 · Connectivity Test: 연결 및 실제 접속 확인

먼저 Home에서 Connectivity Test를 실행해 선택한 서버의 테스트 결과를 확인합니다. 테스트에 실패했다면 일시적인 변동인지 확인하기 위해 한 번 더 실행할 수 있지만, 모든 설정을 연달아 빠르게 바꾸지는 마세요. 테스트에서 반환된 시간은 해당 시점의 테스트 대상과 방식에 대한 결과일 뿐 웹페이지 로딩 속도나 파일 전송 속도와 같지 않으며, 모든 앱에 규칙이 적용되었다는 증거도 아닙니다.

그런 다음 브라우저를 열어 원래 사용하려던 구체적인 대상에 접속하고 페이지를 연 뒤 내부 페이지로 이동하는 등 실제 작업을 수행합니다. 이전에 캐시된 홈페이지가 보이는 것만으로는 연결이 확인되지 않습니다. 페이지를 새로고침하거나 새 브라우저 탭에서 다시 시도할 수 있습니다. 브라우저에서는 접속되지만 특정 앱에서 접속되지 않는다면 해당 앱의 대상 도메인, 계정 상태, 오류 메시지를 각각 확인해야 합니다. 이를 근거로 전체 연결이 실패했다고 단정하지 마세요.

같은 대상을 사용해 방식별 비교

결과가 확실하지 않다면 서버를 그대로 둔 상태에서 같은 대상을 Direct, Proxy, Config 순서로 비교합니다. 방식을 바꿀 때마다 요청을 새로 보내고, 기존 연결이 판단에 영향을 주지 않도록 필요한 경우 이전 페이지를 닫았다가 다시 엽니다. 원래 Direct로 접속할 수 있는 대상이라면 “열렸다”는 사실만으로 프록시 경로가 작동한다고 확인할 수 없습니다. Proxy에서는 성공하지만 Config에서 실패한다면 현재 구성을 확인하는 것이 좋습니다.

앱에서 제공하는 요청 기록에서 방금 요청한 대상을 찾아 적용된 정책과 규칙을 확인합니다. DIRECT가 표시되면 구성이 실제로 그렇게 처리하도록 되어 있는지 판단합니다. REJECT가 표시되면 해당 대상을 거부하는 규칙이 있는지 확인합니다. PROXY가 표시되는데도 실패한다면 선택한 서버, 원격 응답, 대상 자체의 상태를 계속 확인하세요. 기록은 실제로 일어난 일을 보여줄 뿐이며, 모든 DIRECT를 오류로 간주해서는 안 됩니다.

Data의 트래픽 변화는 참고 자료로 확인할 수 있지만, 백그라운드 요청으로도 트래픽이 증가할 수 있으므로 특정 대상에 접속했다는 증거로 단독 사용하지 마세요. 제대로 확인하려면 연결 상태 유지, 실제 대상 요청 완료, 예상한 처리 정책 적용의 세 가지를 모두 확인해야 합니다. 이를 확인한 뒤 평소 필요한 Config로 돌아가 현재 작동하는 설정을 이후 문제 해결의 기준으로 보관하세요.

05 · 일반적인 실패 원인: 발생 단계별 점검

문제를 해결할 때는 먼저 “어느 단계에서 멈췄는지” 확인한 뒤 해당 설정을 조정합니다. 한 번에 조건 하나만 바꾸고 같은 대상을 다시 테스트하세요. 바로 재설치하면 아직 백업하지 않은 정보가 사라질 수 있고 유용한 현장 정보도 없어집니다. 보통은 오류와 매개변수, 현재 구성을 기록한 뒤 다시 가져올지 결정하는 것이 좋습니다.

구독을 저장했지만 서버가 보이지 않음

구독 항목으로 돌아가 URL 전체를 복사했는지, 구독 주소가 아닌 관리 웹페이지를 복사하지 않았는지, 링크가 만료되었거나 서버에서 재설정되지 않았는지 확인합니다. 업데이트 후에는 콘텐츠를 다운로드하기 전에 오류가 발생했는지, 콘텐츠를 해석할 때 발생했는지 구분하세요. 전자는 현재 네트워크와 링크 접속 가능성을 먼저 확인하고, 후자는 구독 형식을 먼저 확인합니다. 서비스 제공업체의 도움이 필요하면 전체 URL을 공개하지 말고 오류 문구와 발생 단계를 전달하세요.

서버는 있지만 테스트 시간이 초과됨

먼저 연결을 끄고 기기의 기존 Wi-Fi 또는 셀룰러 네트워크가 정상적으로 인터넷에 연결되는지 확인합니다. 웹페이지 로그인이 필요한 네트워크라면 먼저 로그인하세요. 그런 다음 주소, 포트, 프로토콜, 인증 및 TLS 관련 필드를 확인하고 수동 입력이 빠짐없이 되었는지 살펴봅니다. 기존 구독에 작동이 확인된 다른 항목이 있다면 규칙을 수정하지 않고 다른 항목으로 다시 테스트해 단일 서버 문제인지 로컬 네트워크 문제인지 구분할 수 있습니다. 테스트 시간 초과만으로 어떤 항목에 문제가 있는지 확정할 수는 없습니다.

Proxy에서는 접속되지만 Config 결과가 예상과 다름

Config 페이지에서 실제로 선택된 파일을 확인하세요. 파일 목록에 이름이 있는지만 보면 안 됩니다. 이어서 방금 전 요청 기록에서 매칭된 규칙과 정책을 확인해 대상에 더 앞선 규칙이 먼저 적용되었는지 살펴봅니다. 수정하기 전에 백업하세요. 확신이 없다면 DNS, 규칙, 정책 설정을 한꺼번에 바꾸지 마세요. DOMAIN-SUFFIX, IP-CIDR, FINAL의 상세 동작은사용 설명서에서 해당 장을 확인하세요.

연결 후 일부 대상에 접속되지 않거나 네트워크 전환 후 끊김

Wi-Fi, 셀룰러 네트워크 중 어느 쪽에서 실패했는지 또는 양쪽 모두에서 발생했는지 기록합니다. 네트워크를 전환할 때마다 연결을 다시 설정하고 대상 요청을 새로 실행하세요. 일부 대상에서만 실패한다면 대상 자체의 상태, 규칙 처리, DNS 관련 오류를 각각 확인합니다. 시간 초과 한 번만 보고 모든 DNS 설정을 바꾸지 마세요. On Demand를 사용 중이라면 먼저 수동 연결 테스트로 돌아가 기본 경로가 작동하는지 확인한 다음 연결 조건을 하나씩 복원하세요.

여전히 원인을 찾지 못했다면 선택한 서버 유형, Global Routing 방식, 실패한 대상과 오류 원문, 이미 수행한 개별 비교 등 네 가지 정보를 정리하세요. 공유하기 전에 구독 URL, 비밀번호, UUID, 개인 서버 주소를 가립니다. 권한, 계정, 연결 문제는FAQ에서, 인터페이스 용어는용어 빠른 확인에서 살펴볼 수 있습니다.

연결 확인 후: 작동하는 구성 보관

처음 확인을 마친 뒤 현재 선택한 Config와 서버를 기록하고 본인의 관리 방식에 따라 구성을 백업합니다. 이후 구독을 업데이트하거나 규칙을 수정하거나 On Demand를 조정할 때는 기존 설정을 먼저 저장한 다음 하나씩 테스트하세요. 구독 업데이트로 목록 항목이 바뀔 수 있으므로 업데이트 후에는 선택한 서버를 다시 확인합니다. 이름이 비슷하다는 이유만으로 이전 연결과 같다고 판단하지 마세요.

이 문서에서는 반복해서 확인할 수 있는 수동 연결을 완료했습니다. 다음 설정을 진행하려면Shadowrocket 사용 설명서에서 필요한 Config, On Demand, Data 및 일상 관리 항목을 확인하세요.

Shadowrocket 전체 플랫폼 다운로드