OFFICIAL MANUAL / GETTING STARTED

Shadowrocket 사용법:
가져오기, 연결 및 확인

iPhone / iPad 화면을 기준으로 다섯 단계에 걸쳐 처음 연결하는 방법을 안내합니다. 먼저 필요한 정보가 모두 있는지 확인한 후 규칙을 조정하고, 각 단계의 결과를 확인합니다.

Subscribe Global Routing Connectivity Test

읽는 순서: 처음 설정한다면 처음부터 따라 하세요. 연결은 되지만 일부 요청에만 문제가 있다면 확인 및 문제 해결 단계로 바로 이동할 수 있습니다. 스크린샷은 화면 위치를 파악하기 위한 것이며, 기기의 실제 필드 표시를 기준으로 확인하세요.

STEP 01 / ADD SERVER

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

구독은 여러 서버 정보를 업데이트하는 경로입니다. 단일 서버는 각 항목을 직접 입력해야 합니다. 두 방법 중 하나를 선택하면 되며, 같은 정보를 중복으로 추가할 필요는 없습니다.

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

하단의 Home을 열고 SERVER 영역에서 Add Server를 찾거나, 오른쪽 위의 추가 버튼을 탭해 Add Server로 이동합니다. Type을 탭해 목록을 연 다음 Subscribe를 선택하고 서비스 제공업체에서 받은 전체 구독 링크를 URL에 입력합니다. 이름은 직접 구분하기 위한 것이므로 용도에 맞게 입력할 수 있습니다. 내용을 가져올 수 있는지를 결정하는 것은 이름이 아니라 URL입니다.

붙여 넣은 뒤 앞뒤와 중간에 불필요한 공백이나 줄바꿈이 있는지 확인하세요. 일부 링크에는 쿼리 매개변수가 포함되며, 이 역시 주소의 일부입니다. 도메인만 복사하거나 길어 보이는 끝부분을 삭제하지 마세요. 저장한 다음 Home으로 돌아와 구독 내용을 불러올 때까지 기다리고, 해당 그룹을 펼쳐 서버 항목이 표시되는지 확인합니다. 가져오기에 실패했다는 안내가 표시되면 링크 또는 현재 네트워크를 먼저 점검하세요. 같은 이름의 구독을 반복해서 새로 만들지 마세요.

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

마찬가지로 Add Server에서 시작하되, Type에서는 Subscribe가 아니라 제공받은 정보에 지정된 프로토콜을 선택합니다. 이어서 Host, Port와 해당 프로토콜에서 요구하는 Password, Method 또는 기타 인증 필드를 입력합니다. 스크린샷을 보고 매개변수를 추측하지 마세요. Type에 따라 표시되는 필드가 다르며, 스크린샷에 특정 필드가 있다고 해서 모든 프로토콜에 입력해야 하는 것은 아닙니다. TLS, SNI 등의 추가 항목도 서비스 제공업체가 제공한 정보와 일치해야 합니다.

사용 가능한 QR 코드가 있다면 Scan QR Code로 읽은 뒤 내용을 확인할 수 있습니다. Import from Cloud JSON은 해당 형식의 정보를 보유한 경우에만 사용합니다. 일반 구독 링크를 형식이 맞지 않는 가져오기 메뉴에 임의로 입력하지 마세요. 직접 입력을 마치면 먼저 저장한 다음 SERVER로 돌아가 항목을 확인합니다. 이후 연결에 사용하는 것은 여기에 저장한 서버이며, 편집 화면에서 아직 제출하지 않은 내용이 아닙니다.

이 단계의 완료 기준은 Home에 선택 가능한 서버가 표시되고, 항목을 열었을 때 예상한 Type과 주소가 보이는 것입니다. 구독 그룹 이름만 표시되고 서버가 없다면 아직 연결을 확인할 수 없습니다. 필드의 의미가 불분명하면 용어집을, 가져오기에 실패한 경우의 안내는 문제 해결을 참고하세요.

Shadowrocket Add Server 공식 스크린샷. Type, Host, Port, Password, Method 및 하단 가져오기 메뉴가 표시됩니다
Add Server: 먼저 Type을 선택한 다음 해당 필드를 입력합니다. 스크린샷의 필드 조합을 서버 매개변수로 사용하지 마세요.
STEP 02 / GLOBAL ROUTING

Global Routing 모드 선택

서버는 연결 대상을 결정하고 Global Routing은 요청 처리 방식을 결정합니다. 서로 다른 설정이므로 서버를 선택한 뒤에도 라우팅 모드를 확인해야 합니다.

