Shadowrocket 공식 웹사이트 · 공식 가이드

Shadowrocket 입문 가이드:
가져오기, 연결 및 확인

iPhone / iPad 화면을 기준으로 다섯 단계를 거쳐 처음 연결합니다. 먼저 설정을 단순하게 유지하고 작동을 확인한 뒤 규칙과 On Demand를 조정합니다.

Subscribe

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

먼저 보유한 정보의 종류를 확인한 뒤 가져오기 방식을 선택합니다. 구독 링크에는 일반적으로 업데이트할 수 있는 여러 서버 항목이 포함됩니다. 단일 서버 정보에는 프로토콜, 주소, 포트, 인증 항목이 들어갑니다. 두 종류의 정보를 섞어 입력하면 안 됩니다. 구독 주소를 Host에 넣거나 단일 서버의 비밀번호를 구독 링크로 사용하지 마세요. 기존 서비스 제공업체에서 받은 정보라면 먼저 해당 항목 설명을 읽고 필요한 정보가 모두 있는지 확인하세요. 프로토콜을 임의로 바꾸거나 매개변수를 추측해 입력하지 마세요.

기존 구독 링크: Subscribe로 가져오기

Shadowrocket의 Home을 열고 오른쪽 위의 추가 버튼을 눌러 Add Server로 이동합니다. Type에서 Subscribe를 선택하고 기존 구독 주소 전체를 해당 URL 입력란에 붙여 넣습니다. 필요하다면 알아보기 쉬운 메모를 추가한 뒤 저장합니다. 붙여 넣은 후 앞뒤에 공백, 줄 바꿈 또는 설명 문구가 들어가지 않았는지 확인하세요. 접근 자격 정보가 포함된 링크는 비공개 정보로 취급하고 공개 게시판에 올리지 마세요.

저장한 뒤 Home으로 돌아가 구독 내용이 불러와질 때까지 기다린 다음 SERVER 그룹에 서버 항목이 나타나는지 확인합니다. 구독 이름이 보인다고 해서 서버 정보를 성공적으로 가져온 것은 아닙니다. 그룹 안에 실제로 선택할 수 있는 항목이 있는지도 확인해야 합니다. 비어 있다면 먼저 구독을 가져오는 네트워크와 주소가 완전한지 확인한 뒤 해당 구독의 업데이트 기능으로 다시 시도합니다. 같은 링크를 반복해서 추가해도 파싱 또는 접근 문제는 해결되지 않으며, 이후 선택이 복잡해질 수 있습니다.

단일 서버 정보: Type에 맞춰 입력

단일 서버 정보를 받았다면 Add Server에서 시작해 올바른 Type을 선택합니다. 오른쪽 이미지에는 Host, Port, Password, Method 항목이 표시되어 있습니다. 프로토콜에 따라 항목이 달라지므로 현재 선택한 유형의 요구 사항과 보유한 정보를 기준으로 입력하세요. Host에는 서버 도메인 또는 IP, Port에는 포트를 입력합니다. 이름이 비슷하다는 이유만으로 Method를 선택해서는 안 됩니다. TLS 또는 전송 매개변수도 각 항목을 대조해야 하며, 이미지에 나온 값을 본인의 정보 대신 사용하면 안 됩니다.

QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. Import from Cloud JSON은 형식이 일치하는 기존 정보에만 사용할 수 있으며, 임의의 웹 링크를 가져오는 기능이 아닙니다. 저장한 뒤 SERVER로 돌아가 서버 항목을 선택하고 선택 표시가 나타나는지 확인합니다. 이 단계에서 완료된 것은 “정보를 가져와 선택한 상태”이며 아직 연결은 이루어지지 않았습니다. 다음 단계에서 어떤 라우팅 방식으로 연결을 처리할지 정합니다.

Shadowrocket 서버 추가 화면. Type, Host, Port, Password, Method 및 하단 가져오기 버튼이 표시됩니다.
Add Server: 먼저 Type을 선택한 뒤 보유한 정보에 맞춰 입력합니다. 프로토콜마다 필요한 항목이 다릅니다.

Global Routing

Config / Proxy / Direct 선택

서버 선택과 라우팅 방식은 서로 다른 설정입니다. 서버 선택은 프록시 연결에 사용할 서버 항목을 정하고, 라우팅 방식은 어떤 연결을 프록시 경로로 보낼지 정합니다. Home으로 돌아가 Global Routing을 눌러 현재 선택 항목을 확인합니다. 처음에는 여러 설정을 한꺼번에 바꾸지 마세요. 서버를 확인하려는 것인지 기존 규칙에 따라 평소처럼 사용하려는 것인지 먼저 정한 뒤 적절한 모드를 선택합니다.

