공식 매뉴얼 / 문제 진단

Shadowrocket 문제 해결연결·구독·설정 진단

먼저 문제가 발생한 단계를 구분한 뒤 해당 설정을 확인하세요. 한 번에 한 가지 조건만 바꾸고 변경 전후 결과를 기록하면 권한, 서버, 규칙, DNS 문제를 구별하기 쉽습니다.

  • 권한 및 연결 스위치
  • 네트워크 및 서버
  • 구독 및 설정
  • 시스템 및 기기

이 페이지는 증상별로 찾아보는 공식 매뉴얼이며, 최초 설정 절차를 대신하지 않습니다. 아직 구독을 가져오거나 처음 연결하지 않았다면 빠른 시작 가이드를 먼저 확인하세요. Home, Config, Global Routing을 사용할 수 있지만 특정 단계에서 문제가 생겼다면 아래 항목에서 해당 증상을 찾아보세요. 가이드는 연결을 설정하는 방법을, 이 페이지는 실패 원인과 진단 방법 및 복구 범위를 설명합니다.

이 안내는 사용자가 이미 보유한 구독 또는 서버 정보를 전제로 합니다. 이 사이트는 서버나 구독을 제공·판매·추천하지 않습니다. 앱을 한 번 구매해도 회선 서비스가 포함되거나 계속 제공되는 것은 아닙니다. iPhone/iPad 버전은 App Store에서 $2.99에 일회성으로 구매할 수 있으며, Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료입니다. 다운로드 경로와 설치 허용 방법은 전체 플랫폼 다운로드를 확인하세요.

01 / 권한

연결 스위치가 켜지지 않거나 켜진 직후 꺼짐

스위치가 켜진 상태를 유지하지 못한다면 서버 비밀번호를 바꾸기 전에 시스템에서 네트워크 확장 또는 VPN 설정이 정상적으로 만들어졌는지 확인하세요. Home의 연결 스위치는 클라이언트가 해당 네트워크 트래픽을 처리하도록 요청하는 기능입니다. 시스템의 요청 승인, 확장 실행, 서버 연결은 각각 별개의 단계입니다. 스위치를 켜자마자 Not Connected로 돌아간다면 권한 단계에서 멈췄는지 연결 단계에서 멈췄는지 먼저 확인하세요. 시스템 권한 승인이나 인증 요청이 표시됐는지, 어떤 오류 문구가 나왔는지 기록하세요. ‘켜지지 않음’이라는 설명보다 원문 오류가 진단에 더 도움이 됩니다.

시스템 권한 및 설정 상태 확인

iPhone 또는 iPad에서 처음 연결할 때 시스템이 VPN 설정을 추가하도록 허용하고 안내에 따라 인증을 완료하세요. 당시 요청을 취소했다면 Shadowrocket으로 돌아와 다시 연결을 시도하세요. 스위치를 연달아 빠르게 누르지는 마세요. 그런 다음 시스템 Settings의 VPN 관리 화면에서 해당 설정이 있는지 확인하세요. 운영체제 버전에 따라 메뉴 이름이 조금 다를 수 있으므로 Settings에서 VPN을 검색해도 됩니다. 설정이 존재한다고 서버가 사용 가능하다는 뜻은 아니지만, 설정 자체가 만들어지지 않았다면 서버 지연 시간 테스트로 권한 확인을 대신할 수 없습니다.

기기가 학교나 회사에서 관리되는 경우, 관리 정책이 VPN 추가, 네트워크 설정 변경 또는 네트워크 확장 실행을 제한하는지 확인하세요. 관리 기기에서 버튼을 조작할 수 없는 문제는 개인 기기의 일시적 오류와 다릅니다. 제한 안내를 기록하고 기기 관리자에게 문의하세요. 관리 항목을 반복해서 삭제하지 마세요. 설정을 변경하려면 기기 잠금을 해제하라는 안내가 나오면 먼저 잠금을 해제한 뒤 앱을 전면에 두고 조작하세요. 잠긴 상태에서 발생한 오류를 설정 손상으로 오해하지 않도록 주의하세요.

다른 연결과의 충돌을 확인하고 시작 단계와 핸드셰이크를 구분하기

먼저 연결 중인 다른 VPN 세션과 같은 시스템 네트워크 경로를 사용하는 기능을 잠시 끈 다음 Shadowrocket을 테스트하세요. 목적은 라우팅에 영향을 주는 변수를 줄이는 것이지 모든 네트워크 도구를 삭제하는 것이 아닙니다. 다른 세션을 끈 뒤 스위치가 계속 켜져 있다면 설정을 하나씩 다시 활성화해 충돌 원인을 찾으세요. 시스템 상태 표시줄의 VPN 표시는 시스템 연결이 존재한다는 뜻일 뿐, 원하는 세션이 연결됐다는 보장은 아닙니다. 시스템 VPN 목록에서 이름과 연결 상태도 확인하세요.

스위치가 몇 초간 켜져 있다가 꺼진다면 오류가 서버 연결, 인증, 인증서 또는 설정 파싱 중 어느 문제를 가리키는지 살펴보세요. 서버 주소 오류와 시스템의 권한 거부는 해결 방법이 다릅니다. 전자는 서버 및 프로토콜 매개변수를 확인하고, 후자는 시스템 권한을 점검하세요. 스위치가 꺼졌다는 이유만으로 모든 서버를 삭제하지 마세요. 스위치는 정상적으로 켜지지만 웹사이트에 접속할 수 없다면 권한 단계에서 같은 작업을 반복하지 말고 다음 장으로 이동하세요.

  1. 연결을 끄고 현재 설정과 구독 기록을 보존하세요.
  2. Shadowrocket을 전면에 둔 채 시스템 안내를 완료한 다음 스위치 상태를 확인하세요.
  3. 오류 원문을 기록하세요. 스위치가 안정적으로 켜져 있다면 확인할 네트워크 요청을 하나 정해 테스트하세요.
  4. 시스템 설정에 문제가 있다고 확인된 경우에만 해당 VPN 설정을 제거하고 다시 승인하세요.

