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

STEP 01 · 서버 정보 가져오기

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

먼저 보유한 정보가 서버 목록 업데이트용 구독 링크인지, 단일 서버의 주소·포트·인증 정보인지 확인하세요. 두 종류의 정보를 앱에 추가하는 방법은 서로 다르며 둘 다 진행할 필요는 없습니다. Shadowrocket을 열고 Home으로 이동한 뒤 오른쪽 위의 추가 버튼을 눌러 Add Server로 들어갑니다. 저장한 후에는 편집 화면에서 바로 연결을 시도하지 말고 Home으로 돌아가 결과를 확인하세요.

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

Add Server에서 Type을 열고 Subscribe를 선택한 다음 기존 구독 링크 전체를 URL에 입력합니다. 메모에는 ‘개인 구독’처럼 알아보기 쉬운 이름을 사용할 수 있습니다. 비밀번호나 링크에 포함된 인증 정보는 메모에 적지 마세요. 확인 후 저장하고 구독을 읽어올 때까지 기다립니다. 성공하면 Home 목록에 해당 구독의 서버 항목이 표시됩니다. 구독 이름만 있고 선택할 서버가 없다면 먼저 업데이트 결과를 확인하세요.

링크를 복사할 때는 특히 앞뒤와 중간의 매개변수를 확인하세요. 채팅 메시지의 설명, 줄바꿈, 공백, 문장 끝의 문장 부호는 링크에 포함되지 않으므로 함께 입력하면 안 됩니다. 아래 내용은 입력란 형식을 설명하기 위한 예시일 뿐 실제 구독으로 사용할 수 없으며 열 필요도 없습니다.

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

가져오기에 성공했다면 목록이 바로 새로 고침되지 않더라도 같은 구독을 여러 개 만들지 말고 기존 항목을 유지하세요. 서버 목록을 다시 불러오려면 기존 구독을 업데이트하면 됩니다. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 비밀번호처럼 보관하세요. 문제 화면을 다른 사람에게 보낼 때는 전체 URL과 매개변수를 가리세요. 업데이트와 여러 구독 관리 방법은 구독 매뉴얼의 업데이트 전략을 참고하세요.

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

서버 정보를 받았다면 Add Server의 Type에서 정보에 명시된 프로토콜을 선택합니다. 예를 들어 Shadowsocks, VMess, VLESS 또는 Trojan을 선택한 뒤 주소, 포트 및 해당 프로토콜에 필요한 인증 정보를 입력합니다. 프로토콜마다 입력 항목이 다르므로 한 프로토콜의 비밀번호, UUID 또는 전송 매개변수를 다른 프로토콜에 임의로 적용하면 안 됩니다. 입력 순서는 제공받은 정보와 현재 양식에 따르세요.

저장하기 전에 주소에 불필요한 공백이 들어갔는지, 포트가 빠짐없이 입력되었는지, 인증 정보의 문자가 누락되지 않았는지 항목별로 확인하세요. 자료에 TLS, 전송 방식 또는 서버 이름이 명시되어 있다면 해당 값도 그대로 입력해야 합니다. 양식을 단순하게 보이게 하려고 매개변수를 삭제하지 마세요. 항목이 확실하지 않다면 여러 조합을 시도하는 대신 서비스 제공업체에 문의하세요. 양식이 저장된다는 것은 입력을 받아들였다는 뜻일 뿐, 원격 서버에 연결할 수 있음을 보장하지 않습니다.

QR 코드와 클립보드 정보: 내용 유형 확인

가져오기용 QR 코드가 있다면 Scan QR Code를 사용하고 시스템 안내에 따라 필요한 카메라 권한을 허용하세요. QR 코드에는 단일 서버 공유 링크나 구독 주소가 포함될 수 있습니다. 인식 후 유형, 메모, 주소가 보유한 정보와 일치하는지 확인하고 저장하세요. 클립보드에서 가져올 때도 복사한 내용이 전체 공유 정보인지 확인하세요. 웹 페이지 제목이나 일반 설명을 복사한 것이어서는 안 됩니다. 정리 방법은 QR 코드 스캔 및 가져오기 안내를 참고하세요.

한 가지 방법으로 추가를 마쳤다면 Home으로 돌아가 방금 추가한 서버를 찾아 선택하세요. 이때 다른 설정을 연이어 변경하지 마세요. 다음 단계에서는 요청을 어떤 방식으로 처리할지 정합니다. 구독은 서버 목록을 제공하고 규칙 구성은 트래픽 경로를 결정합니다. 구독을 성공적으로 가져왔다고 해서 적합한 규칙 구성까지 가져오거나 활성화한 것은 아닙니다.

