Shadowrocket 사용법

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

Shadowrocket의 Home을 열고 Add Server를 찾아 들어간 다음 Type을 누르고 Subscribe를 선택합니다. 기존 구독 링크 전체를 해당 URL 입력란에 붙여 넣고, 알아보기 쉬운 메모를 입력한 뒤 저장하세요. 구독 내용을 반환하는 링크를 입력해야 합니다. 서비스 제공업체의 로그인 페이지나 소개 페이지 주소는 사용할 수 없습니다. 링크 끝의 매개변수는 인증에 사용될 수 있으므로 복사할 때 삭제하지 말고 따옴표, 공백 또는 줄바꿈도 추가하지 마세요.

저장한 뒤 Home으로 돌아가 SERVER에 구독 그룹과 서버 항목이 표시되는지 확인합니다. 요청 실패 안내가 표시되거나 그룹만 있고 항목이 없다면 연결을 진행하지 마세요. 링크가 유효한지, 내용을 앱이 인식할 수 있는지, 현재 네트워크에서 구독 내용을 가져올 수 있는지 먼저 확인하세요. 구독 가져오기와 서버 연결은 별개의 단계입니다. 구독이 저장되었다고 해서 각 서버에 연결할 수 있다는 뜻은 아닙니다.

나중에 구독을 업데이트할 때는 해당 그룹의 업데이트 기능을 사용하고, 업데이트 후 현재 선택 항목을 다시 확인하세요. 원격 구독 내용이 항목 이름을 바꾸거나 기존 항목을 삭제할 수 있으므로, 선택했던 서버가 여전히 있는지 확인해야 합니다. 항목을 헷갈리지 않도록 처음에는 같은 링크를 반복해서 가져오지 않아도 됩니다. 우선 하나의 그룹을 확인한 다음 다른 구성을 관리하세요.

단일 서버 정보가 있는 경우: 먼저 Type 확인

구독 링크가 아니라 주소, 포트, 인증 정보가 제공된 경우 Add Server의 Type에서 실제 서버와 일치하는 프로토콜을 선택하세요. 그런 다음 Host, Port와 해당 프로토콜에 필요한 Password, Method 또는 기타 인증 정보를 입력합니다. 스크린샷은 특정 항목 구성의 예시일 뿐이므로 모든 프로토콜에 같은 항목을 입력하면 안 됩니다. Type이 잘못되면 주소와 비밀번호가 정확해도 연결이 성립하지 않을 수 있습니다.

Host에는 서버에서 안내한 호스트명 또는 주소를 입력하고, Port에는 해당 포트를 입력하세요. 전체 웹 주소를 Host에 입력하면 안 됩니다. Password와 키는 대소문자를 구분하는 경우가 많으므로 붙여 넣은 뒤 앞뒤 공백을 확인하세요. Method는 해당 프로토콜에서 필요한 경우에만 원래 제공된 정보에 맞춰 선택하고, 이름이 비슷하다는 이유로 추측하지 마세요. TLS, SNI, 전송 방식 등의 추가 항목은 원래 구성과 동일하게 설정하세요. 잘 모르는 항목은 개념 빠른 참조에서 확인하고, 프로토콜 매개변수의 선택 기준은 프로토콜 자세히 알아보기를 참고하세요.

지원되는 QR 코드가 있다면 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 권한을 허용할 수 있습니다. Import from Cloud JSON은 별도의 입력 방식입니다. 일반 구독 링크를 해당 JSON 주소로 임의로 사용하지 마세요. 어떤 방법을 쓰든 저장 후 Home으로 돌아가 항목 이름과 유형이 예상한 대로인지 확인하세요. 목록에서 서버를 확인한 뒤 다음 단계로 진행합니다. 이 단계는 정보를 저장한 것일 뿐, 연결이 확인된 것은 아닙니다.

Home으로 돌아가 Global Routing을 누르고 현재 선택 항목을 확인합니다. 시작할 때는 세 가지 방식인 Config(구성)/Proxy(프록시)/Direct(직접 연결)의 차이를 알아두세요. 연결 스위치가 켜져 있다는 이유만으로 요청이 특정 경로를 거친다고 단정하지 마세요. 라우팅 방식에 따라 같은 서버를 선택해도 접속 동작이 달라질 수 있습니다.

