공식 사용 설명서 / 빠른 시작

Shadowrocket 사용법

기존 정보를 가져오고 Global Routing을 선택한 다음 연결과 접속을 확인하세요. 처음에는 순서대로 진행하고, 완료한 단계는 목차에서 건너뛸 수 있습니다.

진행 순서: 정보 확인 → SERVER에 항목 표시 → 모드 확인 → 연결 켜기 → 실제 접속 확인. 스크린샷은 App Store 공식 페이지에서 가져왔으며, 실제 화면은 기기에 표시되는 내용을 기준으로 확인하세요.

단계 01 / 추가 및 가져오기

Add Server: 기존 연결 정보 가져오기

Shadowrocket을 열고 Home으로 이동합니다. 아래 SERVER 영역에는 등록된 서버와 구독 그룹이 표시됩니다. 처음 사용하는 경우 Add Server를 탭하세요. 준비한 정보에 맞는 방법을 선택하면 됩니다. 같은 정보를 중복해서 가져올 필요는 없습니다. 구독 링크는 여러 서버 정보를 업데이트하는 데 사용하고, 단일 서버 정보는 한 개의 연결에 필요한 설정값을 입력하는 데 사용합니다.

구독 링크가 있는 경우: Subscribe 사용

Add Server에서 Type을 탭하고 Subscribe를 선택한 뒤, 본인의 전체 구독 링크를 URL에 입력합니다. 여러 구독을 구분해야 한다면 화면에 표시된 이름 또는 메모 입력란에 알아보기 쉬운 이름을 적고 저장하세요. Home으로 돌아가 정보 가져오기가 끝날 때까지 기다린 다음, 해당 그룹에 서버 항목이 표시되는지 확인합니다. 링크만 저장되고 항목이 나타나지 않으면 연결을 시도하기 전에 구독 가져오기 문제부터 해결하세요.

링크를 복사할 때는 전체 매개변수를 포함하고 안내 문구, 앞뒤 공백, 줄바꿈이 함께 붙지 않도록 주의하세요. 서비스 제공업체의 웹페이지 주소를 구독 링크로 사용해서도 안 됩니다. 링크에는 계정 식별 정보가 포함될 수 있으므로 신뢰할 수 있는 본인 서비스에서만 복사하세요. 문제 해결을 위해 공개 스크린샷을 공유할 때는 전체 링크를 가리세요. 처음 가져오기에 성공한 뒤 표시되는 서버 목록은 실제로 받은 정보에 따라 달라지며, 이후 업데이트에서 항목이 추가되거나 삭제될 수도 있습니다.

단일 서버 정보가 있는 경우: Type에 맞는 설정 입력

Add Server로 돌아가 준비한 정보에 맞는 Type을 선택한 다음 Host, Port와 해당 프로토콜에 필요한 인증 정보를 입력합니다. 스크린샷에 Password, Method 등의 항목이 표시되어도 모든 프로토콜이 같은 항목을 사용하는 것은 아닙니다. Host에는 서버 주소를, Port에는 해당 포트를 입력하세요. 인증 정보, 암호화 방식 및 전송 관련 설정은 서버 측 정보와 일치해야 합니다. 항목 이름만 보고 임의로 선택하지 마세요.

정보가 QR 코드로 제공되었다면 Scan QR Code로 읽을 수 있습니다. 읽은 뒤에도 Type과 주요 항목을 확인하세요. Import from Cloud JSON은 해당 형식의 정보를 가진 경우에만 사용하며, 모든 링크를 가져오는 공통 메뉴가 아닙니다. 저장한 뒤 Home으로 돌아와 SERVER에 항목이 표시되는지 확인하세요. 이 단계는 정보가 등록되었다는 뜻일 뿐, 연결 성공 여부는 이후 테스트로 확인해야 합니다. 항목이 무엇인지 모르겠다면 값을 반복해서 바꾸기보다 먼저 용어 설명서에서 확인하세요.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method 및 하단의 가져오기 메뉴가 표시됩니다
Add Server: 먼저 Type을 선택하고 준비한 정보에 맞춰 항목을 입력하세요. 화면에 표시되는 항목은 선택한 프로토콜에 따라 달라집니다.

단계 02 / 모드 선택

Global Routing: 연결에 적용할 정책 확인

SERVER에 항목이 표시되어도 바로 연결 스위치를 켜지 마세요. Home에서 Global Routing을 탭해 현재 모드를 확인합니다. 이 설정은 요청을 처리하는 방식을 결정합니다. 서버 선택과 라우팅 모드 선택은 별개의 작업입니다. 서버를 선택했더라도 Direct 정책이 자동으로 Proxy로 바뀌지는 않습니다.

