Clash 生態系 · 繁體中文設定文件

Clash知識庫用戶端下載與設定參考

下載Clash 查看教學

依平台挑選用戶端，從 mihomo 核心、YAML 欄位到規則分流逐項查閱。

原始碼開放設定範例繁體中文文件

設定欄位與運作方式

先確認欄位所屬類別，再對照設定片段。範例僅展示結構，不能取代完整訂閱內容。

Clash知識庫config.yaml / general

CORE / mihomo

核心負責連線與路由

mihomo 是 Clash 生態系中的代理核心，負責讀取設定、接收連線、比對規則並建立對外連線。用戶端則提供訂閱管理、系統匣選單與系統整合，兩者屬於不同層級。原版 Clash、Clash Meta 與 mihomo 有演進關係，但舊版核心不一定能辨識新增欄位。排查設定問題時，應先確認用戶端實際使用的核心，再查核欄位支援狀況。範例中的混合連接埠可接收 HTTP 與 SOCKS 要求；若只在本機使用，請保持區域網路存取關閉。

查閱通用欄位 → 
# 頂層通用欄位
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: false

閱讀設定時，可依「入口 → 模式 → 規則 → 策略 → 對外連線」的順序逐步確認。連接埠與 TUN 決定連線如何進入核心；mode 決定採用哪種處理方式；rules 則決定流量交由哪項策略處理。將不同層次分開檢查，比一次修改多個開關更容易找出原因。

依作業系統挑選用戶端

先確認平台與處理器架構，再比較介面、接管方式和維護狀況。

Windows

可從 Clash Plus、Clash Verge Rev、FlClash 等用戶端中挑選。一般瀏覽可先啟用系統代理；若遊戲或命令列程式沒有使用系統代理，再評估是否採用 TUN 接管。安裝前請在系統資訊中確認處理器類型，更新後也要確認服務模式仍可正常使用。

前往下載

macOS

Apple Silicon 與 Intel 裝置需要使用對應的安裝檔，可在「關於這台 Mac」查看晶片資訊。首次執行時依系統提示授權，接著確認選單列狀態與網路代理設定。更換用戶端前，請先結束舊程式，避免兩個 App 同時修改系統代理。

前往下載

Android

可比較 Clash Plus、Clash Meta for Android、FlClash 與 Surfboard，並留意設定格式和核心功能的差異。首次啟動連線時，請允許 VPN 要求；若鎖定螢幕後連線中斷，請檢查電池最佳化、背景活動與自動啟動權限，不必反覆重新安裝訂閱。

前往下載

iOS

下載頁提供 Clash Plus 的 App Store 連結，並列出官方網站 clashplus.io。安裝後匯入相容的設定，並依系統提示新增 VPN 設定。行動作業系統對背景網路延伸功能另有管理方式，桌面版的服務安裝步驟不適用於手機。

前往下載

Linux

桌面環境可選擇 Clash Verge Rev 或 FlClash，並依發行版挑選套件格式。伺服器與路由器使用者可參閱 mihomo 核心相關資訊，自行管理服務啟動、設定目錄與權限。桌面代理設定不一定會套用到終端機中的每個程序。

前往下載

安裝檔、訂閱與用戶端的差異

安裝檔提供執行程式，訂閱提供代理設定，兩者不能互相取代。安裝完成後，還需要匯入來自可信來源且與用戶端相容的設定。知識庫提供軟體下載入口與欄位說明，不提供代理服務；下載用戶端不會自動產生可用出口。訂閱連結通常與帳戶權限相關，分享截圖或記錄前，請遮蔽完整網址。

Clash for Windows 已停止維護，可用來辨認舊教學或移轉現有設定，但不建議只因名稱熟悉，就選作新裝置的預設用戶端。移轉時請保留訂閱網址與自訂規則，再檢查新用戶端產生的設定。是否支援某項協定，取決於實際使用的核心與用戶端整合，而非應用程式名稱是否包含 Clash。

查看所有用戶端 →

Clash 使用教學：三步驟快速上手

先完成一條可驗證的連線，再逐步加入分流、覆寫或 TUN 設定。

01 / PROFILE

匯入訂閱或本機設定

在用戶端的設定管理頁面新增訂閱網址，或匯入本機 YAML 檔案。等待下載與解析完成後，將該設定設為目前使用的項目。若出現解析錯誤，先查看錯誤行號，區分網路要求失敗與 YAML 結構錯誤；兩者的處理方式不同。

訂閱內容可能包含節點、策略群組與規則，也可能只有節點清單。匯入成功不代表設定結構一定完整。請先確認介面中有可供選擇的策略，再啟用連線；不要將 Base64 文字直接當成完整 YAML 儲存。

