Shadowrocket 구독 업데이트 오류 해결: 수동 업데이트, 앱 실행 시 자동 업데이트 설정 및 점검 순서

먼저 구분하기: 구독 업데이트 오류인가요, 연결 오류인가요?

Shadowrocket의 구독 업데이트는 사용자가 제공한 주소에서 서버 정보를 가져와 Home 목록에 반영하는 과정입니다. 앱 자체를 업데이트하는 것도, 특정 서버에 연결하는 것도 아닙니다. 목록에 기존 항목이 보인다고 해서 이번 새로고침까지 성공한 것은 아닙니다. 기기에 저장된 데이터가 남아 있다는 뜻일 뿐입니다.

먼저 어느 단계에서 문제가 생겼는지 확인하세요. 새로고침 직후 오류가 표시되는지, 한참 기다린 뒤 시간 초과가 발생하는지, 업데이트 완료로 표시되지만 새 항목이 없는지 기록합니다. 업데이트가 완료됐는데 특정 서버에 연결할 수 없다면 연결 테스트를 진행하세요. 구독을 반복해서 삭제하고 다시 추가할 필요는 없습니다.

이 과정으로 흔한 두 가지 상황을 설명할 수 있습니다. 기존 서버에는 여전히 연결되지만 구독 주소는 만료됐을 수 있고, 구독은 정상적으로 새로고침되지만 그 안의 특정 서버가 일시적으로 작동하지 않을 수도 있습니다. 두 상황은 서로 모순되지 않습니다. 전자는 목록을 가져오는 단계의 문제이고, 후자는 목록을 사용한 뒤 발생하는 문제입니다.

수동 업데이트: Home에서 시작하고 기존 구독 유지하기

먼저 수동 업데이트를 한 번 진행해 전체 결과를 확인하세요. 처음부터 구독을 다시 추가하지 마세요. 같은 주소를 여러 번 가져오면 Home에 출처 그룹이 중복으로 생겨 확인하기 어려워질 수 있습니다. 주소를 다시 입력해야 한다면 기존 구독을 확인하고 수정하는 편이 좋습니다.

1. 구독 찾기

   Home으로 이동해 업데이트할 구독 그룹을 확인합니다. 그룹 이름과 현재 항목 수를 기록해 개별적으로 추가한 서버를 구독 항목으로 착각하지 않도록 하세요.

2. 주소 확인

   해당 구독의 편집 화면을 열고 URL이 서비스 제공업체가 안내한 주소와 일치하는지 확인합니다. 처음 가져올 때는 Home → 오른쪽 위 “+” → Type → Subscribe 순서로 진행합니다. 이미 구독이 있다면 새로 만들 필요가 없습니다.

3. 아래로 당겨 새로고침

   Home으로 돌아가 목록을 아래로 당겨 새로고침을 시작한 뒤 요청이 끝날 때까지 기다립니다. 구독이 여러 개라면 각 그룹의 결과를 따로 확인하세요. 한 그룹이 성공했다고 해서 모두 성공한 것은 아닙니다.

4. 결과 확인

   성공 또는 오류 메시지를 기록한 뒤 대상 그룹을 확인합니다. 항목 수가 그대로여도 원격 목록의 내용이 바뀌지 않았을 수 있습니다. 요청과 분석이 완료됐는지는 업데이트 알림과 함께 판단하세요.

앱 실행 시 자동 업데이트: Settings에서 설정하기

자동 업데이트를 사용하면 평소 수동으로 조작할 일이 줄지만, 만료된 링크가 복구되는 것은 아닙니다. 먼저 수동 업데이트가 성공하는지 확인한 다음 앱 실행 시 자동 업데이트를 켜세요. Settings → Subscribe로 이동해 Update On Open을 활성화합니다. 앱 업데이트에 따라 메뉴의 문구나 위치가 달라질 수 있으므로 실제 화면을 기준으로 확인하세요.

이 설정은 앱을 열 때 구독 업데이트를 시작하는 기능입니다. 정해진 간격으로 계속 실행되는 백그라운드 새로고침 기능은 아닙니다. 앱으로 돌아온 뒤 업데이트 여부를 확인하기 어렵다면 설정을 반복해서 켰다 끄기보다 Home에서 직접 새로고침하고 결과를 확인하는 편이 명확합니다.

• 먼저 옵션 확인: Settings → Subscribe → Update On Open. 서버 목록의 자동 새로고침 설정을 Config에서 찾지 마세요.
• 그다음 동작 확인: 옵션을 켠 뒤 앱을 다시 열고 요청이 끝날 때까지 기다린 다음 대상 구독에 업데이트 결과가 표시되는지 확인합니다. Home 화면이 보인다고 해서 요청이 성공한 것은 아닙니다.
• 현재 네트워크 확인: 앱을 열 때 인터넷에 연결되어 있지 않거나 Wi-Fi 인증이 필요한 상태라면 자동 업데이트가 실패할 수 있습니다. 연결이 복구된 뒤 수동으로 다시 새로고침하세요.
• 기능을 혼동하지 마세요: Settings → On Demand는 필요할 때 연결을 관리하는 옵션이며 Subscribe의 업데이트 설정을 대신하지 않습니다. 연결 시작과 구독 새로고침은 서로 다른 동작입니다.

