Shadowrocket 구독 업데이트 방법: 수동 새로고침과 앱 실행 시 자동 업데이트 설정

이 글의 핵심 내용

이 글은 이미 이용 중인 서비스 제공업체의 구독을 보유한 Shadowrocket 사용자에게 해당합니다. 먼저 Home에서 수동으로 새로고침해 목록을 확인한 다음 Settings → Subscribe에서 앱 실행 시 업데이트를 켜세요. 요청이 실패하면 네트워크, 업데이트 경로, 링크 유효성을 차례로 확인합니다. 구독 업데이트는 서비스 제공업체가 반환하는 목록을 가져오는 기능입니다. 서비스 연장이나 Global Routing 전환, Config 규칙 업데이트와는 다릅니다.

구독 업데이트 범위: 서버 목록이며 규칙이나 요금제가 아닙니다

Shadowrocket은 구독 주소를 저장한 뒤 해당 주소에 콘텐츠를 요청하고, 식별 가능한 서버 항목을 Home에 정리합니다. 서비스 제공업체가 주소, 포트, 인증 정보 또는 서버 이름을 변경해도 연결 스위치가 켜져 있다는 이유만으로 기존 항목이 새 정보로 바뀌지는 않습니다. 구독 내용을 다시 가져와야 합니다. 새 항목이 표시되는지는 서비스 제공업체가 실제로 반환한 내용에 따라 달라집니다.

현재 항목이 하나씩 수동으로 추가한 서버가 아니라 구독에서 가져온 것인지 먼저 확인하세요. 서버 설정만 개별 입력하고 구독 주소를 등록하지 않았다면 아래로 당겨 새로고침해도 새 목록을 가져올 수 없습니다. 구독을 처음 추가할 때는 Home 오른쪽 위의 「+」→ Type → Subscribe를 선택하고 본인이 보유한 구독 주소를 입력해 저장하세요. 이미 가져온 구독은 매번 다시 추가할 필요가 없습니다.

구독 목록: 구독 주소에서 반환되는 목록입니다. 업데이트 후 항목이 추가, 삭제 또는 변경될 수 있으며 목록 개수는 그대로일 수도 있습니다.
Config: 구성 파일과 규칙을 관리합니다. 서버 구독을 업데이트해도 별도로 관리하는 Config 구성 파일까지 업데이트되는 것은 아닙니다.
Global Routing: 연결에 Config, Proxy, Direct 등의 처리 방식을 적용합니다. 구독 업데이트 빈도를 설정하는 기능은 아닙니다.
서비스 이용 기간: 본인이 이용하는 서비스 제공업체가 관리합니다. 새로고침을 반복해도 요금제 기간이 연장되거나 사용량이 충전되지는 않습니다.

Home에서 수동 업데이트: 먼저 새로고침한 뒤 결과 확인하기

수동 업데이트는 처음 가져온 뒤 정상 작동을 확인하거나, 서비스 제공업체의 변경 안내를 적용하거나, 자동 업데이트 실패를 점검할 때 유용합니다. 시작하기 전에 기기가 네트워크에 정상적으로 연결되어 있는지 확인하세요. Home에 구독 그룹이 여러 개라면 대상 그룹 이름을 먼저 기록해 두세요. 다른 그룹의 목록 변화를 이번 업데이트 결과로 착각하지 않는 데 도움이 됩니다.

대상 확인

Home으로 이동해 업데이트할 구독 그룹을 찾으세요. 해당 그룹이 개별 서버의 연결 정보가 아니라 본인이 이용 중인 서비스 제공업체의 구독 주소를 사용하는지 확인합니다.
아래로 당겨 새로고침

Home의 목록 영역을 아래로 당겨 구독을 새로고침하세요. 구독 그룹이 여러 개라면 각 그룹의 업데이트 결과를 확인하세요. 한 그룹의 성공만으로 모든 그룹이 정상 업데이트됐다고 판단하지 마세요.
결과 확인

