開源核心 · 全平台客戶端

Mihomo 核心的 Clash 客戶端 下載與設定教學

下載Clash 查看教學

從適合目前系統的客戶端開始，依序完成訂閱匯入、規則分流與系統代理設定。頁面也說明 Mihomo 核心、圖形客戶端與設定檔之間的關係，方便依問題快速找到資料。

永久免費 程式碼開源 中文文件
CORE mihomo LICENSE GPL-3.0 PLATFORMS 5 CONFIG YAML

設定資料瀏覽器

先了解設定，再開啟系統代理

客戶端介面負責操作，Mihomo 核心負責處理連線，設定檔則告訴核心如何分流。以下四組資料對應日常使用中最常遇到的設定。

config.yaml

設定檔是核心的執行說明

mixed-port: 7890
mode: rule
log-level: info
allow-lan: false

Clash 客戶端匯入訂閱後，通常會將遠端內容儲存為可切換的 Profile，再交由 Mihomo 核心載入。設定中包含連接埠、代理節點、策略群組、規則與 DNS 等欄位。日常使用不必從空白檔案開始編寫，先匯入服務提供者給的訂閱，再確認客戶端顯示「設定有效」。需要手動修改時，應先複製一份設定，避免訂閱更新後覆蓋本機變更。

相較於只提供固定開關的網路工具，YAML 設定能清楚表達各層關係，也更方便遷移與排錯。若啟動失敗，先查看日誌指出的欄位與行號，再檢查縮排、冒號後的空格及清單層級。設定成功載入只是第一步，後續還要選擇策略群組並開啟系統代理。

了解訂閱匯入步驟 →

客戶端下載

依作業系統選擇 Clash 客戶端

圖形客戶端適合日常桌面與行動裝置。伺服器、路由器及自動化環境則可考慮直接使用 Mihomo 核心。

Windows

適合長時間在桌面執行。下載前確認裝置架構，安裝後重點檢查系統代理、混合連接埠與開機啟動選項。若舊客戶端仍在執行，應先退出，避免多個程式同時佔用代理連接埠。

前往下載

macOS

依 Intel 或 Apple Silicon 選擇對應安裝包。首次執行可能需要在系統設定中確認權限；開啟代理後，也要留意其他網路工具、瀏覽器擴充功能與系統 VPN 是否同時改變連線路徑。

前往下載

Android

行動裝置通常透過系統 VPN 介面接管流量。匯入訂閱並啟動後，確認狀態列顯示連線狀態；背景省電限制可能會終止客戶端程序，長時間使用時可依系統設定允許其穩定執行。

前往下載

iOS

透過 App Store 取得支援 Mihomo 設定的客戶端。首次新增網路設定時，系統會要求確認；匯入後應先選擇策略，再啟動連線，並從客戶端日誌判斷訂閱更新或規則載入是否成功。

前往下載

Linux

桌面使用者可選擇具圖形介面的客戶端，伺服器使用者則可直接執行 Mihomo 核心。部署前確認發行版、處理器架構、設定路徑與服務權限，並為日誌與設定更新保留清楚的目錄。

前往下載

查看全部客戶端 →

快速上手

匯入、選擇、驗證三步完成基礎連線

先沿著主線完成一次可用連線，再處理規則、DNS 或區域網路共享等進階設定。一次只做一項變更，排錯會更清楚。

  1. 01

    匯入訂閱設定

    開啟客戶端的設定或 Profile 頁面，貼上完整訂閱網址並執行下載。匯入後手動更新一次，確認設定名稱、策略群組與規則都已顯示。若提示格式錯誤，先檢查連結是否被截斷，不要將網頁網址當作訂閱網址。

  2. 02

    選擇策略與模式

    進入代理或策略群組頁面，選擇一個可用策略。執行模式先使用「規則」，它會依設定區分直連與代理。測試期間不要同時修改 DNS、連接埠與規則，否則發生變化時難以判斷是哪項設定產生作用。

  3. 03

    開啟代理並驗證

    桌面端開啟系統代理，行動端啟動系統 VPN 連線。接著造訪一個外部網站，並在客戶端連線記錄中確認請求已出現、規則已命中、策略已選定。網頁能開啟但記錄為空時，應優先檢查系統代理是否確實指向客戶端連接埠。

完整教學還包含設定更新、模式切換、出口驗證與常見失敗現象的處理順序。

查看完整教學 →

開源生態