Config: 현재 규칙에 따라 처리

Config를 선택하면 앱이 현재 구성의 규칙에 따라 요청을 처리합니다. Config로 들어가 사용할 구성 파일이 선택되어 있는지 확인한 다음, Rule에 용도에 맞는 규칙이 있는지 살펴보세요. 구성 파일에는 규칙뿐 아니라 DNS 등의 설정도 포함될 수 있으므로 서버 구독을 가져오는 일과 규칙 구성을 선택하는 일은 별개입니다. 구독이 있다고 해서 적합한 규칙 구성이 모두 준비된 것은 아닙니다.

스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 구성 편집 화면의 각 섹션입니다. 처음 연결할 때 모든 항목을 켜거나 수정할 필요는 없습니다. 특히 일반적인 연결을 위해 HTTPS Decryption을 함부로 조정하지 마세요. 기본 연결에 필수인 단계가 아닙니다. 규칙만 확인하려면 먼저 Rule을 살펴보고, 내용을 이해한 뒤 Add Rule을 사용하세요. 편집하기 전에 원래 구성을 보관해 두면 복원할 수 있습니다.

규칙 키워드는 원문 그대로 사용해야 합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 지정된 도메인 접미사와 일치하는 요청에 해당 처리 방식을 적용한다는 뜻입니다. FINAL,DIRECT는 앞선 규칙에 일치하지 않은 요청을 처리하는 기본 규칙의 한 예입니다. 이 구문은 형식을 알아보기 위한 예시이며 개인 구성을 그대로 덮어쓰라는 의미가 아닙니다. 규칙 순서와 처리 방식, 현재 서버가 함께 결과에 영향을 줍니다. 낯선 키워드는 설명을 먼저 확인하세요. 한 줄만 복사해 완성된 구성이 만들어질 것이라고 기대하지 마세요.

Proxy와 Direct: 연결 경로 구분

Proxy는 요청을 프록시 경로로 처리하므로 문제 해결 시 선택한 서버가 실제 접속에 사용할 수 있는지 확인하는 데 도움이 됩니다. Direct는 직접 연결 경로로 요청을 처리하며 로컬 네트워크 상태를 비교할 수 있습니다. 두 항목은 라우팅 방식이지 서버를 추가하는 기능이 아니며, 잘못된 인증 정보를 수정해 주지도 않습니다. 점검이 끝나면 임시 테스트 상태를 계속 사용하지 말고 실제로 필요한 방식으로 되돌리세요.

처음 설정할 때는 먼저 목적을 분명히 하세요. 신뢰할 수 있는 규칙 구성이 있고 규칙에 따라 처리하려면 Config를 선택하고 현재 구성을 확인합니다. 서버 경로와 로컬 경로를 비교하려면 Proxy와 Direct에서 같은 접속 테스트를 진행할 수 있습니다. 한 번에 하나의 옵션만 바꾸고 현재 선택을 기록하세요. 서버, 규칙, DNS를 동시에 변경하면 어떤 변경이 결과에 영향을 줬는지 알기 어렵습니다. 준비가 끝나면 Home으로 돌아가 연결 단계로 진행하세요.

SERVER에서 사용할 항목 선택

Home으로 돌아가 SERVER에서 이번에 사용할 서버를 선택하고 선택 표시가 원하는 항목에 있는지 확인하세요. 방금 구독을 업데이트했다면 현재 선택 항목이 바뀌지 않았는지 특히 주의해서 확인합니다. 서버 이름은 식별을 위한 라벨일 뿐, 주소와 인증 정보 및 원격 서버 상태가 올바르다는 증거는 아닙니다. 첫 테스트에서는 한 항목을 고정하고 서버를 반복해서 바꾸지 않는 것이 좋습니다.