Config: 현재 규칙에 따라 처리

Config는 현재 구성 파일의 규칙에 따라 요청의 라우팅을 결정합니다. Config를 열어 사용할 구성 파일이 선택되어 있는지 확인하고 Rule의 정책도 살펴보세요. Config 화면은 구성 파일을 관리하는 곳이고, Global Routing의 Config는 구성 규칙을 적용한다는 뜻입니다. 두 곳의 이름은 같지만 목적은 다릅니다. Subscribe만 가져와서는 현재 규칙을 확인한 것이 아닙니다.

예를 들어 규칙에 따라 특정 도메인은 PROXY로, 특정 IP 주소 범위는 DIRECT로 처리할 수 있습니다. 실제 결과는 규칙의 내용과 순서, 정책 참조에 따라 달라집니다. 처음 사용할 때는 스크린샷에 보이는 General, Hosts, URL Rewrite, HTTPS Decryption 항목을 하나씩 수정할 필요가 없으며, 연결을 위해 추가 기능을 켤 필요도 없습니다. 사용 가능한 구성이 있다면 그대로 두고 기본 연결부터 확인한 뒤 규칙을 살펴보세요.

Proxy와 Direct: 테스트 목적에 맞게 선택

Proxy는 이 모드의 처리 방식에 따라 요청을 선택한 프록시 서버로 전달합니다. 처음 테스트할 때 사용하면 규칙 차이로 인한 변수를 줄일 수 있지만, 시스템의 모든 트래픽이 반드시 처리된다는 뜻은 아닙니다. Direct는 요청을 선택한 프록시 서버를 거치지 않고 직접 처리합니다. 가져온 서버의 연결을 확인하려는 경우 Direct로는 테스트할 수 없습니다.

처음에는 현재 모드를 기록해 두고, 연결 및 접속 확인을 위해 잠시 Proxy로 바꾼 뒤 필요한 Config로 되돌릴 수 있습니다. 되돌린 뒤에는 반드시 다시 테스트하세요. 서버가 작동하는 것과 규칙이 올바른 것은 서로 다른 문제입니다. 사용할 규칙을 아직 준비하지 않았다면 현재 구성을 먼저 확인하고, 모드에 Config가 표시되게 하려고 출처를 알 수 없는 내용을 가져오지 마세요. 규칙 키워드의 의미는 용어 설명서에서, 구성 파일 관리는 Config 설정 안내에서 확인할 수 있습니다.

Shadowrocket의 Config 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시됩니다
Config: 구성 파일의 Rule 등 항목을 확인합니다. Global Routing 모드는 Home에서 선택하며, 이 편집 화면에서는 선택하지 않습니다.

단계 03 / 연결하기

Home: 서버 선택 후 연결 켜기

Home으로 돌아와 SERVER에서 기존 서버 하나를 선택합니다. 같은 구독에 여러 항목이 있다면 우선 하나만 선택해 테스트하고, 여러 항목을 연달아 바꾸지 마세요. 이어서 Global Routing을 다시 확인해 앞에서 정한 모드가 유지되고 있는지 살펴봅니다. 항목 이름은 구분을 위한 표시일 뿐, 연결 품질이나 프로토콜 설정, 현재 사용 가능 여부를 알 수 있는 정보가 아닙니다.

Home 상단의 연결 스위치를 탭합니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용해 달라는 안내가 표시될 수 있습니다. 이 안내는 Shadowrocket이 시스템 네트워크 연결 구성을 만들도록 허용하는 것으로, 앱을 다시 구매하라는 뜻도 구독 내용이 검증되었다는 뜻도 아닙니다. 안내에 표시된 앱 정보를 확인하고 직접 시작한 작업이 맞다면 시스템 요청에 따라 기기 인증을 완료하세요.

승인한 뒤 Home으로 돌아와 상단 스위치와 연결 상태가 바뀌었는지 확인합니다. 스크린샷의 Not Connected는 연결되지 않은 상태이며, 직접 입력해야 하는 문구가 아닙니다. 승인을 거부했다면 스위치가 켜진 상태를 유지하지 못할 수 있습니다. 같은 구독을 다시 가져오기보다 연결을 다시 시작하고 시스템 안내를 처리하세요. 기기 관리 제한으로 필요한 구성을 만들 수 없는 경우에는 먼저 기기 권한을 확인해야 합니다.

