開源用戶端 · 依平台整理安裝檔

Clash安裝包下載多平台用戶端與設定指南

下載Clash 查看教學

從平台安裝檔開始，逐步完成訂閱匯入與規則分流設定。

平台與架構 中文操作說明 開源核心資訊
Clash · 設定
執行設定介面示意
系統代理
TUN 模式
允許區域網路連線
開機時啟動
混合連接埠7890
外部控制127.0.0.1:9090
模式規則全域直連
config.yaml
mixed-port: 7890
mode: rule

rules:
  - GEOSITE,cn,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

依作業系統選擇安裝檔

先確認裝置的作業系統，再核對處理器架構。安裝檔用來安裝用戶端，訂閱設定則提供代理與規則，兩者需分別準備。

Windows 安裝檔

適用於桌上型電腦與筆記型電腦。前往「設定 → 系統 → 系統資訊」查看系統類型，確認是 x64 還是 ARM 裝置，再選擇相符的用戶端。下載頁會先列出 Clash Plus，再列出其他圖形介面用戶端與封存專案。

安裝完成後，先開啟用戶端的設定檔清單，不要只開啟系統代理。若尚未選取設定檔或核心尚未啟動，系統代理可能會指向尚未監聽的本機連接埠。初次測試建議只執行一個代理用戶端，避免連接埠與系統設定互相覆寫。

前往下載

macOS 安裝檔

先在 Apple 選單的「關於這台 Mac」查看晶片資訊。Apple Silicon 與 Intel 機型須分別選擇相符的架構。開啟磁碟映像檔後，依用戶端說明將 App 移至「應用程式」資料夾，再從該資料夾啟動。

系統代理、背景執行與網路延伸功能可能需要個別授權。若出現系統安全性提示，請確認 App 來源與提示內容，不要直接關閉整套系統防護。更換用戶端前，先結束舊用戶端並還原原有代理設定，避免仍在背景執行的選單列 App 持續接管連線。

前往下載

Android 安裝檔

下載 APK 時，請配合裝置支援的處理器架構；若不確定，先確認用戶端是否提供通用版。請將安裝權限授予實際用來開啟安裝檔的 App，安裝完成後可視需要還原原設定。

首次連線時通常會出現系統 VPN 授權提示。這是用戶端建立本機網路接管通道的步驟，不代表裝置已連上任何代理節點。授權後仍須選擇有效設定檔與策略。若鎖定螢幕後連線中斷，請檢查電池最佳化、背景執行限制，以及是否有其他 VPN App 同時啟動。

前往下載

iOS App Store 入口

下載頁提供 Clash Plus 的 App Store 連結，並列出官方網站 clashplus.io。請先閱讀商店中的系統需求，再完成安裝；訂閱網址應由可信來源取得，並另外匯入用戶端。

允許新增 VPN 設定後，返回用戶端確認所選設定檔與連線狀態。系統 VPN 圖示只表示相關通道已建立，無法證明所有 App 都採用相同的分流策略。測試時先用瀏覽器連線至目標，再依實際需求檢查 App 連線，避免反覆刪除系統網路設定。

前往下載

Linux 桌面與核心

桌面環境建議優先選用圖形介面用戶端；伺服器或路由器使用者則可考慮直接執行 Mihomo 核心。Debian 系與 RPM 系發行版應依各自的套件管理方式安裝；AppImage 是常見的可攜式發行格式範例，實際可用檔案請以下載頁列出的入口為準，並非每個專案都提供所有格式。

安裝前記下發行版、架構與桌面環境。桌面代理設定通常只會影響遵循該設定的 App，終端機工具可能需要另外指定代理。直接執行核心時，還須自行管理設定檔路徑、啟動服務、記錄檔與存取權限；圖形介面用戶端的操作步驟不能直接套用至背景服務。

前往下載

初次安裝可從 Clash Plus 開始；已經有穩定設定的使用者，則應先比較核心相容性、訂閱管理方式與系統接管方式。用戶端名稱相近，不代表支援的設定範圍完全相同。舊教學中的按鈕位置也可能與目前介面不同，建議依「設定檔、代理、設定、記錄」等功能入口尋找。

