공식 안내서 · 시작하기

Shadowrocket
구독 가져오기 및 연결 가이드

먼저 기존 서버를 Home에 저장하고 Global Routing을 선택한 다음, 연결을 켜 실제 요청을 확인합니다. 이 가이드는 반복해서 점검할 수 있는 연결을 한 번 설정하는 것을 목표로 하며, 전체 구성 파일을 미리 익힐 필요는 없습니다.

완료한 단계는 건너뛰어도 됩니다. 문제가 발생하면 마지막으로 정상 동작을 확인한 단계부터 다시 점검하세요. 시스템 버전에 따라 메뉴 위치가 다를 수 있으므로 현재 화면의 영문 이름을 기준으로 기능을 찾으세요.

STEP 01 · Home / Add Server / Subscribe

서버 추가 또는 기존 구독 가져오기

Shadowrocket을 열고 Home 화면으로 이동합니다. 여기에서 저장된 서버를 확인하고, 연결할 대상을 선택하고, 연결 스위치를 켤 수 있습니다. 이 단계에서는 아직 연결하지 마세요. 목록이 비어 있으면 먼저 정보를 가져오고, 항목이 이미 있더라도 이름만 보고 선택하지 말고 본인의 유효한 구독에서 가져온 항목인지 확인하세요. 구독은 서버 정보를 가져오는 주소이며, 단일 서버는 개별 연결 정보입니다. 두 가지는 입력 방법이 다릅니다.

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

Home 오른쪽 위의 추가 버튼을 누르고 Add Server로 이동한 다음 Type에서 Subscribe를 선택합니다. 전체 구독 링크를 URL에 붙여 넣고, 필요하면 알아보기 쉬운 메모를 입력한 뒤 오른쪽 위의 저장 버튼을 누릅니다. 붙여 넣은 링크 앞뒤에 공백, 줄바꿈, 채팅 문구가 포함되지 않았는지 확인하세요. 도메인만 복사하거나 물음표 뒤의 매개변수를 지우지 마세요. 매개변수는 구독 인증 정보일 수 있으므로 일부가 빠지면 내용을 가져오지 못할 수 있습니다.

저장한 뒤 Home으로 돌아가 구독 내용을 불러올 때까지 기다립니다. 정상적으로 가져오면 해당 구독 그룹과 서버 항목이 표시됩니다. 항목 하나를 눌러 예상한 서버가 선택되었는지 확인하세요. 구독 이름만 보이고 서버가 없다면 가져오기가 완료된 것이 아니므로 먼저 가져오기 결과를 확인해야 합니다. 새로고침할 때는 해당 구독 항목의 업데이트 기능을 사용하세요. 메뉴에서 업데이트 항목을 찾아 실행한 뒤 목록이 바뀌었는지 확인합니다.

새로고침하려고 같은 구독을 반복해서 추가하지 마세요. 중복된 그룹이 생기면 이후 선택과 문제 해결이 복잡해지고 오래된 항목을 잘못 사용할 수 있습니다. 업데이트하면 서비스 제공업체가 반환하는 데이터를 다시 가져오므로 구독 항목을 직접 수정한 경우 새 내용으로 덮어쓸 수 있습니다. 별도의 수정 내용을 보존해야 한다면 저장 방법을 먼저 확인한 뒤 업데이트하세요.

단일 서버 정보가 있는 경우: Type에 맞춰 입력

단일 서버 설정을 받았다면 Add Server로 이동하되, Type에서 Subscribe가 아니라 서비스 제공업체가 안내한 프로토콜을 선택합니다. 서버 주소, 포트, 인증 정보와 해당 프로토콜에 필요한 항목을 차례로 입력하세요. 예를 들어 UUID, TLS, Server Name이 필요하면 받은 정보를 하나씩 대조합니다. 서로 다른 프로토콜의 항목을 혼용하거나 주소 형식만 보고 프로토콜을 추측하지 마세요.

저장한 뒤 Home으로 돌아가 방금 추가한 항목을 선택합니다. 기존 QR 코드가 있다면 Scan QR Code로 가져올 수도 있지만, 가져온 뒤 Type과 주소를 확인해야 합니다. 구독 URL, QR 코드, 인증 정보에는 접속 자격 증명이 포함될 수 있으므로 공개 화면 캡처나 전달을 피하세요. 이 단계를 마치면 연결할 서버가 무엇인지 분명히 확인한 다음 라우팅을 선택합니다.

STEP 02 · Global Routing / Config

