CLASH · IPV4 · 開源用戶端

Clash開源網用戶端下載與設定

依平台選擇用戶端,透過中文教學匯入設定,再檢查連接埠與規則是否生效。

  • 核心Mihomo
  • 授權條款GPL-3.0
  • 規則目標DIRECT

127.0.0.1 / 用戶端入口

依作業系統下載 Clash 用戶端

先確認作業系統與處理器架構,再選擇安裝檔。圖形介面用戶端通常可在同一個介面匯入設定、切換策略組及查看記錄,適合初次安裝者。若已在使用命令列核心,可前往下載頁查看獨立的核心下載入口,避免把核心套件當成桌面安裝程式。

Windows

在系統的「關於」頁面確認作業系統類型,再核對用戶端標示的處理器架構。初次安裝可先透過系統代理測試瀏覽器連線,不必一開始就啟用虛擬網卡。若安裝程式或系統顯示權限提示,先確認提示涉及安裝、服務還是網路存取;不必只為了處理單一提示就關閉整個防火牆。更換舊用戶端前,先結束舊程序並保留原有設定。

前往下載

macOS

在「關於這台 Mac」中確認是 Intel 處理器還是 Apple 晶片,再選擇相符的安裝檔。若啟動時出現系統安全性提示,請參閱專案的發行說明,確認安裝需求;若能啟動但無法接管流量,則檢查系統代理狀態及用戶端的網路權限。要移轉到另一台電腦時,建議先移轉設定,不要直接複製舊應用程式的資料夾。

前往下載

Android

選擇安裝套件時,請確認裝置所用作業系統支援的架構,不要只看手機晶片的規格。首次連線通常會出現系統的 VPN 授權提示,確認允許後,再查看用戶端是否顯示已連線。若問題只在鎖定螢幕後發生,先檢查系統是否暫停應用程式的背景執行;若一連線就中斷,則確認是否有其他應用程式正在使用 VPN。

前往下載

iOS

從下載頁前往 App Store 的產品頁面,先確認系統需求,再決定是否安裝。首次連線時,依照系統提示允許新增 VPN 設定;成功匯入與成功連線是兩種不同狀態,不能只因設定清單出現名稱就判定已連線。若裝置已有正在使用的 VPN 設定,請先確認能否切換,尤其是由公司或機構管理的裝置。

前往下載

Linux

桌面系統使用者應先確認 Linux 發行版、套件格式與處理器架構,再選擇圖形介面用戶端。不同桌面環境處理系統代理的方式不盡相同:瀏覽器能使用代理,不代表終端機指令也會讀取相同設定。若只在伺服器上執行核心,還要確認設定檔路徑與服務權限,並依實際用途設定監聽範圍。

前往下載

若兩款用戶端都支援目前的裝置,可優先比較設定匯入方式、維護狀態與記錄入口。若需要區域網路存取、虛擬網卡或設定覆寫,也要確認介面是否提供相應選項,以及核心是否支援這些欄位。若只是為了開啟舊設定檔而考慮使用已封存的用戶端,可先用仍在維護的用戶端測試副本,避免反覆修改原始檔案。

查看所有用戶端 → 比較用戶端,選擇適合的版本

DIRECT / 設定指引

Clash 設定欄位與流量路徑

本機監聽、流量接管與規則分流是三件不同的事:連接埠決定應用程式將要求送到哪裡,接管方式決定哪些要求能進入核心,規則則決定進入核心的要求要如何處理。記住這三個環節,排查時就能分辨是要求沒有送進來,還是進來後走錯路徑。

規則比對順序與預設目標