구성(Config), 프록시(Proxy), 직접 연결(Direct) 구분하기

Home으로 돌아와 Global Routing을 탭해 선택 항목을 엽니다. 구성(Config)은 현재 구성 파일의 규칙에 따라 요청 처리 방식을 결정합니다. 프록시(Proxy)는 프록시 경로를 사용할 수 있는 요청을 해당 경로로 처리하며, 짧은 시간 비교 테스트를 할 때 적합합니다. 직접 연결(Direct)은 직접 연결 경로로 처리하므로 상단 스위치가 켜져 있어도 요청이 선택된 서버를 반드시 거치는 것은 아닙니다. 세 모드는 속도 설정이 아니며, 잘못 입력한 인증 정보를 바로잡아 주지도 않습니다.

규칙에 따라 사용하려면 먼저 구성(Config)을 선택한 다음 하단의 Config를 열고 필요한 구성 파일이 선택되어 있는지 확인합니다. 파일이 여러 개라면 새 파일 하나를 가져왔다는 사실만으로 해당 파일이 현재 설정이 된 것은 아닙니다. 실제 선택 상태를 확인해야 합니다. 파일 편집 화면에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 표시됩니다. 처음 연결할 때 모든 항목을 수정하거나 모든 기능을 활성화할 필요는 없습니다.

구성 파일 전체를 한 번에 바꾸지 말고 규칙 순서 확인

Rule의 규칙은 일반적으로 순서대로 일치 여부를 확인하므로, 포괄적인 기본 규칙보다 구체적인 조건이 먼저 와야 합니다. 아래 예시는 문법을 이해하기 위한 것입니다. example.com 및 하위 도메인은 PROXY에 일치하고, 지정된 로컬 네트워크 대역은 DIRECT에 일치하며, 나머지 요청은 FINAL로 처리됩니다. 실제 구성의 정책 이름이 존재해야 합니다. 규칙 텍스트만 있고 연결된 정책이 없다면 연결 준비가 완료되었다고 판단할 수 없습니다. 예제를 그대로 사용하기 위해 기존 구성을 통째로 바꾸지 마세요.

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

문제가 서버와 규칙 중 어디에서 비롯됐는지 아직 확실하지 않다면 현재 모드를 기록해 두고, 잠시 프록시(Proxy)로 전환해 연결과 확인을 진행한 다음 구성(Config)으로 되돌려 비교할 수 있습니다. Proxy에서는 연결되고 Config에서 실패할 때 규칙과 정책을 집중적으로 확인할 수 있습니다. 두 모드에서 모두 실패한다면 서버와 기본 네트워크를 먼저 점검하세요. 처음 설정할 때는 변경 범위를 작게 유지하세요. 구독, 구성, DNS를 동시에 바꾸면 결과를 비교하기 어렵습니다.

Shadowrocket Config 공식 스크린샷. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Add Rule이 표시됩니다
Config 파일 편집 화면: 이 단계에서는 구성이 선택되어 있는지 확인하고 Rule의 역할을 이해하면 됩니다. 모든 섹션을 수정할 필요는 없습니다.
STEP 03 / HOME

기본 서버 선택 후 연결 스위치 켜기

실제로 사용할 서버를 선택한 다음 스위치를 켭니다. 항목 편집 화면에 들어가는 것과 기본 서버를 선택하는 것은 서로 다른 동작입니다.

SERVER에서 선택된 항목 확인

Config에서 Home으로 돌아와 SERVER 그룹에서 방금 가져온 서버를 찾습니다. 항목 왼쪽의 원을 탭해 선택 표시가 대상 서버로 이동했는지 확인합니다. 이름을 탭해 편집 화면으로 이동한 경우 목록으로 돌아와 선택 상태를 확인하세요. 구독에 서버가 여러 개 있다면 이번에는 하나를 선택해 확인합니다. 테스트할 때마다 서버를 바꾸면 오류를 서로 비교하기 어렵습니다.

Home에서 Global Routing이 앞 단계에서 계획한 모드인지 다시 확인한 다음 상단 연결 스위치를 켭니다. 처음 사용할 때는 시스템에서 VPN 구성 추가를 허용할지 물을 수 있습니다. 안내를 읽고 Shadowrocket에서 시작한 작업인지 확인한 뒤 허용하고, 시스템이 요구하는 기기 인증을 완료합니다. 승인을 취소해도 서버 항목은 남아 있지만 이번 작업으로 연결을 설정할 수는 없습니다. 다시 시도할 때 서버를 모두 다시 입력하기보다 승인 결과부터 확인하세요.

