Shadowrocket
가져오기 및 연결 안내

서버 기록은 연결에 필요한 정보를 저장하고, 구독은 여러 서버 기록을 가져오고 업데이트하는 데 사용합니다. 먼저 보유한 정보의 종류를 확인하세요. 완전한 구독 URL이 있다면 Subscribe를, 프로토콜·주소·포트·인증 정보가 있다면 Add Server에서 직접 입력합니다. 두 방법을 모두 사용할 필요는 없으며, 구독 URL을 Host에 입력해서도 안 됩니다.

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

Shadowrocket의 Home에서 SERVER 영역에 있는 Add Server를 찾아 엽니다. Type을 열고 Subscribe를 선택한 뒤 해당 URL 항목에 본인의 구독 링크를 붙여 넣습니다. 알아보기 쉬운 메모를 입력하고 저장하세요. Subscribe는 기존 구독을 가져오는 메뉴이며 앱 구매 페이지가 아닙니다. 저장 후 Home으로 돌아가 구독 요청이 완료될 때까지 기다린 다음 구독 그룹과 서버 기록이 표시되는지 확인합니다. 구독 이름만 있고 실제 서버가 없다면 가져오기 결과를 추가로 확인해야 합니다.

붙여 넣기 전에 링크가 완전한지 확인하세요. 특히 물음표 뒤의 매개변수, 대소문자, 마지막 문자를 살펴봅니다. 채팅 문구의 줄바꿈, 앞뒤 공백이나 문장 부호가 URL에 포함되지 않도록 하세요. 아래는 링크 형식만 보여주는 예시이며 연결에 사용할 수 없습니다. 본인이 보유한 주소를 사용하고, 실제 인증 정보가 포함된 링크를 공개 페이지나 문의용 스크린샷에 올리지 마세요.

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

구독 업데이트 성공 여부는 링크의 유효성, 현재 네트워크, 구독 주소의 응답에 따라 달라집니다. 업데이트에 실패하면 기존 기록을 보존하고 본인의 구독이 유효한지 확인한 뒤 새로고침을 시도하세요. 같은 URL을 반복해서 추가해도 중복 그룹만 생길 뿐 요청 실패가 해결되지는 않습니다. 구독과 규칙 설정을 함께 사용하는 경우 Config도 별도로 확인하세요. 서버 목록이 표시된다고 해서 현재 규칙까지 준비된 것은 아닙니다.

서버 정보 한 건이 있는 경우: Add Server에 입력

Add Server에서 Type을 선택한 다음 해당 프로토콜에 맞는 항목을 입력합니다. 스크린샷의 예에서는 Host가 서버 주소, Port가 포트이며 Password와 Method는 기존 정보와 일치해야 합니다. Type을 바꾸면 항목도 달라질 수 있습니다. 예를 들어 VMess와 VLESS는 인증 및 전송 매개변수가 서로 다르므로 한 프로토콜의 항목을 다른 프로토콜에 그대로 옮겨 쓰면 안 됩니다. 낯선 항목은 용어 설명에서 의미를 확인한 뒤 이 페이지로 돌아오세요.

직접 입력할 때는 주소에 불필요한 경로가 포함되지 않았는지, 포트가 완전한지, 인증 정보에 공백이 잘못 복사되지 않았는지 항목별로 확인합니다. TLS, 전송 방식, 관련 호스트 이름도 기존 정보를 기준으로 입력하세요. 양식을 채우기 위해 임의로 값을 추측하지 마세요. 정보가 부족하다면 원래 정보를 제공한 곳에 누락된 항목을 문의해야 합니다. Type만 바꾼다고 매개변수가 채워지지는 않습니다.

해당 서버의 QR 코드가 있다면 Scan QR Code로 가져온 다음 기록을 열어 항목을 확인할 수 있습니다. Import from Cloud JSON은 형식이 맞는 기존 구성에만 사용하며, 일반 구독 URL을 가져오는 범용 메뉴가 아닙니다. 저장한 뒤 Home으로 돌아가 SERVER에 해당 기록이 표시되는지 확인하세요. 여기까지는 연결 정보를 저장한 단계입니다. 다음으로 트래픽을 처리할 방식을 선택해야 합니다.