시스템에서 다른 VPN 연결을 사용 중이라면 설정에서 현재 활성 연결을 확인한 뒤 Shadowrocket으로 돌아와 다시 시도하세요. 연결이 서로 전환되어 결과를 잘못 판단하는 일을 줄일 수 있습니다. 처음 테스트하는 동안에는 On Demand도 설정하지 않는 것이 좋습니다. 자동 연결 조건이 추가되면 확인할 사항이 늘어납니다. 수동 연결과 해제를 반복해서 성공적으로 수행한 뒤 필요에 따라 On Demand를 살펴보세요.

스위치가 켜졌다는 것은 연결 과정이 해당 상태에 도달했다는 뜻일 뿐, 서버 인증이나 대상 접속, 모든 규칙이 올바르다는 증거는 아닙니다. 여기서 작업을 끝내지 마세요. 현재 서버와 모드를 유지한 채 다음 단계에서 Connectivity Test를 실행하고 실제 접속도 확인합니다. 스위치가 곧바로 꺼지면 시스템 안내나 오류 문구를 기록한 뒤 문제 해결로 이동하세요.

Shadowrocket의 Home 화면. 상단에 Not Connected 스위치, Global Routing, Connectivity Test가 표시되고 아래에 SERVER와 Add Server가 있습니다
Home: 먼저 SERVER에서 서버를 선택하고 Global Routing을 확인한 다음 상단의 연결 스위치를 조작하세요.

단계 04 / 작동 확인

Connectivity Test: 테스트와 실제 접속 확인

연결을 유지한 상태에서 Home의 Connectivity Test를 탭합니다. 테스트가 완료될 때까지 기다린 뒤 결과를 확인하세요. 테스트 성공 여부는 사용된 테스트 방식에 따라 달라집니다. 특정 대상에 대한 연결 확인이나 특정 핸드셰이크만 반영될 수 있으므로 모든 웹페이지에 접속할 수 있다는 뜻은 아닙니다. 표시된 소요 시간도 실제 다운로드 속도가 아니며, 숫자 하나만으로 전체 연결 상태를 판단할 수 없습니다.

이어서 브라우저를 열고 평소 사용하는 웹페이지에 접속합니다. 브라우저 캐시가 아니라 콘텐츠가 새로 로드되는지 확인하세요. 다른 웹페이지도 열어 비교해 개별 사이트 문제인지 전반적인 접속 문제인지 살펴봅니다. 연결 전후의 상황을 기록해 비교할 수는 있지만, 페이지의 모양이 달라졌다는 사실만으로 판단해서는 안 됩니다.

Config 모드에서 규칙 다시 확인

앞 단계에서 문제를 좁히기 위해 Proxy를 사용했다면, 이제 장기적으로 사용할 Config로 되돌린 뒤 같은 방식으로 다시 접속을 확인하세요. Proxy에서는 접속되지만 Config에서 일부 대상에 접속할 수 없다면 서버를 바로 삭제하기보다 규칙 일치 여부, 정책 참조, 도메인 이름 확인을 먼저 살펴보세요. 반대로 Direct에서 페이지가 열린다고 해서 프록시 서버가 작동한다는 뜻은 아닙니다. 해당 요청이 프록시 서버를 사용하지 않았을 수 있습니다.

요청의 실제 처리 경로를 확인해야 한다면 앱에서 해당 접속과 관련된 연결 기록이나 진단 정보를 살펴보고, 대상 도메인과 시간, 적용된 정책을 함께 확인하세요. 기록의 DIRECT와 PROXY는 서로 다른 처리 방식을 나타냅니다. 시스템의 VPN 표시만으로는 특정 요청에 어떤 규칙이 적용되었는지 알 수 없습니다. 규칙 순서 등 자세한 내용은 용어 설명서에서 확인하고, 이 페이지에서는 기본 검증을 마무리하세요.

마지막으로 연결을 수동으로 끊었다가 다시 연결하고 같은 테스트를 반복합니다. 두 번 모두 결과가 일치하고 실제 접속도 정상이어야 더 세부적인 설정을 조정하는 것이 좋습니다. 테스트는 실패했지만 웹페이지가 정상이라면 테스트 방식과 대상을 먼저 확인하세요. 테스트는 성공했지만 웹페이지가 열리지 않는다면 현재 설정을 유지하고 실패한 도메인, 시간, 안내 문구를 기록한 뒤 다음 단계에서 원인을 좁혀 갑니다. 한 번에 하나만 변경해야 변경 사항과 결과를 비교할 수 있습니다.

단계 05 / 문제 해결

Settings: 실패 단계별 점검

