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

이 글의 핵심

이미 본인 구독 서비스의 URL을 보유한 사용자를 위한 안내입니다. 먼저 Home에서 해당 구독을 수동으로 업데이트한 다음, Settings → Subscribe에서 앱 실행 시 자동 업데이트 옵션을 확인하세요. 실패하면 링크, 네트워크, 응답 콘텐츠 순서로 원인을 좁혀 갑니다. 업데이트가 완료된 뒤에는 서버 연결 상태를 별도로 확인해야 합니다. 구독 새로고침 성공이 연결 사용 가능을 뜻하지는 않습니다.

구독을 업데이트하면 무엇이 바뀌나요?

Shadowrocket의 구독 업데이트는 저장된 구독 URL에 다시 요청을 보내고 응답에 포함된 서버 설정을 불러오는 작업입니다. 앱 자체를 업데이트하는 것이 아니며, Config의 규칙 파일을 새로고침하는 것과도 다릅니다. 이 글에서는 보유 중인 구독을 관리하는 방법만 설명하며, 구독이나 관련 서비스를 제공·판매·추천하지 않습니다.

업데이트 후 서버가 추가되거나 기존 항목이 삭제될 수 있으며, 주소·포트·연결 매개변수가 바뀔 수도 있습니다. 구독 항목을 직접 수정했다면 다음 새로고침에서 원격 설정이 다시 적용될 수 있으므로 중요한 변경 사항은 먼저 기록해 두세요. 기존에 선택한 항목이 삭제되었다면 Home에서 선택 상태도 다시 확인해야 합니다. 전체 항목 수만 확인해서는 안 됩니다.

Home

구독 그룹, 업데이트 결과 및 현재 서버 확인

Settings → Subscribe

구독 자동 업데이트와 요청 경로 설정 확인

Config

설정 파일 및 규칙 관리: 서버 구독과는 별개

정리: 먼저 업데이트 대상을 확인하세요

서버 목록을 업데이트하려면 Home에서 구독을 관리하세요. DOMAIN-SUFFIX, GEOIP, IP-CIDR 또는 FINAL의 매칭 방식을 변경하려면 현재 사용 중인 Config를 확인해야 합니다. 규칙 순서를 바로잡으려고 서버 구독을 반복해서 새로고침하지 마세요.

Home에서 구독 수동 업데이트하기

처음 가져온 뒤, 서비스 제공자가 설정 변경을 알린 뒤, 또는 자동 업데이트 결과가 불분명할 때는 먼저 대상 구독을 수동으로 업데이트하세요. 구독이 여러 개라면 각각 따로 실행하고 결과를 기록해 다른 구독의 성공 메시지를 현재 구독의 복구로 착각하지 않도록 합니다.

그룹 확인

Home을 열고 새로고침할 구독 그룹을 찾습니다. 메모와 포함된 항목을 확인해 가져온 구독인지, 직접 추가한 개별 서버인지 구분하세요.
링크 확인

해당 구독의 편집 정보를 열어 URL이 온전한지 확인합니다. 다시 추가해야 한다면 Home → + → Type → Subscribe로 이동해 본인 구독 URL을 입력하고 저장하세요. 문제를 해결할 때는 기존 항목을 유지하고 처음부터 삭제하지 않는 편이 좋습니다.
업데이트 실행

Home에서 구독 그룹 제목 행을 왼쪽으로 밀고 Update를 선택합니다. 그룹 안의 개별 서버 행이 아니라 구독 행에서 실행해야 합니다. 두 작업의 대상은 서로 다릅니다. 요청이 끝날 때까지 기다리고 새로고침을 연달아 실행하지 마세요.
결과 확인

실패 메시지가 있는지 확인하고 그룹의 주소, 포트 또는 항목에 예상한 변화가 있는지 살펴봅니다. 목록이 바뀌지 않았다고 반드시 실패한 것은 아닙니다. 원격에서 동일한 콘텐츠를 반환하면 새로고침 후에도 그대로일 수 있습니다.
연결 확인

Home에서 선택된 서버를 다시 확인한 다음 Connectivity Test를 실행합니다. 실제 연결을 테스트하려면 연결 스위치가 켜져 있는지와 시스템 VPN 권한이 승인되었는지 확인하세요. 구독 요청이 완료되어도 데이터 연결이 설정된 것은 아닙니다.