권한 재승인의 범위와 복구 방법

시스템 VPN 설정을 제거하기 전에 앱에 저장된 서버 정보와 Config 사본이 보존되어 있는지 확인하세요. 시스템 설정과 앱 내 규칙 파일은 서로 다른 항목입니다. 삭제하기 전에 현재 화면이 어디인지 확인해 구독 목록을 시스템 설정으로 착각해 지우지 않도록 하세요. Shadowrocket을 다시 열고 연결을 시도한 뒤 시스템 안내에 따라 설정을 추가하세요. 계속 실패한다면 기기를 재시동하고 같은 네트워크에서 한 번 더 테스트하세요. 재시동은 일시적으로 멈춘 시스템 확장을 확인하는 방법일 뿐, 기존 설정이 올바르다는 증거는 아닙니다.

Mac, Windows, Android, Linux에서는 먼저 앱이 정상적으로 실행되는지 확인한 뒤 해당 시스템의 네트워크 권한을 점검하세요. 앱을 처음 열기도 전에 문제가 발생했다면 다운로드 페이지의 설치 허용 안내를 따르세요. Windows는 파일 출처를 확인한 후 SmartScreen에서 ‘자세히 보기 → 실행’을 선택합니다. Mac은 ‘개인정보 보호 및 보안’에서 ‘그래도 열기’를 확인합니다. Android는 ‘알 수 없는 앱 설치’를 허용합니다. Linux는 설치 파일 형식과 실행 권한을 확인하세요. 설치 차단은 연결 실패와 다르며, 출처가 불분명한 파일은 허용하지 마세요.

02 / 라우팅

연결됨으로 표시되지만 웹사이트와 앱에서 인터넷에 접속할 수 없음

연결 스위치가 켜져 있다는 것은 시스템 연결이 만들어졌다는 뜻일 뿐, 모든 요청이 올바른 경로로 나간다는 의미는 아닙니다. ‘모든 곳에 접속할 수 없음’, ‘일부 도메인만 실패’, ‘브라우저는 되지만 특정 앱은 실패’를 나눠 기록하세요. 각 증상은 기본 네트워크, 서버 경로, 규칙 매칭, DNS 또는 앱 자체 동작과 관련될 수 있습니다. 평소 안정적으로 이용하고 현재 목적이 분명한 대상을 하나 골라 같은 동작을 반복하세요. 매번 다른 웹사이트를 열고 결과를 막연하게 비교하지 마세요.

연결을 끈 상태에서 기본 네트워크 확인

Shadowrocket을 끄고 현재 Wi-Fi 또는 셀룰러 네트워크로 평소 접속 가능한 페이지를 열어 보세요. 이때도 접속에 실패한다면 Wi-Fi 로그인 인증, 셀룰러 데이터 권한, 라우터 또는 시스템 네트워크 상태부터 확인하세요. 공용 Wi-Fi는 먼저 웹페이지에서 인증해야 할 수 있습니다. 연결 아이콘이 표시된다고 인증이 완료된 것은 아닙니다. VPN 연결을 끊은 상태에서 인증을 마친 뒤 Shadowrocket을 시작하세요. 인증 페이지 자체에 접속할 수 없다면 규칙을 바꿔 원인을 찾으려 하지 마세요.

기본 네트워크가 정상이라면 기존 서버와 설정을 다시 사용해 Home에서 실제로 원하는 SERVER가 선택됐는지 확인하세요. 이름이 비슷한 항목이 여러 개라면 표시 이름만 보지 말고 주소나 구독 출처를 확인하세요. 방금 테스트에 성공한 서버가 다음 연결에서도 자동 선택되는 것은 아닙니다. 선택 정책을 사용한다면 최종적으로 어느 사용 가능한 항목을 가리키는지도 확인하세요. 정책 이름을 고정 서버로 착각하면 테스트 전후를 제대로 비교할 수 없습니다.

Global Routing 세 가지 모드로 비교 테스트

원래 Global Routing 모드를 기록한 뒤 진단을 위해 잠시 다른 모드로 전환하세요. Config는 현재 설정의 규칙에 따라 트래픽을 처리합니다. Proxy는 해당 트래픽을 선택된 프록시 경로로 보냅니다. Direct는 직접 연결을 비교하는 데 사용합니다. 이 전환은 영구적인 사용 권장 사항이 아니라 규칙 문제와 서버 문제를 구분하기 위한 것입니다. 테스트가 끝나면 원래 모드로 되돌리세요. 진단 중 임시로 선택한 Proxy를 일상 설정으로 남겨두지 않도록 특히 주의하세요.

모드주요 비교 목적결과에 따른 다음 확인 항목
설정 / Config현재 규칙이 실제로 어떻게 작동하는지 확인이 모드에서만 실패하면 규칙 순서와 정책 확인
프록시 / Proxy규칙에 따른 분기 차이 줄이기이 모드에서도 실패하면 서버, 인증, DNS 확인
직접 연결 / Direct대상의 직접 네트워크 경로 확인이 모드에서도 실패하면 기본 네트워크와 대상 서비스 확인

Proxy에서는 접속되지만 Config에서는 안 된다면 대상에 어떤 규칙이 적용됐는지, 해당 규칙이 가리키는 정책이 있는지 확인하세요. 규칙은 보통 순서대로 매칭되므로 앞쪽의 포괄적인 항목이 뒤쪽의 구체적인 항목을 가릴 수 있습니다. 아래 예시는 순서를 설명하기 위한 조각이며, 가져와서 바로 사용할 수 있는 완전한 설정이 아닙니다. 실제 설정에서 PROXY에 해당하는 정책이 정의되어 있는지 확인하세요. 규칙을 복사하는 것만으로 연결 경로가 사용 가능해지는 것은 아닙니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

요청 하나를 기준으로 범위 좁히기