새로고침이 끝날 때까지 기다린 뒤 시간 초과, 파싱 실패 또는 다른 오류 메시지가 표시되는지 기록하세요. 요청이 진행 중일 때 연달아 새로고침하거나 요청 도중 구독 주소를 변경하지 마세요.
항목 확인

대상 그룹을 펼쳐 서비스 제공업체가 안내한 새 이름이나 항목이 나타났는지 확인하세요. 기존에 선택한 서버가 삭제됐다면 목록에 남아 있는 사용 가능한 항목을 다시 선택합니다.
연결 확인

실제로 이용하려는 페이지나 서비스에 접속해 연결을 확인하세요. ‘업데이트 성공 여부’와 ‘선택한 서버의 사용 가능 여부’를 따로 기록하고, 두 결과를 하나로 묶어 판단하지 마세요.

예를 들어 업데이트 전후 항목이 모두 12개여도 업데이트되지 않았다는 뜻은 아닙니다. 항목 하나의 서버 주소가 바뀌었지만 이름과 전체 개수는 그대로일 수 있습니다. 반대로 새 이름이 표시되어도 모든 서버에 연결할 수 있다는 보장은 없습니다. 목록 길이만 보지 말고 새로고침 결과, 예상한 변경 사항, 연결 상태를 함께 확인하세요.

앱 실행 시 자동 업데이트: Settings → Subscribe

수동 새로고침을 줄이려면 Settings → Subscribe로 이동해 Update on Open(앱 실행 시 업데이트)을 켜세요. 설정한 뒤 Shadowrocket을 다음에 열었을 때 Home에서 업데이트 결과를 확인합니다. 처음 설정을 마친 뒤에는 구독 주소와 현재 네트워크 경로가 정상적으로 작동하는지 수동 업데이트로 한 번 확인하는 것이 좋습니다.

‘앱 실행 시’ 업데이트는 앱을 열 때 실행되는 기능입니다. 일정한 간격으로 백그라운드에서 반복 요청한다는 뜻도, 앱이 항상 백그라운드에서 새 목록을 가져온다는 뜻도 아닙니다. 시스템 스케줄, 네트워크 상태, 앱이 요청을 처리 중인지 여부에 따라 실제 완료 시점이 달라질 수 있습니다. 이 옵션을 서비스 만료 알림이나 연결 유지 설정으로 사용하지 마세요.

두 가지 업데이트 방법: 사용 상황에 맞게 선택하기

수동 업데이트

경로: Home 목록을 아래로 당겨 새로고침
사용 상황: 처음 설정 확인, 변경 안내 확인, 오류 점검
장점: 한 번의 작업으로 요청 결과와 목록 변화를 확인할 수 있습니다.
주의: 관련 설정은 한 번에 하나씩 바꾸고 새로고침해 확인하세요.

앱 실행 시 업데이트

경로: Settings → Subscribe → Update on Open
사용 상황: 구독이 유효한지 확인했고 앱을 열 때 목록을 동기화하려는 경우
조건: 앱을 열 때 구독 주소에 접근할 수 있는 네트워크 경로가 있어야 합니다.
주의: 앱을 열었다고 요청이 반드시 성공하는 것은 아닙니다.

먼저 수동 업데이트로 구독이 유효한지 확인한 뒤 앱 실행 시 업데이트를 켜세요. 두 방법은 함께 사용할 수 있으며 구독을 반복해서 삭제하고 다시 가져올 필요는 없습니다.

자동 업데이트로 새 목록을 가져오지 못하면 같은 네트워크에서 수동으로 새로고침해 보세요. 수동 업데이트도 실패하면 네트워크나 링크를 점검해야 합니다. 수동 업데이트는 성공했지만 앱 실행 시 완료되지 않았다면 해당 옵션이 켜져 있는지, 앱을 열 때 수동 새로고침과 같은 네트워크 조건을 사용할 수 있는지 확인하세요.

Update via Proxy와 On Demand의 차이

일부 구독 주소는 현재 네트워크에서 직접 접근할 수 없지만, 이미 사용 가능한 연결을 거치면 접근할 수 있습니다. 이 경우 Settings → Subscribe에서 Update via Proxy를 확인하세요. 이 옵션은 구독 요청을 프록시를 통해 보낼지 결정합니다. 만료된 token을 복구하거나 사용할 수 없게 된 서버를 다시 작동시키는 기능은 아닙니다.

