공식 매뉴얼 · 첫 연결 절차

Shadowrocket 사용법
구독 가져오기 및 연결 테스트

기존 정보를 가져온 다음 라우팅을 선택하고 연결하세요. 마지막으로 실제 요청을 확인합니다. 스위치가 켜졌다고 연결이 정상이라고 볼 수는 없습니다.

처음이라면 다섯 단계를 순서대로 진행하세요. 연결은 되지만 일부 앱에서 문제가 발생한다면 결과 확인과 문제 해결 항목을 바로 읽어도 됩니다. 프로토콜 항목이나 기술적 선택 기준은 프로토콜 매뉴얼에서 확인하세요.

단계 01 · 정보 유형 확인

서버 추가 또는 기존 구독 가져오기

보유한 정보의 유형을 확인한 뒤 적절한 메뉴를 선택하세요. 구독 링크는 보통 여러 서버를 가져오는 데 사용하며 이후 갱신할 수 있습니다. 단일 서버 공유 정보에는 연결 하나에 필요한 내용이 들어 있고, 수동 설정값은 프로토콜, 주소, 포트, 인증 정보를 각각 입력해야 합니다. 내용이 URL처럼 보인다는 이유만으로 구독 링크라고 판단하지 마세요. 서비스 제공자가 안내한 용도에 맞게 사용하고, 안내 페이지나 계정 페이지, 설정 파일 다운로드 주소를 잘못된 입력란에 넣지 않도록 주의하세요.

구독 링크: Config에서 Subscribe 열기

Shadowrocket을 열고 Config로 이동해 Subscribe 메뉴를 찾습니다. 구독 추가 양식을 열고 알아보기 쉬운 이름을 입력한 뒤 본인의 구독 링크 전체를 주소 입력란에 붙여 넣고 저장합니다. 정보가 불러와질 때까지 기다리세요. 이름은 기기에서 구분하기 위한 것으로 구독 내용에는 영향을 주지 않습니다. 주소의 경로나 쿼리 매개변수는 인증에 사용될 수 있으므로 임의로 삭제하거나 조합하지 마세요.

가져오기가 끝나면 Home으로 돌아가 해당 서버 그룹이나 항목이 표시되는지 확인합니다. 목록이 나타나면 클라이언트가 정보를 읽었다는 뜻이지만, 목록에 있는 서버가 모두 작동한다는 의미는 아닙니다. 사용할 서버 하나를 선택한 뒤 다음 단계에서 연결을 테스트하세요. 저장 후에도 목록이 비어 있다면 구독 항목으로 돌아가 주소 전체가 입력되었는지, 업데이트 중 오류가 표시되었는지 확인하세요. 같은 정보를 여러 번 추가하지 마세요.

수동 설정값: Home에서 Add Server 사용

항목별 설정값을 받았다면 Home에서 추가 버튼을 눌러 Add Server로 이동합니다. 정보에 맞는 프로토콜 유형을 선택한 뒤 서버 주소, 포트, 인증 정보를 차례로 입력하세요. 프로토콜마다 필수 항목이 다릅니다. 예를 들어 어떤 유형은 비밀번호를 사용하고 다른 유형은 UUID를 사용하므로 서로 다른 프로토콜의 항목을 바꿔 입력할 수 없습니다. 이름이나 메모는 원하는 대로 설정해도 되지만 연결 정보는 기존 자료와 일치해야 합니다.

입력란이 호스트명을 요구한다면 정보에 적힌 호스트명만 입력하고 웹페이지 경로는 추가하지 마세요. 지정된 숫자를 포트에 입력합니다. TLS, 전송 방식, Host, SNI 등의 항목은 제공된 정보에 해당 설정이 있을 때만 입력하세요. 옵션이 더 완전해 보인다는 이유로 모든 스위치를 켜지 마세요. 저장 후 Home으로 돌아가 방금 추가한 항목을 선택하고 다시 열어 줄바꿈, 공백 또는 설명 문구가 함께 붙여 넣어지지 않았는지 확인합니다.