02 / MODE

選擇模式與流量入口

日常使用建議從規則模式開始，在對應的策略群組中選擇可用出口，再啟用系統代理或行動裝置的 VPN 連線。全域模式會將進入核心的流量交由全域策略處理，直連模式則用於直接連線；兩者都不是速度設定。

系統代理與 TUN 是流量入口設定，規則與全域則是處理模式。若瀏覽器正常連線，但其他程式無法連線，先確認該程式是否遵循系統代理，再判斷是否需要 TUN。每次只修改一個條件，並記錄變更前的狀態。

03 / VERIFY

檢查連線與命中規則

開啟一個明確需要代理的目標，再返回連線頁面檢查目標網域、命中規則、策略群組與實際出口。只看到 VPN 圖示或系統匣圖示變色，無法證明每個程式都依預期路徑連線；請以該筆連線記錄為準。

若沒有連線記錄，優先檢查流量入口；若命中錯誤策略，檢查規則順序；若策略正確但連線失敗，再檢查出口與 DNS。完成驗證後請儲存可用設定，之後更新出問題時便能逐項比對，不必一次重設所有選項。

初步排查要點

瀏覽器可以連線但終端機不行，通常應先檢查終端機程式的代理設定；訂閱可以更新但網頁無法開啟，則應接著檢查出口選擇與目標連線。用戶端下載訂閱、核心建立對外連線與瀏覽器瀏覽，可能採用不同的網路路徑，不能因其中一項成功就推斷所有功能都正常。

變更 DNS 後仍看到舊結果，可先中斷相關連線並重試，必要時依平台清除快取。若同時啟用其他 VPN、加速器或虛擬網卡工具，請先逐一結束，以縮小問題範圍。操作前保留目前設定，測試完成後再決定是否長期採用變更。

查看完整教學 →

開源核心與設定來源

釐清用戶端、核心與服務提供者的差異，才能判斷說明適用於哪個環節。

Clash、Meta 與 mihomo

Clash 生態系涵蓋核心、圖形化用戶端、設定工具與規則專案。原版 Clash 為規則代理提供基礎設定結構，Clash Meta 在此基礎上擴充功能，後續以 mihomo 名稱持續發展。舊教學中的 Meta 與目前文件中的 mihomo 往往有所關聯，但不能因此認定所有欄位、協定與預設行為完全相同。

查閱教學時，先確認內容描述的是哪個核心，再確認用戶端是否允許直接設定對應欄位。圖形介面可能會代為產生連接埠、DNS 或 TUN 設定，也可能在啟動前合併本機覆寫。排查時應盡量查看最終執行設定，而不只是訂閱來源檔案；兩者之間的差異往往就是行為改變的原因。

公開原始碼與授權範圍

mihomo 原始碼公開，核心採用 GPL-3.0 授權條款。公開儲存庫可用來檢視實作、閱讀變更與追查問題；授權條款則規範程式碼的使用與散布條件。圖形化用戶端是獨立專案，可能採用不同授權；核心的授權資訊不能直接視為所有用戶端的授權聲明，也不能據此判斷訂閱服務是否可用。

開源儲存庫中的問題紀錄可用來查核已知行為，但單一討論串不代表所有裝置都會遇到相同問題。回報問題時，請附上作業系統、用戶端名稱、核心資訊、重現步驟與已去識別化的記錄。請勿公開完整訂閱網址、帳戶憑證或包含私人網路資訊的設定檔。

更新用戶端與更新訂閱是兩回事

用戶端更新可能改變核心功能、介面入口與系統整合；訂閱更新通常只會變更遠端設定內容。更新後若出現異常，先確認變動發生在哪一層。保留更新前可用的設定，查看用戶端版本資訊，再比對產生後的規則與 DNS 設定。不要只憑檔名判斷核心是否已同步更新。

本知識庫的設定片段用於說明欄位與語法，不包含可直接連線的代理出口。複製範例前請先閱讀註解，確認策略名稱已定義，且目前平台支援對應功能。YAML 以空格表示層級，清單項目前的連字號、逗號與字串引號都有實際用途；直接拼接多個片段可能造成鍵值重複或缺少相依設定。

文件查閱順序

初次使用可先閱讀使用指南，完成匯入與驗證；需要挑選用戶端時，查看選型指南；已知欄位名稱時，前往設定參考。核心原理與使用情境分析收錄於專題文章。依目前遇到的問題挑選資料，比一次啟用所有功能更容易判斷設定是否生效。

近期設定文章

說明代理模式、流量接管與行動裝置系統權限背後的運作原理。

查看所有文章 →
下載 Clash