TRAFFIC / CONFIGURATION
先決定流量如何進入核心，再設定連線如何傳出。
系統代理會將作業系統的代理位址指向用戶端的本機監聽連接埠。瀏覽器等遵循系統設定的應用程式便會透過此連接埠進入核心，再依目前模式選擇出口。初次設定建議先採用這種方式：匯入訂閱、啟動核心，再開啟用戶端的系統代理。系統代理與 TUN 的差異在於接入範圍，而非節點速度；未遵循系統代理設定的應用程式仍可能直接連線。設定檔中的 mixed-port 可同時接收 HTTP 與 SOCKS 請求，但實際修改系統設定的是用戶端的開關。
mixed-port: 7890allow-lan: falsemode: rulelog-level: info# 由用戶端介面啟用系統代理TUN 透過虛擬網路介面與路由設定，讓未主動使用系統代理的應用程式也能連上核心。啟用前，先確認訂閱在一般代理模式下可正常使用，再授予用戶端所需的管理員或 VPN 權限。自動路由會將流量導入介面，DNS 劫持則用於接入指定的解析流程；兩者都需依本機網路環境確認設定。相較於系統代理，TUN 的接入範圍更廣，也較容易受到其他 VPN、虛擬網卡與路由軟體影響。發生衝突時應逐項排查，不要一次修改所有選項。
tun: enable: true stack: mixed auto-route: true auto-detect-interface: true dns-hijack: - any:53規則模式會依設定順序檢查連線目標，符合規則後交由對應策略處理。網域後綴、IP 網段與規則集可共同組成分流邏輯，最後再以預設規則處理其餘連線。與全域模式統一使用單一策略不同，規則模式可讓本機服務直連、指定網站走代理。新增自訂規則時，先確認策略名稱已存在，再將具體規則排在涵蓋範圍較廣的規則之前。範例中的 PROXY 是策略群組名稱，必須在完整設定檔中另行定義，不能將這段內容當成完整訂閱直接匯入。
mode: rule# PROXY 須在策略群組中定義rules: - DOMAIN-SUFFIX,github.com,PROXY - IP-CIDR,192.168.0.0/16,DIRECT - MATCH,PROXY訂閱連結可用來從設定來源取得節點或完整設定檔。初次使用時，通常是在用戶端的設定頁面貼上連結；下載完成後，選取並啟用對應設定檔。完整 YAML 可包含策略群組、規則與 DNS；節點提供者則只負責管理節點來源，仍須由主要設定檔引用。相較於只複製單一節點連結，完整訂閱更能保留既有分流設定。更新前建議先備份本機修改，並確認用戶端是否支援覆寫機制；直接編輯訂閱快取檔案，可能會在下次自動更新時被取代。
# 本機節點提供者片段proxy-providers: local-nodes: type: file path: ./providers/nodes.yaml# 策略群組透過 use 引用 local-nodesPACKAGES / PLATFORMS
先選擇作業系統，再確認處理器架構與安裝方式。下載用戶端與提供代理服務是兩回事，安裝完成後仍須準備可用的設定檔。
建議優先查看 Clash Plus，也可比較 Clash Verge Rev、FlClash 與 Clash Nyanpasu。安裝後先匯入設定檔，再啟用系統代理；需要使用 TUN 時，再設定服務與權限。若本機連接埠已被占用，先找出占用中的程序，避免一再重新安裝。
前往下載依 Apple Silicon 或 Intel 選擇安裝檔。Clash Plus、Clash Verge Rev 與 FlClash 提供不同介面；搜尋 ClashX Meta 時，請留意其封存狀態。初次啟動若出現系統安全性提示，先確認來源，再依系統指示完成授權。
前往下載可選擇 Clash Plus、Clash Meta for Android、FlClash 或 Surfboard，並確認訂閱格式與用戶端相容。初次連線時須核准 VPN 請求。若背景連線中斷，先檢查電池最佳化與背景執行限制，再確認訂閱是否已到期。
前往下載透過下載頁前往 Clash Plus 的 App Store 頁面，官方網站為 clashplus.io。匯入設定並允許新增 VPN 設定檔後，再選擇策略與節點。系統顯示 VPN 圖示只代表通道已建立，實際分流結果仍應查看請求紀錄。
前往下載桌面環境可從 Clash Verge Rev 與 FlClash 開始，依發行版選擇套件格式。伺服器與路由器環境可另行部署 mihomo 核心，設定設定檔目錄、服務權限與啟動方式；命令列部署不等於安裝桌面用戶端。
前往下載FIRST CONNECTION
依照「設定來源 → 接入方式 → 請求驗證」的順序操作，遇到問題時也照此順序逐步檢查。
前往下載頁選擇適用於作業系統的用戶端。開啟設定或訂閱頁面，貼上服務供應商提供的 Clash 相容訂閱網址；下載完成後，將其設為目前使用的設定檔。看到設定檔名稱不代表已啟用，還要確認節點清單與策略群組是否出現。
如果只取得單一節點連結或 Base64 文字，先確認用戶端是否支援匯入。若需要轉換，優先使用可信任的本機工具；訂閱網址可能與帳戶及流量資訊相關，請勿貼入來路不明的線上工具。
在策略群組中手動選擇可用節點，再將運作模式設為規則模式。桌面平台可先開啟系統代理，使用瀏覽器進行基本測試；確認連線正常後，再依需求啟用 TUN。行動平台則依系統提示核准 VPN 授權。
全域模式與 TUN 並非同一個開關。前者決定連線進入核心後如何選擇策略，後者決定流量如何進入核心。啟用全域模式，也不代表裝置上的所有應用程式都已由核心接管。
瀏覽要測試的網站，同時開啟用戶端的連線清單。檢查目標網域、命中規則、策略群組與最終節點，確認請求路徑符合預期。單次延遲測試只反映特定測試目標，不能代表下載速度或所有服務的連線品質。
若網頁無法開啟，先確認連線是否進入核心。若沒有紀錄，檢查系統代理、VPN 權限與路由；若已有紀錄但連線失敗，再檢查 DNS、節點連線狀態與規則目標。每次只調整一項設定，並保留可重現的檢查結果。
安裝檔不包含代理服務。用戶端負責讀取設定檔與處理連線，節點則由設定來源提供。訂閱下載成功，不代表其中每個節點目前都能使用；仍須依服務狀態與實際請求結果判斷。
連線成功不代表分流正確。本機裝置、公司網路與印表機服務通常需要保留直連路徑。啟用 TUN 後若這些服務異常，應優先檢查區域網路路由與排除項目，而不是直接將所有請求都交給代理節點。
本機修改必須能持續保存。訂閱更新可能會覆蓋手動編輯的內容。長期使用的自訂規則應放在用戶端支援的覆寫或合併機制中，並在更新後再次確認規則順序與策略群組名稱。各用戶端介面不同，請參照對應平台的文件。
OPEN SOURCE / RESPONSIBILITY
釐清介面、核心與設定來源的分工，才能正確判斷功能支援情況與問題所在。
Clash 生態系涵蓋核心、桌面介面、行動用戶端與設定工具。Clash Meta 是常見的歷史搜尋名稱，mihomo 則延續相關核心的發展方向。搜尋舊教學時可能會同時看到這兩個名稱；實際設定應以所使用核心的文件為準，不能只憑應用程式名稱推斷支援哪些協定與欄位。
ClashX 通常指 macOS 平台的用戶端，不代表所有平台都使用相同的應用程式。本網站依平台整理安裝檔下載入口與中文說明，方便辨別仍在維護的用戶端和已封存的專案。各專案的發布時程不同，介面相似也不代表核心行為完全一致。
mihomo 的公開儲存庫提供原始碼、授權條款、問題討論與版本發布資訊。開源協作的價值在於實作內容可供檢視，問題也能根據明確的設定與環境重現。此處列出的 GPL-3.0 是 mihomo 核心所採用的授權，不代表每個第三方用戶端或商店應用程式都使用相同授權；散布或修改前，請分別閱讀各專案的說明。
回報問題前，先記錄作業系統、用戶端名稱、核心資訊與觸發步驟。日誌僅保留重現問題所需的部分，並遮蔽訂閱網址、帳戶資訊、節點密碼及其他存取憑證。將「某個網站無法開啟」拆分為 DNS 解析失敗、連線失敗或規則選擇錯誤，通常比只描述最後的現象更容易找出原因。
用戶端通常負責匯入設定檔、更新訂閱、管理系統匣選單、設定系統代理及提供權限服務；核心則負責解析設定、執行規則、建立代理連線與處理網路請求。因此，介面上的開關沒有生效時，可能是系統授權問題，也可能是設定遭到覆寫，不能只檢查節點清單。
更換用戶端時，先匯出設定檔並記錄自訂項目。完整 YAML、單一節點連結與節點提供者是不同類型的內容；能匯入其中一種，不代表另外兩種也能直接使用。協定支援、TUN 網路堆疊與規則行為也須配合核心確認。
更新應用程式安裝檔、更新核心、重新整理訂閱與下載規則集，是四種不同操作。訂閱重新整理成功只代表取得遠端內容；應用程式仍可能使用舊設定，策略群組也可能保留先前的選擇。更新完成後應檢查目前啟用的項目，不要只看更新時間提示。
遇到相容性問題時，先備份，再比較更新前後的設定差異。不要同時更換用戶端、節點、DNS 與規則，否則難以判斷是哪項變更解決了問題。需要長期運作的環境，建議保留可還原的設定副本，並在本機記錄重要修改。
NOTES / FIELD GUIDES
從連接埠、訂閱格式到 Linux 部署，依問題查看對應操作說明。
Clash 啟動時若提示連接埠被占用，可使用 netstat、lsof 等命令找出占用中的程序，再修改 mixed-port 與 external-controller 連接埠，並同步更新系統代理設定。
閱讀文章 →整理常見訂閱格式的結構差異，說明 Clash 為何需要 YAML 設定檔，並介紹如何透過訂閱轉換，將 Base64 節點連結轉為可直接匯入的完整設定檔，以及轉換時的注意事項。
閱讀文章 →介紹在 Linux 執行 Clash 的兩種方式：安裝具備圖形介面的桌面用戶端；或在伺服器、無桌面環境中部署 mihomo 執行檔、撰寫 systemd 服務並連接 Web 面板。
閱讀文章 →