자동 업데이트는 실패하지만 수동 업데이트는 성공한다면 먼저 두 작업을 수행할 때의 네트워크와 연결 상태를 비교하세요. 앱을 여는 순간 Wi-Fi와 셀룰러 네트워크가 전환 중이었을 수 있습니다. 한 번의 차이만으로 설정 오류라고 단정하지 말고 같은 네트워크에서 다시 확인하세요.

1단계: 구독 링크 만료 및 접근 권한 변경 점검

먼저 이용 중인 서비스 제공업체에 구독 주소가 여전히 유효한지 확인하세요. 웹사이트 로그인 주소를 구독 주소로 대신 사용하거나 기억에 의존해 쿼리 매개변수를 삭제하지 마세요. 길어 보이는 URL에는 계정 식별 정보, 접근 자격 증명, 출력 형식 선택이 함께 포함될 수 있습니다. 매개변수 하나가 빠져도 다른 응답을 받을 수 있습니다.

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

위 주소는 실제로 가져올 수 없는 예시입니다. 실제 문제를 확인할 때는 기기에서 주소와 출처를 문자 단위로 대조하세요. 특히 프로토콜, 도메인, 경로, 물음표 뒤의 매개변수와 복사 과정에서 포함된 공백이나 줄바꿈을 살펴보세요. 실제 주소를 공개 웹페이지나 출처를 알 수 없는 변환 도구에 입력하지 마세요.

• 주소가 재발급됨: 서비스 제공업체가 구독 링크를 새로 발급했다면 이전 token이 더 이상 유효하지 않을 수 있습니다. 기존 구독에 새 전체 주소를 저장한 다음 새로고침하세요.
• 접근 권한 변경: 계정 상태, 이용 기간 또는 서비스 제공업체의 접근 제한이 구독 응답에 영향을 줄 수 있습니다. 앱 구매 상태가 이러한 접근 권한을 대신하지는 않습니다.
• 401 또는 403 응답: 오류 상세 정보에 이 HTTP 상태 코드가 표시된다면 먼저 인증 및 접근 제한을 확인하세요. 숫자만으로 원인을 하나로 단정할 수는 없습니다.
• 404 응답: 전체 경로와 구독 주소가 변경됐는지 확인하세요. 이때 서버 포트를 무작정 바꿔도 구독 API 경로 문제는 대개 해결되지 않습니다.
• 429 응답: 연속으로 새로고침하지 말고 서비스 제공업체의 안내에 따라 기다린 뒤 다시 시도하세요. 재시도를 반복하면 요청 빈도 제한이 계속 적용될 수 있습니다.

브라우저에서 같은 도메인의 홈페이지가 열린다고 해서 구독 API까지 정상이라는 뜻은 아닙니다. 홈페이지와 구독 경로에 서로 다른 권한 확인이 적용될 수 있으며, 로그인 페이지로 이동하더라도 서버 목록을 받은 것은 아닙니다. 도메인 접속 여부가 아니라 전체 구독 URL의 응답을 확인하세요.

2단계: 현재 네트워크 및 요청 시간 초과 점검

링크가 유효한지 확인한 뒤에는 기기에서 구독 주소의 호스트에 안정적으로 접속할 수 있는지 살펴봅니다. 먼저 Wi-Fi 웹 인증을 완료하고 일반 웹페이지가 정상적으로 열리는지 확인한 뒤 Wi-Fi와 셀룰러 네트워크를 비교하세요. 주소, 모드, 네트워크를 한꺼번에 바꾸면 원인을 비교하기 어려우므로 한 번에 조건 하나만 변경합니다.

위 영어 문구는 점검 중에 볼 수 있는 오류 예시입니다. 시스템 언어와 오류 발생 위치에 따라 표시되는 문구가 다를 수 있으므로 특정 문구만 기준으로 삼지 마세요. 인증서 관련 경고가 표시되면 기기의 날짜와 시간을 확인하고 서비스 제공업체에 인증서를 점검해 달라고 요청하세요. 인증서 검증을 무시해 문제를 우회하지 마세요.

1. 시스템 설정에서 네트워크 연결 상태를 확인하세요. 웹 인증이 필요한 Wi-Fi라면 먼저 인증을 완료합니다.
2. 현재 Shadowrocket 연결 상태와 Global Routing 선택 항목을 기록한 뒤, 기존 상태에서 한 번 새로고침합니다.
3. Wi-Fi 또는 셀룰러 네트워크만 바꾼 뒤 같은 구독을 새로고침해 결과를 비교합니다.
4. 현재 연결이 요청에 영향을 주는 것으로 의심되면 조건을 통제할 수 있는 상황에서 연결을 끊고 다시 테스트하세요. On Demand가 활성화된 경우 연결이 다시 시작되는지도 확인합니다.

