本文目錄
先確認 v2.5.4-rc 仍是預發布版
Clash Verge Rev v2.5.4-rc 於 2026 年 9 月 17 日 19:36(Asia/Shanghai)發布,GitHub Release 明確標記為 Pre-release。截至同一時間,專案的 Latest 穩定版仍是 v2.5.2;看到 v2.5.4 版本號,不等於它已經替代正式版。
這次 RC 與持續更新的 AutoBuild 包含系統代理、服務模式、訂閱編輯、節點選擇、連接埠避讓和 TUN 等多項修改,並移除可攜模式,統一使用系統應用資料目錄。它適合願意保留完整備份、能夠做桌面網路驗證並可立即還原的人,不適合僅因版本號更大就直接覆蓋日常唯一環境。
如果目前 v2.5.2 使用正常,又不需要驗證發布說明中的某項修復,繼續留在穩定版是完整方案。若正在處理系統代理狀態錯誤、服務模式超時、Windows system/mixed TUN 不接管流量,或必須提前驗證可攜模式遷移,再安排一次可隨時還原的測試時段。
發布管道與處理方式
| 看到的版本 | 專案狀態 | 建議 |
|---|---|---|
| v2.5.2 | Latest 穩定版 | 日常環境優先保留,等待下一個正式 Release |
| v2.5.4-rc / AutoBuild | Pre-release | 只在完成備份並能還原時測試 |
| 只看到應用內更新提示 | 通道尚未確認 | 先開啟官方 Release 核對標籤、日期和安裝檔名稱 |
| 第三方打包或解壓縮版 | 不屬於官方發布保證 | 不要用來判斷 v2.5.4 的遷移結果 |
先判斷自己是否需要測試這次變化
發布說明列出的修復很多,但升級前應只選一個自己能復現的目標。比如系統代理切換失敗後介面狀態錯誤,就記錄開關狀態、系統代理實際值和一條實際請求;服務模式操作超時,就記錄首條錯誤和後續操作是否繼續異常。
近期 issue #7915 的範圍很窄:Windows 服務模式中的特定 v2.5.4 AutoBuild 使用 system 或 mixed TUN 堆疊時沒有流量,gVisor 正常,還原 v2.5.2 後恢復。
Service IPC 隨後為暫存在 %ProgramData% 的核心補充防火牆規則,主倉升級到包含該修復的 2.7.0;v2.5.4-rc 的發布說明已經列入這項修復。
這不表示所有 TUN 無流量都由防火牆導致,也不應讓使用者手動關閉 Windows 防火牆。只有版本、Windows 服務模式、堆疊差異和無流量現象同時匹配時,才把它作為升級 RC 的一個理由。
可攜模式使用者的目標不是先驗證網路,而是確認設定從哪裡讀取。v2.5.4 明確移除可攜模式並統一使用系統應用資料目錄;如果舊安裝把資料放在程式附近、Scoop 目錄或自訂位置,必須先找出舊目錄並單獨儲存。
Scoop 是官方文件列出的社群維護發行管道,文件提到它可用於修改設定目錄或可攜需求,但專案也明確不為下游管道問題提供支援。這與 v2.5.4 應用內的「移除可攜模式」不是同一項保證;使用 Scoop 時還要核對 Scoop 自己的持久化目錄和升級行為。
穩定版工作正常,只想追新版本
留在 v2.5.2,等待正式版,不為 AutoBuild 承擔遷移風險。
正在使用可攜版或自訂資料目錄
先記錄舊資料位置和啟動方式,再備份舊目錄與系統資料目錄。
系統代理開關顯示與系統實際狀態不一致
儲存升級前對照,升級後只驗證系統代理,不同時改 TUN 和連接埠。
Windows TUN 的 system/mixed 堆疊不接管流量
記錄目前堆疊、服務狀態與同一測試目標,再評估包含相關修復的 RC。
應用、核心或全部訂閱都無法啟動
先恢復現有穩定環境,不把所有啟動故障都歸給這次發布。
升級前完整備份系統應用資料目錄
先完整退出 Clash Verge Rev,確認系統匣處理程式和服務操作已經結束,再複製應用資料目錄。
官方隱私文件把 Windows 目錄列為 %APPDATA%\io.github.clash-verge-rev.clash-verge-rev,macOS 為 ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev。
Linux 使用 $XDG_DATA_HOME/io.github.clash-verge-rev.clash-verge-rev,通常位於 ~/.local/share。
目錄中的 verge.yaml、config.yaml、profiles.yaml 和 profiles/ 是恢復設定、訂閱與 Profile 的關鍵。logs/、service-logs/、cache.db 和 Geo 資料也可以幫助對照,但不要只儲存日誌而漏掉設定。
備份應儲存在應用工作目錄之外,並標明系統、架構、原版本和時間。verge.yaml 可能明文儲存 WebDAV 位址、使用者名稱和密碼,Profile 可能包含訂閱 token、節點密碼和 UUID;不要把原始備份上傳到公開雲端硬碟或直接附在 Issue。
官方資料目錄
| 平台 | 應用資料目錄 | 備份重點 |
|---|---|---|
| Windows | %APPDATA%\io.github.clash-verge-rev.clash-verge-rev | verge.yaml、profiles.yaml、profiles/、config.yaml |
| macOS | ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev | 完整目錄與目前應用版本 |
| Linux | $XDG_DATA_HOME/io.github.clash-verge-rev.clash-verge-rev | 通常位於 ~/.local/share,並另記實際 XDG_DATA_HOME |
備份完成標準
- Clash Verge Rev 已完整退出,複製時沒有繼續寫入設定
- 系統應用資料目錄已整體複製到獨立位置
- 舊可攜或自訂資料目錄也已單獨儲存
- 原版本、系統架構、安裝來源和備份時間已經記錄
- 原始備份保持私有,公開證據已經刪除 token、密碼、UUID 和存取網域
先遷移可攜模式資料,不要直接覆蓋舊目錄
v2.5.4 的發布說明只確認「移除可攜模式,統一使用系統應用資料目錄」,沒有承諾自動找到每一種第三方可攜打包或自訂目錄。因此不要先刪除舊檔案,也不要把新程式直接解壓縮到舊程式目錄後期待它自動讀取原設定。
在舊版本仍可開啟時,先記錄目前 Profile 名稱、訂閱來源、覆寫與指令碼、系統代理、TUN、服務模式和連接埠。然後同時備份舊程式附近的資料目錄與官方系統應用資料目錄。安裝 RC 後,先讓它建立並使用新的系統資料目錄,再從應用提供的匯入或備份恢復入口恢復。
若只能手動恢復,先關閉新版本,保留它剛建立的目錄副本,再一次性複製完整的已備份設定集合。不要只挑一份 profiles.yaml、只複製 profiles/,或把新舊 verge.yaml 混在一起;這些檔案之間的引用和目前選擇可能不同步。
從舊可攜環境遷移
記錄舊環境
儲存版本、啟動路徑、資料目錄、Profile 清單、覆寫、連接埠、系統代理和 TUN 狀態。
做兩份獨立備份
分別複製舊可攜或自訂目錄,以及目前系統應用資料目錄;不要覆蓋同名備份。
讓新版本建立目錄
從官方 v2.5.4-rc 安裝並啟動一次,確認它使用系統應用資料目錄後完整退出。
按完整備份恢復
優先使用應用內恢復;手動恢復時保持檔案集合一致,並保留新版本初始目錄副本。
先驗證 Profile 再開 TUN
確認訂閱、策略群組和選中節點正確後,先測試系統代理,最後再恢復服務模式與 TUN。
只從官方 GitHub Release 安裝對應架構
Clash Verge Rev 官方文件說明,專案目前只透過 GitHub Release 發布。測試 v2.5.4-rc 時應開啟該 RC 的官方 Release,確認頁面標記 Pre-release、目標提交為 c7ffb212,並記錄發布時間和安裝檔名稱,再按系統與架構選擇安裝檔。
Windows 普通裝置通常選擇 x64;ARM Windows 選擇 arm64。只有系統缺少且無法安裝 WebView2,或普通包無法開啟介面時,才考慮檔案名帶 fix_webview2 的大體積版本。macOS 要區分 Apple 晶片與 Intel,Linux 要同時匹配發行版包格式和 CPU 架構。
安裝前儲存安裝檔名稱和下載時間,不使用第三方「綠色版」、不從搜尋廣告下載同名安裝套件,也不把穩定版與 RC 的資源目錄混合。正式環境只有一個時,應先準備 v2.5.2 官方安裝套件和完整資料備份,再啟動測試安裝。
安裝前最後核對
核對發布標籤
頁面必須是官方儲存庫的 v2.5.4-rc Release,並明確標記 Pre-release。
核對系統與架構
Windows、macOS、Linux 的安裝套件不能混用,x64、arm64、Apple M 與 Intel 也要對應。
保留還原材料
保留 v2.5.2 官方安裝套件、完整資料備份和舊可攜目錄。
關閉舊實例再安裝
完整退出舊版本,不讓兩個介面或核心同時修改同一資料目錄。
服務模式下不要修改快取副本
v2.5.4 Release 把一條重要提醒放在最前面:服務模式下,設定目錄中的規則集和代理集合檔案只是快取副本,手動修改不會影響正在執行的核心。需要自己維護的檔案應在設定中使用 type: file,而不是繼續編輯服務產生的快取。
這次 AutoBuild 還加入服務模式多使用者隔離和舊服務升級遷移,並修復操作超時後繼續發生錯誤或狀態異常的問題。升級後先從介面確認服務安裝狀態和目前使用者,再檢查應用日誌與 service-logs;不要看到舊快取仍在,就據此判斷新核心載入了手動修改。
如果原設定依賴手動修改 provider 快取,先恢復備份並把真正需要維護的規則集或代理集合改成明確的本機 file provider。一次只遷移一個檔案,重新載入後用連線記錄或規則命中驗證,避免把服務遷移、provider 遷移和訂閱更新同時進行。
先驗證系統代理,再單獨驗證 TUN
恢復 Profile 後先關閉 TUN,只開啟系統代理,用同一節點完成一次實際 HTTPS 請求,並在 Connections 中確認目標、規則和出口。然後關閉系統代理,確認作業系統代理狀態同步恢復;這一步用於驗證發布說明中的系統代理狀態與恢復修復。
系統代理穩定後再安裝或升級服務並開啟 TUN。Windows 如果原問題只出現在 system 或 mixed 堆疊,就保持同一節點和測試目標重新測試;不要同時切換 gVisor、DNS、連接埠和覆寫。macOS、Linux 則重點確認授權流程、繞過規則和服務日誌沒有繼續報舊權限錯誤。
v2.5.4 新增 TUN 的 Mips 堆疊選項,Release 明確要求 Mihomo v1.19.31 或以上。沒有這個核心版本或沒有明確測試目的時,不要只因新增選項就切換堆疊。
分層驗證
| 層級 | 要驗證什麼 | 失敗時先做什麼 |
|---|---|---|
| 應用與 Profile | 訂閱、策略群組、選中節點和覆寫都存在 | 停在應用層,先恢復完整備份 |
| 系統代理 | 開關與系統實際狀態一致,實際 HTTPS 請求進入 Connections | 關閉開關並恢復系統代理,再查日誌 |
| 服務模式 | 目前使用者可以安裝、啟動和執行操作,service-logs 無持續錯誤 | 卸載或停用服務,退回系統代理 |
| TUN | 同一目標被接管,DNS 與路由正常,關閉後網路恢復 | 關閉 TUN,不連續切換多個堆疊 |
| Mips | 核心至少 v1.19.31,且有單獨的接管驗證 | 恢復升級前堆疊 |
用同一組請求完成升級驗收
版本號和介面能開啟只證明安裝完成,不證明遷移成功。重啟一次系統和 Clash Verge Rev,再用升級前儲存的同一 Profile、同一節點與同一 HTTPS 目標依序驗證應用啟動、系統代理、服務模式和 TUN。
再檢查系統應用資料目錄確實儲存了新修改,重啟後 Profile、選中節點、覆寫和連接埠沒有回到舊值。使用本機 type: file 的規則集或代理集合時,還要確認執行設定引用的是源檔案,不是服務快取副本。
測試期間不要刪除舊可攜目錄、v2.5.2 安裝套件或升級前備份。至少完成一次重啟和一次關閉代理後的直連恢復,再決定是否繼續使用 RC。
v2.5.4-rc 驗收清單
- 執行版本明確顯示 v2.5.4-rc,並記錄了目標提交和安裝檔名稱
- 資料來自系統應用資料目錄,舊可攜目錄仍保持唯讀備份
- 訂閱、Profile、覆寫、指令碼、策略群組和選中節點完整
- 系統代理的介面狀態與作業系統實際狀態一致
- 服務模式操作可完成,日誌沒有超時後的持續錯誤
- TUN 使用原堆疊完成實際請求,關閉後系統網路恢復
- 手動維護的 provider 使用 type: file,沒有繼續編輯快取副本
- 重啟系統和應用後設定仍保持,且沒有兩個實例同時執行
- v2.5.2 安裝套件、完整資料備份和還原步驟仍可使用
出現異常就完整還原 v2.5.2
如果 RC 無法啟動、設定遷移不完整、系統代理或 TUN 出現新的異常,先關閉 TUN 和系統代理,完整退出應用,並確認作業系統已經恢復直連。不要在異常狀態下繼續更新訂閱或反覆覆蓋資料目錄。
儲存一份 v2.5.4 的故障現場副本後,使用官方 v2.5.2 安裝套件恢復程式,並把升級前的完整資料備份作為一個整體恢復。不要只換回可執行檔案卻繼續使用已經由新版本改寫的部分設定,也不要把新舊資源檔案拼在一起。
還原後先確認版本與 Profile,再按系統代理、服務模式、TUN 的順序驗證。若舊可攜版本原本穩定,可以暫時恢復舊程式與舊資料目錄,但保持它與系統資料目錄分離,等待後續正式版提供明確的遷移說明。
安全還原
恢復直連
關閉 TUN 和系統代理,完整退出 RC,確認普通網路在沒有本機代理時可用。
儲存故障現場
複製 v2.5.4 目前資料目錄和脫敏日誌,避免覆蓋升級前備份。
恢復穩定程式
從官方 Release 安裝與原系統架構一致的 v2.5.2。
恢復完整資料
使用升級前整體備份恢復,不混用新舊單個檔案。
逐層驗證
確認 Profile 後先測系統代理,再測服務模式和 TUN,並完成關閉後的直連恢復。
後續以正式 Release 判斷遷移完成
截至 2026 年 9 月 17 日,v2.5.4-rc 與 AutoBuild 都是預發布,v2.5.2 仍是 Latest 穩定版。後續應以專案正式 Release 頁面是否發布新穩定版本、是否保留可攜模式移除和資料目錄說明為準,不根據預發布版本號猜測正式版發布日期。
正式版到來後仍需保留一次相同的遷移驗證:完整備份、確認系統資料目錄、恢復 Profile、先測系統代理、再測服務模式與 TUN、最後驗證還原。AutoBuild 測試成功不能替代正式版復核。
如果需要提交問題,提供系統、架構、安裝管道、舊版與新版、舊資料目錄與新系統目錄、首條相關日誌和最小復現步驟。公開前刪除訂閱 token、節點認證資訊、WebDAV 資訊、存取網域和完整本機路徑。