Config: 현재 구성에 따라 규칙 적용

Config는 현재 구성 파일의 규칙에 따라 연결 출구를 결정합니다. Config를 사용하려면 먼저 Config로 이동해 필요한 구성이 있고 활성화되어 있는지 확인합니다. 구성을 열면 General, Rule, Hosts 등의 섹션을 볼 수 있습니다. 기존 구성의 출처와 용도를 파악해야 합니다. 처음 연결할 때 URL Rewrite나 HTTPS Decryption을 하나씩 켤 필요는 없습니다.

규칙은 일반적으로 순서대로 적용되며, 실제 출구는 일치한 규칙과 그 정책에 따라 결정됩니다. 예를 들어 DOMAIN-SUFFIX는 도메인 접미사로 매칭하고, GEOIP는 IP의 지리 정보로 매칭하며, FINAL은 기본 규칙으로 사용됩니다. 따라서 Config에서 특정 웹페이지가 직접 연결되더라도 연결 실패를 뜻하지는 않습니다. 규칙이 의도한 결과일 수 있습니다. 처음 테스트할 때 서둘러 Add Rule을 누르지 마세요. 기존 구성을 유지하고 현상을 확인한 뒤 수정이 필요한지 판단합니다.

Proxy와 Direct: 결과 비교

Proxy는 클라이언트가 처리하는 연결을 선택된 프록시 경로로 전달하므로 서버가 작동하는지 잠시 확인할 때 적합합니다. Proxy에서는 접근할 수 있지만 Config에서는 같은 대상에 접근할 수 없다면, 서버 항목을 모두 다시 입력하기보다 활성 구성과 규칙을 먼저 확인합니다. 비교가 끝나면 원래 사용하려던 모드로 돌아가 문제 해결을 위한 임시 선택을 일상 설정으로 남기지 않도록 합니다.

Direct는 클라이언트가 처리하는 연결에 직접 연결 경로를 사용하며, 프록시 결과와 비교할 때 쓸 수 있습니다. 서버 항목을 선택해도 Direct 설정이 바뀌지는 않습니다. 이 비교는 클라이언트가 현재 연결을 처리하는 방식을 보여줄 뿐, 기기의 모든 시스템 트래픽까지 설명하지는 않습니다. 규칙 순서, 정책, 세 가지 모드의 차이를 더 알아보려면 프록시 모드 가이드를 참고하세요. Global Routing을 확인한 뒤 연결 단계로 이동합니다. 현재 선택 항목을 기록해 두면 다음 단계에서 확인할 때 유용합니다.

Shadowrocket Config 구성 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시됩니다.
Config: 구성 내용에 따라 Config 모드의 처리 결과가 달라집니다. Global Routing 선택 메뉴는 Home에 있습니다.

Home

스위치를 켜고 첫 연결 승인 완료

Home으로 돌아가 매개변수를 바꾸지 않고 다음 항목을 확인합니다. SERVER에서 방금 확인한 서버가 선택되어 있는지, Global Routing이 테스트할 모드인지 확인합니다. Config를 선택했다면 해당 구성도 확인합니다. 상단에 Not Connected가 표시되면 현재 클라이언트 연결이 설정되지 않은 상태입니다. 서버 이름 옆의 테스트 결과만 보고 연결 여부를 판단하지 마세요. 테스트 기록과 상단 연결 상태는 서로 다른 역할을 합니다.

Home 상단의 연결 스위치를 켭니다. 처음 사용할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 묻습니다. 안내에 표시된 앱 이름을 확인한 뒤 계속 진행하고, 기기에서 요구하는 암호 또는 생체 인증을 완료합니다. 이 단계는 시스템 네트워크 연결 구성을 만드는 승인 절차입니다. 두 번째 구독을 가져오는 과정이 아니며 시스템 팝업에 서버 비밀번호를 입력할 필요도 없습니다. 취소했다면 앱으로 돌아가 연결을 다시 켤 때 승인 절차를 완료하면 됩니다.

승인이 끝나면 Shadowrocket으로 돌아와 상단 상태가 연결되지 않음에서 연결됨으로 바뀔 때까지 기다립니다. 잠시 전환되는 동안 스위치를 연달아 반복해서 누르지 마세요. 어떤 조작이 현재 결과를 만들었는지 파악하기 어려워집니다. 스위치가 바로 꺼지거나 연결 중 상태가 오래 지속되면 완료되지 않은 시스템 안내가 있는지 확인한 다음, 기기에서 다른 VPN 연결이 작동 중인지 확인합니다. 다른 연결로 전환해야 한다면 먼저 해당 연결을 끊고 이 단계로 돌아와 다시 시도합니다.

