공식 안내 · 첫 사용

Shadowrocket 사용법
구독 가져오기와 첫 연결

가져오기, 라우팅, 연결, 확인 순서로 처음 설정합니다. 기존 서버 연결을 먼저 사용할 수 있게 한 다음 규칙과 자동 연결 조건을 조정하면 각 단계의 결과를 구분하기 쉽습니다.

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

Shadowrocket을 열고 먼저 Home 화면에 머뭅니다. 연결 스위치는 아직 켜지 마세요. 보유한 정보의 종류를 확인합니다. 구독 링크는 보통 여러 서버를 가져오고 업데이트하는 데 사용합니다. 단일 공유 링크는 서버 하나의 정보만 담고 있으며, 직접 입력하려면 프로토콜과 연결 매개변수가 모두 필요합니다. 각 정보의 용도는 다릅니다. 단일 서버 링크를 Subscribe 주소로 사용하거나 설정 파일 주소를 서버 주소 입력란에 넣지 마세요.

기존 구독 링크가 있는 경우: Subscribe 선택

Home에서 오른쪽 위의 추가 버튼을 누른 뒤 Add Server로 이동합니다. Type을 열고 Subscribe를 선택한 다음 본인의 구독 링크 전체를 URL에 붙여 넣습니다. Remarks에는 “일상 설정”처럼 알아보기 쉬운 이름을 입력할 수 있습니다. 접근 인증 정보는 메모에 적지 마세요. 링크 앞뒤에 공백이나 줄 바꿈이 들어가지 않았는지 확인한 뒤 Done을 눌러 저장합니다. Home으로 돌아가 구독을 불러올 때까지 기다립니다. 목록에 서버가 표시되지 않으면 해당 구독의 작업 메뉴에서 업데이트를 실행할 수 있습니다.

가져오기에 성공하면 Home에 구독 그룹과 서버 항목이 표시됩니다. 다음 단계로 넘어가기 전에 선택할 수 있는 서버가 있는지 확인하세요. 구독 이름만 있고 서버가 없으면 가져오기가 완료된 것이 아닙니다. 요청이 아직 처리 중이거나 응답 내용이 비어 있거나 구독 형식을 인식하지 못했을 수 있습니다. 먼저 업데이트 결과를 확인하고, 같은 이름의 구독을 반복해서 만들지 마세요. 나중에 어떤 항목을 사용하는지 구분하기 어려워질 수 있습니다.

구독을 업데이트하면 원격 콘텐츠를 다시 가져옵니다. 직접 수정한 내용을 보존해야 한다면 수정 항목을 먼저 기록한 뒤 다음 업데이트에서 덮어쓰이는지 확인하세요. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 클라이언트에서 필요한 위치에만 붙여 넣으세요. 문제를 다른 사람에게 설명할 때는 주소 전체나 주소가 보이는 화면을 보내지 마세요.

단일 서버 정보가 있는 경우: 프로토콜에 맞춰 입력

서버 주소, 포트, 인증 정보를 받았다면 Add Server에서 시작합니다. Type에서 제공된 정보에 지정된 프로토콜을 선택한 다음 항목별로 입력합니다. Shadowsocks, VMess, VLESS, Trojan 등은 프로토콜마다 입력 필드가 다릅니다. 비밀번호, 사용자 식별자, 암호화 방식, 전송 매개변수는 원본 정보에 맞게 입력해야 합니다. Address에는 서버 도메인이나 IP를 입력합니다. 구독 페이지나 브라우저에서 열어 본 설명 페이지를 입력하는 곳이 아닙니다.

TLS 또는 특정 전송 방식이 관련된 경우 서버 정보에 표시된 관련 옵션도 확인하세요. 주소와 포트만 입력하고 끝낼 수는 없습니다. QR 코드가 제공되면 Scan QR Code로 읽은 다음 인식된 Type과 Address를 확인합니다. 어느 방법을 사용하든 저장한 뒤 Home으로 돌아가 특정 서버를 선택하세요. 필드와 공유 링크의 차이는 용어집에서 확인할 수 있습니다. 처음 연결할 때는 아직 이해하지 못한 매개변수를 변경할 필요가 없습니다.

이 단계의 완료 기준은 Home에 서버 항목이 명확히 표시되고, 해당 항목을 선택할 수 있으며, 연결 정보의 출처를 알고 있는 것입니다. 여기까지는 서버의 사용 가능 여부를 확인하지 않았습니다. 다음 단계에서 트래픽 처리 방식을 먼저 정합니다.

