공식 안내서 · 첫 설정

Shadowrocket 사용법 가져오기부터 연결 확인까지

정보 추가, 모드 선택, 연결, 확인 순서로 진행합니다. 처음 설정할 때는 정상 작동을 확인한 연결 하나를 먼저 테스트한 뒤 규칙과 자동 연결 설정을 조정합니다.

Add Server Global Routing Connectivity Test

STEP 01 / 연결 정보 준비

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

완료 기준: Home의 SERVER 그룹에 선택 가능한 서버가 표시됩니다. 링크만 저장된 상태는 완료가 아닙니다.

Shadowrocket을 열고 먼저 전달받은 정보가 여러 서버 항목을 불러오는 구독 링크인지, 단일 서버의 전체 매개변수인지 확인합니다. 두 정보는 진입 경로와 용도가 다릅니다. 구독은 서버 항목을 묶어서 가져오고 업데이트하는 데 사용하며, 수동 추가는 지정한 서버를 기기에 저장합니다. 처음 설정할 때는 한 가지 방법만 선택하면 됩니다. 같은 정보를 여러 경로로 반복해서 가져올 필요는 없습니다.

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

서비스 제공업체에서 전체 구독 링크를 복사한 뒤 Config를 열고 Subscribe 항목을 찾습니다. 안내에 따라 링크를 붙여넣고 알아보기 쉬운 이름을 입력해 저장한 다음 업데이트합니다. 앱 화면이 변경될 수 있으므로 현재 표시되는 Subscribe 항목을 기준으로 진행하세요. 링크의 쿼리 매개변수도 주소의 일부입니다. 물음표 뒤의 내용을 삭제하거나 안내 페이지 주소를 구독 주소로 사용하지 마세요.

가져오기가 끝나면 Home으로 돌아가 SERVER 그룹을 확인합니다. 저장은 되었지만 서버가 표시되지 않는다면 먼저 구독 업데이트 결과를 확인하고, 서버에서 식별 가능한 데이터가 실제로 반환되었는지 점검합니다. 구독과 구성 파일은 서로 다른 형식입니다. 구독은 주로 서버 항목을 제공하고, 구성 파일에는 규칙과 다른 설정이 포함될 수 있습니다. 구독을 가져오려고 기존 구성을 바로 교체하지 마세요.

https://example.com/sub?token=xxxx

위 주소는 형식 예시일 뿐 실제로 사용할 수 있는 구독 링크가 아닙니다. 실제 링크에는 개인 자격 증명이 포함되는 경우가 많으므로 공개 댓글, 스크린샷, 공유 문서에 게시하지 마세요.

서버 매개변수가 있는 경우: Add Server 사용

Home으로 돌아가 SERVER 그룹에서 Add Server를 누릅니다. 먼저 서버 측과 일치하는 Type을 선택한 뒤 Host와 Port를 입력합니다. 해당 Type에서 필요한 Password, Method 또는 기타 인증 정보도 입력합니다. 스크린샷은 한 가지 필드 조합을 보여 줍니다. VLESS, Trojan 등 다른 Type을 선택하면 필드가 달라지므로 스크린샷의 항목을 모든 프로토콜에 그대로 적용하면 안 됩니다.

Host에는 일반적으로 서버에서 제공한 도메인이나 IP를 입력합니다. 웹 주소의 경로를 임의로 추가하지 마세요. Port는 서버의 수신 포트와 일치해야 합니다. TLS, 전송 방식, 경로 또는 서버 이름이 필요한 Type은 서비스 제공업체의 매개변수를 항목별로 확인해야 합니다. 주소와 비밀번호만 입력했다고 설정이 끝난 것은 아닙니다. 저장한 뒤 Home으로 돌아가 추가한 항목을 선택하고 현재 선택 표시를 확인합니다.

개인 QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. Import from Cloud JSON은 해당 형식의 가져오기에 쓰이며, 임의의 웹 링크를 가져오는 일반 경로가 아닙니다. 가져온 뒤에도 Type, Host, Port를 확인합니다. 서버를 저장했다는 것은 정보가 클라이언트에 기록되었다는 뜻일 뿐, 연결 가능 여부는 다음 단계에서 확인해야 합니다. 여러 가져오기 방법을 비교하려면 구독 및 서버를 가져오는 네 가지 방법을 확인하세요.

Shadowrocket 공식 Add Server 화면. Type, Host, Port, Password, Method 및 QR 코드 가져오기 항목 표시
Add Server: 먼저 Type을 선택한 다음 서버 정보에 맞춰 해당 필드를 입력합니다.

