本文目錄
Ubuntu 安裝從架構匹配的 DEB 開始
在 Ubuntu 上的完整順序是：按 CPU 架構下載官方 DEB，用 apt 安裝，匯入訂閱並驗證系統代理，最後再設定開機啟動。系統代理還沒穩定時，不要同時安裝 TUN 服務或設為登入後自動接管，否則重啟後斷網會更難還原。
截至 2026-07-23，Clash Verge Rev 最新穩定版 v2.5.2 提供 amd64、arm64、armhf 的 DEB。Ubuntu 與 Debian 使用者直接使用 DEB，桌面選單、依賴和卸載都能交給套件管理員；目前 Latest 沒有 AppImage，不需要從第三方網站補找。
架構對應
| uname -m | DEB 資產 |
|---|---|
| x86_64 | *_amd64.deb |
| aarch64 / arm64 | *_arm64.deb |
| armv7l | *_armhf.deb；先確認系統本身是 32 位 ARM |
下載後先核對架構和包資訊
DEB='./Clash.Verge_2.5.2_amd64.deb'
uname -m
dpkg --print-architecture
dpkg-deb -I "$DEB" | sed -n '1,25p'版本號只作目前示例，檔案名應以自己下載的 Release 為準。dpkg-deb 能讀取包的 Architecture 與 Depends；如果這裡已經與系統不匹配，不要用 --force-architecture 強裝。
用 apt 安裝本機 DEB，讓它一起解決依賴
架構確認一致後，再交給 apt 安裝本機檔案。這樣缺少依賴時會給出明確的包名，也便於以後從同一個包管理系統卸載。
DEB='./Clash.Verge_2.5.2_amd64.deb'
sudo apt install "$DEB"
# 查看安装状态
dpkg -l | grep -i clash-verge
# 需要卸载时先记下上一步显示的真实包名
sudo apt remove clash-verge命令中的檔案名和包名必須以本機結果為準。若 apt 報依賴無法滿足，儲存完整錯誤和 Ubuntu 版本；不要去隨機網站下載單個 .so 檔案覆蓋系統庫。安裝結束後從應用選單啟動一次，比立刻開啟 TUN 更容易看到 WebKit、系統匣或核心啟動錯誤。
第一次只驗證 Profile 和系統代理
應用能啟動後先別碰 TUN。用一份簡單 Profile 和系統代理跑通瀏覽器，已經足以確認安裝套件、Mihomo 核心與桌面代理之間可以正常配合。
最小聯網路徑
匯入遠端訂閱或本機設定
Clash Verge Rev 2.x 支援 URL、本機檔案和拖拽匯入；先手動更新。
設為目前 Profile
確認策略群組與節點不是舊快取。
固定一個節點
保持 Rule 模式，開啟系統代理。
開啟瀏覽器並看連線
網域、規則和出站同時出現才算桌面代理正常。
日誌、Profiles 和終端代理分別在哪裡
瀏覽器已經能用，但終端命令仍然超時，這在 Linux 上很常見。桌面系統代理與 shell 環境變數不是同一份設定，先分開看，不必為了 apt 或 Git 立刻開啟 TUN。
官方文件列出的 Linux 路徑
| 內容 | 路徑 |
|---|---|
| verge.yaml | ~/.config/io.github.clash-verge-rev.clash-verge-rev/verge.yaml |
| 工作目錄 | ~/.local/share/io.github.clash-verge-rev.clash-verge-rev/ |
| Profiles | ~/.local/share/io.github.clash-verge-rev.clash-verge-rev/profiles/ |
| WebView 快取 | ~/.cache/io.github.clash-verge-rev.clash-verge-rev/ |
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,::1
# 结束测试
unset HTTP_PROXY HTTPS_PROXY NO_PROXY開機啟動只在系統代理驗證成功後再開啟
先在 Clash Verge Rev 設定頁啟用「開機自啟動」或 Auto Launch；不同版本的名稱可能略有變化。它表示使用者登入桌面後啟動應用，不表示開機前就有代理，也不保證 TUN 會在沒有權限確認的情況下自動接管。只需要系統代理的使用者，先保持 TUN 關閉。
find ~/.config/autostart /etc/xdg/autostart -maxdepth 1 -type f -iname '*clash*' -print 2>/dev/null
grep -R '^Exec=' /usr/share/applications 2>/dev/null | grep -i 'clash.verge|clash-verge'真正驗證一次開機啟動
先退出再重新登入桌面
確認只出現一個 Clash Verge Rev 處理程式，沒有舊用戶端同時啟動。
看目前 Profile 和節點
應用啟動後，仍要確認訂閱已經選中，執行設定就是剛才驗證的那份。
檢查系統代理
若設定為自動開啟，瀏覽器應產生連線記錄；不希望自動接管時保持開關關閉。
測試退出恢復
從應用選單正常退出後，Ubuntu 的 HTTP、HTTPS 和 SOCKS 代理不再指向本機連接埠。
這次登入測試透過後，開機啟動才算真正可用。只看到系統匣圖示出現還不夠，因為 Profile 沒選中或系統代理殘留時，圖示和網路狀態可能並不一致。
確實有程式不讀代理，再安裝 TUN 服務
TUN 需要服務與虛擬網路介面卡權限。先讓系統代理穩定，再從目前版本的設定頁安裝服務。舊教學中的服務指令碼和安裝目錄可能已經變化，遇到權限或 IPC 錯誤時，應先看目前 Release 與官方 FAQ，不要直接執行別的版本留下的命令。
系統匣不顯示常見於桌面環境缺少 AppIndicator 支援；視窗閃退則應從終端啟動應用讀取 stderr。兩者都與訂閱節點品質無關。
雙擊後無視窗
從終端啟動並保留 WebKit/圖形庫錯誤，檢查目前桌面會話。
瀏覽器能用，apt/Git 不通
為對應命令設定環境變數或工具設定，不先開 TUN。
TUN 開關立即彈回
查看服務安裝與權限；不要反覆改 DNS 和節點。
退出後瀏覽器沒網
到桌面網路設定關閉殘留代理，再檢查應用是否被強制結束。