공식 매뉴얼 · 빠른 시작

Shadowrocket 첫 설정과 연결

‘가져오기 → 모드 선택 → 연결 → 확인 → 문제 해결’ 순서로 진행합니다. 먼저 연결 하나를 설정한 다음 규칙을 조정하세요. 여러 설정을 동시에 변경하지 않는 것이 좋습니다.

STEP 01 / IMPORT

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

먼저 보유한 정보의 유형을 확인하세요. 개별 서버 정보와 Subscribe 구독 주소는 서로 다른 입력 방식이므로 혼동해 입력하지 마세요.

Shadowrocket을 열고 Home으로 이동한 다음 SERVER 그룹에서 Add Server를 찾습니다. 아직 항목을 추가하지 않았다면 목록이 비어 있어도 설치 오류가 아닙니다. 저장된 연결 정보가 아직 없다는 뜻입니다. 보유한 정보에 따라 한 가지 방법을 선택하세요. 프로토콜, 주소, 포트 등 개별 항목이 있다면 직접 추가하고, 전체 구독 링크가 있다면 Subscribe로 가져옵니다. 처음에는 한 가지 방법만 진행하면 되며, 같은 정보를 중복 입력할 필요는 없습니다.

기존 서버 정보가 있는 경우: Type에 맞춰 입력

Add Server를 탭한 뒤 먼저 Type을 선택하고 해당 유형에 필요한 항목을 입력합니다. 스크린샷에는 Host, Port, Password, Method 입력란이 표시되어 있습니다. Host에는 서버 도메인이나 IP를, Port에는 해당 포트 번호를 입력하고 Password와 Method는 기존 정보를 확인해 입력하세요. Type을 바꾸면 항목도 달라질 수 있습니다. 한 프로토콜의 입력 항목을 다른 프로토콜에 그대로 적용하거나 이름만 보고 옵션을 선택하지 마세요.

항목을 하나씩 복사할 때 앞뒤 공백과 줄바꿈, 문장 부호를 확인하세요. 특히 포트 번호는 서버 정보와 일치해야 합니다. 주소 입력란에는 일반적으로 호스트명만 입력하며 전체 웹 경로를 넣지 않습니다. 프로토콜에 따라 UUID, SNI, 전송 관련 정보가 추가로 필요할 수 있습니다. 해당 정보는 보유한 서버 정보에서 확인하세요. 필요한 항목이 없다면 기존 정보를 제공한 곳에 먼저 문의한 뒤 진행하세요. 각 항목의 자세한 의미는 프로토콜 기술 참고 자료에서 확인할 수 있습니다.

기존 구독 링크가 있는 경우: Subscribe로 가져오기

Add Server에서 Subscribe 유형을 선택하고 알아보기 쉬운 이름을 입력한 뒤 전체 구독 주소를 URL 입력란에 붙여 넣습니다. 주소를 복사할 때 쿼리 부분을 포함해 전체를 복사하세요. 도메인만 잘라 쓰거나 구독 주소를 Host로 입력하면 안 됩니다. 저장한 뒤 구독 내용을 가져올 때까지 기다리고 Home으로 돌아가 해당 그룹이나 서버 항목이 표시되는지 확인합니다. 구독 정보를 저장한 것과 서버 항목을 성공적으로 가져온 것은 별개이므로 목록에 실제로 표시되는 내용을 확인해야 합니다.

보유한 정보가 QR 코드라면 Scan QR Code를 사용할 수 있으며, 필요하면 카메라 접근을 허용하세요. 스캔 후에는 인식된 유형과 항목을 확인하고 저장합니다. Import from Cloud JSON은 별도의 가져오기 메뉴이며 Subscribe와는 다릅니다. 일반 구독 링크를 여기에 입력하면 안 됩니다. 보유한 정보의 형식에 맞는 방법을 사용하세요. 붙여 넣을 수 있다는 이유만으로 형식이 올바르다고 판단하지 마세요.

