Shadowrocket 구독 업데이트 방법: 수동 새로고침, 앱 실행 시 자동 업데이트 및 실패 해결

이 글의 핵심

사용 중인 구독이 있다면 먼저 Home에서 수동으로 새로고침해 목록이 정상인지 확인한 다음, Settings → Subscribe에서 Update on Open을 켜세요. 업데이트에 실패하면 요청이 구독 주소에 도달했는지 확인하고, 응답 내용을 해석할 수 있는지도 살펴봅니다. 구독 새로고침, 연결 테스트, Config 업데이트는 서로 다른 작업입니다. 이 글에서는 조작, 확인, 문제 해결 순으로 설명합니다.

구독 업데이트란? 목록 새로고침이지 앱 업데이트가 아닙니다

Shadowrocket 구독 업데이트는 기존 구독 주소를 다시 읽어 Home의 해당 그룹에 있는 연결 항목을 갱신하는 작업입니다. 원격에서 이름, 주소, 포트 또는 기타 연결 매개변수가 변경되면 그 내용을 반영하기 위해 일반적으로 다시 가져와야 합니다. 이 글에서는 사용자가 이미 서비스와 구독을 보유한 경우를 전제로 합니다.

구독 주소 읽기 원격 콘텐츠 요청 연결 항목 해석 로컬 목록 업데이트

이 과정에서 콘텐츠를 요청할 수 있는지와 항목을 해석할 수 있는지는 별개의 조건입니다. 구독 서버가 로그인 페이지를 반환하면 네트워크 요청에 성공했더라도 유효한 구독을 받은 것은 아닙니다. 목록이 업데이트되었다고 해서 모든 연결을 정상적으로 사용할 수 있다는 뜻도 아닙니다. 연결 사용 가능 여부는 원격 서비스 상태, 인증 매개변수, 현재 네트워크에 따라 달라집니다.

Home: 기존 연결과 구독 그룹을 확인하고 목록을 새로고침한 뒤 업데이트된 항목을 살펴봅니다.
Settings → Subscribe: 앱을 열 때 업데이트하는 옵션을 비롯해 구독 관련 동작을 관리합니다.
Config: 구성 파일을 관리합니다. 이 안의 규칙이나 원격 구성 업데이트는 Home에서 구독 목록을 새로고침하는 작업과 구분해야 합니다.
App Store: 앱을 구입하고 업데이트하는 곳이며, 구독 콘텐츠를 새로고침하는 기능은 없습니다.

수동 새로고침: 주소를 확인한 다음 그룹을 점검하세요

처음 가져오거나 업데이트할 때 문제가 생기면 먼저 수동 새로고침을 해보세요. 자동 실행을 기다리는 대신 이번 작업의 결과를 바로 확인할 수 있습니다. 시작하기 전에 대상 그룹 이름, 현재 항목 수, 확인할 연결 이름을 기록해 두세요. 새로고침 전후를 비교하기 위한 정보이며 구독 인증 정보는 기록하거나 공개하지 않아도 됩니다.

구독 유형 확인

Home에서 기존 구독 그룹을 찾습니다. 처음 추가할 때는 Home 오른쪽 위의 “+” → Type → Subscribe를 선택하고 본인의 구독 주소를 입력한 뒤 저장합니다. 개별 공유 링크는 지속적으로 새로고침할 수 있는 구독 목록이 아닙니다.
주소 전체 확인

해당 구독의 편집 화면을 열어 URL을 확인합니다. 쿼리 매개변수가 모두 포함되어 있는지, 앞뒤에 공백이나 줄바꿈 또는 설명 문구가 붙지 않았는지 살펴보세요. 본인의 주소만 확인하고 전체 주소를 공개 토론 공간에 올리지 마세요.
아래로 당겨 목록 새로고침

