匯入訂閱連結
打開客戶端的設定頁，把訂閱位址貼進輸入框，點擊下載。清單中出現新項目後選取它，客戶端會重新載入設定並啟動內核。如果清單一直是空的，先在瀏覽器裡打開訂閱位址，確認它能直接回傳內容，再回來看客戶端日誌裡的錯誤類型。
PLATFORM
依平台取得 Clash 客戶端
五個平台各自有對應的 GUI 客戶端，安裝檔、系統需求與內核區封存檔都在下載頁依平台分區列出。點選下方卡片可直接跳到對應分區，也可以先看選型指南再決定裝哪一個。
-
Windows
Clash Plus、Clash Verge Rev、FlClash 等客戶端，支援系統代理與 TUN 模式接管，適配 Windows 10 1809 以上的 x64 與 ARM64 裝置。
前往下載 -
macOS
提供 Apple Silicon 與 Intel 兩套安裝檔，常駐於選單列，可開啟增強模式接管不讀系統代理的命令列工具與開發環境。
前往下載 -
Android
手機與平板通用的 APK 安裝檔，支援分應用程式代理與 VPN 模式，依裝置 CPU 架構選擇 ARM64 或 ARMv7 版本即可。
前往下載 -
iOS
Clash Plus 已上架 App Store，從商店頁直接安裝，支援隨需連線與捷徑連動，官網網址為 clashplus.io。
前往下載 -
Linux
提供 .deb 與 .rpm 兩種套件格式，涵蓋主流桌面發行版；伺服器與路由器場景可改用內核區的壓縮檔，依架構選擇對應版本。
前往下載
CORE FEATURES
內核能力與設定項說明
mihomo 內核的行為由 config.yaml 決定，以下六項是日常使用中改動最多、也最容易設定錯誤的部分，每項都給出對應的設定鍵與取值方式。
以虛擬網卡接管不讀系統代理的流量
內核級TUN 模式會在系統中建立一張虛擬網卡，把不遵循系統代理設定的流量一併接管，適合遊戲客戶端、終端機命令列工具、容器環境這類場景。開啟後內核直接處理三層流量，搭配 auto-route 與 auto-detect-interface 讓路由表自動指向虛擬網卡，不必手動改閘道。相較於只改系統代理的方式，TUN 涵蓋範圍更完整，代價是需要管理員或 root 權限，Windows 上還得先裝好 Wintun 驅動程式。
tun:
enable: true
stack: system
auto-route: true
auto-detect-interface: true
rules 段由上而下匹配，命中即停
路由核心rules 段決定每個連線要走直連還是走代理，匹配順序嚴格由上而下、命中即停。把 DOMAIN-SUFFIX 放在前面，可以讓整段網域後綴一次歸類；IP-CIDR 處理純 IP 請求，GEOIP 涵蓋中國大陸網段，最後用 MATCH 收尾。規則順序寫反，會出現本該直連的流量繞一圈代理，或內部網路位址被誤轉發。改完規則把日誌等級調到 debug，觀察命中了哪一條，比反覆試設定快得多。
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
- GEOIP,CN,DIRECT
- MATCH,PROXY
把真實解析延後到連線建立時
DNSFake-IP 模式先給網域回傳一個 198.18.0.0/16 網段內的假位址，真實解析延後到連線建立那一刻，由內核依規則決定用哪個 DNS 去查。這樣省掉一次完整的 DNS 往返，首次存取的等待明顯縮短，也繞開了本機 DNS 被污染導致的解析錯誤。代價是部分依賴真實 IP 的程式拿不到位址，用 fake-ip-filter 把區域網路網域、NTP、STUN 這類條目排除即可。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver: 223.5.5.5
節點清單與規則設定解耦
設定訂閱連結透過 proxy-providers 引入，內核依 interval 指定的週期自動拉取最新節點清單，不用手動重新匯入。相較於把節點直接寫進 config.yaml，provider 方式讓節點更新與規則設定解耦：規則檔不動，節點清單跟著訂閱走。多個訂閱可以並存，在 proxy-groups 裡用 use 欄位按需引用，也能用 filter 只取符合關鍵字的節點。拉取失敗時保留上一份可用清單，不影響正在進行的連線。
proxy-providers:
main:
type: http
interval: 3600
url: "https://example.com/sub?token=xxxx"
同一個連接埠同時接收 HTTP 與 SOCKS5
入站mixed-port 讓 HTTP 與 SOCKS5 共用同一個連接埠，瀏覽器、終端機工具、編輯器外掛都指向 7890 即可，不用分別記兩個埠號。預設只監聽 127.0.0.1，區域網路內其他裝置想借用需要開啟 allow-lan 並把 bind-address 設成具體網卡位址，同時用 authentication 加一組帳號密碼，避免連接埠被同網段裝置隨意使用。連接埠被占用時日誌會直接回報 listen error，換一個閒置連接埠即可。
mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
authentication:
- "user:pass"
把節點組織成有意義的群組
策略proxy-groups 把一批節點組織成有意義的群組：url-test 依延遲自動挑選最快的節點，fallback 在主節點不可用時依序降級，select 交給使用者手動決定，load-balance 把請求分散到多個出口。群組名稱會被 rules 段直接引用，所以命名要穩定，改名等於改路由。搭配 health-check 的 interval 與 tolerance，可以控制測速頻率與切換靈敏度，避免網路抖動時來回跳群組。
proxy-groups:
- name: 自動選擇
type: url-test
interval: 300
url: http://www.gstatic.com/generate_204
QUICKSTART
三步完成首次設定
從安裝到能正常上網，中間只有三個動作。每一步在客戶端介面裡都有對應入口，分平台的詳細說明放在教學頁。
選擇代理模式
日常使用選規則模式，中國大陸網域與 IP 直連、其餘流量依 rules 段走代理；需要排查某個網站是否被規則誤判時，暫時切到全域模式讓所有流量都經過代理，驗證完再切回來。全域模式下所有請求都走代理，長時間掛著會明顯增加流量消耗。
開啟系統代理或 TUN
在設定裡開啟系統代理，瀏覽器這類遵循系統代理的程式立刻生效；命令列工具、遊戲客戶端這類不讀系統代理的程式，需要開啟 TUN 模式才能被接管。開啟後造訪任意網站確認連線正常，再回到連線頁看命中的規則與出口節點，確認分流符合預期。
OPEN SOURCE
開源內核與社群維護
客戶端介面與代理內核是兩層獨立的專案，理解這層關係，遇到問題時就知道該去查哪一邊的日誌。
專案沿革
Clash 內核以 Go 語言撰寫，早期定位是規則驅動的本機代理程式，設定集中在一個 YAML 檔案裡，這個設計沿用至今。原作者封存專案後，社群在 Clash Meta 分支上繼續演進，形成現在的 mihomo 內核，新協定支援與 DNS 實作都在這個分支上更新。
生態分工
內核與主流 GUI 客戶端都以開源授權發布，程式碼託管在公開倉庫。規則集、訂閱轉換工具、Web 控制面板由不同團隊分別維護，彼此透過標準的 config.yaml 與 RESTful API 對接，任何一方都可以獨立發布新版本，不必等待其他專案同步節奏。
內核與介面的關係
GUI 客戶端本身不實作代理協定，它負責設定編輯、節點顯示與開關控制，實際連線由 mihomo 內核建立。同一份 config.yaml 放到另一個客戶端裡，行為基本一致；反過來說，介面卡住時內核往往還在正常運作，排查問題看內核日誌比看介面準確。
更新機制
內核與客戶端版本各自獨立演進，部分客戶端允許替換內建的內核版本，升級內核不必重裝整個應用程式。規則集與 GeoIP 資料透過 provider 依週期拉取，不隨安裝檔發布，所以規則庫的時效性取決於設定裡的更新間隔，把它設短一些可以更快拿到新規則。
複製 mihomo 內核原始碼
git clone https://github.com/MetaCubeX/mihomo.git
FAQ
常見問題精選
以下四條是初次設定階段出現頻率最高的問題，展開可以看到原因與處理順序，更多條目在教學頁裡依平台分類列出。
訂閱匯入後節點清單是空的怎麼辦？
先在瀏覽器裡打開訂閱位址，確認它能直接回傳內容；瀏覽器也打不開，代表連結已過期或目前網路不通。能打開但客戶端拉取失敗，看日誌裡的錯誤類型：憑證驗證失敗可以改用 HTTP 位址或更新系統根憑證；回傳內容無法解析，則要確認這份訂閱是不是 Clash 格式。
開了系統代理，瀏覽器能上網但終端機指令不行？
終端機工具多數不讀系統代理設定，只認 http_proxy 與 https_proxy 兩個環境變數。先在 shell 裡暫時匯出這兩個變數指向 127.0.0.1:7890 驗證，確認可用後寫進 shell 設定檔；長期方案是開啟 TUN 模式，讓內核直接接管命令列流量，不必逐一設定每個工具。
規則模式下某個網站走了代理，想讓它直連要怎麼改？
在 rules 段靠前的位置插入一條 DOMAIN-SUFFIX 指向 DIRECT 的規則，位置必須在既有的同類規則之前，否則會被前面的規則先命中。改完重新載入設定，到連線頁確認這條連線命中的是新規則；如果仍然走代理，檢查是否被 IP-CIDR 或 GEOIP 規則提前匹配走了。
連接埠被占用導致啟動失敗，日誌回報 listen error？
代表 mixed-port 指定的連接埠已被其他程式占用。先用系統指令查出占用行程並結束它，或者直接把連接埠改成 7891 這類閒置值，改完重啟內核。切換連接埠後記得同步更新瀏覽器外掛與終端機的代理設定，否則它們還在連舊連接埠，會出現內核明明啟動了卻上不了網的情況。
NOTES
技術筆記
設定過程中的細節問題與排查過程記錄，依發布時間倒序排列，完整清單在筆記封存頁。
Clash 自訂規則語法與優先順序：DOMAIN-SUFFIX、IP-CIDR 與 MATCH 的匹配順序
逐條拆解 rules 段的寫法與匹配順序：從 DOMAIN、DOMAIN-SUFFIX、IP-CIDR 到 GEOIP 與 MATCH 兜底，講清楚由上而下短路匹配的機制與常見寫錯方式。
閱讀全文 →Clash 多裝置設定同步：訂閱連結、託管設定與手動匯出三種方案
手機、電腦、平板之間如何讓設定保持一致：比較訂閱連結自動同步、自建設定託管與手動匯出匯入三種方案的適用場景、維護成本與衝突處理方式。
閱讀全文 →Clash 節點逾時無法連線：依序排查的七個環節
節點逾時往往不是節點本身的問題。依訂閱更新、DNS 解析、連接埠占用、系統代理、規則命中、內核日誌、網路環境七個環節依次排查，快速定位真正原因。
閱讀全文 →