특정 앱에서만 문제가 발생하면 브라우저에서 같은 서비스의 공개 페이지를 연 뒤 앱 로그인, 콘텐츠 로드, 업로드 등 동작별로 비교하세요. 페이지는 열리지만 로그인이 실패한다면 인증, 시간 설정 또는 서버 측 보안 정책 문제일 수 있습니다. 이미지 로드 실패는 다른 도메인에서 비롯될 수도 있으므로 첫 페이지의 도메인에만 규칙을 추가하지 마세요. 요청 기록에서 실제로 실패한 도메인과 적용된 정책을 확인하세요. 성공한 요청을 오류의 증거로 오해하지 않도록 주의하세요.

네트워크를 바꾼 뒤 정상 작동한다면 두 네트워크에서 같은 설정을 사용한 결과를 저장하고 로컬 네트워크 제한 및 DNS 차이를 확인하세요. 모든 네트워크에서 실패할 때 서버나 설정 점검을 집중적으로 진행하세요. 설정을 변경할 때마다 요청을 새로 보내고, 필요하면 기존 연결을 종료한 뒤 테스트하세요. 기존 장시간 연결에는 새 규칙이 즉시 적용되지 않을 수 있습니다. 전체 가져오기 및 연결 순서는 Config 설정 가이드에서, 프로토콜 관련 내용은 프로토콜 질문과 답변에서 확인하세요.

03 / 서버 및 전송 계층

서버 연결 시간 초과, 간헐적 연결 실패 및 속도 저하

Timeout은 기다리는 시간 안에 특정 단계에서 예상한 응답을 받지 못했다는 뜻입니다. 비밀번호가 반드시 틀렸거나 서버가 반드시 중단됐다는 의미는 아닙니다. 지연 시간 테스트, 프로토콜 핸드셰이크, 실제 웹페이지 접속은 서로 다른 방식으로 수행될 수 있으므로 결과를 각각 기록하세요. 단일 서버만 시간 초과되는지, 같은 구독의 모든 서버가 시간 초과되는지, 특정 네트워크에서만 발생하는지 먼저 확인하세요. 증상을 구체적으로 나누면 로컬 네트워크, 구독 매개변수, 원격 서비스 중 어디를 확인할지 판단하기 쉽습니다.

테스트 실패와 실제 서비스 이용 실패 구분하기

Connectivity Test를 실행할 때는 테스트 대상과 방식을 확인한 뒤 브라우저에서 실제 요청도 보내 보세요. 일부 서버는 특정 탐색 요청에 응답하지 않아도 정상적인 프록시 연결은 처리할 수 있습니다. 반대로 탐색에 성공해도 이후 대상까지의 경로가 정상이라는 보장은 없습니다. 지연 시간 숫자를 다운로드 속도로 간주하거나 한 번의 테스트로 서버 상태를 장기간 판단하지 마세요. 같은 조건에서 여러 번 측정한 결과가 안정적인지가 단 한 번의 수치보다 중요합니다.

설정을 그대로 둔 채 Wi-Fi와 셀룰러 네트워크를 바꿔 같은 서버를 테스트하세요. Wi-Fi에서만 실패하면 라우터, 공용 네트워크 제한, DNS를 확인하세요. 셀룰러에서만 실패하면 앱의 셀룰러 데이터 권한과 현재 데이터 네트워크 상태를 확인하세요. 테스트에는 데이터가 사용되므로 특히 대용량 파일을 전송하기 전에 데이터 한도를 확인하세요. 사용 가능하다고 확인된 다른 서버가 있다면 비교 대상으로 활용할 수 있지만, 문제 해결을 위해 출처를 모르는 항목을 가져오지는 마세요.

프로토콜별 매개변수 확인

서버 주소, 포트, 인증 정보부터 확인하고, TLS, SNI, 전송 방식, 경로를 이어서 확인하세요. 가져오기에 성공했다는 것은 클라이언트가 내용을 인식했다는 뜻일 뿐, 모든 필드가 서버와 일치한다는 뜻은 아닙니다. 서버 주소를 모든 이름 필드에 그대로 넣거나 포트가 같다는 이유로 전송 방식까지 같다고 단정하지 마세요. 자신의 서비스 제공업체가 안내한 원본 정보와 항목별로 비교하고, 수정하기 전에 기존 기록을 보존하세요.

프로토콜 또는 기능중점적으로 확인할 항목자주 하는 오해
Shadowsocks주소, 포트, 암호화 방식, 비밀번호암호화 방식은 확인하지 않고 비밀번호만 수정
VMess / VLESS인증 필드, 전송 방식, TLS 및 관련 매개변수프로토콜 이름이 같으면 나머지 필드도 공통이라고 판단
Trojan인증 정보, TLS, SNI연결 주소와 인증서 이름을 혼동
Hysteria2 / WireGuardUDP 연결 가능 여부와 각 프로토콜의 인증 및 키 매개변수일반 웹페이지에 접속되므로 UDP도 작동한다고 판단

인증서 관련 오류가 발생하면 먼저 기기의 날짜, 시간, 시간대가 정확한지 확인한 뒤 서버 인증서 이름과 SNI를 점검하세요. 인증서 검증을 끄는 것을 일반적인 해결책으로 사용하지 마세요. 이름 불일치, 인증서 이상 또는 잘못된 연결 대상을 감출 수 있습니다. 서비스 제공업체가 연결 매개변수를 변경했다면 자신의 구독을 먼저 업데이트한 뒤 새 항목과 기존 항목을 비교하세요. 경험에 따라 필드를 임의로 채우지 마세요.

속도 문제는 측정 단계별로 나눠 확인하기

연결 설정 지연, 첫 화면 표시 지연, 다운로드 지속 속도 저하는 서로 다른 병목일 수 있습니다. 연결 설정 지연은 DNS나 핸드셰이크 단계에서 발생할 수 있고, 첫 화면 지연은 대상 사이트나 여러 보조 도메인과 관련될 수 있습니다. 지속적인 다운로드 저하는 로컬 대역폭, 서버 부하, 원격 경로의 영향을 받습니다. 같은 대상과 파일을 비슷한 시간대에 비교하면서 매번 서버나 네트워크 중 한 가지 조건만 바꾸세요. 백그라운드 시스템 업데이트와 클라우드 동기화도 함께 살펴보세요.