연결 상태는 첫 번째 확인 항목이지 최종 결론이 아닙니다

Home으로 돌아와 상단에 Not Connected가 계속 표시되는지 또는 연결 상태로 바뀌었는지 확인합니다. 스위치를 켜자마자 원래 상태로 돌아가면 연속해서 다시 시도하지 말고 안내 문구를 기록한 다음, 시스템에서 다른 VPN 연결이 실행 중인지 확인하세요. 처음 문제를 해결하는 동안에는 연결을 제어하는 항목을 하나만 유지해 서로 간섭하지 않게 합니다. 알 수 없는 시스템 구성을 삭제하며 문제를 해결하려 하지 마세요. 관리되는 기기에는 관리자 제한이 있을 수 있습니다.

스위치가 켜져 있다는 것은 클라이언트가 연결 작업 상태에 들어갔다는 의미일 뿐, 원격 인증, 도메인 확인, 실제 대상에 대한 접근이 모두 성공했다는 뜻은 아닙니다. 이때 바로 On Demand를 켜거나 자동 실행 실패를 서버 오류로 판단하지 마세요. 수동 연결을 유지하고 다음 단계에서 테스트를 실행한 뒤 대상 앱에 접속합니다. 수동 연결 경로를 확인한 후 자동 연결 조건을 설정하세요.

연결을 중지하려면 Home으로 돌아와 상단 스위치를 끄고 상태가 바뀌었는지 확인합니다. 나중에 서버를 바꾸거나 주요 매개변수를 수정할 때는 먼저 연결을 끊고 변경 사항을 저장한 뒤 다시 연결해 확인하는 것이 좋습니다. 새 설정이 언제 적용되었는지 파악하기 쉽고, 기존 연결의 결과를 새 매개변수의 결과로 착각하는 일을 줄일 수 있습니다.

Shadowrocket Home 공식 스크린샷. 상단 Not Connected 스위치, Global Routing, Connectivity Test, SERVER 및 Add Server가 표시됩니다
Home: SERVER 선택 항목, Global Routing, 상단 연결 상태를 차례로 확인한 다음 Connectivity Test를 실행합니다.
STEP 04 / CONNECTIVITY TEST

작동 여부 확인: 테스트 및 실제 요청

“클라이언트 상태 → 테스트 요청 → 대상 앱” 순서로 확인해 한 번의 테스트 결과를 전체 연결 경로의 결론으로 확대하지 마세요.

Connectivity Test 실행

방금 선택한 서버와 연결 상태를 유지한 채 Home에서 Connectivity Test를 탭하고 이번 테스트가 완료될 때까지 기다립니다. 먼저 명확한 성공 또는 실패 결과가 표시되는지 확인하세요. 서버별 수치를 비교할 필요는 없습니다. 테스트 결과는 방법, 대상, 현재 네트워크의 영향을 받습니다. 테스트 요청이 성공했다면 이번 테스트에서 거친 경로를 사용할 수 있다는 의미지만, 모든 앱과 도메인이 같은 경로를 사용한다는 뜻은 아닙니다.

테스트에 실패하면 현재 직접 연결(Direct) 상태인지, 선택된 서버가 예상한 서버인지 먼저 확인합니다. 필요한 경우 Settings에서 Test Method를 확인하고 현재 선택을 기록한 뒤 비교하세요. 성공 결과 하나를 얻으려고 방법을 계속 바꾸지 마세요. 현재 방법, 네트워크, 실제 접속 결과를 함께 확인하는 것이 더 중요합니다.

새로운 실제 요청 보내기

사용하려는 앱이나 페이지를 열고 직접 새로고침하거나 새 요청을 보냅니다. 이미 열려 있는 페이지, 캐시된 콘텐츠, 기존 연결은 새 설정이 적용되었음을 확인하기에 적합하지 않습니다. Shadowrocket으로 돌아와 Data에서 이번 작업 시간에 해당하는 기록을 확인합니다. 규칙 및 정책 정보가 있다면 스위치가 켜져 있는지만 보지 말고 대상 요청이 실제로 어떤 규칙과 일치했는지 확인하세요.

“테스트는 통과했지만 대상 앱은 실패”와 “테스트와 대상 앱이 모두 실패”는 서로 다른 문제입니다. 전자는 대상 요청의 규칙, DNS, 앱 동작을 먼저 확인하고, 후자는 서버, 인증, 현재 네트워크를 먼저 점검합니다. 페이지가 열렸다는 사실만으로 프록시를 통과했다고 판단할 수도 없습니다. 구성(Config)에서 해당 대상을 DIRECT로 처리하도록 규칙이 설정되어 있을 수 있습니다.

