공식 매뉴얼 · 시작 가이드

Shadowrocket 사용법

iPhone·iPad 화면을 기준으로 가져오기, 라우팅 방식 선택, 연결 및 확인 과정을 안내합니다. 처음 사용할 때는 수동 연결을 먼저 완료한 다음 자동화 설정을 조정하세요.

아래 순서대로 진행하면 ‘정보를 제대로 가져왔는지’, ‘서버에 연결할 수 있는지’, ‘요청이 규칙에 따라 처리되는지’를 나누어 확인할 수 있습니다. 처음부터 DNS, 규칙, On Demand를 한꺼번에 바꾸지 마세요. 정상화되더라도 어떤 설정이 영향을 줬는지 파악하기 어렵습니다. 화면에 표시되는 프로토콜 유형과 매개변수는 본인이 가진 정보에 맞춰 입력하세요. 프로토콜마다 입력란이 다르므로 예시와 똑같이 채울 필요는 없습니다.

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

Shadowrocket을 열고 Home으로 이동합니다. 먼저 보유한 정보가 ‘구독 URL’인지 ‘개별 서버 매개변수’인지 확인하세요. 전자는 일반적으로 여러 서버 정보를 가져오고 업데이트하는 데 쓰이며, 후자는 주소, 포트, 프로토콜, 인증 정보가 구체적으로 정해져 있습니다. 입력 방법이 서로 다르므로 구독 URL을 서버 주소로 입력하거나, 개별 서버 공유 정보를 구독 업데이트 URL로 사용하지 마세요.

구독 URL이 있는 경우: Subscribe 선택

Home 오른쪽 위의 추가 버튼을 눌러 Add Server로 이동한 다음 Type을 열고 Subscribe를 선택합니다. URL에 본인의 전체 구독 URL을 붙여 넣고, 필요한 경우 알아보기 쉬운 메모를 입력한 뒤 저장하세요. 붙여 넣기 전후에 URL이 메신저에서 잘리지 않았는지, 앞뒤에 공백이 붙지 않았는지, 쿼리 매개변수가 온전히 포함됐는지 확인하세요. 구독 URL에는 접근 정보가 들어 있을 수 있으므로 공개 댓글이나 누구나 볼 수 있는 메모에 올리지 마세요.

저장한 뒤 Home으로 돌아가 구독 정보가 로드될 때까지 기다린 다음 구독 그룹 아래에 서버 항목이 표시되는지 확인하세요. 그룹 이름만 보이고 항목이 없다면 먼저 로딩 중인지 확인한 뒤 해당 구독을 업데이트하세요. 업데이트 오류가 나면 오류 메시지를 보관하고, 기기의 현재 네트워크에서 구독 URL에 접속할 수 있는지 확인하세요. 같은 URL을 반복해서 삭제하고 다시 추가해도 URL이 만료됐거나 응답을 해석할 수 없는 문제는 대개 해결되지 않습니다.

개별 서버 정보가 있는 경우: 실제 Type에 맞춰 입력

수동 설정 정보를 받았다면 Add Server에서 정보와 일치하는 Type을 선택한 뒤 Address, Port, 해당 프로토콜에 필요한 인증 항목을 차례로 입력하세요. Shadowsocks, VMess, VLESS, Trojan 등은 필요한 매개변수가 서로 다르므로 포트나 이름만 보고 추측해서는 안 됩니다. TLS, 서버 이름 또는 전송 매개변수가 있다면 원래 정보와 동일하게 입력하세요. Address와 TLS에 사용하는 이름은 서로 다를 수 있습니다.

저장한 뒤 Home으로 돌아가 사용할 서버를 누르고 선택 표시가 원하는 항목에 있는지 확인하세요. 가져오기에 성공했다는 것은 앱이 정보를 읽었다는 뜻일 뿐, 원격 서비스가 반드시 작동한다는 의미는 아닙니다. 이 단계에서는 복잡한 매개변수를 조정하지 말고 다음 단계에서 Global Routing을 선택하세요. 프로토콜 항목의 의미를 모르겠다면 프로토콜 참고 자료를 확인하고, 프로토콜 유형을 바꿔가며 시험하지 마세요.

