Windows
建議先從 Clash Plus 等持續維護的圖形化用戶端開始。安裝後匯入訂閱、啟用系統代理，再確認瀏覽器能否連線。若要接管遊戲或商店應用程式，再了解 TUN 與回送連線限制。
從 Clash for Windows 遷移時，請先備份訂閱、自訂規則與覆寫設定。新用戶端的設定目錄與服務模式可能不同，不宜直接覆蓋整個舊目錄。系統代理連接埠也應以新用戶端實際顯示的數值為準。
前往下載Clash 設定區塊
從設定項目了解連線路徑。選擇主題，查看用途、啟用方式及 YAML 範例。範例僅說明局部結構，需合併至現有設定；代理群組名稱必須與規則目標一致。
依序比對，依策略連線
規則模式會依 rules 順序由上而下檢查連線，符合條件後套用對應策略，不再繼續比對。網域後綴適合涵蓋同一服務的子網域；IP 規則適用於已知位址範圍；MATCH 則處理其餘連線。先放入需要個別處理的規則，再加入區域規則與最終策略。mihomo 延續常見的 Clash 規則寫法，同時擴充規則功能；從舊設定遷移時，請確認使用的規則類型與資料檔仍受支援。以下範例中的 PROXY 是代理群組名稱，必須先在設定中定義，不能只複製規則就直接啟動。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY透過代理群組集中管理出口
代理群組將規則目標與實際出口分開，切換出口時不必逐條修改規則。select 可供手動選擇，url-test 會依測試結果選擇出口，fallback 則依序尋找可用項目。先決定要手動控制或自動切換，再設定群組類型與候選清單。mihomo 相容常見的舊版代理群組結構，但舊核心未必能辨識新增欄位；遷移時請以實際使用的核心文件為準。以下範例先用 DIRECT 建立可解析的最小群組；匯入訂閱後，再透過 proxies 或 use 接入實際出口，規則中的 PROXY 才能用來選擇代理。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT保留網域對應，檢查 DNS 解析路徑
fake-ip 會為網域配置虛擬位址，讓核心在後續連線中保留網域資訊，以便比對網域規則。啟用 dns 後，也要確認應用程式的 DNS 請求確實送入核心；只修改 enhanced-mode 並不會自動接管所有系統 DNS 解析。相較於舊核心，mihomo 提供更多 DNS 策略選項，遷移時不宜整段沿用來源不明的組合設定。若區域網路服務或特定應用程式無法正常運作，可針對網域設定 fake-ip-filter，並檢查快取。以下範例僅呈現基本結構，上游解析器應依所在網路的實際連線狀況選擇。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- '*.lan'
nameserver:
- https://dns.alidns.com/dns-query接管未使用系統代理的連線
TUN 透過虛擬網路介面處理流量，適合不讀取系統代理設定的程式。桌面版通常需要管理員權限或用戶端服務模式；手機則透過系統 VPN 介面承載流量。啟用前先確認一般代理可以連線，再逐步開啟自動路由與 DNS 劫持，避免將出口故障誤判為路由問題。不同核心、用戶端與作業系統的 TUN 實作可能各異，設定檔中有 tun 不代表目前的程式一定能載入。若啟動後無法正常存取區域網路，應檢查路由、網卡與其他 VPN 是否衝突，而非一再重裝用戶端。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53分開更新訂閱出口與規則集合
完整設定、訂閱、proxy-providers 與 rule-providers 並非同一類內容。完整訂閱可能涵蓋代理、群組與規則；代理集合只提供出口；規則集合則只提供比對條件。分開管理後，就能保留本機策略，只更新需要變更的資料。mihomo 支援多種規則集合格式，但舊核心不一定能辨識所有格式與欄位；遷移前請確認 behavior 和 format。以下範例使用本機 classical 規則檔，並透過 RULE-SET 引用；檔案須事先存在，且包含 payload 清單。遠端訂閱網址可能含有存取權限資訊，分享記錄或設定前請先移除。
rule-providers:
local-direct:
type: file
behavior: classical
format: yaml
path: ./rules/local-direct.yaml
rules:
- RULE-SET,local-direct,DIRECT
- MATCH,PROXY透過本機介面檢視連線與策略
外部控制介面供面板讀取連線、切換策略及調整執行狀態，並非瀏覽器使用的代理連接埠。啟用 external-controller 後，面板須填入相應位址；external-ui 則指向已放入設定目錄的面板資料夾。mihomo 保留常見控制介面的使用方式，但面板是否支援新功能，仍取決於面板本身。建議先綁定回送位址，僅允許本機存取；若確實需要遠端管理，再設定驗證機制與網路存取限制。部分圖形化用戶端會自行管理控制位址與驗證參數，建議優先使用用戶端設定，避免手動設定與執行時覆寫互相衝突。
external-controller: 127.0.0.1:9090
external-ui: ./ui
log-level: info依作業系統選擇用戶端
圖形化用戶端負責訂閱管理、系統代理與日常操作；核心則負責協定、解析與規則執行。先選擇適合裝置的用戶端，再確認處理器架構、系統需求與設定支援範圍。
macOS
先確認處理器是 Apple Silicon 還是 Intel，再選擇對應安裝檔。Clash Plus、Clash Verge Rev 等用戶端可管理訂閱與規則；安裝後的網路權限請依系統提示操作。
系統代理與 TUN 的授權方式不同。若瀏覽器能上網、終端機卻無法連線，請先確認命令列程式是否讀取代理環境變數；只有明確需要透明接管流量時才啟用 TUN，以免與既有 VPN 同時修改預設路由。
前往下載Android
可選擇 Clash Plus、Clash Meta for Android 等用戶端。匯入設定後允許建立 VPN 連線，再確認應用程式能否存取網路。安裝檔架構須符合裝置需求；不確定時，請先查看裝置的處理器資訊。
背景中斷連線不一定是訂閱失效所致。先檢查系統的電池最佳化、背景執行與自動啟動權限，再觀察切換無線網路後是否恢復。每次只調整一項設定，較容易判斷問題是系統停止背景程序，還是連線路徑改變。
前往下載iOS
下載頁提供 Clash Plus 的 App Store 連結，並列出官方網站 clashplus.io。安裝後依用戶端支援的格式匯入訂閱，允許新增 VPN 設定，再到系統設定確認連線狀態。
同一份訂閱在不同用戶端上的欄位支援可能不同。匯入失敗時，先確認連結回傳的是完整設定還是代理集合，再查看具體錯誤訊息。不要將桌面版的監聽位址、檔案路徑與 TUN 參數原樣套用到手機。
前往下載Linux
桌面環境可選 Clash Verge Rev 或 FlClash；伺服器與路由器使用者可查看 mihomo 核心套件。安裝前請確認發行版的套件格式與 CPU 架構，再設定資料目錄和執行權限。
以命令列執行時，先在前景模式檢查記錄，確認設定能成功載入後，再交由服務管理器啟動。一般使用者監聽連接埠、建立 TUN 裝置與修改路由所需的權限各不相同；排除問題時，請分別檢查設定錯誤與權限不足。
前往下載mihomo 核心與開源生態
分開了解核心、用戶端與設定來源。專案原始碼說明實作方式，發行說明記錄變更，用戶端介面則決定實際操作流程。
Clash Meta 與 mihomo 的關係
Clash Meta 是這個核心專案早期使用的名稱，目前專案以 mihomo 為名持續開發。搜尋教學時，仍可能看到舊名稱、舊儲存庫路徑，以及不同用戶端的畫面截圖。判斷設定是否適用，應確認實際執行的核心及其文件，而非只看用戶端名稱是否包含 Meta。圖形介面與核心的更新時間也不一定相同。
用戶端不等於訂閱服務
mihomo 負責執行代理協定、DNS 解析與分流規則；圖形化用戶端則在其上提供設定管理、系統整合與操作介面。訂閱來自使用者自行選擇的服務或自建設定。安裝用戶端不會自動產生可用出口，原始碼開放也不代表訂閱內容公開。本網站提供下載索引與中文使用資料；各專案的開發、發布及問題處理由各自的維護者負責。
透過原始碼與發行說明確認變更
可在 MetaCubeX/mihomo 儲存庫查閱核心原始碼，授權條款以儲存庫中的 LICENSE 檔案為準。提交紀錄、議題討論與發行說明有助於確認某個欄位是否受支援，或某項行為是否有所變更。複製下方指令即可取得原始碼供閱讀；一般使用者安裝圖形化用戶端不需要這個步驟，它也不能取代匯入訂閱與網路設定。
更新前記錄設定，更新後驗證連線路徑
更新用戶端或核心前，請備份目前設定與本機覆寫內容，並閱讀變更說明。更新後先確認設定載入成功，再分別檢查 DNS、規則比對與出口連線。遇到問題時，記下作業系統、用戶端名稱、核心資訊與最小重現步驟；分享記錄前，請移除訂閱網址、驗證資訊與私人網域。提供清楚的重現資料，比貼上整份設定截圖更方便定位問題。
原始碼公開
MetaCubeX / mihomo
查看核心實作、設定變更與社群討論。桌面及行動用戶端的功能支援情況仍須分別確認。
開啟核心原始碼儲存庫 ↗git clone https://github.com/MetaCubeX/mihomo.git依問題繼續閱讀
初次使用時，依序匯入訂閱、選擇規則模式、啟用代理並確認連線，不必一次開啟所有網路功能。瀏覽器能正常使用後，再處理終端機、商店應用程式或區域網路裝置的需求。
訂閱、模式與連接埠入門 →無法上網時，先分辨是取得訂閱失敗、設定載入失敗，還是出口連線失敗。這三種問題涉及不同連線環節；系統化排查應從記錄中的第一則有效錯誤開始。
依症狀進行故障排除 →規則與全域模式、系統代理與 TUN、HTTP 連接埠與控制連接埠容易混淆。修改前先確認設定項目負責哪個環節，避免以擴大流量接管範圍來掩蓋原有問題。
查看疑難排解 →設定與排查紀錄
從常見使用情境開始：新手設定、舊用戶端遷移，以及 Windows 應用程式的回送連線限制。文章依操作流程說明設定，並交代適用條件。
Windows 商店應用程式無法透過代理連線：使用 CheckNetIsolation 解除 UWP 回送連線限制
說明 UWP 應用程式預設禁止存取本機回送位址的原因，示範圖形化豁免工具與 CheckNetIsolation 指令兩種解除方式，並比較 TUN 模式這項替代方案。
閱讀排查步驟 →原用戶端停止更新後：選擇 mihomo 核心用戶端與遷移設定的步驟
整理停止更新的用戶端現況與風險，依平台列出可替代的 mihomo 核心用戶端，並逐步說明如何完整遷移訂閱、自訂規則與覆寫指令碼。
閱讀遷移步驟 →Clash Meta 新手常見十問：一次看懂訂閱匯入、代理模式、連接埠與核心
集中解答初次使用時最常遇到的十個問題：訂閱從哪裡取得、如何選擇規則或全域模式、7890 連接埠的用途，以及 mihomo 與舊核心的關係等，並附上各項設定的位置。
閱讀新手十問 →