공식 매뉴얼 · 첫 설정

Shadowrocket 사용법

기존 구독이나 서버를 추가하고 Global Routing을 선택한 다음 연결을 켜세요. Connectivity Test와 실제 접속 결과를 비교해 확인합니다.

1단계 · 서버 항목 준비

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

Home에서 Add Server를 찾아 보유한 정보의 종류를 확인합니다. 서비스 제공자가 프로토콜 유형, 주소, 포트 및 인증 정보를 제공했다면 서버 한 대를 직접 추가합니다. 서버 목록을 가져오는 구독 링크를 받았다면 Subscribe를 선택합니다. 하나의 정보는 둘 중 한 가지 방식으로만 입력합니다. 구독 링크는 보통 URL 형식이지만 서버 주소와는 다르므로 Host에 입력해 서버 한 대처럼 사용할 수 없습니다.

서버 한 대 입력

Add Server에 들어간 뒤 Type에서 서비스 제공자가 안내한 프로토콜을 선택하고 표시되는 항목을 입력합니다. Host에는 제공된 호스트 이름이나 IP 주소를, Port에는 해당 포트를 입력합니다. 화면에 표시된 Password와 Method는 이 양식의 필드 예시입니다. Type을 변경하면 필수 입력 항목도 프로토콜에 따라 달라집니다. 스크린샷에 나온 필드 조합을 그대로 따라 하지 말고, 누락된 정보를 채우려고 프로토콜을 임의로 바꾸지 마세요.

저장하기 전에 원본 정보와 입력 내용을 위에서부터 하나씩 대조합니다. 주소를 복사할 때 앞뒤 공백이나 줄바꿈이 없는지 확인하고 포트는 별도로 입력합니다. 서비스 제공자가 QR 코드를 제공했다면 같은 화면에서 Scan QR Code를 찾아 스캔할 수 있습니다. 가져온 뒤에도 유형과 서버 주소를 확인해야 합니다. Import from Cloud JSON은 JSON 가져오기 기능이며 일반 구독 링크를 입력하는 곳이 아닙니다.

서버 목록 가져오기

Add Server의 Type에서 Subscribe를 선택하고 서비스 제공자가 준 전체 구독 링크를 붙여 넣은 뒤 저장합니다. 복사할 때 링크 끝의 매개변수를 빠뜨리거나 안내 문구까지 함께 붙여 넣지 마세요. 구독 주소에 접근 인증 정보가 포함될 수 있습니다. 문제를 기록할 때는 오류 문구와 발생 시간만 남기고 원본 링크나 링크가 포함된 스크린샷을 공개하지 마세요.

Add Server 화면에 표시된 Type, Host, Port, Password, Method와 QR 스캔 및 JSON 가져오기 메뉴
Add Server: Type을 먼저 선택한 다음 해당 유형에 필요한 항목을 확인합니다.

다음 단계로 넘어가기 전에: Home으로 돌아가 SERVER에 방금 저장한 항목이 표시되는지, 또는 구독 그룹을 펼쳤을 때 실제 서버가 보이는지 확인합니다. 그룹 이름이 표시된다고 서버 목록을 가져온 것은 아닙니다. 빈 그룹만 보인다면 연결 테스트를 계속하지 말고 일반적인 실패 원인을 확인하세요.

2단계 · 요청 경로 결정

Global Routing: Config, Proxy 또는 Direct 선택

Home에서 Global Routing을 엽니다. 이 설정은 연결을 켰을 때 클라이언트가 트래픽을 처리하는 방식을 정합니다. SERVER에서 선택한 서버와는 서로 독립된 설정입니다. 서버를 현재 항목으로 선택해도 Global Routing이 자동으로 Proxy로 바뀌지는 않습니다. 먼저 확인할 모드를 선택한 다음 다음 단계에서 스위치를 켜 연결을 시작합니다.

이번 확인 목적에 맞는 모드 선택

구성 (Config)
현재 적용 중인 구성 파일에 따라 요청을 처리합니다. 도메인이나 네트워크 대역이 규칙과 일치하면 규칙에 지정된 정책을 사용하고, 앞선 규칙에 일치하지 않으면 FINAL에 지정된 경로를 확인합니다. 구성 내용을 알고 있고 평소의 라우팅 동작을 확인하려면 이 항목을 선택합니다.
프록시 (Proxy)
클라이언트가 처리하는 트래픽을 Config의 규칙별 라우팅 대신 현재 선택한 프록시 서버로 보냅니다. 처음 문제를 확인할 때 잠시 사용하면 “서버가 요청을 처리할 수 있는지”와 “대상이 예상한 규칙과 일치하는지”를 나누어 확인할 수 있습니다.
직접 연결 (Direct)
클라이언트가 처리하는 트래픽을 선택한 프록시 서버를 거치지 않고 대상에 직접 보냅니다. 상단 연결 스위치를 끄는 설정은 아닙니다. 비교 테스트 중에도 스위치는 켜 둔 상태로 사용할 수 있습니다.