Home으로 돌아가 목록 영역을 아래로 당겼다가 놓아 구독을 새로고침합니다. 작업이 끝날 때까지 기다리면서 실패 알림이 있는지 확인하세요. 구독이 여러 개라면 대상 그룹별로 결과를 확인합니다.
업데이트 결과 확인

대상 그룹의 이름과 항목 수, 변경된 것으로 알려진 항목을 비교합니다. 원격에서 특정 연결이 변경된 것이 확실하다면 해당 항목의 편집 정보를 열어 주소나 포트를 확인한 다음 연결 테스트를 진행하세요.

아래는 주소 구조를 보여주는 예시이며 연결에 사용할 수 없습니다. 예시의 token은 쿼리 매개변수입니다. 실제 주소에는 다른 매개변수 이름이 쓰이거나 경로에 인증 정보가 포함될 수 있습니다. 예시를 보고 본인 주소의 필드를 바꾸지 마세요.

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

앱 실행 시 자동 업데이트: Subscribe에서 설정

수동 새로고침이 성공한 다음 Settings → Subscribe → Update on Open으로 이동해 앱을 열 때 업데이트하는 옵션을 켜세요. 이 설정은 앱을 열 때 구독을 가져오도록 하며, 일정 간격으로 실행되는 백그라운드 예약 작업은 아닙니다. 연결을 계속 실행해 둔 채 앱을 열지 않았다고 해서 구독이 새로고침되었다고 볼 수는 없습니다.

먼저 수동으로 확인: 주소 자체가 유효하지 않다면 자동 업데이트를 켜도 같은 문제가 반복될 뿐, 원격 인증 정보가 복구되지는 않습니다.
설정을 켠 뒤 Home으로 이동: 다음에 앱을 열 때 대상 그룹과 변경이 확인된 항목을 살펴보세요. 옵션이 켜져 있다는 사실만으로 업데이트 성공 여부를 판단하지 마세요.
변경 사항이 확인되면 수동 새로고침: 원격 변경 내용을 바로 가져와야 할 때는 다음 앱 실행을 기다리기보다 직접 새로고침하고 결과를 확인하는 편이 확실합니다.
문제 해결 변수를 줄이기: 두 번의 새로고침 결과를 비교하는 동안에는 자동 업데이트를 잠시 끄고, 확인을 마친 뒤 필요에 따라 다시 켤 수 있습니다.

Update on Open과 On Demand는 용도가 다릅니다. 전자는 구독을 가져오는 시점을 제어하고, 후자는 연결을 필요에 따라 실행하는 기능입니다. Settings → On Demand를 바꿔도 구독 주소 문제는 해결되지 않고 목록 업데이트를 대신할 수도 없습니다. 구독 문제를 확인할 때 두 설정을 함께 변경할 필요는 없습니다.

작업 또는 설정	실행 방식	확인할 항목
Home에서 아래로 당겨 새로고침	사용자가 직접 실행	이번 작업의 알림, 대상 그룹, 확인된 항목 변경
Update on Open	앱을 열 때 실행	옵션이 켜져 있는지만 보지 말고 실제로 가져온 결과 확인
On Demand	연결 조건에 따라 실행	연결 상태를 확인하며 구독 업데이트의 증거로 간주하지 않음

요약: 수동 업데이트가 성공한 뒤 자동 업데이트를 켜세요

먼저 재현 가능한 수동 새로고침 성공을 확인한 뒤 Update on Open을 켜세요. 이후 문제가 생기면 여러 설정을 동시에 바꾸지 않고도 주소가 유효하지 않은 것인지 자동 실행이 완료되지 않은 것인지 구분할 수 있습니다.

업데이트 실패 해결: 링크, 네트워크, 형식을 나눠 점검

먼저 화면에 표시된 전체 알림을 기록한 다음 아래 세 가지 원인을 차례로 확인하세요. 시스템 언어와 요청 단계에 따라 표시 문구가 다를 수 있습니다. 오류 메시지는 단서일 뿐, 일반적인 문구 하나만으로 구독이 만료되었다고 단정할 수 없습니다.

