Clash Meta for Android · 開源 mihomo 核心

Clash Android 版Android 用戶端下載與設定

依裝置選擇用戶端,再完成訂閱匯入、VPN 授權與規則分流設定。

  • YAML 規則範例
  • 中文設定文件
閱讀設定文件

下載各系統適用的 Clash 用戶端

先選擇裝置的作業系統,再確認處理器架構和安裝檔格式。更換用戶端前,請保留訂閱網址或設定檔,方便重新匯入。

如何選擇安裝檔

手機處理器支援 64 位元,不代表作業系統一定能安裝所有 64 位元應用程式。若下載頁提供多種架構的套件,請以系統實際支援的應用程式架構為準。不確定時,可優先查看用戶端是否提供通用版;不要只憑手機型號中的數字判斷。如果系統提示應用程式與已安裝的同名應用程式衝突,請先備份設定,再確認兩者是否來自相同的發行管道。

如何從舊用戶端移轉

從已停止維護的 Clash for Windows 移轉時,先記下目前啟用的設定檔和手動選擇的策略組,再將原訂閱或本機檔案匯入新用戶端。請勿直接複製整個應用程式資料夾。舊用戶端留下的系統代理設定可能仍指向原本的連接埠;切換前先關閉舊用戶端的流量接管,再用同一個瀏覽器送出新請求,確認新用戶端的連線記錄有收到請求。

用戶端分流與設定功能

先區分系統接管、規則比對和出口選擇。某個環節正常,不代表下一個環節也正常。

先確認流量是否進入用戶端

首次啟動並連線時,請在 Android 系統彈出視窗中確認 VPN 要求。授權後,符合接管範圍的應用程式流量才會進入用戶端,不必逐一設定代理位址。有時 VPN 已由其他應用程式使用,工作資料夾也可能設有個別限制。若部分應用程式未生效,先檢查用戶端的應用程式接管範圍,再查看連線記錄。全域接管指的是流量入口,不代表一定要使用全域代理模式;在規則模式下,流量仍可依規則直連。

查看首次授權步驟 →
分流異常時,依序檢查入口、規則和出口
觀察結果優先檢查項目重新測試方式
連線記錄中找不到請求確認系統是否已授權,以及目標應用程式是否在接管範圍內。桌面版也要確認應用程式是否使用系統代理。關閉應用程式中正在瀏覽的頁面,再重新開啟。比較前後兩次記錄,確認是否出現相應的目標位址。
有連線記錄,但規則不符確認目前是否使用規則模式。檢查具體規則是否被前面的通用規則優先符合,以及設定是否已重新載入。使用原本的應用程式存取相同目標,不更動網路和策略組,再確認新連線記錄中的規則名稱。
規則符合,但連線失敗分辨是網域解析、建立出口連線失敗,還是應用程式回應逾時。符合規則只代表已選定出口,不代表資料已送達。保持接管方式和規則不變,只替換該策略組的出口,觀察錯誤是否有所變化。

開源專案與設定資料

透過上游原始碼、變更紀錄和用戶端文件確認功能。下載來源、核心支援和訂閱服務是三件不同的事。

原版 Clash、Clash.Meta 與 mihomo

早期 Clash 奠定了許多沿用至今的設定習慣:集中定義節點,由策略組管理出口,再透過規則依序指定策略。Clash.Meta 延續這套架構並進一步擴充,後續以 mihomo 之名維護。舊教學仍會使用前兩個名稱。遇到相同的設定鍵時,可以參考舊教學了解基本用途,但不要假設預設值、支援範圍和觸發條件也完全相同。排除問題時,先確認目前用戶端使用哪一類核心,再查閱相應專案的資料。

用戶端與核心的分工

Clash Meta for Android 負責管理設定並提供 Android 端的 VPN 連線;mihomo 則負責解析設定、比對規則並建立出口。能儲存設定,只代表檔案已匯入用戶端;能否載入、規則是否符合,還要查看核心的執行記錄。反過來說,若系統未授權,或省電策略終止了背景服務,修改 YAML 中的出口通常無法解決問題。回報問題前,先區分這兩個層面:安裝、系統彈窗和介面問題,優先查看用戶端專案;欄位、規則和連線解析問題,再參照核心資料。

如何查證社群資料

上游儲存庫可供查看原始碼和提交紀錄,也能在問題區搜尋相同錯誤。搜尋時保留明確的欄位名稱和錯誤類型,並先確認討論使用的平台與執行方式;例如,桌面版系統代理運作正常,不能證明 Android 的 VPN 接管設定也正確。重現問題時,請保留最精簡的設定、操作步驟和已移除敏感資訊的錯誤片段。公開記錄前,請刪除訂閱網址、代理認證資料和私人網域;連線記錄中的目標也可能洩漏實際瀏覽內容。

更新前保留可用的設定

用戶端安裝檔、核心變更和訂閱內容各有不同的更新週期。更新用戶端可能同時更新核心;更新訂閱則可能變更節點名稱、策略組或規則順序。若更新後分流結果不同,先備份目前檔案並保留上一份可用版本;比對變更說明和設定差異,避免同時重新安裝用戶端、更新訂閱和修改 DNS。一次只變更一項,再使用相同網路、應用程式和目標重新測試,就能縮小問題範圍。

安裝與設定常見問題

安裝完成後,為什麼策略組還是空的?
安裝檔提供的是用戶端,策略組則來自目前使用的設定。先確認訂閱已成功匯入並啟用;只將檔案匯入清單,並不會自動取代目前正在使用的設定。
已顯示 VPN 圖示,為什麼有些請求仍然直連?
VPN 圖示表示系統已建立 VPN 連線。進入用戶端的請求若符合 DIRECT,仍會直接連線。先確認連線記錄中有沒有該請求,再核對符合的策略。
只有切換 Wi-Fi 網路後出錯,該先檢查什麼?
先確認新網路是否需要登入驗證、網域解析是否正常,再查看用戶端有沒有重新建立連線。沿用原本的規則重新測試,就能區分是網路變更還是設定變更造成問題。
已修改連接埠,為什麼終端機仍使用舊位址?
已開啟的終端機可能仍保留舊的代理環境變數。請檢查該終端機工作階段和指令本身的代理設定;系統代理中的新連接埠不一定會同步更新。

技術筆記

依實際狀況查閱:切到背景後連線中斷、桌面應用程式未使用代理,以及網域解析路徑與預期不符。

Clash Meta for Android 背景常駐:VpnService 授權與省電白名單設定

說明 VpnService 授權提示的意義、各品牌系統的省電策略為何會終止背景連線,以及電池最佳化白名單與自動啟動的逐項設定方式。

閱讀背景常駐設定 →

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

瀏覽器擴充功能攔截代理、終端機未使用系統代理、連接埠不一致,是三大常見原因。本文分別整理瀏覽器與終端機的檢查順序和環境變數設定方式。

閱讀系統代理排除指南 →

Clash DNS 洩漏檢測:使用 fake-ip、nameserver-policy 設定防止 DNS 洩漏

先透過檢測頁面確認 DNS 請求的流向,再從 enhanced-mode、fallback 和 nameserver-policy 三處調整設定,並附上可直接參照的 YAML 範例。

閱讀 DNS 設定排除指南 →