연결한 뒤 시스템의 VPN 상태를 함께 확인해 터널이 만들어졌는지 살펴볼 수 있습니다. 표시 위치는 기기와 시스템 화면 구성에 따라 다를 수 있으므로 상태 표시줄에 항상 같은 아이콘이 나타나야 하는 것은 아닙니다. 시스템에 연결됨으로 표시되더라도 네트워크 터널이 만들어졌다는 뜻일 뿐, 구독 유효 기간, 원격 서버, DNS 및 모든 규칙이 정상이라는 의미는 아닙니다. 다음 단계에서 실제 접속으로 확인해야 하며 “스위치가 켜짐”을 가이드의 완료로 간주하지 마세요.

첫 확인 중에는 네트워크, 서버, 모드를 바꾸지 말고 On Demand도 기존 설정으로 유지합니다. 테스트를 중단하려면 Home으로 돌아가 상단 스위치를 끄고 상태가 복구될 때까지 기다린 다음 직접 연결 결과와 비교합니다. 자동 연결 조건은 이후에 설정하세요. 그래야 수동으로 연결을 끊은 뒤 자동으로 다시 연결되는 현상이 판단에 영향을 주지 않습니다.

Shadowrocket Home 화면. 상단에 Not Connected 스위치가 있고 아래에 Global Routing, Connectivity Test, SERVER 및 Add Server가 표시됩니다.
Home: 서버와 Global Routing을 확인한 다음 상단 스위치를 켭니다. 이미지에는 연결되지 않은 상태가 표시되어 있습니다.

Connectivity Test

테스트, 접속, 규칙의 세 단계로 확인

연결을 유지한 상태에서 Home의 Connectivity Test를 사용해 서버 테스트 결과를 확인합니다. 응답이 전혀 없는 항목을 먼저 가려낼 때 유용하지만, 결과는 테스트 방식과 대상에 따라 달라집니다. 테스트에 성공했다고 해서 모든 웹페이지에 접속할 수 있다는 뜻은 아니며 다운로드 속도, 동영상 재생 또는 UDP 사용 가능 여부를 바로 알 수 있는 것도 아닙니다. 선택한 서버의 결과를 기록하고 숫자를 바꾸려고 반복해서 테스트하지 마세요.

실제 접속으로 애플리케이션 계층 확인

브라우저를 열어 평소 알고 있고 현재 네트워크에서 접속 가능 여부를 확인할 수 있는 HTTPS 페이지로 이동합니다. 새로고침하고 사이트의 다른 페이지도 열어 캐시된 화면만 본 것은 아닌지 확인합니다. 다른 사이트도 함께 테스트해 특정 대상만 문제인지 전반적으로 접속할 수 없는지 구분합니다. 기존 구성에서 특정 대상이 프록시를 사용하도록 되어 있다면 해당 대상을 확인해야 합니다. 원래 직접 연결되는 페이지 하나만 열어서는 프록시 출구가 정상인지 확인할 수 없습니다.

실패하면 현상을 먼저 기록합니다. 도메인 이름 확인 오류인지, 연결 시간 초과인지, 인증서 안내인지, 페이지는 열리지만 특정 콘텐츠만 실패하는지에 따라 점검 방향이 다릅니다. 페이지를 열기 위해 인증서 위험 안내를 무시하지 말고 시스템 DNS, 서버 프로토콜, 모든 규칙을 즉시 바꾸지도 마세요. 유효한 비교를 위해 기존 상태를 보존합니다.

연결 기록에서 실제 출구 확인

라우팅을 확인해야 한다면 클라이언트 연결 기록 또는 Data 관련 화면에서 방금 요청한 도메인, 일치한 규칙, 처리 정책을 확인합니다. 현재 화면에 표시되는 정보를 기준으로 판단하세요. Config에서 DIRECT, PROXY 또는 REJECT가 표시되면 규칙과 함께 해석해야 합니다. REJECT는 서버 연결이 끊긴 것이 아니라 구성이 요청을 차단한 결과일 수 있습니다. 대상 규칙과 일치하지 않으면 도메인과 규칙 순서를 확인합니다.

마지막으로 통제된 비교를 합니다. Global Routing만 바꾸거나 기존 서버 하나만 바꾸고, 매번 같은 요청을 다시 실행합니다. Proxy로 바꾼 뒤 정상화되면 Config를 먼저 확인합니다. 서버 두 개의 결과가 다르면 서버 정보와 원격 상태를 우선 확인합니다. 연결을 끊어도 같은 페이지가 열리지 않으면 로컬 네트워크나 대상 자체의 문제일 수 있습니다. 웹페이지는 정상인데 통화나 게임 등에 문제가 있다면 UDP 관련 기능을 별도로 확인해야 합니다. HTTPS 결과를 모든 프로토콜에 그대로 적용할 수는 없습니다.