구독 주소에는 접속 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요. 문제를 확인할 때 전체 주소를 공개된 페이지나 스크린샷에 올리지 마세요. 가져오기가 끝나면 사용할 서버 하나를 명확히 선택하고 다음 단계에서 Global Routing을 설정합니다. 이때는 고급 옵션을 변경하거나 모든 항목을 한꺼번에 테스트하지 않아도 됩니다.

Shadowrocket Add Server 공식 스크린샷: Type, Host, Port, Password, Method 및 Scan QR Code 메뉴 표시
Add Server: 먼저 Type을 선택한 다음 해당 유형에 맞는 정보를 입력합니다.

STEP 02 / ROUTING

Global Routing: 모드를 선택하고 Config 확인

서버는 연결 대상을 정하고 Global Routing은 요청 처리 방식을 정합니다. 각각 따로 확인해야 합니다.

Home으로 돌아가 Global Routing을 탭하고 현재 선택된 모드를 확인합니다. 이 가이드에서 사용하는 세 가지 명칭은 Config(구성), Proxy(프록시), Direct(직접 연결)이며, 인터페이스에는 Config, Proxy, Direct로 표시됩니다. 상단 스위치가 켜져 있는지만 보고 요청이 선택한 서버를 거친다고 판단하지 마세요. 실제 처리 경로는 모드와 규칙에도 영향을 받습니다.

모드의미 및 이번 단계에서의 사용법
Config(구성)현재 구성 파일의 규칙에 따라 처리 방식을 결정합니다. 사용하기 전에 Config에서 실제로 활성화된 파일을 확인하세요.
Proxy(프록시)일반 요청을 선택한 프록시로 처리합니다. 모드별 차이를 임시로 비교할 때 유용하지만, 모든 대상에 접속할 수 있다는 뜻은 아닙니다.
Direct(직접 연결)대상에 직접 연결합니다. 연결 스위치가 켜져 있어도 요청이 선택한 서버를 사용한다고 볼 수 없습니다.

평소 규칙에 따라 요청을 처리하려면 Config를 선택하고 Config 페이지에서 현재 사용 중인 구성 파일을 확인합니다. 구독을 가져오면 서버 목록은 설정할 수 있지만, 규칙까지 자동으로 선택되거나 설정되는 것은 아닙니다. 별도의 구성 파일이 있다면 먼저 출처와 용도를 확인한 뒤 앱의 가져오기 메뉴에서 불러와 선택하세요. 사용할 파일이 없다면 현재 설정을 먼저 살펴보고 기존 내용을 함부로 덮어쓰지 마세요.

Config에서 Rule 확인

공식 스크린샷에는 구성 파일 편집 화면이 표시되어 있습니다. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Add Rule을 확인할 수 있습니다. 처음 설정할 때는 Rule을 중점적으로 살펴보고 규칙이 사용 목적에 맞는지 확인하세요. General 등 다른 섹션에도 각각 용도가 있으므로 첫 연결을 위해 모든 항목을 수정할 필요는 없으며, 모든 고급 기능을 한꺼번에 켤 필요도 없습니다.

규칙은 위에서 아래로 확인하며, 처음 일치하는 규칙이 적용되면 이후 규칙은 확인하지 않습니다. PROXY는 해당 프록시 정책으로 처리하고, DIRECT는 직접 연결하며, REJECT는 요청을 거부합니다. FINAL은 앞선 규칙에 해당하지 않는 요청에 적용되는 기본 규칙입니다. 범위가 좁은 예외 규칙은 일반적으로 범위가 넓은 규칙보다 앞에 둡니다. 첫 연결을 확인하는 것이 목적이라면 기존 설정을 유지하고 현재 상태를 기록하세요. 사용자 규칙을 많이 추가하지 않아도 됩니다.

