공식 매뉴얼 / 첫 연결

Shadowrocket 구독 가져오기 및 연결 방법

기존 연결 정보를 준비한 뒤 가져오기, 라우팅, 연결, 확인, 문제 해결 순서로 진행하세요. 재현 가능한 연결을 먼저 확인하고 규칙과 자동 연결 설정은 나중에 조정하세요.

  • Home → Add Server
  • Global Routing
  • Connectivity Test

이 페이지의 목표는 첫 연결을 완료하는 것입니다. 앱 인터페이스의 용어는 영어 원문으로 표기합니다. 버튼 위치는 기기와 앱 화면에 따라 달라질 수 있으니 이름을 기준으로 메뉴를 찾으세요. 연결 정보가 준비되어 있다면 모든 설정 매개변수를 먼저 익히지 않아도 순서대로 확인할 수 있습니다.

단계 01 / 서버 목록 만들기

Add Server: 서버 추가 또는 Subscribe 가져오기

Shadowrocket을 열고 Home으로 이동합니다. 처음 사용하는 경우 목록에 서버가 없을 수 있습니다. 이는 연결 정보를 아직 가져오지 않은 상태일 뿐, 설치 실패가 아닙니다. 먼저 보유한 정보가 서버 목록을 갱신하는 구독 URL인지, 단일 서버 공유 링크인지, 주소·포트·인증 정보가 담긴 설정 안내인지 확인하세요. 정보 유형에 따라 가져오는 방법이 다르므로 구독 URL을 서버 주소 입력란에 넣지 마세요.

구독 URL이 있는 경우: Subscribe 사용

Home 오른쪽 상단의 추가 버튼을 눌러 Add Server를 열고 Type에서 Subscribe를 선택합니다. 입력 화면으로 돌아와 전체 구독 주소를 URL에 붙여 넣고, Remarks에는 알아보기 쉬운 이름을 입력한 뒤 저장합니다. 붙여 넣기 전후에 공백, 줄 바꿈, 설명 문구가 포함되지 않았는지 확인하세요. 주소의 쿼리 매개변수도 유지해야 하며 도메인 부분만 복사해서는 안 됩니다.

저장한 뒤 Home으로 돌아가 구독 정보를 불러올 때까지 기다린 다음 구독 그룹과 서버 항목이 표시되는지 확인합니다. 구독 이름만 저장되고 선택할 서버가 없다면 같은 주소를 반복해서 추가하지 말고 가져오기 결과부터 확인하세요. 구독 주소에는 보통 접근 인증 정보가 포함되므로 비밀번호처럼 안전하게 보관해야 합니다. 문제를 설명할 때 전체 URL이나 인증 정보가 담긴 QR 코드를 보내지 마세요.

단일 서버 정보가 있는 경우: 프로토콜에 맞춰 입력하거나 가져오기

매개변수 정보를 받은 경우 Add Server의 Type에서 원본 안내에 표시된 프로토콜을 선택한 뒤 서버 주소, 포트, 인증 정보를 입력합니다. 이름만 보고 프로토콜을 추측하거나 도메인을 확인된 IP 주소로 임의 변경하지 마세요. 일부 연결은 기존 도메인과 관련 TLS 설정에 의존합니다. 전송 방식, 경로 또는 추가 필드가 있다면 서비스 제공업체가 안내한 정보와 항목별로 대조하고, 안내되지 않은 값은 임의로 입력하지 마세요.

공유 QR 코드가 있다면 Scan QR Code를 선택하고 시스템 안내에 따라 카메라 권한을 허용합니다. 공유 링크가 있다면 클라이언트에 표시되는 클립보드 가져오기 안내에 따라 진행하세요. 안내가 표시되지 않으면 웹페이지 제목이 아니라 전체 공유 내용을 복사했는지 먼저 확인합니다. QR 코드나 링크를 가져온 후에도 항목 유형과 주소를 확인하세요. 가져오기에 성공했다는 것은 클라이언트가 정보를 인식했다는 뜻일 뿐 서버가 작동한다는 보장은 아닙니다.

마지막으로 Home에서 사용할 서버를 선택해 현재 선택 항목으로 표시되는지 확인합니다. 뒤이어 연결을 검증할 서버 하나만 선택하면 되며, 목록 순서는 지금 조정하지 않아도 됩니다. 구독 갱신, 중복 항목, 백업은 구독 및 서버 관리 매뉴얼을 참고하세요. 여기서는 계속해서 Global Routing을 설정합니다.

완료 기준: Home에 선택할 수 있는 서버가 있고 그중 하나가 명확히 선택되어 있습니다.

단계 02 / 트래픽 경로 정하기

Global Routing: Config / Proxy / Direct 선택

