Shadowrocket에 본인의 구독을 이미 가져온 사용자를 위한 안내입니다. 먼저 Home에서 수동 업데이트를 확인한 다음 Settings → Subscribe에서 Update on Open을 확인하세요. 실패하면 네트워크, 링크, 응답 내용, 요청 간격을 차례로 점검합니다. 구독 업데이트는 서버 목록을 다시 가져오는 기능으로, 연결 테스트나 Config 규칙 업데이트와는 다릅니다.
구독 업데이트 범위: 목록, 연결, 규칙은 각각 별도로 관리
Shadowrocket은 Apple 플랫폼용 유료 클로즈드 소스 앱으로, 주로 iPhone / iPad에서 사용하며 App Store에서만 구매 및 설치할 수 있습니다. 일회성 구매 방식이며, 클라이언트 구매에는 연결 서비스 요금제가 포함되지 않습니다. 이 안내는 이미 본인의 서비스 제공업체와 구독을 보유한 사용자를 전제로 합니다. 이 사이트는 노드, 구독, 서비스 제공업체를 제공·판매·추천하지 않습니다. 가격, 시스템 요구 사항 및 일반적인 구매 가능 여부는 App Store 페이지를 기준으로 확인하세요.
구독 업데이트는 저장된 구독 주소에 다시 요청을 보내고, 응답에서 서버 정보를 가져오는 과정입니다. 원격 서버에서 주소, 포트, 이름 또는 인증 매개변수를 변경하면 업데이트 후 목록이 달라질 수 있습니다. 변경 사항이 없다면 업데이트에 성공해도 목록은 그대로일 수 있습니다. 항목 수가 같다는 이유만으로 업데이트 실패라고 판단할 수는 없습니다.
Home의 구독 목록, Config의 구성 파일, 시스템의 VPN 연결은 서로 다른 항목입니다. 구독 요청이 성공해도 모든 서버 항목이 연결 가능한 것은 아니며, 연결이 정상이어도 구독 주소가 유효하다는 뜻은 아닙니다. 문제를 해결할 때는 먼저 어느 단계에서 실패했는지 확인한 뒤 적절한 조치를 선택하세요.
수동 업데이트: 구독 그룹 하나를 새로고침한 뒤 결과 확인
처음 문제를 확인할 때는 구독 그룹 하나만 업데이트하세요. 여러 주소에서 동시에 실패하면 원인을 파악하기 어렵습니다. 아래 절차는 이미 가져온 구독 그룹에 적용됩니다. 같은 주소를 다시 추가할 필요는 없습니다. 중복으로 가져오면 이름이 같은 그룹이 생겨 확인이 더 번거로워질 수 있습니다.
- Home을 엽니다. 업데이트할 구독 그룹을 찾아, 현재 보고 있는 항목이 개별적으로 추가한 서버가 아니라 해당 그룹에 속한 서버인지 확인합니다.
- 구독 그룹을 조작합니다. 구독 그룹 이름을 길게 누른 뒤 표시되는 메뉴에서
Update를 선택합니다. 개별 서버 항목이 아닌 그룹 제목을 대상으로 작업하세요. - 요청이 끝날 때까지 기다립니다. 요청이 진행 중일 때 연달아 탭하지 마세요. 결과 메시지를 확인하고, 화면에 업데이트 시간이 표시되면 함께 기록해 두세요.
- 목록 내용을 확인합니다. 그룹이 남아 있는지, 항목이 온전한지, 원격에서 변경을 안내한 이름이나 주소가 반영되었는지 살펴봅니다. 항목 수가 같아도 내용이 업데이트되지 않았다고 단정할 수 없습니다.
- 연결은 별도로 확인합니다. 현재 선택한 항목이 삭제되거나 이름이 바뀌었다면 목록에 남아 있는 항목을 다시 선택하세요. 필요하면 다시 연결해 실제 접속이 가능한지 확인합니다.
Home 목록을 아래로 당겨 새로고침해도 구독 업데이트를 시작할 수 있습니다. 구독 그룹이 여러 개라면 다른 그룹의 요청도 함께 시작되는지 확인하세요. 특정 주소의 문제만 확인하려면 해당 그룹에서 Update를 실행하는 편이 결과 메시지와 구독을 연결해 파악하기 쉽습니다. 메뉴 위치와 표시 방식은 현재 앱 화면을 기준으로 확인하세요.
앱을 열 때 자동 업데이트: Update on Open 설정
수동 업데이트가 성공한 것을 확인한 뒤 자동 실행을 켜면 요청 자체의 실패와 자동 실행 조건 미충족을 구분하기 쉽습니다. Update on Open은 앱을 열 때 구독 업데이트를 시작하는 기능입니다. 백그라운드에서 계속 실행되는 정기 다운로드 작업은 아니며, 앱을 전면으로 전환할 때마다 새 요청을 보낸다는 의미도 아닙니다.
- Settings → Subscribe로 이동해 Update on Open을 찾아 켭니다.
- 같은 화면에서 업데이트 간격과 관련된 옵션도 확인합니다. 현재 인터페이스에서 간격을 설정할 수 있다면 기존 값을 유지하고 기록해 두세요. 짧은 시간 안에 앱을 반복해서 열어도 매번 새 요청이 발생한다고 볼 수는 없습니다.
- Home으로 돌아가 해당 구독 그룹을 유지합니다. 설정된 간격만큼 기다린 뒤 앱을 다시 열고, 업데이트 메시지나 화면에 표시되는 시간 정보를 확인합니다.
- 화면에 변화가 없으면 해당 그룹에서 Update를 한 번 실행합니다. 수동 업데이트는 성공하지만 자동으로 시작되지 않는다면 구독 주소를 바로 바꾸지 말고 스위치, 간격, 앱을 열었을 때의 네트워크 상태를 먼저 확인하세요.
앱을 여는 것과 VPN에 연결하는 것은 별개의 동작입니다. Settings → On Demand는 조건에 따라 연결을 시작하는 동작을 관리하며 구독을 업데이트하지 않습니다. On Demand를 켜도 Update on Open을 대신할 수 없습니다. 반대로 On Demand가 꺼져 있어도 요청에 필요한 네트워크를 사용할 수 있다면 구독을 수동으로 업데이트할 수 있습니다.
정리: 먼저 요청을 확인한 뒤 자동 실행을 확인하세요
같은 구독을 수동으로 업데이트해 성공한 뒤 자동 업데이트가 설정된 간격에 따라 실행되는지 확인하세요. 수동 업데이트도 실패한다면 네트워크와 링크를 점검해야 합니다. 자동 업데이트 스위치를 계속 바꿔도 원격 응답 문제는 해결되지 않습니다.
업데이트 실패: 오류 유형에 따라 다음 단계 확인
실패 메시지는 시스템 네트워크 계층, HTTP 응답 또는 콘텐츠 분석 단계에서 발생할 수 있습니다. 아래 영어 문구는 네트워크 오류 상세 정보에 표시될 수 있는 원문이며, 앱에서 항상 같은 형식으로 표시된다는 보장은 없습니다. 실제 메시지를 저장하고 발생 시점을 함께 확인하세요. 모든 실패를 구독 만료 탓으로 돌리지 마세요.
네트워크 세부 정보: The request timed out.
원인: 제한 시간 안에 요청이 완료되지 않았습니다. 네트워크 연결 문제, 원격 서버의 응답 지연 또는 현재 프록시 경로를 사용할 수 없는 경우일 수 있습니다.
해결 방법: 먼저 Wi-Fi와 셀룰러 네트워크를 번갈아 사용해 비교한 뒤 같은 그룹을 업데이트합니다. 구독 주소에만 접근할 수 없다면 이미 사용 가능한 연결을 통해 업데이트해야 하는지도 확인하세요.
네트워크 세부 정보: A server with the specified hostname could not be found.
원인: 구독 주소의 호스트 이름을 확인하지 못했습니다. 링크를 잘못 입력했거나 도메인이 더 이상 유효하지 않거나 현재 네트워크의 이름 확인에 문제가 있을 수 있습니다.
해결 방법: 기존 구독의 도메인과 전체 주소를 확인하고 다른 네트워크에서 다시 시도합니다. 도메인을 IP 주소로 바로 바꾸지 마세요. HTTPS 인증서 확인이나 서버 식별에 문제가 생길 수 있습니다.
HTTP 상태: 403 Forbidden
원인: 서버가 요청을 거부했습니다. 권한, 접근 제한 또는 보안 정책과 관련된 문제일 수 있으며, 상태 코드만으로 클라이언트 오류라고 단정할 수 없습니다.
해결 방법: 본인의 서비스 제공업체 계정에서 구독 권한과 현재 주소를 확인합니다. 상태 코드와 발생 시간을 전달해 확인을 요청하고, 짧은 간격으로 요청을 반복하지 마세요.
HTTP 상태: 429 Too Many Requests
원인: 원격 서버가 요청 빈도를 제한하고 있습니다. 새로고침을 반복하면 콘텐츠를 정상적으로 가져올 수 없는 시간이 길어질 수 있습니다.
해결 방법: 연속으로 탭하는 것을 멈추고 원격 안내에 따라 기다립니다. 응답에 Retry-After가 포함되어 있다면 지정된 대기 시간이나 시점에 다시 시도하고 자동 업데이트 간격도 확인하세요.
주소가 로그인 페이지, 인증 페이지 또는 안내 페이지를 반환한다면 HTTP 상태가 200이어도 분석 가능한 구독 콘텐츠를 받은 것은 아닙니다. 이 경우 콘텐츠 분석에 실패하거나 목록이 비어 있을 수 있습니다. 본인의 서비스 제공업체 계정에서 구독 주소를 다시 확인하고, 웹페이지 주소를 구독 주소로 사용하지 마세요.
- 링크가 온전한지 확인: 앞뒤 공백이나 줄바꿈이 있는지, 쿼리 매개변수가 누락되지 않았는지 확인합니다. 복사 과정에서 token이 잘리지 않았는지도 특히 주의하세요.
- 권한 상태: 구독이 초기화, 취소 또는 교체되었는지 확인합니다. 이전에 작동했던 링크라도 지금 유효하다는 보장은 없습니다.
- 응답 내용: 원격 서버가 현재 앱에서 사용할 수 있는 구독 콘텐츠를 제공하는지 확인합니다. 계정 관리 페이지나 단순 안내문이 반환된 것은 아닌지 살펴보세요.
- 인증서 오류: 먼저 기기의 날짜와 시간이 올바른지 확인한 뒤 본인의 서비스 제공업체에 인증서 상태를 문의합니다. 보안 검증을 끄는 방식으로 문제를 감추지 마세요.
Update via Proxy: 사용 가능한 연결을 확보한 뒤 요청 경로를 선택
현재 직접 연결 네트워크에서 구독 주소에 접근할 수 없지만 기존 서버는 사용할 수 있다면 Settings → Subscribe → Update via Proxy를 확인할 수 있습니다. 이 옵션은 구독 업데이트의 네트워크 경로를 조정합니다. 사용 가능한 서버를 만들어 주거나 취소된 링크 또는 잘못된 응답 내용을 복구하지는 않습니다.
- Home에서 이미 사용할 수 있는 것으로 확인한 항목을 선택하고 연결 스위치를 켠 다음 실제 네트워크 접속이 정상인지 확인합니다.
- Settings → Subscribe로 이동해 Update via Proxy를 켠 뒤 Home으로 돌아와 같은 그룹에서 Update를 한 번 실행합니다.
- 옵션을 켜기 전과 후의 결과를 비교합니다. 기존 연결을 거쳐야만 성공한다면 해당 설정을 유지할 수 있습니다. 두 경로에서 모두 실패하면 주소와 원격 서버 상태를 계속 확인하세요.
- 기존 항목을 모두 사용할 수 없다면 먼저 연결 문제를 해결하거나 본인의 서비스 제공업체에 현재 유효한 정보를 확인하세요. 실패하는 연결에 의존해 업데이트를 반복하지 마세요.
Global Routing의 Config, Proxy, Direct, Scene은 트래픽 처리 방식을 설정하며 구독 업데이트 간격을 조정하는 옵션이 아닙니다. 특히 Direct를 구독 강제 새로고침으로 이해해서는 안 되며 Proxy로 전환하면 반드시 업데이트가 완료된다고 볼 수도 없습니다. 문제를 진단할 때는 한 번에 한 가지 요소만 변경하고 결과를 기록하세요. 분할 라우팅, DNS, 구독 옵션을 동시에 바꾸면 원인을 찾기 어려워집니다.
정리: 재현 가능한 비교 조건 하나를 유지하세요
같은 구독에서 네트워크 유형, Update via Proxy 상태, 결과를 각각 기록하세요. 반복해서 같은 결과가 나타나는 차이를 확인하는 것이 구독을 계속 다시 가져오는 것보다 문제를 파악하는 데 도움이 됩니다.
자주 묻는 질문: 업데이트 간격, 목록 변경, 규칙 새로고침
앱을 열 때마다 새로고침되지 않는 것 같은데 자동 업데이트가 고장 난 건가요?
먼저 Settings → Subscribe에서 Update on Open이 켜져 있는지 확인하고 현재 화면에 표시되는 업데이트 간격을 살펴보세요. 간격만큼 기다린 뒤 다시 확인합니다. 그런 다음 Update를 수동으로 실행해 자동 실행 조건 문제인지 요청 실패인지 구분하세요. 서버 항목 수가 그대로라는 이유만으로 결론을 내리지 마세요.
업데이트는 성공했는데 원래 있던 서버가 사라진 이유는 무엇인가요?
다시 가져온 콘텐츠에서 해당 항목이 삭제되거나 이름이 바뀌었을 수 있습니다. 먼저 올바른 그룹을 보고 있는지 확인한 뒤 현재 목록에서 항목을 다시 선택하세요. 원격에서 예상한 내용과 실제 결과가 다르면 본인의 서비스 제공업체에 응답 내용을 확인하세요. 알 수 없는 주소를 수정해 항목을 복구하려고 하지 마세요.
자동 업데이트 간격은 짧을수록 좋은가요?
간격을 짧게 설정한다고 더 안정적인 것은 아닙니다. 본인의 서비스 제공업체 지침에 따라 설정하세요. 원격 콘텐츠가 바뀌지 않았다면 요청을 반복해도 새 콘텐츠를 얻을 수 없습니다. 429가 발생하면 재시도를 멈추고 기다려 수동 새로고침과 자동 실행이 겹치지 않도록 하세요.
구독을 새로고침하면 DOMAIN-SUFFIX 규칙도 업데이트되나요?
구독 새로고침만으로는 알 수 없습니다. 서버 구독과 Config의 규칙 관리는 서로 다른 작업입니다. 구성을 업데이트해야 한다면 Config에서 현재 활성화된 파일과 출처를 확인하세요. DOMAIN-SUFFIX, GEOIP, IP-CIDR, FINAL의 내용과 순서는 별도로 점검해야 합니다.
업데이트는 실패했지만 기존 목록으로 연결할 수 있습니다. 바로 삭제해야 하나요?
기존 목록을 유지하고 오류를 기록한 뒤 현재 구독 주소를 확인하세요. 기존 연결이 작동한다는 것은 해당 항목으로 현재 연결할 수 있다는 뜻일 뿐, 구독 권한이 정상이라는 의미는 아닙니다. 새 주소가 유효하고 업데이트가 성공한 것을 확인한 뒤 중복되거나 사용할 수 없는 그룹을 정리하세요.