작은 페이지는 정상인데 큰 파일 전송이 자주 멈춘다면 특정 네트워크나 전송 방식에서만 발생하는지 기록한 뒤 자신의 서비스 제공업체에 서버 측 상태를 문의하세요. 근거 없이 MTU나 동시 연결 매개변수를 바꾸지 마세요. 잘못 설정하면 문제가 더 커질 수 있습니다. 원래 값으로 복원했을 때 문제가 다시 안정적으로 재현되는지도 매개변수의 영향을 판단하는 데 필요합니다. 문의할 때 실패 시간, 네트워크 종류, 오류 원문, 민감 정보를 가린 매개변수를 제공하세요. 전체 비밀번호나 개인 키는 보내지 마세요.

04 / 구독 데이터

구독 가져오기 또는 업데이트 실패, 목록이 바뀌지 않음

구독 업데이트는 ‘내용 가져오기’와 ‘내용 파싱’ 두 단계로 이뤄집니다. 첫 번째 단계는 구독 주소 접속 가능 여부, 인증, 서버 응답과 관련되고, 두 번째 단계는 형식, 프로토콜 필드, 클라이언트의 인식 여부와 관련됩니다. 오류가 다운로드 단계에서 발생했는지 가져오기 단계에서 발생했는지 확인하세요. 연결 시간 초과, 인증 실패, 빈 응답, 형식 오류는 각각 다른 방식으로 해결해야 합니다. 사용자가 보유한 구독 주소에는 접근 인증 정보가 포함되는 경우가 많으므로 전체 주소를 공개 스크린샷, 채팅 기록, 브라우저 동기화 메모에 넣지 마세요.

가져온 내용이 웹페이지가 아닌 구독 데이터인지 확인

자신의 서비스 제공업체 계정 페이지에서 구독 주소를 다시 복사하세요. 안내 페이지, 관리 화면, 공유 페이지의 주소를 복사하지 않도록 주의하세요. 복사한 주소 앞뒤에 공백, 줄바꿈, 한글 문장부호가 섞이지 않았는지 확인하세요. 특히 메신저가 자동으로 줄을 바꾼 경우 주소가 온전히 복사됐는지 살펴보세요. 주소 매개변수는 인증에 사용될 수 있으므로 표시를 짧게 만들려고 임의로 삭제하면 안 됩니다. QR 코드 인식에 성공해도 내용이 클라이언트에서 사용할 구독 형식이라는 보장은 없습니다.

인증 실패 또는 링크 만료 오류가 나오면 서비스 제공업체 계정에서 구독이 초기화되었는지, 만료되었는지, 접근 조건이 있는지 먼저 확인하세요. 초기화된 이전 주소는 즉시 사용할 수 없게 될 수 있으며, 클라이언트에서 반복 업데이트해도 만료된 인증 정보가 복구되지는 않습니다. 로그인 또는 인증 페이지가 반환된다면 서버 목록이 아닌 다른 내용을 가져온 것입니다. 올바른 구독 주소를 확인하세요. 웹페이지 내용을 몇 줄의 주소로 직접 바꿔 완전한 구독처럼 사용하지 마세요.

가져오기 경로 확인 및 기존 목록 보존

일부 구독 주소는 현재 직접 연결에서는 접속되지 않지만 기존에 사용할 수 있는 연결에서는 가져올 수 있습니다. 반대 상황도 가능합니다. 원래 연결 상태를 기록한 뒤 연결을 끊었을 때와 사용 가능하다고 확인된 연결을 사용할 때의 업데이트 결과를 각각 비교하세요. 해당 구독을 업데이트해야 복구할 수 있는 만료 서버를 구독 가져오기 경로로 사용하지 마세요. 문제 해결이 순환될 수 있습니다. 모든 서버가 작동하지 않는다면 자신의 서비스 제공업체에 구독 주소와 서버 상태를 먼저 문의하세요.

업데이트 실패 시 기존 목록을 보존하고 구독 전체를 먼저 삭제하지 마세요. 기존 항목이 여전히 연결된다면 문제가 구독 인터페이스에만 있는지, 서버 자체도 사용 불가능한지 구분하는 데 도움이 됩니다. 업데이트가 완료되면 서버 개수와 항목 필드를 확인하세요. 개수가 같다고 업데이트되지 않았다고 단정하지 마세요. 이름은 그대로여도 주소, 인증, 전송 매개변수가 바뀌었을 수 있습니다. 반대로 목록 개수가 늘어도 새 항목이 연결된다는 보장은 없습니다.

파싱 오류와 덮어쓰기 범위 구분하기

내용을 가져왔지만 파싱에 실패한다면 서비스 제공업체가 제공하는 형식과 선택한 가져오기 방식이 일치하는지 확인하세요. Add Server, Subscribe, Scan QR Code, Import from Cloud JSON은 서로 다른 유형의 내용을 대상으로 하며, 전체 설정 파일, 단일 연결 정보, 구독 주소를 같은 입력으로 취급할 수 없습니다. 알맞은 메뉴에서 사본을 먼저 가져와 결과를 확인한 뒤 기존 항목을 교체하세요. 자세한 절차는 구독 가져오기 가이드를 확인하세요.

구독의 개별 항목을 직접 수정했다면 다음 업데이트에서 서비스 제공업체의 매개변수로 덮어써질 수 있습니다. 임시 수정 내용을 보존해야 한다면 별도의 항목으로 저장하고 구분하기 쉽게 이름을 지정한 뒤 서비스 제공업체에 원본 정보를 확인하세요. 업데이트할 때마다 수동으로 다시 수정하는 방식에 계속 의존하지 마세요. 일부 항목이 사라졌다면 필터 조건과 그룹 표시를 확인하고, 구독 응답에 해당 항목이 실제로 포함됐는지도 확인하세요. 표시 필터 문제를 데이터 손실로 오해하지 않도록 주의하세요.

