OFFICIAL MANUAL · QUICK START

Shadowrocket 시작 가이드

구독 가져오기 → Global Routing → 연결 → 확인 → 문제 해결. 순서대로 설정하고 먼저 서버 하나의 연결을 확인한 다음 규칙 분기를 점검하세요.

아래 단계는 iPhone과 iPad에서 사용할 수 있습니다. 두 기기는 화면에 표시되는 공간이 다르지만 기본 순서는 같습니다. 먼저 연결 정보를 서버 항목으로 저장하고 요청 처리 방식을 선택한 뒤 연결합니다. 앱 화면 구성은 표시 상태에 따라 달라질 수 있으므로 Home, Add Server, Config 같은 영문 인터페이스 항목을 기준으로 찾으세요. 특정 버튼이 화면의 어느 위치에 있는지에 의존하지 마세요.

처음부터 모든 옵션을 조정할 필요는 없습니다. 이해하지 못한 설정은 그대로 두고 현재 상태를 기록한 다음 이 페이지에서 필요한 단계만 진행하세요. 프로토콜에 필수인 정보가 빠져 있다면 다른 항목의 값으로 대신 채우지 말고 먼저 정보를 확인하세요. 구독 주소, 비밀번호, 키는 민감한 정보이므로 전체 내용을 공개 게시물이나 스크린샷에 노출하지 마세요.

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

Shadowrocket을 열고 Home으로 이동한 다음 추가 항목을 찾아 Add Server를 엽니다. 보유한 정보가 어떤 유형인지 먼저 확인하세요. 구독 링크는 여러 서버 항목을 가져올 때 사용하며, 개별 서버 정보에는 프로토콜, 주소, 포트 및 인증 매개변수가 포함됩니다. 정보 유형에 맞는 방법 하나만 선택하면 됩니다. 가이드를 따라 하기 위해 같은 정보를 중복해서 가져올 필요는 없습니다.

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

Add Server의 유형 선택 화면에서 Subscribe를 찾아 선택한 다음, 서비스 제공업체에서 받은 전체 링크를 URL 필드에 입력합니다. 복사할 때 안내 문구, 따옴표, 줄바꿈 또는 앞뒤 공백이 포함되지 않았는지 확인하세요. 특히 물음표 뒤의 매개변수를 삭제하지 마세요. 이 부분은 구독을 식별하는 데 사용될 수 있으며, 주소가 열리더라도 일부를 삭제하면 동일한 내용을 가져오지 못할 수 있습니다.

직접 알아보기 쉬운 이름을 메모로 입력하고 구독을 저장합니다. Home으로 돌아가 구독에서 서버 목록을 가져왔는지 확인하세요. 항목이 나타나지 않으면 해당 구독의 업데이트 기능을 실행하고 결과를 확인합니다. 구독 주소를 저장하는 것과 구독 내용을 성공적으로 가져오는 것은 다릅니다. 선택 가능한 서버 항목이 표시되어야 이 단계의 주요 확인이 끝난 것입니다.

구독을 업데이트하면 원본 내용에 따라 목록이 바뀌고 항목 이름도 달라질 수 있습니다. 처음 가져올 때는 그룹과 출처를 확인하고, 이름이 비슷하다는 이유만으로 기존 항목을 삭제하지 마세요. 기존 구독을 교체하려면 먼저 새 구독이 정상적으로 업데이트되고 서버를 사용할 수 있는지 확인한 뒤 이전 내용을 정리하세요. 문제가 생겼을 때 비교할 수 있도록 기존 상태를 남겨 두는 것이 좋습니다.

개별 서버 정보가 있는 경우: 프로토콜 및 필드 확인

정보가 항목별 매개변수로 제공되었다면 Add Server에서 해당 프로토콜을 선택한 뒤 주소, 포트 및 인증 정보를 입력합니다. Shadowsocks, Trojan, WireGuard 등은 필요한 필드가 서로 다릅니다. 주소와 포트가 있다는 이유만으로 다른 프로토콜의 값을 그대로 적용하지 마세요. 주소 필드에는 일반적으로 호스트 이름이나 IP 주소를 입력하며, 임의로 웹 주소 형식으로 바꾸지 마세요. 포트는 제공된 값을 그대로 사용하고 흔히 쓰이는 숫자를 추측해 입력하지 마세요.