Diagnostics

실패한 단계에 따라 확인하고 재설치를 반복하지 않기

문제 해결은 앱을 바로 삭제하는 대신 첫 번째로 실패한 단계부터 시작해야 합니다. 현재 구성을 보존하고 사용 중인 네트워크, 서버, Global Routing, 구체적인 오류를 기록한 뒤 한 번에 한 항목만 바꿉니다. 그래야 변경 사항이 효과가 있었는지 판단하고 원래 상태로 되돌릴 수 있습니다. 재설치를 반복해도 기존 구독의 만료, 잘못된 항목 입력, 원격 서비스 장애는 해결되지 않는 경우가 많으며 로컬 메모와 설정이 사라질 수도 있습니다.

가져오기에 실패하거나 SERVER에 항목이 없음

구독 주소가 완전한지, 현재 네트워크에서 가져올 수 있는지, 응답이 로그인 페이지나 오류 안내가 아니라 클라이언트에서 인식할 수 있는 구독인지 확인합니다. 인증 정보가 포함된 링크를 낯선 확인 페이지에 붙여 넣지 마세요. 기존 서비스 제공업체의 정보를 다시 받아야 한다면 기존 채널을 통해 확인합니다. 수동 서버 정보는 Type, Host, Port, 인증 내용을 하나씩 확인하고 대소문자, 앞뒤 공백, 잘못 붙여 넣은 따옴표도 점검합니다.

테스트에 실패하거나 연결 상태가 반복해서 바뀜

Settings에서 Test Method를 열어 현재 테스트 방식을 확인합니다. 테스트 방식이 다르면 결과를 같은 지표로 단순 비교할 수 없습니다. 연결을 설정할 수 없다면 먼저 시스템 VPN 승인이 완료되었는지 확인한 뒤 네트워크에서 웹 로그인이 필요한지 점검합니다. Wi-Fi와 셀룰러 네트워크를 한 번 비교할 수 있지만, 네트워크를 바꾸면 On Demand 조건이 실행될 수도 있으므로 상단 연결 상태도 확인해야 합니다.

테스트 응답은 있지만 웹페이지가 열리지 않음

먼저 앞 절의 방법에 따라 Proxy와 Config를 각각 확인한 뒤 DNS 또는 규칙 문제인지 판단합니다. 모든 상황에 특정 DNS 주소를 고정 답으로 적용하지 마세요. 실제 네트워크와 구성에 따라 DNS 확인 경로를 함께 판단해야 합니다. Settings에서 Proxy, TCP, UDP 아래의 모든 옵션을 차례로 바꿀 필요도 없습니다. 각 항목은 서로 다른 계층에 영향을 주므로 기존 증거가 해당 항목을 가리킬 때만 조정합니다. 이름 확인과 시간 초과 문제를 더 자세히 알아보려면 문제 해결 가이드를 참고하세요.

Diagnostics로 결과 정리

원인을 더 자세히 확인하려면 Settings에서 Diagnostics를 열고 같은 실패 요청과 관련된 진단 내용을 살펴봅니다. 공유하기 전 구독 URL, 접근 자격 정보, 서버 인증 정보 및 기타 개인 정보를 가립니다. 오류 유형, 발생 순서, 관련 설정만 남기면 됩니다. 변경 사항이 도움이 되지 않으면 원래 값으로 되돌린 뒤 다음 항목을 확인합니다. 이렇게 비교 기록을 남기면 민감한 정보가 많이 포함된 전체 화면 이미지보다 원인을 파악하기 쉽습니다.

이 페이지에서 첫 사용 절차를 마칩니다. App Store에서 앱을 찾는 방법, 정품 확인, 기기 변경 후 복구는 연결 설정에서 처리할 사항이 아닙니다. 관련 안내는 정품 가이드에서 확인할 수 있습니다. 규칙을 체계적으로 설명한 내용은 프록시 모드 페이지를 참고하세요. 다운로드 문제, 가져오기 문제, 실행 문제를 구분해 두면 이후 문제가 생겼을 때 처음부터 반복하지 않고 해당 단계로 바로 돌아올 수 있습니다.

Shadowrocket Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP가 표시됩니다.
Settings: 실패한 단계에 따라 Test Method, On Demand, Diagnostics를 확인하고 한 번에 한 항목만 조정합니다.

On Demand

아직 설치하지 않았다면 기기에 맞게 받기

설치하고 기존 정보를 준비한 뒤 추가 및 가져오기로 돌아가 시작하세요. 첫 연결에 성공한 다음 일상적으로 사용할 규칙과 On Demand 조건을 하나씩 설정합니다.