서버는 “어떤 연결 경로를 사용할지” 정하고, Global Routing은 “어떤 연결에 이 경로를 적용할지” 정합니다. Home에서 Global Routing을 열어 Config / Proxy / Direct 세 가지 모드를 확인하세요. 목록에 서버가 있거나 연결 스위치가 켜져 있다는 사실만으로 모든 요청이 선택한 서버를 거친다고 볼 수는 없습니다. 실제 트래픽 경로는 이 설정에도 영향을 받습니다.

Config: 현재 설정의 규칙에 따라 처리

Config는 현재 활성화된 설정의 규칙에 따라 요청을 처리합니다. DIRECT에 일치하는 트래픽은 직접 연결하고, PROXY에 일치하는 트래픽은 해당 프록시 정책을 사용합니다. 사용하기 전에 Config로 이동해 어떤 설정이 활성화되어 있는지와 기본 용도를 확인하세요. 구독을 가져왔다고 해서 전체 규칙 설정까지 함께 가져온 것은 아닙니다. Home에 구독 그룹이 표시되어도 Config가 전환되었다는 뜻은 아닙니다.

용도에 맞는 신뢰할 수 있는 설정이 있다면 일상적인 연결에 Config를 사용할 수 있습니다. 첫 연결을 완료하려고 설정 전체를 임의로 바꾸지 마세요. 설정 파일에는 DNS, 정책 그룹 등이 포함될 수 있어 교체하면 문제 원인을 찾기가 더 어려워집니다. 이 페이지에서 규칙을 모두 익힐 필요는 없습니다. 나중에 복원할 수 있도록 현재 설정 이름을 기록해 두세요.

Proxy와 Direct: 비교 테스트에 사용

Proxy를 선택하면 클라이언트가 처리하는 트래픽이 프록시 경로를 사용합니다. 선택한 서버로 실제 접속이 가능한지 임시로 확인할 때 유용하지만 기기의 모든 통신이 해당 경로를 거친다는 뜻은 아닙니다. Direct를 선택하면 처리 대상 트래픽이 직접 연결됩니다. 기본 네트워크를 비교하는 데 사용할 수 있으며, “더 안정적인 프록시 연결”을 의미하는 모드는 아닙니다. 해당 요청은 선택한 서버를 통해 전달되지 않습니다.

첫 점검에서 규칙이 테스트에 영향을 주는지 확실하지 않다면 원래 선택을 기록해 두고 Proxy로 임시 전환해 접속을 한 번 확인한 뒤 Config로 복원해 같은 테스트를 반복하세요. 결과가 다르면 서버를 바로 삭제하기보다 설정과 정책을 먼저 확인합니다. 어떤 모드를 선택하든 설정 후 Home으로 돌아가 다음 단계에서 연결 스위치를 조작하세요.

완료 기준: 현재 선택한 모드와 용도를 설명할 수 있고 임시 테스트 후 어떤 모드로 복원해야 하는지 알고 있습니다.

단계 03 / 시스템 연결 설정

Home: 연결 스위치 켜기 및 첫 VPN 권한 승인

Home으로 돌아가 현재 서버와 Global Routing을 다시 확인합니다. 목록을 살펴보다 다른 항목을 잘못 선택하지 않았는지 확인한 다음 상단의 연결 스위치를 켭니다. 첫 연결을 설정할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. 이는 클라이언트가 관련 네트워크 트래픽을 처리하는 데 필요한 시스템 권한이며 앱을 다시 구매하라는 뜻도, 구독이 작동한다는 증거도 아닙니다.

시스템 안내에서 요청 앱이 Shadowrocket인지 확인하고 내용을 읽은 뒤 구성을 허용합니다. 기기에서 요구하면 본인 인증을 완료하세요. 취소하거나 거부하면 클라이언트가 연결을 설정하지 못할 수 있습니다. 이 경우 Home으로 돌아가 다시 시도하고 시스템 안내에 따라 권한을 승인하세요. 기기가 조직에서 관리되거나 제한이 적용된 경우 권한은 관리 정책에 따라 달라질 수 있습니다. 제한 조건을 먼저 확인하고 설정을 반복해서 초기화하지 마세요.

권한 승인이 끝나면 클라이언트로 돌아가 스위치와 연결 상태가 유지되는지 확인합니다. 시스템 상태 막대나 제어 센터의 VPN 표시는 시스템 연결 여부를 확인하는 데 도움이 되지만 기기마다 표시 위치가 다를 수 있습니다. VPN 연결 표시는 원격 서버, DNS, 대상 웹사이트가 모두 정상이라는 뜻이 아닙니다. 실제 접속도 확인해야 합니다.

