確認晶片與系統需求
開啟 Apple 選單中的「關於這台 Mac」,查看晶片或處理器名稱。Apple Silicon 與 Intel 使用不同架構的安裝檔;接著前往下載頁確認用戶端最低系統需求,將 App 移至「應用程式」後再啟動,避免長期直接從磁碟映像檔執行。
從系統代理接管到規則分流,依 Mac 晶片選擇用戶端,並參考 YAML 設定與 TUN 使用步驟。
功能依用戶端實作與使用的核心而異,設定名稱請以實際介面為準。
系統代理會將目前網路服務的 HTTP、HTTPS 與 SOCKS 入口指向本機監聽連接埠,適合先讓瀏覽器透過 Clash 連線。匯入設定並啟動核心後,再開啟用戶端的系統代理;連接埠必須與執行中的設定一致。Safari 通常會讀取系統設定,但終端機工具可能需要另外指定代理。系統代理與 TUN 的差異在於流量接管方式:系統代理仰賴應用程式遵循代理設定,不會自動涵蓋每個處理程序,也不會替應用程式決定最終出口。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
TUN 透過虛擬網路介面接收流量,可供不讀取系統代理設定的應用程式使用。使用 mihomo 的用戶端通常需要先安裝服務或授予權限,再啟用 TUN,並搭配路由與 DNS 設定。相較於系統代理,TUN 的接管範圍更廣,也更容易與其他 VPN、虛擬機網路或企業網路政策衝突。初次設定時,先確認一般代理可正常運作,再單獨測試 TUN;若遇到斷網,先關閉 TUN、保留記錄並檢查路由,避免同時變更多項設定。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
規則分流會將請求特徵對應至直連、拒絕或指定策略組。設定為規則模式後,核心會依清單順序檢查網域、目標 IP 等條件,符合規則時使用相應出口,最後再套用兜底規則。相較於全域模式,規則模式可分別處理本機服務與需要代理的請求。策略組負責選擇出口,規則則決定哪些請求使用該策略組,兩者不能互相取代。修改後應查看連線記錄中的命中規則確認結果,不要只憑網頁能否開啟判斷設定是否正確。
mode: rule
rules:
- DOMAIN-SUFFIX,local,DIRECT
- IP-CIDR,127.0.0.0/8,DIRECT
- MATCH,DIRECT
設定覆寫可將本機差異與遠端訂閱分開保存,例如固定監聽連接埠、追加區域網路直連規則,或調整記錄層級。直接修改下載的訂閱檔案,變更可能在下次更新時被覆蓋;支援覆寫的用戶端則可在產生執行設定時合併本機內容。覆寫不是通用的 Clash 核心開關,各用戶端處理物件、陣列與指令碼的方式各不相同。啟用前先備份原始設定、確認合併順序,再檢查最終執行設定,尤其要留意規則追加位置與同名策略組是否遭到取代。
mixed-port: 7890
allow-lan: false
log-level: info
先完成一般系統代理連線,再依應用需求新增 TUN 與覆寫,方便逐步確認每項變更的影響。
開啟 Apple 選單中的「關於這台 Mac」,查看晶片或處理器名稱。Apple Silicon 與 Intel 使用不同架構的安裝檔;接著前往下載頁確認用戶端最低系統需求,將 App 移至「應用程式」後再啟動,避免長期直接從磁碟映像檔執行。
使用可信來源提供的訂閱網址或本機 YAML 檔案。匯入後確認已選取該設定,再檢查策略組的出口選擇。用戶端與設定來源是兩回事;安裝 App 不會自動產生可用的遠端節點,也不代表已經有網路服務。
核心執行後啟用系統代理,使用瀏覽器測試所需網站,再查看連線記錄中的目標、命中規則與策略組。若瀏覽器可用但終端機失敗,先檢查終端機是否指定代理;不要直接歸咎於節點,也不必立刻重裝用戶端。
初次連線建議只啟用一種流量接管方式。若同時使用其他 VPN 或代理工具,先記下用途並暫停其中一項進行測試,避免兩個程式交替修改路由與 DNS。測試結束後正常結束用戶端,並確認系統代理已還原;詳細授權路徑與異常復原步驟請參閱教學。
依作業系統前往用戶端清單,並在下載頁集中查看安裝檔、處理器架構與系統需求。
跨裝置使用時,設定語法相似不代表所有功能都完全相同。先確認用戶端採用的核心,再檢查協定、規則集格式與 DNS 欄位是否受支援。Mac 的系統代理開關、行動裝置的 VPN 授權,以及桌面版的服務安裝,是各平台不同的連線方式,不能將一台裝置的介面操作原封不動套用到另一台。即使訂閱可以共用,也應將本機監聽連接埠、檔案路徑與介面偏好保留在各裝置上。
先依 Apple Silicon 或 Intel 選擇安裝檔,再比較 Clash Plus、Clash Verge Rev 與 FlClash 的設定管理方式。需要選單列操作或 TUN 時,請分別確認介面實作與服務權限,不要將單一用戶端的選項視為所有 Mac 用戶端的共同功能。
前往下載 macOS 用戶端查看 Clash Plus、Clash Verge Rev 等圖形用戶端,確認系統與處理器架構需求。尋找 Clash for Windows 替代方案時,先備份訂閱與本機規則,再遷移設定;若使用商店版 App 遇到迴圈存取問題,可參閱教學中的 Windows 平台補充說明。
前往下載 Windows 用戶端依裝置處理器架構選擇用戶端安裝檔,首次連線時請留意系統的 VPN 授權提示。行動作業系統的背景限制可能影響持續連線;切換網路後應重新檢查 DNS 解析與連線狀態,不能直接沿用桌面版的系統代理排除方式。
前往下載 Android 用戶端下載頁提供 Clash Plus 的 App Store 連結,並列出官方網站 clashplus.io。匯入設定後,依系統提示新增 VPN 設定,再確認所需 App 可正常使用。與 Mac 共用訂閱前,先確認行動版支援其中的協定與欄位,並保留各裝置自己的本機設定。
前往下載 iOS 用戶端桌面環境可選擇 Clash Verge Rev 或 FlClash,並依發行版確認套件格式。伺服器與路由器使用者可前往核心專區查看 mihomo;若只執行核心,須自行管理設定目錄、處理程序與網路權限,不能依賴桌面選單接管流量。
前往下載 Linux 用戶端連接埠與接管方式。本頁浮動視窗顯示的是本機代理入口,不是遠端節點位址。若用戶端使用其他連接埠,macOS 網路設定與命令列參數也要一併調整。只修改 YAML 中的連接埠而未重新載入設定,執行中的處理程序可能仍使用舊值;請先確認記錄與目前的監聽狀態,再測試請求。
訂閱與本機修改。訂閱網址可能包含存取憑證,應視為敏感資訊妥善保存,勿貼在公開截圖或程式碼儲存庫中。更換用戶端時,建議先匯出本機規則與覆寫,再重新匯入訂閱;直接複製整個 App 資料夾,可能連同舊路徑、快取與不相容的介面設定一併搬移。
Clash 生態並非一套名稱對應一種介面的單一軟體。負責解析設定、執行規則與建立連線的是核心;負責管理訂閱、切換系統代理、提供選單列與更新介面的則是圖形用戶端。了解兩者分工後,就能將「介面沒有選項」、「不支援設定欄位」與「流量接管未生效」視為不同問題處理,減少重複安裝與盲目修改設定。
原版 Clash 專案停止更新後,社群持續發展衍生核心與圖形用戶端。mihomo 延續 Clash Meta 分支的技術路線,保留許多熟悉的設定欄位,也加入自身功能。舊設定可供讀取,不代表所有新協定、新格式的規則集或 DNS 選項都能在舊核心上運作。遇到解析錯誤時,應先確認實際執行的核心名稱,再查閱相應文件,而不是只看 App 圖示或安裝檔名稱。
舊教學也可能使用已變更的選單名稱或權限流程。參考時應先釐清操作目的,例如「開啟目前網路服務的代理設定」或「檢查最終執行設定」,再到所用的用戶端尋找相應入口。封存版用戶端可供了解舊設定,但選擇用戶端時仍須考量目前的系統相容性與專案說明,不應將舊截圖視為現行介面的保證。
即使都是以 mihomo 為基礎的用戶端,提供的覆寫機制、訂閱更新方式與系統服務管理流程也可能不同。核心支援某個欄位,不代表介面一定有對應按鈕;介面上有 TUN 開關,也不代表服務權限已設定完成。排除問題時,先確認設定是否成功產生,再確認核心是否啟動,最後檢查作業系統是否將流量送往正確入口。逐層驗證比同時調整多個開關更容易重現問題。
本頁的 YAML 片段僅用於說明欄位位置,並非可直接連線的完整訂閱。實際設定還需要節點、策略組與適合使用情境的規則。將範例合併至現有檔案前,應確認縮排與欄位層級,避免重複的頂層鍵;修改後先使用用戶端的設定檢查功能,再重新載入執行設定,並保留修改前的備份以便還原。
mihomo 的原始碼與文件可用於確認設定欄位含義、平台限制與變更紀錄。查閱時應區分核心儲存庫與圖形用戶端儲存庫:代理協定、規則比對或 DNS 行為通常應先查核心文件;訂閱清單、選單列與服務安裝則應查看相應用戶端說明。公開原始碼有助於追蹤實作,但不能取代對設定來源與本機權限的判斷。
向專案回報問題時,請保留必要的系統資訊、核心類型與最小重現設定。記錄中可能包含瀏覽過的網域、訂閱網址或節點資訊,公開提交前應先移除敏感資料。盡量說明「執行了什麼操作、預期結果為何、實際出現什麼」,不要上傳整份日常使用設定,方便維護者定位問題,也能減少無關資訊。
用戶端更新、核心更新與訂閱更新是三個獨立流程。用戶端更新可能改變設定管理與權限流程,核心更新可能調整欄位行為,訂閱更新則可能替換節點與規則。更新前記下目前的流量接管方式與本機覆寫;完成後分別測試瀏覽器、命令列與區域網路服務,不要將「App 能啟動」視為所有網路路徑都已正常。
更新後若出現異常,先比對最終執行設定與記錄,再決定要還原哪一層。遠端訂閱覆蓋設定時,恢復本機規則比重裝 App 更直接;系統代理設定殘留時,應檢查網路服務設定;TUN 無法啟動時,則要檢查服務授權與衝突程式。每次只縮小一項變更範圍,才能保留清楚的排錯線索。
可供閱讀實作與變更紀錄;一般安裝不必複製儲存庫,也不需要自行編譯核心。
git clone https://github.com/MetaCubeX/mihomo.git
從本機連線問題到策略組選擇,依照實際需求繼續閱讀。
依序檢查節點品質、出口線路與本機設定,涵蓋 DNS 模式、TUN 堆疊選擇及 Wi-Fi 省電干擾,快速找出 macOS 上的網路瓶頸。
閱讀全文 →逐一解析三種自動策略組的測速邏輯、切換時機,以及 interval、tolerance 等欄位,附上 YAML 範例與適用情境。
閱讀全文 →從原版核心停止更新到 mihomo 接手,釐清核心、圖形用戶端與規則集專案的分工,協助挑選適合 macOS 的用戶端組合。
閱讀全文 →