자료에 TLS, Server Name 또는 기타 전송 옵션이 명시되어 있다면 해당 값을 그대로 입력합니다. 도메인 주소와 TLS 인증에 사용하는 이름은 서로 다른 역할을 할 수 있으므로 임의로 바꾸지 마세요. 필수 정보가 제공되지 않았다면 원래 정보를 제공한 곳에 확인하세요. 저장을 위해 인증서 확인을 끄거나, 쓸 수 있을 것처럼 보이는 공용 주소를 대신 입력하지 마세요.

저장한 뒤 Home으로 돌아가 SERVER 영역에서 방금 추가한 항목을 찾아 사용할 서버를 선택합니다. 편집 화면을 열어 프로토콜 유형, 포트 및 인증 정보를 다시 확인하세요. 이 단계에서 항목이 표시된다는 것은 정보가 저장되었다는 뜻일 뿐, 서버에 연결할 수 있다는 증거는 아닙니다. 서버를 선택한 다음 Global Routing을 설정하세요.

02 · Global Routing 모드 선택

Home에서 Global Routing을 열어 현재 요청 처리 방식을 확인합니다. 이 가이드에서는 세 가지 모드를 Config/Proxy/Direct로 표기합니다. 이 설정은 요청을 처리하는 원칙을 결정하며, 서버 프로토콜을 선택하거나 연결 정보를 보완하는 기능은 아닙니다. 변경하기 전에 현재 값을 기록해 두면 확인 후 복원하기 쉽습니다.

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

일상적으로 규칙 분기를 사용하려면 Config를 선택합니다. 그런 다음 Config 화면으로 이동해 사용할 구성이 실제로 활성화되어 있는지 확인하세요. 목록에 구성이 저장되어 있어도 활성화된 것은 아닙니다. 편집 중인 파일과 현재 적용 중인 파일이 다를 수도 있습니다. 확실하지 않다면 먼저 활성화 표시를 확인하고 해당 구성을 열어 내용을 살펴보세요.

Config는 현재 구성의 규칙에 따라 정책을 결정합니다. 요청은 규칙에 따라 PROXY, DIRECT 또는 REJECT 정책을 사용할 수 있으므로 연결을 켰다고 해서 모든 요청이 프록시를 통과하는 것은 아닙니다. 규칙은 일반적으로 순서대로 일치 여부를 확인하며 먼저 일치한 항목이 결과에 영향을 줍니다. 전체 구조와 규칙 문법, 최종 정책의 의미는 구성 필드 참고 자료에서 확인하세요. 처음 연결할 때 전체 파일을 다시 작성할 필요는 없습니다.

Proxy: 프록시 연결 경로 먼저 확인

선택한 서버로 실제 접속할 수 있는지 확인하려면 Proxy를 임시로 선택할 수 있습니다. 이 모드에서는 해당 모드로 처리되는 요청이 선택한 프록시 서버를 거치므로 규칙 분기가 판단에 미치는 영향을 줄일 수 있습니다. 목적이 분명한 비교 테스트에 적합하지만, 모든 앱과 대상에 어떤 네트워크에서든 접속할 수 있다는 뜻은 아닙니다.

테스트 전에 Home에서 방금 확인한 서버가 여전히 선택되어 있는지 확인하세요. 일상적으로 규칙 분기를 사용한다면 테스트가 끝난 뒤 Config로 복원하고 대상 요청을 다시 확인합니다. 그렇지 않으면 이후의 접속 결과가 확인하려는 구성 규칙이 아니라 Proxy 모드에서 나온 것일 수 있습니다.

Direct: 로컬 네트워크 접속 확인

Direct는 선택한 프록시 서버를 거치지 않고 요청을 대상에 직접 보냅니다. 로컬 네트워크에서 특정 서비스에 접속할 수 있는지 확인하는 데 도움이 되지만, 프록시 서버의 사용 가능 여부를 증명하지는 않습니다. 정보를 가져온 뒤 계속 Direct 상태였다면 웹 페이지가 열리더라도 구독이 적용되었다고 판단할 수 없습니다.