QR 코드 및 클립보드: 가져온 뒤 내용 확인

서버 QR 코드가 있다면 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 권한을 허용한 뒤 본인이 보유한 QR 코드를 스캔하세요. 클립보드로 가져올 때는 공유 정보를 전체 복사한 다음 클라이언트의 가져오기 메뉴를 사용합니다. QR 코드와 클립보드는 수동 입력을 줄여 줄 뿐, 원본 정보에 빠진 설정을 채워 주거나 서버 연결을 보장하지 않습니다.

어떤 방식으로든 가져오기를 마치면 Home으로 돌아가 항목 이름, 프로토콜 유형, 서버 주소가 예상한 내용과 일치하는지 확인한 다음 해당 항목을 선택하세요. 구독 링크, 비밀번호, 전체 공유 정보는 민감한 자료로 취급해야 합니다. 문제를 해결할 때는 오류 메시지와 항목 이름만 기록하고 전체 정보를 공개하지 마세요. 다음 단계에서 Global Routing을 확인하고, 아직 연결 스위치는 켜지 마세요.

단계 02 · 요청 처리 방식 확인

Global Routing 방식 선택

Home에서 Global Routing을 열고 현재 선택된 방식이 Config, Proxy, Direct 중 무엇인지 확인합니다. 서버는 사용할 연결 정보를 결정하고 Global Routing은 요청을 처리하는 방식을 결정합니다. 서버만 바꾸고 여기서 방식을 확인하지 않으면 서버를 선택했는데도 실제 요청이 서버를 거치지 않는다고 오해할 수 있습니다.

Config
현재 활성화된 설정의 규칙에 따라 요청을 처리합니다. 대상에 따라 다른 정책이 적용될 수 있습니다.
Proxy
클라이언트가 처리하는 요청을 프록시 정책으로 전달합니다. 선택한 서버가 기본적으로 작동하는지 먼저 확인할 때 적합합니다.
Direct
직접 연결 경로를 사용하므로 프록시 서버가 정상 작동하는지 확인하는 용도로는 적합하지 않습니다.

첫 테스트: 변수 줄이기

처음 연결할 때 방금 가져온 서버가 작동하는지 확인하려면 Proxy를 임시로 선택할 수 있습니다. 규칙 설정으로 인한 영향을 줄일 수 있으므로 기본 요청도 완료되지 않는다면 많은 규칙을 바로 수정하기보다 서버 설정값이나 네트워크부터 확인하세요. Proxy를 선택해도 모든 앱과 시스템 트래픽이 똑같은 방식으로 처리되는 것은 아닙니다. 다음 단계에서 연결한 뒤 앱별로 실제 동작을 확인해야 합니다.

서버가 작동하는 것을 확인한 뒤 대상별로 요청을 처리하려면 Config로 전환하세요. Config에서 현재 활성화된 설정이 무엇인지 확인해 ‘가져온 설정’과 ‘활성화된 설정’을 혼동하지 않도록 합니다. 현재 적용 중인 설정만 요청 처리에 영향을 줍니다. 다른 파일을 편집해도 사용 중인 규칙이 자동으로 바뀌지는 않습니다.

Config: 현재 파일 확인 후 규칙 이해하기

규칙은 일반적으로 위에서 아래 순서로 확인되며, 일치하는 규칙을 찾으면 해당 정책이 적용됩니다. PROXY는 프록시 정책으로 전달, DIRECT는 직접 연결, REJECT는 요청 거부를 의미합니다. FINAL은 앞선 규칙에 일치하지 않는 요청에 적용되는 기본 정책입니다. 처음 기존 설정을 사용할 때 규칙 수정, 서버 변경, DNS 조정을 동시에 하면 결과가 바뀌어도 어느 설정이 영향을 주었는지 파악하기 어렵습니다.

