Windows
可選擇 Clash Plus、Clash Verge Rev 等用戶端。桌面使用時,可先啟用系統代理並確認瀏覽器連線正常,再視應用程式需求考慮使用 TUN。安裝前請確認系統需求與處理器架構;升級時保留訂閱來源與本機覆寫規則。
前往下載CONFIGURATION / 設定功能
從流量接管到策略比對,依用途查看設定片段。範例僅列出部分欄位,須搭配有效節點與策略群組使用。
規則模式會依清單順序由上往下比對,符合條件後便採用對應策略,不再繼續比對後續規則。網域後綴適合涵蓋特定服務,關鍵字可用於較廣泛的網域比對,地理資料庫規則則能補充 IP 位址判斷。相較於讓所有連線共用同一個出口,規則分流可分別為開發服務、區域網路資源與一般網站安排連線路徑。將明確的網域規則放前面,預設規則放最後;範例中的 PROXY 必須是設定檔中已存在的節點或策略群組名稱。
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- DOMAIN-KEYWORD,google,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
系統代理需要應用程式主動遵循代理設定,部分命令列工具與網路程式不會讀取這些設定。TUN 模式透過虛擬網路介面與路由接管連線,適合需要擴大接管範圍的情境。啟用前,先確認一般代理連線正常,再依用戶端要求安裝服務或授予權限。自動路由、介面辨識與 DNS 接管也應一併檢查;其他 VPN、虛擬機網卡或企業網路政策都可能影響結果。TUN 解決的是流量如何進入核心,不會取代節點選擇與分流規則。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
圖形化用戶端通常會在設定頁提供訂閱網址匯入功能,下載的內容可能是完整 YAML,也可能只是需要轉換的節點清單。匯入後,請確認策略群組、規則與節點都已載入,再啟用系統代理。相較於逐一手動輸入伺服器參數,訂閱更方便集中更新;但更新也可能覆蓋直接修改遠端設定檔的內容。需要長期保留的本機規則,建議優先使用用戶端提供的覆寫或合併功能。下方範例展示的是本機檔案型節點提供者,並非可直接貼入訂閱欄位的網址。
proxy-providers:
local-nodes:
type: file
path: ./providers/nodes.yaml
health-check:
enable: false
mihomo 支援 Shadowsocks、VMess、Trojan、VLESS、Hysteria2、TUIC 等代理類型,實際可用欄位取決於核心實作與伺服器設定。即使都顯示為節點,底層傳輸方式、驗證參數與 UDP 行為也可能不同。選擇協定時,先確認用戶端支援情況,再核對伺服器參數,不宜只看名稱判斷速度。相較於只支援單一訂閱格式的工具,多協定核心更方便統一管理策略群組;但變更節點類型名稱並不等於完成協定轉換。範例使用保留網域與教學用密碼,無法用於實際連線。
proxies:
- name: trojan-example
type: trojan
server: proxy.example.com
port: 443
password: "your-password"
sni: proxy.example.com
udp: true
Fake-IP 透過保留位址與網域建立對應,讓核心在收到連線時保留網域資訊,以便套用網域規則。它不是目標伺服器的真實位址,也不是可分享給其他裝置的解析結果。相較於先取得真實位址再判斷目標的方式,這種對應可縮短部分解析等待時間,但區域網路裝置探索、印表機或特殊應用程式可能需要例外設定。遇到相容性問題時,先確認 DNS 是否確實進入核心,再針對特定網域設定過濾;不要清空整份過濾清單,也不要一再切換模式來掩蓋設定錯誤。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "*.local"
nameserver:
- 223.5.5.5
外部控制介面可供面板讀取策略群組、連線、規則與記錄,也能用來切換策略。它與接收瀏覽器請求的混合連接埠用途不同,兩者不能互相取代。桌面用戶端通常已管理此介面,一般不必手動新增一組設定;只有獨立執行核心時,才需要依部署方式設定。相較於只編輯檔案,控制面板更適合確認實際生效狀態。建議先綁定本機迴圈位址,避免直接暴露於公用網路;若確實需要遠端存取,再設定驗證與存取控制。範例僅展示本機監聽欄位。
external-controller: 127.0.0.1:9090
log-level: info
mode: rule
# 圖形化用戶端使用者建議優先使用內建面板
# 遠端管理前請另行設定驗證與存取控制
OPEN SOURCE / 核心與用戶端
用戶端負責操作介面,核心負責連線。先了解兩者的分工,再選擇安裝檔、排查問題與安排更新。
Clash 最初以規則導向的代理核心為基礎,並逐漸發展出圖形化用戶端、設定編輯器與控制面板等工具。原始專案停止維護後,社群分支仍持續演進。Clash Meta 後來改以 mihomo 為名,因此舊教學提到的 Meta 核心與新資料中的 mihomo 有沿革上的關聯,但不代表所有舊設定都與目前欄位完全相容。
安裝檔名稱也不等於核心名稱。Clash Verge Rev、FlClash 等用戶端各自管理操作介面、系統代理、服務安裝與設定;底層連線能力仍須依其實際使用的核心判斷。閱讀舊文章時,先確認討論的是圖形介面還是核心參數,再判斷操作是否適用,才不會在不同用戶端中找不到名稱相同的按鈕。
mihomo 儲存庫公開原始碼,並採用 GPL-3.0 授權。原始碼、議題紀錄與發布說明有助於了解實作方式並釐清相容性問題。不同圖形化用戶端各有其授權條款與維護時程,不能把核心的授權條件直接視為所有安裝檔通用的聲明。重新散布或修改軟體前,請先閱讀對應專案的授權檔案與相關說明。
本站提供安裝檔導覽與繁體中文技術內容,不取代上游專案的發布說明,也不代表各用戶端的維護團隊。若要確認特定欄位是否支援,或了解某項系統權限的用途,請以相應用戶端與核心文件為準。回報問題時,請附上作業系統、重現步驟與必要記錄,並移除訂閱網址、密碼及其他私人參數。
圖形化用戶端更新、核心更新、訂閱更新與規則集更新是不同操作。介面更新可能改變服務安裝方式;核心更新可能調整欄位行為;訂閱更新則主要替換設定內容。一次只變更一個環節,保留原設定檔副本,再測試連線與分流,通常比一次更新所有元件更容易找出問題來源。
遠端訂閱內容也應與本機設定分開管理。直接修改訂閱下載的檔案,可能在下次更新時遭到覆蓋。對於固定的區域網路直連規則、個人策略群組或 DNS 例外,建議使用用戶端提供的覆寫功能,並記錄修改原因。更換用戶端前,先匯入原設定,再確認混合連接埠、DNS 與 TUN 的行為;不要把舊介面的開關位置當成設定標準。
代理開關已啟用,只能表示某項接管設定已開啟,不能直接證明所有應用程式都已使用代理。驗證時應檢查連線是否實際進入核心、符合哪一條規則,以及最後選用了哪個策略。瀏覽器與終端機可能使用不同的代理來源,區域網路應用程式也可能略過系統代理,因此應逐一確認各應用程式的狀況。
排查時請依序確認設定能否載入、節點參數是否正確、DNS 是否正常、流量是否進入核心,最後再檢查規則與 TUN 路由。不要只憑單次連線結果判斷整個用戶端。協定差異與核心相容性的細節,可繼續閱讀協定與核心技術參考;不熟悉欄位名稱時,可先查看名詞速查。
git clone https://github.com/MetaCubeX/mihomo.git
PACKAGES / 依平台選擇
先確認作業系統,再核對處理器架構與軟體維護狀態。以下連結會前往下載頁的對應平台區塊,不會直接開始下載。
可選擇 Clash Plus、Clash Verge Rev 等用戶端。桌面使用時,可先啟用系統代理並確認瀏覽器連線正常,再視應用程式需求考慮使用 TUN。安裝前請確認系統需求與處理器架構;升級時保留訂閱來源與本機覆寫規則。
前往下載請依 Apple Silicon 或 Intel 選擇安裝檔。首次開啟時,依系統提示處理應用程式權限;若要使用網路延伸功能或背景服務,請依用戶端說明操作。選擇已停止維護的用戶端前,先確認它是否仍適用於目前的系統與訂閱設定。
前往下載依裝置架構選擇安裝檔,首次連線時確認系統 VPN 授權。行動裝置的背景執行限制可能影響持續連線,請檢查電池管理設定。匯入前確認訂閱格式與用戶端相容,切換網路後再測試 DNS 與應用程式連線狀況。
前往下載下載頁提供 Clash Plus 的 App Store 連結及官方網站 clashplus.io。安裝後,依用戶端指引匯入設定並授予 VPN 權限。行動作業系統的網路接管方式與桌面系統代理不同,更換用戶端時應重新確認策略群組與連線設定。
前往下載桌面使用者可選擇 Clash Verge Rev 或 FlClash,並依發行版選擇相符的安裝檔格式。伺服器與路由器使用者可在下載頁查看核心區,另行管理服務、權限與設定檔。圖形化用戶端的安裝步驟不能取代伺服器部署流程。
前往下載安裝檔只包含用戶端程式,不會自動產生可用節點。連線前仍須取得合法的節點參數或訂閱設定,並確認目前使用的核心支援相應協定。
初次使用建議先閱讀入門教學。已有設定但準備更換用戶端時,先比較平台支援、設定管理與網路接管方式,再匯入原設定檔。
查看用戶端比較 →完成安裝後,先前往設定管理頁匯入訂閱或本機 YAML,等待用戶端下載並解析內容。確認策略群組中出現可選擇的節點後,再啟用適合目前情境的接管方式。只開啟系統代理卻沒有有效設定,或只有節點清單卻沒有相應策略群組,都可能讓連線無法依預期處理。按鈕名稱依用戶端而異,完整操作請參閱Clash 設定教學。
首次驗證時,建議保留原設定中的規則模式,分別測試需要代理的服務與本機資源。若某個應用程式沒有進入核心,先確認它是否遵循系統代理,不要立刻修改節點參數。只有確認需要接管這類連線時,才啟用 TUN 並處理權限與路由。全域模式適合暫時確認出口是否可用,不宜用來取代規則比對結果的檢查。
用戶端提供訂閱管理、系統設定與操作介面,核心則負責代理連線、DNS 與規則比對。操作介面相似,不代表核心功能相同;排查問題時應同時確認兩者。可在名詞速查中了解核心與用戶端的差異。
訂閱包含節點、策略與規則,策略群組則決定符合規則後實際使用哪個出口。部分設定採用手動選擇群組,匯入成功後仍須選定可用節點。請先檢查群組中的選擇,再查看連線記錄,不必只是不斷重新整理訂閱。
不一定。接管方式取決於應用程式的行為與用戶端實作。初次使用時,先測試系統代理;只有需要接管不遵循系統代理的程式時,再評估是否使用 TUN。若同時啟用兩者,請留意重複接管及與其他 VPN 的路由衝突,相關名詞請參閱網路堆疊術語說明。
遠端更新可能會重新產生設定檔,並覆蓋直接寫入檔案的內容。請將需要長期保留的規則移至用戶端支援的覆寫設定中,再檢查合併後的實際規則順序。調整前先備份原檔,每次只修改一項,方便確認變更效果。
TECH NOTES / 技術筆記
依核心差異、記錄判讀與設定功能分類整理。請先確認適用範圍,再將文章中的局部設定合併至自己的檔案。
依時間線整理三代核心的沿革與命名變化,對照設定欄位、協定支援與用戶端適配情況,協助判斷舊設定能否直接沿用。
閱讀核心差異 →依記錄層級解析用戶端輸出,逐項說明連線逾時、解析失敗、連接埠占用、設定解析錯誤等常見問題,並提供從記錄追查至特定設定項目的步驟。
查看記錄排查方式 →整理 mihomo 在原版基礎上擴充的功能:遠端載入規則集、流量嗅探、VLESS 與 Hysteria2 支援,以及相應的設定方式。
查看設定功能 →