STEP 05 / SETTINGS & DIAGNOSTICS

실패 단계별 확인: 한 번에 한 항목씩 변경

먼저 가져오기 실패, 연결 실패, 요청 실패를 구분하세요. 각 문제는 서로 다른 단계에서 발생하므로 같은 방법으로 처리할 필요는 없습니다.

먼저 기본 네트워크를 확인한 다음 가져오기 결과 점검

연결을 끈 뒤 기기 자체에서 원래 사용할 수 있던 네트워크 리소스에 정상적으로 접근할 수 있는지 확인합니다. 기본 네트워크를 사용할 수 없다면 Wi-Fi 로그인, 셀룰러 데이터 권한, 네트워크 연결 끊김을 먼저 해결하세요. 구독을 가져올 수 없다면 URL 전체가 정확한지, 서비스 제공업체 측 구독이 아직 유효한지 확인합니다. 구독 링크를 검색어로 제출하거나 다른 사람에게 공개적으로 보내지 마세요. 가져오기 단계에서 아직 서버 목록을 받지 못했다면 Global Routing을 바꾸는 것으로 해결하기 어렵습니다.

스위치가 돌아가는 경우와 연결 후 시간 초과를 구분해 확인

스위치가 즉시 돌아가면 시스템 VPN 승인, 다른 VPN의 연결 상태, 기기 관리 제한을 우선 확인합니다. 스위치는 켜져 있지만 요청 시간이 초과된다면 현재 서버의 Host, Port, Type, 인증 필드를 확인하고 복사해 붙이는 과정에서 공백이 추가되지 않았는지 살펴보세요. 서비스 제공업체가 여러 접속 정보를 제공한 경우 한 정보의 주소와 다른 정보의 인증 필드를 섞지 마세요. 수정 사항을 저장한 뒤 다시 연결하고 같은 테스트 방법으로 확인합니다.

일부 요청에만 문제가 있는 경우: Config 확인

프록시(Proxy)에서는 사용할 수 있지만 구성(Config)에서는 사용할 수 없다면 Config로 돌아가 실제 선택된 파일을 확인한 다음 실패한 요청과 일치한 규칙 및 정책을 살펴봅니다. 범위가 지나치게 넓은 DOMAIN-KEYWORD, 앞쪽에 배치된 기본 규칙, 정책 참조가 예상 서버를 가리키는지 확인하세요. 먼저 원래 구성의 사본을 보관하고 한 항목을 수정한 뒤 새 요청을 보냅니다. 하나의 대상 문제를 해결하려고 모든 요청을 장기간 다른 모드로 고정하지 마세요.

수동 연결을 유지하고 Diagnostics 사용

Settings에서 On Demand를 확인합니다. 처음 문제를 해결할 때는 자동 실행을 끄고 수동 연결을 유지하세요. Wi-Fi 또는 네트워크 전환으로 상태가 달라진 것을 무작위 연결 끊김으로 오인하는 일을 막을 수 있습니다. 수동 연결이 안정되면 On Demand를 별도로 설정하고 각 실행 조건을 확인합니다. Test Method는 테스트 결과를 이해하는 데 사용하고 Diagnostics는 진단 정보를 수집하는 데 사용합니다. 분명한 이유가 없다면 Proxy, TCP, UDP 등의 설정을 한꺼번에 변경하지 마세요.

문제를 계속 확인해야 한다면 오류 원문, 발생 단계, 네트워크 유형, Global Routing 모드, 모든 서버에서 같은 현상이 발생하는지를 기록합니다. Diagnostics 또는 Data 정보를 공유하기 전에 구독 링크, 인증 정보, 불필요한 접근 기록을 숨기세요. 자주 발생하는 증상의 추가 안내는 문제 해결을, 화면 용어와 규칙 키워드는 용어집을 참고하세요. App Store에서 앱이 표시되는지, 구매 또는 구입 항목 복원에 문제가 있는 경우에는 정품 이용 안내를 확인하세요. 연결 매개변수를 다시 조정할 필요는 없습니다.

Shadowrocket Settings 공식 스크린샷. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP가 표시됩니다
Settings: 문제를 확인할 때는 Test Method, On Demand, Diagnostics를 기록하고 다른 옵션은 한꺼번에 변경하지 마세요.