開源代理生態系 · 設定欄位參考

Clash問答網
用戶端下載與設定欄位

下載Clash 查看教學 mihomo 核心 · YAML 設定

依作業系統選擇用戶端,按欄位查閱YAML 設定,從 DNS 到規則掌握分流路徑。

config.yaml YAML · 以 2 個空格縮排
  1. mixed-port: 7890
  2. allow-lan: false
  3. # 依規則比對連線
  4. mode: rule
  5. log-level: info
  6. dns:
  7. enable: true
  8. enhanced-mode: fake-ip
  9. proxy-groups:
  10. - name: PROXY
  11. type: select
  12. proxies: [DIRECT]
  13. rules:
  14. - GEOIP,CN,DIRECT
  15. - MATCH,PROXY
UTF-8

此片段僅展示欄位階層,並非完整代理設定;PROXY 目前只有 DIRECT,實際使用時須匯入有效節點並加入策略組。

平台入口
5
核心
mihomo
設定
YAML
核心協定
GPL-3.0

Clash 用戶端平台下載入口

先確認作業系統與處理器架構,再選擇圖形化用戶端。Clash Plus 在 Windows、macOS、Android 與 iOS 的下載清單中優先推薦;Linux 可先考慮 Clash Verge Rev。用戶端負責管理設定與整合系統,真正解析欄位、建立連線的是核心。介面看起來相似,不代表支援的設定功能完全相同。

Windows

適合需要系統匣控制、系統代理與切換設定檔的桌面使用者。尋找 Clash for Windows 替代方案時,可優先比較 Clash Plus 與 Clash Verge Rev,並確認作業系統架構、服務權限及 TUN 支援。遷移前先保留原設定,匯入後測試,避免直接覆蓋現有工作環境。

前往下載

macOS

先在系統資訊中確認是 Apple Silicon 還是 Intel,再下載相應安裝檔。系統代理與網路延伸功能的授權方式可能不同,首次啟動時請依用戶端提示完成設定。既有設定可以遷移,但開機啟動、代理接管與本機路徑等選項,都需要在新用戶端重新確認。

前往下載

Android

行動裝置通常透過系統 VPN 介面接管流量。安裝前確認裝置架構,連線前完成系統授權;若鎖定螢幕後連線中斷,請檢查電池最佳化與背景執行限制。依應用程式分流屬於用戶端功能,與 YAML 中依網域或目標位址分流的規則並非同一層設定。

前往下載

iOS

從下載頁前往 Clash Plus 的 App Store 頁面,官方網站為 clashplus.io。匯入訂閱後,先確認用戶端是否辨識出節點與策略組,再允許新增 VPN 設定。部分桌面版可用的底層網路參數,在行動裝置上可能由系統接管,請以用戶端實際支援的功能為準。

前往下載

Linux

桌面使用者可比較 Clash Verge Rev 與 FlClash,並依 Linux 發行版選擇套件格式。伺服器與路由器使用者可參考 mihomo 核心入口,自行管理服務與設定路徑。啟用透明代理前,先了解路由、DNS 與權限之間的關係;遠端操作時,請保留可用來復原的管理連線。

前往下載

安裝檔只包含用戶端,不會自動附上可用的代理服務。訂閱網址通常含有存取憑證,請妥善保存在可信任的裝置中;分享設定或記錄檔前,先移除敏感參數。查看所有用戶端 →

設定欄位索引台

一條連線的流程可分為入口、模式、解析、節點、策略與規則六個部分。以下依序說明各層設定:先看重點,再對照 YAML 範例。範例都是局部片段,不能直接拼接成完整訂閱;手動選取欄位後,自動輪播會停止。

mixed-port: 7890allow-lan: false
bind-address: 127.0.0.1

port 決定哪些程式會使用代理嗎?

連接埠欄位設定的是本機監聽入口,不是遠端節點的連接埠。port 接收 HTTP 代理連線,socks-port 接收 SOCKS 代理連線,mixed-port 則可在同一個連接埠接收這兩類連線。上例只監聽本機,應用程式需將代理位址設為本機位址與對應連接埠。常見設定錯誤包括只啟動核心,卻未設定應用程式代理;或兩個用戶端占用相同連接埠。允許區域網路存取前,應一併檢查綁定位址、防火牆與驗證設定,不能只切換單一選項。

前往設定欄位頁查看 →

匯入訂閱並驗證連線