封存用戶端適用於辨識舊環境與遷移情境。遇到無法辨識的設定欄位時，先確認核心是否支援，再考慮調整設定；反覆更換安裝檔通常無法解決訂閱內容本身的問題。下載頁會分別列出安裝入口與維護狀態，方便區分日常使用和舊版相容需求。

查看所有用戶端 →

Clash 設定與設定檔位置

下方為靜態設定示意。切換主題可查看操作位置；實際名稱依所選用戶端而異，不會變更本機網路設定。

設定 · 系統代理
系統代理開啟
混合連接埠7890
監聽位址127.0.0.1
允許區域網路連線關閉

讓 App 使用本機代理

系統代理會將作業系統的代理位址指向用戶端的監聽連接埠，適合遵循系統設定的瀏覽器與桌面 App。先啟動核心並選取設定檔，再前往設定頁開啟系統代理。瀏覽器擴充功能可能會覆寫系統設定，終端機也可能只讀取環境變數，因此瀏覽器能連線不代表終端機也已使用代理。相較於 TUN，這種方式的影響範圍較容易確認。若變更混合連接埠，請同步檢查系統代理位址；排除問題時，先確認連線是否出現在用戶端的連線清單中。

此範例僅用來說明欄位與位置，並非可直接取代現有訂閱的完整設定檔。實際執行前，須確認策略群組、規則資料與核心功能彼此相容。

安裝後完成這三個步驟

請分開確認「安裝成功」與「連線可用」。先建立可還原的基本設定，再逐步擴大接管範圍；發生問題時，較容易找出變更來源。

  1. 匯入並選取訂閱設定檔

    開啟「設定檔」或「Profiles」，選擇從連結或本機檔案匯入。連結須包含完整路徑與參數；匯入完成後，點選設定檔項目將其設為目前設定檔，再查看代理頁是否出現策略群組。安裝檔本身不會附帶可用的代理服務，訂閱內容應由可信來源提供。

    若清單中已有設定檔卻沒有策略群組，先確認目前選取的項目，再查看記錄中的解析提示。不要將訂閱網址貼到節點伺服器位址欄，也不要在公開截圖中顯示完整訂閱連結；其中的存取參數可能與帳戶相關。

  2. 選擇規則模式與可用策略

    初次使用時可先選擇規則模式，再於需要手動選擇的策略群組中指定可用項目。規則模式決定如何比對流量，策略群組則決定比對後使用哪個出口，兩者並非同一個開關。全域模式可用於縮小部分問題的排查範圍，但無法取代正確的規則設定。

    測速結果只反映特定測試條件，不代表瀏覽所有網站時的實際體驗。若某個 App 出現異常，請記下目標網域、命中規則與錯誤時間，再檢查相關策略群組。若只有單一目標連線失敗，應先排查該目標的解析與連線，而非立即重設整個用戶端。

  3. 啟用流量接管並確認連線

    桌面版先開啟系統代理，用瀏覽器連線至目標並查看連線清單。若終端機無法使用代理，請另外檢查其代理環境變數。若要接管其他 App，再評估是否使用 TUN；行動裝置則依系統提示允許 VPN 連線，並確認目前設定檔已啟用。

    確認連線正常後，再設定開機時啟動。開機時啟動只代表啟動 App，不一定會同時啟用系統代理或 TUN，請分別確認。結束用戶端前先關閉流量接管；若結束後仍無法連線，請檢查系統是否仍保留指向本機連接埠的代理設定，再依教學還原。

查看完整教學 →

開源生態、核心與更新

用戶端介面、代理核心與訂閱服務屬於不同層次。了解各自負責的部分，比單純比較軟體名稱更有助於安裝與排除問題。

查看用戶端比較 →

Clash 名稱與後續生態系

Clash 最初建立了以設定檔、規則與策略群組管理代理連線的使用方式。原始專案與部分早期圖形介面用戶端停止維護後，社群仍持續以相關設定生態為基礎，開發核心與介面。如今搜尋 Clash，常會同時看到歷史專案、後續核心與不同平台的用戶端，不應將它們視為同一個維護團隊。

閱讀舊教學時，應先確認教學適用的用戶端與核心。介面上看似相同的開關，實際實作可能不同；舊專案支援的設定範圍也未必涵蓋新欄位。日常使用建議優先選擇仍在維護的用戶端，備份原始設定檔，再依現行文件遷移，比照著舊截圖操作更可靠。