이 단계가 끝나면 현재 모드와 선택 이유를 설명할 수 있어야 합니다. 규칙에 따라 일상적으로 사용하려면 Config, 규칙의 영향을 배제하고 프록시 경로를 확인하려면 Proxy, 로컬 직접 접속을 확인하려면 Direct를 선택합니다. 확인을 마친 뒤 Home으로 돌아가 연결을 시작하세요.

03 · 연결을 켜고 시스템 권한 승인

Home으로 돌아가 선택한 서버와 Global Routing을 확인한 다음 연결을 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 메시지가 표시될 수 있습니다. 이 메시지는 Shadowrocket이 기기에서 네트워크 트래픽을 처리하는 시스템 연결 구성을 만들도록 허용하는 절차입니다. 구매 절차나 서버 정보를 받는 단계가 아닙니다.

팝업에 표시된 앱 이름과 안내를 읽고 방금 실행한 작업으로 나타난 것인지 확인한 뒤 허용을 선택합니다. 이어서 시스템이 요구하는 기기 인증을 완료하세요. 권한을 취소하면 서버 항목을 저장하는 것만으로는 연결할 수 없습니다. 다시 시도하려면 Shadowrocket으로 돌아가 연결을 한 번 더 시작하고, 현재 시스템 안내에 따라 진행하세요. 확인 절차를 건너뛰려고 스위치를 반복해서 누르지 마세요.

권한 승인이 끝나면 상태가 안정될 때까지 기다리고 Home에서 연결 상태를 확인합니다. 시스템의 VPN 표시는 관련 연결 상태만 나타내며, 대상 서비스에 접속할 수 있거나 모든 요청이 프록시를 거친다는 것을 단독으로 증명하지 않습니다. 스위치를 켜자마자 다시 꺼진다면 앱에 표시된 안내를 기록한 뒤 다음 단계에서 문제를 확인하세요. 프로토콜, 라우팅, 구성 파일을 연달아 바꾸지 마세요.

기기에서 시스템 VPN 연결을 사용하는 다른 설정이 있다면 이번 확인에 필요하지 않은 연결을 먼저 종료하세요. 조직에서 관리하는 기기는 네트워크 정책이나 구성 관리로 인해 관련 작업이 제한될 수 있습니다. 기기 관리 기준에 따르고, 용도를 모르는 시스템 구성을 삭제하지 마세요.

처음 확인할 때는 현재 Wi-Fi를 계속 사용하는 등 동일한 네트워크 환경을 유지하는 것이 좋습니다. 서버 사용 가능 여부를 확인하는 동안 네트워크를 바꾸지 마세요. 네트워크가 달라지면 연결 조건도 바뀌어 로컬 네트워크 문제를 정보 입력 문제로 오해할 수 있습니다. 한 환경에서 연결을 확인한 뒤 다른 네트워크를 따로 테스트하세요.

이 단계의 완료 기준은 권한 승인이 끝났고 연결 상태가 안정적으로 유지되며, 현재 서버와 라우팅 모드가 예상대로 설정된 것입니다. 이어서 테스트와 실제 접속을 통해 결과를 확인하세요.

04 · 테스트와 실제 접속으로 작동 확인

Home에서 Connectivity Test를 찾아 현재 서버를 테스트합니다. 결과는 특정 테스트 대상과 방식, 현재 네트워크 조건에서의 연결 가능성을 보여주는 참고 자료로 활용하세요. 결과가 표시되어도 모든 서비스에 정상 접속할 수 있다는 뜻은 아닙니다. 결과가 나오지 않더라도 모든 프로토콜 매개변수가 잘못되었다고 단정하지 말고 실제 접속 결과와 함께 판단하세요.