02 · Global Routing: 처리 방식 선택

Home에서 Global Routing을 엽니다. 여기서는 연결 처리 방식을 정하며 서버 주소나 비밀번호를 바꾸지는 않습니다. 세 가지 방식은 Config, Proxy, Direct입니다. 각 방식의 용도를 파악한 다음 현재 테스트 목적에 맞는 항목을 선택하세요. 연결 스위치가 켜졌다고 해서 모든 요청이 프록시를 거치는 것은 아닙니다.

Config: 현재 구성의 규칙에 따라 처리

기존 규칙 기반 구성을 일상적으로 사용한다면 Config를 선택하세요. 그런 다음 Config로 이동해 목록에 파일을 추가했는지만 보지 말고 실제로 원하는 파일이 적용 중인지 확인합니다. 구성의 규칙은 일반적으로 위에서부터 일치 여부를 확인하며, 규칙에 지정된 정책으로 처리됩니다. 대상의 규칙이 DIRECT라면 직접 연결되는 것이 정상입니다. 규칙에 PROXY가 지정되어 있으면 해당 정책에서 올바른 서버가 선택되었는지도 확인하세요.

아래는 규칙 순서 예시일 뿐, 현재 구성을 바로 교체하라는 뜻은 아닙니다. 첫 번째 규칙은 예시 도메인에 PROXY를 적용하고, 두 번째 규칙은 지정된 사설 주소 대역에 DIRECT를 적용하며, FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. 모든 서비스에 이 구성이 적합한 것은 아니므로 처음에는 현재 사용 중인 파일을 이해하는 데 집중하세요.

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

Proxy 및 Direct: 명확한 목적이나 비교 테스트에 사용

Proxy는 앱의 처리 범위에 들어오는 요청을 프록시 경로로 보냅니다. 라우팅 규칙이 문제의 원인인지 임시로 확인할 때 사용할 수 있지만, 잘못된 서버 매개변수를 수정해 주지는 않으며 기기의 모든 시스템 트래픽이 반드시 같은 경로를 이용하는 것도 아닙니다. Direct는 직접 연결 방식으로, 기본 네트워크에서 대상의 상태를 확인할 때 적합합니다. 시스템의 VPN 구성을 자동으로 끊지는 않습니다.

처음 설정할 때는 Config를 선택하면 됩니다. 나중에 특정 대상에서만 문제가 발생한다면 일시적으로 방식을 바꿔 비교한 다음 원래 선택으로 되돌리세요. 전환 전 상태를 기록해 두는 것이 중요합니다. 그렇지 않으면 문제 해결 후 일상적인 사용 목적과 맞지 않는 설정이 남을 수 있습니다. 현재 파일이나 규칙 순서가 여전히 헷갈린다면 자주 묻는 질문의 라우팅 안내를 먼저 확인하세요. 처음부터 전체 구성을 다시 작성할 필요는 없습니다.

03 · Home: 연결 스위치를 켜고 권한 승인

Home으로 돌아가 선택된 서버와 Global Routing을 다시 확인합니다. 준비가 되면 화면의 연결 스위치를 켜세요. 처음 활성화할 때 시스템에서 VPN 구성 추가 권한을 요청합니다. 안내를 읽고 허용한 다음 시스템 요구에 따라 기기 인증을 완료하세요. 여기서 승인하는 것은 시스템 네트워크 구성입니다. 서버 비밀번호를 입력하는 것이 아니며, 서버 인증 정보는 앞서 Add Server에서 입력해야 합니다.

시스템 안내를 완료한 뒤 Shadowrocket으로 돌아와 스위치가 계속 켜져 있는지, 연결 오류가 표시되는지 확인하세요. 스위치가 곧바로 꺼진다면 안내 문구를 먼저 기록하고 빠르게 여러 번 누르지 마세요. 시스템 Settings에서 VPN 구성이 생성되었는지 확인할 수 있습니다. 기기가 조직의 관리 대상이거나 시스템 제한이 있거나 다른 VPN 연결이 사용 중이면 동작이 다를 수 있으므로, 현재 기기에서 해당 구성을 추가하고 활성화할 수 있는지 먼저 확인하세요.

