CONFIGURATION / 設定大綱
先確認流量如何進入核心，再決定請求要比對哪條規則。以下設定片段用於說明欄位關係，節點資訊與監聽位址需依實際環境補上。
規則模式會由上而下檢查請求，命中後交由指定出口處理，不再比對後續規則。先放明確的網域規則，再安排地理位置比對，最後以 MATCH 接收其餘流量。若網站走錯出口，先查看連線記錄中的命中規則，再確認策略組目前選擇的項目。相較於全域模式，規則模式可讓不同服務走不同路徑；前提是請求已進入核心，而且網域資訊能正確辨識。
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY策略組為規則提供穩定的出口名稱。規則可固定指向 PROXY，組內節點則能隨時調整，不必每次更換節點都修改規則。select 適合手動選擇，url-test 會依測試結果選擇，fallback 則依序尋找可用出口。自動測試只反映特定測試位址的連線狀況，不代表所有服務的實際表現。使用訂閱提供的策略組時，先了解各組之間的引用關係，再確認最後選到哪個節點，避免把組名誤認為實際伺服器。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
- AUTO
- name: AUTO
type: url-test
use: [subscription]
url: https://www.gstatic.com/generate_204
interval: 300TUN 透過虛擬網路介面接收系統流量，適合不讀取系統代理設定的應用程式。啟用前先確認一般代理連線正常，再依用戶端提示安裝服務或授予權限。自動路由會影響系統網路路徑，若同時使用其他 VPN、虛擬機網路或安全軟體，需留意是否衝突。TUN 不等於全域代理：進入核心的流量仍由目前模式與規則決定出口。關閉時請確認虛擬介面與路由已恢復，尤其是切換網路或從休眠喚醒後。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53Fake-IP 會讓 DNS 回傳保留位址，再由核心將該位址對應回原始網域，讓後續連線仍能套用網域規則。這種方式適合搭配 TUN 使用，但不代表所有 DNS 查詢都會自動交由遠端伺服器處理。遇到區域網路探索、特殊驗證，或依賴真實解析結果的應用程式時，可依狀況新增 fake-ip-filter。調整前先記錄目前的 DNS 設定，每次只改一項，再清除相關快取進行驗證；避免同時更換上游伺服器與過濾規則，增加問題排查難度。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "*.local"
nameserver:
- https://dns.alidns.com/dns-query訂閱連結用於取得節點或完整設定，匯入方式則視用戶端支援的格式而定。取得連結後，先在設定頁面匯入並選取，再確認策略組與規則是否確實載入。完整 Clash YAML 與單純的節點清單並不相同，匯入成功也不代表已啟用。自動更新可能覆寫原訂閱檔案，需長期保留的規則與 DNS 調整，建議優先使用用戶端的覆寫功能。分享截圖或記錄前，請遮蔽訂閱網址，其中可能包含存取服務所需的憑證。
設定管理
→ 從 URL 匯入
→ 更新設定
→ 選取並啟用
→ 檢查策略組
→ 設定覆寫與更新間隔Clash 生態系包含不同的圖形介面與核心實作，介面名稱相似，不代表所有欄位都能通用。mihomo 延續 Clash 風格的設定結構，並支援自身提供的協定與網路功能。切換核心前，請查看目標用戶端的說明，確認協定、規則提供者與 TUN 設定是否受支援。遇到未知欄位或解析錯誤時，先縮小範圍檢查出錯的段落，不要直接刪除整段設定。這裡所說的相容是指設定調整的方向，並非每個用戶端都提供切換核心的選項。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090DOWNLOAD / 平台下載
先確認作業系統架構，再選擇安裝套件。圖形用戶端負責設定與連線管理，mihomo 核心負責處理請求；只有核心檔案不會自動提供設定清單、系統代理開關或訂閱管理介面。
桌面版可先從 Clash Plus、Clash Verge Rev 或 FlClash 中選擇，再依下載頁說明安裝。首次啟動後，先匯入現有訂閱並確認核心正常運作，再開啟系統代理。瀏覽器能連線不代表所有應用程式都已接入，命令列工具可能需要另外設定代理環境變數。
若要使用 TUN，請依用戶端提示設定服務與權限，不必一開始就啟用所有流量接管方式。遇到連接埠被占用時，先確認是否有其他代理程式仍在背景執行；修改監聽連接埠後，也要一併更新應用程式中的手動代理位址。離開用戶端前關閉系統代理，可減少設定殘留造成的連線問題。
前往下載下載前請在系統資訊確認晶片類型，並選擇對應 Apple Silicon 或 Intel 的安裝套件。安裝完成後，將應用程式移至「應用程式」資料夾，再依提示處理網路延伸功能或輔助服務權限。若已安裝其他網路工具，請先停用其代理接管功能，避免多個程式反覆改寫相同的系統設定。
Clash Plus、Clash Verge Rev 和 FlClash 的設定入口各有不同，但基本流程相同：匯入、選取設定、選擇策略組、啟用流量接管。切換無線網路或從睡眠狀態恢復後，若無法正常瀏覽網頁，先檢查目前網路服務的代理位址與 DNS，再查看核心記錄，不要只憑選單列圖示判斷連線狀態。
前往下載Android 可選擇 Clash Plus、Clash Meta for Android、FlClash 等用戶端。安裝時請確認處理器架構；若不確定，先閱讀下載頁的套件類型說明，不要反覆安裝不相容的檔案。匯入完成後，系統通常會要求授權建立 VPN 連線；確認授權後，才能透過這種方式接收應用程式流量。
行動作業系統可能會限制背景執行。若鎖定畫面後連線中斷，請檢查電池最佳化、自動啟動與背景網路設定。依應用程式分流與網域規則屬於不同層級：應用程式是否進入代理由接管設定決定，進入後的出口則由規則決定。同時啟用其他 VPN 或工作設定檔的網路功能時，也請留意是否衝突，並依用戶端支援情況安排使用方式。
前往下載iPhone 與 iPad 使用者可前往下載頁查看 Clash Plus 的 App Store 頁面。產品官方網站為 clashplus.io。安裝後匯入適用於該用戶端的訂閱或設定，再依系統提示新增 VPN 設定。完成授權只代表具備接管流量的條件，還需選取設定與策略組，最後實際測試連線。
行動網路與無線網路的連線條件可能不同。若只有其中一種網路可用，請分別檢查訂閱更新、節點連線與 DNS 解析。自動選擇策略依賴測試位址，無法保證每個網站都得到相同結果。排查時先固定使用一個明確的手動出口，確認問題範圍後再恢復自動策略，避免測試期間出口不斷變動。
前往下載圖形化桌面環境可選擇 Clash Verge Rev 或 FlClash，並依 Linux 發行版的套件格式安裝。桌面環境的系統代理並非所有程式都會讀取；終端機、容器與背景服務也可能使用各自的網路設定。先在一般使用者工作階段確認基本連線，再評估是否需要 TUN 或以服務方式執行，較容易區分權限與設定問題。
伺服器與路由器使用者可查看下載頁的核心區，依處理器與執行環境選擇 mihomo。自行執行核心時，需要管理設定檔路徑、服務啟動順序與記錄輸出。控制介面通常應限制為僅供本機存取；若需遠端管理，請先規劃驗證方式與存取範圍。容器內的迴圈位址屬於容器本身，不能直接當作主機位址使用。
前往下載SOURCE / 開源與維護
透過公開原始碼、設定文件與發布說明了解功能範圍。用戶端、核心與訂閱分別維護，選擇和排查時應分開檢視這三個部分。
Clash 最初以規則導向的代理核心與 YAML 設定方式建立生態系，之後出現不同分支與圖形用戶端。原始專案的維護狀態與後續專案並不相同，不能把舊用戶端的教學直接當成所有新用戶端的操作說明。mihomo 延續 Clash Meta 專案的技術路線，實際行為應以目前的專案文件及用戶端整合情況為準。閱讀舊文章時，優先核對欄位意義與適用核心，不要只比對介面截圖。
設定檔中的縮排、清單與引用關係都會影響解析。修改前先備份可用版本，每次只調整一個功能區塊；若發生解析錯誤，先查看記錄指出的欄位與上下文，再確認該欄位是否受目前使用的核心支援。檔案能載入，只代表通過相應的結構檢查，不表示節點可連線、規則比對正確，或系統流量已接管。這些狀況需要分別驗證。
圖形用戶端負責顯示設定、管理程序及整合系統功能；核心則負責解析規則、建立連線與處理 DNS。兩者可能分開更新，因此更換介面不一定會改變核心行為，更新核心也不一定會改變訂閱匯入入口。選擇用戶端時，除了平台與安裝方式，也應確認服務模式、覆寫機制、記錄入口與設定匯出方式，確保日後能排查問題並轉移設定。
不同專案的開放範圍與授權條款應分別確認，不能因為使用相同核心，就推斷整個應用程式採用相同授權。mihomo 儲存庫公開了原始碼與授權資訊，可用於查閱功能實作、問題討論與發布記錄。本網站整理下載入口與中文操作說明，協助使用者找到相關資料；各專案的發布、商店上架與訂閱服務仍由各自維護者負責。
用戶端更新會更新應用程式本身，核心更新會影響協定與網路行為，訂閱更新則會取得服務提供者提供的節點或設定。遇到節點失效，先確認訂閱是否過期、更新後的設定是否已啟用，不要立刻重裝用戶端。遇到未知協定或欄位，再確認核心支援範圍。更新前先閱讀變更說明，並保留目前可用的設定；更新後重新檢查監聽連接埠、流量接管開關與策略組選擇，避免預設值變更影響原有環境。
訂閱內容可能包含服務提供者預設的 DNS、規則與策略組，本機直接編輯的內容可能在下次更新時被覆蓋。需要長期保留的規則，應使用用戶端支援的覆寫或合併功能，並確認合併順序。不要將完整訂閱檔案上傳至公開討論區；回報問題時提供適度刪減的設定片段、系統環境與相關錯誤行，保留重現問題所需的資訊即可。
先確認核心正在監聽，再確認應用程式請求出現在連線清單，最後檢查命中規則與實際出口。這比連續切換多個節點更容易找出問題所在。延遲測試只會連線至指定位址，測試成功不能取代實際服務驗證；同樣地，網頁能開啟也不代表所有應用程式都走相同路徑。使用命令列工具時，請留意目前終端機是否設定代理環境變數，並確認測試工具與瀏覽器採用相同的流量接管方式。
除錯記錄可能包含瀏覽的網域、目標位址與本機路徑，分享前請先刪除與問題無關的內容。排查完成後，恢復適合日常使用的記錄等級，避免長期記錄過多請求。控制連接埠與混合代理連接埠用途不同：前者供管理介面使用，後者接收代理請求；請勿將管理位址填入瀏覽器的代理設定。預設連接埠只是常見設定，實際值仍以用戶端目前顯示的監聽資訊為準。
用戶端負責管理設定與處理連線，不會自動提供可用的代理伺服器。你可以匯入現有的服務訂閱，或使用自行維護的節點設定。匯入前先確認內容來源與格式。公開分享連結的可用性與存取權限可能隨時變動，不適合單獨用來判斷用戶端是否正常。請參閱節點與訂閱說明。
規則與全域模式決定進入核心的請求如何選擇出口；TUN 則決定系統流量透過什麼方式進入核心，兩者屬於不同層面。啟用 TUN 後仍可使用分流規則；使用全域模式也不代表所有應用程式都會自動接管。建議先用一種明確的接管方式完成驗證，再依需求擴充。詳細操作請參閱代理模式與規則教學。
先確認設定已選取，再檢查系統代理或 VPN 流量接管是否生效。若連線清單中沒有相關請求，優先檢查接管方式與連接埠；若已有請求，則檢查出口、規則與 DNS 錯誤。不要同時更換節點、解析伺服器與代理模式，否則很難確認是哪項設定生效。請依照疑難排解的檢查順序逐項確認。
優先使用用戶端提供的資料更新與網路設定入口，先確認目前生效的值，再決定是否修改設定。GeoIP 主要用於比對地理位置規則，無法解決所有網域解析問題；連接埠供本機程式與核心通訊，修改後也要同步更新手動代理設定。請分別參閱GeoIP 更新說明與連接埠設定說明。
NOTES / 使用筆記
從實際症狀著手，逐步排查。分開處理訂閱更新、DNS 對應與流量接管，避免把所有網路問題都歸咎於節點無法使用。
用戶端顯示已連線但無法瀏覽網頁時，依序檢查系統代理、連接埠占用、TUN 權限、DNS 設定、規則比對與節點狀態，快速找出問題所在。
閱讀排查清單 →依錯誤狀況整理訂閱更新失敗的常見原因，包括連結過期、網路無法直連、憑證問題與格式不相容，並說明各用戶端自動更新間隔的設定位置。
查看訂閱更新說明 →從 DNS 查詢流程談起，說明 Fake-IP 如何透過保留位址加快建立連線，並比較 redir-host，以及哪些網域應加入 fake-ip-filter 白名單。
了解 Fake-IP 對應原理 →