공식 가이드 · 빠른 시작

Shadowrocket 빠른 시작

기존 서버 또는 구독을 가져오고 라우팅 모드를 선택한 다음 서버와 웹 접속을 각각 확인합니다.

단계 01 · 가져오기

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

Shadowrocket을 열고 Home 화면에 머뭅니다. 오른쪽 위의 더하기 버튼이나 SERVER 그룹의 Add Server를 눌러 추가 화면으로 이동합니다. 먼저 보유한 정보의 종류를 확인합니다. 주소, 포트, 인증 정보가 한 세트로 제공되었다면 단일 서버 정보입니다. 서버 목록을 가져오는 링크는 구독이고, 서비스 제공자가 서버 QR 코드를 제공했다면 QR 코드로 추가할 수 있습니다. 동일한 정보를 가져오는 방법은 하나만 선택하면 됩니다. 구독 링크를 나눠 단일 서버 필드에 입력하지 마세요.

수동 입력: Type을 선택한 다음 매개변수 입력

Type을 열고 정보에 명시된 프로토콜을 선택합니다. 예를 들어 Shadowsocks를 사용하는 경우 호스트 이름 또는 IP 주소를 Host에, 포트를 Port에 입력하고 비밀번호와 암호화 방식은 각각 Password와 Method에 입력합니다. 포트가 포함된 전체 주소를 Host에 입력하거나 다른 서버의 비밀번호 또는 암호화 방식으로 빈 항목을 채우지 마세요. 프로토콜에 따라 필드가 달라집니다. 정보와 필드가 맞지 않으면 먼저 Type을 다시 확인한 뒤 입력을 계속합니다. 필드의 의미는 프로토콜 설명을 참조하세요.

구독 또는 QR 코드: 원본 정보 유지

구독 링크가 있다면 Type에서 Subscribe를 선택하고 링크 필드에 전체 링크를 붙여 넣은 뒤 저장합니다. 링크 끝의 쿼리 매개변수도 링크의 일부이므로 길이를 줄이기 위해 삭제하지 마세요. 기존 서버의 QR 코드가 있다면 추가 화면에서 Scan QR Code를 사용합니다. 시스템 안내에 따라 카메라 접근을 허용한 뒤 QR 코드를 비추고 인식된 정보가 보유한 정보와 일치하는지 확인합니다. 비밀번호, 구독 매개변수 또는 QR 코드가 포함된 전체 화면을 공개 채널에 공유하지 마세요.

저장한 뒤 Home으로 돌아가 SERVER 아래에 새 항목이 표시되는지, 또는 구독 그룹을 펼쳤을 때 서버 목록이 실제로 표시되는지 확인합니다. 구독 그룹 이름만 보인다고 해서 목록을 성공적으로 가져온 것은 아닙니다. 그룹이 비어 있다면 현재 네트워크에서 링크가 완전하고 여전히 유효한지 확인합니다. 선택할 수 있는 서버가 목록에 나타나면 다음 단계로 진행합니다.

Shadowrocket의 Add Server 화면. 서버 필드와 Scan QR Code 진입 항목이 표시됩니다
Add Server: 먼저 Type을 확인한 다음 해당 필드를 입력합니다. QR 코드는 Scan QR Code에서 추가합니다.

단계 02 · 라우팅

Global Routing에서 처리 모드 선택

서버가 목록에 표시되면 Home에서 Global Routing을 엽니다. 이 설정은 ‘트래픽을 어떤 방식으로 처리할지’를 정하며 ‘어떤 서버를 선택할지’를 정하는 설정은 아닙니다. 처음 단계별로 확인할 때는 선택한 모드를 기록하고 Home으로 돌아가 해당 행에 표시된 이름을 확인합니다. 이후 결과를 비교할 때 서버나 네트워크를 동시에 바꾸지 마세요. 어떤 변경이 결과에 영향을 주었는지 판단하기 어려워집니다.

구성(Config)
현재 적용 중인 구성 규칙에 따라 요청을 처리합니다. 요청에 따라 프록시를 사용하거나 직접 연결하거나 거부 정책이 적용될 수 있습니다. 사용할 수 있는 규칙 구성이 있고 일상적인 라우팅을 확인하려면 이 항목을 선택합니다. 특정 웹 페이지가 열린다는 사실만으로 프록시 규칙이 적용되었다고 판단하지 마세요.
프록시(Proxy)
이 모드에서 처리되는 트래픽을 선택한 프록시 서버로 전달합니다. 프록시 연결을 먼저 확인하고 현재 구성의 라우팅 규칙이 판단에 영향을 주지 않도록 하려면 잠시 이 항목으로 전환해 테스트할 수 있습니다. 비교를 마친 뒤 평소 사용하는 모드로 되돌립니다.
직접 연결(Direct)
이 모드에서 처리되는 트래픽을 프록시 서버를 거치지 않고 직접 연결합니다. 기기의 현재 네트워크에서 동일한 웹 페이지에 접속할 수 있는지 비교할 때 적합합니다. 연결 스위치가 켜져 있더라도 직접 연결 결과로 선택한 서버의 사용 가능 여부를 판단할 수는 없습니다.