앱 실행 시 자동 업데이트 설정 방법

Settings → Subscribe로 이동해 앱 실행 시 구독을 업데이트하는 옵션인 Update on Open을 찾아 필요에 따라 켭니다. 화면의 대소문자 표기와 배열은 설치된 버전에 따라 다를 수 있습니다. 설정을 켠 뒤에는 다음에 앱을 열었을 때 Home에서 결과를 확인하세요. 스위치가 켜져 있다는 사실만으로 업데이트가 실행되었다고 판단하면 안 됩니다.

앱을 열 때 업데이트하는 기능은 실행 조건이지 일정한 간격으로 동작하는 백그라운드 작업이 아닙니다. 앱이 열려 있지 않을 때 계속 새로고침하거나, 앱을 백그라운드로 전환할 때마다 요청을 즉시 완료한다고 보장하지 않습니다. 성공적으로 업데이트하려면 네트워크 연결, 유효한 링크, 해석 가능한 응답 콘텐츠가 필요합니다.

현재 상태부터 확인:다른 기기의 설정을 기준으로 기본값을 추측하지 말고 본인 기기에서 옵션이 켜져 있는지 확인하세요.
먼저 수동으로 확인:수동 Update가 성공하는지 확인한 뒤 자동 실행 조건을 점검하면 여러 변수를 동시에 살펴보는 일을 줄일 수 있습니다.
완료될 때까지 기다리기:앱을 연 뒤 요청이 끝날 때까지 기다리세요. Home에 처음 표시되는 목록은 이전에 저장된 내용일 수 있습니다.
자동 연결과 구분:Settings → On Demand는 조건에 따라 VPN 연결을 설정하는 기능이지 구독 업데이트 일정이 아닙니다. 자동 새로고침 문제를 확인할 때 On Demand부터 변경하지 마세요.

옵션을 켠 뒤에도 새로고침 여부가 불분명하다면, 먼저 본인 구독 서비스에 원격 설정이 실제로 변경되었는지 확인한 다음 Home의 내용과 비교하세요. 항목 수가 같다고 자동 업데이트가 실행되지 않았다고 단정할 수 없으며, 항목 수가 늘었다고 모든 항목의 연결이 정상이라고 볼 수도 없습니다.

업데이트 시간 초과: 먼저 요청 경로 확인

구독 URL에 접근할 수 있는지와 목록에 있는 서버에 연결할 수 있는지는 별개의 문제입니다. 일반 네트워크로 구독 도메인에 접근할 수 없어도 기존 연결을 통해서는 접근할 수 있습니다. 반대로 현재 선택된 서버가 작동하지 않으면 프록시를 통한 구독 요청도 실패할 수 있습니다.

점검 항목	설정 위치	확인 방법
현재 네트워크	기기의 Wi-Fi 또는 셀룰러 네트워크 설정	네트워크만 전환한 뒤 같은 구독을 업데이트하세요. 결과가 달라지면 요청 경로를 추가로 확인해야 합니다.
기존 연결	Home → Connectivity Test	먼저 현재 서버가 작동하는지 확인하세요. 이미 끊긴 연결로 대체 설정을 가져오려고 해서는 안 됩니다.
프록시를 통한 업데이트	Settings → Subscribe → Update via Proxy	기존 연결은 사용할 수 있지만 직접 요청은 실패한다면 이 옵션을 켜고 다시 시도해 결과를 비교할 수 있습니다.
라우팅 모드	Home → Global Routing	현재 Config, Proxy, Direct 또는 Scene 중 어떤 모드인지 기록하세요. 라우팅 모드와 새로고침 설정을 동시에 변경하지 않도록 합니다.

Update via Proxy는 모든 문제를 해결하는 옵션이 아닙니다. 켜기 전에 사용할 수 있는 서버를 선택하고 연결해야 합니다. 구독 주소에 직접 접근할 수 있는 경우에는 이 옵션을 끈 상태에서도 결과를 확인하세요. Global Routing의 Proxy는 프록시 모드, Direct는 직접 연결, Config는 설정에 따른 처리, Scene은 지정된 장면에 따른 동작을 뜻합니다. 어느 쪽을 선택해도 자동 업데이트가 켜지는 것은 아닙니다.