規則模式會由上往下檢查每條規則,符合條件後便採用該規則指定的目標,不會繼續尋找更精確的規則。範例分別處理私人網路位址、示範網域名稱與其他流量:第一條讓指定的位址範圍直接連線,第二條用來觀察網域比對與拒絕結果,最後一條則作為預設規則。這份設定不需要遠端節點,適合先在測試設定中查看記錄,再將相同的順序套用到自己的設定。實際編輯時,請避免將拒絕規則寫成範圍過廣的網域後綴。

  • 將具體條件放在前面,MATCH 放在最後。
  • no-resolve 可避免這條位址規則主動將網域名稱解析為 IP。
mode: rule
rules:
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN,example.org,REJECT
  - MATCH,DIRECT

便條上的 mixed-port: 7890 僅為範例,不是所有用戶端都使用的固定連接埠。127.0.0.1 指向目前裝置;手機上的相同位址不會指向電腦。若只供本機使用,請維持 allow-lan: false,並以用戶端實際顯示的監聽連接埠為準。遇到連接埠衝突時,確認目前連接埠確實被占用後再更換,並一併修改曾手動填入舊連接埠的應用程式設定。

查看連接埠、模式及其他一般設定欄位 →

mixed-port / 初次連線

匯入設定、選擇模式並測試連線

初次使用時,盡量保留原本可正常上網的狀態,每次只修改一項設定。先確認設定能否載入,再檢查要求是否進入核心,最後才確認規則將流量分到哪裡。這樣即使第二步出了問題,也不必回頭重新匯入訂閱。

  1. 01 / config.yaml

    匯入並啟用設定

    在設定或訂閱頁面新增現有的本機檔案或訂閱網址。匯入後,先確認策略組與規則是否出現,再選取該設定檔並確認它是目前生效的設定。若介面只顯示下載成功,卻沒有載入內容,請先查看匯入記錄是否有格式或網路錯誤。訂閱網址可能包含存取憑證,分享錯誤畫面時請勿截取完整網址。

  2. 02 / mode: rule

    選擇規則模式與流量接管方式

    日常使用時先選擇規則模式;確認需要轉送的規則指向正確的策略組,再到組內檢查目前選用的出口。桌面電腦可先透過系統代理測試會遵循此設定的應用程式;手機則需依用戶端的連線操作完成系統授權。規則模式與系統代理並非二選一:前者決定如何分流,後者決定要求如何進入核心。

  3. 03 / 127.0.0.1

    查看連線記錄與比對結果

    重新開啟網頁送出要求,再到用戶端的連線記錄中比對網域名稱、命中的規則與出口。若完全沒有新記錄,先確認應用程式是否使用代理入口;若有記錄但連線失敗,再檢查策略組、DNS 與連線錯誤。測試命令列程式時,請另外確認終端機讀取到的代理設定,不要用瀏覽器的結果代替判斷。

需要恢復網路時,先關閉剛才啟用的流量接管方式,再確認系統代理是否已還原。直接結束用戶端程序,可能會讓系統代理設定仍指向本機連接埠。恢復後記下是哪個開關改變了故障狀況,下次就從該步驟繼續排查,不必重新安裝。

查看完整教學 → 依問題現象查找排查步驟

config.yaml / 專案來源

Clash 開源生態系與 Mihomo 核心

Clash開源網是獨立的資訊站,整理用戶端下載入口、設定範例與排查方法。用戶端的發行說明、維護狀態與功能範圍,請以各專案資訊為準。閱讀原始碼時,先分辨看到的是負責網路處理的核心,還是用來控制核心的用戶端介面。

專案沿革:同一名稱下的不同專案

早期的 Clash 專案將代理節點、策略組與分流規則整合在同一份設定中。原專案後來停止維護,但這套設定結構與相關使用習慣,仍由社群中的其他專案延續。舊教學中的介面、選單路徑與欄位,不一定適用於目前的用戶端;舊截圖可用來理解概念,實際操作仍應參考現行專案的說明。

移轉舊設定檔時,先保留原始檔案並另存副本,再逐一比對通用欄位、節點類型與規則目標。舊設定檔即使能成功載入,也不代表每項設定都會以原本的方式處理。先確認基本連線,再逐步還原相依性較高的功能,比移轉時整份重寫更容易找出問題。