STEP 02 / 요청 경로 결정

Global Routing 모드 선택

완료 기준: 현재 서버와 라우팅 모드를 구분하고 사용 중인 구성 파일을 확인합니다.

서버를 추가한 뒤 Home으로 돌아가 Global Routing을 누릅니다. 여기서 요청을 처리하는 방식을 정합니다. SERVER에서 “어떤 서버를 선택할지” 정하는 것과는 별개의 설정입니다. 서버만 바꾸고 모드를 확인하지 않으면 실제 요청은 기존 방식대로 처리될 수 있습니다. 처음 사용할 때는 Config/Proxy/Direct 세 가지 모드를 이해하는 것이 중요합니다. 화면에 Scene이 표시되더라도 기본 연결 확인을 마칠 때까지는 현재 설정을 유지하고 나중에 장면 구성을 살펴보세요.

Config: 현재 구성 파일의 규칙에 따라 분기

일상적으로 규칙에 따라 트래픽을 분기하려면 Config를 선택합니다. 클라이언트는 현재 활성 구성의 규칙에 따라 요청에 PROXY, DIRECT, REJECT 중 어떤 정책을 적용할지 판단합니다. Config를 열어 현재 사용 중인 파일을 확인한 다음 Rule로 이동해 내용을 살펴봅니다. 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 서로 다른 설정 영역입니다. 처음 연결할 때 하나씩 수정할 필요는 없으며 이 안내서를 따라 하기 위해 HTTPS Decryption을 활성화할 필요도 없습니다.

Rule의 규칙은 일반적으로 위에서 아래 순서로 확인합니다. 처음 일치하는 규칙의 정책이 적용되고 마지막의 FINAL은 앞에서 일치하지 않은 요청을 처리합니다. 아래 코드는 순서를 이해하기 위한 예시이며, 현재 구성을 그대로 교체할 필요는 없습니다. 수정 전에는 원본 파일을 보관해 기존 규칙을 복구할 수 있도록 하세요.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

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

Proxy는 프록시 처리가 필요한 요청을 선택한 서버로 전달합니다. 이를 통해 “서버가 작동하는지”와 “규칙 때문에 요청 경로가 잘못되었는지”를 비교할 수 있습니다. 모든 앱과 네트워크 환경에서 반드시 작동한다는 뜻은 아니며 올바른 서버 매개변수를 대신할 수도 없습니다. Direct는 프록시 서버를 거치지 않으며 직접 접속하거나 프록시 경로의 영향을 확인하는 데 사용합니다. Direct를 선택하면 연결 스위치가 켜져 있어도 요청이 프록시 서버를 통과한다고 볼 수 없습니다.

신뢰할 수 있는 구성이 이미 있다면 먼저 Config로 연결을 확인합니다. 이후 일부 대상에서만 문제가 생기면 잠시 Proxy로 전환해 같은 대상을 비교하고 테스트 후에는 원래 모드로 되돌립니다. DOMAIN-SUFFIX, FINAL, 정책의 자세한 의미는 용어 안내서를 확인하세요. 규칙 순서로 문제가 생겼다면 문제 해결 안내서에서 점검을 이어가세요.

Shadowrocket 공식 Config 편집 화면. General, Rule, Hosts 등의 영역과 Add Rule 표시
Config: Config 모드는 현재 구성을 사용하며 Rule 영역에서 규칙을 확인합니다.

STEP 03 / 시스템 연결 설정

Home 상단의 연결 스위치 켜기

완료 기준: 시스템 승인을 마치고 Home으로 돌아왔을 때 스위치가 켜져 있으며 상태가 Not Connected에 머물지 않습니다.

Home으로 돌아가 SERVER에서 선택한 서버와 Global Routing을 다시 확인합니다. 두 항목을 확인한 뒤 상단의 Not Connected 옆에 있는 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가할지 물을 수 있습니다. 안내를 읽고 허용한 뒤 시스템 요구에 따라 기기 암호나 생체 인식으로 확인합니다. 이 승인은 시스템 네트워크 통로를 설정하기 위한 것으로 구독의 유효 여부와는 별개의 문제입니다.

