開源專案 · 全平台客戶端持續更新

Clash入門指南 下載與設定

從裝置平台與使用方式出發,集中說明 客戶端選擇訂閱匯入系統代理設定。先完成可用的基礎連線,再按需要處理 TUN、DNS 與規則細節。

永久免費 程式碼開源 中文文件 規則分流
CONFIGURATION WORKSPACE

從設定檔到系統接管

Clash 客戶端的圖形介面主要負責管理設定、切換執行模式和控制系統網路入口。核心依設定檔處理連線,客戶端則把常用操作整理成可見設定。以下依實際設定順序拆解幾個容易混淆的部分。

設定檔 Profiles
目前檔案 config.yaml
自動更新
覆寫設定
設為使用中設定 已啟用

設定檔匯入與更新

設定檔通常包含代理服務提供者、策略組、分流規則、連接埠和 DNS 參數。首次使用時,應先確認訂閱連結來源,再透過客戶端的設定或訂閱頁面匯入。匯入成功只代表檔案可以讀取,還需要將該檔案設為使用中設定。更新訂閱時,客戶端會重新取得遠端內容;本機手動修改可能被覆蓋,因此長期使用的自訂規則更適合放入覆寫或合併設定。遇到訂閱更新失敗時,應依序檢查連結是否完整、網路是否可存取、系統時間是否準確,以及遠端服務是否回傳有效的 YAML 內容。

建議設定順序

先匯入並啟用設定檔,再於策略組中選定常用出口,接著開啟系統代理驗證瀏覽器連線。只有應用程式不遵循系統代理時,才繼續設定 TUN。DNS 調整應放在基礎連線穩定之後,如此發生問題時可以明確區分是訂閱內容、代理入口、路由還是解析鏈路造成。

規則模式與全域模式

規則模式依設定檔逐條決定直連、代理或拒絕,適合日常使用。全域模式會將大多數連線交給目前的全域策略,適合短時間排查規則是否遺漏比對。直連模式則繞過代理。切換模式不會修復失效的訂閱,也不會自動解決系統代理未開啟的問題,判斷時應分開檢查設定狀態和入口狀態。

PLATFORM DOWNLOADS

依作業系統選擇客戶端

不同平台的安裝格式、系統權限和代理入口並不相同。下載頁依平台列出仍可使用的圖形客戶端、停止維護的封存客戶端和面向伺服器的核心檔案。首頁只提供平台入口,不直接發佈安裝套件。

Windows

適合需要圖形介面、系統代理開關和 TUN 接管的桌面使用者。安裝前先確認系統架構,並避免同時執行多個會修改代理或虛擬網卡的客戶端。若 UWP 應用程式不經過本機代理,還需要另外檢查迴圈配置限制。

前往下載

macOS

下載時需要區分 Apple Silicon 與 Intel 處理器。首次執行可能涉及應用程式安全性確認、網路延伸功能或管理員授權。系統代理適合瀏覽器和一般桌面軟體,命令列工具或獨立網路應用程式則可能需要環境變數或 TUN 模式。

前往下載

Android

Android 客戶端通常透過系統 VPN 介面接管連線。匯入訂閱後,需要在系統彈出視窗中允許建立 VPN 連線。背景執行限制和省電策略可能導致客戶端暫停,長期使用時應依裝置系統設定允許必要的背景活動。

前往下載

iOS

iPhone 與 iPad 透過系統網路延伸功能建立代理連線。下載入口會指向可用的商店客戶端,並說明訂閱匯入位置。首次連線需要確認系統 VPN 權限;切換設定後,應回到客戶端檢查策略組是否仍符合目前用途。

前往下載

Linux

桌面環境可以使用圖形客戶端,伺服器、路由器和旁路由更常直接執行 Mihomo 核心。部署前要區分處理器架構、套件格式和服務管理方式。透明代理還涉及 TUN 或 TProxy、轉送規則、DNS 與開機自動啟動,不宜直接照搬桌面設定。

前往下載

圖形客戶端與核心的差異

圖形客戶端提供設定匯入、策略切換、日誌檢視和系統開關,適合個人裝置。核心負責讀取設定並處理連線,適合熟悉命令列、服務管理和網路路由的使用者。兩者並非相同的安裝形式,首次使用通常從圖形客戶端開始,更容易定位問題。