02 · Global Routing: Config, Proxy 또는 Direct 선택

Home에서 Global Routing을 누르고 현재 목적에 따라 Config, Proxy 또는 Direct를 선택합니다. 세 모드는 트래픽 처리 방식을 바꿉니다. 누락된 서버 매개변수를 보완하거나 연결할 수 없는 서버를 사용할 수 있게 만들지는 않습니다. 처음 설정할 때 현재 선택 항목을 기억해 두면 확인 단계에서 조건을 맞춰 비교할 수 있습니다.

Config: 현재 설정의 규칙에 따라 처리

확인된 규칙 설정이 있다면 보통 Config부터 사용합니다. Config에서 현재 활성화된 설정을 확인하고 사용할 파일인지 확인하세요. 서버를 가져오는 것과 규칙 설정을 활성화하는 것은 별개의 작업입니다. Home에 서버가 표시되어도 Config에서 규칙 파일을 전환했다는 뜻은 아닙니다. 규칙은 대상 요청에 PROXY, DIRECT, REJECT 등의 정책을 적용하며, 실제 결과는 규칙 순서와 정책 설정에도 영향을 받습니다.

처음 사용할 때 규칙 전체를 바로 편집할 필요는 없습니다. 확인된 설정을 유지하고 연결 및 접속 테스트를 먼저 진행하세요. 특정 도메인의 처리 방식을 조정해야 한다면 설정을 백업한 뒤 항목별로 수정합니다. DOMAIN-SUFFIX, IP-CIDR, GEOIP 등의 키워드는 규칙 용어 설명에서 확인하세요. 규칙이 예상과 다르게 적용되는 경우의 체계적인 점검 방법은 문제 해결 안내서를 참고하세요.

Proxy: 선택한 서버의 연결 경로 비교

선택한 서버가 요청을 정상적으로 처리하는지 확인하려면 Proxy로 잠시 전환해 일반 분할 라우팅 규칙이 테스트 결과에 미치는 영향을 줄일 수 있습니다. 서버와 네트워크, 테스트 페이지는 그대로 두고 Global Routing만 변경하세요. Proxy에서는 접속되지만 Config에서는 같은 페이지가 열리지 않는다면 구독을 다시 가져오기보다 설정 규칙과 정책 경로를 먼저 확인하세요. 테스트가 끝나면 원래 사용하려던 모드로 되돌립니다.

Direct: 현재 네트워크의 직접 연결 확인

Direct는 현재 네트워크에서 직접 연결을 시도하는 모드이며, 선택한 프록시 서버가 사용 가능하다는 것을 증명하지 않습니다. 기본 네트워크가 끊겼는지 확인하려면 Shadowrocket 연결을 먼저 끈 다음 익숙한 페이지를 여는 편이 명확합니다. Wi-Fi 또는 셀룰러 네트워크가 정상 작동하는지 확인한 뒤 Home으로 돌아가 계속 진행하세요. 라우팅 모드를 정했으면 첫 연결 승인을 진행할 수 있습니다.

03 · Home: 스위치를 켜고 시스템 승인 완료

Home으로 돌아가 사용할 서버가 선택되어 있는지 다시 확인하고, Global Routing도 앞 단계에서 선택한 항목과 일치하는지 확인합니다. 그런 다음 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. 이는 시스템 네트워크 연결을 설정하는 데 필요한 승인입니다. 안내를 읽고 허용한 뒤 기기 요구 사항에 따라 암호 또는 생체 인증을 완료하고 Shadowrocket으로 돌아옵니다.

승인이 완료되면 Home의 연결 스위치가 켜진 상태로 유지되는지, 시스템에 해당 연결 상태가 표시되는지 확인합니다. 승인이 끝나기 전에 스위치를 연속해서 반복해서 누르지 마세요. 반복 조작은 연결과 해제 요청을 서로 겹치게 할 수 있으며 어느 단계에서 실패했는지 파악하기 어렵게 만듭니다. 누른 직후 스위치가 꺼진 상태로 돌아가면 시스템 안내를 취소했는지 먼저 확인한 다음 기기 관리 제한이 있는지 살펴보세요.

기기에서 네트워크 연결을 관리하는 다른 도구도 활성화되어 있다면 Shadowrocket을 단독으로 테스트하기 전에 해당 도구를 일시 중지하세요. 연결 설정 충돌을 줄이는 데 도움이 됩니다. 관리되는 업무용 또는 학교용 기기에서는 VPN 구성 변경이 제한될 수 있습니다. 이런 제한은 기기 관리 요구 사항에 따라 처리해야 하며, 설정을 반복해서 삭제해 우회하려 해서는 안 됩니다.