Config를 선택한 경우 현재 파일 확인

Config를 선택했다면 하단의 Config 탭으로 이동해 현재 활성화된 파일을 확인합니다. 해당 파일을 열어 Rule을 확인하고 대상과 관련된 조건 및 정책을 찾은 다음 규칙의 순서와 마지막의 FINAL을 확인합니다. 예를 들어 일치하는 규칙이 DIRECT를 지정한다면 연결이 켜져 있어도 해당 요청이 직접 연결되는 이유를 설명할 수 있습니다.

Config 편집 화면에 표시된 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule
Config 편집 화면: Rule에서 조건과 정책을 확인할 수 있습니다. 첫 연결에는 Add Rule을 사용할 필요가 없습니다.

다음 단계로 넘어가기 전에: Home으로 돌아가 Global Routing 옆에 표시된 모드를 확인합니다. 처음 확인할 때 규칙과 서버를 동시에 바꿀 필요는 없습니다. 현재 모드를 기록한 뒤 확인 결과를 보고 변경이 필요한지 판단하세요. 규칙 키워드의 의미는 용어 매뉴얼에서 확인할 수 있습니다.

3단계 · 연결 시작

Home: 서버 선택 후 연결 켜기

점 표시가 테스트할 서버를 가리키는지 확인

Home으로 돌아가 SERVER에서 사용할 서버를 찾아 항목을 선택하고 점 표시가 해당 행으로 이동했는지 확인합니다. 이름이 비슷한 서버를 여러 개 가져왔다면 메모나 주소를 대조해 이전에 사용한 항목을 잘못 선택하지 않도록 합니다. 그룹을 펼치거나 상세 화면을 여는 것만으로는 서버가 선택되지 않습니다. 선택한 뒤 현재 Global Routing 모드를 유지하면 같은 설정으로 다음 테스트를 비교할 수 있습니다.

처음 표시되는 시스템 확인 처리

Home 상단에 Not Connected가 표시되면 같은 행의 스위치를 누릅니다. 처음 켤 때 시스템에서 VPN 구성 추가를 요청할 수 있습니다. 방금 Shadowrocket에서 시작한 작업인지 확인한 뒤 허용하고 시스템 안내에 따라 인증을 완료합니다. 관련 구성을 이미 추가했다면 이번에는 안내가 다시 표시되지 않을 수 있습니다. 실수로 확인을 취소했다면 Home으로 돌아가 다시 시작하면 됩니다. 같은 구독을 새로 가져올 필요는 없습니다.

시스템 확인이 끝나면 Home으로 돌아가 상태가 안정될 때까지 기다리고 스위치가 켜진 상태인지 확인합니다. 스위치가 곧바로 꺼짐으로 돌아가면 연속해서 켜고 끄거나 여러 서버를 바꾸지 마세요. 시스템 안내와 스위치 상태 변화를 기록하고 문제 해결 단계를 확인합니다. 스위치가 켜졌다는 것은 로컬 연결이 시작되었다는 뜻일 뿐, 선택한 서버가 사용 가능하거나 특정 대상이 예상대로 라우팅된다는 것을 단독으로 증명하지는 않습니다.

Home 화면에 표시된 Not Connected 스위치, Global Routing, Connectivity Test 및 SERVER 그룹
Home: SERVER에서 항목을 선택한 다음 상단 스위치를 조작합니다. Connectivity Test도 같은 화면에 있습니다.

4단계 · 두 가지 결과 비교

Connectivity Test: 실제 접속과 함께 확인

연결을 켠 뒤 Home에서 Connectivity Test를 실행하고 결과를 기다립니다. 당시 사용한 서버, Global Routing 및 네트워크 환경을 함께 기록하세요. 예를 들어 Wi-Fi와 셀룰러 중 어떤 네트워크를 사용했는지 적습니다. 테스트 결과는 당시 사용한 테스트 방식에서의 연결 가능 여부를 보여 주며 모든 앱, 도메인 또는 요청의 결과가 같다는 뜻은 아닙니다. 테스트가 한 번 실패했다고 즉시 재설치하거나 구성을 지울 필요는 없습니다.

이어서 브라우저에서 평소 사용할 수 있고 확인이 필요한 페이지에 접속합니다. 새로 로드해야 하는 콘텐츠를 열고 이미 표시된 이전 탭만 확인하지 마세요. 새 요청이 발생하지 않아도 캐시된 콘텐츠가 계속 보일 수 있습니다. Config를 확인한다면 DIRECT로 연결될 것으로 예상하는 대상과 PROXY를 사용할 것으로 예상하는 대상을 각각 골라 접속 여부를 기록할 수 있습니다. 페이지가 열린다는 사실은 접속에 성공했다는 뜻일 뿐 어떤 정책을 거쳤는지 그 자체만으로 판단할 수는 없습니다.