Home으로 돌아가 SERVER에서 방금 저장했거나 구독으로 가져온 서버를 선택합니다. 테스트할 서버가 선택되어 있는지 확인하세요. 구독에 여러 기록이 있다면 하나를 정해 먼저 테스트합니다. 서버, 모드, 설정을 동시에 바꾸면 어떤 변경이 결과에 영향을 줬는지 판단하기 어렵습니다. Config에서 정책 그룹을 사용한다면 실제 정책 선택도 확인하세요. Home에서 선택한 항목이 모든 규칙에 최종 적용되는 연결 경로와 항상 일치하는 것은 아닙니다.

Global Routing 표시값을 다시 확인해 앞 단계에서 선택한 모드와 일치하는지 살펴본 뒤 Home 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. 직접 시작한 작업에 대한 안내인지 확인한 뒤 허용하고, 기기에서 요구하는 방식으로 본인 인증을 완료하세요. 이 권한은 시스템 네트워크 연결을 설정하기 위한 것이며 서버 비밀번호를 가져오는 절차가 아닙니다.

권한을 허용한 뒤 Shadowrocket으로 돌아가 상단 상태가 Not Connected에서 연결 상태로 바뀌는지 확인합니다. 스위치가 바로 꺼지거나 계속 연결되지 않은 것으로 표시되면 시스템 권한을 완료했는지 먼저 확인한 다음 현재 서버 기록과 설정을 살펴보세요. 시스템 대화상자를 닫고 연결이 설정됐다고 가정하거나, 스위치가 잠시 켜졌다는 이유만으로 확인을 끝내지 마세요.

iPhone과 iPad의 조작 순서는 같지만 기기에 따라 화면 배치가 다를 수 있습니다. 시스템의 VPN 상태는 참고 자료로 활용할 수 있지만, 그것만으로 원격 서버 접속 가능 여부, 도메인 확인 또는 규칙 일치 여부를 입증할 수는 없습니다. 다음 단계에서 Connectivity Test를 실행하고 실제 페이지에도 접속해야 합니다. 기기에서 다른 VPN 연결이 이미 작동 중이라면 시스템에서 실제로 어떤 연결이 활성화되어 있는지 먼저 확인해 두 연결 작업이 서로 영향을 주지 않도록 하세요.

서버 매개변수를 수정해야 한다면 먼저 연결을 끈 뒤 편집하고, 저장 후 다시 켜서 테스트할 수 있습니다. 처음 사용하는 경우에는 On Demand 조정을 미루는 것도 좋습니다. 먼저 수동으로 한 번 연결하고 끊어 기본 동작을 확인한 뒤 자동 실행 조건을 설정하세요. 지금은 선택한 서버와 모드를 그대로 유지하고 다음 단계로 이동해 테스트와 실제 접속으로 적용 여부를 확인합니다.

먼저 어느 단계에서 실패했는지 파악한 다음 Settings에서 관련 옵션을 조정하세요. 구독에서 서버 기록을 가져오지 못한 경우, 스위치가 연결 상태를 유지하지 못하는 경우, 테스트 실패, 일부 페이지만 열리지 않는 경우는 서로 다른 문제입니다. 현상을 구분하면 Proxy, TCP, UDP 등을 연달아 바꾸는 것보다 원인을 찾기 쉽습니다. 기능을 모르는 옵션은 기존 값을 유지하세요.

가져오기 실패: URL과 입력 항목 확인

Subscribe를 저장했는데 서버 기록이 나타나지 않으면 URL이 빠짐없이 복사됐는지, 구독이 유효한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 확인합니다. 구독을 업데이트하려면 먼저 해당 주소에 요청을 보내야 하므로 목록에 있는 서버가 그 요청을 처리해 줄 것이라고 가정하지 마세요. 확인한 뒤 업데이트를 다시 시도하세요. 사용 가능한 기록이 있다면 먼저 보존해 업데이트 실패가 모든 기록의 삭제로 이어지지 않도록 합니다.

서버 정보를 직접 입력했다면 Add Server를 다시 열어 원본 정보와 Type, Host, Port, 인증 항목을 하나씩 대조한 뒤 TLS와 전송 관련 항목도 확인하세요. 비밀번호, UUID, 호스트 이름, 경로를 기억에 의존해 입력하지 마세요. QR 코드로 가져온 경우에도 결과를 확인해야 합니다. 기록을 저장할 수 있다는 것은 앱이 입력 양식을 받아들였다는 뜻일 뿐, 원격 서버 매개변수가 올바르다는 뜻은 아닙니다.