오류: Failed to load subscription

원인 및 해결: 구독을 불러오지 못했다는 포괄적인 알림입니다. 주소 권한, 요청 실패, 응답 형식 오류 등이 원인일 수 있습니다. 먼저 본인의 서비스 제공자에게 주소가 유효한지 확인하고 네트워크 연결과 응답 내용을 각각 점검하세요.

오류: The request timed out.

원인 및 해결: 대기 시간 내에 요청이 완료되지 않았다는 뜻입니다. 현재 네트워크, 요청 경로 또는 구독 서버의 응답 문제일 수 있습니다. Wi-Fi와 셀룰러 네트워크에서 각각 수동 새로고침을 해보고 한쪽에서만 실패하는지 비교하세요.

오류: A server with the specified hostname could not be found.

원인 및 해결: 구독 주소의 호스트 이름을 확인하지 못했습니다. 도메인이 빠짐없이 복사되었는지 확인한 뒤 네트워크를 바꿔 다시 시도하세요. 도메인이 변경되었다면 본인의 서비스 제공자에게 최신 주소를 확인합니다.

첫 번째 원인: 링크 만료 또는 권한 변경

서비스 제공자가 인증 정보를 재설정하면 이전 주소가 Home에 남아 있어도 콘텐츠를 가져오지 못할 수 있습니다. 요청 결과가 HTTP 401 또는 403이면 먼저 권한 상태와 접근 제한을 확인하고, 404가 반환되면 경로가 변경되었는지 살펴보세요. 이러한 상태 코드만으로 구체적인 계정 문제를 단정할 수는 없으므로 본인의 서비스 정보를 함께 확인해야 합니다.

본인의 서비스 제공자 관리 페이지에서 구독 주소를 다시 복사해 로컬에 저장된 주소와 하나씩 대조하세요.
계정 홈이나 로그인 페이지, 개별 연결 공유 텍스트가 아니라 구독 주소를 복사했는지 확인하세요.
주소를 변경한 뒤에는 대상 구독만 새로고침해 결과를 확인하세요. 유효하지 않은 것으로 확인된 이전 주소를 계속 재시도하지 마세요.

두 번째 원인: 네트워크 연결 불가 또는 요청 경로 문제

Wi-Fi에서는 실패하지만 셀룰러 네트워크에서는 성공한다면 구독을 바로 다시 만들기보다 두 접속 환경의 차이를 먼저 확인하세요. 먼저 네트워크를 바꿔 비교한 뒤 현재 연결이 요청에 영향을 주는지 살펴봅니다. Global Routing의 Proxy, Direct, Config, Scene은 라우팅 모드입니다. 이를 변경하면 네트워크 접근에 영향을 줄 수 있지만 구독 인증 정보의 유효성은 바뀌지 않습니다.

한 번에 조건 하나만 바꾸세요. 예를 들어 구독 주소는 그대로 두고 Wi-Fi에서 셀룰러 네트워크로만 전환합니다.
현재 연결을 켰을 때와 껐을 때를 비교해야 한다면 먼저 기존 상태를 기록하고 테스트가 끝난 뒤 원래대로 되돌리세요.
한 번의 시간 초과 문제를 해결하겠다며 DNS, 라우팅, 모든 연결 매개변수를 한꺼번에 바꾸지 마세요. 어떤 변경이 영향을 주었는지 알 수 없게 됩니다.

세 번째 원인: 응답 내용을 해석할 수 없음

HTTP 200은 요청이 성공 응답을 받았다는 뜻일 뿐, 내용이 유효한 연결 목록임을 보장하지 않습니다. 서버가 로그인 페이지나 점검 안내 또는 다른 텍스트를 반환할 수 있습니다. 브라우저에서 페이지가 표시되더라도 Shadowrocket이 해당 내용을 구독으로 해석할 수 있다는 뜻은 아닙니다.

