mihomo 核心 · 用戶端與設定文件

Clash Meta下載與設定指南

下載Clash 查看教學

依作業系統選擇用戶端，完成訂閱匯入、設定規則分流，並檢查代理連線。

  • 開源核心
  • 多平台下載入口
  • 中文設定說明

平台與安裝檔

Clash 用戶端下載

先確認作業系統與處理器架構，再選擇圖形用戶端。安裝檔、系統需求與維護狀態集中整理於下載頁，核心檔案則另行列出。

Windows

桌面用戶可先了解 Clash Plus，再依介面偏好比較 Clash Verge Rev、FlClash 與 Clash Nyanpasu。系統代理適合遵循系統設定的應用程式；若要接管更多連線，再確認 TUN 所需的權限與服務。安裝前請確認處理器架構，也不要直接以舊用戶端的安裝目錄覆蓋新專案。

前往下載

macOS

先分清 Apple Silicon 與 Intel，再選擇對應的安裝檔。Clash Plus、Clash Verge Rev 和 FlClash 可作為挑選介面的起點。首次執行時，依系統提示完成授權；切換用戶端前，先關閉原用戶端的代理接管功能。設定是否相容，應依實際使用的核心與設定欄位判斷，而非只看應用程式名稱。

前往下載

Android

依裝置架構選擇安裝包，並在首次連線時確認 VPN 授權。Clash Plus、Clash Meta for Android 與 FlClash 的設定入口各不相同，請先匯入訂閱，再檢查應用程式分流與背景執行限制。Surfboard 使用不同於 Clash YAML 的設定格式，不能只改副檔名就直接共用。

前往下載

iOS

下載頁提供 Clash Plus 的 App Store 下載入口及官方網站 clashplus.io。安裝後，先允許新增 VPN 設定，再匯入用戶端支援的連結或檔案。桌面設定中的本機路徑、指令碼和特定系統參數未必適用於手機；匯入失敗時，先確認設定格式及應用程式支援範圍，再修改內容。

前往下載

Linux

有桌面環境的使用者可從 Clash Verge Rev 和 FlClash 開始，並依發行版選擇套件格式。伺服器與路由器使用者可參考獨立的 mihomo 核心下載入口，但需自行管理設定目錄、程序與網路權限。桌面圖形用戶端與背景服務不可同時占用相同的監聽連接埠或虛擬網卡。

前往下載

安裝成功只代表程式能夠執行，不表示訂閱、節點或分流已生效。首次使用時，建議只啟動一個用戶端、保留原始設定副本，並依「匯入、選擇、驗證」的順序完成檢查。

查看所有用戶端 →

瀏覽設定功能

mihomo 與規則分流

圖形介面負責操作，核心負責連線與執行規則。依照使用情境查看相關功能，先了解作用範圍，再決定是否啟用。

依目標選擇出站

規則分流會將不同目標的連線導向不同出站策略，免去每次存取都手動切換模式。mihomo 會依序比對規則，由第一個符合的項目決定後續路徑；網域、位址範圍與規則集都可做為條件。策略組則用來管理可選的出站方式，兩者屬於不同層級。遇到應用程式走錯路徑時，先查看連線記錄中的命中規則，再調整規則順序，不要直接將所有流量改為全域模式。

了解更多 ›

分清規則與策略組

匯入設定後，先在代理頁面選好策略組的出站項目，再以規則模式建立新連線。手動選擇的項目會保留，會自動測試的策略組則依設定執行測試與切換。相較於原版 Clash，mihomo 擴充了部分規則與策略功能，但可用欄位仍須參照核心文件。自訂規則應放在確實需要優先比對的位置，並透過用戶端的覆寫或合併機制管理，避免下次更新訂閱時遺失修改。

了解更多 ›

首次執行流程

訂閱匯入與連線檢查

保留一套可重複執行的檢查流程：先確認設定正常載入，再選擇出站策略，最後檢查實際連線。每次只調整一類設定。

步驟 01 / 設定

匯入並啟用 Profile

開啟用戶端的設定頁面，貼上來自可信來源的訂閱連結，或選擇本機 YAML 檔案。等待下載與解析完成後，再明確選取這份設定。檔案出現在清單中，不代表核心已載入；請同時確認目前設定標記與錯誤訊息。

匯入失敗時，先確認連結傳回的是網頁還是設定內容，再檢查格式是否適用於目前的核心。訂閱連結可能包含存取憑證，分享截圖時請遮住完整網址，也不要將連結貼到公開討論區。請先保留一份可還原的設定，再嘗試覆寫與合併。

步驟 02 / 出站

選擇模式與策略組

首次連線可使用規則模式，在設定提供的策略組中選擇出站項目，再依系統要求啟用系統代理或允許 VPN 連線。延遲測試只反映特定測試目標的連線狀況，不能直接代表所有網站的存取速度，也無法取代完整的實際連線測試。