재시도 사이에 간격을 두세요. 연속해서 버튼을 눌러도 인증이나 형식 문제는 해결되지 않으며, 인터페이스 접근 제한이 발생할 수도 있습니다. 문제를 정리할 때 실패 단계, 오류 원문, 당시 네트워크, 연결 활성화 여부를 기록하고 민감 정보를 가린 주소 구조만 제공하세요. 로그를 요청받으면 구독 인증 정보, 서버 비밀번호, 개인 도메인이 포함되어 있는지 먼저 확인하세요. 구독의 사용 가능 여부는 해당 서버에서 결정되며, 앱 구매 상태가 구독 계정 상태를 대신하지 않습니다.

05 / 이름 해석

DNS 오류, 도메인 접속 실패 및 규칙 매칭 문제

DNS는 도메인 이름을 연결에 필요한 주소로 변환합니다. 서버에 연결되지만 특정 도메인이 열리지 않는다면 이름 해석에 실패했거나, 해석은 성공했지만 이후 대상 연결이 실패했을 수 있습니다. 브라우저의 오류 문구만으로는 두 경우를 구분하기 어렵습니다. 실패한 도메인, 발생 시각, Global Routing 모드를 기록한 뒤 요청 또는 진단 기록에 이름 해석 오류가 있는지 확인하세요. 페이지가 빈 화면으로 보인다고 DNS 주소를 바로 더 추가하지 마세요. 여러 설정을 동시에 바꾸면 이후 결과를 해석하기 어렵습니다.

DNS 해석 실패와 대상 연결 거부 구분하기

기록에 주소를 가져오지 못했다고 표시되면 DNS 서버에 연결할 수 있는지, 사용 중인 전송 방식이 현재 네트워크에 의존하는지, 관련 설정이 적용됐는지 확인하세요. 주소를 가져왔지만 이후 연결이 시간 초과된다면 라우팅, 출구 경로, 대상 서비스를 계속 점검하세요. HTTPS 주소를 대상 IP로 바꾸는 것을 유일한 판별 방법으로 사용하지 마세요. HTTPS에는 도메인, 인증서, 서버 이름이 필요하므로 IP 직접 접속 실패만으로 DNS가 정상인지 비정상인지 결론 내릴 수 없습니다.

같은 도메인이 Wi-Fi와 셀룰러에서 다르게 동작한다면 서버와 설정을 그대로 둔 채 두 네트워크를 비교하세요. 로컬 네트워크 내부의 이름만 실패한다면 현재 라우터나 조직 내부 DNS에서 해당 이름을 해석해야 하는지 확인하세요. 공용 DNS 서비스는 보통 사설 로컬 네트워크의 기기 이름을 알지 못합니다. 모든 요청을 같은 원격 DNS 경로로 보내면 외부 접속은 해결되지만 내부 서비스가 작동하지 않을 수 있습니다. 내부 도메인은 해당 네트워크의 설정에 맞게 처리하고 일반 주소를 무조건 적용하지 마세요.

DNS 설정과 규칙 순서가 만나는 지점 확인하기

Config에서 현재 사용 중인 파일을 확인한 뒤 DNS 관련 설정을 살펴보세요. 활성화되지 않은 사본을 편집하지 않도록 주의하세요. 시스템 DNS, 설정 파일의 DNS, 암호화된 DNS 설정이 있다면 각각 기록하고 현재 요청을 어느 항목이 처리하는지 확인하세요. 설정 화면에 주소가 보인다고 해서 모든 주소가 동시에 적용된다고 가정하지 마세요. 시스템에서 수행하는 이름 해석과 프록시 서버 쪽 이름 해석도 혼동하지 마세요. 처리 경로에 따라 결과 주소가 달라질 수 있으므로 실제 요청 기록을 기준으로 판단하세요.

규칙은 가장 먼저 매칭될 수 있는 항목부터 확인하세요. DOMAIN은 정확한 도메인, DOMAIN-SUFFIX는 도메인 접미사, IP-CIDR과 GEOIP는 주소 조건을 대상으로 하며 FINAL은 앞에서 매칭되지 않은 요청을 처리합니다. 주소 조건은 DNS 해석 결과와 관련될 수 있으므로 같은 대상이라도 DNS가 바뀌면 이후 트래픽 분기 결과가 달라질 수 있습니다. 아래 내용은 규칙 유형만 보여 주며 완전한 정책 정의가 포함되어 있지 않습니다. 현재 사용 중인 설정을 그대로 대체하는 데 사용할 수 없습니다.

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

특정 도메인이 PROXY로 처리되어야 하는데 포괄적인 DIRECT 항목에 먼저 매칭된다면, 파일 끝에 같은 도메인을 계속 추가하지 말고 규칙의 위치나 조건을 조정하세요. 앱 요청의 실제 도메인이 예상과 같은지도 확인하세요. 로그인, 이미지, API, 푸시는 서로 다른 도메인을 사용할 수 있습니다. 웹페이지 주소 표시줄만으로 백그라운드 요청을 모두 파악할 수는 없습니다. 실패 기록에서 확인할 대상을 찾아보세요.

캐시, IPv6 및 복구 테스트

DNS를 변경한 뒤에도 기존 연결이나 캐시가 결과에 영향을 줄 수 있습니다. 설정을 보존하고 연결을 끊었다가 다시 연결한 뒤 대상 요청을 새로 보내세요. 필요한 경우 대상 앱도 종료했다가 다시 여세요. 새 요청이 발생하기 전에 진단 페이지를 새로 고친 것만으로 설정이 적용되지 않았다고 판단하지 마세요. 기기를 재시동하면 일부 캐시와 세션 요인을 제거할 수 있지만, 재현 조건을 잃지 않도록 원래 결과를 기록한 뒤에 진행하세요.

일부 네트워크에서만 IPv6 관련 연결 오류가 발생한다면 기록에 나타난 IPv4 및 IPv6 주소와 현재 설정이 각 주소 유형을 처리하는 방식을 비교하세요. 시간 초과가 발생했다고 IPv6를 영구적으로 끄지 마세요. IPv6를 켜면 항상 더 빨라지는 것도 아닙니다. 특정 주소 유형과 오류가 안정적으로 연관되는지 확인한 뒤 짧게 비교 테스트하고 완료 후 원래 값으로 복원하세요. 라우터나 조직 네트워크의 DNS 정책은 네트워크 관리자에게 확인하고 관리 설정을 임의로 덮어쓰지 마세요.

