Shadowrocket 구독 가져오기 실패·서버 목록이 비어 있을 때: 링크 형식과 업데이트 시점 확인 가이드

구독을 추가한 뒤 파싱 오류가 나거나 목록이 비어 있다면 링크, 인코딩, 서비스 제공자 상태, 업데이트 시점을 차례로 확인하세요.

이 글의 핵심

서비스 제공자에게 받은 Subscribe 링크를 Shadowrocket에 가져올 수 없거나 서버 항목이 보이지 않는 경우를 다룹니다. 먼저 링크가 온전히 저장되었는지 확인하고, 가져오기 실패와 파싱 오류, 빈 목록을 구분하세요. 마지막으로 서비스 제공자 상태와 업데이트 시점을 점검합니다. 단계마다 확인 가능한 결과를 기준으로 살펴보면 설정을 반복해서 삭제할 필요가 없습니다.

먼저 가져오기 실패와 빈 목록을 구분하세요

Shadowrocket의 Subscribe는 서버 정보를 가져오는 방법 중 하나이며, 서버 자체를 뜻하지는 않습니다. 업데이트 과정에서는 저장된 주소를 읽고, 서비스 제공자에게 내용을 요청한 뒤, 이를 파싱해 목록에 반영합니다. 추가에 성공했다는 것은 구독 항목이 저장되었다는 뜻일 뿐입니다. Home에 새 서버가 보이지 않는다고 해서 링크가 정상적으로 파싱되었다고 볼 수는 없습니다.

링크 저장업데이트 시작내용 가져오기항목 파싱목록 확인

먼저 어떤 현상인지 기록하세요. 업데이트 중에 구체적인 오류가 표시되나요? Subscribe 항목은 남아 있지만 서버 목록이 비어 있나요? 아니면 이전에 사용하던 항목이 바뀌지 않았나요? 세 경우의 점검 방향은 서로 다릅니다. 오류가 표시되면 링크와 네트워크 요청을 먼저 확인하고, 업데이트가 완료됐는데 목록이 비어 있다면 서비스 제공자가 실제로 반환한 내용을 확인하세요. 기존 항목에 변화가 없다면 서비스 제공자가 새 내용을 아직 게시하지 않았을 수도 있습니다.

오류: Failed to load subscription

원인 및 해결 방법: 클라이언트가 사용할 수 있는 구독 내용을 가져오지 못한 상태입니다. 링크가 만료되었거나 현재 네트워크에서 해당 주소에 접속할 수 없는 경우가 원인일 수 있습니다. 먼저 서비스 제공자가 안내한 원래 링크와 계정 상태를 확인한 뒤 업데이트를 다시 실행하세요. 이 오류만으로 특정 프로토콜 매개변수가 잘못되었다고 판단하지 마세요.

한 기기에서만 문제가 발생한다면 해당 기기의 현재 네트워크에서 서비스 제공자가 안내한 구독 주소에 접속할 수 있는지 확인하세요. 여러 기기에서 같은 링크를 사용했을 때 결과가 동일하다면 서비스 제공자에게 먼저 문의하는 것이 좋습니다. 자격 증명이 포함된 전체 URL을 공개 웹페이지나 게시판에 올려 테스트하지 마세요.

1단계: Subscribe 링크가 온전한지 확인

