이 글의 핵심

이 글은 이용 중인 서비스 제공업체의 구독이 있는 Shadowrocket 사용자를 위한 안내입니다. 먼저 ‘내용을 가져오지 못함’, ‘구독이 아닌 내용을 가져옴’, ‘구독에 사용 가능한 항목이 없음’을 구분한 뒤 링크, 제공업체 상태, 새로고침 시점, 네트워크 경로를 확인하세요. 점검 중에는 기존 기록을 유지하고 한 번에 한 가지 조건만 바꾸세요. 마지막으로 인증 정보가 포함되지 않은 문의 자료를 정리해 기기에서 조정할 문제인지 서비스 제공업체에 문의할 문제인지 판단합니다.

1. 요청 실패·파싱 실패·목록이 비어 있는 경우 구분하기

구독은 링크에 항상 고정된 노드 목록이 저장된 형태가 아닙니다. 업데이트할 때 클라이언트가 주소에 접속해 서버가 반환한 내용을 가져오고, 그중 지원되는 서버 항목을 로컬 목록에 저장합니다. 어느 단계에서든 문제가 생기면 업데이트 오류로 보일 수 있지만, 해결 방법은 각기 다릅니다.

링크 확인주소에 요청내용 수신항목 파싱목록 표시

먼저 Home에서 해당 구독이 단순히 그룹 접기 상태인지 확인하세요. 다른 그룹의 노드 수를 해당 구독의 결과로 착각하지 않도록 주의합니다. 그런 다음 새로고침할 때 표시된 안내를 빠짐없이 기록하세요. 아래 증상으로 문제 단계를 파악할 수 있지만, ‘비어 있음’만 보고 구독 전체를 삭제하지 마세요.

이 글에서는 iPhone / iPad의 Home, Config, Settings를 기준으로 화면을 안내합니다. Mac, Windows, Android, Linux에서도 ‘요청, 응답, 파싱, 표시’ 단계에 따라 문제를 찾을 수 있습니다. 다만 모바일의 아래로 당겨 새로고침하는 동작이 데스크톱에도 있다고 가정하지 마세요. 해당 구독의 작업 메뉴에서 업데이트해야 합니다.

2. 링크 전체 확인하기: 관리 페이지 주소를 구독 URL로 사용하지 마세요

이용 중인 서비스 제공업체의 구독 관리 페이지로 돌아가 ‘구독 주소 복사’ 기능을 다시 사용하세요. 복사한 뒤에는 기기에서만 내용을 확인해 주소의 시작 부분, 도메인, 경로, 쿼리 매개변수가 온전한지 살펴보세요. 브라우저 주소창에 표시되는 계정 홈, 주문 페이지, 로그인 페이지는 보통 클라이언트가 읽어야 하는 구독 엔드포인트가 아닙니다.

https://example.com/sub?token=xxxx

위 내용은 구조를 알아보기 위한 예시일 뿐 가져오기에 사용할 수 없습니다. 실제 주소의 token 같은 필드는 접근 인증 정보일 수 있습니다. 무작위 문자열처럼 보인다는 이유로 삭제하지 마세요. 다른 서비스 제공업체의 매개변수 이름을 자신의 링크에 적용해서도 안 됩니다.

  1. 주소 앞뒤에 공백, 줄바꿈, 따옴표, 한글 문장부호가 붙지 않았는지 확인하세요. 메신저 화면에 보이는 줄바꿈이 실제 링크에 포함되는 것은 아닐 수 있으니, 붙여넣은 뒤 다시 확인합니다.
  2. https://가 잘리지 않았는지 확인하세요. 경로의 대소문자, ? 뒤의 매개변수, & 구분자는 원래대로 유지해야 합니다.
  3. 문자열에 &가 그대로 보인다면 원본 페이지에서 다시 복사하세요. 확인 없이 주소 전체를 일괄 치환하거나 디코딩하지 마세요.
  4. 서비스 제공업체가 여러 내보내기 형식을 제공한다면 Shadowrocket용으로 명시된 구독 형식을 선택하세요. 웹페이지 공유 주소나 Config 파일 전체의 주소를 같은 형식으로 취급하지 마세요.

3. 서비스 제공업체의 응답 확인하기: 상태 코드와 빈 응답은 따로 점검

브라우저에서 페이지가 열린다고 해서 해당 주소를 구독으로 사용할 수 있는 것은 아닙니다. 로그인된 브라우저에는 쿠키가 저장되어 있을 수 있지만 구독 요청에는 같은 로그인 상태가 적용되지 않을 수 있습니다. 서버가 인증 페이지를 반환할 수도 있습니다. HTTP 상태가 200이어도 본문이 HTML이라면 클라이언트가 파싱할 수 있는 서버 데이터가 아닐 수 있습니다.

443
HTTPS에서 포트를 명시하지 않았을 때 사용하는 기본 포트
401 / 403
인증 요구사항과 접근 정책부터 확인
200
HTTP 요청 성공이 유효한 구독 본문을 보장하지는 않음