첫 테스트 중에는 On Demand를 켜거나 설정하지 마세요. 주문형 연결 조건이 수동으로 연결을 끊은 뒤 다시 연결을 요청하면 테스트 전후 상태를 비교하기 어려워질 수 있습니다. 자동 연결 조건을 이미 설정했다면 내용을 기록하고 작동 방식을 이해한 뒤 자동 실행을 잠시 중지하세요. 기기에서 사용 중인 다른 VPN 연결도 먼저 끊어 연결 상태가 서로 전환되는 일을 방지합니다.

스위치가 바로 꺼지면 당시 시스템 안내와 클라이언트 오류 메시지를 기록하고 문제 해결에서 권한 및 설정을 확인하세요. 스위치를 연달아 빠르게 켜고 끄지 마세요. 스위치가 켜진 상태로 유지되면 그대로 두고 확인 단계로 진행합니다. 연결을 종료하려면 Home으로 돌아가 스위치를 끈 뒤 시스템 연결 상태를 확인하세요. 다시 연결되면 On Demand 조건을 점검합니다.

완료 기준: 시스템 권한 승인이 끝났고 연결 상태가 유지됩니다. 다음 단계에서는 스위치만 확인하지 말고 실제 요청을 테스트합니다.

단계 04 / 실제 요청으로 결과 확인

Connectivity Test: 지연 시간과 페이지 접속을 따로 확인

먼저 기기의 Wi-Fi 또는 셀룰러 네트워크가 작동하는지 확인합니다. 기본 네트워크가 로그인 인증 화면에 머물러 있거나 인터넷에 연결되지 않는다면 인증을 마치고 네트워크를 복구한 뒤 Shadowrocket을 테스트하세요. 그렇지 않으면 구독 가져오기, 지연 시간 테스트, 웹 페이지 접속이 모두 실패해 서버 매개변수 문제로 잘못 판단할 수 있습니다.

Home에서 Connectivity Test를 실행해 가져온 서버를 테스트하고 결과가 나올 때까지 기다립니다. 테스트 결과는 기본적인 연결 가능 여부와 응답 상태를 판단하는 데 도움이 되지만 테스트 방식에 따라 확인 범위가 다릅니다. 지연 시간이 표시되어도 인증, DNS, 규칙, 대상 웹사이트 접속까지 모두 정상이라는 뜻은 아닙니다. 결과가 나오지 않을 때도 한 번의 결과만으로 항목을 삭제하지 말고 테스트 방식과 네트워크 환경을 함께 살펴보세요.

이어서 Safari를 열고 접근 권한이 있으며 평소 정상적으로 이용할 수 있는 HTTPS 페이지를 방문합니다. 페이지가 실제로 로드될 때까지 기다린 다음 같은 웹사이트의 다른 페이지도 열어 캐시된 페이지를 현재 연결 성공으로 착각하지 않도록 합니다. 대상 앱에서도 연결을 사용해야 한다면 해당 앱을 열어 필요한 작업을 직접 테스트하세요. 브라우저 접속 성공은 브라우저 요청이 처리되었다는 뜻일 뿐 앱 내부 테스트를 대신하지 않습니다.

Config를 사용할 때 페이지가 열린다는 사실만으로 해당 연결이 프록시를 거쳤다고 단정할 수 없습니다. 도메인에 DIRECT 규칙이 적용되었을 수 있습니다. 트래픽 경로를 확인하려면 클라이언트의 요청 기록이나 로그에서 대상 도메인에 해당하는 요청을 찾아 현재 설정의 정책과 일치하는지 살펴보세요. 본인 기기에서 필요한 정보만 확인하세요. 로그에 접속 도메인이 포함될 수 있으므로 전체 로그를 공개하지 마세요.

결과를 비교하려면 한 번에 조건 하나만 변경하세요. 예를 들어 네트워크, 서버, 테스트 페이지를 그대로 두고 Config를 Proxy로 임시 변경한 뒤 같은 페이지를 새로고침하고 원래 설정으로 복원합니다. Proxy에서는 작동하지만 Config에서 실패한다면 규칙, 정책 선택, DNS를 우선 확인하세요. 둘 다 실패한다면 서버와 네트워크를 계속 점검합니다.

확인을 마치면 사용 가능하다고 확인된 서버 하나와 현재 설정을 기준으로 보존합니다. 이후 서버 변경, 구독 갱신, 규칙 수정 후에도 같은 페이지에서 테스트를 반복할 수 있습니다. 지연 시간이 가장 짧다는 이유만으로 선택하지 마세요. 실제 접속이 안정적이고 필요한 작업을 완료할 수 있는지가 확인해야 할 결과입니다.

완료 기준: 테스트 페이지가 실제로 열리고 필요한 작업을 완료할 수 있으며 트래픽 경로가 현재 Global Routing 설정과 일치합니다.

단계 05 / 실패한 단계부터 원인 좁히기