한 번에 한 항목씩 변경하는 것이 좋습니다. 기존 값을 기록하고 수동 새로고침을 한 번 실행한 뒤 결과를 남기고 다음 단계로 넘어가세요. 네트워크, 서버, 여러 스위치를 한꺼번에 바꾸면 업데이트가 다시 작동하더라도 무엇이 원인이었는지 알 수 없습니다.

오류 메시지로 실패 원인 구분하기

아래는 네트워크 계층이나 HTTP 응답에 표시될 수 있는 오류 원문입니다. 실제 메시지의 언어와 표시 방식은 다를 수 있으므로 기기에 나타난 내용을 빠짐없이 기록하세요. 매번 같은 문구가 표시되는 것은 아닙니다. 단순히 “업데이트 실패”라는 메시지만으로는 링크 만료와 연결 중단을 구분할 수 없습니다.

오류: The request timed out.

원인 및 해결 방법:대기 시간 안에 요청이 완료되지 않은 상태입니다. 네트워크, DNS 또는 원격 서버 응답이 원인일 수 있습니다. 먼저 Wi-Fi와 셀룰러 네트워크를 바꿔 다시 시도하세요. 사용 가능한 연결이 있다면 Settings → Subscribe → Update via Proxy 옵션을 켜기 전과 후의 결과를 비교할 수 있습니다. 시간 초과만으로 구독이 만료되었다고 판단할 수는 없습니다.

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

원인 및 해결 방법:구독 도메인 이름을 확인할 수 없는 상태입니다. URL의 호스트 이름이 온전한지, 공백이나 불필요한 문장 부호가 들어 있지 않은지 확인한 뒤 네트워크를 바꿔 테스트하세요. 계속 실패하면 본인 구독 서비스에 해당 도메인이 아직 사용 중인지 문의하세요.

오류: HTTP 401 Unauthorized

원인 및 해결 방법:서버가 유효한 인증을 요구합니다. 현재 사용 중인 전체 구독 URL을 복사했는지 확인하고 로그인 페이지 주소와 혼동하지 마세요. 인증 매개변수가 초기화되었다면 본인 계정 페이지에서 링크를 다시 받아 저장된 URL을 업데이트하세요.

오류: HTTP 403 Forbidden

원인 및 해결 방법:서버가 이번 요청을 거부했습니다. 인증, 접근 제한 또는 계정 상태와 관련된 문제일 수 있습니다. 먼저 전체 링크가 맞는지 확인한 뒤 본인 구독 서비스에 상태 코드와 발생 조건을 전달하세요. 403만으로 프로토콜을 바꿔야 한다고 단정하지 마세요.

오류: HTTP 404 Not Found

원인 및 해결 방법:요청한 경로에 해당하는 리소스가 없습니다. 경로가 잘리지 않았는지, 쿼리 매개변수가 빠지지 않았는지 확인하고 구독 주소가 변경되었는지 문의하세요. 같은 잘못된 링크를 반복해서 새로고침해도 대개 결과는 달라지지 않습니다.

인증서 관련 오류가 표시되면 기기의 날짜와 시간, 구독 도메인, 현재 네트워크에서 로그인 차단이 발생하는지 확인한 뒤 본인 구독 서비스에 인증서를 점검해 달라고 요청하세요. 보안 검사를 무시해 원인을 덮어서는 안 됩니다. 공용 네트워크에서 로그인이 필요한 경우 시스템 설정에서 먼저 로그인한 뒤 앱으로 돌아와 다시 시도하세요.

링크가 열리는데도 왜 해석되지 않나요?

HTTP 요청이 성공했다고 해서 응답 콘텐츠가 올바른 구독이라는 뜻은 아닙니다. 서버에서 계정 로그인 페이지, 만료 안내 페이지 또는 네트워크 인증 페이지를 반환할 수 있습니다. 페이지가 정상적으로 표시되더라도 Shadowrocket에서 가져올 수 있는 서버 목록은 아닙니다.