아래 카드는 표준 HTTP 응답 원문을 보여 주며, 오류 상세 정보나 서비스 제공업체의 답변에서 확인한 상태를 설명하기 위한 것입니다. Shadowrocket에 이 안내가 그대로 표시된다는 뜻은 아닙니다.

HTTP 401 Unauthorized

원인 및 해결 방법: 유효한 인증 정보가 요청에 없거나 만료됐습니다. 서비스 제공업체 페이지에서 유효한 구독 주소를 다시 복사하고 계정 상태를 확인한 다음 해당 구독을 업데이트하세요.

HTTP 403 Forbidden

원인 및 해결 방법: 서버가 현재 요청을 거부했습니다. 계정 권한, 출처 제한 또는 접근 정책이 원인일 수 있습니다. 발생 시각과 네트워크 유형을 기록해 서비스 제공업체에 확인하세요. 클라이언트 규칙을 바꿔 서버의 권한 제한을 해제하려고 해서는 안 됩니다.

HTTP 429 Too Many Requests

원인 및 해결 방법: 요청이 빈도 제한에 걸렸습니다. 연속 새로고침을 멈추세요. 응답에 Retry-After가 있으면 안내된 시간만큼 기다리고, 없으면 서비스 제공업체가 안내한 새로고침 간격에 따라 다시 시도하세요.

HTTP 503 Service Unavailable

원인 및 해결 방법: 서버가 일시적으로 요청을 처리할 수 없습니다. 먼저 이용 중인 서비스 제공업체의 점검 안내를 확인하고 잠시 뒤 다시 시도하세요. 로컬 구독을 반복해서 삭제하고 추가해도 서버 장애는 해결되지 않습니다.

판단 기준: 본문 형식을 먼저 확인한 뒤 로컬 설정을 조정하세요

서비스 제공업체가 응답이 로그인 페이지, 인증 페이지 또는 빈 내용이라고 확인했다면 제공업체가 먼저 구독 출력을 수정해야 합니다. 로컬에서 프로토콜을 바꾸거나 규칙 순서를 조정해도 이런 응답이 서버 항목으로 바뀌지는 않습니다.

4. 업데이트 시점 조절하기: 기존 항목을 보존하고 한 번에 하나씩 확인

계정 요금제를 변경하거나 구독 인증 정보를 재설정했거나 서비스 제공업체가 항목을 조정한 뒤에는 관리 페이지와 구독 엔드포인트의 결과가 동시에 바뀌지 않을 수 있습니다. 이때 업데이트를 연속으로 누르면 결과를 판단하기 어렵고 빈도 제한에 걸릴 수도 있습니다. 서비스 제공업체의 안내에 따라 기다리고 ‘최근 시도 시각’과 ‘마지막으로 성공을 확인한 시각’을 따로 기록하세요.

  1. 현재 상태 보존: 기존 구독 이름, 현재 항목 수, 오류 내용을 기록하세요. 기존 노드를 계속 사용할 수 있다면 그룹 전체를 삭제하거나 앱 데이터를 지우지 마세요.
  2. 새 주소 적용 확인: 인증 정보를 방금 재설정했다면 로컬 구독 주소도 교체했는지 확인하세요. 이전 주소를 그대로 두고 반복해서 새로고침하면 같은 실패가 반복됩니다.
  3. 해당 구독만 업데이트: Home에서 해당 구독을 찾아 업데이트하세요. 아래로 당겨 새로고침할 때는 실제로 어떤 구독 요청이 실행됐는지 확인해 다른 구독의 결과와 혼동하지 않도록 합니다.
  4. 완료 후 비교: 해당 그룹에 항목이 나타났는지, 개수가 바뀌었는지, 같은 오류가 발생했는지 확인하세요. 한 번의 작업이 끝난 뒤에 다음 조건을 변경합니다.

‘계속 다시 가져오기’를 기본 해결 방법으로 삼지 마세요. 이름이 같은 그룹이 만들어져 기존 항목과 새 항목이 함께 남을 수 있고, 어느 업데이트가 성공했는지도 파악하기 어려워집니다. 기록을 새로 만들어야 한다면 유효한 링크가 저장되어 있는지 확인하고 어느 구독 그룹을 삭제할지 명확히 파악한 뒤 진행하세요.

5. 네트워크를 바꿔 확인하기: 구독 요청과 노드 연결은 별개

구독 주소에 접속할 수 있는지와 특정 노드에 연결할 수 있는지는 서로 다른 조건입니다. 노드 연결에 성공해도 구독 도메인에 접속할 수 있는 것은 아니며, 구독 업데이트에 성공해도 모든 노드가 연결되는 것은 아닙니다. 테스트할 때는 같은 구독 링크를 유지하고 Wi-Fi 또는 셀룰러 네트워크 중 하나만 바꿔 확인하세요.

