Windows
適合日常桌面使用。安裝前先確認作業系統版本與處理器架構；若已安裝其他代理工具，請先關閉，再啟用用戶端的系統代理。遇到連接埠遭占用，應先找出監聽中的程序，不要反覆重裝。
前往下載 →用戶端 / 依作業系統選擇
查看所有用戶端 →macOS
依 Apple Silicon 或 Intel 選擇安裝套件。首次啟動後，依系統提示完成授權，先匯入設定並測試系統代理；若要接管更多應用程式，再了解服務元件與 TUN 模式所需的權限。
前往下載 →Android
手機與平板請選擇行動裝置用戶端；Clash Verge Rev 是桌面版軟體。前往下載中心查看可用應用程式，匯入相容的訂閱並確認 VPN 授權；背景連線也別忘了留意系統的電池管理設定。
前往下載 →iOS
前往 iPhone 或 iPad 查看 Clash Plus 的 App Store 頁面。行動版介面與桌面版不同，匯入前請確認支援訂閱格式；連線時依系統提示新增 VPN 設定檔，再確認規則與策略組選擇。
前往下載 →Linux
依 Linux 發行版支援的套件格式選擇桌面安裝套件，安裝前先查看相依套件需求。圖形桌面環境可用用戶端管理設定；伺服器、路由器等環境則可至下載中心的 Mihomo 核心區，獨立設定服務與權限。
前往下載 →用戶端、訂閱與代理服務是三件不同的事。安裝用戶端只是準備好執行環境；訂閱提供節點、策略組與規則等設定內容；能否連線則取決於服務是否可用。選安裝套件時先確認作業系統，再確認處理器架構；選訂閱時先確認格式，再確認所需的核心功能。
若要從舊用戶端移轉，建議先匯出原有設定，並記下連接埠、代理模式與本機修改內容。新用戶端首次執行時只啟用一份設定，確認能正常連線後，再移轉覆寫設定與自訂規則。如此一來，遇到問題時較容易分辨是安裝環境、訂閱內容還是本機設定所致。
訂閱、代理與規則設定
依操作項目查看介面局部示意。示意中的開關僅供參考，實際設定請在用戶端內操作。
介面 / 設定 / 訂閱管理
匯入訂閱與切換設定檔
在設定頁貼上訂閱連結並匯入，下載完成後選取對應設定檔，再到代理頁查看策略組。相較於直接編輯核心檔案，圖形介面會集中顯示訂閱來源與目前啟用的設定，更方便管理日常使用的多份設定檔。匯入成功不代表連線正常，還需確認訂閱格式、節點資訊與策略組選擇。遠端訂閱更新可能會覆蓋原始內容，想長期保留的規則應透過本機覆寫管理；分享螢幕截圖時，記得遮住訂閱網址中的個人識別資訊。
查看訂閱匯入步驟 →介面 / 設定 / 系統代理
系統代理與混合連接埠
系統代理會將支援系統代理設定的應用程式，導向用戶端的監聽位址。混合連接埠可同時接收 HTTP 與 SOCKS 代理連線，範例連接埠為 7897，實際值請以設定頁為準。初次使用時先啟用系統代理，再用瀏覽器測試目標網站；終端機或自行設定代理的應用程式可能還需要額外設定。相較於 TUN 模式，這種方式的接管範圍較明確，也更適合初學者排查問題。修改連接埠後，記得同步檢查應用程式內的代理位址；關閉用戶端前，也要確認系統代理已還原。
查看系統代理設定 →介面 / 規則 / 比對順序
規則比對與策略組選擇
規則模式會依設定檔中的順序檢查連線，通常由最先符合的規則決定處理方式。規則指向的策略組還會再選擇實際節點，兩者不可混為一談。相較於將所有流量交給同一個出口，規則分流可依不同網域設定直連或代理。新增規則時，先確認目標網域，再確認策略組名稱存在，並將具體規則排在兜底規則之前。連線結果不如預期時，先到連線頁查看命中的規則與策略鏈，不要只憑網頁能否開啟來判斷設定是否生效。
查看規則與策略組設定 →介面 / 設定 / TUN 模式
虛擬網卡與應用程式流量接管
TUN 模式透過虛擬網路介面處理流量，適用於不遵循系統代理設定的應用程式。它與系統代理的差異在於流量接管方式，並不會取代訂閱或自動提供節點。啟用前先確認一般代理連線可用，再依用戶端提示準備服務元件與所需權限。若裝置同時執行其他 VPN、虛擬網卡或企業網路工具，請留意路由衝突。若發生網路中斷，先關閉 TUN 進行比對，再檢查 DNS、自動路由與介面選擇。每次只調整一個項目，並保留可還原正常網路的原始設定。
查看 TUN 與 Fake-IP 說明 →設定 / dns / enhanced-mode
網域解析與流量分流
DNS 會決定網域如何解析，也會影響依目標 IP 判斷的規則。理解 Mihomo 的 DNS 設定時，需搭配實際的流量接管方式，不能只更換一組上游伺服器就認定問題已解決。Fake-IP 會以虛擬位址對應網域，與一般解析回傳真實位址的方式不同。調整前先記下增強模式、上游伺服器與過濾項目，再用同一個網域進行比較。若只有部分應用程式異常，先檢查該應用程式的加密 DNS 與快取；複雜參數的用途及彼此關係，可在進階設定中逐項查閱。
查看 DNS 設定最佳化 →介面 / 連線與記錄 / 問題排查
連線記錄與錯誤排查
連線頁適合確認流量是否進入核心，以及命中了哪條規則；記錄頁則可查看設定載入、解析失敗與連線異常。相較於一再切換節點，這些資訊更能幫助縮小問題範圍。排查時先記下發生時間與目標網域，重現一次後再尋找對應記錄。必要時可暫時提高記錄層級，收集完成後再恢復日常設定，避免資訊太多影響閱讀。對外回報問題前，請移除訂閱網址、認證資料與私人瀏覽記錄，並附上可重現的步驟及已嘗試的操作。
查看常見記錄錯誤 →首次使用：匯入、選擇、驗證
先建立一條可重現的連線流程。確認基本設定正常後，再加入覆寫、規則集與 TUN 設定。
-
匯入可用的訂閱
安裝並開啟用戶端，前往設定頁貼上服務提供者給的訂閱連結，匯入完成後選取該設定檔。連結所提供的內容必須與用戶端相容，網頁分享網址不一定是訂閱網址。若使用本機檔案，請先確認檔案是完整的 Clash YAML 設定，而不是只有節點文字的清單。
首次測試時，只保留一份明確啟用的設定檔。若解析失敗，先查看錯誤指出的欄位或行號，檢查縮排與格式；不要同時修改連接埠、DNS 與規則。
-
選擇策略組並啟用代理
前往代理頁確認訂閱中的策略組已顯示，再為需要手動選擇的策略組指定節點。初次使用時保留規則模式，並在設定頁啟用系統代理。策略組名稱由設定檔決定，不同訂閱的分組方式可能不一樣，不能只憑名稱判斷實際出口。
此時先用支援系統代理的瀏覽器進行測試。若應用程式有自己的代理選項，請確認沒有指向舊用戶端的連接埠；先不要啟用其他網路接管功能，方便逐步判斷問題。
-
在連線頁確認結果
造訪目標網站後開啟連線頁，確認目標網域、命中規則與策略鏈。網站能開啟只代表這次連線成功，不能單獨證明要求的流量經過預期出口。若看不到對應連線，請檢查應用程式是否遵循系統代理，以及用戶端目前是否使用剛匯入的設定檔。
若連線記錄存在但無法瀏覽，再查看記錄中的解析或連線錯誤。固定使用同一個網域作為測試對象，每次只修改一項設定，才能判斷問題來自規則、節點還是本機環境。
開始設定前，先釐清三個差異
- 訂閱連結與設定檔
- 訂閱連結是取得遠端設定的入口，設定檔則是用戶端實際讀取的內容。遠端更新會重新取得內容，本機檔案則需要自行維護。轉換格式前，先確認服務提供者是否已有適用於用戶端的訂閱，避免把完整設定轉換成只有節點的清單。
- 規則模式與全域模式
- 規則模式依規則清單選擇流量處理方式；全域模式通常會把流量交給全域策略組。兩種模式都需要可用的節點與設定。切換模式可作為比對測試，但不能取代對規則順序、策略組選擇與目標連線記錄的檢查。
- 系統代理與 TUN 模式
- 系統代理仰賴應用程式支援相應設定；TUN 則透過虛擬網路介面接管流量。若瀏覽器正常、其他應用程式卻異常，應先分辨各應用程式的連線方式。TUN 涉及權限、路由與 DNS，建議先確認一般代理可正常使用，再繼續設定。
專案來源 / 程式碼與核心
Clash Verge Rev 開源專案
專案沿革與桌面介面
Clash Verge Rev 延續 Clash Verge 的桌面用戶端發展方向，以圖形介面管理訂閱、代理策略、連線與設定。認識這個專案時，需區分用戶端介面與代理核心：設定頁負責管理設定來源，偏好設定頁負責桌面整合，而網路要求的規則比對與協定處理主要由核心完成。舊教學中的按鈕位置可能與目前介面不同，尋找功能時，建議依操作項目定位，而不是照著截圖座標點選。
Mihomo 核心與設定相容性
Mihomo 屬於 Clash 設定生態系，提供代理協定、策略組、規則與 DNS 等功能。用戶端將這些功能整合到桌面操作流程中，但並非每個設定欄位都對應一個獨立開關。有些設定來自訂閱原文，有些來自用戶端產生的執行設定，也可能有部分受到本機覆寫影響。若設定內容與介面顯示不一致，先確認目前啟用的設定檔，再檢查合併後的結果。查閱 Clash Meta 教學時，也要留意核心的演進與欄位支援情況，不能直接套用其他用戶端的介面操作步驟。
GPL-3.0 授權條款與原始碼
本專案以 GPL-3.0 授權條款公開原始碼。若想了解某項功能的實作方式，可從程式碼儲存庫的說明文件、原始碼與議題紀錄著手；若要修改或重新散布，請詳閱授權條款中的具體義務。開源代表程式碼可供查閱、討論與參與改進，不表示在所有網路環境下都會有相同表現。實際使用時仍需確認作業系統、服務元件、設定來源與網路條件。向專案回報問題時，清楚的重現步驟與已去識別化的記錄，比只描述「無法連線」更有幫助。
用戶端、核心與訂閱分別更新
用戶端更新、核心更新與遠端訂閱更新屬於不同層次。用戶端更新可能改變介面或系統整合；核心更新可能影響協定與設定欄位；訂閱更新則會變更節點、規則或策略組內容。升級前先保留目前可用的設定，閱讀版本發布說明，並記下本機覆寫、連接埠與服務設定。更新後先驗證原有的使用流程，確認規則比對與應用程式連線正常，再嘗試新功能。若只有某一份訂閱異常，應先檢查設定內容，不要立即回退所有元件。
查看專案原始碼與版本發布說明 →原始碼儲存庫 / git clone
git clone https://github.com/clash-verge-rev/clash-verge-rev.git日常使用與從原始碼建置
日常使用只要前往下載中心選擇安裝套件即可。複製儲存庫適合閱讀實作、提交修改或自行建置，不會自動完成安裝。從原始碼建置還需依專案說明準備工具鏈、相依套件與作業系統環境；建置步驟請以儲存庫目前的文件為準。
訂閱內容與本機修改
訂閱通常包含節點、策略組與規則，更新時可能會覆蓋原始內容。若要長期保留自訂分流，請先了解用戶端的覆寫機制，避免每次更新後都得重新手動修改。規則引用的策略組名稱必須存在；合併多份訂閱時，也要留意同名策略組、重複節點與規則順序。修改設定後，先確認是否成功載入，再透過連線頁驗證實際命中的結果。
故障記錄與隱私保護
排查時可記錄作業系統、網路連線方式、啟用的代理模式與錯誤發生時間。設定檔與記錄可能包含訂閱連結、伺服器位址、認證資料與瀏覽網域，公開回報前請逐項移除識別資訊。用來說明問題的最小設定只保留必要欄位；不要將完整的私人訂閱貼到公開討論區，也不要把暫時性的除錯設定留在日常設定中。
前往進階設定手冊 →設定檔與故障排查文章
依問題選擇閱讀路徑：不熟悉格式先看訂閱，設定載入失敗先看 YAML，啟動異常先檢查連接埠。
Clash 設定檔 YAML 逐段解析：從 mixed-port 到 rules
依序解析一般連接埠、dns、proxies、proxy-groups、rule-providers 與 rules 各段欄位的用途，並附上常見縮排錯誤範例。
適合已匯入訂閱、準備閱讀原始設定的使用者。先辨認頂層欄位與清單層級，再判斷要修改的是監聽連接埠、解析方式還是規則引用，避免只複製片段卻漏掉相關設定。
閱讀文章 →7897 混合連接埠遭占用：找出占用程序並修改監聽連接埠
介紹如何在 Windows、macOS、Linux 使用指令找出占用連接埠的程序，並在用戶端設定中修改混合連接埠、同步更新系統代理。
適合遇到監聽失敗，或切換用戶端後無法連線的情況。依序確認占用程序、判斷是否需要關閉舊程序，再修改連接埠；最後確認瀏覽器、終端機與其他應用程式是否仍使用舊的代理位址。
閱讀文章 →訂閱連結匯入用戶端的三種方式，以及 YAML、Base64 格式差異
說明貼上 URL、匯入本機檔案與掃描 QR Code 三種匯入方式，比較 Clash YAML 與 Base64 節點清單這兩類訂閱內容，並介紹更新間隔設定。
不同用戶端提供的匯入入口不盡相同。閱讀時先確認目前應用程式支援的方式，再檢查訂閱實際回傳的內容；若開啟連結後顯示網頁或錯誤訊息，應先修正來源，而不是一再更改檔案副檔名。
閱讀文章 →