Windows 用戶端
建議優先參考 Clash Plus,也可比較 Clash Verge Rev、FlClash 與 Clash Nyanpasu。安裝後先匯入設定,再啟用系統代理;若需要接管遊戲或命令列連線,再確認 TUN 權限。若其他軟體已占用監聽連接埠,請先排除衝突,再測試連線。
前往下載 →CLIENT DOWNLOADS
先確認作業系統與處理器,再選擇用戶端。桌面與行動裝置的授權方式不同,訂閱設定也必須符合用戶端支援的格式。
建議優先參考 Clash Plus,也可比較 Clash Verge Rev、FlClash 與 Clash Nyanpasu。安裝後先匯入設定,再啟用系統代理;若需要接管遊戲或命令列連線,再確認 TUN 權限。若其他軟體已占用監聽連接埠,請先排除衝突,再測試連線。
前往下載 →在 Apple 選單中開啟「關於這台 Mac」,看到 Apple 晶片名稱就選擇 Apple 晶片版安裝檔;看到 Intel 則選擇 Intel 版。下載頁優先推薦 Clash Plus,另列出 Clash Verge Rev 與 FlClash;ClashX Meta 則保留為封存選項。
將 App 移至「應用程式」後啟動,依系統提示確認網路相關權限。先用系統代理測試瀏覽器連線,再依 App 需求啟用 TUN。切換網路後若無法連線,請先確認設定是否已啟用、代理模式是否正確,以及系統中是否還有其他代理工具正在執行。
前往下載 →可選擇 Clash Plus、Clash Meta for Android、FlClash 或 Surfboard。安裝檔架構須符合裝置規格,首次連線時請確認系統 VPN 權限。若背景執行時斷線,也請檢查電池最佳化設定;各用戶端支援的訂閱格式不盡相同,請分別確認。
前往下載 →前往下載頁開啟 Clash Plus 的 App Store 頁面,產品官網為 clashplus.io。匯入訂閱並選擇設定後,依提示加入 VPN 設定。若特定 App 無法連線,先查看所選策略與命中的規則,再決定是否調整分流。
前往下載 →桌面環境可選擇 Clash Verge Rev 或 FlClash,並依發行版選擇套件格式。App 是否會讀取系統代理,取決於其實作方式;伺服器與路由器使用者可前往核心區查看 mihomo,並自行管理服務權限、設定檔路徑與監聽範圍。
前往下載 →MIHOMO CONFIGURATION
透過 macOS 視窗示意了解常用設定。介面名稱會因用戶端而異,欄位意義請以目前使用的 mihomo 核心文件為準。
proxy-groups:
- name: Proxy
type: select
proxies:
- Auto
- DIRECT
- name: Auto
type: url-test
use:
- subscription
url: https://www.gstatic.com/generate_204
interval: 300
tolerance: 50開啟用戶端的代理頁面,先確認規則使用哪個策略組,再選擇手動策略或自動測試組。select 用來保留明確選擇;url-test 則依指定網址的測試結果,從候選項目中選出較佳選項,適合網路環境經常變動的裝置。兩者可以巢狀使用:外層決定採用哪種方式,內層負責定期測試。測試結果只反映當下連至測試網址的狀況,不代表所有網站的實際體驗。範例中的訂閱提供者必須在完整設定中定義,不能只複製這段就開始連線。
rule-providers:
local:
type: file
behavior: classical
format: yaml
path: ./rules/local.yaml
rules:
- DOMAIN-SUFFIX,apple.com,DIRECT
- RULE-SET,local,DIRECT
- GEOIP,CN,DIRECT
- MATCH,Proxy在規則頁查看比對順序,將需要優先處理的網域放在兜底規則之前。規則集透過 rule-providers 管理來源,再由 RULE-SET 引用,適合分別維護工作服務、直連網域與公開分類。本機檔案與遠端訂閱屬於不同來源類型;切換為遠端來源時,還須設定網址與更新間隔。相較於逐行新增規則,訂閱式管理更方便獨立更新,但仍須確認規則集的行為類型與內容格式。排查時請以連線詳情中的命中紀錄為準,不要只憑規則名稱推測結果。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
先在設定中啟用系統代理,並用瀏覽器造訪目標網站測試設定。系統代理適用於遵循系統網路設定的 App;若要接管其他連線,再啟用 TUN,並完成用戶端要求的服務安裝或系統授權。TUN 透過虛擬網卡與路由處理流量,可能涉及 DNS、預設出口及其他 VPN 的相容性,排查範圍比系統代理更廣。這兩種連線方式都不能取代規則模式本身。啟用後若網路異常,先關閉 TUN 以恢復原有連線路徑,再逐項檢查路由與解析,避免同時修改多個選項而難以找出原因。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "localhost.ptlogin2.qq.com"
nameserver:
- https://dns.alidns.com/dns-query在設定頁確認 DNS 已啟用,再檢查解析請求是否確實送入核心。Fake-IP 會為網域回傳對應的映射位址,連線進入核心後再還原網域,有助於依網域規則處理流量;該位址並非目標伺服器的真實位址。若遇到區域網路服務或依賴真實解析結果的 App,可依網域新增過濾項目,再清除相關快取重新測試。除了更換 DNS 伺服器,也要留意 App 內建的加密 DNS、TUN 的請求接管方式與解析出口。範例僅用來展示欄位關係,請依目前網路的可連線狀況選擇解析服務。
初次使用時,依序確認「設定已啟用、策略可用、規則模式、系統代理」。先讓瀏覽器成功連線一次,再到連線頁檢查目標網域、命中規則與出口策略。若沒有出現紀錄,可能表示流量尚未進入用戶端;若已有紀錄但連線失敗,接著檢查策略選擇、解析結果與上游連線狀況。這樣能區分入口與出口問題,避免反覆重新安裝 App。
若需要自訂分流方式,建議優先使用用戶端提供的本機覆寫功能,將工作網域、區域網路例外與固定策略分別儲存。直接修改從訂閱下載的設定,更新後可能會被覆蓋。每次只修改一類參數,並保留可正常連線的設定副本;遇到問題時即可還原,並比較修改前後的行為。欄位意義、組合限制與更完整的 YAML 範例,請參閱 mihomo 進階設定手冊;第一次匯入則可從 訂閱匯入教學開始。
OPEN SOURCE CONTEXT
分清用戶端、核心與訂閱,更新、移轉與排除問題時就能明確知道該檢查哪裡。
在用戶端中點選匯入、切換策略或查看連線,操作的是圖形介面;實際解析設定、處理規則及建立代理連線,則由核心負責。mihomo 延續並發展了 Clash Meta 的相關成果,因此教學中會同時出現 Clash、Clash Meta 與 mihomo 等名稱。名稱相近不代表每個用戶端都有相同的功能入口,也不代表較舊的核心能讀取目前文件中的所有欄位。遇到設定錯誤時,請先確認正在執行的核心,再查看用戶端如何傳入設定。
選擇用戶端時,建議比較作業系統相容性、設定管理方式、覆寫功能與授權流程。即使使用相同核心,不同用戶端的預設值、選單配置與服務安裝方式仍可能不同。移轉時可沿用相容的訂閱,但系統代理、開機啟動、TUN 權限與本機覆寫都需要在新用戶端重新確認。先結束舊用戶端再測試新用戶端,可減少監聽連接埠、系統代理與虛擬網卡彼此干擾。
Clash 生態系中既有持續開發的核心與介面,也有已停止維護的歷史用戶端。早期教學截圖仍具參考價值,但其中的下載位置、設定欄位與系統權限說明可能已經改變。下載頁會分別標示封存用戶端與目前可選的用戶端,方便已有設定的使用者判斷相容性。新裝置建議優先選擇持續維護的版本;移轉舊設定時,先保留原始檔案,再逐項檢查連接埠、DNS、策略組與規則引用。
舊介面能夠啟動,不代表它能處理新的設定語法;同樣地,新核心支援某個欄位,也不表示用戶端介面已提供相應選項。設定載入失敗時,先閱讀日誌中的欄位名稱與行號,檢查 YAML 縮排、策略組名稱及提供者引用是否相符,再考慮功能相容性。將問題縮小至單一欄位或最小片段,比一次替換整份設定更容易找出原因。
mihomo 原始碼由 MetaCubeX 的公開儲存庫維護,核心採用 GPL-3.0 授權。儲存庫中的文件、提交紀錄與問題討論有助於確認功能變更;各圖形用戶端的程式碼與授權則應分別查看對應專案。本站整理下載入口與中文操作流程;用戶端、核心與訂閱服務則由各自的維護者提供。回報問題時,請區分是介面按鈕無法操作、設定未正確傳入,還是核心已收到連線但處理失敗。
提交日誌前,請先移除訂閱網址中的憑證、伺服器資訊,以及可能辨識個人身分的內容。可保留作業系統、處理器架構、操作步驟、錯誤訊息與已去識別化的最小設定,讓問題容易重現。若要閱讀或建置核心,可複製旁邊的指令取得原始碼;一般使用者直接選擇圖形用戶端即可,取得原始碼並非安裝用戶端的必要步驟。
App 更新通常涉及介面、系統整合或隨附核心;訂閱更新則會重新取得連線參數、策略或規則,兩者是獨立流程。更新 App 後,請確認原設定仍已啟用,並檢查權限與服務是否正常。更新訂閱後,則要留意手動選擇的策略是否仍存在、本機覆寫是否繼續生效,以及規則集是否成功載入。分開驗證兩種更新,有助於找出是哪次變更影響連線。
建議先儲存可用設定與本機覆寫,再進行影響範圍較大的調整。網路環境、訂閱內容與用戶端設定同時變動時,只看某個網頁能否開啟,很難找出問題。保留固定的驗證流程:開啟目標網站、查看連線紀錄、確認命中規則、核對出口策略。測試結束後恢復日常模式,避免將臨時的全域設定留到後續使用。
開啟用戶端的設定頁,選擇新增或匯入,貼上相容的訂閱 URL,等待下載完成後啟用該設定;接著前往代理頁確認策略組。按鈕名稱可能略有不同,請參照訂閱匯入步驟確認操作順序。
先用系統代理測試遵循系統設定的 App。若要接管其他 App,再依用戶端說明設定 TUN,並檢查權限、路由與 DNS。兩種連線方式的作用範圍不同,詳細排查方式請參閱 進階設定手冊。
建議將規則寫入用戶端的本機覆寫或合併設定,不要直接修改訂閱產生的檔案。更新後在連線頁確認規則是否命中,並確認自訂項目仍位於兜底規則之前。常見設定問題可前往說明中心查看。
先查看該 App 的連線是否進入用戶端。有紀錄時,檢查命中規則、所選策略與 DNS;沒有紀錄則檢查 App 的代理設定或網路接管方式。命令列工具可能需要另外設定代理環境變數,其他排查方向請參閱故障排除問答。
CONFIGURATION NOTES
從理解設定欄位到檢查分流結果,依照實際問題繼續閱讀。
以 GEOIP、GEOSITE 與規則集為基礎,建立直連、代理與廣告封鎖的組合。透過連線紀錄確認命中規則,區分規則順序與出口連線問題,再依網站需求新增例外。
閱讀分流實作 →從網域後綴、IP 位址區段到規則集引用,逐項說明常用語法與 no-resolve 參數。了解由上而下的比對順序後,再決定自訂規則的插入位置,避免例外規則被前方較寬泛的條件覆蓋。
閱讀規則語法 →依照設定檔的排列順序,了解一般設定、DNS、代理定義、策略組與規則集之間的關係。先確認各欄位負責的環節,再檢查相鄰區塊中的名稱引用,讓日誌錯誤能對應到具體設定位置。
閱讀設定說明 →