확인된 결과우선 확인할 항목다음 단계
Wi-Fi에서는 실패하고 셀룰러 네트워크에서는 성공Wi-Fi 인증 상태, DNS, 외부 연결 정책먼저 네트워크 로그인을 완료하고 실패한 네트워크 환경을 기록하세요. 구독 내용은 아직 변경하지 마세요.
두 네트워크 모두 401 반환구독 인증 정보와 계정 권한유효한 주소를 다시 복사하고 서비스 제공업체에 권한을 확인하세요.
두 네트워크 모두 파싱 오류 발생응답 본문과 내보내기 형식서비스 제공업체에 엔드포인트가 실제로 반환하는 내용을 확인해 달라고 요청하세요.
업데이트는 성공했지만 연결은 실패서버 주소, 포트, 연결 매개변수연결 문제 점검으로 넘어가고 구독 링크를 반복해서 교체하지 마세요.

테스트 중 연결 스위치가 저절로 반복해서 켜지면 Settings → On Demand에서 온디맨드 연결 조건을 확인하고 기존 설정을 기록하세요. 기능을 이해한 경우에만 잠시 조정하고 테스트가 끝나면 원래대로 복구합니다. On Demand는 연결이 시작되는 조건에 영향을 줄 뿐, 구독 본문을 파싱하는 설정은 아닙니다.

Global Routing의 Proxy, Direct, Config, Scene은 라우팅 동작을 제어하며 구독 데이터 형식과는 관계가 없습니다. 잘못된 내용을 고치려고 DOMAIN-SUFFIX, GEOIP, IP-CIDR, FINAL을 수정하지 마세요. 네트워크 경로를 바꿔야 하는지는 실제 요청 결과를 근거로 판단해야 합니다.

6. 노드 목록이 여전히 비어 있을 때: 항목 확인 후 문의 준비

해당 그룹을 펼쳤고 업데이트 중 네트워크 오류도 없는데 서버 항목이 여전히 없다면, 서비스 제공업체에 현재 구독에 내보낼 수 있는 노드가 실제로 포함되어 있는지 확인해 달라고 요청하세요. 계정 만료, 요금제 미적용, 서버 측 필터 조건, 출력 오류 등으로 내용이 비어 있을 수 있습니다. 구체적인 원인은 서비스 제공업체가 계정과 응답을 확인해야 판단할 수 있습니다.

프로토콜 이름이 같다고 모든 출력 형식을 바로 가져올 수 있는 것은 아닙니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 연결 매개변수가 서로 다릅니다. 항목 앞부분의 프로토콜 이름만 다른 것으로 바꾸거나 포트를 임의로 추가하지 마세요. 서비스 제공업체가 Shadowrocket용으로 제공하는 유효한 출력을 받아야 합니다.

7. 구독 업데이트 관련 자주 묻는 질문

같은 링크가 브라우저에서는 열리는데 왜 가져오기에 실패하나요?

내용이 서버 데이터인지 웹페이지인지 먼저 구분하세요. 로그인 양식, 인증 안내 또는 계정 화면이 보인다고 해서 구독이 정상이라고 볼 수는 없습니다. 웹페이지 소스 전체를 Home에 붙여넣지 마세요. 클라이언트가 실제로 가져올 수 있는 구독 출력인지 서비스 제공업체에 확인하세요.

기존 구독을 먼저 삭제하고 다시 추가하면 해결되나요?

먼저 삭제하지 마세요. 해당 그룹과 오류를 기록하고 기존 주소가 여전히 유효한지 확인한 뒤 한 번 업데이트하세요. 기록을 잘못 입력했거나 실제로 새로 만들어야 한다는 점이 확인된 경우에만 해당 그룹을 삭제하세요. 아직 사용할 수 있는 기존 항목까지 함께 지우지 않도록 주의합니다.

방금 업데이트했는데 새 노드가 없습니다. 계속 아래로 당겨 새로고침해야 하나요?

연속해서 새로고침할 필요는 없습니다. 먼저 서비스 제공업체 관리 페이지에 새 항목이 생겼는지 확인한 뒤 안내된 새로고침 간격만큼 기다리세요. 429가 표시되면 시도를 멈춰야 합니다. 기다린 뒤에도 비어 있다면 발생 시각, 해당 그룹, 네트워크 테스트 결과를 서비스 제공업체에 전달해 확인을 요청하세요.

노드는 있지만 웹페이지가 열리지 않아도 파싱 실패인가요?

같은 단계의 문제는 아닙니다. 먼저 Home에서 선택한 서버를 확인하고 Global Routing 설정과 연결 결과를 살펴보세요. Config를 사용하는 경우 실제로 활성화된 설정도 확인해야 합니다. 구독 항목이 표시된 뒤에는 가져오기를 반복해도 서버 연결이나 규칙 매칭 문제를 해결하기 어렵습니다.

Shadowrocket 다운로드 및 가져오기 안내

iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제이며, Mac(Apple 실리콘 / Intel) / Windows / Android / Linux 버전은 무료입니다. 총 2가지 방식으로 이용할 수 있습니다. iPhone / iPad의 시스템 요구 사항은 App Store 페이지를 확인하세요. 다운로드 페이지에서 기기에 맞는 버전을 선택하거나 최초 가져오기 및 연결 방법을 확인할 수 있습니다.