用戶端下載 · 設定參考

Clash工具箱全平台用戶端與設定教學

依作業系統選擇用戶端，查看訂閱匯入、規則分流與TUN 模式設定方式。

開源核心
中文文件
YAML 設定

5 個平台
mihomo · GPL-3.0
YAML 單檔設定

+ : # = - + : # = - + : # = - +
: DOMAIN-SUFFIX : + = # : - + :
# = - + : # = - + : # = - + : #
+ : DIRECT = + : # = - + : # =
- # + : = - # + : = - # + : =
MATCH : + = # : - + : DIRECT
: + = - # : + = - # : + = - #
# REJECT + : = - # + : = - #
+ : # = - + : # = - + : # = -
: DOMAIN-SUFFIX : + = # : - +
# = - + : # = - + : # = - + :
+ : DIRECT = + : # = - + : # =
- # + : = - # + : = - # + : =
MATCH : + = # : - + : DIRECT
: + = - # : + = - # : + = - #

+ : # = - + : # = - + : # = - +
: + = # : MATCH : - + : # = - :
# = - + : # = - + : # = - + : #
+ : DIRECT = + : # = - + : # =
- # + : = - # + : = - # + : =
DOMAIN-SUFFIX : + = # : - + :
: + = - # : + = - # : + = - #
# REJECT + : = - # + : = - #
+ : # = - + : # = - + : # = -
: + = # : MATCH : - + : # = - :
# = - + : # = - + : # = - + :
+ : DIRECT = + : # = - + : # =
- # + : = - # + : = - # + : =
DOMAIN-SUFFIX : + = # : - + :
: + = - # : + = - # : + = - #

Clash · 設定 CONFIGURATION

Clash

代理

設定檔

規則

連線

記錄

設定

設定GENERAL

系統代理

應用程式遵循系統代理設定

已啟用

TUN 模式

虛擬網卡接管流量

已啟用

允許區域網路連線

Allow LAN

連線模式

規則全域直連

混合連接埠

7890 TCP

外部控制

127.0.0.1:9090

config.yamlREAD ONLY

1mixed-port: 7890

2allow-lan: false

3mode: rule

4external-controller:

5 127.0.0.1:9090

6tun:

7 enable: true

8rules:

9 - DOMAIN-SUFFIX,example.com,DIRECT

10 - GEOIP,CN,DIRECT

11 - MATCH,DIRECT

設定參考 / Configuration

規則、流量接管與設定管理

用戶端介面負責操作，核心負責處理連線。先確認流量是否進入用戶端，再判斷套用哪條規則。分開檢查這兩個層面，比反覆切換模式更容易找出問題。

初次使用時，設定檔是起點。安裝用戶端不代表已能透過代理連線，通常還需要另外準備訂閱網址。匯入後先確認設定檔已選取、策略群組存在，再依應用程式需求啟用系統代理或 TUN。以下設定片段用於說明欄位之間的關係，不包含代理伺服器，也不能取代可用的訂閱。

rules · 由上而下比對

依目的地選擇連線出口

規則模式會依設定檔中的順序比對連線，由第一條符合的規則決定連線出口。網域後綴、目的位址與兜底規則各有用途，應將具體規則排在範圍較廣的規則之前。在用戶端的「代理」或「設定」中選擇規則模式，再到「連線」查看比對結果。相較於全域模式，規則模式可讓直連與代理並行，不必讓每個要求都經過同一個出口。範例全採直連，僅供參考語法；替換策略名稱前，請確認設定檔中已有對應的策略群組。

適用：支援 Clash 規則語法的桌面與行動裝置用戶端。

# 具體網域規則在前，兜底規則在後
mode: rule

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - GEOIP,CN,DIRECT
  - MATCH,DIRECT

# DIRECT：直連
# REJECT：拒絕連線
# 使用 GEOIP 前，須備妥對應的地理資料

tun · 虛擬網卡

接管不遵循系統代理的流量

TUN 模式透過虛擬網卡與路由設定接管流量，適用於不讀取系統代理設定的應用程式。桌面版通常需要安裝服務或授予管理員權限，再到「設定」啟用 TUN；行動裝置則通常透過系統 VPN 授權接管流量。TUN 與規則模式並非二選一：前者決定流量如何進入核心，後者決定流量進入後如何選擇出口。若已使用其他 VPN、虛擬網卡或企業網路政策，請先記錄原有設定。發生異常時先檢查路由與 DNS，不要只看開關是否已開啟。

適用：支援 TUN 且具備相應權限的用戶端；欄位設定請以實際使用的核心為準。

# mihomo TUN 設定片段
tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53

# DNS 劫持還需要搭配核心 DNS 設定
# 啟用前檢查其他 VPN 與虛擬網卡
# 用戶端可能會透過介面覆寫這些欄位

profiles · 訂閱與提供者

區分完整設定檔與代理提供者

