Shadowrocket 사용법
구독 가져오기 및 첫 연결

Shadowrocket을 열고 Home에서 Add Server를 선택합니다. 화면의 추가 버튼으로 같은 페이지를 열 수도 있습니다. 주소 모양만 보고 가져오기 방식을 선택하지 마세요. 구독 주소는 여러 서버 정보를 가져오는 데 사용하고, 단일 공유 링크에는 일반적으로 서버 하나의 정보가 담겨 있습니다. Host, Port, Password 등의 매개변수는 해당 Type을 선택한 뒤 입력해야 합니다. 먼저 보유한 정보의 종류를 확인하면 구독 주소를 Host에 잘못 입력하는 일을 막을 수 있습니다.

기존 구독이 있는 경우: Subscribe 사용

Add Server에서 Type을 열고 Subscribe를 선택한 다음, 보유한 구독 주소 전체를 해당 주소 입력란에 넣습니다. 복사할 때 주소 끝의 매개변수까지 포함하고, 앞뒤에 공백이나 줄바꿈, 설명 문구가 들어가지 않았는지 확인하세요. 구독을 구분하기 쉽도록 메모를 입력할 수도 있습니다. 메모는 기기에서 구분하기 위한 것으로 원격 구독 내용에는 영향을 주지 않습니다. 확인 후 저장하고 앱이 내용을 가져올 때까지 기다린 다음 Home에서 결과를 확인합니다.

예를 들어 https://example.com/sub?token=xxxx는 주소 형식을 보여 주는 예시일 뿐이며 실제 연결에는 사용할 수 없습니다. 실제로는 본인이 보유한 주소를 사용하세요. 저장 후 구독 이름만 보이고 선택 가능한 서버가 없다면 구독 내용을 정상적으로 가져왔는지 먼저 확인하세요. 같은 주소를 반복해서 추가하지 마세요. 구독 주소는 현재 네트워크에서 접속할 수 있어야 합니다. 가져오기가 완료되지 않은 상태에서 연결 스위치를 반복해서 바꿔도 서버 목록이 채워지지 않습니다.

기존 서버 정보가 있는 경우: Type 선택 후 항목 입력

서버 정보를 직접 추가할 때는 먼저 자료와 일치하는 Type을 선택합니다. 그런 다음 Host와 Port를 입력합니다. Host에는 서버 도메인이나 주소를, Port에는 서버가 지정한 포트 번호를 입력하세요. 스크린샷에 표시된 항목을 기준으로 Password와 Method도 확인해야 합니다. 프로토콜마다 표시되는 항목이 다르므로 이 항목 구성이 모든 프로토콜에 공통으로 적용되는 것은 아닙니다. UUID, TLS 또는 전송 설정이 필요한 연결이라면 보유한 정보와 해당 항목을 추가로 대조하세요.

경험만으로 Method를 바꾸거나 ‘더 안전해 보인다’는 이유로 서버 설정과 다른 옵션을 켜지 마세요. 포트, 인증 정보, 전송 설정은 서로 일치해야 합니다. 앱에서 저장이 되더라도 원격 서버가 해당 설정을 받아들인다는 뜻은 아닙니다. 입력을 마친 뒤 원본 정보를 다시 확인하고 저장한 다음 Home으로 돌아갑니다.

QR 코드 및 단일 공유 링크

QR 코드가 있다면 Scan QR Code를 사용하고, 안내에 따라 필요한 카메라 권한을 허용하세요. 인식된 후에는 유형, 주소, 포트를 확인한 다음 저장합니다. 클립보드로 가져오려면 공유 링크 전체만 복사한 뒤 앱에서 해당 가져오기 기능을 사용하세요. 붙여넣기 접근 안내가 표시되면 필요한 경우 허용합니다. Import from Cloud JSON은 해당 형식의 정보를 가져오는 기능이며, 임의의 구독 주소를 대신 입력하는 용도가 아닙니다.

서버가 Home에 표시되는지 확인한 뒤 Global Routing을 엽니다. 처음에는 자주 사용하는 세 가지 모드인 Config, Proxy, Direct를 구분하세요. 여기서는 연결 처리 방식을 바꾸며 서버 정보 자체는 변경하지 않습니다. 모드를 전환해도 잘못된 비밀번호가 수정되거나 누락된 구독 내용이 추가되지는 않습니다.

Config: 현재 구성 파일의 규칙 사용

Config를 선택하면 현재 사용 중인 구성 파일의 규칙에 따라 연결이 처리됩니다. 대상에 따라 PROXY로 전달되거나 DIRECT로 연결될 수 있으며, REJECT 규칙이 적용될 수도 있습니다. 따라서 연결을 켠 뒤 일부 요청이 직접 연결되더라도 설정이 반드시 적용되지 않은 것은 아닙니다. 대상에 어떤 규칙이 적용되는지 확인하세요. Config로 이동해 현재 실제로 사용 중인 구성 파일을 확인해야 합니다. 파일이 목록에 저장되어 있는지만 확인해서는 안 됩니다.