Mihomo 核心、客戶端與設定資料的關係

判斷一個 Clash 客戶端是否適合自己，不能只看介面。還要分清核心來源、設定相容性、更新路徑與問題邊界。

專案演進與核心定位

Mihomo 是 Clash Meta 專案延續使用的核心名稱，負責監聽本機連接埠、解析設定、建立代理連線、執行規則比對並處理 DNS。使用者平時看到的視窗、系統匣選單、訂閱管理與系統代理按鈕，多數由上層圖形客戶端提供。核心與客戶端並不是同一個軟體包，因此兩個客戶端即使都使用 Mihomo，安裝方式、設定入口與系統整合也可能不同。

開源生態中的職責分工

核心維護者關注協定實作、設定欄位、網路行為與執行穩定性；客戶端維護者負責將這些能力整理成適合桌面或行動系統的介面。訂閱服務提供者則負責產生節點、策略群組與規則。出現問題時先判斷所屬層級：介面無法開啟屬於客戶端層，設定解析失敗通常與 YAML 或欄位相容性有關，節點逾時屬於連線層，網站走錯策略則應查看規則命中。

設定相容性與遷移方式

Mihomo 支援較完整的 Clash 設定結構，但不同客戶端可能會在原始設定之外儲存自己的介面設定。例如開機啟動、視窗行為與系統代理開關通常不會寫入訂閱檔案。遷移客戶端時，應分別備份訂閱網址、本機覆寫規則與客戶端偏好，不要只複製一個設定檔就假定所有設定都會跟隨。重新匯入後，逐項核對策略群組、DNS 與系統代理狀態較為穩妥。

更新機制與問題重現

客戶端更新、核心更新與訂閱更新是三條不同的路徑。客戶端升級主要變更介面與系統整合；核心升級可能加入設定欄位或修正網路行為；訂閱更新則會替換節點、規則與策略群組。排錯時記錄使用的平台、客戶端名稱、設定來源、執行模式與關鍵日誌，能減少無效嘗試。若更新後出現異常，先確認變化發生在哪一層，再決定回頭檢查設定或客戶端選項。

常見問題精選

先依現象確認排錯方向

匯入訂閱後為什麼沒有可選策略？

先手動更新目前的 Profile，確認訂閱網址回傳的是 Clash YAML 設定，而不是登入頁面或一般網頁。若設定可以載入但策略為空，再查看客戶端日誌中的解析提示，並到使用教學核對匯入步驟。

開啟客戶端後為什麼網頁仍然直連？

桌面端需要同時確認核心正在執行，以及系統代理已經開啟。若瀏覽器使用獨立的代理擴充功能，也要檢查它是否覆蓋系統設定。開啟客戶端連線記錄並重新整理網頁；記錄為空通常表示流量尚未進入客戶端。

規則模式與全域模式該選哪個？

日常使用優先選擇規則模式，讓不同連線依設定分流。全域模式適合暫時驗證節點是否可用，不建議將它當成所有問題的固定解法。測試完成後切回規則模式，再查看具體的規則命中情況。

設定更新後為什麼修改內容消失了？

訂閱更新通常會重新寫入遠端設定，直接在本機編輯的內容可能會被替換。需要長期保留的調整，應使用客戶端提供的覆寫功能，或維護獨立的設定副本。操作前先記錄原值，方便發生問題時還原。

技術筆記

設定管理與故障定位紀錄

文章圍繞一個具體問題展開，提供可重現的檢查步驟。先查看與現象對應的主題，再依序執行。

入門指南

Clash 設定檔 Profile 是什麼：多設定切換與管理方法

說明 Profile、訂閱連結與 config.yaml 的關係，並整理多個設定的命名、切換、更新與清理方法，減少誤改設定或覆蓋本機內容的情況。

閱讀全文 →
故障排除

Clash 連接埠被佔用怎麼辦：找出 7890 衝突程序並修改混合連接埠

分別使用 Windows、macOS 與 Linux 常見命令找出佔用程序，並說明修改 mixed-port 後如何同步檢查系統代理，避免連接埠改了但流量入口仍指向舊值。

閱讀全文 →
格式與選型

Clash 訂閱格式總覽：YAML、Base64 分享連結與 sing-box JSON 如何互轉

比較常見訂閱格式的結構與辨識方式，說明轉換前需要保留的欄位，以及轉換完成後應重新核對的策略群組、規則、DNS 與協定參數。

閱讀全文 →

查看全部文章 →