STEP 03 · 시스템 연결 설정

Home: 연결 스위치 켜기 및 VPN 구성 승인

Home으로 돌아와 서버가 선택되어 있고 Global Routing이 이번 확인 목적에 맞는지 살펴본 다음 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성 추가를 요청할 수 있습니다. 이는 앱이 시스템 네트워크 기능을 통해 트래픽을 처리하도록 허용하는 절차이며, 서버를 다시 가져오는 것이 아닙니다. 안내가 현재 작업으로 인해 표시된 것인지 확인한 뒤 시스템 화면에서 허용을 선택하고 기기의 암호 또는 생체 인증을 완료하세요.

승인이 완료되면 Shadowrocket으로 돌아가 연결 스위치가 켜진 상태로 유지되는지 확인하세요. 시스템 확인을 마치지 않았다면 앱이 여전히 연결되지 않았을 수 있습니다. 권한 안내를 먼저 처리한 뒤 한 번 더 시도하세요. 스위치가 곧바로 꺼진다면 빠르게 여러 번 누르거나 정보를 반복해서 추가하지 마세요. 처리되지 않은 시스템 창이 있는지, 기기에서 현재 VPN 연결을 허용하는지 확인하세요.

VPN 구성과 규칙 구성 구분하기

시스템의 VPN 구성 기록은 앱과 시스템 네트워크 기능을 연결하는 데 사용되고, 앱의 Config 파일은 규칙, DNS 등의 처리 설정에 사용됩니다. 둘 다 ‘구성’이라고 불릴 수 있지만 용도는 다릅니다. 시스템 VPN 구성을 삭제해도 잘못 작성된 규칙은 수정되지 않으며, Config 파일을 바꿔도 시스템 승인을 대신할 수 없습니다. 문제의 유형을 정확히 파악한 뒤 해당 조치를 고려하세요.

이전에 승인을 거부했다면 연결을 다시 시도하고 시스템 안내를 확인하세요. 기기가 관리 정책의 제한을 받거나 시스템에서 VPN 구성을 추가할 수 없다고 표시되면 먼저 기기 관리 요구 사항을 확인하세요. 이를 구독 문제로 오해하지 마세요. 시스템 기록을 확인하려면 시스템 설정에서 VPN을 검색하고 Shadowrocket에 해당하는 항목을 찾으세요. 변경하기 전에 대상을 확인해 사용 중인 다른 네트워크 설정에 영향을 주지 않도록 주의하세요.

승인을 마치고 스위치가 켜진 상태로 유지되더라도 연결 절차가 시작되었거나 시스템 연결 상태가 설정되었다는 의미일 뿐, 모든 웹 사이트에 접속할 수 있다는 뜻은 아닙니다. 시스템 상태 표시만으로 앱 수준의 연결을 확인할 수도 없습니다. 다음 단계에서는 서버와 모드를 그대로 유지하고 실제 웹 요청을 확인하세요. 그래야 결과를 비교하기 쉽습니다.

STEP 05 · 실패 지점 하나씩 해결

Shadowrocket 연결 안 됨: 증상별 문제 해결

저장 실패, 업데이트 실패, 서버 테스트 실패, 연결 스위치가 꺼짐, 연결 후 웹 페이지가 열리지 않음 중 어느 단계에서 문제가 발생했는지 먼저 기록하세요. 기존에 작동하던 구성은 유지하고 한 번에 변수 하나만 변경한 뒤 같은 페이지에서 다시 확인합니다. 처음부터 모든 서버를 삭제하거나 Config를 비우거나 네트워크 설정을 초기화하지 마세요. 문제를 파악하는 데 필요한 정보까지 함께 사라질 수 있습니다.

구독 업데이트 실패 또는 서버 목록이 비어 있음

먼저 기기의 기본 네트워크로 일반 웹 페이지에 접속할 수 있는지 확인한 다음 Subscribe의 URL이 완전한지 살펴보세요. 링크 매개변수가 누락되었거나 복사할 때 줄바꿈과 문장 부호가 섞였다면 서비스 제공업체에서 전체 링크를 다시 받아 교체하세요. 정보가 변경되었다면 복사본을 여러 개 추가하지 말고 기존 구독을 업데이트하세요. 그래도 실패하면 앱에 실제로 표시된 오류 내용을 기록하고 서비스 제공업체에 링크의 유효성과 가져오기에 적합한 응답인지 확인하세요.