查看所有客戶端 →
OPEN SOURCE CONTEXT

開源生態與設定邊界

Clash 不是單一平台上的固定安裝套件,而是一套由核心、圖形客戶端、規則專案和設定工具共同組成的生態。理解這些邊界,有助於判斷更新來自哪裡,也能避免將客戶端介面問題和核心設定問題混為一談。

專案歷史

早期 Clash 核心建立了以 YAML 設定、規則比對和策略組選擇為基礎的使用方式,之後出現了 Windows、macOS、Android 等平台的圖形客戶端。部分早期專案已停止維護,但它們留下的設定結構和操作習慣仍廣泛存在。目前使用時不應只根據舊教學中的客戶端名稱判斷是否可用,而應同時查看專案維護狀態、目標系統支援和所使用的核心分支。

核心與客戶端

Mihomo 延續並擴充了 Clash Meta 相關能力,負責解析設定、建立監聽連接埠、處理規則、執行策略組和 DNS 邏輯。圖形客戶端在其外層提供操作介面,不同客戶端可能採用不同的更新方式、設定覆寫結構和系統整合方案。因此,同一份訂閱在不同客戶端中的入口名稱可能不同,但排查主線仍然一致:確認設定有效、確認核心正在執行、確認系統流量進入監聽入口、確認規則符合預期策略。

規則與訂閱生態

訂閱通常由服務提供者產生,規則集合則可能來自獨立維護的開源專案。客戶端只是讀取和執行這些內容,不負責修復遠端訂閱中的格式錯誤。匯入前應確認連結來源和用途,不要將包含個人存取資訊的訂閱網址公開在日誌、截圖或程式碼儲存庫中。需要長期維護自訂規則時,應將個人覆寫與遠端訂閱分開保存,避免每次更新訂閱後重複修改。

更新機制

客戶端更新、核心更新和訂閱更新是三條獨立鏈路。客戶端更新會改變介面和平台整合;核心更新可能增加設定能力或修復網路處理問題;訂閱更新則會改變代理服務提供者、策略組和規則內容。排查更新後出現的異常時,應先確認具體變化發生在哪一層,再查看對應日誌和設定差異。穩定使用期間不必同時修改所有層級,分步更新更容易回復和定位。

A

設定可供審閱

YAML 檔案可以明確寫出監聽連接埠、DNS、策略組和規則順序。修改前保留可正常運作的副本,每次只調整一類參數,發生錯誤時更容易判斷是哪一段設定造成。

B

日誌可協助定位

連線失敗不等同於節點問題。日誌可以協助區分設定解析失敗、DNS 解析異常、規則比對結果、連接埠衝突和系統入口未接管。排查應從具體錯誤訊息開始。

C

元件可替換

訂閱、規則集合、核心和圖形客戶端彼此有清楚的邊界。某個圖形客戶端停止維護時,可以遷移到相容客戶端;遷移前應匯出個人覆寫,並重新檢查平台權限與系統代理設定。

TECHNICAL NOTES

近期設定與故障排查筆記

技術筆記圍繞首次使用、DNS、連接埠衝突和平台特有問題展開。文章提供操作位置、指令用途和判斷順序,適合在基礎教學之外,依具體現象查閱。

入門指南

Clash 新手第一週最常問的十個問題:從訂閱匯入到系統代理一次說清楚

集中回答客戶端如何選擇、訂閱連結如何匯入、規則與全域模式有何差異、系統代理為什麼沒有生效,以及切換策略後應從哪裡驗證。每個問題都對應到客戶端中的實際設定位置。

閱讀全文 →
故障排查

Clash DNS 洩漏怎麼查:檢測方法與 fake-ip、nameserver 防洩漏設定實作

從瀏覽器檢測和命令列查詢開始,確認 DNS 是否繞過客戶端,再逐項說明 enhanced-mode、nameserver 與 fallback 的關係。修改過程強調一次只調整一個參數,避免解析鏈路和代理鏈路同時變化。

閱讀全文 →
故障排查

Clash 連接埠 7890 被佔用怎麼辦:定位衝突程序與修改 mixed-port 的完整步驟

說明如何在 Windows、macOS 與 Linux 中定位監聽連接埠的程序,判斷是殘留客戶端還是其他網路工具,並同步修改客戶端監聽連接埠與系統代理設定,避免只修改一處後仍然無法連線。

閱讀全文 →