테스트 실패: 테스트 방식과 실제 연결 상태 구분

Settings에서 Test Method를 확인하고 현재 테스트 방식을 파악한 뒤 Connectivity Test를 다시 실행합니다. 특정 테스트가 실패해도 모든 연결을 사용할 수 없다고 바로 단정하지 말고 실제 페이지 접속 결과와 함께 판단하세요. 사용 가능한 Wi-Fi와 셀룰러 네트워크를 비교해 볼 수도 있습니다. 이때 서버와 모드는 그대로 유지하세요. 네트워크에 따라 결과가 달라진다면 모든 항목을 동시에 바꾸기보다 네트워크 접근성과 관련 제한을 중점적으로 확인합니다.

스위치가 바로 꺼진다면 시스템 권한과 현재 설정을 먼저 확인하세요. 연결은 유지되지만 여러 테스트가 실패한다면 기존 서버 정보가 유효한지 확인한 뒤 Diagnostics에서 관련 정보를 살펴봅니다. Diagnostics는 원인 파악을 돕는 기능이며 잘못된 매개변수를 자동으로 채워 주지는 않습니다. 정확한 오류 내용과 발생 시각을 기록한 다음 현상에 맞춰 점검하세요.

Config 문제: 규칙 순서와 정책 참조 확인

Proxy에서는 접속되지만 Config에서는 안 된다면 Config로 돌아가 현재 사용 중인 파일, Rule 순서, 정책 그룹을 확인합니다. 다른 설정 파일이 선택됐거나, 요청이 적절하지 않은 규칙과 먼저 일치했거나, 규칙이 참조하는 정책에 사용 가능한 서버가 없는 것이 원인일 수 있습니다. 복구를 위해 Rule 전체를 바로 삭제하지 마세요. 테스트 대상과 일치한 규칙을 찾아 한 항목만 수정한 뒤 다시 테스트합니다.

특정 도메인만 실패한다면 연결 기록에서 실제 대상, 확인 결과, 일치한 정책을 살펴봅니다. DNS와 규칙 문제는 비슷한 증상으로 나타날 수 있어 페이지 오류만으로는 구분하기 어렵습니다. 기존 설정을 비교용으로 보존하고 항목별로 점검하세요. 구독을 계속 바꾸는 방식으로 해결하려 하지 마세요. 규칙 키워드와 프로토콜 항목에 대한 자세한 설명은 용어 설명에서, 증상별 안내는 FAQ에서 확인할 수 있습니다.

연결 상태가 자동으로 바뀌는 경우: On Demand 확인

수동으로 연결을 끊은 뒤 다시 연결되거나 네트워크를 전환할 때 연결 동작이 달라진다면 Settings에서 On Demand 활성화 여부와 실행 조건을 확인하세요. On Demand는 조건에 따라 연결을 시작하는 기능이며 서버 자체의 접속 가능성을 대신하지 않습니다. 처음 문제를 점검할 때는 기존 조건을 기록한 뒤 관련 자동 실행 설정을 잠시 끄고 수동 스위치로 다시 확인하세요. 기본 연결이 안정된 후 필요한 조건을 복원합니다.

문제 해결 자료를 공유할 때는 구독 URL의 인증 정보, 서버 인증 정보, 개인을 식별할 수 있는 기록을 가리고 필요한 화면 문구, 오류 내용, 조작 순서만 남기세요. ‘가져오기 방식 → 현재 Global Routing → 시스템 연결 상태 → Test Method 및 결과 → 실제 접속 현상’ 순서로 정리하면 좋습니다. 공개 자료에 전체 연결 정보를 노출하지 마세요.

5단계를 마쳤다면 정상 작동하는 설정을 유지하고 필요에 따라 다른 기능을 살펴보세요. 구매, App Store 국가 또는 지역, 구입 항목 복원은 별도의 절차입니다. 자세한 내용은 정품 이용 안내에서 확인할 수 있습니다. 이 페이지의 목표는 본인의 연결 정보, 모드, 실제 접속 결과가 서로 일치하는지 확인하는 것입니다.