Home 오른쪽 위의 ‘+’를 누르고 Type을 Subscribe로 설정한 다음, 해당 주소 입력란에 전체 링크를 입력해 저장하세요. 서비스 제공자 도메인만 입력하거나 링크 일부만 복사하거나 안내 문구까지 함께 붙여 넣으면 전체 구독 URL을 대신할 수 없습니다. 이미 Subscribe 항목이 있다면 먼저 저장된 주소를 확인하세요. 원래 값이 잘못된 것을 확인한 경우에만 수정해 비슷한 항목이 여러 개 생기지 않도록 합니다.

  1. 원본 링크 가져오기

    서비스 제공자 계정 페이지에서 구독 주소를 복사하세요. 표시 이름이나 웹페이지 제목이 아니라 전체 URL을 복사했는지 확인합니다. 구독은 본인이 이용하는 서비스 설정이며 클라이언트 구매 비용과 회선 서비스 비용은 별도로 청구됩니다.

  2. 시작과 끝 확인

    https://처럼 프로토콜을 포함한 주소로 시작하는지, 끝부분의 매개변수가 빠지지 않았는지 확인하세요. 예시 형식은 https://example.com/sub?token=xxxx입니다. 도메인과 자격 증명은 임의의 값이므로 접속에 사용할 수 없습니다.

  3. 구분 기호 확인

    쿼리 매개변수에 있는 ?, &, = 등의 원래 문자를 그대로 유지하세요. 메신저에서 줄바꿈이 들어가거나 복사 중 내용이 잘리는 경우, 반각 기호가 전각 기호로 바뀌는 경우에는 서비스 제공자가 링크를 인식하는 데 필요한 매개변수가 달라질 수 있습니다.

  4. 저장 후 업데이트

    Subscribe 항목을 저장한 뒤 Home에서 현재 인터페이스에 표시되는 새로고침 기능으로 구독을 업데이트하세요. 서버 항목이 나타나는지 또는 구체적인 오류가 표시되는지 확인합니다. 저장 직후 보이는 이전 목록만으로 이번 업데이트 결과를 판단하지 마세요.

일부 링크에는 접속 자격 증명이 포함됩니다. 도메인과 경로가 같더라도 매개변수가 다르면 서비스 제공자가 다른 계정으로 인식할 수 있습니다. 링크를 확인할 때는 앞부분과 끝부분, 매개변수 유무를 비교하되 공개 스크린샷에 전체 자격 증명이 드러나지 않도록 하세요. 자격 증명이 노출된 것 같다면 클라이언트에서 매개변수를 임의로 바꾸지 말고 서비스 제공자에게 문의하세요.

2단계: 반환된 내용을 파싱할 수 있는지 확인

링크에 접속할 수 있다고 해서 서버 목록이 반환되는 것은 아닙니다. 서비스 제공자가 로그인 페이지, 만료 안내, 접근 제한 페이지 또는 현재 가져오기 방식과 호환되지 않는 텍스트 형식을 반환할 수 있습니다. 이 경우 네트워크 요청은 완료된 것처럼 보여도 파싱 후 사용할 수 있는 항목이 없을 수 있습니다. 서비스 제공자가 Shadowrocket용으로 지원한다고 안내한 가져오기 형식을 기준으로 확인하고, 아무 웹페이지 주소나 Subscribe 주소로 사용하지 마세요.

URL 1개
필요한 쿼리 매개변수를 포함해 Subscribe 주소 전체를 저장해야 합니다
결과 2가지
요청 실패와 요청 완료 후 빈 목록을 구분하세요
확인할 항목 3가지
링크 원문, 서비스 제공자가 반환한 내용, Home 목록

서비스 제공자가 구독 내용을 확인하는 방법을 안내한다면 계정 페이지에서 현재 서버 항목이 실제로 있는지, 해당 링크가 어떤 가져오기 형식을 대상으로 하는지 확인하세요. ‘인코딩 수정’을 위해 반환된 텍스트의 문자를 직접 삭제하거나 필드 순서를 바꾸거나 변환 방식을 추측하지 마세요. 내용 형식은 서비스 제공자가 생성하므로 직접 수정하면 이번에는 읽히더라도 다음 업데이트에서 다시 문제가 생길 수 있습니다.

‘목록이 비어 있다’는 것이 단순히 잘못된 화면을 보고 있기 때문은 아닌지도 확인하세요. Config 페이지가 아니라 Home에서 업데이트된 서버 목록을 확인하고 있는지 살펴보세요. Global Routing을 Proxy, Direct, Config 또는 Scene으로 설정하면 트래픽 처리 방식이 달라지지만, 설정을 바꿔도 빈 구독 내용이 서버로 채워지지는 않습니다. 먼저 가져오기 결과를 해결한 다음 라우팅 설정을 확인하세요.

3단계: 서비스 제공자 상태와 업데이트 시점 확인

구독 내용은 서비스 제공자가 관리합니다. 계정 상태 변경, 자격 증명 재설정, 구독 주소 변경 또는 일시적인 요청 제한으로 인해 이전에 저장한 URL이 더 이상 같은 내용을 반환하지 않을 수 있습니다. 링크 원문에 문제가 없고 서비스 제공자 계정 페이지에도 사용 가능한 항목이 표시되지 않는다면 먼저 서비스 제공자에게 확인하세요. 반환 내용이 비어 있을 때 Shadowrocket이 서버 정보를 만들어낼 수는 없습니다.