06 / 백그라운드 및 연결 정책

백그라운드 배터리 소모, 발열 및 On Demand 반복 연결

배터리 소모를 진단할 때는 먼저 시스템 배터리 통계를 확인한 다음 Shadowrocket이 주요 원인인지 판단하세요. 배터리 화면의 비율은 통계 기간 중 앱별 상대 소비량을 나타내며 배터리 전체 용량이 같은 비율로 줄었다는 뜻은 아닙니다. 기기를 사용한 시간이 짧으면 특정 백그라운드 활동의 비율이 높게 보일 수 있습니다. 대표적인 관찰 시간을 정하고 화면 사용량, 네트워크 종류, 신호 세기, 백그라운드 다운로드를 기록하세요. 앱을 막 연 직후의 짧은 측정값만으로 결론 내리지 마세요.

비교 가능한 관찰 조건 만들기

시스템 Settings의 배터리 화면에서 Shadowrocket의 전면 및 백그라운드 활동을 확인한 뒤 같은 시간대의 브라우저, 동영상 재생, 클라우드 동기화, 시스템 작업과 비교하세요. 시스템 VPN 경로를 이용하는 트래픽이 항상 클라이언트에서 직접 시작되는 것은 아닙니다. 다른 앱이 백그라운드에서 계속 데이터를 전송하면 네트워크 확장이 계속 작동할 수 있습니다. Data 페이지의 트래픽 기록으로 활성 대상을 파악할 수 있지만, 트래픽 양과 배터리 소모가 일정한 비율로 대응하는 것은 아닙니다. 연결 횟수, 무선 신호, 기기 온도도 함께 확인하세요.

확실히 식별할 수 있는 대량의 백그라운드 전송부터 잠시 중지한 뒤 문제가 계속되는지 관찰하세요. 신호가 약한 셀룰러 환경에서만 발열이 발생한다면 모바일 네트워크 재연결과 무선 송신이 주요 요인일 수 있습니다. 안정적인 Wi-Fi에서도 계속 발생한다면 클라이언트 연결 정책을 확인하세요. 테스트 중 화면 밝기와 사용 방식, 네트워크를 비슷하게 유지하세요. 충전하면서 대용량 파일을 다운로드하는 상황을 대기 상태와 직접 비교하지 마세요.

On Demand는 일률적인 절전 스위치가 아닙니다

On Demand는 설정 조건에 따라 연결을 시작합니다. 활성화한다고 반드시 배터리가 절약되는 것도 아니고, 비활성화한다고 항상 안정적인 것도 아닙니다. 조건이 평소 네트워크 전환 방식과 맞지 않으면 Wi-Fi, 셀룰러 또는 화면을 깨울 때마다 연결을 반복해서 시도할 수 있습니다. 화면을 잠근 뒤, Wi-Fi에서 벗어난 뒤, 특정 네트워크에 접속한 뒤, 특정 앱을 연 뒤 중 언제 연결되는지 기록하세요. 발생 시점과 설정 조건을 대응해 보면 반복 실행 여부를 판단하기 쉽습니다.

관찰을 위해 연결을 끌 때는 On Demand가 곧바로 다시 연결을 만들지 먼저 확인하세요. 자동 연결 조건을 그대로 둔 채 Home 스위치만 누르면 스위치가 작동하지 않는 것처럼 보일 수 있습니다. 짧은 시간 On Demand를 비활성화한 뒤 같은 네트워크와 비슷한 사용 방식으로 관찰하고, 원래 설정을 복원해 결과를 비교하세요. 이 테스트는 자동 실행 요인을 분리하기 위한 것이며 모든 사용자가 장기간 비활성화해야 한다는 뜻은 아닙니다. 자동 연결이 필요하다면 실제 네트워크 조건에 맞게 규칙을 정리하세요.

  1. 기존 On Demand 조건과 현재 연결 상태를 기록하세요.
  2. 자동 연결을 잠시 중지하고 안정적인 연결을 한 번 수동으로 설정하세요.
  3. 연결이 계속 끊겼다 다시 이어지는지, 네트워크가 중단되는지, 비정상적인 백그라운드 활동이 있는지 확인하세요.
  4. 조건을 하나씩 다시 활성화해 어떤 조건이 이상 동작과 함께 나타나는지 확인하세요.

반복 연결에서 서버와 네트워크 문제 추적하기

자동 연결을 꺼도 수동 연결이 자주 끊긴다면 배터리 옵션만 계속 조정하지 말고 서버, 네트워크, DNS 관련 항목으로 돌아가세요. 서버 연결 불안정, 인증 실패, 이름 해석 시간 초과 때문에 클라이언트가 연결을 반복해서 시도할 수 있습니다. 백그라운드 배터리 소모가 별도의 성능 문제가 아니라 연결 오류의 결과일 수도 있습니다. 먼저 안정적으로 유지되는 연결을 복구한 뒤 대기 중 영향을 평가하는 편이 원인을 찾기 쉽습니다.

특정 Wi-Fi에서만 연결이 반복된다면 주기적인 인증이 필요한지, 유휴 상태에서 연결이 끊기는지, 기기가 액세스 포인트를 자주 바꾸는지 확인하세요. 저전력 모드, 앱의 백그라운드 동작, 네트워크 정책도 관찰 결과를 바꿀 수 있으므로 함께 기록하세요. 측정값을 낮추려고 필요하지 않은 시스템 보호를 끄지 마세요. 장시간 연결이 필요한 작업이라면 테스트 중 관련 백그라운드 작업을 유지했는지 기록하세요.

임시로 켠 상세 로그와 대량의 진단 테스트는 완료 후 평소 상태로 되돌리세요. 진단 과정 자체가 지속적인 작업 부하를 만들지 않도록 해야 합니다. 문제가 계속 재현된다면 네트워크 하나, 서버 하나, 명확한 On Demand 상태, 반복 가능한 동작 하나로 상황을 단순화하세요. 트래픽 패널은 Data 페이지 통계 안내를, 연결 정책은 On Demand 및 백그라운드 배터리 문제 해결을 확인하세요.