Global Routing 모드 선택

서버는 프록시 연결에 사용할 대상을 정하고, Global Routing은 요청을 처리하는 방식을 정합니다. Home에서 Global Routing을 열고 Config, Proxy, Direct 세 가지 모드를 확인하세요. 이 가이드에서는 기본 점검을 위해 이 세 모드를 사용합니다. 화면에 다른 옵션이 표시되더라도 이번 작업 범위에 집중하고 모든 기능을 한꺼번에 설정할 필요는 없습니다.

Config: 현재 규칙에 따라 처리

적합한 구성 파일이 있다면 일상적인 사용에는 Config를 선택할 수 있습니다. 그런 다음 Config로 이동해 파일이 목록에 있기만 한 것이 아니라 실제로 적용되어 있는지 확인하세요. 구독 가져오기와 Config는 서로 다른 기능입니다. 구독은 주로 서버 정보를 갱신하고, Config는 규칙과 DNS 등의 동작을 제어합니다. 구독을 가져왔다고 해서 필요한 분할 라우팅 규칙까지 준비된 것은 아닙니다.

규칙은 일반적으로 순서대로 확인하며, 먼저 일치하는 규칙이 요청에 적용할 정책을 결정합니다. 예를 들어 아래 내용은 예시 도메인에 PROXY를 적용하고 나머지 요청은 FINAL로 처리합니다. 이는 규칙 매칭을 설명하기 위한 예시일 뿐 기존 파일을 대체할 수 있는 완전한 구성은 아닙니다. PROXY도 실제 구성에서 유효한 정책으로 정의되어 있어야 합니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

Proxy: 선택한 프록시 연결 확인

적합한 Config가 없거나 문제가 규칙에서 비롯되었는지 확인하는 중이라면, 잠시 Proxy를 선택해 지정한 서버를 거치는 요청을 테스트할 수 있습니다. 이 옵션은 자동으로 문제를 해결하지 않으며 잘못된 인증 정보를 보완해 주지도 않습니다. 시스템 자체 트래픽이나 시스템 제한이 적용되는 요청은 예외일 수 있으므로, 기기의 모든 데이터가 예외 없이 이 모드를 따른다고 이해해서는 안 됩니다.

Direct: 로컬 네트워크와 비교

Direct를 선택하면 요청이 직접 연결되므로 현재 Wi-Fi나 셀룰러 네트워크가 정상인지 확인할 수 있습니다. 프록시 서버를 검증하는 용도는 아닙니다. Direct에서는 페이지가 열리고 Proxy에서는 열리지 않는다면 프록시 연결을 추가로 점검할 수 있습니다. 두 모드 모두 실패하면 모든 구성을 바로 다시 만들기보다 대상 사이트, 로컬 네트워크, DNS 문제도 확인하세요.

이번에 선택한 모드를 기록해 두세요. 처음 문제를 점검할 때 규칙을 바꾸고 서버를 교체하고 모드까지 전환하면 어떤 변경이 영향을 주었는지 알기 어렵습니다. 규칙 구조와 설정의 의미는 설정 참고에서 확인할 수 있습니다. 우선 현재 서버와 라우팅 모드를 정한 뒤 연결을 켜세요.

STEP 03 · Home / VPN

스위치를 켜고 시스템 연결 상태 확인

Home으로 돌아가 서버 선택 표시와 Global Routing을 다시 확인합니다. 이상이 없으면 화면 위쪽의 연결 스위치를 켭니다. 처음 연결할 때 iPhone 또는 iPad에 VPN 구성을 추가하라는 시스템 메시지가 표시됩니다. 메시지를 읽고 방금 Shadowrocket에서 시작한 요청인지 확인한 다음 허용하고, 안내에 따라 기기 인증을 완료하세요. 이는 시스템 네트워크 터널을 설정하는 데 필요한 권한 부여이며 구독을 가져오는 단계가 아닙니다.

이전에 권한 요청을 취소했다면 앱으로 돌아가 연결을 다시 시작하세요. 구독을 반복해서 추가해도 해결되지 않습니다. 시스템 권한 부여가 완료되지 않았다면 Home에 서버가 여러 개 표시되어도 연결이 설정되었다고 볼 수 없습니다. 안내를 완료한 뒤 Shadowrocket으로 돌아와 스위치가 켜져 있는지, 연결 상태가 갱신되었는지 확인하세요. 필요한 경우 시스템 설정에서도 VPN 상태를 확인해 두 상태가 일치하는지 살펴봅니다.