이름이 같은 Config 모드와 Config 화면 구분

Global Routing의 Config는 처리 모드이며, 하단의 Config는 구성 파일을 확인하고 관리하는 화면입니다. 첫 연결을 위해 Add Rule을 누르거나 General 또는 Hosts를 수정할 필요는 없습니다. 나중에 특정 도메인이 예상과 다른 경로로 연결되는 것을 발견하면 현재 적용 중인 구성의 Rule로 돌아가 앞에서 일치한 규칙이 있는지, 일치하지 않을 때 어떤 기본 정책이 적용되는지 확인합니다. 규칙 키워드는 용어 가이드에서 확인할 수 있습니다.

Shadowrocket의 Config 구성 파일 편집 화면. General, Rule, Hosts 섹션과 Add Rule이 표시됩니다
Config 파일 편집 화면입니다. 트래픽 처리 모드를 바꾸려면 Home으로 돌아가 Global Routing을 엽니다.

단계 03 · 연결

Home에서 서버를 선택하고 연결 켜기

Home으로 돌아가 대상 서버가 포함된 SERVER 그룹을 펼친 뒤 사용할 항목을 선택합니다. 항목 옆의 점으로 선택 상태를 확인합니다. 특히 이름이 비슷한 항목이 여러 개라면 그룹을 펼쳤거나 테스트 수치가 보인다는 이유만으로 선택된 것으로 여기지 마세요. 첫 테스트에서는 식별할 수 있는 서버 하나만 선택합니다. 이후 해당 항목의 결과와 웹 접속 동작을 서로 비교합니다.

첫 연결 시 시스템 안내 처리

서버와 모드를 확인한 다음 Home 상단의 연결 스위치를 켭니다. 처음 실행할 때 iPhone 또는 iPad에서 VPN 구성을 추가할지 물을 수 있습니다. 안내를 시작한 앱이 방금 조작한 Shadowrocket인지 확인하고 시스템 안내에 따라 진행합니다. 시스템에서 기기 인증을 요청하면 인증을 마친 후 Home으로 돌아가 상태를 확인합니다. 이전에 권한 요청을 취소했다면 스위치가 꺼짐 상태로 돌아왔는지 확인하세요. 팝업이 사라졌다고 해서 권한 설정이 완료된 것은 아닙니다.

스위치를 켠 뒤 상단 상태가 계속 Not Connected로 표시되는지, 잠시 바뀌었다가 바로 돌아오는지 확인합니다. 기기에서 다른 VPN이 실행 중이라면 먼저 사용 목적을 확인합니다. 변경이 허용된 기기에서는 직접 켠 다른 연결을 끊은 후 다시 시도할 수 있습니다. 직장이나 학교에서 관리하는 기기의 VPN 구성이 제한되어 있다면 기기 관리자에게 문의하세요. 연결을 시도하기 위해 관리 구성을 제거하지 마세요.

화면에 연결됨이 표시되면 우선 서버와 모드를 그대로 유지하고 항목을 바로 바꾸지 않습니다. 시스템 연결이 설정되었다는 것은 연결 절차가 시작되었다는 뜻일 뿐, 서버에 도달할 수 있거나 규칙이 예상대로 적용된다는 뜻은 아닙니다. 다음 단계에서 서버 테스트와 실제 웹 접속을 각각 확인하면 각 상태를 구분할 수 있습니다.

Shadowrocket의 Home 화면. Not Connected, Global Routing, Connectivity Test, SERVER 그룹이 표시됩니다
Home: SERVER에서 항목을 선택한 다음 상단 연결 스위치를 조작합니다. 이미지는 연결 전 상태입니다.

단계 04 · 확인

Connectivity Test 실행 후 웹 접속 확인