승인을 마친 뒤 Shadowrocket으로 돌아와 스위치와 상태가 유지되는지 확인합니다. 켜자마자 자동으로 꺼진다면 시스템 안내를 먼저 확인하고 구독을 반복해서 가져오거나 서버를 여러 개 연속해서 만들지 마세요. 기기의 다른 VPN 연결, 관리 기기의 제한, 완료되지 않은 시스템 확인이 이 단계에 영향을 줄 수 있습니다. 다른 VPN을 먼저 연결 해제한 뒤 앱에서 다시 시도할 수 있습니다. 조직에서 관리하는 기기는 관리자 안내에 따르고, 알 수 없는 관리 구성을 삭제하지 마세요.

iPad는 화면 크기나 분할 화면 상태에 따라 스크린샷과 레이아웃이 다를 수 있지만 작업 순서는 같습니다. 먼저 서버를 선택하고, Global Routing을 확인한 다음, 마지막으로 연결 스위치를 켭니다. 항목을 찾기 어렵다면 Home으로 돌아가고 필요하면 분할 화면을 종료한 뒤 확인하세요. 시스템 네트워크 설정의 다른 스위치를 앱 내 연결 버튼으로 착각하지 마세요.

연결 상태가 표시된 뒤에는 On Demand를 변경하거나 여러 옵션을 동시에 조정하지 마세요. 상단 스위치가 켜졌다는 것은 시스템 통로가 설정되었다는 의미일 뿐, 서버 인증이 정상이라는 뜻은 아닙니다. 규칙이 대상을 Direct로 보낼 수도 있습니다. 현재 상태를 유지하고 다음 단계에서 실제 접속을 확인해야 전체 연결이 작동하는지 알 수 있습니다.

Shadowrocket 공식 Home 화면. Not Connected 스위치, Global Routing, Connectivity Test 및 SERVER 그룹 표시
Home: SERVER와 Global Routing을 확인한 뒤 상단 연결 스위치를 조작합니다.

STEP 04 / 실제 결과 확인

연결과 규칙이 작동하는지 확인

완료 기준: 실제 대상에 정상적으로 접속할 수 있고 요청에 적용된 정책이 예상과 일치합니다.

연결 스위치를 켜 둔 상태에서 Home의 Connectivity Test를 실행해 현재 테스트 방식에 따른 연결 상태를 참고합니다. 테스트 결과가 표시되어도 모든 웹사이트나 프로토콜이 정상이라는 뜻은 아닙니다. 시간 초과가 표시되더라도 테스트 대상, 테스트 방식, 실제 접속 결과를 함께 확인해야 합니다. 한 번의 테스트 수치만으로 구성을 크게 바꾸지 마세요.

  1. 먼저 기본 네트워크를 확인합니다. 브라우저에서 평소 정상적으로 열리고 접근 권한이 있는 페이지에 접속합니다. 연결을 끈 뒤에도 전혀 접속할 수 없다면 서버 매개변수를 계속 수정하기보다 Wi-Fi, 셀룰러 네트워크 또는 네트워크 로그인 페이지부터 확인합니다.
  2. 실제 대상을 테스트합니다. 프록시로 처리될 것으로 예상하는 대상에 접속한 뒤 한 번 새로고침합니다. 브라우저 캐시를 새 연결 결과로 오해하지 않도록 하세요. 특정 앱에서만 실패한다면 브라우저로 같은 서비스의 접근 가능한 페이지에 접속해 비교합니다.
  3. 요청 정책을 확인합니다. 앱에서 확인할 수 있는 요청 기록이나 Data 정보에서 방금 테스트한 대상을 찾고 일치한 규칙 및 PROXY, DIRECT, REJECT 결과를 확인합니다. 화면에 따라 기록 필드는 다를 수 있습니다. 중요한 점은 “같은 대상이 예상한 경로를 사용했는가”입니다.

Config에서 한 대상은 정상이고 다른 대상은 실패한다면 규칙 일치, DNS 확인, 대상 서비스 자체의 제한을 추가로 구분해야 합니다. Proxy로 잠시 전환한 뒤 서버와 대상을 유지해 다시 테스트할 수 있습니다. Proxy는 정상이지만 Config에서 실패하면 규칙을 먼저 확인하고, 둘 다 실패하면 서버와 대상 사이의 경로를 우선 확인합니다. 이는 문제를 찾는 방법이지 Proxy를 모든 문제의 고정 해결책으로 사용하라는 뜻은 아닙니다.