다음으로 Global Routing에 표시된 현재 방식을 확인합니다. Config를 사용하려면 앞 단계에서 구성 파일을 확인했는지 점검하세요. Proxy 또는 Direct로 비교 테스트 중이라면 이번 테스트에서 선택한 방식도 기록해 둡니다. 확인이 끝나면 Home 상단의 스위치를 켜세요. 연결이 끊긴 상태에서는 스크린샷처럼 상단에 Not Connected가 표시됩니다. 스위치를 켠 뒤 앱의 연결 상태가 갱신될 때까지 기다리고, 연속해서 빠르게 누르지 마세요.

시스템 안내를 확인한 뒤 권한 승인

처음 연결할 때 시스템에서 VPN 구성 추가를 허용할지 물을 수 있습니다. 이 권한을 통해 Shadowrocket은 선택한 설정에 따라 기기의 네트워크 요청을 처리합니다. 안내가 Shadowrocket에 해당하는지 확인한 뒤 허용을 선택하고 시스템 안내에 따라 인증을 완료하세요. 거부하거나 취소하면 이번 연결을 계속할 수 없을 수 있습니다. 앱으로 돌아가 연결을 다시 시작하고 시스템 안내를 확인하세요. 구독을 다시 가져올 필요는 없습니다.

권한 승인은 서버 서비스를 구매하는 것이 아니며, 서버가 검증되었다는 뜻도 아닙니다. 시스템에 VPN 상태가 표시되는 것은 관련 연결 또는 구성이 활성화되어 있다는 의미일 뿐, 모든 페이지에 정상적으로 접속할 수 있다는 보장은 아닙니다. 이전에 다른 VPN 구성을 사용했다면 현재 작동 중인 구성이나 시스템 관리 제한이 있는지 먼저 확인하세요. 업무 또는 학습 환경에서 관리하는 항목은 용도를 모른 채 삭제하지 마세요.

상태가 안정된 뒤 접속 테스트

Home으로 돌아가 상단 연결 상태가 안정적으로 유지되는지 확인하세요. 스위치가 바로 꺼지거나 연결을 반복해서 시도하거나 오류가 표시되면 안내 내용을 기록하고 마지막의 문제 해결 단계로 이동하세요. 변경 사항을 계속 추가하지 마세요. 상태가 안정적이라면 먼저 Connectivity Test를 실행한 뒤 평소 사용하려던 페이지를 여세요. iPad에서도 같은 순서로 진행하면 됩니다. 컨트롤 위치는 현재 앱 레이아웃을 기준으로 하며, 주요 화면 용어는 동일합니다.

처음 연결하기 전에는 On Demand를 직접 제어할 수 있는 상태로 유지하고, 조건 설정은 서두르지 않는 것이 좋습니다. 수동 연결과 연결 해제, 결과 확인이 모두 재현된 뒤 자동 실행 조건을 살펴보세요. 그래야 연결이 저절로 복구될 때 수동 조작의 결과인지 On Demand 동작인지 구분하기 쉬워 문제 원인을 찾을 수 있습니다.

구독 가져오기 실패: 내용을 가져올 수 있는지 확인

가져오기 또는 업데이트 단계에서 실패했다면 URL 전체가 입력되었는지, 구독이 여전히 유효한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 먼저 확인하세요. 로그인 페이지, 오류 페이지 또는 지원되지 않는 내용이 반환되면 브라우저에서 주소가 열린다고 해도 앱이 구독으로 인식할 수 있다는 뜻은 아닙니다. 전체 링크를 모르는 검사 페이지에 입력하지 마세요. 구독 링크에 접근 자격 정보가 포함되어 있을 수 있습니다. 내용을 확인해야 한다면 이미 이용 중인 서비스 제공업체에 문의하세요. 모든 연결 설정을 먼저 바꿀 필요는 없습니다.

서버가 목록에 있지만 연결되지 않음: 항목과 권한 재확인