첫 테스트에서는 On Demand를 잠시 꺼두고 반복 가능한 수동 연결을 먼저 확인하는 것이 좋습니다. On Demand는 조건에 따라 연결을 시작할 수 있으므로 수동 테스트 중 연결이 다시 켜져 ‘껐는데도 자동으로 연결된다’고 오해할 수 있습니다. 수동 연결이 정상임을 확인한 뒤 필요에 따라 조건을 별도로 설정하세요. 서버 자체가 연결되지 않는 문제를 자동 연결 조건 추가로 해결하려 하지 마세요.

연결이 계속 유지되면 스위치를 반복해서 켜고 끌 필요는 없습니다. 시스템에 VPN 상태가 표시되는 것은 관련 네트워크 구성이 연결 상태라는 뜻일 뿐, 구독에 포함된 모든 서버나 모든 대상 웹사이트가 작동한다는 증거는 아닙니다. 설정이 제대로 됐는지 판단하려면 서버 연결 상태와 실제 접속 결과를 모두 확인해야 합니다.

04 · Connectivity Test: 연결 확인

Home에서 Connectivity Test를 사용해 서버 연결 상태를 확인합니다. 테스트 전에 현재 선택된 테스트 방식을 확인하고, 같은 네트워크에서 같은 서버를 반복해 확인하세요. 테스트 방식마다 확인하는 범위가 다릅니다. 결과가 표시되어도 대상 서비스의 모든 요청이 정상 처리된다는 보장은 없으며, 특정 탐지 요청이 시간 초과됐다고 해서 모든 접속이 실패했다고 단정할 수도 없습니다.

그런 다음 브라우저를 열고 접근 권한이 있으며 평소 정상적으로 열리는지 아는 서비스를 방문하세요. 이미 로드된 페이지를 보는 데 그치지 말고 새로고침한 뒤 새로운 요청이 완료될 때까지 기다리세요. 먼저 일반 페이지를 테스트한 다음 로그인 후 페이지나 파일 요청 등 실제로 필요한 기능을 시도하세요. 페이지 본문은 표시되지만 이미지, 로그인 또는 다른 기능이 실패한다면 각 기능이 서로 다른 도메인에 접속했을 수 있으므로 따로 확인해야 합니다.

Config를 사용 중이라면 현재 구성에서 대상에 적용되어야 할 규칙과 정책을 확인하세요. 대상 하나는 DIRECT, 다른 대상은 PROXY로 처리되는 것이 정상적인 라우팅 결과일 수 있습니다. 필요한 경우 앱의 연결 기록에서 대상 도메인에 해당하는 요청을 찾아 일치한 규칙과 처리 정책을 확인하세요. 접속 IP가 바뀌지 않았다는 이유만으로 모든 규칙이 적용되지 않았다고 판단하지 마세요.

비교가 필요하다면 한 번에 한 가지만 바꾸세요. 같은 대상과 같은 서버를 유지하고 Proxy로 잠시 전환해 다시 시도한 다음 Config로 복원합니다. Proxy에서는 정상이고 Config에서는 문제가 생긴다면 현재 구성과 정책 선택을 먼저 확인하세요. 두 방식 모두 문제가 있으면 서버와 기본 네트워크를 점검하세요. Direct 비교 결과도 기록해 두면 대상 자체의 문제와 프록시 경로 문제를 구분하는 데 도움이 됩니다.

Data의 트래픽 수치는 데이터 활동 여부를 파악하는 데 참고가 될 수 있습니다. 하지만 통계 범위, 앱 캐시, 백그라운드 요청이 수치에 영향을 주므로 특정 순간의 숫자 하나만으로 판단하지 마세요. 한 번 정상적으로 확인했다면 사용 가능한 서버, 처리 방식, 네트워크 환경만 기록하면 됩니다. 더 낮은 테스트 수치를 얻으려고 설정을 계속 바꿀 필요는 없습니다.

05 · 흔한 실패 원인: 기본 네트워크부터 단계별 점검