先確認基本代理路徑正常，再決定是否需要 TUN。全域模式改變的是策略選擇方式，不會自動讓原本忽略系統代理的應用程式開始使用代理。切換模式後，請建立新連線並查看結果；已建立的長連線可能仍沿用原本的出站路徑。

步驟 03 / 驗證

檢查連線與命中規則

連線至明確的測試目標，並查看用戶端連線清單中的目標網域、命中規則、策略組與最終出站。若要確認出口，再搭配可信的 IP 查詢網站檢查。網頁能開啟只代表目前的請求成功，仍應查看記錄確認流量是否經過預期路徑。

如果瀏覽器正常，但某個應用程式無法連線，先確認該應用程式是否遵循系統代理，再檢查流量接管範圍與 DNS。Windows 市集應用程式也可能受到回環限制影響。記錄出問題的應用程式、目標與日誌摘要，分別檢查設定、代理路徑與名稱解析；不要同時更改多個參數，以免失去比較依據。

查看完整教學 → 首次連線檢查清單 →

專案與維護依據

開源生態與核心關係

分清核心專案、圖形用戶端與訂閱來源。程式碼、授權條款與更新紀錄都可查閱，但用戶端名稱本身無法證明所有設定都相容。

Clash、Meta 與 mihomo

Clash 是這類規則代理工具的重要起點；Clash Meta 在相關設定體系上擴充了協定與網路功能，後續核心專案則以 mihomo 的名稱持續發展。日常搜尋中的「Clash Meta」可能指核心，也可能指採用該核心的圖形用戶端。要辨別具體專案，需一併查看應用程式名稱、核心說明與維護紀錄，不能將這三個名稱視為可互換的安裝包。

核心負責解析設定、比對規則與處理連線；圖形用戶端通常提供訂閱清單、系統匣操作、系統代理開關與日誌介面。不同介面可以搭配相同核心，而不同介面也可能採用各自的設定預處理方式。遷移時，請先確認匯出內容是標準核心設定，還是僅供特定用戶端使用的管理資料，再決定匯入方式。

原始碼與授權條款

mihomo 的原始碼與專案說明可在 MetaCubeX 的公開儲存庫查閱，核心採用 GPL-3.0 授權。授權條款說明程式碼的使用、修改與散布條件，並不表示每個圖形用戶端都採用相同授權，也不代表核心專案提供訂閱服務。如需散布或二次開發，請分別閱讀所使用專案的授權全文與相依套件說明。

查閱原始碼有助於核對實際實作與文件，而不是以星號數量作為連線品質保證。本文不列出即時熱度數據；判斷功能是否適用時，應優先參考公開文件、變更紀錄，以及目前用戶端實際整合的核心。社群討論可用來尋找已知問題，提交回報前仍須移除設定中的存取憑證與個人資訊。

查看 mihomo 開源儲存庫 ↗

更新機制與相容性界線

用戶端更新、核心更新、訂閱更新與規則集更新是四件不同的事。用戶端更新可能改變介面與權限流程；核心更新可能調整協定或設定欄位；訂閱更新主要刷新遠端設定內容；規則集更新則會改變部分規則參照的資料。排查變更時，先確認是哪一層更新，才能找到相應紀錄，避免把所有問題都歸咎於訂閱。

更新前請保留設定副本與本機覆寫內容。更新後先用原本的測試目標檢查基本連線，再驗證自訂規則。舊設定能通過解析，不代表所有行為都與舊環境一致；反之，新設定中的擴充欄位也可能讓舊核心無法載入。封存版用戶端可供查閱舊環境，日常選用時則應優先考慮仍有維護紀錄且明確支援目標系統的專案。

訂閱來源與文件範圍

本站整理用戶端下載入口、操作流程與概念說明。訂閱提供哪些出站項目、伺服器採用哪些參數，以及遠端網址是否可連線，皆由相應的設定來源決定。安裝用戶端後仍需有效設定；安裝檔本身並非訂閱服務。如需確認參數，應向設定提供者查詢協定類型、格式與使用要求，不要根據用戶端名稱推測連線資訊。

不同用戶端的按鈕名稱與設定位置可能有所不同，因此教學會依「匯入設定、選擇出站、接管流量、驗證連線」的主要流程安排。若介面不同，請尋找對應功能，不必照搬所有開關。需要了解策略組、規則集或 DNS 增強模式時，可先查閱概念速查；需要比較協定與核心功能時，再參考協定手冊。

概念速查 › 協定手冊 › 常見問題 ›

取得 mihomo 原始碼

可在已安裝 Git 的環境中複製以下指令。複製儲存庫只會下載程式碼，不會自動安裝圖形用戶端，也不會啟用系統代理。編譯與執行需求請參閱儲存庫文件。

git clone https://github.com/MetaCubeX/mihomo.git

可複製到本機終端機；執行前請確認指令內容。

設定與問題記錄

近期技術文章

本文說明設定管理、DNS 行為與應用程式相容性。先確認問題所在的層級，再依文章步驟逐項檢查。

查看所有文章 →