구독 업데이트 실패와 기존 서버의 연결 가능 여부는 따로 확인해야 합니다. 목록은 남아 있어도 구독을 일시적으로 읽어오지 못할 수 있고, 업데이트가 성공해도 특정 서버는 사용할 수 없을 수 있습니다. 먼저 현재 목록과 선택된 항목을 확인하세요. 업데이트가 된다는 사실만으로 모든 서버를 사용할 수 있다고 판단하지 마세요. 업데이트 후 항목 변경과 여러 구독 관리 방법은 구독 업데이트 안내를 참고하세요.

Connectivity Test 실패

서버를 직접 추가했다면 Add Server 편집 화면으로 돌아가 보유한 정보와 프로토콜, 주소, 포트, 인증 항목을 대조한 뒤 TLS와 전송 매개변수를 확인하세요. 구독에서 가져온 항목이라면 한 번 업데이트하고 테스트 대상 서버가 여전히 목록에 있는지 확인합니다. 한 항목만 실패한다면 이미 보유한 다른 항목과 비교해 볼 수 있습니다. 모두 실패한다면 먼저 현재 네트워크 상태와 공통으로 사용하는 구성 조건을 확인하세요. 추측한 비밀번호나 포트를 반복해서 시도하지 마세요.

연결 스위치가 켜진 상태로 유지되지 않음

VPN 구성을 추가하도록 시스템에서 승인했는지, 처리하지 않은 안내가 남아 있는지 확인하세요. 시스템에 명확한 오류가 표시되면 서버를 테스트하기 전에 해당 오류부터 해결해야 합니다. 기기의 네트워크를 전환한 뒤 문제가 생겼다면 연결을 끄고 기본 네트워크가 복구될 때까지 기다린 다음 다시 켜 보세요. 매 단계마다 결과를 확인한 뒤 다음 조치를 진행합니다. 관리 기기의 제한은 기기 관리 요구 사항에 따라 처리해야 하며 서버 정보를 바꾸는 것으로 시스템 권한 문제를 해결할 수는 없습니다.

테스트는 응답하지만 웹 페이지가 열리지 않음

먼저 모든 페이지에서 문제가 발생하는지, 특정 도메인이나 앱에서만 발생하는지 확인하세요. 서버는 그대로 둔 채 Config에서 Proxy로 잠시 전환해 비교합니다. Proxy에서는 정상이고 Config에서 문제가 생기면 현재 구성의 규칙과 DNS를 우선 확인하세요. 두 모드 모두 문제가 있다면 서버 매개변수, 원격 서버 상태, 현재 네트워크를 다시 살펴보세요. 비교가 끝나면 원래 필요한 모드로 되돌리고 임시 테스트 상태를 최종 설정으로 사용하지 마세요.

DNS는 도메인 이름을 주소로 변환합니다. 서버 테스트에서 응답을 받았다고 해서 페이지에 필요한 모든 도메인이 올바르게 해석되는 것은 아닙니다. 먼저 현재 Config의 DNS 설정이 직접 확인한 구성에서 가져온 것인지 살펴보고 여러 해석 옵션을 동시에 변경하지 마세요. 단계별 확인 방법은 웹 페이지는 열리지 않지만 지연 시간은 정상일 때 DNS 문제 해결 안내를 참고하세요.

문제를 문의하기 전에 필요한 정보만 정리

기기 종류, 현재 네트워크, Global Routing 선택, 실패 단계와 오류 문구를 기록하고 특정 대상에서만 문제가 발생하는지도 적어 두세요. 전체 구독 링크, 비밀번호, UUID 또는 기타 인증 정보를 보내지 마세요. 로그와 스크린샷도 민감한 항목을 확인해 가린 뒤 공유하세요. “Proxy에서는 접속되지만 Config로 돌아오면 특정 도메인에 접속할 수 없음”처럼 설명하면 단순히 “연결 안 됨”이라고 하는 것보다 원인을 파악하기 쉽습니다.

앞 단계의 조작을 다시 확인하려면 추가 및 가져오기, Global Routing 선택 또는 연결 승인으로 돌아가 통과하지 못한 첫 단계부터 다시 진행하세요.