Global Routing의 Proxy, Direct, Config, Scene은 전체 트래픽을 처리하는 방식을 선택하는 항목이지 구독을 복구하는 버튼이 아닙니다. 주소 하나를 새로고침하려고 모든 트래픽 처리 방식을 계속 강제로 바꾸거나, 검증 없이 DIRECT 규칙을 추가하지 마세요. 구독 요청이 실제로 어떤 경로를 사용하는지는 현재 연결과 설정을 함께 확인해야 합니다.

3단계: 응답 내용 및 인식할 수 없는 형식 점검

네트워크 요청이 완료돼도 가져올 수 있는 항목이 없을 수 있습니다. HTTP 200은 HTTP 수준에서 요청이 성공했다는 뜻일 뿐입니다. 응답 본문은 로그인 페이지, 점검 안내 페이지, 오류 설명 또는 현재 가져오기 방식에서 인식할 수 없는 데이터일 수 있습니다. 이 경우 네트워크를 계속 바꿔도 해결되지 않을 수 있습니다.

• 먼저 가져오기 유형 확인: Home → “+” → Type → Subscribe는 구독을 가져오는 메뉴입니다. Config는 구성 파일을 관리하므로 전체 구성 파일 주소와 서버 구독 주소를 같은 종류의 입력으로 취급하면 안 됩니다.
• 그다음 출력 용도 확인: 서비스 제공업체에 Shadowrocket을 사용한다고 알리고, 제공된 구독 출력이 현재 가져오기 방식에 맞는지 확인하세요. 파일 확장자만 보고 판단하지 마세요.
• 응답이 비어 있는지 확인: 응답 내용이 비어 있거나 인식 가능한 서버 항목이 없으면 목록이 예상대로 업데이트되지 않을 수 있습니다. 먼저 로컬 목록을 지우지 말고 서비스 제공업체에 응답 본문을 확인해 달라고 요청하세요.
• 항목 정보 확인: Address, Port와 해당 프로토콜에 필요한 인증 정보가 서버 설정과 일치해야 합니다. 구독을 읽을 수 있다고 해서 모든 항목의 매개변수를 사용할 수 있다는 뜻은 아닙니다.

Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 프로토콜 이름이고 Subscribe는 구독을 가져오는 유형입니다. 두 서비스에 같은 프로토콜 이름이 적혀 있어도 구독 데이터의 구성 방식까지 같다고 볼 수는 없습니다. 프로토콜, 구독 형식, 전체 구성 구조는 서로 다른 개념입니다.

업데이트 후 마무리: 항목을 확인하고 중복 정리하기

업데이트가 성공하면 먼저 대상 그룹을 확인한 다음 그중 항목 하나를 골라 연결을 테스트하세요. Connectivity Test는 테스트 조건에서의 연결 가능성과 지연 시간을 확인하는 데 도움이 되지만 속도 테스트는 아닙니다. 측정값 하나만으로 모든 웹사이트와 서비스가 정상이라고 판단할 수 없습니다.

1. 업데이트 결과 확인: 대상 그룹 이름과 항목 변경 여부를 확인하세요. 서비스 제공업체가 내용을 변경하지 않았다면 항목 수와 이름이 그대로인 것도 정상일 수 있습니다.
2. 실제 연결 테스트: 기존 항목을 선택해 Connectivity Test를 실행한 다음 필요한 페이지를 직접 열어 보세요. 목록 새로고침 성공 여부와 실제 접속 성공 여부는 따로 기록합니다.
3. 중복된 출처 확인: 같은 구독을 여러 번 가져왔다면 올바른 주소가 설정된 그룹을 먼저 확인한 다음 불필요한 그룹을 삭제하세요. 서버 표시 이름만 보고 중복 여부를 판단하지 마세요.
4. 관리 기록 보관: 이번에 변경한 항목이 URL, 네트워크, 자동 업데이트 설정 중 무엇인지 기록하세요. 같은 문제가 다시 발생하면 해당 단계부터 확인할 수 있습니다.

계속 실패하면 네트워크 종류, 발생 시각, 전체 오류 문구, 시도한 단계를 서비스 제공업체에 전달하고 비공개 지원 채널을 통해 구독 권한을 확인하세요. 공개 화면을 공유할 때는 인증 정보를 가리세요. 단순히 “업데이트가 안 돼요”라고 문의하는 것보다 주소, API 응답, 형식 중 어디에 문제가 있는지 파악하기 쉽습니다.

Shadowrocket은 한 번 구매하면 계속 사용할 수 있는 클로즈드 소스 상용 앱이며, 주로 iPhone과 iPad에서 이용합니다. 유일한 공식 제공 경로는 App Store입니다. 시스템 요구 사항은 App Store 페이지의 안내를 기준으로 확인하세요. 앱 구매 ≠ 서버 이용권. 앱을 구매해도 서버나 구독이 자동으로 제공되지는 않습니다. 이 사이트에서는 사용자가 이미 보유한 구독의 관리 방법만 안내하며, 서버나 구독을 제공·판매·추천하지 않습니다.