스위치를 켜자마자 꺼지면 먼저 앱이나 시스템에 오류 안내가 표시되는지 확인하세요. 다른 VPN 연결이 시스템 연결을 사용 중인지 확인하고, 필요하면 해당 연결을 끈 다음 Shadowrocket에서 다시 시도합니다. 현재 상태를 기록하지 않은 채 시스템 구성을 바로 삭제하지 마세요. 삭제하면 다음 연결 때 다시 권한을 받아야 할 수 있고 문제 원인을 판단하기도 더 어려워집니다.

수동으로 연결을 끈 뒤에도 연결이 다시 시작된다면 On Demand가 켜져 있는지, 다른 시스템 자동 연결 조건이 설정되어 있는지 확인하세요. 처음 사용할 때는 해당 설정을 기록한 다음 자동 연결 조건을 잠시 끄고 수동 연결을 테스트할 수 있습니다. 이렇게 하면 앱이 직접 연결하는 경우와 시스템 조건에 따라 다시 연결되는 경우를 구분해 스위치가 반응하지 않는다고 오해하지 않을 수 있습니다.

스위치가 켜져 있다는 것은 연결 과정이 시작되었다는 뜻일 뿐, 선택한 서버와 도메인 해석, 규칙이 모두 예상대로 동작한다는 보장은 아닙니다. 서버를 여러 개 연달아 바꾸지 말고, 먼저 같은 서버로 아래 테스트를 완료해 연결 상태와 실제 접속 결과를 각각 기록하세요.

STEP 04 · Connectivity Test

서버, 접속 결과, 규칙을 나누어 확인

연결한 뒤 Connectivity Test를 실행해 선택한 서버의 테스트 결과를 확인합니다. 테스트 메뉴는 Home의 도구 또는 작업 메뉴에 있을 수 있습니다. 테스트 방식을 선택할 수 있다면 서버를 비교할 때 같은 방식을 사용하세요. 테스트 성공은 해당 테스트 조건에서 예상한 응답을 받았다는 뜻이며, 모든 웹사이트와 프로토콜, 앱의 동작까지 확인되었다는 뜻은 아닙니다.

테스트 결과가 네트워크 탐지 응답만 보여 주는 경우 인증과 전체 프록시 접속이 정상이라고 단정할 수 없습니다. 테스트 방식마다 확인하는 연결 범위가 다를 수 있으므로, 다음으로 브라우저를 열어 현재 라우팅 설정에 맞고 접속 가능한지 확인된 페이지를 방문하세요. 이전에 열었던 페이지나 캐시된 내용을 이번 연결의 결과로 착각하지 않도록 새로고침하거나 요청을 다시 보내세요.

Config를 확인할 때는 페이지가 열리는 것과 규칙에 따라 연결되는 것을 구분해야 합니다. 페이지가 열려도 PROXY가 아니라 DIRECT 규칙이 적용된 결과일 수 있습니다. 앱의 요청 기록이나 Log에서 방금 방문한 도메인을 찾아 적용된 규칙과 최종 정책을 확인하세요. 해당 요청이 기록에 없다면 시간, 도메인, 현재 연결이 일치하는지 먼저 살펴보세요. 페이지가 열리는 속도만으로 연결 경로를 판단하지 마세요.

Proxy를 확인할 때는 같은 서버를 유지하고 같은 페이지에서 연결 전후의 접속 결과를 비교하세요. Direct는 기본 네트워크를 확인하는 데 사용합니다. 모드마다 확인 목적이 다르므로 모두 같은 결과를 내야 하는 것은 아닙니다. 상태 표시줄의 VPN 아이콘만으로 결론을 내리지 마세요. 시스템 아이콘은 터널 상태를 나타낼 뿐, 각 요청에 적용된 최종 정책까지 보여 주지는 않습니다.

마지막으로 평소 사용할 설정으로 점검합니다. 문제 해결을 위해 Proxy로 바꾸었다면 사용할 Config로 되돌린 뒤 대상 요청을 다시 보내고 기록을 확인하세요. 구성 파일 이름, 서버 이름, Global Routing 선택, 테스트 결과를 기록해 둘 수 있지만 인증 정보는 공개 기록에 남기지 마세요. 일상 모드로 복원한 뒤에도 예상대로 동작해야 이번 시작 절차가 완료된 것입니다.

STEP 05 · 실패 단계별 확인

자주 발생하는 실패와 다음 점검 항목