初次使用時,先完成最短的可行流程:設定能載入、策略有出口、應用程式能接入。不要同時修改連接埠、DNS、TUN 與規則;每次只調整一個層面,發生異常時才容易找出原因。以下是完整入門流程的三步預覽。

  1. 匯入設定

    開啟用戶端的設定或訂閱管理頁面,新增可信來源提供的訂閱連結,或匯入本機 YAML 檔案。更新完成後,確認設定已選取,且清單中有節點與策略組。若出現解析錯誤,先檢查錯誤行附近的縮排、冒號與清單結構;不要試圖靠反覆重新安裝用戶端來修正內容錯誤。遠端訂閱下載成功,也不代表每個節點都能連線。

  2. 選擇模式與出口

    先使用規則模式,找出規則引用的主要策略組,並選取一個有效節點。桌面版開啟系統代理後,確認連接埠與目前用戶端一致;行動裝置則依提示允許建立 VPN。若有應用程式不會讀取系統代理,TUN 可能是較合適的接管方式,但會涉及路由與權限,建議先確認一般代理連線正常再啟用,避免混淆接入失敗與節點故障。

  3. 確認實際連線

    開啟目標網站,並在用戶端的連線清單中查看應用程式、目標網域、命中規則與最終出口。網頁能開啟不代表分流方式符合預期,測速成功也不代表特定網站一定可用。若瀏覽器正常但終端機無法連線,請檢查終端機是否讀取代理環境變數;若全部逾時,先檢查本機網路與節點狀態。驗證完成後,請關閉暫時啟用的詳細記錄。

先保留一份已驗證可用的設定,再逐步加入應用程式分流或自動策略。遇到問題時,切回基準設定即可判斷原因來自新變更還是網路環境。查看完整教學 →

Clash 生態系與 mihomo 核心

判斷設定能否使用,應檢查核心與欄位支援情況,而不只是看用戶端名稱。本網站整理下載入口與中文欄位說明,不代表任何用戶端的開發團隊。開源程式碼、專案文件與實際執行記錄,是確認功能行為的重要依據。

專案沿革與相容性範圍

Clash 生態系經歷了原專案停止維護、社群分支持續發展的過程。原用戶端儲存的 YAML、策略選擇與本機設定,未必能原樣遷移至新用戶端。mihomo 延續並擴充了相關設定功能,但舊版核心通常無法辨識新加入的協定或欄位。查閱範例時,請先確認文件適用的核心,再判斷是否符合目前的使用環境。

下載清單中的 Clash for Windows 與 ClashX Meta 已標示為停止維護的封存項目。新裝置建議優先考慮仍在維護的方案;若舊環境確實有相依需求,請先評估系統相容性與所需協定,不要只因介面熟悉就做選擇。查看用戶端挑選建議 →

用戶端、核心與服務提供者

用戶端負責匯入設定、系統匣選單、更新訂閱與系統代理等操作;核心負責讀取設定、解析網域、比對規則與建立對外連線;服務提供者則維護遠端伺服器及訂閱內容。這三個部分可能分別發生問題。介面顯示已連線,只能代表某個本機狀態成立,不能證明遠端服務可用,也不代表所有應用程式都已接管。

同一個節點在不同用戶端的表現不一,應比較核心、協定參數與 DNS 接管方式。同一用戶端在不同網路下結果不同,則還要考慮網路業者、路由與伺服器端限制。將問題分層檢查,比直接更換所有設定更容易找出可重複驗證的原因。

開源授權與查閱依據

mihomo 採用 GPL-3.0 開源授權,原始碼、提交紀錄與問題討論都可在專案儲存庫查閱。核心的授權不代表所有圖形化用戶端都採用相同授權;散布或修改前,應查閱各專案的說明。程式碼開源讓使用者能檢視實作,但不能取代對安裝來源、操作權限與網路行為的判斷。

查找欄位行為時,先閱讀對應文件,再搭配記錄檔驗證。回報問題時,請說明作業系統、用戶端名稱、核心資訊、最小設定與重現步驟;不要公開完整訂閱網址、驗證資訊或可辨識個人的連線記錄。精簡的重現資料有助於區分設定問題與程式缺陷。

更新機制與設定保留

更新用戶端、更新核心、更新訂閱與更新規則資源是四種不同操作。更新用戶端時可能一併更換核心;更新訂閱可能替換節點與策略組;更新規則資源則只會影響對應的比對集合。操作前請確認此次更新會修改哪個層面,並保留可供還原的設定與自訂內容。

長期維護時,請分開管理遠端訂閱與本機覆寫,並記錄規則用途。策略組名稱變更後,應檢查自訂規則是否仍引用有效目標。DNS 模式變更後,可依需要清除相關快取再測試,避免舊映射影響判斷。設定成功載入後,仍須透過實際連線確認更新效果。

查閱 mihomo 原始碼

已安裝 Git 的使用者可複製以下指令,在本機取得公開儲存庫以供閱讀。複製原始碼不等於安裝或啟動用戶端;一般使用者直接從下載頁挑選圖形化用戶端即可。

git clone https://github.com/MetaCubeX/mihomo.git

設定與故障排除文章

欄位參考適合逐項查閱,文章則會針對單一問題說明判斷流程。以下依發布日期列出最近三篇,涵蓋系統代理接入、記錄檔判讀與多份設定管理等不同使用情境。

查看所有文章 →