판단 기준: 한 번 새로고침해도 바뀌지 않는다고 가져오기에 실패한 것은 아닙니다

먼저 서비스 제공자 계정 페이지와 Home 목록을 비교하세요. 서비스 제공자가 새 항목을 게시하지 않았다면 여러 번 새로고침해도 같은 목록이 표시될 수 있습니다. 서비스 제공자가 업데이트했는데 클라이언트에서 계속 오류가 발생한다면 링크와 요청 결과를 다시 확인하세요.

업데이트 시점도 판단에 영향을 줍니다. 구독 주소를 방금 변경했다면 새 주소를 올바르게 저장한 뒤 해당 항목을 직접 업데이트하세요. 이전 항목의 자동 업데이트를 기다려도 기존 URL은 새 주소로 바뀌지 않습니다. 서비스 제공자가 내용을 변경했다면 안내에 따라 변경 사항이 게시되었는지 확인한 뒤 한 번 업데이트하고 결과를 살펴보세요. 짧은 간격으로 연속 조작하면 어느 주소로 요청했는지 구분하기 어려우므로 한 번에 한 항목씩 변경하는 것이 좋습니다.

네트워크에 따라 결과가 달라진다면 같은 Subscribe 항목의 업데이트 결과를 각각 기록해 현재 네트워크의 접속 문제인지 서비스 제공자가 반환한 내용의 문제인지 판단하는 데 활용하세요. 테스트 중에는 링크와 계정 상태를 그대로 유지합니다. 네트워크, 주소, 구성을 동시에 바꾸면 결과를 한 가지 원인과 연결하기 어렵습니다.

목록이 복구되면 구독을 계속 바꾸기보다 연결을 확인하세요

Home에 서버 항목이 표시되면 구독 가져오기와 파싱이 적어도 화면에 나타나는 결과를 만든 것입니다. 이후에도 연결할 수 없다면 서버 매개변수, 서비스 제공자 상태, 라우팅 설정을 별도로 점검하세요. 더 이상 ‘목록이 비어 있음’ 문제로 볼 필요는 없습니다. 예를 들어 Home에서 선택한 항목과 Global Routing 설정이 이후 요청에 영향을 줍니다. Settings → On Demand는 설정한 조건을 충족할 때 필요에 따라 연결할지를 결정하지만, 만료된 구독 URL을 복구하지는 않습니다.

  1. 업데이트 후 예상한 항목이 실제로 나타났는지 확인하고, 이전 서버를 잘못 선택하지 않았는지도 살펴보세요.
  2. 그다음 Home → Global Routing에서 현재 Proxy, Direct, Config, Scene 중 무엇으로 설정되어 있는지 확인하고 사용 목적에 맞게 선택하세요.
  3. 네트워크 조건에 따라 자동으로 연결해야 한다면 Settings → On Demand에서 설정한 조건을 확인하세요. 구독 가져오기 문제와 분리해 점검합니다.

점검 순서는 ‘링크 무결성 → 반환 내용과 형식 → 서비스 제공자 상태 → 업데이트 결과 → 연결 설정’으로 정할 수 있습니다. 이 순서는 모든 문제를 클라이언트 안에서 해결할 수 있다는 뜻이 아니라 문제가 발생한 단계를 구분하기 위한 것입니다. 링크와 반환 내용은 서비스 제공자에게 확인해야 하며, 목록에 항목이 표시된 뒤의 연결 문제는 라우팅 및 서버 매개변수를 점검해야 합니다. 여러 설정을 한꺼번에 초기화하기보다 변경 전후의 현상을 기록하면 원인을 찾기 쉽습니다.

공식 앱과 기본 사용법 확인

Shadowrocket은 App Store에서 제공되며 개발자는 Shadow Launch Technology Limited입니다. 일회성 구매 방식이며, 기기 호환성과 시스템 요구 사항은 App Store 페이지의 안내를 기준으로 확인하세요. 이 사이트는 공식 설명을 제공하며 구독 서비스는 제공하지 않습니다. 처음 사용한다면 앱 정보를 확인한 다음 기본 설정 안내를 살펴보세요.

공식 앱 확인 안내 사용 가이드 보기
App Store 공식 앱 확인