Shadowrocket이 연결되지 않을 때: 실패 단계부터 확인

실패가 발생하면 먼저 “어느 단계의 완료 기준을 달성하지 못했는지” 기록한 뒤 아래 순서대로 확인합니다. 가져오기 실패, 스위치가 유지되지 않는 문제, 웹 페이지 접속 실패는 서로 다른 단계이므로 해결 방법도 다릅니다. 현재 설정과 원래 연결 정보는 보존하고 한 번에 한 항목만 변경한 뒤 같은 테스트를 반복하세요. 그래야 변경으로 문제가 해결되었는지 판단할 수 있습니다.

구독 항목이 없거나 갱신 후에도 사용할 수 없는 경우

구독 정보로 돌아가 URL 전체가 올바른지 확인합니다. 특히 끝부분의 매개변수, 대소문자, 붙여 넣을 때 포함된 공백을 살펴보세요. 현재 네트워크에서 구독 URL에 접속할 수 있는지 확인한 뒤 여러 그룹을 반복해서 만들지 말고 기존 구독을 갱신해 보세요. 로그인 페이지, 안내 페이지 또는 인식할 수 없는 내용이 반환되면 클라이언트가 예상한 서버 목록을 만들 수 없습니다.

구독 접근 권한과 유효 상태, 서버 사용 가능 여부는 서비스 제공업체에 확인해야 합니다. 문제를 설명할 때는 오류 문구, 발생 단계, 필요한 비식별 정보만 제공하세요. 문제 해결을 위해 전체 구독 URL을 공개 웹페이지나 채팅 캡처에 올리지 마세요. 갱신 및 정리 방법은 구독 갱신 안내를 참고하세요.

항목은 있지만 테스트에 실패하거나 연결이 끊기는 경우

먼저 현재 선택된 서버를 확인한 다음 프로토콜, 주소, 포트, 인증 정보를 점검합니다. 직접 입력한 항목은 TLS 및 전송 관련 필드도 특히 주의해서 확인하세요. 연결 매개변수끼리 서로 일치해야 하며 주소와 포트만 올바르다고 충분한 것은 아닙니다. 서비스 제공업체가 정보를 변경했다면 최신 유효 정보를 반영하세요. 항목 이름만 바꾸지 마세요.

시스템 권한 승인이 완료되지 않았거나 스위치가 바로 꺼지면 기기에 표시된 권한 안내부터 처리합니다. 연결 상태는 유지되지만 실제 요청이 실패한다면 보유 중인 다른 서버도 테스트하되 같은 네트워크와 테스트 페이지를 사용하세요. 여러 서버를 바꾸면서 DNS와 규칙까지 동시에 수정하면 결과를 비교하기 어렵습니다.

지연 시간은 정상이지만 웹 페이지가 열리지 않는 경우

먼저 Direct가 예상과 다르게 선택된 것은 아닌지 확인한 다음 앞 단계와 같은 방식으로 Config와 Proxy를 비교합니다. Config에서만 실패한다면 현재 활성화된 설정과 관련 규칙을 확인하세요. 두 모드 모두 접속할 수 없다면 서버 기능, 기본 네트워크, DNS를 점검합니다. 정상적으로 열리는 다른 페이지를 테스트하면 특정 웹사이트 문제인지 전반적인 접속 실패인지 구분하는 데 도움이 됩니다.

DNS는 도메인 이름을 주소로 변환합니다. 지연 시간 테스트에 성공해도 모든 도메인이 정상적으로 해석된다는 보장은 없습니다. 확인하기 전에 설정을 저장하고 dns-server 같은 매개변수를 변경했는지 살펴보세요. 익숙하지 않은 주소를 임의로 입력하지 마세요. 이전에 정상 작동이 확인된 설정으로 우선 되돌린 뒤 요청을 다시 테스트하세요. 자세한 순서는 지연 시간은 정상이지만 웹 페이지가 열리지 않을 때 DNS 점검 안내를 참고하세요.

점검 후 일상 설정으로 복원

같은 네트워크, 같은 서버, 같은 페이지에서 안정적으로 재현되는 것을 확인하면 평소 사용하는 Global Routing 설정으로 복원하고 임시 테스트 때문에 Proxy나 Direct가 남아 있지 않은지 확인합니다. On Demand가 필요하다면 트리거 조건을 별도로 설정하고 테스트하세요. 이어서 구독 및 서버 관리 매뉴얼에서 그룹, 갱신, 백업 방법을 확인할 수 있습니다. 첫 연결 단계에서 모든 고급 옵션을 함께 변경할 필요는 없습니다.

완료 기준: “스위치가 켜져 있다”는 정보에 그치지 않고 실패 단계, 점검 항목, 재테스트 결과를 명확히 설명할 수 있습니다.