이미 Shadowrocket에 직접 구독을 등록한 iPhone 및 iPad 사용자를 위한 안내입니다. Home에서 수동으로 새로 고치는 방법, Settings → Subscribe에서 앱 실행 시 업데이트를 설정하는 방법, 그리고 링크 만료·요청 실패·콘텐츠 파싱 실패를 구분하는 방법을 설명합니다. 판단 기준은 새로 고침 결과이며, 연결 스위치 상태가 아닙니다.
먼저 확인할 점: 구독 가져오기 문제인가, 기존 설정 사용 문제인가
구독 업데이트는 별도의 절차입니다. Shadowrocket이 저장된 구독 주소에 요청을 보내고, 응답을 받은 뒤 내용을 파싱해 Home의 항목을 업데이트합니다. Home에 기존 항목이 보인다는 것은 기기에 마지막으로 가져온 데이터가 남아 있다는 뜻일 뿐, 이번 요청이 성공했다는 의미는 아닙니다. 반대로 업데이트에 실패했다고 해서 기존 연결이 모두 즉시 작동하지 않는 것도 아닙니다. 두 문제는 각각 확인해야 합니다.
문제를 점검하기 전에 실패한 구독 그룹과 새로 고칠 때 표시된 문구를 기록하세요. 구독이 여러 개라면 하나씩 따로 확인하고, 한 그룹의 결과만으로 모든 링크를 판단하지 마세요. 새로 고침 전후의 항목 수와 업데이트 시간도 비교합니다. 오류 없이 끝났지만 내용이 달라지지 않았다면 서비스 제공자가 같은 데이터를 반환했을 수 있습니다. 오류가 발생하고 기존 항목이 그대로라면 이번 업데이트에서 사용할 새 콘텐츠를 가져오지 못한 것입니다.
진단 순서: 먼저 새로 고침 결과 확인
어떤 구독에서 어떤 메시지가 표시됐는지, 기존 항목은 남아 있는지부터 확인한 다음 연결 상태를 살펴보세요. Home의 연결 스위치를 반복해서 켰다 끄는 것으로 구독 업데이트를 테스트할 수는 없습니다.
수동 업데이트: 구독별로 새로 고치고 저장된 주소 확인
수동 업데이트는 한 그룹씩 실행한 직후 결과를 확인할 수 있어 처음 문제를 파악할 때 유용합니다. 다음 절차는 사용자가 본인의 구독 링크를 이미 가지고 있다는 전제입니다. 예시 주소 https://example.com/sub?token=xxxx는 링크 구조를 설명하기 위한 것으로, 실제로 사용할 수 있는 구독 주소가 아닙니다. 업데이트할 때는 직접 저장한 주소를 사용하고 전체 주소가 온전한지 확인하세요.
구독 찾기
Shadowrocket에서 Home을 열고 이전에 추가한 Subscribe 항목을 찾으세요. Home에 그룹이 여러 개라면 업데이트할 그룹을 먼저 확인해 다른 그룹의 성공을 문제 해결로 착각하지 않도록 합니다.
수동으로 새로 고침
Home에서 구독 항목을 아래로 당겨 새로 고치고 요청이 끝날 때까지 기다리세요. 메시지가 표시되기 전에 연속으로 반복 실행하지 마세요. 화면에 나온 오류 문구를 기록하고 새로 고침 전후의 항목을 비교합니다.
링크 확인
해당 구독의 편집 화면에서 Type이 Subscribe인지 확인하고 저장된 URL을 살펴보세요. 도메인, 경로,
token등의 쿼리 매개변수가 누락되거나 만료되지 않았는지, 불필요한 공백이 없는지 확인합니다. 확인 후 저장하고 Home으로 돌아가 한 번 더 새로 고치세요.결과 기록
한 그룹에서만 실패한다면 해당 링크와 반환 콘텐츠를 먼저 확인하세요. 모든 구독에서 시간 초과가 발생한다면 현재 네트워크를 우선 점검합니다. 오류 문구를 보관해 본인의 서비스 제공자에게 링크 상태를 문의할 때 활용하세요.
아직 구독을 추가하지 않았다면 Home 오른쪽 위의 «+»를 누르고 Type에서 Subscribe를 선택한 다음, 이미 가지고 있는 링크를 입력해 저장하고 처음으로 새로 고침을 실행하세요. 링크를 복사할 때는 물음표 뒤의 매개변수까지 모두 포함해야 합니다. 예시 주소의 ?token=xxxx도 URL의 일부이므로 빠뜨리면 접근이 거부되거나 예상과 다른 내용이 반환될 수 있습니다. 실제 링크와 인증 정보는 공개하지 마세요.
앱 실행 시 자동 업데이트: 설정 및 사용 조건
앱 실행 시 업데이트는 Shadowrocket을 열 때 구독의 최신 내용을 가져오도록 시도하는 기능입니다. 백그라운드에서 계속 새로 고치는 기능이 아니며, 잘못된 주소를 수정해 주지도 않습니다. 먼저 수동 업데이트를 한 번 성공시킨 뒤 Settings → Subscribe에서 앱 실행 시 업데이트 옵션을 확인하세요. 현재 화면에 Update on Open이 표시된다면 필요에 따라 켜면 됩니다. 실제로 표시되는 옵션은 앱 내 화면을 기준으로 확인하세요.
먼저 링크 확인
Home으로 돌아가 대상 구독을 수동으로 새로 고쳐 오류가 없는지 확인하고 구독 콘텐츠가 정상적으로 표시되는지 살펴보세요. 수동 업데이트가 실패하면 아래의 세 가지 원인을 확인하세요. 자동 업데이트를 켜고 계속 재시도하는 것만으로 해결하려 하지 마세요.
설정 확인
Settings → Subscribe로 이동해 Update on Open 등 앱 실행 시 업데이트와 관련된 옵션을 확인하세요. 설정을 변경한 뒤 Home으로 돌아옵니다. 구독 그룹을 여러 개 관리한다면 각 그룹의 새로 고침 결과도 따로 확인하세요.
다시 확인
다음에 앱을 열면 네트워크 요청이 끝날 때까지 기다린 다음 구독 콘텐츠나 업데이트 알림을 확인하세요. 앱을 열었다고 해서 원격 서버가 반드시 새 항목을 반환하는 것은 아닙니다. 서비스 제공자의 콘텐츠가 바뀌지 않았다면 목록도 그대로일 수 있습니다.
본인의 구독 주소가 기존 프록시 연결을 통해서만 열리는 경우 Settings → Subscribe에서 Update via Proxy를 확인하고, 현재 연결이 작동하는지 함께 테스트하세요. 이 옵션은 업데이트 요청에 사용할 네트워크 경로를 바꿀 뿐, 만료된 링크를 교체하거나 파싱할 수 없는 응답을 구독 데이터로 바꾸지는 않습니다. 테스트할 때는 한 번에 조건 하나만 변경하세요. 먼저 현재 경로로 시도한 다음 옵션을 전환하고 수동으로 새로 고쳐 두 결과를 비교합니다.
설정 원칙: 수동 업데이트 성공 후 자동 업데이트 사용
수동 새로 고침으로 콘텐츠를 가져와 파싱할 수 있는지 확인한 뒤 앱 실행 시 업데이트를 켜세요. 수동 업데이트가 실패하면 오류 문구를 보관하고 링크, 네트워크, 형식을 차례로 점검합니다.
업데이트 실패의 세 가지 원인과 해결 방법
오류 문구는 요청 단계와 서버 응답에 따라 달라집니다. 아래 카드의 영어 문구와 상태 코드는 표시될 수 있는 예시이므로 기기에 실제로 나타난 내용을 기준으로 확인하세요. 같은 “Failed to load subscription”도 여러 원인으로 발생할 수 있으니, 한 문구만 보고 링크가 만료됐다고 단정할 수 없습니다.
오류: HTTP 403
원인 및 해결 방법:서버가 현재 요청을 거부한 상태로, 링크 인증 정보나 접근 제한이 원인일 수 있습니다. 구독 URL에 모든 매개변수가 포함됐는지 확인하고 본인의 서비스 제공자에게 접근 조건을 문의하세요. 인증 정보를 임의로 추측하거나 변경하지 마세요.
오류: HTTP 404
원인 및 해결 방법:요청한 주소에 해당 리소스가 없습니다. 도메인과 경로가 직접 저장한 주소와 일치하는지 확인하세요. 원래 주소가 변경됐다면 본인의 서비스 제공자에게 새로 사용할 수 있는 주소를 확인한 뒤 업데이트하세요.
오류: The request timed out.
원인 및 해결 방법:제한 시간 안에 요청이 완료되지 않았습니다. 먼저 현재 Wi-Fi 또는 Cellular로 네트워크에 정상적으로 접속할 수 있는지 확인한 다음, 직접 연결과 Settings → Subscribe → Update via Proxy를 사용한 수동 새로 고침 결과를 비교하세요.
오류: Failed to load subscription
원인 및 해결 방법:앱이 이번 구독 콘텐츠를 가져오거나 사용할 수 없는 상태입니다. 먼저 링크와 네트워크를 확인하세요. 요청은 완료됐지만 사용할 수 있는 항목이 없다면 본인의 서비스 제공자에게 응답이 파싱 가능한 구독 형식인지 확인해 달라고 요청하세요.
링크 만료: 주소 확인 후 접근 권한 점검
구독 하나에서만 실패하고 저장된 링크가 최근 변경된 적이 있다면 URL부터 확인하세요. 도메인 철자, 경로 끝부분, 쿼리 매개변수가 서버 응답에 영향을 줄 수 있습니다. HTTP 403은 접근 조건을 먼저 확인하고, HTTP 404는 경로부터 살펴보는 편이 좋습니다. 다만 서버가 같은 문제를 다른 상태 코드로 표시할 수도 있습니다. 테스트를 위해 아직 사용할 수 있는 기존 항목을 삭제하지 말고, 현재 상태를 보존한 채 본인의 서비스 제공자에게 확인하세요.
네트워크 오류: 기기 인터넷 연결과 구독 요청 경로 구분
Wi-Fi 또는 Cellular에 연결됨으로 표시되어도 구독 주소에 반드시 접속할 수 있는 것은 아닙니다. 먼저 기기에서 네트워크를 정상적으로 이용할 수 있는지 확인한 다음 같은 네트워크 환경에서 Home의 수동 새로 고침을 다시 실행하세요. 모든 구독에서 시간 초과가 발생하면 현재 네트워크를 확인하고, 특정 주소만 시간 초과라면 해당 주소의 접근 조건을 점검합니다. Update via Proxy를 변경하기 전에 선택한 연결 자체가 작동하는지 확인하세요. 연결을 사용할 수 없다면 업데이트 요청도 실패할 수 있습니다.
형식을 파싱할 수 없음: 파일명이 아닌 응답 콘텐츠 확인
요청이 서버에 정상적으로 도달해도 로그인 페이지, 오류 안내 또는 빈 내용이 반환될 수 있습니다. 이런 응답은 Shadowrocket이 파싱할 수 있는 구독 데이터가 아닙니다. 새 항목이 추가되지 않거나 로드에 실패하는 형태로 나타날 수 있습니다. 이때 Global Routing의 Proxy, Direct 또는 Config를 반복해서 전환해도 서버 응답 내용은 바뀌지 않습니다. Type이 Subscribe인지 확인하고 본인의 서비스 제공자에게 해당 링크의 실제 응답 형식을 점검해 달라고 요청하세요.
자주 묻는 질문: 새로 고쳐도 예상한 변화가 없어요
아래로 당겨 새로 고쳤는데 오류는 없고 항목도 그대로인가요?
먼저 목록에서 다른 그룹이 아니라 대상 구독을 새로 고쳤는지 확인하세요. 그런 다음 서비스 제공자가 현재 제공하는 콘텐츠와 비교합니다. 원격 항목에 변화가 없다면 업데이트에 성공해도 목록에 새 항목이 저절로 추가되지는 않습니다. 항목 수가 그대로라는 이유만으로 실패라고 판단하지 마세요.
앱 실행 시 업데이트를 켰는데도 수동으로 테스트해야 하나요?
수동 새로 고침을 사용하면 한 번의 작업과 그 결과를 명확하게 비교할 수 있습니다. Home으로 돌아가 대상 구독을 아래로 당겨 새로 고치고 오류 문구를 기록하세요. 계속 실패한다면 다음 앱 실행 때까지 기다리지 말고 링크, 네트워크 경로, 반환 콘텐츠를 차례로 확인합니다.
Update via Proxy를 켰는데도 시간 초과가 발생하나요?
먼저 Home에서 현재 선택한 연결이 작동하는지 확인한 다음 Settings → Subscribe에서 해당 옵션의 상태를 살펴보세요. 두 네트워크 경로 모두 시간 초과된다면 발생 시간과 오류 문구를 기록해 본인의 서비스 제공자에게 구독 주소의 접근 조건을 확인하세요.
링크는 열리는데 로드 실패가 표시되나요?
웹페이지가 열린다고 해서 파싱 가능한 구독 데이터가 반환된 것은 아닙니다. Type이 Subscribe인지, URL 전체가 올바른지 확인하고 본인의 서비스 제공자에게 해당 주소의 응답 내용을 점검해 달라고 요청하세요. 로그인 페이지나 오류 페이지는 구독 항목으로 가져올 수 없습니다.
업데이트에 실패하면 기존 항목이 삭제되나요?
먼저 Home에서 기존 항목이 계속 표시되는지 확인하세요. 이번 실패로 전체 설정이 변경됐다고 단정하지 마세요. 새로 고침 전후의 실제 변화를 기록하고, 새 링크가 작동하는지 확인하기 전에는 문제 해결을 위해 기존 구독을 삭제하지 않는 편이 좋습니다.
문제 점검을 마쳤다면 수동 새로 고침을 한 번 더 실행해 대상 구독의 콘텐츠가 정상적으로 반환되는지 확인한 다음, 다음에 앱을 열 때 업데이트 결과를 살펴보세요. 구독은 사용자가 직접 이용하는 서비스 제공자가 제공하며, Shadowrocket은 이러한 설정을 가져와 사용하는 Apple 플랫폼용 유료 앱입니다. 앱 구매와 회선 요금제는 별개입니다. iPhone 및 iPad의 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 확인하세요.