取得客戶端
依平台選擇入口,各平台推薦客戶端、完整版本清單與最低系統需求請見下載頁,下載前請確認裝置晶片架構
核心特性
模組運行狀態一覽,點擊任意行展開說明
規則分流解決的是「哪些流量走代理、哪些直連」這個最核心的問題:依網域、GEOIP、IP-CIDR、程序名稱等條件由上而下逐條比對,命中即路由到指定出口,未命中則落入 MATCH 兜底規則。相較手動切換全域代理,規則模式一次設定長期生效,本地流量直連不繞路、境外流量按需走對應策略群組。規則集支援遠端訂閱與本機覆寫兩種維護方式,遠端集合定時拉取、本機覆寫優先生效,更新規則時不會中斷已建立的連線。寫法範例與比對優先順序詳見協定參考頁與名詞速查。
curl -I -x http://127.0.0.1:7890 https://example.com不同服務商發放的節點往往協定各異:Shadowsocks、VMess、Trojan、VLESS、Hysteria2、TUIC 以及 WebSocket、gRPC 等傳輸層組合,Clash 用同一份 YAML 設定檔統一管理,不需要為每種協定單獨安裝客戶端。節點可編入 url-test(自動測延遲選最快)、fallback(主節點失效自動切換)、load-balance(多節點分攤連線)等策略群組,由核心自動選路,把手動干預降到最低。哪種協定適合哪種網路環境、各核心的協定支援差異,協定參考頁有完整對照表。
grep -c "name:" profile.yaml訂閱機制把「維護節點清單」這件事從使用者手裡拿走:服務商把全部節點與推薦規則打包成一個 URL,貼到客戶端即可拉取完整設定,節點增刪、位址變更都由下一次更新自動同步,無需逐一手抄伺服器參數。客戶端支援按小時或按天定時自動更新,更新失敗時回退到前一版本快取,不會因為一次拉取失敗導致斷網。匯入入口在各客戶端的「設定」或「訂閱」頁,具體操作步驟與常見匯入錯誤的處理請見教學頁第二步與說明中心。
mihomo -f profile.yaml -t傳統「系統代理」只對讀取代理設定的應用程式生效,命令列工具、遊戲客戶端、UWP 應用程式經常繞過它直連。TUN 模式在系統裡建立一塊虛擬網卡,把全部對外流量在網路層接管後交給核心按規則處理,不需逐個應用程式設定,對不走系統代理的程式同樣生效。啟用時 Windows 需要系統管理員權限、macOS 需要授權網路延伸功能、Android 走 VpnService,均為一次性授權。Windows UWP 迴圈限制的解除方法與 TUN 常見衝突排查,請見說明中心對應條目。
ip route | head -n 3DNS 污染與解析洩漏是代理場景裡最常見的兩類隱性故障:網域被解析到錯誤 IP 導致規則誤判,或解析請求以明文發往本地 ISP 而暴露存取意圖。內建 DNS 模組提供 fake-ip 與 redir-host 兩種模式——fake-ip 回傳保留段虛擬位址、把真實解析延遲到出口側,速度快且天然防污染;redir-host 相容性較佳,適合需要真實 IP 的場景。上游支援 DoH / DoT 加密查詢,並可依網域把境內外解析分流到不同解析器。兩種模式的取捨詳見名詞速查。
nslookup example.com 127.0.0.1圖形客戶端能做的事,腳本和面板同樣可以做:核心在本機 9090 埠暴露完整 RESTful 控制 API,連線清單、節點延遲、流量統計、運行日誌都以 JSON 回傳,切換節點、調整模式、觸發訂閱更新都是一次 HTTP 請求。對接 metacubexd、yacd 等開源 Web 面板即可獲得視覺化監控,不依賴特定 GUI;撰寫自動化腳本做定時測速、異常告警也只需要 curl。API 預設僅監聽本機迴環位址,對外開放前務必設定 secret 驗證。
curl http://127.0.0.1:9090/version快速上手
三步驟接入,完整流程與截圖請見教學頁
-
取得並安裝客戶端
在下載頁選擇對應平台的安裝包,注意區分 x64 與 ARM64 架構。Windows 與 macOS 直接執行安裝精靈,首次啟動依系統提示完成服務或網路延伸功能授權;Android 安裝 APK 或從商店取得,iOS 統一透過 App Store。安裝完成後建議先進一次設定頁,確認核心版本與開機自動啟動選項。
-
匯入訂閱連結
複製服務商提供的訂閱位址,在客戶端的設定或訂閱頁貼上匯入,等待節點清單拉取完成,並順手開啟定時自動更新。匯入失敗時先確認連結是否複製完整、是否已過期,再確認目前網路能否直連訂閱伺服器;反覆失敗的情境在說明中心有逐項排錯清單。
-
選擇節點並驗證連通
切換到規則模式,在策略群組裡選定一個延遲較低的節點,存取任意網頁確認連通,再用測速頁面確認頻寬符合預期。異常時開啟日誌面板,按連線失敗、DNS 解析、規則未命中三類線索逐項排查;行動裝置還應確認應用程式未被系統的背景省電策略關閉。
三步走完即可正常使用。如果卡在某一步,不必從頭重裝:安裝問題多與系統架構或權限授權有關,匯入問題多與訂閱連結本身有關,連通問題多與節點或規則有關,按環節定位比盲目重試更快。教學頁對每一步都配有截圖與對應平台的差異說明。
開源背書
從 2018 年的初代核心到今天的 mihomo,專案譜系、程式碼與發布流程全部公開可查
- 專案歷史可追溯Clash 核心 2018 年在 GitHub 開源,原儲存庫封存後由社群分支 mihomo(原 Clash.Meta)接續維護,設定格式向後相容,生態譜系請見文章區的開源生態全景一文。
- 核心程式碼公開mihomo 核心以 Go 撰寫、GPL 授權託管於公開儲存庫,每一次提交、每個 Release 的編譯產物與校驗和皆可追溯,任何人都能審核原始碼或從原始碼自行建置。
- 社群持續維護各平台 GUI 客戶端(Clash Verge Rev、ClashMetaForAndroid 等)由獨立社群儲存庫迭代,Issue 討論、變更日誌與發布節奏全部公開,不存在閉源黑盒元件。
- 更新機制透明本站安裝包跟隨上游儲存庫的正式 Release 同步更新,不做二次打包與注入;下載前可對照上游發布頁核對檔名與版本號,拿到的與開發者發布的一致。
- 核心與介面分層GUI 客戶端只負責介面與程序管理,流量處理全部由內嵌的 mihomo 核心完成;介面停更時核心仍可獨立升級替換,不被單一專案的存廢綁架。
開源對一般使用者的意義並不抽象:它意味著流量處理邏輯寫在所有人都能讀的程式碼裡,意味著出現問題時可以在公開 Issue 裡找到同樣的案例與修復進度,也意味著即使某個客戶端專案停止維護,設定檔與訂閱仍能原樣遷移到生態內的其他客戶端繼續使用。下面的指令可以直接拉取核心原始碼,自行審閱或編譯。
git clone https://github.com/MetaCubeX/mihomo.git
常見問題精選
一句話答案,完整排查路徑請見說明中心
以下四條涵蓋了新使用者提問頻率最高的情境,先對號入座能省去大部分排查時間;沒有命中的問題,直接到說明中心按症狀檢索。
最新文章
選型對照、平台指引與排查紀錄,長文件持續補充中,全部文章入口在頁尾
Clash 開源生態全景:核心、GUI 客戶端與規則專案之間的關係梳理
把核心專案、各平台 GUI 客戶端、規則集與轉換工具放進同一張關係圖,說明誰依賴誰、哪些專案已封存、社群維護現況如何,幫助讀者看懂生態後再做選型。
iOS 怎麼用 Clash:App Store 取得客戶端與訂閱設定匯入流程
iOS 平台沒有離線安裝包,客戶端統一透過 App Store 取得。依序示範商店下載、首次啟動 VPN 描述檔授權、訂閱連結匯入與節點連通性驗證四個環節。
手機上 Clash 耗電嚴重怎麼排查:背景執行策略與省電設定調整
從規則集輪詢、日誌等級、DNS 並發到系統背景限制,逐層定位行動裝置耗電來源,並提供 Android 電池最佳化白名單與 iOS 按需連線的具體設定方法。