完整的訂閱設定檔可以同時包含代理、策略群組與規則；代理提供者則只會向現有設定檔提供代理項目。初次匯入通常是在「設定檔」中新增遠端訂閱，儲存後選取該設定檔，再確認更新是否成功。定期更新會重新取得遠端內容，直接修改下載的檔案可能在下次更新時被覆蓋；若要長期調整，請使用用戶端的覆寫或合併功能。右側採用本機提供者語法，方便理解檔案之間的關係；檔案路徑是相對於核心工作目錄，而非任意系統目錄。

適用：遠端設定檔管理方式依用戶端而異；提供者片段適用於 mihomo。

# 本機檔案必須包含 proxies 清單
proxy-providers:
  local:
    type: file
    path: ./providers/local.yaml

proxy-groups:
  - name: 手動選擇
    type: select
    use:
      - local

# 請勿在公開截圖或記錄中揭露訂閱網址

core · 設定相容性

依欄位支援情況選擇核心

Clash、Clash Premium 與 mihomo 在設定功能與維護狀態上各有差異，介面名稱相似不代表支援相同欄位。mihomo 延續 Clash Meta 的設定體系，許多現行用戶端會以它處理連線。只有部分用戶端提供核心切換功能，其他用戶端則固定內建核心，因此不能套用相同的操作步驟。遇到未知欄位或不支援的協定時，先查看記錄並確認用戶端使用的核心，再參照設定文件處理。單獨替換執行檔可能造成與用戶端介面不相容，建議優先使用產品提供的更新方式。

適用：核心選擇與設定遷移；並非每個用戶端都能切換核心。

名稱	參考重點
Clash	原始設定體系與基礎規則語法
Clash Premium	舊設定中的專屬擴充欄位
mihomo	Clash Meta 的後續專案，請依現行文件確認欄位支援情況

platform · 權限與系統設定

設定檔可遷移，權限須重新設定

同一份相容的設定檔可以在多個平台重複使用，但監聽連接埠、檔案路徑與系統權限仍須分別檢查。桌面系統通常先確認系統代理，再視需要啟用 TUN；行動系統則先完成 VPN 授權。遷移時不要直接複製舊裝置的絕對路徑，也不要假設所有用戶端都能讀取相同格式的訂閱。先確認目標產品支援的格式，再匯入、選取設定檔並檢查策略群組。首次成功連線後，再設定開機啟動、背景執行等選項，才能將設定問題與系統限制分開排查。

適用：在五大平台之間遷移設定檔；詳細安裝步驟請參閱全平台指南。

平台	系統檢查位置
Windows	設定 → 網路和網際網路 → Proxy
macOS	系統設定 → 網路 → 目前使用的網路 → 詳細資料 → 代理伺服器
Android	系統設定中的 VPN 與電池管理
iOS	設定 → 一般 → VPN 與裝置管理
Linux	桌面代理設定、服務權限與終端機環境變數

下載入口 / Platforms

依作業系統選擇 Clash 用戶端

先確認作業系統與處理器架構，再比較介面、設定支援與權限需求。下載中心集中列出安裝檔與系統需求；本頁的平台入口則會直接開啟對應分類。

Windows

可從 Clash Plus、Clash Verge Rev、FlClash 等桌面用戶端中選擇。新安裝建議優先考慮仍在維護的產品；Clash for Windows 僅供查閱歷史資料。既有設定檔可以遷移，但舊用戶端的擴充指令碼、服務設定與絕對路徑不應直接照搬。

安裝後先匯入設定檔並啟用系統代理。若瀏覽器可以連線、終端機卻不行，先檢查終端機的環境變數，不必立刻重新安裝用戶端。需要 TUN 的應用程式，再另外檢查服務權限與虛擬網卡。

前往下載 →

macOS

Apple Silicon 與 Intel 機型須選擇對應的安裝檔，可在「關於這台 Mac」查看晶片資訊。Clash Plus、Clash Verge Rev 與 FlClash 提供桌面操作介面；ClashX Meta 已停止維護，遷移前請保留原設定檔副本。

首次啟動時，請留意系統安全提示與網路權限。系統代理通常套用於目前的網路服務，切換有線或無線網路後應再次確認；TUN 則需要用戶端提供相應服務或權限，並非只要修改瀏覽器設定即可。

前往下載 →

Android

可比較 Clash Plus、Clash Meta for Android、FlClash 與 Surfboard。不同產品支援的設定格式不盡相同，尤其不能將支援訂閱視為相容所有 Clash 欄位。安裝檔架構應與裝置相符；若不確定，請先查看下載頁的選擇說明。

首次連線時須確認已授予系統 VPN 權限。若鎖定螢幕後連線中斷，請檢查電池最佳化與背景執行限制；若同時使用其他 VPN，先確認系統目前啟用的是哪項服務，再判斷設定是否有問題。

前往下載 →

iOS

透過 App Store 取得 Clash Plus，產品說明請參閱 clashplus.io。匯入前請確認用戶端支援的設定格式；連結匯入與本機檔案匯入的位置依產品介面而異，不能只憑副檔名判斷內容是否相容。