처음 테스트하는 동안에는 On Demand를 끈 상태로 유지해 자동 연결 조건과 수동 조작이 결과에 동시에 영향을 주지 않도록 합니다. 수동 연결과 접속 확인이 모두 정상인 뒤 네트워크 조건에 따라 On Demand를 활성화할지 검토하세요. On Demand는 연결을 시작할 시점을 정하는 기능이며, 구독 내용이나 서버 매개변수, 규칙 오류를 해결하지는 않습니다.

스위치가 켜져 있다는 것은 연결 절차가 해당 상태에 진입했다는 뜻일 뿐, 모든 대상 페이지에 접속할 수 있다는 의미는 아닙니다. 여기서 점검을 끝내지 말고 서버 테스트, 브라우저 접속, 라우팅 결과를 함께 확인하세요.

04 · Connectivity Test: 연결과 실제 접속 확인

먼저 Home에서 Connectivity Test를 사용해 기존 서버에 연결할 수 있는지 확인하고, 서버 하나를 선택해 접속 테스트를 진행합니다. 테스트 결과는 특정 요청이 응답을 받았는지 판단하는 데 도움이 됩니다. 하지만 지연 시간 수치는 다운로드 속도와 같지 않으며, 모든 앱과 페이지의 정상 작동을 보장하지도 않습니다. 숫자가 낮다는 이유만으로 전체 설정이 완료됐다고 판단하지 마세요.

같은 네트워크와 페이지로 반복 확인

현재 Wi-Fi 또는 셀룰러 네트워크를 유지한 채 브라우저를 열고, 로딩 상태를 판단할 수 있는 익숙한 페이지에 접속합니다. 먼저 페이지의 주요 콘텐츠가 표시되는지 확인한 다음 이미지나 다른 리소스가 로드되는지 살펴보세요. 일부 콘텐츠만 실패한다면 실패 범위를 기록합니다. 페이지 전체가 열리지 않을 때와 점검 방향이 다릅니다. 이전 페이지가 캐시된 내용을 표시할 수 있으므로 이미 열려 있는 탭만 보지 말고 테스트할 때 페이지를 새로고침하세요.

그런 다음 클라이언트로 돌아가 연결 기록에서 요청 대상과 해당 정책을 확인합니다. Config를 사용한다면 대상 요청이 예상대로 PROXY 또는 DIRECT를 따르는지, REJECT되지는 않았는지, 정책이 현재 사용 가능한 서버를 가리키는지 살펴보세요. 시스템에 연결 표시가 나타나거나 브라우저에서 특정 페이지 하나가 열리는 것만으로 모든 규칙이 올바르다고 판단할 수는 없습니다.

조건 하나만 바꾸고 결과 비교

서버 테스트는 응답하지만 실제 페이지가 열리지 않는다면 서버는 그대로 둔 채 Global Routing을 Config에서 Proxy로 잠시 바꾸고 같은 페이지에 다시 접속합니다. 모드에 따라 결과가 달라지면 규칙과 현재 Config를 먼저 확인하세요. 두 모드에서 모두 실패한다면 서버 매개변수와 네트워크 조건, DNS를 점검합니다. 한 번에 한 항목만 바꿔야 변경 사항과 결과를 연결해 판단할 수 있습니다.

확인을 마치면 장기적으로 사용할 모드로 되돌린 뒤 다시 테스트합니다. “네트워크 종류, 선택한 서버, Global Routing, 실패한 페이지, 표시된 오류”를 간단히 기록하는 것이 좋습니다. 인증 정보는 기록하거나 공개하지 마세요. 이런 기록은 “스위치가 켜졌는데 작동하지 않음”이라는 설명보다 다음 단계의 원인을 찾는 데 도움이 되며, 나중에 수정 효과를 확인하기도 쉽습니다.

05 · 자주 발생하는 문제: 실패 지점부터 확인

문제가 발생하면 먼저 연결을 끄고 기기 자체가 네트워크에 접속할 수 있는지 확인합니다. 그런 다음 가져오기, 승인, 서버 연결, 규칙 처리 순서로 점검하세요. 서버를 모두 삭제하거나 Config를 교체하고 DNS까지 한꺼번에 수정하지 마세요. 잠시 정상으로 돌아오더라도 어떤 항목이 원인이었는지 알기 어렵습니다. 아래에는 첫 사용에서 자주 발생하는 점검 경로만 정리했습니다. 세부 항목은 Shadowrocket 문제 해결 안내서에서 확인할 수 있습니다.

