開源核心 · 持續整理設定文件

Clash 用戶端下載與設定檔指南

依系統選擇相容的用戶端,透過 YAML 範例了解 mihomo 的連接埠、DNS 與分流規則。

程式碼開源 中文文件

01 Downloads

依平台下載 Clash 用戶端

先確認作業系統,再選擇安裝套件架構。桌面版還要區分圖形介面用戶端與獨立核心;初次使用從圖形介面用戶端開始即可。

Windows

請在系統的裝置規格中確認處理器架構。常見的 Intel 與 AMD 電腦使用 x64 套件;搭載 ARM 處理器的裝置,則須確認用戶端是否提供相應版本。安裝後先匯入設定,再啟用系統代理。測試正常但只有部分應用程式未走代理時,請檢查該應用程式是否沿用系統設定,先別急著更換訂閱。

前往下載

macOS

在「關於這台 Mac」查看晶片或處理器,再選擇對應的 Apple Silicon 或 Intel 套件。選單列狀態只能表示用戶端是否正在執行,無法確認每個應用程式的連線都已接管。切換設定後,請從連線記錄確認目前的請求;完成測試準備離開時,也要確認系統代理設定已還原。

前往下載

Android

依裝置支援的應用程式架構選擇安裝套件,不要只憑處理器是否為 64 位元判斷。初次啟動通常需要確認系統的 VPN 連線要求。切到背景後若連線中斷,先查看用戶端執行狀態與系統電池管理;若裝置已設定工作資料或其他 VPN,也要確認目前由哪個應用程式管理連線。

前往下載

iOS

從下載頁前往 App Store 查看相容用戶端與系統需求。匯入設定後,依系統提示允許新增 VPN 設定,再回到用戶端確認目前選取的設定。桌面版儲存的 YAML 可作為移轉起點,但本機檔案路徑、代理模式名稱與進階欄位不一定能直接沿用。

前往下載

Linux

桌面用戶端請依發行版支援的套件格式與處理器架構選擇。安裝前先確認系統套件管理工具使用的格式,不要把相同架構的不同格式當成可互換。終端機命令與桌面應用程式的代理設定可能各自獨立;若請求只從終端機送出,請優先檢查該程式實際讀取的代理設定。

前往下載

02 Config Reference

Clash 設定欄位與 YAML 範例

先分清輸入、輸出與比對條件。點選欄位查看對照範例;這些片段用來說明單一層級的設定,不是包含訂閱與節點的完整檔案。

混合代理連接埠

混合連接埠可同時接收本機應用程式傳來的 HTTP 與 SOCKS 代理連線。這是應用程式連接核心的連接埠,不是遠端節點使用的連接埠。若只在目前裝置使用,可先關閉區域網路存取,再確認應用程式填寫的位址與連接埠。遇到連接埠已被占用時,先找出占用的程序,再同步修改核心與應用程式的設定。若只改其中一處,請求可能根本沒有進入核心,連線記錄也就看不到規則命中。

DNS 解析模式

先確認請求是否進入核心的 DNS 模組,再判斷解析模式是否合適。fake-ip 可先回傳映射位址,讓核心在後續連線中識別網域;這不代表系統的所有 DNS 查詢都會自動交由核心處理。排查時請區分瀏覽器的安全 DNS、系統解析與核心解析。只有特定網域與映射位址不相容時,再檢查該網域的過濾項目,避免為單一服務更動整套解析設定。

config.yaml
mixed-port: 7890
allow-lan: false
dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16

閱讀設定的順序:先找 mixed-port、mode 等頂層欄位,再查看 proxies 定義了哪些輸出方式,最後檢查 proxy-groups 與 rules 如何引用這些名稱。策略群組名稱也是引用關係的一部分。更改名稱時,群組內的巢狀引用與規則末尾的目標都要一併修改,否則即使 YAML 能解析,核心仍可能拒絕載入。

修改的位置:訂閱來源、本機覆寫與用戶端產生的最終設定並非同一個檔案。更新後修改內容消失,應先確認編輯的是哪一層。需要長期保留的局部修改,請放在用戶端支援的覆寫層,並確認清單採用追加還是取代。特別是 rules:取代整個區段可能刪除原有例外,追加在 MATCH 之後則可能永遠不會命中。完整語法請見設定欄位參考。

03 Quick Start

Clash 設定匯入與連線驗證