스크린샷의 구성 편집 화면은 General, Rule, Hosts 등의 섹션으로 구성되어 있습니다. Rule에서 규칙을 확인하고, 새 규칙을 추가할 때만 Add Rule을 사용하세요. 첫 연결을 위해 각 섹션을 수정할 필요는 없습니다. 특히 일반 연결을 테스트하기 위해 URL Rewrite나 HTTPS Decryption을 변경하지 마세요. 용도를 알고 있는 기존 구성을 그대로 두고 기본 연결에 성공한 뒤 규칙을 하나씩 살펴보세요.

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

Proxy: 서버 연결 가능 여부를 먼저 확인

Proxy를 선택하면 클라이언트가 처리할 수 있는 연결이 프록시로 전달됩니다. 처음 문제를 점검할 때는 규칙 선택으로 인한 변수를 줄일 수 있습니다. 서버 하나를 선택하고 같은 대상으로 연결을 확인하세요. Proxy에서 정상적으로 접속되지만 Config로 전환한 뒤 실패한다면 구독을 바로 삭제하기보다 구성 파일과 규칙 적용 여부를 먼저 점검하세요. Proxy를 선택했다고 모든 앱과 시스템 트래픽이 반드시 같은 경로로 처리되는 것은 아니므로 실제 요청을 확인해야 합니다.

Direct: 대상에 직접 연결

Direct를 선택하면 서버를 거치지 않고 대상에 직접 연결합니다. 현재 네트워크에서 같은 사이트에 직접 접속할 수 있는지 비교할 때 유용합니다. Direct에서는 접속되지만 Proxy에서는 실패한다면 선택한 서버나 서버 매개변수를 우선 점검하세요. Direct는 ‘가장 빠른 서버 자동 선택’ 설정이 아닙니다. 모드를 선택한 뒤 Home으로 돌아가 서버를 선택하고 연결을 켭니다.

Home으로 돌아가 SERVER 목록에서 방금 가져온 서버를 찾습니다. 항목 왼쪽의 선택 원을 누르고 선택 표시가 원하는 서버에 있는지 확인하세요. 항목 편집 화면을 여는 것과 해당 항목을 현재 서버로 선택하는 것은 다릅니다. 목록에 서버가 여러 개 있더라도 처음 점검할 때는 하나만 선택하고 메모를 기록해 두면 이후 다시 테스트할 때 같은 조건을 유지하기 쉽습니다.

Global Routing을 다시 확인합니다. 기본 연결을 점검 중이라면 앞에서 안내한 Proxy를 먼저 사용할 수 있습니다. 명확한 구성 파일을 보유하고 규칙에 따라 사용하려면 Config를 선택하세요. 그런 다음 Home 상단의 연결 스위치를 켭니다. 연결되지 않은 상태에서는 Not Connected가 표시될 수 있습니다. 조작 후 스위치와 연결 상태가 바뀌는지 확인하고, 한 번 누른 뒤 곧바로 다른 앱으로 전환하지 마세요.

VPN 구성 권한 요청이 처음 표시될 때

처음 연결할 때 시스템에서 VPN 구성을 추가할지 묻는 안내가 표시될 수 있습니다. 이는 기기에서 Shadowrocket이 네트워크 연결을 설정하는 데 필요한 시스템 권한이며 구독 가져오기 안내가 아닙니다. Shadowrocket에서 요청한 작업인지 확인한 뒤 시스템 절차에 따라 허용하고 기기에서 요구하는 인증을 완료하세요. 이전에 안내를 취소했다면 앱으로 돌아가 연결을 다시 시작합니다. 시스템 안내가 끝나기 전에 스위치를 반복해서 누르지 마세요.

권한을 승인한 뒤 Home으로 돌아가 연결 스위치가 켜진 상태로 유지되는지 확인합니다. 시스템의 VPN 상태는 관련 네트워크 구성이 활성화되었음을 뜻하지만 원격 서버에 접속할 수 있음을 보장하지는 않습니다. 비밀번호가 틀리거나 포트에 연결할 수 없거나 규칙이 잘못 지정된 경우에는 이후 요청을 보내야 문제가 드러날 수 있습니다. 이 단계에서는 ‘항목 선택, 구성 허용, 연결 유지’를 완료하고 실제 접속 결과는 다음 단계에서 확인합니다.

연결 후에는 설정을 그대로 유지

스위치를 켠 직후 서버를 바꾸고 규칙을 수정하고 네트워크까지 전환하지 마세요. 현재 조건으로 먼저 한 번 테스트한 뒤 실패하면 변수를 하나씩 바꾸세요. iPad에서도 같은 순서로 점검하며, 화면 배치는 기기에 실제로 표시되는 내용을 기준으로 합니다. 앱 구매 내역과 서버 정보는 별개입니다. 기기를 바꾼 뒤 앱을 다시 다운로드했더라도 구독이나 서버 정보를 가져왔는지 확인해야 합니다.