Mihomo 與圖形介面用戶端的分工

Mihomo 是 Clash 生態系中的代理核心，負責解析設定檔、比對規則、建立對外連線及處理相關網路功能。圖形介面用戶端通常負責顯示設定檔清單、策略群組、記錄與設定，並協調核心啟動及系統流量接管。視窗開啟不代表核心已啟動；核心正常執行，也不代表 App 流量已進入代理。

因此，排查問題應分層進行：先確認設定檔是否成功載入，再檢查監聽連接埠是否已建立，最後確認系統代理或 TUN 是否涵蓋目標 App。不同用戶端可能採用不同的核心版本與預設設定。若缺少某項功能，應確認實際核心是否支援，而非只根據用戶端名稱判斷。

如何查閱開源資訊

可透過開源程式碼儲存庫查閱實作內容、授權條款、發行說明與已知問題。下方指令僅會複製 Mihomo 原始碼，適合想閱讀實作或準備建置環境的使用者；一般安裝不必先複製儲存庫，直接從下載頁選擇圖形介面用戶端即可。儲存庫中的建置步驟請以專案說明為準。

提交問題前，先用明確關鍵字搜尋既有討論，並準備作業系統、用戶端名稱、重現步驟與必要記錄。公開資料前，請移除訂閱網址、帳戶參數與私人伺服器資訊。社群資訊可協助了解問題，但不應將討論中的實驗參數直接套用至所有裝置。

App、核心與訂閱須分別更新

用戶端更新可能變更介面與系統整合方式；核心更新可能影響通訊協定或設定欄位的處理方式；訂閱更新則主要變更節點、策略與規則來源。三者並不相同。訂閱更新成功不代表 App 已更新；重新安裝用戶端也不會自動修復失效的訂閱網址或遠端服務。

更新前記下正在使用的設定檔與重要設定，並閱讀相關變更說明。更新後若發生異常，先判斷是啟動失敗、設定檔解析失敗，還是特定連線失敗，再逐步縮小範圍。舊版用戶端的遷移建議可參閱停止維護用戶端說明；連接埠、DNS 與逾時問題則可依照疑難排解手冊逐項處理。

取得 Mihomo 原始碼

本機須已安裝 Git；這不是安裝用戶端的步驟。

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

查看 Mihomo 開源儲存庫 →

設定與問題排除文章

完成基本連線後，再依實際症狀閱讀相關文章。每次只變更一項設定，並記錄修改前後的結果，避免連接埠、DNS 與路由同時變動而無法判斷原因。

故障排除

Clash 連接埠 7890 已被占用：找出占用程序並變更混合連接埠

用戶端啟動時若提示連接埠已被占用，可使用 netstat、lsof 等指令找出占用程序，再修改 mixed-port 與外部控制連接埠，並同步調整系統代理設定。

適用於出現 address already in use，或多個代理用戶端同時執行的情況。先找出占用程序，再決定結束程序或變更連接埠；不要隨意結束名稱不明的系統程序。變更連接埠後，也要檢查瀏覽器擴充功能與終端機是否仍使用舊位址。

安全與憑證

開啟代理後網頁顯示憑證錯誤？HTTPS 錯誤原因與處理方式

整理系統時間錯誤、中間人攔截、節點異常與 DNS 污染等憑證錯誤原因，說明哪些情況與代理有關，以及安全的處理順序。

出現憑證警告時，先不要輸入密碼或付款資訊，並確認系統時間、目標網域與憑證提示。更換出口後恢復連線只能作為排查線索，不能因此認定憑證可以忽略，也不應關閉瀏覽器憑證驗證來解決問題。

進階設定

GeoIP 與 GeoSite 資料庫更新方式及分流規則寫法

說明 GeoIP、GeoSite 資料檔的用途與存放位置、手動及自動更新設定，以及 GEOIP、GEOSITE 規則在 config.yaml 中的常見寫法。

適用於規則已載入但目標分流與預期不同，或記錄明確顯示規則資料讀取失敗的情況。先確認目前使用的資料格式與實際路徑，再檢查更新流程；新增規則前，也應確認核心支援相應的規則類型。

查看所有文章 →