安裝與遷移 · Clash 技術部落格

Clash Verge Rev 更新卡住:下載與取消修正

Clash Verge Rev 更新下載卡住,按取消後仍繼續下載?先區分下載與安裝,再核對 v2.5.8 的快取重用、來源切換與取消修正。匯出備份後正常升級,驗證原設定,失敗時還原可用設定。

  • Clash Verge Rev
  • 內建更新
  • 下載快取
  • 取消更新
  • v2.5.8
本文目錄

進度條停住後,最需要知道的是程式仍在下載,還是安裝程式已經接手。安裝開始後應等待結果;仍在下載時,保留原設定與可用連線,再決定取消或使用官方安裝套件,才能完成一次可核對的升級。

更新下載卡住時,進度、快取與取消分別意味著什麼

先保存進度、等待時間、第一則錯誤與取消後的變化。安裝程式已啟動時,等待結果,不要強制結束;若仍在下載,按後面的官方安裝套件流程處理。

截至本次核對,官方最新正式版為 v2.5.8。舊版更新器必須先完成這次升級才能使用新實作,反覆開啟舊視窗不會把修復載入進去。無需透過降級來測試下一次更新。

v2.5.8 修正了什麼,哪些現象仍要另外檢查?

官方 issue #8172 回報的是 Windows 從 v2.5.6 升級到 v2.5.7 時,已下載的內容再次下載、速度很慢,而且取消沒有真正停止下載。維護者隨後附上快取重用與取消下載的修正提交,2026 年 10 月 9 日發布的 v2.5.8 已列出這三項修正。這不代表所有更新卡住的情況都由同一缺陷造成。

依階段判斷

觀察到的現象該版本的處理方式應核對的內容
完整下載後又從頭開始v2.5.8 會先比對快取版本與目前的更新版本,並驗證安裝包簽章;通過才會重用。快取不符或驗證失敗時,仍會重新下載;不能把每次重新下載都當成缺陷。
下載很慢或進度停住下載會依更新清單中的位址、其他鏡像來源、GitHub 的順序嘗試;第一輪會判斷來源是否過慢,並切換來源。切換來源是嘗試恢復下載的方式,不保證所有網路都能連上,也不保證能在短時間內完成。
按取消只關閉視窗v2.5.8 在準備與下載階段會呼叫真正的取消處理。安裝開始後,無法承諾仍可中止;不要反覆按更新,或強制結束安裝程式。
安裝失敗或服務異常已超出上述下載修正的範圍。保留安裝錯誤與完整版本,依對應平台的官方安裝和服務說明處理。

固定版本的原始碼中,第一輪下載會每 30 秒檢查進度,新增下載量不足 1 MiB 時就切換來源;所有來源在第一輪都失敗後,第二輪只依下載是否停頓判斷。因此不能宣稱「30 秒內自動修好」,也不能把 GitHub 永遠優先視為實作規則。

新版也要分清取消按鈕與關閉視窗:取消會呼叫後端處理,單純關閉視窗只會隱藏介面。請只在準備或下載階段取消,等狀態結束後再重試;安裝階段不要把關閉視窗當成中止。

保留下載停住時的進度、已等待時間、第一條錯誤,以及是否仍在安裝。瀏覽器能開啟專案首頁,只代表網頁可以連線,不能證明對應安裝包和下載過程中跳轉到的位址可以連線。不要為了加快進度同時啟動多個更新視窗。

保留獨立備份,用官方安裝套件完成升級

先在設定中的 Verge 進階設定開啟備份設定,建立本機備份,再從查看紀錄匯出升級前的紀錄,存到應用程式資料目錄之外。只建立紀錄,不等於已儲存獨立副本;外部設定檔和自行管理的資源也要另外備份。備份與訂閱認證資訊只留在自己的裝置上。

安裝程式已啟動時,等待結果並保留錯誤,不強制結束。若仍在下載且取消無效,先確認手邊已有官方安裝套件;需要透過目前代理取得時,維持可用連線完成下載。之後正常停止系統代理或 TUN,完整退出應用程式,再按官方方式手動升級。

保留設定,完成一次升級

  1. 確認版本與系統架構

    記錄完整應用程式版本、系統、架構、目前 Profile 與代理模式,保留已匯出的升級前備份。安裝程式已開啟時應等待結果。v2.5.8 的系統日誌出現 Installing update v,也是進入安裝處理的線索;舊版不保證有此提示,沒有它不能判定仍在下載。

  2. 從官方 Release 選擇安裝包

    開啟文末的 v2.5.8 官方 Release,依官方安裝說明選擇符合系統與架構的安裝包;macOS 還要核對最低系統需求。不要把本站的歷史備份版本當成這次的修正版本。

  3. 依官方方式安裝並重新啟動

    下載完成後,依對應平台的正常安裝方式升級,保留既有資料與安裝位置。套件管理器使用者請沿用官方對應管道,不要混用可攜版或多個安裝目錄。不要執行暫存快取檔 pending_update.bin、略過簽章驗證,或清空應用程式設定來促使更新。

  4. 在應用程式內核對版本並驗證原設定

    啟動後,確認真正執行的版本為 v2.5.8,核對原 Profile、節點、規則與代理模式,並以新的 HTTPS 請求驗證能否正常存取。正常退出再啟動後,重新檢查一次。

若官方安裝包本身也下載失敗,請保留目前可用的用戶端與備份,檢查該下載路徑的第一個網路錯誤,再依官方說明處理。若已取得安裝包卻安裝失敗,請停止重複下載,改查安裝階段;不要關閉安全軟體,或改用來源不明的安裝包來繞過問題。

如何確認恢復,下一次有更新時又該怎麼驗證?

本次升級的驗收

  • 應用程式內的完整版本為 v2.5.8,原設定可正常載入
  • 節點、規則與代理模式正確,新的 HTTPS 請求成功

目前顯示「已是最新版本」只能證明版本核對,不能證明已實際測試快取重用或取消下載。等下一次確有官方更新時,再觀察一次更新:版本相符且簽章有效的完整快取應可重用;確實需要取消時,僅在準備或下載階段操作,並確認狀態結束後再試。

若因切換來源、簽章驗證失敗或版本不符而重新下載,先保留錯誤與階段資訊,不能只憑進度歸零就判定快取重用失效。安裝成功後正常重新啟動並核對新版本;視窗關閉本身不代表升級已完成。

設定恢復與更新故障意見回饋

若設定確實損壞,先保留目前的資料,再在備份紀錄中匯入先前匯出的升級前檔案,選取對應紀錄並執行還原備份。匯入只會新增紀錄,不會自動套用;還原後重新核對訂閱、規則、代理模式與實際請求。

優先還原已驗證可用的設定。若必須退回舊版應用程式,先核對官方安全公告與備份相容性,不要假定新版產生的備份能由舊版讀取,也不要照抄 issue 中的舊版本建議。沒有可用設定時,正常停止代理接管,再檢查一般網路;必須透過代理的服務則暫緩存取。

若仍有異常,請向上游提供完整版本、系統與架構、目標更新版本、卡住的階段、等待時間、取消後的狀態、第一個錯誤,以及正常退出再啟動的結果。遮蔽訂閱權杖、私人位址與備份內容,不附上安裝包或認證資訊;分別說明實際觀察到的下載與安裝結果,沒有重新測試的修正不要寫成已驗證。

參考資料