구독 요청 경로

설정 위치: Settings → Subscribe
옵션: Update via Proxy
기능: 구독 업데이트 요청을 프록시 경로로 보냅니다.
필요 조건: 사용 가능한 서버가 있고 해당 연결 경로가 이미 설정되어 있어야 합니다.

옵션을 전환한 뒤 Home으로 돌아가 수동 새로고침을 실행해 결과를 비교하세요. 시간 초과가 발생했다고 반드시 이 옵션을 켜야 하는 것은 아닙니다.

자동 연결 조건

설정 위치: Settings → On Demand
기능: 설정한 네트워크 조건에 따라 VPN 연결을 시작하거나 중지합니다.
업데이트와의 관계: 연결 가능 여부에 영향을 주지만 구독 새로고침을 대신하지는 않습니다.
확인 방법: 먼저 현재 연결 상태를 확인한 뒤 Home에서 업데이트를 점검하세요.

On Demand와 Update on Open은 서로 다른 설정입니다. 하나는 연결 조건을 처리하고, 다른 하나는 앱을 열 때 구독을 동기화합니다.

문제 해결 시 비교할 조건을 유지하세요. 현재 네트워크에서 먼저 새로고침하고 오류를 기록합니다. 사용 가능한 서버에 연결할 수 있다면 연결을 설정한 뒤 Update via Proxy를 확인하고 다시 시도하세요. 네트워크, Global Routing, 여러 구독 옵션을 동시에 바꾸면 업데이트에 성공하더라도 어떤 변경이 영향을 줬는지 판단하기 어렵습니다.

업데이트 실패 시: 오류 유형별로 확인하기

먼저 기존 구독을 보존하고 ‘삭제 후 다시 추가’를 첫 번째 해결 방법으로 삼지 마세요. 사용할 수 없는 주소를 다시 추가해도 보통 같은 결과가 나오며, 비교에 유용한 그룹과 선택 상태를 잃을 수 있습니다. 오류 메시지, 당시 네트워크, Update via Proxy 사용 여부, 특정 구독 그룹에서만 문제가 발생하는지 기록하면 원인을 찾는 데 도움이 됩니다.

아래로 당겨 새로고침해도 계속 시간 초과될 때는 어떤 설정부터 바꿔야 하나요?

먼저 기기가 현재 Wi-Fi의 네트워크 인증을 마쳤는지 확인한 뒤 Home에서 다시 시도하세요. 일반적인 인터넷 연결은 정상이지만 구독 요청이 시간 초과되면 본인이 사용할 수 있는 다른 네트워크에서 결과를 비교해 보세요. 사용 가능한 프록시 연결이 있다면 Settings → Subscribe → Update via Proxy도 확인합니다. 조건은 한 번에 하나씩 바꾸고 결과를 기록하세요.

파싱 실패가 표시됩니다. 네트워크를 바꿔도 해결되지 않는 이유는 무엇인가요?

파싱 실패는 주소가 유효한 구독 대신 로그인 페이지, 오류 메시지 또는 지원되지 않는 콘텐츠를 반환했을 때 발생할 수 있습니다. 원래 서비스 제공업체의 구독 관리 페이지에서 전체 주소를 다시 복사하고, 요금제 안내 페이지나 개별 서버 설정이 아닌지 확인하세요. 계속 실패하면 오류 메시지를 원래 서비스 제공업체에 전달하고 반환 형식을 확인하세요.

어제는 업데이트됐는데 오늘 권한 오류가 표시됩니다. 어떻게 해야 하나요?

원래 서비스 제공업체 계정의 유효 기간과 구독 token이 재설정됐는지 확인하세요. 요청 결과에 HTTP 401 또는 403이 포함되어 있으면 먼저 권한과 서비스 상태를 확인해야 합니다. 403은 서버 측 접근 제한으로도 발생할 수 있으므로 상태 코드만으로 요금제가 만료됐다고 단정할 수 없습니다. 새 주소를 받았다면 대상 구독을 수정한 뒤 새로고침하세요.