서버 문제와 규칙 문제를 구분하려면 Proxy를 임시로 선택해 같은 대상에 접속해 비교할 수 있습니다. 테스트가 끝나면 원래 사용하려던 모드로 되돌리세요. 이 방법은 비교를 위한 것이지 장기 설정을 권장하는 것이 아닙니다. 한 번의 비교에서 서버, 규칙, 네트워크를 동시에 바꾸면 결과로 원인을 파악하기 어렵습니다. 규칙 순서에 관한 자세한 설명은 규칙 순서와 FINAL 기본 규칙에서 확인하세요.

Shadowrocket Config 공식 구성 편집 스크린샷: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config 편집 화면: 이번 단계에서는 Rule을 확인하고 모든 섹션을 수정하지 않아도 됩니다.

STEP 03 / CONNECT

Home: 서버를 선택하고 연결 스위치 켜기

먼저 서버를 선택하고 모드를 확인한 다음 연결을 시작합니다. 처음 연결할 때 시스템의 VPN 구성 권한을 요청할 수 있습니다.

앞의 두 단계를 마친 뒤 Home으로 돌아가 SERVER 그룹에서 사용할 서버를 선택하고, 선택한 항목이 의도한 서버인지 확인합니다. 구독에 여러 항목이 있다면 그룹 이름을 현재 사용 중인 서버 이름으로 착각하지 마세요. 실제로 선택된 개별 항목을 확인해야 합니다. 선택할 항목이 보이지 않으면 연결 스위치를 반복해서 켜지 말고 첫 단계로 돌아가 가져오기가 완료됐는지 확인하세요.

이어서 Global Routing을 다시 확인합니다. 서버와 모드를 확인한 뒤 Home 상단의 스위치를 켭니다. 공식 스크린샷의 Not Connected는 촬영 당시 연결되지 않았다는 뜻이며, 입력해야 하는 내용이 아닙니다. 연결을 시작한 뒤 상태가 어떻게 바뀌는지 확인하세요. 스위치가 바로 꺼지거나 오류가 표시되면 안내 문구를 기록하고, 스위치를 빠르게 반복해서 전환하지 마세요. 실패가 발생한 단계를 파악하기 쉬워집니다.

첫 연결 시 시스템 권한 안내 확인

처음 연결을 시작할 때 VPN 구성을 추가하라는 시스템 안내가 표시될 수 있습니다. 이는 앱이 해당 네트워크 연결을 만들도록 허용하는 시스템 권한이며, 기존 서버 계정 인증과는 다릅니다. 요청을 시작한 앱이 Shadowrocket인지 확인한 뒤 시스템 안내에 따라 허용하세요. 기기 인증을 요청하면 기기에 설정된 인증 절차를 완료합니다. 권한을 허용하지 않으면 일반적으로 앱에서 연결을 완료할 수 없습니다.

방금 권한 요청을 취소했다면 Home으로 돌아가 연결을 다시 시작하고 시스템 안내가 표시되는지 확인하세요. 기기 관리 정책으로 제한된 경우에는 해당 기기의 관리 지침을 따르세요. 관련 없는 설정을 변경해 제한을 우회하려고 하지 마세요. 다른 VPN 연결이 기기에서 실행 중인지도 확인해 연결 전환으로 생긴 변화를 서버 문제로 오해하지 않도록 합니다.

권한을 허용한 뒤 Home으로 돌아가 연결 상태가 안정될 때까지 기다린 다음 확인 단계로 넘어갑니다. 시스템에 연결이 설정된 것으로 표시되어도 로컬 연결 절차가 해당 단계까지 진행됐다는 뜻일 뿐, 원격 인증과 대상 접속, 규칙 적용까지 모두 정상이라는 의미는 아닙니다. 이때 앱 설정을 그대로 유지하고 다음 단계의 테스트로 각 항목을 따로 확인하세요.

Shadowrocket Home 공식 스크린샷: 상단에 Not Connected 스위치, Global Routing, Connectivity Test가 표시되고 아래에 SERVER와 Add Server가 표시됩니다
Home: 선택한 서버와 Global Routing을 확인한 뒤 상단의 연결 스위치를 조작합니다.

STEP 04 / VALIDATE

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