문제를 해결할 때 Direct를 원래 네트워크와 비교하는 용도로 사용할 수 있지만, 프록시 경로를 확인하는 데는 적합하지 않습니다. 방식을 선택한 뒤 Home으로 돌아가 방금 확인한 서버가 그대로 선택되어 있는지 살펴보세요. 이제 클라이언트가 사용할 서버 정보와 요청 처리 방식을 모두 알고 있으므로, 다음 단계에서 스위치를 켜고 시스템 권한을 설정합니다.

단계 03 · 시스템 연결 권한 설정

스위치를 켜고 연결 상태 확인

Home으로 돌아가 서버가 선택되어 있고 Global Routing도 방금 지정한 방식인지 확인한 뒤 상단 연결 스위치를 켭니다. 처음 사용하는 경우 iPhone/iPad에 VPN 구성을 추가하라는 시스템 안내가 표시될 수 있습니다. 안내에 표시된 앱이 Shadowrocket인지 확인하고 추가를 허용한 다음 기기의 암호 또는 생체 인증으로 본인 확인을 완료하세요. 이 과정은 시스템에서 진행되며 웹페이지에 기기 암호를 입력할 필요가 없습니다.

권한 설정 후 Shadowrocket으로 돌아와 스위치가 계속 켜져 있는지 확인합니다. 켜자마자 자동으로 꺼지거나 시스템 안내를 완료하지 못했다면 구독을 삭제하지 말고 먼저 권한 문제를 해결하세요. 안내가 표시되지 않으면 시스템 Settings에서 VPN 구성 상태를 확인한 뒤 앱으로 돌아와 다시 시도합니다. 조직에서 관리하는 기기는 관리 정책의 제한을 받을 수 있으므로 해당 기기 관리 지침을 따르세요.

연결 스위치가 켜져도 대상에 접근할 수 있다는 뜻은 아닙니다

시스템이 VPN 구성을 허용했다는 것은 클라이언트가 트래픽 처리를 위한 연결 환경을 만들 수 있다는 의미일 뿐, 선택한 서버의 인증이 성공했거나 모든 대상에 접근할 수 있다는 뜻은 아닙니다. 상태 표시줄의 표시는 기기와 화면 상황에 따라 다를 수 있으므로 특정 아이콘이 계속 보이는지만으로 판단하지 마세요. 현재 서버와 라우팅 방식을 유지한 채 테스트를 실행하고 대상 페이지를 여는 것이 다음 확인 방법입니다.

처음 문제를 해결하는 동안에는 네트워크 경로를 바꿀 수 있는 다른 VPN 연결을 동시에 켜지 말고 On Demand 같은 자동화 설정도 추가하지 마세요. 수동 연결 상태를 하나로 유지하면 스위치가 언제 켜지고 어느 단계에서 오류가 발생했는지 파악하기 쉽습니다. 다른 네트워크 설정이 있다면 먼저 현재 상태를 기록한 뒤 시스템에 표시된 내용을 확인해 실제로 활성화된 항목을 파악하세요.

서버를 바꿔야 한다면 현재 테스트를 마치고 결과를 기록한 다음 항목 하나만 바꿔 다시 테스트하세요. 설정을 변경할 때도 한 번에 하나씩만 바꿉니다. 사용을 마치면 Home으로 돌아가 스위치를 끄면 됩니다. 다음에 연결할 때도 현재 서버와 Global Routing을 확인하세요. 이전에 연결에 성공했다는 이유로 이번에 선택된 상태를 확인하지 않고 넘어가지 마세요.

단계 04 · 테스트 후 실제 요청 확인

Connectivity Test 및 앱 접근 확인

먼저 Connectivity Test를 실행한 다음 실제 웹페이지와 대상 앱을 확인합니다. 테스트 결과는 특정 테스트 방식과 대상에서의 상태를 보여 줄 뿐, 모든 요청에 대한 일괄적인 결론은 아닙니다. 테스트는 성공했지만 앱이 계속 작동하지 않거나, 테스트 시간이 초과되어도 일부 웹페이지가 열린다면 요청이 어떤 경로를 거치는지 더 확인하세요. 정보 전체가 유효하거나 무효하다고 바로 단정하지 마세요.

선택한 서버를 테스트한 뒤 같은 웹페이지 열기

