Windows
可從 Clash Plus 等圖形用戶端開始使用。首次連線先確認系統代理是否正常,再依應用程式需求啟用 TUN;若遇到連接埠占用或服務權限提示,先處理本機環境,不要反覆更換訂閱。
前往下載CONFIGURATION INSPECTOR
一份設定會依序決定入口、解析、規則與出站。先確認請求已進入核心,再查看命中的規則與策略組;將問題拆解到對應設定段,比同時修改多個開關更容易找出原因。
規則會由上而下比對,命中後交由指定策略處理。網域後綴適合用來指定明確的網站集合,地理位置規則則用於判斷 IP 位址的歸屬;最後的 MATCH 會接手其餘請求。若網站流量走錯出口,先在連線記錄中核對網域、命中規則與最終策略,不要只看目前選取的節點。規則模式會依這份清單處理流量,全域模式則採用全域策略;切換模式不代表規則問題已修正。範例引用的 PROXY 策略組必須先定義,GEOIP 規則也需要可用的地理位置資料。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
TUN 會將符合路由條件的流量導入虛擬網卡,適合不讀取系統代理設定的應用程式,以及需要進一步處理的 UDP 請求。啟用前,先確認用戶端具備服務或管理員權限,再檢查虛擬網卡與路由是否已建立。TUN 擴大的是流量接管範圍,不會自動改善遠端線路,也無法讓原本不支援 UDP 的節點突然支援 UDP。同時執行其他 VPN 可能改變預設路由,初次設定建議只使用一種流量接管工具。範例僅展示接管設定段;DNS 劫持仍須搭配已啟用的核心 DNS。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
mihomo 支援多種代理協定,但協定名稱相同,不代表所有欄位都能互換。匯入設定時,請保留服務提供者提供的伺服器、連接埠、驗證資訊與傳輸設定;若使用 TLS,也要核對憑證驗證與伺服器名稱。不要以關閉憑證驗證來取代對時間、網域和憑證鏈的排查。圖形介面是否提供特定選項,取決於用戶端及其核心的支援狀況。下方使用保留的範例網域說明 SOCKS5 項目的欄位結構;位址與驗證資訊並非實際線路,不能直接用來連線。
proxies:
- name: example-socks
type: socks5
server: proxy.example.com
port: 1080
username: your-username
password: your-password
策略組可將規則與實際節點分開管理。規則固定指向穩定的組名,再由組內設定手動選擇、定期測試或依可用性切換。select 適合在首次連線時明確指定出口;url-test 會根據測試結果評估候選項目;fallback 則依設定順序選擇可用項目。測試目標、網路狀態與檢測間隔都會影響自動選擇,測試數值不等於實際下載速度。下方範例使用手動組連接既有代理,example-socks 必須先在 proxies 中定義;組名大小寫也必須與規則引用一致,否則設定無法依預期載入。
proxy-groups:
- name: PROXY
type: select
proxies:
- example-socks
- DIRECT
fake-ip 會為 DNS 查詢回傳合成位址,並由核心保留位址與網域的對應關係,讓後續請求仍可依網域比對規則。它不會永久將真實伺服器位址替換成另一個出口,最終連線仍取決於所選策略。設定時須一併考量 DNS 上游是否可連線、流量接管方式及本機應用程式的相容性;部分區域網路探索或自訂解析情境可能需要加入過濾規則。範例使用迴路位址作為監聽位址,僅用來說明本機解析入口,不應直接對外部網路開放。啟用這段設定後,也要確認系統或 TUN 確實將查詢交由核心處理。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 1.1.1.1
用戶端的設定訂閱通常會載入完整 YAML 檔,而 proxy-providers 用於載入可供策略組引用的代理清單,兩者不可不加判斷就互換。更新失敗時,先確認連結是否過期、回傳內容是否符合預期,再檢查下載請求的網路路徑。訂閱網址通常包含帳戶識別資訊,應視同憑證妥善保管;截圖、記錄檔與公開儲存庫都不應包含真實網址。下方以保留的範例網域展示更新間隔與本機快取路徑;服務提供者的內容必須符合 provider 格式,並由策略組透過 use 引用後才會參與選擇。
proxy-providers:
remote:
type: http
url: "https://subscription.example.com/proxies.yaml"
path: ./providers/remote.yaml
interval: 3600
CLIENT ENTRY POINTS
先選擇作業系統,再確認處理器架構。圖形用戶端負責管理設定與接管系統流量,核心則負責解析規則並轉送請求。請分別確認安裝套件是否能執行、TUN 需要哪些權限,以及設定格式是否相容;不能只憑用戶端名稱判斷。
可從 Clash Plus 等圖形用戶端開始使用。首次連線先確認系統代理是否正常,再依應用程式需求啟用 TUN;若遇到連接埠占用或服務權限提示,先處理本機環境,不要反覆更換訂閱。
前往下載依 Apple Silicon 或 Intel 選擇安裝套件。系統代理與網路延伸功能的授權位置不同,安裝後請依系統提示核對;從睡眠喚醒或切換網路後,應重新確認出口與 DNS 解析是否正常。
前往下載確認裝置架構與安裝權限,匯入訂閱後允許建立 VPN 連線。背景省電設定可能中斷服務;若鎖定螢幕後斷線,請檢查電池限制,以及是否有其他 VPN 應用程式占用流量接管功能。
前往下載透過下載頁前往 Clash Plus 的 App Store 頁面,官方網站為 clashplus.io。匯入前請確認設定格式相容,首次啟動時依系統提示授權 VPN,再驗證規則與出口。
前往下載桌面環境可選擇圖形用戶端;伺服器與路由器使用者則可查看核心下載入口。安裝前請確認發行版套件格式、處理器架構與服務執行身分,避免將桌面代理設定誤認為整台裝置的流量接管。
前往下載下載頁依平台列出用戶端、處理器架構與系統需求。若已在使用其他用戶端,遷移前先匯出設定,並記錄本機規則、覆寫項目與策略選擇。同一份訂閱在不同工具中可能經過不同的轉換流程,介面相似不代表設定處理方式完全相同。
Clash for Windows 停止更新後,舊安裝套件仍可能出現在教學截圖中。新部署建議優先評估仍在維護的方案,封存用戶端僅適用於明確的相容性需求。完成遷移後,請關閉舊工具的開機啟動與系統代理,避免兩個程序爭用連接埠或反覆修改系統設定。
FIRST CONNECTION
安裝好用戶端不代表流量已經經過代理。依照「載入設定 → 選擇策略 → 接管流量並驗證」的順序操作,有助於區分訂閱下載、節點連線與本機流量接管問題。以下畫面僅示意設定項目,實際選單名稱請以所用用戶端為準。
開啟設定或訂閱頁面,新增遠端設定並貼上現有連結。下載成功後選取該設定,確認策略組已出現;只儲存網址但未啟用設定,不會改變目前連線。
若開啟後顯示網頁、登入提示或空白內容,請先向訂閱服務提供者確認連結與帳戶狀態。不要將含有帳戶識別資訊的網址提交至公開轉換網站,也不要在公開討論區貼上訂閱內容。
初次使用請選擇 Rule 規則模式,並在實際被規則引用的策略組中指定節點後執行測試。延遲測試反映的是特定目標的探測結果,不等於所有網站的實際連線速度。
測試逾時不一定代表節點完全無法使用,也可能是測試目標或 DNS 解析路徑異常。請搭配實際網站連線與記錄檔判斷,先固定一個出口完成驗證,再考慮使用自動測試與回退策略。
先透過系統代理讓瀏覽器完成驗證;不遵循代理設定的應用程式,再視需要啟用 TUN。開啟目標網站後,在連線記錄中確認命中規則、策略組與最終出口是否一致。
驗證時請分別檢查瀏覽器、終端機與其他應用程式。終端機工具可能需要另外設定代理環境變數;IP 查詢也只反映該次查詢使用的出口,不能據此認定所有請求都走同一路徑。
SOURCE & MAINTENANCE
Clash Meta 是這個核心分支早期使用的名稱,目前核心專案以 mihomo 為名維護。搜尋結果、設定教學與部分用戶端名稱仍可能保留 Meta 字樣。判斷文件是否適用時,應確認實際執行的核心及其支援欄位,而不只是查看視窗標題;舊截圖中的按鈕名稱也可能已經變更。
mihomo 提供設定解析、協定處理、規則判斷與 DNS 等功能。圖形用戶端則另外提供訂閱管理、系統匣選單、系統代理與服務管理。用戶端更新和核心更新並非同一件事;若某個設定鍵無法辨識,應先查看實際核心資訊與載入記錄,再決定要更新哪一層。
公開儲存庫中的程式碼、授權條款、問題記錄與發布說明,是確認功能行為的重要依據。若教學與實際介面不一致,請回到對應專案的文件與發布記錄,確認設定項目是否改名、預設值是否調整,以及是否需要新的執行權限。本網站提供中文操作索引,不取代上游專案對功能範圍的說明。
代理核心與用戶端不等於代理服務。訂閱中的節點、線路狀態、流量額度與帳戶效期由服務提供者決定;下載新用戶端無法補足已失效的訂閱。一般所說的 Clash 代理服務訂閱,通常是服務商提供的設定入口;使用前仍須確認來源、協定支援與服務條款,不應將它誤認為核心專案本身提供的網路資源。
規則清單、地理位置資料與代理訂閱各有不同的更新週期。更新 Clash GeoIP 前,先確認設定使用的資料格式與檔案位置;更新訂閱時,則檢查節點清單與本機覆寫是否保留。將這些操作分開執行,發生錯誤時才容易還原到明確的已知狀態。
保留目前可用的設定、重要覆寫項目與啟動參數,閱讀變更說明後再更新。更新完成後,先確認能否啟動並載入 YAML,再測試 DNS、常用網站與需要接管的應用程式。若結果有差異,請保留已去除敏感資訊的錯誤內容;回報時說明作業系統、架構、用戶端與核心環境,不要附上真實訂閱網址、密碼或完整帳戶資料。
下載原始碼可用於閱讀實作與追蹤變更。clone 只會取得儲存庫內容,不會自動安裝用戶端;一般桌面使用者可直接透過下載頁取得安裝套件。
git clone https://github.com/MetaCubeX/mihomo.git
CONFIGURATION NOTES
完成基本設定後,再依實際症狀閱讀相關專題。系統代理未生效、規則比對錯誤與節點無法使用,分屬不同層次的問題;排查時先保留現況,找出請求在哪個環節偏離預期,再只調整相關設定。
從瀏覽器與終端機兩個方向找出系統代理失效原因:瀏覽器擴充功能接管、PAC 與連接埠衝突,以及終端機需要手動設定 http_proxy 環境變數等問題。
閱讀排查步驟 →透過實際 rules 片段說明規則比對順序、GEOSITE 與 GEOIP 的用途、rule-providers 引用方式,並設定中國大陸直連、境外流量走代理。
閱讀設定說明 →匯入訂閱後如何首次連線:在策略組中選擇節點、了解延遲測試結果的意義,再透過瀏覽器與 IP 查詢確認代理確實生效。
閱讀連線步驟 →