# 設定入口 → 規則比對 → 策略出口
# proxy-groups
設定能成功解析，只代表完成第一步。接著還要確認流量從哪個入口進入、符合哪條規則，以及最後使用哪個策略組。以下依實際設定順序說明五個項目；介面示意僅呈現欄位關係，各用戶端的畫面不一定相同。
日常使用可先選擇規則模式。mihomo 會依設定中的 rules 由上而下比對，第一條符合的規則決定使用的策略；前面的網域規則可能讓後面的地區規則不再參與比對。自訂規則應放在兜底 MATCH 之前，規則引用的策略組名稱也必須確實存在。相較於全域模式，規則模式可讓工作場所的內部網路、常用直連服務與代理流量分別走不同出口。修改後請查看連線面板中的命中規則與策略鏈，不要只憑網頁能否開啟來判斷分流是否正確。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY系統代理適合作為初次連線的起點：開啟後，遵循系統代理設定的瀏覽器與應用程式才會將請求送至本機連接埠。部分命令列工具、遊戲或自行實作網路堆疊的程式不會遵循這項設定，這時再評估是否使用 TUN。TUN 透過虛擬網卡與路由接管流量；桌面端通常需要服務模式或相應權限。兩者處理的是流量入口問題，無法取代節點或分流規則。先以系統代理建立可用的基準，再單獨測試 TUN，較容易找出權限、路由與 DNS 衝突。
mixed-port: 7890
allow-lan: false
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: trueFake-IP 模式會為網域回傳虛擬位址，再由核心透過對應資訊還原網域，進行分流並建立實際連線。它不是把所有網域固定導向某個節點，也不是只要單獨開啟就能接管所有 DNS 請求。設定時應一併檢查上游 DNS、TUN 的 DNS 接管，以及瀏覽器本身的安全 DNS 設定。若遇到區域網路裝置探索、企業網域或特定應用程式的相容性問題，可針對個別網域設定 fake-ip-filter，再觀察結果；不要一開始就替換整條解析鏈，以免掩蓋真正的故障原因。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "localhost"節點測試反映的是用戶端存取指定測試網址的結果，不等於所有網站的實際速度。select 策略組供手動選擇；url-test 策略組則依測試結果自動挑選候選節點，實際行為也會受測試間隔、容差與健康檢查設定影響。初次連線建議先在手動選擇組中指定一個節點，確認目標服務可用後再啟用自動選擇。若發生逾時，請分別檢查訂閱是否有效、節點協定與本機網路。不要反覆切換所有設定，也不要因一次測試失敗就判定是核心故障。
proxy-groups:
- name: PROXY
type: select
proxies:
- AUTO
- DIRECT
- name: AUTO
type: url-test
use:
- subscription訂閱可能提供完整設定，也可能只提供節點清單，兩者不能視為同一種檔案。更新訂閱時，用戶端可能重新下載並取代原有設定，因此長期使用的自訂規則較適合透過用戶端支援的覆寫、合併功能或獨立規則集管理。更新後請檢查目前啟用的設定、策略組引用與解析記錄，確認新內容已載入。訂閱連結通常含有存取憑證，不應提交至公開儲存庫或線上轉換頁面；分享問題排查資料前，請移除連結、節點密碼及其他可識別資訊。
設定類型 完整 Clash YAML
訂閱更新間隔 依用戶端設定
目前設定 確認已選取
本機規則 使用獨立覆寫
更新完成後 檢查載入記錄# clients
下載中心依平台列出用戶端、架構與安裝說明。先選擇圖形化用戶端，再確認裝置晶片與系統需求；mihomo 命令列核心主要適合伺服器、路由器及需要自行管理程序的使用者。各用戶端的介面與核心整合方式不同，不宜只憑名稱認定功能完全相同。
可從 Clash Plus、Clash Verge Rev 等圖形化用戶端開始。安裝後匯入訂閱、選擇規則模式，再開啟系統代理。如需使用 TUN，請依用戶端說明設定服務權限；同時執行多個代理工具可能造成連接埠占用，或互相覆蓋系統代理設定。
若要排查瀏覽器正常、終端機卻無法連線的情況，請先檢查終端機是否設定代理環境變數，不要重複安裝用戶端。結束程式前，請確認系統代理已還原。
前往下載 →先在「關於這台 Mac」確認使用的是 Apple Silicon 還是 Intel，再選擇相應安裝套件。系統代理、網路延伸功能與輔助服務的授權位置可能不同；安裝後請閱讀系統提示，並依用戶端文件完成必要授權。
更換網路、從睡眠喚醒或切換至其他 VPN 後若連線異常，請先確認目前網路服務的代理設定。封存的用戶端適合查閱相容性，日常使用則建議優先選擇仍持續維護的版本。
前往下載 →可選擇 Clash Plus、Clash Meta for Android 等用戶端，並依裝置架構安裝。首次連線時會要求 VpnService 授權，這是系統允許應用程式建立本機 VPN 介面的步驟，並不代表已取得遠端節點服務。
鎖定螢幕後若連線中斷，請一併檢查電池最佳化、自動啟動與背景執行限制。若裝置已有其他 VPN 連線，請先確認兩者是否能同時執行；看到連線圖示也不能取代實際連線測試。
前往下載 →下載中心提供 Clash Plus 的 App Store 下載入口與官方網站 clashplus.io。安裝後依應用程式支援的方式匯入訂閱或設定，完成系統 VPN 授權，再選擇策略組測試連線。
iOS 的流量接管由系統網路延伸功能管理，不能直接套用桌面端的系統代理開關說明。設定相容範圍、背景連線行為與可用功能，請以目前使用的應用程式說明為準。
前往下載 →桌面環境可選擇 Clash Verge Rev 或 FlClash，並依 Linux 發行版選用合適的套件格式。桌面代理設定不一定會自動套用至終端機、容器或背景服務，請分別確認各自使用的網路入口。
使用命令列核心時，需自行管理設定目錄、執行權限與服務記錄。啟用 TUN 前，請檢查現有路由、DNS 管理工具與容器網段，並預先保留可用來還原網路的本機操作方式。
前往下載 →# quickstart
先建立最基本的可用連線，再逐步加入複雜規則。用戶端安裝、節點服務與系統流量接管是三個獨立環節：裝好軟體不代表已有節點，有節點也不代表所有應用程式都已使用代理。
準備服務提供者提供的 Clash 相容訂閱，進入用戶端的設定或訂閱頁面，選擇透過連結匯入；若已有本機 YAML 檔案，也可直接匯入檔案。下載完成後選取該設定，確認代理頁面中看得到策略組。若出現解析失敗，請先檢查訂閱格式、連結是否有效及檔案縮排；不要把一般網頁網址當成訂閱連結。原始節點連結也不一定能直接當成完整設定載入。
訂閱連結匯入步驟 →在代理頁面選擇規則模式，進入實際負責代理出口的策略組，先手動指定一個節點。桌面端建議先開啟系統代理；行動裝置則依系統提示授予 VPN 權限。初次測試時不要同時修改 DNS、規則與 TUN；每次只調整一項，方便比較結果。若軟體提示連接埠已被占用，請先結束其他代理程序，或明確調整本機監聽連接埠及使用該連接埠的應用程式設定。
系統代理設定步驟 →先執行用戶端的節點測試，再存取預期會走代理的服務，並開啟連線面板檢查目標網域、命中規則與最終出口。接著存取預期會直連的服務，確認結果是否符合設定。延遲測試成功只代表測試請求可用，仍須實際測試應用程式。若瀏覽器能用、其他應用程式卻失敗，請回頭檢查流量接管範圍；若連線已進入核心卻持續出錯，再檢查節點與遠端服務。
節點測試與連線驗證 →# source & maintenance
Clash Meta 是了解生態發展沿革時常見的名稱，目前的核心專案使用 mihomo 這個名稱。下載站整理下載入口與設定知識；核心原始碼、用戶端發行說明及節點服務狀態，請分別查閱對應專案或服務提供者的資訊。
搜尋 Clash Meta 時，通常也會看到舊名稱、行動用戶端名稱與 mihomo 核心文件。這些名稱彼此相關，但並非同一個安裝套件。mihomo 延續 Clash 相容設定體系，並持續發展規則、協定與 DNS 等功能。了解彼此關係後，若設定欄位出錯，應先確認實際執行的核心及其支援範圍，而不只是看桌面軟體的標題。
協定與欄位的行為應以專案文件為準。網路上的舊教學可能沿用過時的預設值，複製設定片段前，請確認欄位仍適用於目前環境，並保留可還原的設定副本。
mihomo 的原始碼、提交記錄與議題可在 MetaCubeX 的公開儲存庫查閱。公開原始碼有助於追蹤實作方式與變更，但圖形化用戶端可能還有自己的訂閱管理、服務程序與設定覆寫邏輯。介面操作錯誤與核心解析錯誤應分開排查；回報時提供操作步驟、系統環境及已移除敏感資訊的最小設定，通常比只貼一張連線失敗的截圖更有幫助。
問題排查記錄可能包含網域、節點位址或訂閱憑證。提交公開議題前，請先移除敏感內容，只保留重現問題所需的欄位與錯誤資訊。
圖形化用戶端通常負責匯入訂閱、切換設定、調整系統代理及顯示連線；mihomo 核心則依已載入的設定解析請求、比對規則並建立連線。介面中的開關可能會產生或覆寫設定欄位，因此編輯檔案後，還需確認用戶端是否保留修改。iOS 等平台採用各自的應用程式整合方式，不能只因支援 Clash 格式，就推斷核心實作完全相同。
訂閱服務則提供節點及相關設定，與用戶端屬於不同環節。節點到期、流量用盡或服務端異常時，請洽詢訂閱提供者；通常重新安裝軟體無法解決這類問題。
用戶端更新、核心更新與訂閱更新應分開處理。用戶端更新可能變更介面與權限需求；核心更新可能調整協定或欄位行為；訂閱更新則會更新節點與服務提供者的設定。升級前請備份本機規則及必要設定，並閱讀發行說明；升級後依首次連線流程重新檢查系統代理、DNS 與規則命中情形，避免把舊設定殘留誤認為新程式故障。
需要長期維護的規則，應採用可追蹤的覆寫方式。完整的平台安裝步驟請參閱安裝前準備與安裝文件；設定解析、權限與路由問題可查看設定常見問題。
git clone https://github.com/MetaCubeX/mihomo.git# technical-notes
介紹 iOS 上支援 Clash 設定的用戶端如何從 App Store 下載，以及透過訂閱連結、檔案與 QR Code 匯入設定並啟用 VPN 的完整流程。
閱讀技術筆記 →整理常見訂閱格式的結構差異，說明各用戶端支援哪些格式，以及在本機轉換訂閱時應注意的欄位與安全事項。
閱讀技術筆記 →從規則比對順序談起，比較三種代理模式下的實際流量走向，並提供日常瀏覽、遊戲與辦公等情境的模式選擇建議。
閱讀技術筆記 →