웹페이지에 표시되는 출구 IP 주소를 유일한 근거로 삼지 마세요. Config 모드에서는 대상마다 다른 정책을 사용할 수 있으므로 특정 조회 페이지가 직접 연결되더라도 모든 요청이 직접 연결된다는 뜻은 아닙니다. 확인할 때는 대상, 모드, 선택한 서버, 결과를 기록합니다. 매번 조건 하나만 바꾸고 테스트가 끝나면 예정된 Config 모드로 되돌립니다.

STEP 05 / 실패한 단계부터 확인

자주 발생하는 문제와 Settings 점검

먼저 문제가 발생한 단계를 파악한 뒤 해당 설정을 변경합니다. 모든 옵션을 한꺼번에 초기화하지 마세요.

구독을 저장했지만 서버가 표시되지 않음

구독 항목으로 돌아가 업데이트 결과를 확인합니다. 붙여넣은 구독 링크가 완전한지, 공백이나 줄바꿈이 추가되거나 매개변수가 빠지지 않았는지 확인하고 현재 네트워크에서 해당 주소에 접속할 수 있는지도 점검합니다. 링크 만료, 로그인 페이지 반환, 지원되지 않는 형식 반환 등으로 목록이 생성되지 않을 수 있습니다. 이 경우 자신의 서비스 제공업체에 링크 상태를 문의하세요. 자격 증명이 포함된 전체 주소를 공개 검사 페이지에 입력하지 마세요. 자세한 내용은 구독 업데이트 안내를 확인하세요.

스위치는 켜지지만 서버가 시간 초과됨

먼저 방금 추가한 항목을 선택했는지 확인한 다음 Type, Host, Port, 인증 정보, TLS와 전송 매개변수를 하나씩 점검합니다. 기기의 시스템 시간이 자동으로 설정되어 있는지도 확인하세요. Settings에서 Test Method를 엽니다. 테스트 방법에 따라 측정하는 단계가 다르므로 방법을 변경한 뒤의 수치를 이전 결과와 바로 비교할 수는 없습니다. 서버가 응답하지 않을 때 로컬 규칙을 반복해서 바꿔도 대개 해결되지 않습니다.

일부 웹페이지가 실패하거나 연결이 다시 자동으로 켜짐

일부 대상에서 문제가 생기면 앞 단계에서 설명한 Config와 Proxy 비교 방법을 사용해 더 먼저 적용되는 규칙과 일치했는지 확인합니다. 수동으로 연결을 끊은 뒤 연결이 다시 나타난다면 Settings의 On Demand를 살펴보고 해당 조건이 설정되어 있는지 확인합니다. 처음 사용할 때는 수동 연결을 먼저 확인한 뒤 자동 연결을 설정하세요. 자동 연결 동작을 변경할 때는 기존 설정을 기록해 두어 테스트 후 복구를 잊지 않도록 합니다.

Settings에는 Proxy, TCP, UDP 등의 그룹도 있지만 문제가 발생했다고 반드시 수정해야 하는 항목은 아닙니다. 특정 앱에서 실시간 음성이나 일부 기능만 실패하는 경우 실제로 사용하는 전송 유형에 맞춰 해당 항목을 확인하세요. 테스트 하나를 통과시키기 위해 모든 설정을 임의로 바꾸면 비교 기준을 잃게 됩니다.

추가 점검을 위해 보관할 정보

Settings의 Diagnostics에서 이용 가능한 진단 정보를 확인하고 실제 실패 시간 및 작업 단계와 함께 문제를 파악합니다. “가져오기 성공 여부, 스위치 유지 여부, Connectivity Test 결과, 실패한 대상, Config와 Proxy의 차이”를 기록하면 단순히 “작동하지 않는다”고 알리는 것보다 문제를 파악하는 데 도움이 됩니다. 기록을 공유하기 전에 구독 주소, 비밀번호, 개인 서버 주소 및 기타 인증 정보를 가리세요.

이 페이지에서 첫 설정 절차를 마칩니다. 시간 초과, DNS 이상, 배터리 소모 변화 또는 업데이트 후 문제가 계속되면 증상별 문제 해결 안내서를 확인하세요. 설정 이름의 의미만 궁금하다면 전체 구성을 다시 가져올 필요 없이 용어 안내서를 확인하면 됩니다.

Shadowrocket 공식 Settings 화면. Test Method, On Demand, Diagnostics, Proxy, TCP 및 UDP 그룹 표시
Settings: 증상에 따라 Test Method, On Demand 또는 Diagnostics를 확인하고 비교를 위해 기존 설정을 보관합니다.
Shadowrocket 무료 다운로드