연결한 뒤 Home에서 Connectivity Test를 실행해 선택한 서버의 결과를 확인합니다. 테스트 결과는 사용 중인 테스트 방식과 대상에 따라 달라집니다. 결과가 있다고 모든 웹사이트에 접속할 수 있는 것은 아니며, 결과가 없다고 모든 서비스에 문제가 있는 것도 아닙니다. 따라서 테스트는 문제 범위를 좁히는 도구로 활용하고 최종 결론으로 삼지 마세요. 한 번의 테스트 결과만으로 기존 항목을 일괄 삭제하거나 교체하지 마세요.

세 단계로 나눠 확인

  1. 로컬 연결 상태를 확인합니다. Home으로 돌아가 연결이 유지되는지, 선택한 서버가 바뀌지 않았는지, Global Routing이 방금 확인한 모드로 설정되어 있는지 확인합니다. 상태가 안정되지 않았다면 먼저 연결 문제를 해결하세요.
  2. 실제 대상에 접속되는지 확인합니다. 브라우저에서 사용하려던 페이지를 열어 간단한 페이지 하나가 완전히 로드되는지 확인한 다음 실제로 사용할 앱에서도 테스트하세요. 캐시된 페이지가 보이는지만 확인하거나 알림 수신 여부만으로 연결을 판단하지 마세요.
  3. 요청 처리 경로를 확인합니다. 라우팅을 확인해야 한다면 Data 또는 현재 인터페이스에서 확인할 수 있는 연결 기록을 참고해 방금 요청한 대상의 처리 방식을 확인합니다. 트래픽이 변했다는 사실만으로 모든 요청이 PROXY를 거친다고 판단할 수는 없습니다.

일반 웹페이지는 열리지만 특정 앱이 작동하지 않으면 현재 정상 작동하는 설정을 유지하고 문제가 발생한 대상과 작업을 기록하세요. 앱은 여러 도메인과 전송 방식을 사용하거나 자체 로그인 상태에 영향을 받을 수 있습니다. 홈페이지가 열렸다는 이유만으로 필요한 모든 연결이 정상이라고 볼 수는 없습니다. 반대로 특정 대상에 접속되지 않는다고 구독 전체가 작동하지 않는다고 단정할 수도 없습니다.

비교가 필요하면 같은 대상, 같은 서버, 같은 네트워크를 유지하고 조건 하나만 바꿔 테스트하세요. 예를 들어 서버를 그대로 둔 상태에서 Config와 Proxy의 결과를 비교한 다음 원래 설정으로 되돌립니다. 모드에 따라 결과가 달라지면 규칙과 DNS를 우선 확인하세요. 두 모드에서 모두 실패한다면 서버 정보와 연결 가능 여부를 다시 살펴보세요. 여러 스위치를 동시에 변경하는 것보다 원인을 판단하기 쉽습니다.

STEP 05 / DIAGNOSTICS

Settings: 실패 단계에 따라 설정 확인

먼저 어느 단계에서 실패했는지 확인한 뒤 관련 메뉴를 살펴보세요. 한 번에 한 항목만 변경하고 변경 전 값을 기록해 두세요.

구독 항목이 표시되지 않는 경우: 입력 내용과 가져오기 조건 확인

Subscribe를 저장했는데 Home에 예상한 항목이 표시되지 않으면 URL 전체가 올바른지, 공백이나 줄바꿈, 설명 문구가 섞이지 않았는지 먼저 확인하세요. 그런 다음 현재 네트워크에서 구독 내용을 가져올 수 있는지 살펴봅니다. 브라우저에서 구독 주소가 열린다고 해서 현재 가져오기 방식에 맞는 내용이 반환된다는 뜻은 아닙니다. 로그인 페이지나 오류 안내가 반환되면 서버 목록으로 해석할 수 없습니다. 주소 상태, 유효 기간, 내용 관련 문제는 기존 서비스 정보를 제공한 곳에 문의하세요.

서버를 추가했지만 연결되지 않는 경우: 정보와 권한 확인