목록에 항목은 있지만 연결에 실패한다면 먼저 Type, Host, Port 및 인증 정보를 확인한 다음 해당 프로토콜에 필요한 추가 매개변수를 점검하세요. Method, TLS 또는 전송 방식을 무작위로 바꾸며 시험하지 마세요. 구독에서 가져온 구성이라면 먼저 업데이트하고 항목이 여전히 유효한지 확인하세요. 직접 입력했다면 원래 받은 정보를 항목별로 대조합니다. 시스템 VPN 승인을 완료하지 않았다면 연결 단계로 돌아가 권한을 처리하세요. 인증 오류가 발생하면 권한을 반복해서 요청하지 말고 서버 정보를 확인해야 합니다.

연결은 안정적이지만 접속되지 않음: DNS와 규칙 구분

연결은 유지되지만 대상에 접속할 수 없다면 같은 대상을 Proxy와 Config에서 비교하세요. Config에서만 문제가 발생하면 현재 구성이 올바르게 선택되었는지, Rule이 대상에 적절하지 않은 처리 방식을 지정하는지, DNS 조회가 가능한지 확인합니다. 도메인 조회 실패와 원격 연결 실패는 서로 다른 단계입니다. 시간 초과가 발생했다고 DNS, 규칙, 서버를 한꺼번에 바꾸지 마세요. 자세한 개념은 DNS 및 네트워크 용어에서, 자주 발생하는 증상은 질문과 답변 및 문제 해결에서 확인하세요.

일부 페이지나 앱에서만 문제가 발생한다면 막연히 ‘전부 연결되지 않는다’고 설명하는 것보다 구체적인 대상과 발생 조건을 기록하는 편이 도움이 됩니다. 모든 테스트에서 문제가 발생한다면 먼저 로컬 네트워크 자체를 사용할 수 있는지 확인한 다음, 사용 권한이 있는 다른 네트워크에서 비교해 보세요. 네트워크를 바꾸면 조건도 달라지므로 전환 후 결과를 새로 기록하고 이전 테스트 결과와 섞지 마세요.

테스트 결과가 서로 다르거나 연결이 저절로 복구됨: Settings 확인

Settings에 들어가 먼저 Test Method를 확인하고 Connectivity Test에서 어떤 방식을 사용하는지 파악한 뒤 같은 방식으로 나온 결과를 비교하세요. On Demand로 인해 조건에 따라 연결이 시작될 수 있습니다. 수동으로 연결을 해제한 뒤 다시 연결된다면 스위치만 반복해서 끄지 말고 기존 On Demand 조건을 확인하세요. 처음 문제를 점검할 때는 수동 조작을 안정적으로 재현한 다음 자동 동작을 설정하세요.

문제를 더 자세히 파악하려면 Diagnostics에서 현재 사용할 수 있는 진단 항목을 확인하세요. Settings의 Proxy, TCP, UDP 등은 구체적인 연결 동작과 관련된 설정이지, 모든 문제를 해결하는 단일 버튼이 아닙니다. 기본값이나 이미 검증된 설정을 유지하고 원인을 파악한 경우에만 변경하세요. 변경할 때마다 같은 테스트를 반복하고, 개선되지 않으면 원래 값으로 되돌려 추적하기 어려운 변경이 쌓이지 않도록 합니다.

필요한 기록은 남기고 민감 정보는 가리기

문제를 기록할 때는 실패한 단계, 현재 라우팅 방식, 프로토콜 유형, 오류 안내와 함께 ‘로컬 네트워크를 사용할 수 있는지’, ‘다른 항목에서도 같은 문제가 발생하는지’ 등을 남기면 충분합니다. 스크린샷이나 진단 내용을 공유하기 전에는 전체 구독 URL, 인증 매개변수, Password, 키와 개인 주소를 가리세요. 도움을 받기 위해 구성 파일 전체를 공개하지 마세요.

첫 설정 절차는 정보 저장, 라우팅 방식 확인, 권한 승인, 실제 접속 확인으로 마무리됩니다. 문제가 계속되면 해당 단계에 맞춰 질문과 답변을 읽어 보세요. 프로토콜 매개변수의 차이를 이해하려면 프로토콜 자세히 알아보기를 참고하세요. 시작 단계에서 모든 고급 설정을 한꺼번에 바꿀 필요는 없습니다.