테스트는 정상이지만 특정 대상만 열리지 않는다면 서버를 그대로 두고 해당 대상이 Rule과 일치하는지 확인합니다. 웹페이지 로딩에는 기본 주소 외의 리소스 도메인도 포함될 수 있으므로 주소창의 기본 도메인만 확인하지 마세요. 비교가 필요하면 Proxy로 잠시 전환한 뒤 같은 네트워크에서 같은 페이지를 엽니다. Proxy에서는 접속되지만 Config에서는 되지 않는다면 규칙 순서와 기본 정책을 우선 확인합니다. 비교가 끝나면 평소 사용하는 모드로 되돌리고 Home에서 설정이 복구되었는지 확인합니다.

5단계 · 이상이 발생한 지점부터 확인

Settings: 실패 지점에 따라 문제 해결

먼저 Home에서 문제가 발생한 단계를 확인합니다. 목록이 비어 있는지, 스위치가 켜진 상태를 유지하지 못하는지, 테스트가 실패하는지, 특정 페이지만 문제가 있는지 살펴봅니다. 프로토콜, 서버, 규칙을 한꺼번에 바꾸지 마세요. 아래 항목을 발생 순서에 따라 확인하고 앞 단계가 해결되지 않았다면 뒤 단계의 설정은 먼저 변경하지 않아도 됩니다.

구독 그룹은 있지만 서버가 표시되지 않음

저장할 때 Subscribe를 선택했는지 확인한 다음 원본 구독 정보와 대조해 링크가 완전한지, 특히 쿼리 매개변수가 빠지지 않았는지 확인합니다. 구독 그룹에 업데이트 기능이 있다면 네트워크 연결을 확인하고 수동으로 한 번 업데이트한 다음 SERVER로 돌아가 실제 항목이 있는지 살펴봅니다. 목록이 여전히 비어 있다면 해당 구독을 제공한 서비스 제공자에게 링크 상태와 응답 내용을 문의할 수 있습니다. 같은 링크를 반복해서 추가해도 확인해야 할 그룹만 늘어납니다.

스위치를 끈 뒤 다시 자동으로 켜지거나 켜진 상태를 유지하지 못함

스위치를 켤 수 없다면 시스템에서 VPN 구성 추가를 허용했는지 확인하고 다른 VPN 연결이 사용 중인지 확인합니다. 관리 기기라면 기기 관리 정책을 따르세요. 수동으로 껐는데 다시 자동 연결되는 문제라면 Settings에서 On Demand가 켜져 있는지, 현재 네트워크가 해당 조건을 충족하는지 확인합니다. 원래 설정을 기록한 뒤 필요한 경우 한 번에 하나씩 비교하세요. 자동 연결을 스위치 오류로 오해하지 않도록 합니다.

스위치는 켜져 있지만 테스트가 실패함

기기의 기본 네트워크가 정상인지 확인한 다음 Home으로 돌아가 점 표시가 가리키는 항목을 확인합니다. 직접 추가한 서버라면 Type, Host, Port 및 프로토콜에 필요한 항목을 하나씩 대조합니다. 추측한 포트로 기존 설정을 덮어쓰지 마세요. Settings에서 Test Method를 변경했다면 현재 선택값을 먼저 기록합니다. 테스트 방식에 따라 결과가 달라질 수 있으므로 비교할 때는 동일한 방식을 유지하세요.

Settings 화면에 표시된 Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP
Settings: 문제 해결 시 Test Method와 On Demand를 중점적으로 확인합니다. 추가 정보가 필요하면 Diagnostics를 살펴보세요.

테스트는 성공하지만 평소 접속 결과가 예상과 다름

먼저 비교를 위해 사용한 Proxy 또는 Direct 모드가 아직 적용 중인지 확인한 다음 Config에서 예상한 파일이 활성화되어 있는지 확인합니다. 일부 대상만 문제가 있다면 해당 대상의 규칙 조건, 순서 및 최종 정책을 우선 확인합니다. 먼저 TCP, UDP 또는 다른 설정을 변경할 필요는 없습니다. 추가 확인이 필요하면 Diagnostics를 살펴보세요. 결과를 전달하기 전에 구독 주소, 서버 인증 정보 및 불필요한 접속 기록을 가리세요.

다음 단계: 확인 단계에 따라 다시 테스트합니다. 실패한 단계를 파악했다면 FAQ에서 해당 증상을 확인하세요. 프로토콜 필드를 설명하거나 유형을 비교하려면 기술 참고 자료를 살펴보세요.