Home에서 Connectivity Test를 누르고 테스트가 끝날 때까지 기다린 뒤 점 표시가 있는 서버 항목의 결과를 확인합니다. 목록의 다른 서버 결과로 현재 연결을 추정하지 마세요. 응답이 있으면 해당 항목이 이번 탐색 테스트에 응답한 것입니다. 시간 초과 또는 실패는 이번 테스트에서 예상한 결과를 얻지 못했다는 뜻입니다. 수치는 테스트 방식과 대상, 현재 네트워크에 따라 달라지며 다운로드 속도가 아니고 모든 웹사이트에 접속할 수 있다는 증거도 아닙니다.

그런 다음 브라우저를 열고 Wi-Fi 또는 셀룰러 네트워크, 서버, 모드를 바꾸지 않은 상태에서 평소 이용하는 웹 페이지 한두 개에 접속합니다. 다시 로드해야 하는 페이지를 여는 것이 좋으며, 이전에 열어 둔 페이지만 확인하지 마세요. Config에서 실제 라우팅을 확인하려면 테스트할 도메인에 어떤 정책이 적용될 것으로 예상되는지 확인해야 합니다. 웹 페이지가 로드되는지만으로 DIRECT와 PROXY 중 어떤 경로를 사용했는지 구분할 수 없습니다.

단계 05 · 문제 해결

서버, 모드, DNS 및 규칙을 순서대로 점검

문제를 점검하기 전에 실패 당시의 네트워크, 서버 항목, Global Routing 모드와 증상을 기록합니다. 목록을 가져오지 못한 것인지, 스위치가 켜진 상태를 유지하지 못하는지, 테스트가 실패하는지, 특정 웹 페이지만 열리지 않는지 구분합니다. 한 번에 조건 하나만 바꾸고 같은 웹 페이지 또는 같은 테스트로 다시 확인합니다. 개선되지 않으면 해당 설정을 원래대로 복구한 뒤 다음 항목을 점검합니다.

먼저 서버와 기본 네트워크 확인

목록이 비어 있으면 추가 단계로 돌아가 구독 링크를 빠짐없이 복사했는지, 구독 목록을 성공적으로 가져왔는지 확인합니다. 목록은 있지만 선택한 항목의 테스트가 반복해서 실패하면 Type, Host, Port와 프로토콜에 필요한 인증 정보를 확인합니다. 목록에 사용 가능한 것으로 알고 있는 다른 서버가 있다면 모드와 네트워크를 유지한 채 비교 테스트를 한 번 실행할 수 있습니다. Direct로 전환했는데 평소 열리는 웹 페이지에도 접속할 수 없다면 먼저 현재 Wi-Fi 또는 셀룰러 네트워크를 점검합니다. 예를 들어 Wi-Fi 로그인이 필요한지 확인한 뒤 프록시를 테스트합니다.

이어서 모드, DNS, 규칙 확인

Direct가 정상이면서 프록시 테스트에도 응답이 있지만 Config에서 특정 웹 페이지가 열리지 않으면 현재 어떤 구성을 선택했는지 먼저 확인합니다. 여러 도메인에서 이름 확인이 실패하면 최근 DNS 설정을 변경했는지 우선 확인합니다. 특정 도메인에만 영향을 준다면 Rule에서 예상과 다른 정책이 적용되는지 확인합니다. 예를 들어 REJECT가 먼저 일치했거나 특정 규칙과 일치하지 않아 FINAL로 이동했는지 살펴봅니다. 이러한 현상은 점검을 위한 단서이지 확정적인 결론은 아닙니다. 수정하기 전에 원래 구성을 보존하고, 웹 페이지 하나를 확인하려고 규칙 전체를 삭제하지 마세요.

마지막으로 Settings의 관련 항목 확인

테스트 결과를 비교하기 어렵다면 Settings에서 Test Method를 확인합니다. 테스트 방식을 바꾼 뒤 두 결과를 그대로 비교하지 않도록 합니다. 스위치를 끈 후 자동으로 다시 연결된다면 On Demand에서 현재 네트워크와 일치하는 조건을 사용하도록 설정했는지 확인합니다. 추가 점검이 필요하면 Diagnostics를 확인합니다. 오류를 전달할 때는 문제와 관련된 내용만 인용하고 서버 주소, 비밀번호, 구독 링크를 먼저 제거합니다. 추가 복구 방법은 자주 묻는 질문을 참조하세요.

Shadowrocket의 Settings 화면. Test Method, On Demand, Diagnostics, TCP, UDP 등의 설정 항목이 표시됩니다
Settings: 증상에 따라 Test Method, On Demand 또는 Diagnostics를 확인합니다. 모든 항목을 변경할 필요는 없습니다.
Shadowrocket 다운로드