Home에서 Connectivity Test를 찾아 실행하고 테스트가 끝날 때까지 기다린 뒤 선택한 서버의 성공 또는 실패 상태를 기록하세요. 테스트 방식에 따라 측정 대상이 다를 수 있으므로 목록의 수치를 실제 다운로드 속도로 간주하거나 수치만 보고 서버를 바꾸지 마세요. 첫 확인에서 중요한 것은 같은 조건에서 테스트를 안정적으로 완료할 수 있는지, 실제 요청에 정상적으로 응답하는지입니다.

그런 다음 브라우저를 열어 접근 권한이 있고 정상 콘텐츠를 확인할 수 있는 일반 웹페이지를 방문하세요. 이전 화면이 그대로 보이는 것만 확인하지 말고 페이지 본문과 필요한 리소스가 로드되는지 살펴봅니다. 페이지를 새로고침한 뒤 다른 페이지도 열어 비교할 수 있습니다. 테스트와 브라우저에서 같은 서버를 사용하도록 현재 서버를 유지하세요. 서로 다른 항목을 사용하면 결과를 비교하기 어렵습니다.

대상 앱 및 규칙 적용 확인

브라우저에서 정상적으로 열리는 것을 확인한 다음 원래 사용하려던 앱을 실행해 목록을 새로고침하거나 새 페이지를 여는 등 구체적인 작업을 해 보세요. 앱 하나가 여러 도메인에 요청을 보낼 수 있으므로 홈 화면이 열린다고 로그인, 이미지 또는 다른 기능도 같은 경로로 작동한다고 볼 수 없습니다. 특정 기능만 실패한다면 어떤 작업을 했고 어떤 안내가 표시되었는지 기록해 해당 요청을 확인하세요.

Config를 사용하는 경우 연결 기록에 표시되는 대상과 정책을 살펴 요청이 예상대로 처리되는지 확인하세요. 대상이 DIRECT에 일치하면 규칙에 따라 직접 연결된 것입니다. 서버가 작동하지 않아 ‘효력이 사라진’ 것이 아닙니다. REJECT에 일치하면 현재 설정의 규칙이 무엇을 의미하는지 먼저 확인하세요. 실제 적용된 정책을 확인해야 연결 문제인지 규칙 선택 문제인지 판단할 수 있습니다.

Data의 업로드·다운로드 변화는 요청이 발생했음을 보여 주는 보조 자료가 될 수 있지만, 트래픽 증가만으로 대상 콘텐츠가 정상적으로 반환되었다고 볼 수는 없습니다. 백그라운드 작업으로 수치가 변할 수도 있습니다. 스위치나 숫자 하나만 보는 것보다 Connectivity Test, 실제 페이지 결과, 라우팅 정책, Data를 함께 확인하는 편이 정확합니다. Proxy에서 정상 작동하는 것을 확인한 뒤 Config로 전환해 같은 방식으로 테스트하면 규칙에 따른 차이를 확인하기 쉽습니다.

단계 05 · 가장 먼저 실패한 단계부터 해결

자주 발생하는 오류와 해결 순서

가장 먼저 완료되지 않은 단계부터 확인하세요. 정보를 가져오지 못했다면 가져오기부터 해결하고, 연결 스위치가 켜진 상태를 유지하지 못하면 시스템 권한을 확인합니다. 스위치는 정상인데 페이지가 열리지 않는다면 서버와 라우팅을 살펴보세요. 실패 단계를 건너뛰고 바로 재설치하거나 프로토콜, DNS, 규칙, 서버를 한꺼번에 바꾸지 마세요. 변경할 때마다 같은 테스트와 같은 페이지로 확인해야 바뀐 설정의 효과를 알 수 있습니다.

가져오기 실패 또는 서버 목록이 비어 있음