원격에서 제공하는 내용이 Shadowrocket용 구독인지, 직접 로그인해 읽어야 하는 웹페이지가 아닌지 확인하세요.
요청은 완료되었지만 항목이 비어 있다면 본인의 서비스 제공자에게 해당 주소에서 현재 반환되어야 하는 항목 수와 콘텐츠 형식을 확인하세요.
전체 내용에 임의로 인코딩을 추가하거나 필드를 삭제하거나 프로토콜 이름을 바꾸지 마세요. 원래 문제를 가리거나 연결 매개변수를 손상시킬 수 있습니다.

새로고침 후 변화가 없다면 항목 필드로 확인하세요

구독 새로고침은 성공했지만 아무것도 바뀌지 않은 것처럼 보일 수 있습니다. 원격 콘텐츠가 변경되지 않았다면 이름과 항목 수가 그대로인 것이 자연스럽습니다. 반대로 항목 수가 같다고 업데이트되지 않았다고 단정할 수도 없습니다. 서버 주소, 포트, 인증 매개변수가 바뀌었을 수 있습니다. 목록 길이만 보지 말고 변경된 것이 확인된 항목을 골라 점검하세요.

화면에 보이는 현상	확인할 내용	다음 단계
이름과 항목 수가 모두 그대로임	원격 콘텐츠가 실제로 변경되었는지, 올바른 그룹을 보고 있는지	변경이 확인된 연결의 필드 하나를 대조
목록은 바뀌었지만 연결 실패	원격 서비스 이용 가능 여부, 인증 매개변수, 현재 네트워크	연결 문제 해결로 넘어가고 목록 새로고침은 반복하지 않음
일부 항목만 누락됨	원격 응답의 항목 수, 항목 형식, 매개변수의 완전성	누락된 항목이 여전히 구독에 포함되어야 하는지 본인의 서비스 제공자에게 확인
앱을 열어도 이전 내용이 표시됨	Update on Open 설정 상태와 이번 요청의 완료 여부	수동으로 한 번 새로고침하고 알림을 기록

예를 들어 원격에서 특정 연결의 포트가 443에서 8443으로 변경되었다고 알렸다면 새로고침 후 이름만 보지 말고 해당 항목의 포트를 확인하세요. 숫자는 확인 방법을 설명하기 위한 예시일 뿐, 현재 연결에 권장되는 포트를 뜻하지 않습니다. 실제 매개변수는 사용자가 보유한 설정과 일치해야 합니다.

문제를 문의하기 전에: 현상은 기록하고 인증 정보는 가리세요

위의 비교를 마친 뒤에도 문제가 계속되면 최소한의 문제 해결 기록을 정리하세요. 상대방이 콘텐츠를 가져오지 못한 문제와 가져온 콘텐츠를 해석하지 못한 문제를 구분할 수 있어야 하며, 접근 가능한 구독 주소 전체는 노출하지 않아야 합니다. 구독 인증 정보는 쿼리 매개변수뿐 아니라 경로에도 포함될 수 있으므로 token이라는 이름의 필드만 가리면 충분하지 않습니다.

실행 방식: Home에서 아래로 당겨 새로고침할 때 실패하는지, Update on Open을 켠 뒤에만 변화가 보이지 않는지 설명하세요.
접속 환경: Wi-Fi와 셀룰러 네트워크에서 각각 어떤 결과가 나왔는지, 테스트 중 연결이 켜져 있었는지 기록하세요.
원래 표시된 알림: 오류 문구 전체를 기록하고 HTTP 상태 코드가 표시되었다면 함께 적으세요.
변경 범위: 모든 구독이 실패했는지, 특정 그룹만 실패했는지, 일부 항목만 누락되었는지 설명하세요.
개인 정보 보호: 구독 주소 전체, 비밀번호, UUID 및 기타 인증 필드는 가리고 필요한 현상만 남기세요.