社群分工:介面功能與流量接管方式

圖形介面用戶端通常負責管理設定檔、系統整合與記錄顯示。即使兩款用戶端使用相近的核心,系統匣操作、開機啟動、背景服務與覆寫功能的入口仍可能不同。系統授權或安裝介面相關問題,可先查閱用戶端專案說明;規則判斷與通訊協定支援則較適合參考核心文件。

查閱公開的問題回報時,先確認其中提到的作業系統與重現條件。相同的錯誤訊息,可能源自檔案權限、系統網路服務或設定語法。回報問題時,可提供精簡後的欄位片段、錯誤發生步驟與相關記錄;請先移除節點資訊、訂閱網址及記錄中的個人資料。

核心關係:從 Clash.Meta 到 Mihomo

Mihomo 是 Clash.Meta 延續發展後採用的專案名稱,公開程式碼儲存庫由 MetaCubeX 維護,採用 GPL-3.0 授權。支援相關功能的用戶端可將使用者選定的設定交給核心,由核心負責監聽、規則比對與連線轉送。用戶端也可能將介面設定合併至最終設定,因此匯入的檔案與核心實際載入的內容不一定完全相同。

確認某個欄位是否生效時,先比對儲存的設定與用戶端提供的生效設定,再查看核心記錄。不要只憑按鈕名稱推斷底層狀態。例如,系統代理已開啟,不代表虛擬網卡也已啟用;兩者改變的是不同的流量入口。

更新方式:分別檢查程式、核心與訂閱

程式升級會更新用戶端本身;核心是否隨安裝套件更新,則由各專案決定。重新整理訂閱會更新設定內容,規則集也可能有自己的更新週期。這些動作在介面上可能都標示為「更新」,但實際修改的項目不同。發生異常時,先記下最近更新的是哪一項,再查看對應專案的變更記錄。

修改前先保留一份過去可正常使用的設定副本;修改後優先重新測試原本正常的要求。若訂閱一更新就出問題,先確認策略組與規則引用是否有變動;若升級應用程式後才發生問題,先檢查系統權限與啟動記錄。不要為了恢復一次連線,同時更新訂閱、覆寫設定並替換核心。

查看 Mihomo 原始碼

可在 MetaCubeX/mihomo 儲存庫查看原始碼、授權條款與發行記錄。以下指令需先安裝 Git,只會將原始碼下載到目前目錄下的 mihomo 子目錄,不會安裝用戶端或修改系統代理。若要取得可執行的程式,請依作業系統從下載頁選擇適合的版本。

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

127.0.0.1 / 排查記錄

Clash 安裝與故障排查文章

排查文章依問題現象分類。程式無法開啟,先查看啟動記錄;程式能開啟但沒有流量,先檢查應用程式與本機連接埠的連線;只有特定應用程式無法連線,就從該應用程式的代理設定查起。先選一篇最符合目前狀況的文章。

問題排查

Clash 用戶端一開啟就閃退:排查設定語法、連接埠占用與核心檔案問題

啟動時立即崩潰,常見原因包括 YAML 語法錯誤、連接埠遭占用或缺少核心檔案;可依據記錄線索逐步排除,恢復正常啟動。

適用於程式尚未顯示主畫面就退出的情況。先確認程式是在讀取設定前還是之後退出,再判斷要還原設定副本、釋出連接埠,或修復安裝。

問題排查

Clash 已開啟系統代理卻未生效:分別排查瀏覽器與命令列終端機

瀏覽器擴充功能攔截代理、終端機不讀取系統代理,或缺少環境變數,都是常見原因;可分別從瀏覽器與終端機兩方面逐一排查。

適用於網頁與命令列的連線結果不一致時。比對兩個應用程式是否使用相同的本機連接埠,再判斷問題出在應用程式的代理入口,還是流量分流規則。

查看所有文章 →