儲存設定檔後，授予 VPN 權限，再選擇連線出口並連線。請留意 Wi-Fi 與行動網路的存取權限可能不同；診斷時先確認已選取設定檔，再查看連線狀態，避免將單一網站的問題誤判為整個用戶端故障。

前往下載 →

Linux

桌面環境可選擇 Clash Verge Rev 或 FlClash；伺服器、路由器等情境則可考慮直接執行 mihomo 核心。請先確認 Linux 發行版的套件格式與處理器架構，不要把桌面安裝檔當成所有裝置都能執行的通用檔案。

終端機程式通常不會自動使用桌面系統代理，須依程式支援情況設定代理環境變數，或使用已設定好權限的 TUN。遠端維護時，先保留可復原的連線方式，再修改預設路由與 DNS，避免設定變更中斷管理連線。

前往下載 →

查看所有用戶端 →查看全平台安裝指南 →

開源參考 / Source

用戶端介面與開源核心

Clash 是一個生態系名稱，並非所有平台共用的單一安裝檔。查閱文件時，應一併確認用戶端名稱、使用的核心與設定來源，避免將特定產品的操作說明誤當成通用指南。

5 個平台平台入口

涵蓋桌面與行動作業系統。安裝方式、系統權限與背景執行規則各不相同，連線狀況須在對應裝置上確認。

GPL-3.0mihomo 授權條款

mihomo 專案公開原始碼與授權條款。此授權說明適用於核心專案，不代表每個用戶端或商店產品都採用相同授權方式。

YAML單檔設定

代理、策略群組與規則可集中在一份主設定檔中管理，也可以引用外部規則集與提供者。縮排格式與欄位支援同樣重要。

專案沿革與設定沿用

早期 Clash 用戶端建立了以 YAML 描述代理與分流規則的使用方式。原有專案的維護狀態改變後，社群用戶端與後續核心持續演進，舊教學中的按鈕名稱、下載入口與擴充欄位便可能不再符合目前環境。遷移時可以沿用設定檔的基本架構，但須重新確認核心支援情況，尤其是 DNS、TUN 與外部資源路徑。歷史設定檔能夠匯入，只代表解析成功，不表示所有行為都與原環境一致。

介面操作與實際生效的設定

用戶端通常負責下載設定檔、選擇策略、管理系統匣選單與系統服務；核心則負責監聽連接埠、比對規則與建立連線。有些介面開關會在啟動前產生設定，或在執行期間透過控制介面修改選項，因此編輯訂閱檔案後，介面顯示值可能暫時與實際值不同。排查時優先查看目前選取的設定檔、執行記錄與連線詳細資訊，再確認是否啟用了覆寫。不要同時修改訂閱檔案、介面連接埠與系統代理三處設定，否則很難判斷是哪一項變更影響結果。

更新機制與設定檔備份

用戶端更新、核心更新、訂閱更新與規則資源更新是四種不同操作。更新用戶端不會自動修復過期的訂閱，重新下載訂閱也不會讓舊核心支援新欄位。維護前先備份本機覆寫與自訂規則，閱讀產品更新說明，再一次只更新一個部分。更新後使用相同應用程式與目標重新測試並記錄差異；若需要還原，設定檔備份比憑記憶恢復選項可靠。訂閱網址可能包含存取憑證，請勿貼到公開討論區或截圖中。

原始碼與問題回報

開源儲存庫適合查閱欄位定義、授權條款與已知問題，不能取代各用戶端的安裝檔下載入口。mihomo 儲存庫記錄核心層級的變更；介面按鈕失效、安裝服務失敗等問題，應先確認對應的用戶端。回報問題時請提供作業系統、架構、重現步驟與已隱去敏感資訊的記錄，並刪除訂閱網址、代理驗證資訊與外部控制密鑰。若只有特定應用程式無法連線，請說明系統代理或 TUN 的流量接管方式，而不只是寫連線失敗。

mihomo · 原始碼前往儲存庫 ↗

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

此指令用於取得核心原始碼，執行前須先安裝 Git。

首次連線檢查順序

先確認目前設定檔可以正常載入，再確認目標應用程式的流量已進入用戶端，最後檢查規則與連線出口。系統代理已開啟卻看不到連線記錄時，先確認應用程式是否會使用系統代理；看得到記錄但無法連線時，再檢查比對到的規則、網域解析與所選出口。延遲測試結果只反映特定測試目標與方法，不能單憑此結果證明網頁、終端機及其他應用程式都能正常連線。分層收集資訊，才不會混淆權限、設定與網路問題。

需要完整操作步驟時，請從訂閱匯入與首次連線教學開始；遇到設定解析或連線問題，請參閱常見問題與疑難排解。安裝、系統權限與平台專屬設定集中於全平台指南，方便依裝置逐項確認。

操作紀錄 / Articles