07 / 업데이트 및 복구

앱 또는 시스템 업데이트 후 기존 설정에 문제가 발생함

‘업데이트 후 발생했다’는 시간적 연관성을 뜻할 뿐, 업데이트가 직접 원인임을 입증하지는 않습니다. 앱 또는 시스템 업데이트, 구독 새로 고침, 규칙 수정, 서버 매개변수 변경이 비슷한 시기에 이뤄졌을 수 있습니다. 최근 실제로 변경한 항목을 먼저 나열하고 보존한 설정 사본으로 다시 테스트하세요. 앱 재설치, 구독 재가져오기, DNS 변경을 동시에 하지 마세요. 문제가 해결되더라도 무엇이 영향을 줬는지 알 수 없으며 다음에 같은 문제가 생겼을 때 참고할 근거도 남지 않습니다.

현재 상태를 보존한 뒤 사용 중인 항목 확인하기

현재 Config, 서버 정보, 오류 원문을 보존하고 업데이트 후에도 기존 서버와 설정 파일이 선택되어 있는지 확인하세요. 목록 순서, 그룹, 이름이 바뀌어 다른 항목을 선택했는데도 기존 설정이 작동하지 않는 것처럼 보일 수 있습니다. 자동 선택 정책을 사용한다면 최종 선택 항목을 확인하세요. 로컬 수정 사항이 있다면 구독 업데이트 후 원격 내용으로 덮어써졌는지도 비교하세요. 모든 설정을 기본값으로 되돌리기 전에 실제 사용 중인 항목을 확인하는 편이 효과적입니다.

앱 실행 실패, 연결 스위치가 유지되지 않는 문제, 서버 핸드셰이크 실패, 일부 규칙이 적용되지 않는 문제를 구분하세요. 앱은 열리지만 연결 권한이 다시 요청되면 시스템 안내에 따라 승인한 뒤 첫 번째 장을 확인하세요. 스위치는 켜진 상태를 유지하지만 접속에 실패한다면 라우팅 및 서버 장을 확인하세요. 시스템 업데이트 후 네트워크 확장이 일시적으로 비정상이라면 기기를 재시동하고 같은 조건에서 다시 테스트할 수 있습니다. 단, 재시동 전에 기존 안내를 기록해 유일한 오류 정보를 잃지 않도록 하세요.

최소 설정으로 호환성 및 참조 문제 확인하기

사본에서 불필요한 규칙과 정책을 줄이고 매개변수를 확인한 서버 하나만 남겨 기본 연결을 테스트하세요. 최소 설정은 복잡한 정책 참조나 특정 설정 항목이 원인인지 판단하는 데 도움이 됩니다. 모든 분기 규칙을 영구적으로 삭제하라는 뜻은 아닙니다. 기본 연결이 되면 규칙을 그룹별로 복원하고 저장한 뒤 새 요청을 보내 확인하세요. 특정 그룹을 복원한 뒤 다시 실패한다면 해당 그룹의 조건과 정책 이름을 더 살펴보세요.

설정 파싱 오류는 문제가 발생한 행과 필드에 따라 처리하세요. 정책 이름 변경, 존재하지 않는 그룹 참조, 잘못된 섹션 위치, 붙여넣기 과정에서 들어간 숨은 문자로 인해 파일이 예상대로 불러와지지 않을 수 있습니다. 현재 활성화된 파일을 편집했는지, 저장이 완료됐는지 먼저 확인하세요. 이전 파일 전체를 새 환경에 바로 덮어쓴 뒤 백업을 삭제하지 마세요. 이전 내용 자체의 문제와 이전 과정에서 생긴 변화를 구분하려면 두 파일을 모두 보존해야 합니다.

앱을 다시 받아야 할 때의 경로와 설치 허용

iPhone/iPad에서는 App Store에서 업데이트하거나 다시 다운로드하세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 개발자 Shadow Launch Technology Limited, 공식 아이콘, 앱 ID 932747118을 확인하세요. Mac, Windows, Android, Linux 버전의 업데이트 방법은 전체 플랫폼 다운로드에서 확인할 수 있습니다. 설치 파일은 이 사이트의 /dl/shadowrocket/ 경로에서만 제공합니다. 출처가 불분명한 동명의 프로그램을 받아 현재 앱 위에 설치하지 마세요.

데스크톱 또는 Android에서 처음 실행하거나 앱을 교체한 뒤 시스템 차단 안내가 다시 나타날 수 있습니다. Windows는 파일 출처를 확인한 뒤 ‘자세히 보기 → 실행’을 선택하세요. Mac은 ‘개인정보 보호 및 보안 → 그래도 열기’를 확인하세요. 앱이 손상되었다는 안내가 명확히 표시되면 다운로드 페이지에서 경로를 확인한 후 확장 속성을 처리하세요. Android는 실제 설치 파일을 연 앱에 설치 권한을 부여하세요. Linux는 배포판에 맞는 설치 형식을 선택하고 AppImage에는 실행 권한을 부여해야 합니다. 관리 기기의 제한은 관리자에게 문의하세요.

앱을 다시 받기 전에 백업을 실제로 복원할 수 있는지 확인하세요. 서버 이름의 스크린샷만으로는 인증 필드를 복구하기 어렵고 구독 이름만 저장해 두어도 전체 주소를 대신할 수 없습니다. 백업은 자신이 관리하는 안전한 위치에 보관하고 공개 공간에 올리지 마세요. 업데이트 전후 동일한 설정에서 동작 차이가 계속 재현된다면 재현 절차, 오류 문구, 시스템 환경, 민감 정보를 가린 설정 일부를 전달하세요. 전체 접속 기록은 문제와 관계없는 개인 정보가 포함될 수 있으므로 첨부하지 마세요.

08 / iPad 환경

iPad 가로 모드, 기기 교체 및 네트워크 전환 점검

