Clash Verge Rev 업데이트 멈춤: 다운로드·취소 해결

진행률, 대기 시간, 첫 오류와 취소 후 변화를 기록하세요. 설치 프로그램이 이미 시작됐다면 강제로 종료하지 말고 결과를 기다리세요. 아직 다운로드 중이라면 아래의 공식 설치 파일을 사용하는 절차를 따르세요.

이번 확인 기준 공식 최신 안정 버전은 v2.5.8입니다. 이전 업데이트 기능은 이번 업그레이드를 완료해야 새 구현을 쓸 수 있으며 이전 창을 반복해서 열어도 수정이 적용되지 않습니다. 다음 업데이트를 시험하려고 다운그레이드할 필요는 없습니다.

공식 issue #8172는 Windows에서 v2.5.6을 v2.5.7로 업그레이드할 때 이미 받은 데이터를 다시 다운로드하고, 속도가 매우 느리며, 취소해도 실제로 멈추지 않는 문제를 보고했습니다. 이후 유지관리자가 캐시 재사용과 다운로드 취소를 수정한 커밋을 연결했고, 2026년 10월 9일 공개된 v2.5.8에는 이 세 가지 수정이 명시되어 있습니다. 그렇다고 업데이트가 멈추는 모든 사례를 같은 결함으로 단정할 수는 없습니다.

해당 버전의 소스 코드에서는 처음 각 다운로드 소스를 시도할 때 30초마다 진행 상황을 확인하며, 그동안 새로 받은 데이터가 1 MiB 미만이면 다른 소스로 전환합니다. 모든 소스의 첫 번째 시도가 실패한 뒤 두 번째로 시도할 때는 다운로드가 정체되는지만 판단합니다. 따라서 “30초 안에 자동 해결된다”고 홍보하거나 GitHub를 항상 먼저 시도하는 것이 구현 규칙이라고 설명해서는 안 됩니다.

새 버전에서도 취소 버튼과 창 닫기를 구분해야 합니다. 취소 버튼은 백엔드 처리를 호출하지만, 창을 닫는 동작은 화면만 숨깁니다. 준비 또는 다운로드 단계에서만 취소하고, 해당 작업이 끝난 것을 확인한 뒤 다시 시도하세요. 설치 단계에서는 창을 닫았다고 설치가 중단된 것으로 판단하지 마세요.

다운로드가 멈췄을 때의 진행률, 기다린 시간, 첫 번째 오류와 설치가 아직 진행 중인지 기록하세요. 브라우저에서 프로젝트 홈페이지가 열린다는 것은 해당 페이지에 접속할 수 있다는 뜻일 뿐, 해당 설치 파일이나 다운로드 중 리디렉션되는 주소에 접속할 수 있다는 증거는 아닙니다. 진행을 서두르려고 여러 업데이트 창을 동시에 열지 마세요.

설정의 Verge 고급 설정에서 백업 설정을 열어 로컬 백업을 만든 다음, 기록 보기에서 업그레이드 전 기록을 내보내 앱 데이터 디렉터리 밖에 저장하세요. 기록만 만들었다고 독립된 사본을 저장한 것은 아닙니다. 외부 설정 파일과 직접 관리하는 리소스도 따로 보관하세요. 백업과 구독 인증 정보는 자신의 기기에만 저장하세요.

설치 프로그램이 이미 시작되었다면 결과를 기다리고 오류를 보관하세요. 강제로 종료하지 마세요. 다운로드가 계속되고 취소가 작동하지 않는다면 공식 설치 파일부터 확보하세요. 현재 프록시를 통해 받아야 한다면 작동하는 연결을 유지하며 다운로드를 완료하세요. 이후 정상 절차로 시스템 프록시 또는 TUN을 끄고 앱을 완전히 종료한 뒤 공식 방법으로 수동 업그레이드하세요.

공식 설치 패키지 자체도 다운로드할 수 없다면 현재 사용 가능한 클라이언트와 백업을 보존하세요. 해당 다운로드 경로의 첫 번째 네트워크 오류를 확인하고 공식 안내에 따라 처리하세요. 설치 패키지는 받았지만 설치에 실패한 경우, 다운로드를 반복하지 말고 설치 단계를 확인하세요. 보안 프로그램을 끄거나 출처가 불분명한 패키지로 문제를 우회하지 마세요.

현재 “최신 버전입니다”라는 표시는 버전 확인 결과일 뿐, 캐시 재사용이나 다운로드 취소를 실제로 시험했다는 증거가 아닙니다. 다음 공식 업데이트가 실제로 있을 때 업데이트 과정을 다시 관찰하세요. 버전이 맞고 서명이 유효한 완전한 캐시는 재사용할 수 있어야 합니다. 실제로 취소해야 한다면 준비 또는 다운로드 단계에서만 조작하고, 작업이 끝난 상태를 확인한 뒤 다시 시도하세요.

소스 전환, 서명 검증 실패, 버전 불일치로 다시 다운로드하는 경우에는 먼저 오류와 발생 단계를 기록하세요. 진행률이 처음으로 돌아갔다는 이유만으로 캐시 재사용이 실패했다고 판단하지 마세요. 설치에 성공하면 정상적으로 다시 시작한 뒤 새 버전을 확인하세요. 창이 닫혔다는 사실만으로 업그레이드가 완료된 것은 아닙니다.

설정이 실제로 손상되었다면 현재 데이터를 먼저 보존하세요. 그런 다음 백업 기록에서 이전에 내보낸 업그레이드 전 파일을 가져오고, 해당 기록을 선택해 백업 복원을 실행하세요. 가져오기는 기록을 추가할 뿐 자동으로 적용하지는 않습니다. 복원 후 구독, 규칙, 프록시 모드와 실제 요청을 다시 확인하세요.

앞서 정상 작동이 확인된 설정을 우선 복원하세요. 앱 버전을 이전 버전으로 내려야 한다면 먼저 공식 보안 공지와 백업 호환성을 확인하세요. 새 버전에서 만든 백업을 이전 버전에서 읽을 수 있다고 가정하거나 issue에 나온 이전 버전 권고를 그대로 따라서는 안 됩니다. 사용 가능한 설정이 없다면 정상 절차로 프록시 처리를 멈추고 일반 네트워크 연결을 확인하세요. 반드시 프록시를 거쳐야 하는 작업은 접속을 잠시 보류하세요.

문제가 계속되면 유지관리자에게 정확한 버전, 운영체제와 아키텍처, 업데이트 대상 버전, 멈춘 단계, 기다린 시간, 취소 후 상태, 첫 번째 오류, 정상 종료 및 재시작 결과를 제공하세요. 구독 토큰, 개인 주소, 백업 내용은 가리고 설치 패키지나 인증 정보를 첨부하지 마세요. 직접 관찰한 다운로드 결과와 설치 결과를 각각 설명하고, 다시 시험하지 않은 수정 사항을 검증 완료로 표현하지 마세요.