그런 다음 브라우저를 열고 평소 사용하는 페이지 중 성공 여부를 명확히 판단할 수 있는 곳에 접속합니다. 이전에 캐시된 내용만 표시되는 것이 아니라 새 페이지 내용을 가져왔는지 확인하세요. 페이지 자체의 로그인, 지역, 계정 또는 서버 제한도 결과에 영향을 줄 수 있으므로 모든 문제를 Shadowrocket 탓으로 돌릴 수는 없습니다.

실제 접속에 성공하면 앱으로 돌아가 연결이 유지되는지 확인하고, 확인 가능한 요청 기록을 살펴 대상의 처리 경로를 확인합니다. Config에서는 대상에 어떤 규칙이 일치했고 최종적으로 어떤 정책이 적용되었는지 중점적으로 확인하세요. DIRECT가 적용되었다면 페이지가 열린 것은 직접 연결 경로가 작동했다는 의미이며, 선택한 프록시 서버가 해당 요청에 사용되었다는 증거는 아닙니다.

특정 규칙을 확인하려면 대상과 서버를 그대로 둔 채 구성을 살펴보세요. 현재 활성화된 파일을 보고 있는지 먼저 확인한 다음 규칙 일치 순서를 점검합니다. 일부 대상은 여러 도메인에 동시에 요청할 수 있습니다. 홈페이지는 열리지만 리소스가 일부 로드되지 않는다면 주소 표시줄의 기본 도메인만 보고 모든 규칙이 정상이라고 판단하지 말고 어떤 요청이 실패했는지 구분하세요.

Data의 업로드·다운로드 변화는 활동을 파악하는 참고 자료가 될 수 있지만, 특정 대상에 어떤 경로가 적용되었는지를 직접 증명하지는 않습니다. 통계에는 다른 앱의 백그라운드 요청이 포함될 수 있으며 서비스 제공업체의 집계 기준과 다를 수도 있습니다. 처음 확인할 때는 실제 접속 결과와 적용된 정책을 우선하고 두 곳의 수치가 정확히 일치할 필요는 없습니다.

네 가지 간단한 결과를 기록해 두세요. 사용한 네트워크, 선택한 서버, Global Routing 모드, 대상 서비스 접속 결과입니다. 전체 비밀번호나 구독 링크는 기록하지 마세요. 이후 네트워크를 바꾸거나 구독을 업데이트하거나 규칙을 수정할 때 같은 조건에서 다시 확인할 수 있어 기억에 의존해 비교하지 않아도 됩니다.

이 단계가 끝나면 임시로 선택했던 Proxy 또는 Direct를 평소 사용할 모드로 복원한 뒤 같은 대상에 다시 접속하세요. Config로 복원한 후 결과가 달라지면 규칙을 먼저 확인합니다. 두 모드에서 모두 실패하면 아래 순서에 따라 네트워크와 서버 정보를 점검하세요.

05 · 단계별로 흔한 문제 해결

문제를 확인할 때는 한 번에 조건 하나만 바꾸고 같은 테스트를 반복하세요. 구독을 수정하고 네트워크를 바꾼 뒤 규칙까지 바꾸면, 접속이 복구되어도 어느 조치가 효과가 있었는지 알기 어렵습니다. 아래 순서로 확인하면 가져오기 실패, 연결 미수립, 규칙 불일치를 구분해 처리할 수 있습니다.

구독은 저장했지만 서버 목록이 비어 있음

먼저 기기의 로컬 네트워크가 정상인지 확인한 다음 구독 주소가 완전한지 점검하세요. 업데이트에 실패하면 안내 내용을 확인해 주소에 연결할 수 없는 경우, 인증이 만료된 경우, 내용을 인식할 수 없는 경우 등을 구분합니다. 브라우저에서 링크가 열리더라도 어떤 응답을 받았다는 의미일 뿐, 가져올 수 있는 구독 내용이라는 보장은 없습니다. 로그인 페이지나 안내 페이지 주소를 구독 주소로 사용하지 마세요.

이전에 사용할 수 있었던 링크가 더 이상 업데이트되지 않는다면 서비스 제공업체에 링크 상태와 콘텐츠 형식을 확인하세요. 구독 업데이트가 실패해도 기존 서버가 바로 삭제되는 것은 아닙니다. 기존 항목이 남아 있는 것과 이번 업데이트가 성공한 것을 구분하세요. 출처 상태를 확인하기 전에 기존 목록을 지우지 마세요.

