Windows
適合日常桌面使用。下載頁列出具備圖形介面的客戶端,並說明安裝、匯入設定與接管系統代理的方式。
前往下載iOS 客戶端與中文設定文件
從選擇客戶端到匯入訂閱,依照實際操作流程整理。你可以在這裡找到五大平台入口、中文設定說明與故障排查步驟。
Platform Downloads
不同系統使用不同的安裝套件與權限機制。先選擇目前使用的裝置,再到下載頁比較可用客戶端、系統要求與安裝方式。
適合日常桌面使用。下載頁列出具備圖形介面的客戶端,並說明安裝、匯入設定與接管系統代理的方式。
前往下載適用於 Intel 與 Apple 晶片 Mac。選擇安裝套件前先確認處理器架構,再依客戶端提示授權網路擴充功能或系統代理。
前往下載適合手機、平板與部分電視裝置。下載頁區分常見處理器套件,並提供圖形客戶端與訂閱設定入口。
前往下載適合 iPhone 與 iPad。客戶端透過系統網路擴充功能運作,可匯入訂閱、選擇策略組並設定按需連線。
前往下載適合桌面 Linux、伺服器與路由器環境。一般使用者可選擇圖形客戶端,進階使用者則可繼續查看 mihomo 核心入口。
前往下載Core Configuration
四個設定面板涵蓋日常最常用的操作。上方索引可快速定位,面板內容則依照實際設定順序展開。
Traffic Mode
規則模式適合長期使用。客戶端會從設定檔頂端開始,依序檢查網域、IP、程序或規則集合,符合後交由指定策略組處理。你可以讓常用服務直連,讓需要代理的請求進入節點選擇組,也可以為區域網路位址保留本機存取路徑。
全域模式會將大多數流量交給同一個策略,排查節點是否可用時較直接,但不適合作為複雜設定的判斷依據。遇到「部分網站能開啟、部分網站無法開啟」時,先確認目前模式,再檢查對應網域符合了哪條規則。
Network Access
允許區域網路可讓同一網路中的其他裝置連線至本機代理埠。只有在確實需要分享時才開啟,並確認監聽位址、系統防火牆與埠設定一致。iPhone 上的區域網路權限則會影響區域網路裝置的探索與存取,作用與代理連線本身並不完全相同。
DNS 劫持會將系統解析請求送入客戶端的 DNS 模組,避免解析結果與規則判斷脫節。設定時需同時核對 enable、監聽位址、增強模式、上游伺服器與回退條件。只更換其中一個位址,通常無法解決規則、網路或節點造成的問題。
Subscription
訂閱網址通常由服務提供者產生,客戶端會依設定週期重新下載設定。啟用自動更新前,先手動更新一次,確認檔案可解析、策略組可開啟且規則引用沒有錯誤。如此可分別判斷網址失效、網路阻擋與設定語法問題。
更新訂閱會覆蓋遠端提供的內容,本機臨時修改可能隨之消失。需要長期保留的 DNS、規則或策略組調整,應使用客戶端支援的覆寫與合併功能,而不是直接修改訂閱原文。更新失敗時,先檢查網址是否可存取、系統時間與網路權限。
On Demand
按需連線會利用 iOS 的網路條件觸發客戶端,例如在行動數據、指定 Wi-Fi 或未知網路環境下自動建立連線。設定前應先完成一次手動連線,確認系統已建立對應的 VPN 設定,並允許客戶端加入網路擴充功能。
規則應從具體條件寫到一般條件,避免前面的寬泛規則提前符合。家用網路可設定為中斷或忽略,行動數據則可設定為連線。若出現頻繁重新連線,先減少重複條件,再關閉高頻健康檢查,最後核對低耗電模式與系統背景狀態。
Quick Start
先完成一條可驗證的最短流程,再處理自動更新、覆寫與按需連線。這樣更容易找出問題所在的步驟。
在下載頁進入 iOS 區,選擇適用於 iPhone 或 iPad 的客戶端。首次連線時,系統會要求加入 VPN 設定;使用裝置密碼、Face ID 或 Touch ID 完成授權。只需在系統彈出視窗中確認授權,尚未匯入設定前不要反覆切換連線開關。
複製有效的訂閱網址,在客戶端的設定或訂閱頁面選擇從 URL 匯入。下載完成後開啟設定,確認策略組名稱、規則清單與 DNS 區段都能正常讀取。接著進入策略組選擇頁,依用途選擇節點或自動策略,不要只看到設定名稱就直接連線。
啟用規則模式後建立連線,分別開啟一個應直連的網站與一個應經過代理的網站。若結果不如預期,查看連線記錄中的規則名稱與策略組,不要連續更換多個設定。先確認流量的符合路徑,再判斷是規則、DNS、節點或本機網路問題。
Open Source Context
客戶端、核心與設定格式屬於不同層次。理解它們之間的關係,有助於避免將介面、網路與核心問題混在一起排查。
Clash 建立了廣泛採用的 YAML 設定結構,常見內容包括代理節點、策略組、規則、DNS 與執行埠。原始專案停止維護後,社群仍沿用這套設定思路,並持續開發相容實作、規則資料與圖形客戶端。因此舊教學中的基礎概念仍具參考價值,但是否支援具體欄位,仍應以目前的核心文件為準。
mihomo 是持續維護的 Clash 相容核心之一,負責解析設定、建立代理連線、執行規則與處理 DNS。Windows、macOS、Android、iOS 與 Linux 上的圖形客戶端通常會在核心之外提供訂閱管理、系統代理、網路擴充功能、日誌檢視與策略切換。介面名稱可能不同,但底層概念大致一致。
公開程式碼讓社群能檢視設定欄位、行為變更與已知問題。遇到異常時,應先記錄作業系統、客戶端名稱、使用的模式、設定來源與可重現步驟,再決定應查看客戶端專案還是核心專案。只提交「無法使用」通常不足以定位問題,日誌中的欄位錯誤、規則名稱與網路狀態更具判斷價值。
客戶端更新、核心更新與訂閱更新是三條獨立路徑。更新客戶端主要改變介面與系統整合;更新核心可能帶來欄位支援與網路行為變化;更新訂閱則會替換服務提供者下發的節點、策略與規則。發生變化時一次只調整一個層次,並保留上一份可用設定,回復與比較會更清楚。
mihomo source
git clone https://github.com/MetaCubeX/mihomo.git
Common Checks
多數首次使用時遇到的問題,都能在訂閱、模式、策略組與系統狀態這四個位置找到原因。
先在瀏覽器確認訂閱網址仍可存取,再檢查系統時間、網路權限與客戶端中的更新時間。網址能開啟但客戶端無法解析時,繼續確認回傳內容是否為有效設定。
依序檢查系統 VPN 狀態、目前模式、策略組選擇、訂閱有效性與 DNS 解析。每次只變更一項條件,變更後重新測試,避免多個動作掩蓋真正原因。
日常使用優先選擇規則模式,讓不同請求依規則選擇直連或代理。全域模式適合短時間驗證所選節點能否處理流量,但不能取代對規則符合結果的檢查。
遠端訂閱更新後,直接在本機修改的內容可能遭到覆蓋。需要長期保留的 DNS、規則或策略組調整,應放入客戶端支援的覆寫或合併設定中。
Latest Guides
最新文章聚焦速度、DNS 與 iPhone 背景執行。每篇都依照現象、原因與操作順序編排。