CLIENTS / 平台選擇
先確認作業系統與處理器架構，再選擇用戶端。圖形介面負責管理設定，核心負責處理連線；設定欄位相同，不代表各用戶端的選項位置也相同。
可從 Clash Plus 開始挑選，也能比較 Clash Verge Rev、FlClash 與 Clash Nyanpasu 的介面和服務模式。安裝前請到系統設定查看處理器型號，別只憑檔案圖示判斷安裝套件是否適用。
首次連線先使用系統代理，確認瀏覽器請求出現在連線記錄後，再視需要啟用 TUN。從舊用戶端轉換時，請先結束原程式並關閉原有代理設定，以免連接埠遭占用，或兩個服務同時修改路由。Clash for Windows 已停止維護，封存下載入口供舊環境參考。
前往下載 Windows 用戶端請依 Apple Silicon 或 Intel 選擇安裝套件。Clash Plus、Clash Verge Rev 與 FlClash 的設定管理方式各有不同；是否需要背景服務，應依系統代理、TUN 權限與開機啟動需求判斷。
先將用戶端移至「應用程式」資料夾，再完成首次啟動與系統授權。連線異常時，先檢查目前網路服務中的代理位址與連接埠是否對應正在執行的用戶端。切換 Wi-Fi 網路後也要重新確認，不能只看選單列圖示就認定流量已由用戶端接管。ClashX Meta 的封存狀態會在下載頁另外標示。
前往下載 macOS 用戶端可比較 Clash Plus、Clash Meta for Android、FlClash 與 Surfboard。安裝套件架構須符合裝置規格；也要先確認訂閱格式，不能因為同為代理用戶端，就把其他格式的設定直接當成 Clash YAML 匯入。
首次啟動連線時，系統會要求授權建立 VPN 連線。若切換至背景後就中斷，請檢查電池最佳化與背景執行限制，再查看用戶端記錄。若已有其他 VPN App 正在執行，先確認由哪個 App 接管連線；反覆切換兩個 App，測試結果就難以比較。
前往下載 Android 用戶端下載頁提供 Clash Plus 的 App Store 連結，並列出官方網站 clashplus.io。安裝前請查看商店頁面的系統需求；匯入前確認訂閱提供的設定類型符合用戶端支援範圍。
新增設定後，依系統提示允許建立 VPN 設定，再回到用戶端選取目前使用的訂閱與連線出口。請分別測試 Wi-Fi 與行動網路：若其中一種網路連線異常，記下網路環境、解析結果與連線記錄，再判斷是否需要調整 DNS。系統出現 VPN 圖示，只代表通道已啟用，仍須檢查規則是否命中及目標網站能否連線。
前往下載 iOS 用戶端桌面使用者可選擇 Clash Verge Rev 或 FlClash，並依 Linux 發行版的套件格式安裝。伺服器與路由器使用者可前往下載頁的 mihomo 核心區，先確認處理器架構、執行權限與設定目錄，再安排啟動服務。
桌面環境的系統代理不一定涵蓋命令列工具。終端機程式須檢查自身的代理參數或環境變數；使用 TUN 則須確認權限與路由。部署為系統服務時，應明確指定設定路徑，並保留可讀取的記錄；不要假設服務程序和目前終端機使用相同的工作目錄與使用者權限。
前往下載 Linux 用戶端CONFIGURATION / 設定功能
依照問題選擇設定，不要一次開啟所有選項。以下片段用來說明欄位關係，不含可用的代理伺服器；實際使用時，須加入自己的訂閱或連線出口資訊。
mode: rule
rules:
- DOMAIN-SUFFIX,example.org,PROXY
- MATCH,DIRECTmode: global
GLOBAL
→ 選取的連線出口mode: direct
DIRECT
→ 目標位址規則模式會依清單順序比對網域、位址或規則集，命中後交由指定的連線出口處理；清單末尾的 MATCH 則接手其餘連線。需要暫時比對代理路徑時，可切換至全域模式，並確認 GLOBAL 中實際選用的連線出口。直連模式可用來比較本地網路，並不等於關閉用戶端。相較於只提供單一代理位址的工具，Clash 的分流依據可直接從設定檔檢查。排查時先確認命中項目，再調整規則順序，避免將連線出口故障誤判為規則失效。
TUN 透過虛擬網路介面接收流量，適合不讀取系統代理設定的 App。啟用前，請先確認訂閱與連線出口可用，再確認用戶端具備所需的服務或管理員權限。相較於系統代理，TUN 接管的範圍更廣，也更受路由、DNS 與防火牆設定影響。範例使用自動路由與 DNS 劫持，但各平台的實作方式不一定相同。啟用後若無法連線區域網路，先檢查路由衝突與排除規則，不要重複啟用多個流量接管服務。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53訂閱可用來更新伺服器資訊或完整設定；匯入後還須選取並啟用，下載成功不代表已完成連線。完整設定訂閱與 proxy-providers 代理集合屬於不同層級，匯入時應選擇符合內容類型的入口。相較於直接修改遠端檔案，本機覆寫適合保留連接埠與自訂規則，也能降低下次更新覆蓋設定的風險。更新失敗時，請分別記錄請求錯誤與設定解析錯誤，再檢查網路路徑和 YAML 語法；切勿公開含有存取憑證的訂閱連結。
proxy-providers:
remote:
type: http
url: "https://example.org/proxies.yaml"
path: ./providers/remote.yaml
interval: 3600
proxy-groups:
- name: PROXY
type: select
use:
- remoteexample.org 僅用來說明欄位位置，不可作為實際訂閱來源。
DNS 負責解析網域名稱，規則則決定連線交由哪個出口處理，兩者須搭配使用。fake-ip 會使用保留位址建立網域對應，方便核心關聯後續連線；nameserver-policy 則可指定特定網域使用哪個解析器。相較於只修改系統 DNS，核心 DNS 能配合流量接管路徑處理解析請求，但仍須另外檢查 App 內建的加密 DNS。修改後請重新建立連線並查看解析記錄，必要時清除快取。解析成功不代表代理出口連線正常，兩者應分開驗證。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-query
nameserver-policy:
"+.example.org":
- https://dns.alidns.com/dns-queryClash 生態系沿用相近的 YAML 結構，但不同核心支援的通訊協定與欄位並不完全相同。mihomo 延續 Clash 風格的設定格式，並擴充部分通訊協定與規則功能；舊版核心遇到新欄位時，可能拒絕載入，也可能無法如預期運作。轉換時除了比較用戶端介面，也要確認核心名稱、設定語法與功能支援情況。若用戶端提供核心切換選項，請先備份設定再切換。範例僅使用基本欄位，轉換後仍須逐項驗證 DNS、出口群組與最終規則。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
- GEOIP,CN,DIRECT
- MATCH,DIRECT同一套出口群組與規則可作為多台裝置設定的基礎，但系統權限、檔案路徑與流量接管方式仍須分別處理。桌面系統通常從系統代理開始；行動裝置多透過系統 VPN 介面連線；伺服器則適合明確設定服務。相較於直接複製整份檔案，分開維護通用規則與裝置專屬設定，更容易保留連接埠與接管方式的差異。轉移後先確認出口群組引用有效，再驗證解析與連線；桌面可用的絕對路徑不能直接套用到手機。
# 各裝置分別確認本機連接埠
mixed-port: 7890
allow-lan: false
# 可共用維護的規則結構
rules:
- DOMAIN-SUFFIX,example.org,DIRECT
- GEOIP,CN,DIRECT
- MATCH,PROXY先讓請求進入用戶端，再確認網域解析、規則命中與連線出口。設定畫布中的 PROXY 是群組名稱，不是安裝套件內附的代理服務。
QUICKSTART / 三步檢查
首次設定時，先建立一條可驗證的連線路徑。每完成一步再進行下一步，發生錯誤時就能判斷問題出在匯入、流量接管還是連線出口。
在用戶端的訂閱或設定頁面新增連結，也可匯入本機 YAML。儲存後檢查解析結果，確認出現預期的出口群組，再將該設定設為目前使用項目。訂閱項目出現在清單中，不代表核心已載入設定。
若匯入失敗，先確認錯誤是網路請求還是設定語法造成。網頁說明網址不能當作訂閱內容；欄位縮排錯誤則須回到檔案中修正。初次使用時請保留原始設定副本，自訂內容優先透過用戶端支援的覆寫功能新增，方便日後區分遠端更新與本機修改。
日常使用可從規則模式開始，並在實際使用的選擇群組中指定連線出口。桌面端先啟用系統代理並確認監聽連接埠；行動裝置則依系統提示允許建立 VPN 連線。若要涵蓋不遵循系統代理設定的程式，再查看對應平台的 TUN 設定方式。
全域模式只會改變已進入核心的連線如何選擇出口，無法讓尚未接管的程式自動經過用戶端。切換模式後，請重新送出請求並查看記錄。若要驗證差異，請維持目標位址與網路環境不變，每次只調整一個變數，以免將偶發的網路波動誤認為設定效果。
開啟要測試的目標位址，在連線記錄中搜尋對應網域，確認命中的規則與最終出口。接著再測試一個預期直連的位址，確認規則是否依序執行。分別測試 App 與瀏覽器，可找出代理設定只套用於部分程式的情況。
若沒有連線記錄，優先檢查系統代理、App 設定或 TUN 接管；若有記錄但連線失敗，則繼續檢查解析、出口可用性與遠端回應。停止使用時，先關閉用戶端的接管選項再結束程式，以免系統仍保留指向本機連接埠的代理設定。完整操作流程與復原步驟請參閱教學。
SOURCE / 開源生態系
用戶端名稱、核心名稱與訂閱服務應分開理解。判斷功能是否可用，應以專案文件、實際使用的核心與本機記錄為準，不要只看軟體名稱是否包含 Clash。
Clash 最初以規則式代理核心建立設定生態系，後來出現面向不同桌面與行動系統的圖形化用戶端。原始 Clash 專案及部分早期用戶端已停止維護；如今名稱相近的用戶端，維護狀態不一定相同。舊教學中的按鈕位置、服務安裝方式與通訊協定支援，不能直接套用到所有新用戶端。
挑選時先確認專案是否仍有版本發布，再核對系統需求與設定支援情況。即使程式能在舊環境執行，也可能無法辨識新訂閱欄位。轉換前保留設定、群組選擇與本機規則，轉換後重新驗證連線；成功啟動不代表設定已完成。
mihomo 是 Clash 生態系中持續發展的核心專案，負責解析設定、比對規則與建立連線出口。圖形化用戶端則負責管理訂閱清單、系統代理開關、服務安裝與記錄介面。即使兩個用戶端使用相同核心，核心設定能力可能相近，本機覆寫、權限處理與系統整合仍可能不同。
因此，介面中是否出現某個開關，不代表核心一定支援對應欄位。若說明文件與介面不一致，請先在用戶端資訊頁確認核心，再查閱相應文件。下載頁介紹用戶端選擇，完整文件則進一步區分安裝流程與核心設定，方便依實際環境查找。
mihomo 採用 GPL-3.0 授權，程式碼、問題討論與版本說明可在專案儲存庫查閱。此授權適用於該專案本身，不能據此推定所有圖形化用戶端、訂閱服務或附加元件也採用相同授權。若要散布或修改軟體，請閱讀對應專案的授權檔案與相依性說明。
查看原始碼與問題記錄，有助於確認欄位行為、平台限制與已知問題。本網站不提供未經確認的下載量、使用者評分或連線效果統計。開源程式碼提供可檢視的實作依據，但網路表現仍受本機環境、目標服務與所選出口影響，不能以專案熱門程度取代實際測試。
用戶端更新、核心更新與訂閱更新是三種不同操作。用戶端更新可能改變介面與系統服務；核心更新可能改變欄位支援與連線行為；訂閱更新則主要更換伺服器、規則或設定內容。發生異常時，先記錄是哪一層有所變動，再決定是否還原設定或查閱版本說明。
更新前匯出本機覆寫與自訂規則，並記下連接埠與接管方式。更新後先確認設定能否載入，再檢查代理群組引用、DNS 與路由。若只更新訂閱後才出現問題，應優先比對訂閱內容，不要立即重新安裝用戶端。分層記錄變更內容，能減少重複排查。
安裝 Clash 用戶端不會自動取得代理伺服器。可用的連線出口來自自行部署的服務或既有訂閱，用戶端只會依設定處理連線。訂閱中的位址、存取憑證與帳戶資訊都應妥善保密；分享排查資料時，保留錯誤類型與必要欄位，並移除可用來存取服務的資訊。也請勿將完整訂閱提交至公開儲存庫。
本頁的編輯視窗僅示範欄位結構，選擇群組中的 DIRECT 代表直連，不表示已設定代理線路。遇到不熟悉的術語，可先閱讀術語手冊中的核心、出口群組與網路模式說明，再前往用戶端比較查看各用戶端差異。若要處理特定平台的權限與服務問題，請依作業系統查閱完整文件。
以下指令會複製專案儲存庫，適合閱讀原始碼與文件；一般安裝使用者直接選擇用戶端即可。建置原始碼還需要專案文件指定的工具鏈與環境。
git clone https://github.com/MetaCubeX/mihomo.gitNOTES / 最新文章
依實際環境記錄操作流程。疑難排解文章會沿著連線路徑逐步檢查，先確認問題發生在哪一層，再調整設定；修改前後的測試應使用相同網路與目標位址。
從選擇安裝套件、匯入訂閱，到啟用系統代理與 TUN 服務模式，逐步說明 Windows 完整設定流程，並整理連接埠占用、服務安裝失敗等常見錯誤。
閱讀安裝指南 →先用檢測頁確認解析請求實際流向，再透過 fake-ip、nameserver-policy 與 TUN 劫持 DNS 三個步驟縮小範圍，並附上可直接參照修改的 dns 區段範例。
閱讀 DNS 設定 →依序檢查節點品質、中轉線路與本機設定：切換節點比較、觀察出口路徑、檢查 TUN 堆疊與 DNS 設定，找出網速瓶頸所在環節。
閱讀排查步驟 →查閱時先區分「無法連線」與「連線速度較慢」：前者應優先確認請求是否進入核心；後者則須維持測試條件一致。欄位完整說明與各平台的復原方式，請參閱設定常見問題。