서버를 직접 추가했다면 항목 편집 화면으로 돌아가 Type, Host, Port, 인증 정보를 하나씩 대조합니다. 프로토콜 유형을 잘못 선택했는지, 포트 번호가 틀렸는지, 비밀번호가 제대로 복사됐는지, TLS 관련 이름이 기존 정보와 일치하는지 확인하세요. 연결을 위해 인증서 확인을 임의로 끄지 마세요. 인증서 안내가 표시되면 기기 시간, 서버 이름, 구성 정보가 서로 일치하는지 먼저 살펴보세요. 스위치가 켜진 상태를 유지하지 못하면 시스템의 VPN 구성 권한을 허용했는지 확인합니다.

테스트와 실제 접속 결과가 다른 경우: Test Method 확인

Settings에서 Test Method를 열고 Connectivity Test가 어떤 방식으로 결과를 판단하는지 확인합니다. 테스트 대상과 포트 연결 가능 여부, 실제 웹페이지 접속은 서로 다른 수준의 확인입니다. 테스트 결과를 속도 보장으로 해석하지 마세요. 공식 스크린샷의 Settings에는 Diagnostics, Proxy, TCP, UDP 등의 메뉴도 표시되어 있습니다. 각 메뉴는 서로 다른 설정이나 진단에 사용되므로 이번 문제와 관련된 항목만 확인하고 익숙하지 않은 스위치를 하나씩 시험하지 마세요.

일부 대상에만 문제가 있는 경우: 규칙과 DNS 확인

Proxy에서는 정상이고 Config에서만 문제가 생기면 Rule의 매칭 순서, 대상이 REJECT에 해당하는지, 범위가 넓은 DIRECT 규칙이 먼저 적용되는지 확인하세요. 도메인을 해석할 수 없다는 안내가 표시되면 DNS 설정도 따로 확인합니다. 서버를 바꿔도 DNS 문제는 해결되지 않을 수 있습니다. 규칙과 프로토콜 개념에 관한 자세한 내용은 기술 참고 자료에서 확인하세요. 지금은 문제를 재현할 수 있고 비교하기 쉬운 최소 설정으로 되돌리는 것부터 시작합니다.

설정이 계속 바뀌는 경우: On Demand 확인

Settings의 On Demand는 연결이 시작되는 조건과 관련이 있으며 Global Routing의 규칙 정책과는 다릅니다. 네트워크 전환 후 예상하지 못한 연결 시작이나 상태 변화가 나타나면 관련 조건이 활성화되어 있는지 확인하고 기존 설정을 기록한 뒤 비교해 보세요. 처음 설정 중이라면 수동 연결이 정상인지 확인하기 전까지 새로운 자동 연결 조건을 추가하지 마세요. 서버, 규칙, 연결 조건 중 무엇이 변화를 일으켰는지 구분하기 어려워질 수 있습니다.

Diagnostics가 필요하다면 오류가 발생했을 때 표시된 안내와 시간 순서, 재현 절차를 기록하세요. 진단 정보를 공유하기 전에 구독 주소, 비밀번호, 인증 정보, 개인 접속 기록을 삭제하세요. 오류 유형과 필요한 상황 정보만 남기면 됩니다. 모든 구성을 먼저 지우지 마세요. 문제 비교에 필요한 유용한 정보까지 사라질 수 있습니다.

위 내용을 확인해도 문제를 찾지 못했다면 문제 해결을 참고해 ‘가져오기 실패, 연결 실패, 일부 접속 실패’ 중 실제로 문제가 발생한 단계부터 확인하세요. 문제 해결을 마치기 전에 임시로 변경한 Global Routing이나 테스트 설정을 복원하고 대상에 다시 접속해 결과를 확인합니다. 이후 설정을 바꿀 때마다 ‘기존 값 기록 → 한 항목 변경 → 다시 확인’ 순서를 따르세요.

Shadowrocket Settings 공식 스크린샷: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 증상에 따라 Test Method, On Demand 또는 Diagnostics를 확인합니다.