업데이트에 성공했는데 목록은 왜 그대로인가요?

먼저 대상 구독 그룹이 맞는지 확인하고, 서비스 제공업체가 실제로 변경 사항을 게시했는지 확인하세요. 이름이 같아도 연결 매개변수가 업데이트됐을 수 있습니다. 반환된 내용에 변화가 없다면 목록이 그대로인 것은 정상입니다. 목록 개수를 바꾸려고 요청을 연달아 반복하지 마세요.

업데이트 후 목록이 비어 있습니다. 구독을 바로 삭제해야 하나요?

먼저 그룹이 펼쳐져 있는지, 검색 필터가 적용되어 있는지 확인한 다음 새로고침 중 파싱 오류가 발생했는지 살펴보세요. 주소가 완전하고 서비스가 유효한데도 목록이 비어 있으면 원래 서비스 제공업체에 해당 계정으로 반환되는 내용을 확인해 달라고 요청하세요. 원인이 밝혀질 때까지 주소와 오류 기록을 보관하고 모든 구성을 반복해서 삭제하지 마세요.

구독 주소는 https://example.com/sub?token=xxxx와 같은 형태일 수 있습니다. 사용할 수 없는 예시일 뿐입니다. 실제 주소의 경로, 매개변수 이름, 문자는 본인의 서비스 제공업체가 제공한 내용에 따릅니다. 복사할 때 줄바꿈, 공백, 채팅 문구가 포함되지 않도록 하고 물음표 뒤의 매개변수를 임의로 삭제하지 마세요. &와 같은 구분자도 중요할 수 있으므로 주소 전체를 복사하세요.

업데이트 후 확인: 목록 동기화와 연결 가능 여부를 따로 판단하기

구독 요청 성공은 클라이언트가 반환된 내용을 가져와 처리했다는 뜻일 뿐입니다. 서버에 접근할 수 있는지, 인증 정보가 유효한지, Global Routing이 예상한 대로 설정됐는지는 연결 단계에서 별도로 확인해야 합니다. 목록은 업데이트됐는데 접속이 계속 실패한다면 새로고침을 반복해도 규칙이나 연결 문제는 해결되지 않습니다.

선택한 항목 확인: Home으로 돌아가 선택한 서버가 업데이트된 그룹에 남아 있는지 확인하세요. 기존 항목이 삭제됐다면 다른 서버를 다시 선택합니다.
모드 확인: 규칙에 따라 트래픽을 분리해야 한다면 Global Routing이 Config로 설정되어 있는지 확인하고 실제 적용 중인 구성을 점검하세요. Proxy와 Direct는 처리 방식이 다르므로 같은 테스트 조건으로 취급하지 마세요.
규칙 확인: Config의 DOMAIN-SUFFIX, IP-CIDR, GEOIP 규칙과 FINAL 기본 처리는 규칙 설정에 해당합니다. 서버 구독을 새로고침해도 자동으로 수정되지 않습니다.
인증 정보 확인: 특정 서버만 실패한다면 같은 그룹의 다른 항목과 각각 연결을 테스트하세요. 개별 연결 문제를 구독 전체의 업데이트 실패로 착각하지 않도록 합니다.
자동 업데이트 확인: 수동 새로고침이 정상인 것을 확인한 뒤 Update on Open 설정을 유지하고, 다음에 앱을 열 때 결과를 확인하세요. 요청을 반복하려고 앱을 자주 종료했다가 다시 열 필요는 없습니다.

평소에는 일정한 순서로 확인하면 됩니다. 서비스 제공업체의 변경 안내를 받으면 Home에서 수동 새로고침하고, 예상한 항목이 있는지 확인한 뒤 현재 선택을 점검하고 실제 접속을 테스트하세요. 이후 앱 실행 시 업데이트로 목록을 동기화할 수 있습니다. 실패하면 요청 실패, 콘텐츠 파싱 실패, 연결 실패를 구분해 해당 단계의 문제를 해결하세요.