무엇을 바꿀지 결정하기 전에 실패가 어느 단계에서 발생했는지 기록하세요. 구독이 업데이트되는지, 서버 테스트가 되는지, 연결 스위치가 켜진 상태를 유지하는지, 대상 요청이 성공하는지 확인하는 것이 좋습니다. 한 번에 한 항목만 바꾸고 같은 대상을 다시 테스트하세요. 정상 작동을 확인한 뒤에는 진단을 위해 임시로 변경한 설정을 되돌립니다. 이렇게 하면 앱을 반복해서 삭제하고 다시 설치하는 것보다 유용한 정보를 보존하기 쉽습니다.

구독 내용이 없거나 업데이트 실패

먼저 구독 편집 화면으로 돌아가 URL이 완전한지, Type이 Subscribe인지, 링크가 아직 유효한지 확인하세요. 로그인 페이지, 안내 문구, 빈 내용이 반환되면 앱은 이를 서버 목록으로 사용할 수 없습니다. 이 경우 서비스 제공업체에 구독 주소와 반환 형식을 문의하세요. 매개변수를 임의로 추측하지 마세요. 구독 가져오기는 연결 전에 이루어지는 과정이므로 업데이트 실패를 모든 서버를 사용할 수 없다는 뜻으로 단정하지 마세요.

서버 목록은 있지만 이번 업데이트가 실패했다면 기존 그룹을 보존하고, 기존 항목이 여전히 작동하는지 확인해 구독 가져오기 문제인지 서버 연결 문제인지 구분하세요. 문제 해결을 위해 전체 구독 주소를 공개하지 마세요. 오류 내용과 발생 단계, 이미 확인한 사항을 설명하는 편이 보통 더 도움이 됩니다. 구독에 접속 자격 증명이 포함되어 있다면 민감 정보로 취급하세요.

서버 테스트 실패 또는 연결 후 접속 불가

주소, 포트, 프로토콜, 인증 항목을 하나씩 확인하세요. TLS가 설정된 항목은 관련 이름과 서버 측 요구 사항이 일치하는지도 확인해야 합니다. 무작정 포트만 바꾸지 마세요. 구독에서 가져온 정보라면 구독이 올바르게 업데이트되었는지 먼저 확인한 뒤 서비스 제공업체에 서버 상태를 문의하세요. Wi-Fi와 셀룰러 네트워크를 바꿔 비교할 수 있지만, 전환할 때마다 테스트를 다시 실행해야 합니다. 이전 결과를 그대로 사용하지 마세요.

Direct에서도 모든 대상에 접속할 수 없다면 Wi-Fi 로그인 완료 여부나 네트워크 연결 상태 등 로컬 네트워크부터 확인하세요. 스위치가 켜진 상태를 유지하지 못하면 시스템 VPN 권한과 다른 연결과의 충돌을 먼저 확인합니다. 스위치는 정상인데 요청이 실패한다면 서버, 이름 해석, 정책을 살펴보세요. 단계를 구분하면 시스템 권한 문제를 해결하려고 규칙을 수정하는 일을 피할 수 있습니다.

일부 페이지만 또는 일부 앱만 실패

먼저 같은 대상을 사용해 Config와 임시 Proxy의 결과를 비교하세요. Proxy는 정상인데 Config에서 문제가 발생하면 실제로 적용된 규칙, 정책 대상, 규칙 순서를 확인합니다. 도메인 요청만 실패하고 다른 요청은 정상이라면 DNS 기록과 설정을 살펴보세요. 한 가지 증상만으로 모든 DNS 매개변수를 한꺼번에 바꾸거나 백업 없이 Config 전체를 덮어쓰지 마세요.

DNS, On Demand, Log 또는 구성 복원과 관련된 고급 작업은 설정 참고에서 항목별로 확인하세요. 증상별 안내는 자주 묻는 질문에서 볼 수 있습니다. 문제 해결 정보를 공유하기 전 구독 URL, 비밀번호, UUID 등 민감한 항목을 가리고 화면에 표시된 용어, 오류 문구, 작업 순서만 남기세요.

작동하는 서버 선택과 Config를 유지하고, 이후에는 한 번에 설정 하나만 변경하세요. 구독을 갱신할 때는 기존 그룹을 업데이트하고, 규칙을 수정하기 전에는 현재 구성을 저장합니다. 변경할 때마다 ‘연결 상태 → Connectivity Test → 실제 요청 → 적용된 정책’ 순서로 다시 확인하세요.