복사한 내용이 구독 링크나 클라이언트에서 인식할 수 있는 공유 정보인지 확인하세요. 안내 페이지 주소를 복사한 것은 아닌지 살펴봅니다. 끝부분의 매개변수가 빠지지 않았는지, 공백이나 줄바꿈이 섞이지 않았는지, 서비스 제공자가 주소를 변경하지 않았는지 확인하세요. 구독 업데이트에서 인증 오류가 나거나 지원하지 않는 내용이 반환되면 기존 정보 제공처에 용도와 유효 상태를 확인합니다. 반복해서 업데이트해도 잘못된 주소가 수정되거나 누락된 권한이 추가되지는 않습니다.

서버 목록은 있지만 새 정보가 나타나지 않는다면 ‘구독 새로고침’과 ‘서버 재추가’를 구분하세요. 먼저 기존 구독을 업데이트하고 해당 그룹을 확인해 중복으로 추가한 뒤 예전 항목을 잘못 선택하지 않도록 합니다. 수동으로 입력한 서버는 구독 업데이트만으로 수정되지 않습니다. 설정값이 바뀌었다면 새로 받은 정보를 기준으로 항목별로 확인해야 합니다.

Connectivity Test 실패 또는 연결 후 응답 없음

먼저 연결 스위치를 끄고 원래 Wi-Fi 또는 셀룰러 네트워크에서 일반 웹페이지를 열 수 있는지 확인하세요. 공용 네트워크에서 인증 페이지가 표시된다면 해당 네트워크의 로그인을 먼저 완료한 뒤 Shadowrocket으로 돌아옵니다. 원래 네트워크도 작동하지 않는다면 프록시 설정부터 바꾸지 말고 기기와 네트워크 사이의 기본 연결 문제를 먼저 해결하세요.

기본 네트워크가 정상이라면 프로토콜 유형, 서버 주소, 포트, 인증 정보를 다시 확인하세요. TLS를 사용하는 정보는 관련 호스트명이 제공된 설정과 일치하는지 확인하고 기기의 날짜와 시간도 점검합니다. 오류를 피하려고 인증서 검증을 함부로 끄지 마세요. 서버가 여러 개라면 다른 설정은 그대로 두고 서버 하나만 바꿔 비교한 다음, 정확한 오류 메시지를 본인의 서비스 제공자에게 전달해 확인하세요.

스위치가 바로 꺼지거나 권한 설정이 완료되지 않음

시스템에서 VPN 구성 추가를 거부했는지, 본인 인증이 완료되었는지, 다른 VPN 연결이 활성화되어 있는지 확인하세요. 시스템 Settings에서 관련 구성을 살펴볼 때는 용도를 확인할 수 있는 항목만 처리하고 다른 네트워크 설정을 일괄 삭제하지 마세요. 기기 관리 제한이 있다면 관리 정책에 따라 해결해야 합니다. 앱을 반복해서 재설치하지 마세요.

Proxy에서는 작동하지만 Config에서 일부 요청 실패

현재 활성화된 설정과 실제 적용된 정책부터 확인하세요. Config로 돌아가 사용 중인 파일을 확인하고 대상이 앞선 규칙에 일치하는지, FINAL이 마지막에 어떤 정책을 지정하는지 살펴봅니다. 규칙은 보통 먼저 일치한 항목이 적용되므로 앞쪽의 범위가 넓은 규칙이 뒤쪽의 세부 규칙을 가릴 수 있습니다. 이때는 구체적인 요청 하나부터 확인하고, 페이지 하나를 고치려고 규칙 전체를 삭제하지 마세요.

Wi-Fi 또는 셀룰러 네트워크 중 한쪽에서만 실패한다면 같은 서버와 라우팅 방식을 유지한 채 네트워크를 바꿔 테스트하고 결과를 비교하세요. 앱 하나만 문제가 있다면 해당 앱을 다시 열고 구체적인 작업을 반복한 뒤 연결 기록을 함께 확인합니다. 브라우저가 정상이라고 해서 모든 앱도 정상이라고 단정할 수는 없습니다. 프로토콜 항목의 의미와 선택 기준은 프로토콜 매뉴얼에서 확인하고, 규칙 순서는 규칙 매칭 및 FINAL 기본 정책 안내를 참고하세요.