구독은 저장됐지만 서버가 표시되지 않음

먼저 구독 정보로 돌아가 주소 전체가 입력되었는지, 현재 네트워크에서 해당 구독에 접속할 수 있는지 확인하세요. 구독 주소의 매개변수는 사용자 식별에 필요할 수 있으므로 일부만 복사하면 가져오기에 실패할 수 있습니다. ‘구독 항목을 저장함’과 ‘서버 정보를 정상적으로 가져옴’은 구분해야 합니다. 전자는 기기에 항목을 저장한 것뿐입니다. 보유한 정보에 유효 기간이나 사용 상태가 명시되어 있다면 본인의 기록을 확인하세요. 일반 웹페이지 주소를 구독으로 사용하거나 오류 페이지의 내용을 연결 매개변수로 사용하지 마세요.

기존 항목을 먼저 수정한 뒤 내용을 다시 가져와 중복 항목이 늘어나지 않도록 하세요. 반환된 내용의 형식, 업데이트 방식 또는 여러 구독 정리 방법을 확인하려면 구독 및 서버 관리 매뉴얼을 참고하세요. 완료한 뒤 이 페이지의 3단계로 돌아가 연결을 계속합니다.

스위치가 켜진 상태로 유지되지 않음

처리하지 않은 시스템 VPN 구성 안내가 남아 있는지, 기기 인증이 완료되었는지 확인하세요. 시스템 네트워크 설정에서 다른 VPN 구성이 활성화되어 있다면 현재 사용하는 구성이 무엇인지 먼저 확인한 뒤 Shadowrocket으로 돌아가 다시 시도합니다. 관리되는 기기라면 기기 관리 정책이 해당 구성을 제한하는지도 확인해야 합니다. 이 단계에서는 시스템 구성이 활성화되는지 해결하고 서버 비밀번호나 Rule은 바로 수정하지 마세요.

스위치는 켜졌지만 요청 시간이 초과됨

Home으로 돌아가 선택 표시를 확인하고 테스트하려는 서버가 선택되었는지 확인하세요. 이전 서버 항목이 선택되어 있을 수도 있습니다. 직접 입력한 항목이라면 Type, Host, Port, 인증 정보와 자료에 명시된 TLS 및 전송 옵션을 다시 확인합니다. 구독 항목이라면 원격에서 관리되는 여러 항목을 직접 수정하기보다 기존 구독 내용을 다시 가져오는 것이 우선입니다. 그런 다음 Proxy에서 같은 대상으로 테스트해 규칙과 무관하게 문제가 발생하는지 확인하세요.

보유한 다른 서버로 바꾸려면 기존 항목을 유지하고 한 번에 선택 항목 하나만 변경하세요. 필요한 경우 Wi-Fi와 셀룰러 네트워크를 한 번 비교하되 네트워크 변경을 기록해 두세요. 서버와 네트워크를 동시에 바꾸면 결과의 원인을 구분할 수 없습니다.

Proxy에서는 연결되지만 Config에서 일부 대상에 접속할 수 없음

현재 실제로 사용 중인 Config 파일과 Rule 순서를 확인하고, 대상이 예상한 PROXY 또는 DIRECT로 전달되는지 점검하세요. 도메인 규칙과 IP 주소 규칙은 일치 조건이 다르며, 대상이 해석된 뒤 연결되는 방식도 판단에 영향을 줄 수 있습니다. 처음 점검할 때 전체 구성을 다시 작성할 필요는 없습니다. 먼저 실패한 대상과 관련된 규칙을 찾고 그다음 대체 규칙을 확인하세요. 규칙 키워드, 일치 범위 및 구성 정리는 구독 매뉴얼의 구성 관련 설명을 참고하세요.

테스트 결과와 브라우저 동작이 일치하지 않음

Settings로 이동해 Test Method를 확인하고 현재 테스트 방식을 파악한 뒤 4단계의 실제 접속 결과와 비교하세요. Diagnostics에서 추가 진단 정보를 확인할 수 있지만 로그는 테스트 시간, 대상, 오류 내용을 함께 살펴봐야 합니다. 특정 단어 하나만으로 원인을 판단하지 마세요. 진단 내용을 공유하기 전에 구독 주소와 인증 매개변수 등 개인 정보를 삭제하세요. 구독 주소 전체를 공개적인 문제 해결 자료로 올려서는 안 됩니다.

On Demand는 조건에 따라 연결하는 동작과 관련이 있습니다. 네트워크 환경에 따라 연결 상태가 바뀐다면 관련 조건을 설정했는지 확인하세요. 동작을 이해하기 전에는 Proxy, TCP, UDP 등의 설정을 동시에 변경하지 마세요. 먼저 반복해서 확인할 수 있는 수동 연결 결과를 만든 뒤 자동 연결 설정을 점검합니다. Settings의 Language나 Today Widget은 서버 인증 오류를 해결하는 설정이 아닙니다.