初次使用只需完成三件事:匯入並選取設定、開啟流量入口、送出一次請求驗證。先確認基本流程正常,再調整 DNS 或規則。

  1. 01

    匯入並啟用設定

    開啟用戶端的設定頁,依現有資料選擇訂閱連結或本機 YAML。更新成功後選取這份設定,再前往代理頁確認策略群組可以展開。只看到檔名,代表設定項目已儲存;能看到群組與成員,才更能確認設定已載入。若匯入失敗,先查看錯誤所在行、欄位名稱或下載提示,不必反覆新增相同訂閱。

    config.yaml · 匯入設定

  2. 02

    選擇模式並接入流量

    若要依網域或位址分流,先選擇規則模式,再於策略群組確認目前的輸出方式。桌面版依用戶端說明啟用系統代理;行動裝置則依提示建立 VPN 連線。不要同時更改接入方式與策略群組,否則結果改變時難以判斷是哪一層造成。若已有其他代理正在執行,請先確認這次要使用哪個入口。

    mode: rule · 系統代理

  3. 03

    確認一筆實際連線

    用常用應用程式重新開啟一個頁面,並在連線記錄中尋找相應網域、命中規則與輸出方式。沒有記錄時,檢查應用程式是否使用目前的入口;有記錄但請求失敗,則查看 DNS、策略與節點狀態。頁面快取與既有連線可能影響判斷,可以重新送出請求。確認測試成功後,再逐一還原自訂設定。

    請求目標 → 命中規則 → 實際輸出

常見問題快速查找

為什麼代理頁有節點,連線清單卻沒有請求?
節點已載入不代表流量已接入;先確認系統代理或 VPN 狀態,再檢查送出請求的應用程式是否使用該入口。
為什麼切換策略後,正在載入的頁面沒有變化?
應用程式可能沿用已建立的連線;請重新送出請求並查看新連線,不要以舊記錄判斷切換是否生效。
為什麼只改一條規則,卻影響多個網站?
後綴比對會涵蓋所屬子網域,較早命中也會略過後續規則;請到規則語法對照檢查比對範圍與順序。

更多安裝與連線問題,請見 Clash 常見問題。

04 Project Sources

mihomo 開源核心與設定來源

原始碼、用戶端與訂閱分別由不同專案或服務提供。遇到問題時先確認所屬項目,再查看相應的文件、發布說明或問題紀錄。

專案沿革:Clash、Clash.Meta 與 mihomo

Clash 生態系的設定檔沿用一些共同概念,例如宣告節點、組成策略群組,以及依規則選擇輸出方式。mihomo 延續 Clash.Meta 的開發脈絡,並在此架構上加入新功能。舊教學中的通用寫法仍可作為閱讀起點,但遇到特定協定、DNS 欄位或規則類型時,應以目前執行的核心為準。即使介面名稱相同,也不能因此認定不同用戶端對同一欄位的解讀一致。移轉舊檔案時,可先測試最精簡的設定,再逐段恢復進階選項。

開源生態系:依問題查找上游專案

mihomo 的原始碼儲存庫公開,採用 GPL-3.0 授權。討論欄位意義與實作行為時,可先查閱該儲存庫的相關程式碼、變更紀錄與已知問題。若問題涉及系統匣入口、訂閱更新按鈕或裝置權限,通常應查詢對應用戶端,而非前往核心儲存庫尋找介面實作。授權與原始碼紀錄說明的是各專案自身的發布與授權,不代表訂閱服務的說明,也不能據此推定其他用戶端或規則資料的授權。

核心關係:區分匯入與執行

用戶端負責下載並整理設定,核心讀取最終設定後處理實際連線。訂閱下載失敗發生在取得階段,欄位不受支援發生在載入階段,而規則命中卻無法連線則屬於執行階段。排查時先判斷問題停在哪個階段,再決定查看訂閱回應、載入錯誤或連線記錄。分享重現步驟時,可保留欄位結構與錯誤類型,並以文件位址取代真實節點位址;如此既能說明問題,也不必公開可用來存取訂閱的連結。

更新方式:分別確認安裝套件、訂閱與規則資料

升級用戶端可能改變介面與隨附核心;重新整理訂閱通常只會重新取得設定;更新地理資料庫或規則集則是另一種流程。排查變更時,記下最近執行的是哪一種更新,並保留更新前可用的本機設定。若問題只在更新訂閱後出現,請比較最終規則順序或節點欄位;若地區比對結果改變,則確認目前的資料來源、更新時間與載入狀態。盡量一次只變更一種類型,再用同一個應用程式重試相同目標。

05 Field Notes

Clash 使用指南

設定參考可依欄位查閱,使用指南則依任務查找。以下文章分別介紹跨裝置同步、行動裝置匯入與用戶端介面。

Clash 下載