Subscribe 저장 후 서버가 표시되지 않음

구독 항목으로 돌아가 URL 전체가 올바른지, 설명 문구나 공백, 줄 바꿈이 함께 복사되지 않았는지 확인합니다. 계정 페이지나 단일 서버 공유 링크가 아니라 구독 주소인지 확인하세요. 기본 네트워크가 정상인 상태에서 다시 업데이트하고 구체적인 오류를 살펴봅니다. 주소가 만료되었거나 접근 인증 정보가 변경되었거나 응답 내용에 문제가 있다면 본인의 서비스 제공업체에 확인하세요. 추측으로 링크의 문자를 수정하지 마세요.

스위치가 켜지지 않거나 켜진 직후 꺼짐

처음 표시된 시스템 승인 요청을 허용했고 기기 인증을 완료했는지 확인합니다. 그런 다음 다른 네트워크 연결 도구가 사용 중인지, 기기 관리 정책의 제한을 받는지 확인하고 클라이언트에 표시된 안내를 기록합니다. 최근 시스템 네트워크 설정을 변경했다면 먼저 변경 사항을 파악할 수 있는 상태로 되돌린 다음 테스트하세요. 시스템 연결 구성을 삭제하면 다시 승인을 받아야 합니다. 원인을 확인한 뒤 진행하고, 매번 문제 해결의 첫 단계로 삼지는 마세요.

Connectivity Test 시간 초과

현재 서버에서 한 번 더 테스트한 다음 본인이 보유한 목록에서 다른 서버를 선택해 비교합니다. 한 서버만 계속 실패하면 주소, 포트, 인증 정보, 프로토콜 매개변수를 먼저 확인합니다. 여러 서버가 모두 실패하면 Wi-Fi와 셀룰러 네트워크를 비교하고 기본 네트워크를 점검하세요. 네트워크를 전환할 때 다른 조건은 그대로 유지합니다. TLS 검증을 끄는 것으로 매개변수 확인을 대신하지 말고, 시간 초과를 앱 설치 실패로 단정하지 마세요.

Proxy에서는 접속되지만 Config에서 일부 페이지가 실패

Config로 돌아가 현재 활성화된 파일을 확인하고 실패한 대상에 적용되는 규칙과 정책을 점검합니다. 규칙을 수정하기 전에 먼저 백업하고, 변경한 뒤 저장한 다음 같은 페이지를 다시 불러옵니다. 특정 정책에서 서버 선택이 필요한 경우 이미 사용할 수 없는 항목을 가리키고 있지 않은지 확인하세요. 규칙은 설정된 로직에 따라 대상을 처리합니다. 실제로 어떤 규칙이 적용됐는지 확인해야 라우팅 선택 오류와 서버 자체의 문제를 구분할 수 있습니다.

연결은 정상이지만 도메인 이름 확인 오류 발생

먼저 기기의 날짜와 시간이 올바른지 확인한 다음 오류가 도메인 이름 확인 단계에 집중되는지 살펴봅니다. 현재 DNS 설정을 기록하고 한 번에 한 항목만 조정하세요. 확인 방식과 규칙 파일을 동시에 바꾸지 마세요. IP 주소로 웹사이트를 직접 여는 것은 적절한 비교 방법이 아닐 수 있습니다. HTTPS 연결에는 도메인 이름과 인증서의 일치 여부도 관련되기 때문입니다. 오류가 계속되면 출처가 불분명한 주소를 계속 바꾸어 입력하지 말고 구체적인 오류 메시지를 가지고 문제 해결 안내서의 DNS 관련 항목을 확인하세요.

iPad에서 같은 위치를 찾을 수 없음

iPad는 방향과 창 너비에 따라 분할 화면 레이아웃을 사용할 수 있어 Home, Config 등의 항목 위치가 달라집니다. 하지만 조작 대상은 화면에 표시된 이름을 기준으로 찾을 수 있습니다. 먼저 같은 이름의 페이지를 찾아 해당 단계를 진행하세요. 브라우저 기록, 시스템 승인, 기기 네트워크 설정은 현재 사용하는 iPad에서 다시 확인해야 합니다. 다른 기기에서 성공한 결과만으로 이 기기의 설정까지 완료됐다고 판단할 수 없습니다.