아래 주소는 구조를 보여 주기 위한 예시이며 실제로 사용할 수 있는 구독 링크가 아닙니다. 실제 링크의 쿼리 매개변수는 인증 정보의 일부이므로 복사할 때 빠짐없이 보존해야 합니다. 공개 그룹이나 알 수 없는 변환 페이지에 보내지 마세요.

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

복사할 주소:본인 계정에 표시된 구독 주소를 사용하세요. 계정 센터 URL을 복사하거나 QR 코드 이미지 주소를 구독 콘텐츠로 사용하지 마세요.
매개변수 보존:물음표 뒤의 매개변수와 & 같은 구분자를 그대로 유지하세요. 메신저에서 URL이 자동으로 줄바꿈되거나 직접 수정·삭제하면 인증이 무효화될 수 있습니다.
응답 콘텐츠 유형:HTML 로그인 페이지, 안내 페이지 또는 빈 응답이 반환되면 먼저 접근 권한이나 계정 상태를 확인하세요. Global Routing을 바꾼다고 웹페이지가 구독으로 바뀌지는 않습니다.
형식 호환성:출력 형식이 Shadowrocket에서 인식되는 구독 형식인지, 다른 설정 구조나 개별 규칙 파일이 아닌지 본인 구독 서비스에 확인하세요.
일부 항목만 실패:일부 항목만 누락되었다면 해당 항목의 프로토콜 필드가 빠짐없이 포함되었는지 확인하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 필요한 매개변수가 서로 다릅니다. Type을 임의로 바꾸는 것으로 원본 설정 문제를 해결하려고 하지 마세요.

업데이트 후 확인 및 자주 묻는 질문

새로고침이 끝나면 그룹, 선택된 서버, Connectivity Test, 실제 접속 순서로 확인하세요. 규칙에 따른 접속 결과는 Config에서 점검하고, 서버 인증이나 전송 오류는 해당 항목의 매개변수를 확인해야 합니다. 문제를 단계별로 나누면 연결 오류를 구독 오류로 오인하지 않을 수 있습니다.

구독 업데이트는 성공했는데 서버 수가 그대로인 이유는 무엇인가요?

원격 설정에서 주소, 포트 또는 인증 매개변수만 변경했을 수도 있고 아무것도 바뀌지 않았을 수도 있습니다. 항목 수만 비교하지 말고 변경될 것으로 예상한 내용을 확인하세요. 여전히 궁금한 점이 있다면 본인 구독 서비스에 해당 URL이 현재 반환하는 콘텐츠를 문의하세요.

자동 업데이트를 켜도 수동으로 새로고침해야 하나요?

문제 해결 중에는 필요합니다. 먼저 Home에서 대상 구독을 Update해 링크와 네트워크가 정상인지 확인한 다음 Settings → Subscribe에서 Update on Open을 점검하세요. 이렇게 하면 요청 실패와 자동 실행 조건 미충족을 구분할 수 있습니다.

새로고침 후 기존에 선택한 서버가 사라졌다면 어떻게 해야 하나요?

먼저 올바른 구독 그룹을 확인한 다음 이번 업데이트 후 남아 있는 항목 중에서 서버를 다시 선택하고 Connectivity Test를 실행하세요. 원격에서 기존 항목이 삭제되거나 이름이 바뀐 뒤에도 선택 상태가 유지될 것이라고 가정하지 마세요.

문제 해결을 위해 전체 구독 링크를 다른 사람에게 보내야 하나요?

대개 오류 원문, 네트워크 유형, 수동 업데이트 결과, Update via Proxy 설정 상태를 먼저 공유하면 됩니다. URL 경로의 인증 정보, 쿼리 매개변수, 비밀번호와 계정 정보는 가리세요. 전체 링크가 이미 노출되었다면 본인 계정에서 재설정한 뒤 새 링크를 저장하세요.

연결 설정을 더 확인하려면 설정 가이드를 참고하세요. Shadowrocket은 Apple 플랫폼용 상용 폐쇄형 앱으로, 주로 iPhone과 iPad에서 사용합니다. 앱을 받을 수 있는 유일한 경로는 App Store입니다. 클라이언트 앱의 1회 구매와 회선 요금제는 별개입니다. 가격, 시스템 요구 사항 및 구매 가능 여부는 App Store 페이지를 기준으로 확인하세요.