iPad도 앞에서 설명한 순서대로 시스템 권한, 기본 네트워크, 서버, 규칙, DNS를 확인하면 됩니다. 추가로 가로 모드와 멀티태스킹 화면 배치, Wi-Fi 전용 모델과 셀룰러 모델의 차이, 키보드 입력, 다른 기기에서 설정을 옮긴 뒤의 구성 완전성을 살펴보세요. 같은 구독을 iPhone에서 사용할 수 있다고 해서 iPad의 현재 네트워크와 선택한 서버를 확인하지 않아도 되는 것은 아닙니다. 두 기기의 연결 조건은 다를 수 있습니다.

가로 모드 및 멀티태스킹에서 조작 대상 확인

가로 모드에서는 목록과 상세 화면이 동시에 표시될 수 있습니다. 항목을 눌러 편집 화면에 들어간 것이 현재 연결 서버로 선택됐다는 뜻은 아닙니다. 편집을 마치면 Home으로 돌아가 선택 상태와 실제 연결 대상을 확인한 뒤 테스트하세요. 멀티태스킹이나 화면 분할 중 버튼 전체가 보이지 않는다면 Shadowrocket을 더 넓은 창이나 전체 화면으로 전환한 뒤 가져오기와 저장을 진행하세요. 화면 공간이 부족한 문제를 기능이 사라진 것으로 오해하지 않도록 주의하세요.

외장 키보드로 구독 주소를 붙여넣을 때 입력란에 포커스가 있는지, 내용이 빠짐없이 들어갔는지, Enter 키를 잘못 눌러 제출하지 않았는지 확인하세요. 좁은 입력란에서 긴 주소의 일부가 보이지 않아도 문자열이 잘린 것은 아닙니다. 화면에 보이는 길이가 아니라 주소의 처음과 끝, 매개변수를 확인하세요. 설정 일부를 복사할 때는 영문 문장부호와 실제 줄바꿈을 유지하세요. 텍스트 편집 도구가 쉼표, 따옴표, 하이픈을 자동으로 바꾸지 않도록 주의하세요. 저장 후 해당 항목을 다시 열어 수정 내용이 반영됐는지 확인하세요.

두 기기 비교 시 네트워크와 설정 조건 통일하기

iPhone과 iPad를 비교할 때는 먼저 두 기기를 같은 Wi-Fi에 연결하고, 같은 서버와 Global Routing 모드를 사용해 같은 대상을 테스트하세요. 이 조건에서 iPad만 실패한다면 시스템 VPN 권한, 현재 Config, DNS, On Demand를 비교하세요. 한 기기는 셀룰러, 다른 기기는 공용 Wi-Fi를 사용하는 상태에서 차이를 기기 모델 탓으로 단정하지 마세요. 비교 조건이 같아야 결과로 원인을 찾을 수 있습니다.

Wi-Fi 전용 모델은 자신이 사용할 수 있는 핫스팟을 두 번째 네트워크로 비교 테스트할 수 있습니다. 핫스팟에도 상위 네트워크와 데이터 한도가 있으므로 테스트가 실제로 어떤 경로를 거쳤는지 기록하세요. 셀룰러를 지원하는 iPad는 앱의 셀룰러 데이터 권한, 데이터 연결 상태, Wi-Fi로 전환할 때의 결과를 확인하세요. Wi-Fi를 벗어난 뒤 연결이 끊기면 기본 네트워크 전환이 완료됐는지 먼저 확인한 후 Shadowrocket이 다시 연결되는지 살펴보세요. 네트워크가 준비되기 전의 순간적인 실패를 지속적인 오류로 오해하지 마세요.

화면을 잠갔다가 앱을 다시 열 때 잠시 로딩이 표시되는 것은 기존 세션 복구, 네트워크 전환 또는 대상 앱의 복귀와 관련될 수 있습니다. 앱이 복구된 뒤 요청을 자동으로 다시 보내는지, Home의 연결 상태가 실제로 바뀌었는지 기록하세요. 특정 앱만 새로 고쳐야 한다면 해당 앱의 세션을 확인하세요. 시스템 연결이 반복해서 끊긴다면 연결 스위치와 On Demand 항목을 다시 살펴보세요. 공용 Wi-Fi를 사용한다면 절전 후 재인증이 필요한지도 확인하세요.

구매 항목 다시 받기와 설정 이전을 따로 확인

iPhone/iPad 버전은 App Store에서 $2.99에 일회성으로 구매할 수 있으며, Mac, Windows, Android, Linux 버전은 무료입니다. iPad에서 구매할 때 사용한 것과 같은 Apple ID로 로그인하고 구입 항목에서 Shadowrocket을 찾으세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 가격이 계속 표시되면 다시 결제하기 전에 로그인한 계정과 구매 기록을 확인하세요. 앱을 받는 것과 연결 설정을 옮기는 것은 별개의 단계입니다. 앱을 설치했다고 설정까지 이전된 것은 아닙니다.

다른 기기에서 설정을 옮긴 뒤 구독 주소, 서버 매개변수, Config, DNS, 자동 연결 조건을 각각 확인하세요. 서버 이름이 같다고 내용도 완전히 같다고 판단하지 말고, 모든 로컬 설정이 시스템 이전 과정에서 복원됐다고 가정하지 마세요. 먼저 자신의 구독을 가져와 연결 하나를 확인한 다음 트래픽 분기 설정을 복원하고 마지막으로 On Demand를 활성화하세요. 이 순서는 문제가 발생했을 때 차이가 생긴 단계를 찾기 쉽습니다.

파일을 동기화해야 한다면 자신이 관리하는 저장 공간만 사용하고 파일이 이전 사본이 아닌지 확인하세요. 인증 정보가 포함된 설정 파일을 공개 링크로 전달하지 마세요. 다른 사람에게 도움을 요청하기 전에 인증 정보를 삭제하세요. 문제가 iPad의 특정 화면 배치, 네트워크 전환 또는 화면 잠금 상황에서만 발생한다면 동작 순서와 재현 조건을 기록하세요. 관련 다운로드 안내는 iPad 구매 항목 다운로드 및 가로 모드 사용 팁에서, 기본 조작은 빠른 시작 가이드에서 차례로 확인할 수 있습니다.