문제가 발생하면 먼저 실패한 단계가 구독을 읽지 못한 것인지, 서버 테스트가 연결되지 않은 것인지, 스위치가 켜진 상태를 유지하지 못하는 것인지, 특정 대상에만 접속할 수 없는 것인지 확인하세요. 원인을 분류한 뒤 조치하는 편이 구독 업데이트, DNS 변경, 규칙 수정을 한꺼번에 하는 것보다 정확한 진단에 도움이 됩니다. 아래 순서대로 영향 범위가 넓은 항목부터 확인하세요.

먼저 기기 자체의 인터넷 연결 확인

연결 스위치를 잠시 끄고 On Demand가 켜져 있다면 함께 일시 중지한 다음 Wi-Fi 또는 셀룰러 네트워크가 정상인지 확인하세요. 공용 Wi-Fi는 먼저 로그인 절차를 완료해야 할 수 있습니다. 기본 네트워크가 연결되지 않으면 구독을 읽거나 서버를 테스트하는 작업도 실패할 수 있습니다. 다른 네트워크를 사용할 수 있다면 같은 테스트를 다시 해보세요. 네트워크를 바꾸면서 서버 매개변수까지 함께 수정하면 결과를 비교할 수 없습니다.

구독 업데이트 실패와 서버 연결 실패 구분

구독 업데이트에 실패하면 URL이 온전한지, 유효 기간이 남아 있는지, 응답 내용이 정상인지 확인하세요. 필요하다면 본인이 이용 중인 서비스 제공업체에 원본 정보를 확인합니다. 구독은 업데이트되지만 서버에 연결되지 않는다면 선택된 서버 항목을 확인하고 Address, Port, 인증 정보, TLS 및 전송 항목을 점검하세요. 업데이트 후 서버 목록이 달라질 수 있으므로 현재 선택된 항목을 다시 확인하세요. 그룹 이름이 같다는 이유만으로 선택이 바뀌지 않았다고 생각해서는 안 됩니다.

특정 서버 하나만 계속 시간 초과되고 다른 기존 서버는 정상이라면 문제 범위가 좁혀진 것이므로 앱 전체를 초기화할 필요는 없습니다. 모든 항목이 실패한다면 현재 네트워크, 기기 시간, 시스템 권한을 다시 확인하세요. 테스트 결과는 원인을 찾는 데 도움이 되지만 실제 매개변수와 원격 서비스 상태를 확인하는 일을 대신하지는 않습니다.

스위치 문제와 일부 대상 접속 문제를 따로 점검

스위치를 켠 직후 꺼진다면 시스템 권한을 승인했는지, VPN 구성을 활성화할 수 있는지, 다른 네트워크 구성과 충돌하는지 먼저 확인하세요. 스위치는 켜져 있지만 일부 대상에서만 문제가 생긴다면 Global Routing, 현재 Config 파일, 규칙 순서, 관련 정책을 우선 점검합니다. 모든 구성을 삭제하는 것을 첫 번째 조치로 삼지 마세요. 수정 전에 원본 파일을 보관해 복원할 수 있도록 하세요.

오류 메시지가 도메인 이름 확인이나 인증서와 관련되어 있다면 DNS 설정과 시스템 시간을 확인하세요. 기기 날짜가 크게 틀리면 TLS 검증에 영향을 줄 수 있습니다. 인증서 오류가 발생했다고 검증을 바로 꺼서 문제를 숨기지 마세요. 시간을 정확하게 맞추고 서버 이름 등 관련 항목을 확인한 뒤 다시 테스트하세요. 매개변수에 대한 자세한 설명은 프로토콜 참고 자료를, 일반적인 연결 문제는 연결 문제 해결 FAQ를 확인하세요.

기존 서버로 대상 서비스에 정상 접속할 수 있고, Config의 라우팅이 예상대로 작동하며, 연결을 끊은 뒤 기본 네트워크가 복구되면 시작 단계가 완료된 것입니다. 이후 실제 필요에 따라 On Demand를 설정하거나 여러 구성을 정리하세요. 이런 작업은 수동 연결이 정상임을 확인한 뒤 진행하면 됩니다. 처음 사용할 때 모두 설정할 필요는 없습니다.