먼저 문제가 발생한 단계를 구분합니다. 구독 정보를 가져오지 못했는지, 서버에 연결할 수 없는지, 스위치가 켜지지 않는지, 일부 웹페이지에서만 실패하는지 확인하세요. 원인마다 해결 방법이 다릅니다. 기존 항목과 구성을 유지하고 원래 상태를 기록한 뒤, 처음부터 모든 내용을 삭제하지 마세요. Settings에서 Test Method, On Demand, Diagnostics와 Proxy, TCP, UDP 등의 설정 메뉴를 확인할 수 있습니다. 이번에는 현재 증상과 관련된 항목만 점검하세요.

구독 업데이트 실패: 링크와 가져오기 네트워크 확인

Home에 서버 항목이 표시되지 않는다면 Subscribe의 전체 링크를 다시 확인하고, 만료되었거나 교체되지는 않았는지 또는 복사할 때 매개변수가 빠지지는 않았는지 살펴보세요. 현재 네트워크에서 해당 링크의 서비스에 접속할 수 있는지 확인하고, 본인의 서비스 제공업체에 구독이 유효한지 문의하세요. 정보를 가져오지 못하는 문제와 특정 서버에 연결하지 못하는 문제는 다릅니다. 이 경우 서버의 Port나 Method를 바꿔도 대개 해결되지 않습니다. 자세한 내용은 구독 문제 FAQ를 확인하세요.

항목은 있지만 연결 실패: 서버 설정 확인

해당 항목을 열어 원본 정보의 Type, Host, Port와 인증 정보를 하나씩 대조하세요. 자료에 TLS, 전송 방식, 서버 이름 등이 명시되어 있다면 그 값도 일치시켜야 합니다. 항목이 선택 사항처럼 보여도 이미 입력된 값을 임의로 삭제하지 마세요. 본인이 보유한 다른 서버 하나를 비교 대상으로 사용할 수 있지만, 한 번에 하나씩 테스트하고 결과를 기록해 항목별 상황을 혼동하지 않도록 하세요.

연결 또는 접속 이상: 시스템, 규칙, 네트워크 구분

스위치가 켜진 상태를 유지하지 못하면 VPN 구성 승인, 시스템 안내, 기기 제한을 먼저 확인하세요. 스위치는 정상인데 모든 대상에 접속할 수 없다면 선택한 서버와 로컬 네트워크를 확인합니다. Wi-Fi와 셀룰러 네트워크를 한 번씩 바꿔 보면 현재 연결 네트워크가 원인인지 파악하는 데 도움이 됩니다. 네트워크를 전환하면 데이터 요금이 발생할 수 있으므로 사용 조건을 먼저 확인하세요.

일부 대상에만 접속할 수 없다면 Global Routing과 Config의 규칙을 먼저 확인하세요. Connectivity Test만 실패한다면 Settings에서 Test Method를 열어 선택한 방법과 한계를 확인합니다. 특정 테스트를 통과시키려고 DNS, TCP, UDP 등 여러 설정을 한꺼번에 바꾸거나 인증 관련 확인을 끄지 마세요. 변경 전 기존 값을 기록하고, 개선되지 않으면 원래대로 되돌리세요.

원인을 더 확인해야 한다면 Diagnostics에서 현재 화면에 제공되는 진단 항목을 살펴보세요. 오류 정보를 공유하기 전에는 구독 링크, 비밀번호, 인증 식별 정보와 공개할 필요가 없는 주소를 가리고, 필요한 오류 문구와 작업 순서만 남기세요. 연결 문제는 연결할 수 없음 FAQ에서 확인할 수 있습니다. 설치, App Store 국가 또는 구매 복원 과정에서 발생한 문제라면 연결 설정을 바꾸지 말고 App Store 설치 가이드를 확인하세요.

기본 문제 해결을 마친 뒤 Home으로 돌아와 같은 서버, 같은 모드, 같은 대상으로 다시 테스트하세요. 반복해서 확인할 수 있는 작업 기록이 여러 설정을 한꺼번에 바꾸는 것보다 유용합니다. 일상적으로 사용할 때는 검증된 구성을 유지하세요. On Demand나 세부 규칙을 더 알아보려면 기능 및 설정을 읽고 항목을 하나씩 추가하세요. 모든 기능을 한꺼번에 켜지 마세요.

Shadowrocket의 Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP, UDP가 표시됩니다
Settings: 증상에 맞는 항목을 점검하세요. 처음 문제를 해결할 때는 기존 값을 유지하고, 하나씩 변경한 뒤 다시 확인하는 것이 원칙입니다.