서버는 있지만 연결 또는 접속에 실패

해당 항목의 편집 화면을 다시 열고 프로토콜, 주소, 포트, 비밀번호 또는 기타 인증 정보를 하나씩 확인하세요. 복사한 내용에 공백이 섞이거나 메모를 주소로 잘못 입력하기 쉽습니다. TLS를 사용하는 연결이라면 자료에 명시된 이름 설정과 기기의 날짜 및 시간이 적절한지 확인하세요. 정보 오류를 감추기 위해 인증 요구 사항을 완화하지 마세요.

그런 다음 Home에서 같은 이름의 이전 서버가 아니라 해당 항목이 실제로 선택되어 있는지 확인하세요. Proxy로 잠시 전환해 같은 대상을 테스트하고, 계속 실패하면 로컬 네트워크와 서버 상태를 각각 확인합니다. 테스트가 한 번 시간 초과되었다고 모든 서버를 한꺼번에 삭제하지 마세요. 특정 테스트 대상에 연결할 수 없는 것과 연결 전체가 작동하지 않는 것은 항상 같은 문제가 아닙니다.

연결은 안정적이지만 일부 대상에 접속할 수 없음

먼저 현재 Global Routing을 확인하세요. Proxy에서는 접속되지만 Config에서는 되지 않는다면 현재 활성화된 파일과 대상에 일치한 규칙을 확인합니다. 특히 앞쪽의 더 포괄적인 규칙이 먼저 일치했는지, REJECT에 해당하는지 살펴보세요. 중복 규칙을 여러 개 추가하기 전에 실제 정책을 결정한 규칙을 찾아 필요한 부분만 최소한으로 수정하세요.

도메인 접속만 실패하고 다른 접속은 정상이라면 DNS 관련 요인을 확인해 보세요. 도메인이 올바르게 해석되지 않는 상황에서는 서버 메모를 바꾸거나 목록 순서를 조정해도 대개 해결되지 않습니다. 실패한 도메인과 당시 모드를 기록하고, DNS 및 규칙에 관한 자세한 설명은 FAQ와 구성 필드 참고 자료에서 확인하세요. 처음 문제를 살펴볼 때 모든 DNS 설정을 한꺼번에 바꾸지 마세요.

스위치가 켜진 상태로 유지되지 않거나 끈 뒤 자동으로 다시 연결됨

스위치가 켜진 상태로 유지되지 않으면 시스템 권한 승인이 완료되었는지, 앱에 오류 안내가 표시되었는지, 기기에 연결 관리 제한이 있는지 확인하세요. 끈 뒤 다시 연결된다면 On Demand가 조건에 따라 연결을 다시 시작하는지 확인합니다. 두 현상의 원인은 다르므로 모두 구독 문제로 단정하지 마세요. 시스템 구성을 확인해야 한다면 이번 설정에 해당한다고 확실히 알 수 있는 항목만 다루세요.

도움을 요청할 때는 어느 단계에서 실패했는지, 어떤 프로토콜을 사용하는지, 현재 모드와 테스트 및 실제 접속 결과가 무엇인지 글로 설명하세요. 스크린샷이나 로그를 공유하기 전에 구독 주소, 비밀번호, 키, 계정 식별 정보를 가리세요. 오류 유형과 필요한 필드 이름은 남겨 두면 문제 해결에 도움이 되면서도 연결 인증 정보의 노출을 막을 수 있습니다.

문제 해결이 끝나면 임시로 변경한 라우팅 모드와 테스트 설정을 복원하고 현재 Config와 서버 선택을 확인한 뒤 실제 접속을 한 번 더 테스트하세요. 자료를 정상적으로 가져왔는지, 올바른 서버를 선택했는지, 연결 권한을 승인했는지, 실제 정책이 예상과 일치하는지 재현 가능한 순서로 확인할 수 있어야 합니다. 이후에는 필요할 때 On Demand나 세부 규칙을 하나씩 추가하세요.