Windows
建議先從 Clash Plus 開始，也可比較 Clash Verge Rev、FlClash 等用戶端。先在系統的「關於」頁面確認裝置架構，再依下載頁說明選擇安裝檔。舊版 Clash for Windows 已停止維護，保留設定以便遷移，比長期依賴封存版本更合適。
系統代理適合瀏覽器等常用應用程式。啟用 TUN 前，先確認服務元件已安裝；若同時執行其他網路接管工具，請先關閉其中一種，再檢查路由與連線紀錄。
前往下載 Windows 用戶端- 核心 mihomo
- 核心授權 GPL-3.0
- 平台 5 個
- 設定格式 YAML
CONFIG.YAML / 設定註解
Clash 常用設定項目。
先了解設定要解決什麼問題，再決定是否啟用。以下片段用來說明欄位，並非可直接連線的完整設定；節點、策略群組與解析器仍須依訂閱內容和網路環境補齊。
mixed-port: 7890allow-lan: falsemode: rulelog-level: info以規則模式作為日常起點
規則模式會依設定中的比對條件，決定流量直連或經由代理，適合同時存取本地資源與遠端服務。在用戶端的模式選單中選擇「規則」，並確認使用的訂閱包含規則與策略群組。全域模式會將已接管的流量交由全域策略處理，適合暫時用來比對排除問題，但不能取代系統代理或 TUN 開關。如果某個網站走錯線路，先查看連線紀錄中的命中規則，再調整規則；頻繁切換模式只會掩蓋真正原因。不同用戶端的按鈕名稱可能不同，但核心的分流邏輯相同。
tun: enable: true stack: mixed auto-route: true auto-detect-interface: true接管不遵循系統代理的應用程式
TUN 透過虛擬網卡與路由接管流量，適合遊戲、命令列工具等不使用系統代理的程式。桌面用戶端通常需要安裝服務或授予管理員權限；行動裝置則須核准系統 VPN 連線要求。建議先透過系統代理確認訂閱可用，再單獨測試 TUN，避免把權限問題誤認為節點故障。TUN 不是提升速度的開關，也無法保證接管所有流量；其他 VPN、虛擬機網卡和自訂路由都可能影響結果。啟用後若無法存取區域網路裝置，應檢查路由排除項目，而非直接刪除所有規則。
dns: enable: true enhanced-mode: fake-ip fake-ip-range: 198.18.0.1/16讓網域名稱與連線保持關聯
fake-ip 會為網域名稱配置虛擬位址，讓核心在連線階段保留網域資訊並執行分流。這項設定必須配合實際的 DNS 接管方式，不能只修改這一行，就認定所有 DNS 查詢都會進入用戶端。可先確認用戶端是否啟用 DNS，再檢查 TUN 的 DNS 劫持、瀏覽器安全 DNS 和系統私人 DNS。少數區域網路服務或依賴真實位址的應用程式可能需要加入過濾清單。看到虛擬位址不代表解析出錯；遇到相容性問題時，應針對網域加入例外，修改後清除快取再測試。
proxy-providers: service: type: http url: "https://example.com/proxies.yaml" path: ./providers/service.yaml interval: 86400將節點來源與本機規則分開
代理集合可以定期取得節點清單，讓本機規則不必隨節點更新而反覆改寫。範例網址僅用來說明格式；實際使用時，請填入服務提供者支援的代理集合網址，並在策略群組中透過 use 引用。此處的更新間隔以秒為單位，通常不需要設定得太短。用戶端的「更新訂閱設定」與核心更新代理集合並非同一件事；完整設定訂閱也不一定能直接當作集合使用。遇到更新失敗，先檢查回應內容、網址有效期限與下載路徑權限，再調整網路存取方式，避免反覆重新安裝用戶端。
rules: - DOMAIN-SUFFIX,example.com,DIRECT - GEOIP,CN,DIRECT - MATCH,DIRECT由上而下比對，符合即採用
規則會依序檢查，較具體的網域條件應放在較廣泛的條件之前，最後再加入預設規則。範例以直連目標示範語法；若要使用代理，請換成設定中已有的策略群組名稱，並確認名稱與大小寫完全一致。更新訂閱可能覆蓋直接寫入的規則，若需長期修改，建議使用用戶端的覆寫或合併設定。排查時請查看連線紀錄中的網域、命中規則與最終出口，不能只憑網頁是否開啟來判斷分流正不正常。規則集下載失敗與節點無法使用也是不同問題，應分別確認。
CLIENTS / 依裝置選擇
Clash 全平台下載入口。
先選擇作業系統，再確認處理器架構與用戶端需求。桌面端與行動裝置可使用同一服務提供者的訂閱，但介面操作、支援欄位和系統流量接管方式不一定相同，不建議直接複製整套裝置設定。
macOS
下載前請透過「關於這台 Mac」確認是 Apple Silicon 還是 Intel。Clash Plus、Clash Verge Rev 和 FlClash 各有不同的操作方式；已有舊設定的使用者，應優先檢查覆寫規則、代理連接埠和登入後啟動設定，而不只是看選單列外觀。
首次執行時，請依系統提示處理應用程式權限。系統代理與網路延伸功能的授權是不同步驟，安裝完成不代表流量已經接管。操作方式請參閱完整文件中的平台章節。
前往下載 macOS 用戶端Android
可依使用習慣選擇 Clash Plus、Clash Meta for Android、FlClash 等用戶端。安裝檔架構必須與裝置相符；較新的裝置通常使用 ARM64，但仍應以系統資訊為準。匯入後先確認已選取設定，再核准系統 VPN 連線要求。
若切換至背景後連線中斷，請檢查系統的電池管理與背景執行限制。不要為了維持連線而直接開啟所有常駐功能；頻繁測速和過短的更新間隔也會增加耗電。
前往下載 Android 用戶端iOS
Clash Plus 可透過 App Store 安裝，官方網站為 clashplus.io。在 App 內匯入訂閱、選取設定，並允許新增 VPN 設定。桌面端設定中與系統服務相關的欄位，不應直接照搬到手機。
連線由系統網路延伸功能管理，背景運作方式與桌面端不同。連線異常時，先確認設定是否有效，再查看 App 記錄；是否使用隨選連線，應依實際的網路切換習慣決定。
前往下載 iOS 用戶端Linux
桌面使用者可優先比較 Clash Verge Rev 與 FlClash，依 Linux 發行版選擇合適的套件格式。伺服器和路由器使用者則較適合參閱 mihomo 核心說明，另外設定啟動服務、檔案目錄與執行權限，不必安裝圖形介面。
桌面環境的系統代理不一定會套用到終端機程式。先確認應用程式使用環境變數、明確指定代理參數，還是 TUN，再查看請求是否進入核心；遠端操作時尤其要保留原有的管理連線。
前往下載 Linux 用戶端查看所有用戶端 → 系統需求、架構選項與封存版本說明請見下載頁。
QUICK START / 三步驟預覽
匯入訂閱並首次連線。
用戶端只是處理設定與網路請求的工具，不會自動提供節點。開始前請準備服務提供者提供的有效訂閱網址，並確認裝置時間正確、目前網路可以連線至訂閱網址。訂閱網址可能含有存取憑證，請勿貼到公開討論區或放進截圖。
-
匯入訂閱，確認設定生效
在用戶端找到「設定」、「訂閱」或「Profiles」，選擇從網址匯入，貼上完整網址後執行更新。匯入成功後，還要選取這份設定並確認策略群組已顯示。若只看到訂閱名稱卻沒有節點，先查看更新記錄，判斷是網址失效、回應格式錯誤還是網路連線失敗，不要立刻啟用全域模式並反覆嘗試。
如果服務提供者提供多種格式，請選擇與目前核心相容的 Clash 或 mihomo 設定。手動編輯前先備份原始檔，尤其要注意 YAML 縮排與冒號後的空格；節點密碼等敏感欄位不應提供給他人排查。查看訂閱匯入步驟 →
-
選擇規則模式，啟用一種接管方式
初次使用時先選擇規則模式，在策略群組中選取可用節點，再啟用系統代理。行動裝置請依系統提示允許 VPN 連線。若有應用程式確實不使用系統代理，再測試 TUN，並確認已授予所需權限。現有的 VPN、網路加速器或其他代理工具可能互相爭用路由；排查期間先讓一種接管方式正常運作，減少變數。
全域模式描述的是流量進入用戶端後如何選擇出口，不代表整台裝置的所有請求都會自動進入代理。規則模式下的直連也不表示用戶端失效；應根據存取目標與命中紀錄判斷。查看模式選擇說明 →
-
驗證請求，儲存可用設定
開啟需要測試的網站，同時查看用戶端連線紀錄，確認有新請求進入、命中預期規則並採用正確策略。接著測試本地網站、區域網路裝置和常用應用程式，確認分流沒有影響正常存取。延遲測試只反映單次測量結果，不能代表實際下載頻寬，也無法證明所有網站都能存取。
若只有瀏覽器能用、終端機卻無法連線，先檢查終端機的代理參數；若所有應用程式都無法連線，則依序檢查訂閱、節點和流量接管開關。確認運作穩定後，再啟用開機啟動和自動更新，並記下調整過的項目，方便下次排查。
OPEN SOURCE / 專案與維護
Clash 生態系與 mihomo 核心。
選擇用戶端時，應將圖形介面、代理核心和訂閱服務分開來看。三者分別負責操作入口、流量處理與節點來源；任何一個環節出問題，都不該簡單歸因為「Clash 不能用」。
專案歷史與延續脈絡
Clash 最初因規則分流和 YAML 設定而廣泛使用，之後發展出多種桌面與行動裝置用戶端。原始專案及部分舊用戶端停止維護後，生態系並非只剩下單一路線。Clash.Meta 延續相關功能的開發，後來改用 mihomo 這個名稱；閱讀較早期的教學時，可能會看到這些名稱並存。
名稱相近不代表設定完全通用。較新的通訊協定、規則語法或 DNS 參數，可能只有特定核心支援；遷移時應逐一確認欄位，而不是只把副檔名改成 YAML。原有設定可以匯入，也不代表所有選項都已正確辨識。
核心與圖形用戶端的分工
mihomo 負責解析設定、建立連線和執行規則；圖形用戶端則負責管理訂閱、選擇節點、切換系統代理及顯示記錄。用戶端也可能加入自己的覆寫、合併設定或設定範本，因此介面顯示的選項不一定與最後交給核心的檔案一一對應。
排查時應優先檢查正在執行的設定與實際記錄。介面中關閉的設定可能在訂閱中啟用，本機修改也可能被更新覆蓋，造成「已經改過卻沒有作用」的情況。遷移到其他用戶端時，請分別保存訂閱網址和自訂規則。
開源授權與參考資料
mihomo 採用 GPL-3.0 授權，原始碼、提交紀錄與問題討論可在專案儲存庫中查閱。開源代表可以檢視實作方式與授權條款，不代表第三方服務的節點品質，也不能取代在實際網路環境中的測試。本網站整理設定說明與下載入口，並非核心專案或所有用戶端的官方營運方。
遇到疑似軟體缺陷時，先以盡可能精簡的設定重現問題，並記錄系統、用戶端、核心資訊和錯誤訊息。提交問題前，請移除訂閱網址、節點憑證和個人網路資訊；比起直接上傳整份設定，這樣更適合公開協作。
區分軟體更新與設定更新
用戶端更新、核心更新、訂閱重新整理和規則資料更新，處理的是不同問題。介面更新不代表核心也同步更新，重新整理訂閱也不會自動修復系統權限。升級前請保留目前可正常運作的設定，並閱讀專案的變更說明；若有不相容的調整，先確認設定，再切換日常使用環境。
GeoIP 或規則集下載失敗時，請檢查資源路徑、存取條件和記錄中的具體錯誤；若只有某個節點速度慢，先換節點比較。逐層排查通常比同時升級、重新安裝和修改 DNS 更容易保留有效線索。相關概念可在術語表中逐項查閱。
查看 mihomo 原始碼
儲存庫：MetaCubeX/mihomo。以下指令會下載原始碼，不會安裝圖形用戶端；若只需日常使用，直接到下載頁選擇用戶端即可。
git clone https://github.com/MetaCubeX/mihomo.gitFIELD NOTES / 設定筆記
近期教學與故障排除。
完成基本連線後，再依實際問題閱讀相關專題。遷移用戶端時先保留現有設定，調整 DNS 前先確認請求路徑，選擇核心時先確認功能需求；每次只修改一個條件，才能判斷是哪個步驟造成變化。
故障排除
Clash DNS 洩漏檢測與 fake-ip 防洩漏設定實作
教你透過檢測頁確認 DNS 是否洩漏，並逐步設定 fake-ip、nameserver-policy 與 TUN 劫持，防止 DNS 查詢外洩。
遷移替代
Clash for Windows 停止維護後怎麼辦：設定遷移步驟與替代用戶端選擇
舊用戶端停止維護後的遷移方式：匯出訂閱與自訂規則，依平台挑選仍持續更新的替代用戶端，順利完成轉換。
核心選型
Clash 原版核心、Clash.Meta 與 mihomo 的差異：功能與設定相容性整理
整理三代核心的演進脈絡，比較通訊協定支援、規則語法與 DNS 功能差異，說明舊設定遷移至 mihomo 時需要修改哪些欄位。
訂閱更新出錯時，可先查看Clash 訂閱更新失敗；測試結果波動較大時，可參考Clash 節點延遲的說明。平台安裝與設定的常見問題整理在完整文件的常見問題章節，不必從頭閱讀所有設定。