Windows
可先從 Clash Plus、Clash Verge Rev 等圖形介面用戶端開始。安裝前請在系統設定確認裝置架構；啟動後先匯入設定，再開啟系統代理測試瀏覽器連線。若要接管遊戲、命令列或其他不讀取代理設定的應用程式，再確認服務模式與 TUN 權限。
若 App Store 應用程式出現個別異常，請檢查 UWP 迴圈存取限制。切換用戶端前先結束舊程式，避免兩個程序同時修改系統代理或搶用監聽連接埠。
前往下載Clash 全平台下載
先確認作業系統與處理器架構，再選擇用戶端。安裝套件提供操作介面和執行環境；要建立連線，還需要可用的訂閱或設定檔。若已有設定，請先確認其中的協定、策略群組與規則受目標用戶端支援，不要只憑軟體名稱判斷相容性。
macOS
依「關於這台 Mac」顯示的晶片，選擇 Apple Silicon 或 Intel 對應的安裝套件。圖形介面用戶端可管理訂閱、策略群組與選單列開關；可先用系統代理測試網頁連線。TUN 需要額外的網路接管權限，請依用戶端提示完成授權。
若終端機的請求結果與瀏覽器不同，請先檢查終端機的代理環境變數。開啟系統代理不代表每個命令列工具都會自動使用相同的連線出口。
前往下載Android
可選用 Clash Plus、Clash Meta for Android、FlClash 等用戶端。多數較新的手機採用 ARM64，但仍建議依裝置資訊確認。匯入訂閱並選取設定後，首次啟動通常會要求允許系統 VPN 連線；這項授權用於建立本機流量接管通道。
若背景執行時斷線，先檢查電池最佳化與背景執行限制。依應用程式分流時，請核對應用程式清單，並確認是否有其他 VPN 應用程式正在占用系統連線。
前往下載iOS
從下載頁前往 Clash Plus 的 App Store 頁面，也可查閱官方網站 clashplus.io。安裝後匯入相容的訂閱，確認已選取設定，再依系統提示允許新增 VPN 設定，接著啟動連線並測試目標應用程式。
訂閱能否下載，與其中的代理能否連線是兩回事。匯入失敗時先檢查連結和格式；連線建立後若只有部分網站異常，再檢查規則、DNS 與出口服務狀態。
前往下載Linux
桌面環境可選用 Clash Verge Rev 或 FlClash，安裝時請依發行版選擇 DEB、RPM 等套件格式。伺服器、容器或路由器使用者也可直接部署 mihomo 核心，透過設定檔與服務管理工具控制執行。命令列部署需要自行處理設定目錄、檔案權限、日誌與開機啟動，並非圖形用戶端的一鍵開關。
首次執行時，先在前景確認設定能否載入，並確認監聽位址後再交由 systemd 管理。遠端主機啟用 TUN 或修改預設路由前，請保留獨立的管理連線，避免代理路由影響 SSH 工作階段。一般桌面使用者先採用圖形介面用戶端，通常更容易找出設定問題。
前往下載規則、策略群組與流量接管
設定檔用來描述連線目的地，用戶端則負責管理與套用設定。以下片段用於說明欄位關係，並非可直接連線的完整訂閱。範例中的 PROXY 是策略群組名稱，必須與實際設定中的定義一致；TUN 與 DNS 參數也需依執行平台調整。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY規則分流
rules 會由上而下比對，第一條符合的規則會決定連線去向。網域後綴規則適用於明確的網站範圍；GEOIP 可依目標 IP 位址的地區分流；MATCH 放在最後，用來處理其餘連線。PROXY 必須對應已定義的代理或策略群組。相較於全域模式，規則模式可讓不同請求使用不同出口。調整前先確認應用程式流量已進入核心，再從連線記錄核對命中規則；若完全沒有請求記錄，應先排查系統代理或 TUN，而不是繼續新增規則。
查看設定欄位與規則 →proxy-groups:
- name: PROXY
type: select
proxies:
- AUTO
- DIRECT
- name: AUTO
type: url-test
use:
- provider-main
url: https://www.gstatic.com/generate_204
interval: 300選擇策略群組
proxy-groups 可將規則目標與實際代理分開設定。select 可供手動選擇；url-test 則依指定測試網址的結果選擇可用出口。範例中的 provider-main 必須另行定義於 proxy-providers，不能只複製這段就啟動。相較於逐條修改規則，策略群組能維持規則名稱不變，只需替換群組內的選擇。測試結果僅代表連至測試目標時的狀況，不等於所有網站的使用體驗，也不包含流量倍率、帳戶額度或目標服務的地區限制。
了解節點與策略群組的取捨 →tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53TUN 模式
TUN 透過虛擬網路介面接管路由至該介面的流量，適合不讀取系統代理設定的應用程式。auto-route 與介面識別會影響路由，設定必須符合系統權限與用戶端實作方式。相較於系統代理，TUN 通常能接管更廣的流量，但也更受 DNS、路由和其他 VPN 狀態影響。建議先用系統代理確認訂閱可用，再啟用 TUN，並檢查日誌中的介面卡與路由資訊。若遠端連線或區域網路存取受影響，請先檢查路由排除設定，而非直接切換成全域模式。
比較 TUN 與系統代理原理 →訂閱連結
↓ 在用戶端的「設定檔」新增遠端設定
取得並解析 YAML
↓ 選取設定，檢查載入日誌
查看策略群組
↓ 啟用系統代理或平台 VPN
測試目標請求與命中規則匯入訂閱
訂閱連結用來取得設定，安裝用戶端本身不會提供可用代理。通常可在設定頁新增遠端設定，貼上連結並下載，接著選取設定並查看策略群組。相較於手動編輯本機 YAML，遠端設定較容易同步服務提供者的變更；但直接修改下載內容，可能會在下次更新時被覆寫。需要長期保留的規則，應使用用戶端支援的覆寫機制。訂閱連結可能包含帳戶存取憑證，請妥善保管；更新失敗時先檢查連結有效性、網路連線與格式，再考慮轉換，避免將敏感連結交給不熟悉的轉換服務。
依步驟匯入訂閱 →開放原始碼背景與核心關係
區分用戶端、核心與設定來源，才能判斷更新影響哪個層面。Clash指南整理下載入口與中文設定說明，不取代各用戶端的專案公告，也不提供代理訂閱服務。專案狀態、功能範圍與授權條款，請以各專案公開資料為準。
Clash 與 mihomo 的關係
Clash 最初以規則驅動的代理核心建立設定生態系。原始專案停止公開維護後，社群發展出不同的核心與用戶端路線。mihomo 延續 Clash Meta 的開發方向，提供代理協定處理、規則比對、DNS 與流量接管等功能。名稱相似不代表由同一團隊維護，也不代表所有設定欄位都能在不同實作之間直接通用。
圖形介面用戶端通常會將核心封裝在介面後方，負責設定管理、訂閱更新、系統代理開關與日誌顯示。遇到協定不支援、欄位無法辨識或執行異常時，應同時記錄用戶端名稱與實際使用的核心資訊。只說「Clash 無法連線」通常不足以重現問題；同一份設定在不同核心上的行為也可能不同。
分辨核心與用戶端術語 →公開程式碼與問題排查
mihomo 的原始碼、授權條款、發布說明與問題討論，可在公開程式碼儲存庫中查閱。公開程式碼讓欄位實作與行為變更有跡可循，但不能取代本機設定檢查。提交問題前請先閱讀既有討論，並說明作業系統、啟動方式、錯誤步驟與必要日誌，避免只附上一張開關畫面截圖。
日誌和設定可能包含訂閱網址、代理驗證資訊與瀏覽記錄。分享前請刪除帳戶資訊，只保留能重現問題所需的最小設定。排查時可將故障拆分為設定解析、連接埠監聽、流量接管、規則選擇與目標連線等階段。先找出失敗階段，再查閱相關實作或提交回報，比一次修改多個參數更容易得到可靠結論。
查看 mihomo 開放原始碼儲存庫 ↗取得 mihomo 原始碼
執行命令前，本機需先安裝 Git。複製下來的是原始碼，不是圖形用戶端安裝套件；一般安裝請前往下載頁。
git clone https://github.com/MetaCubeX/mihomo.git用戶端更新與訂閱更新
用戶端更新會變更介面、系統整合或核心元件；訂閱更新則會重新取得設定內容，兩者是獨立操作。訂閱更新成功不代表軟體本身已更新；更換安裝套件也不會自動修復過期訂閱。升級前請保留正常運作的設定與必要覆寫規則；升級後先查看載入日誌，再測試系統代理與 TUN 的實際運作情況。
遠端設定中的規則、代理群組與提供者可能由服務提供者管理，直接編輯下載的檔案容易在重新整理後遺失。若要新增自訂規則，請先確認用戶端支援哪些覆寫或合併機制，並檢查最後生效的設定。自動更新間隔應依服務提供者的說明設定，不應以頻繁請求來嘗試修復失效的訂閱。
查看訂閱更新排查順序 →從基本檢查到平台故障排除
首次設定時，建議只執行一個用戶端。匯入後先確認設定能正常解析，再確認本機連接埠已開始監聽。接著啟用系統代理或平台提供的 VPN 流量接管功能，連線至目標網址並查看連線記錄。若瀏覽器可用、其他應用程式卻無法連線，請優先確認該應用程式是否遵循系統代理設定，不要立刻認定代理伺服器失效。
若只有啟用 TUN 時才出錯，請優先檢查權限、DNS 與路由；若所有模式都失敗，再檢查訂閱狀態與代理連線能力。每次只修改一項設定，並記錄修改前後的日誌差異。需要重設設定時，請先匯出備份，避免一併清除可重現的故障現場與原有規則。完整文件依平台整理了安裝、授權與常見衝突的排查流程。
查看全平台安裝與設定文件 →設定前先確認三件事
已有訂閱，還是無法匯入？
先確認連結回傳的是相容的設定，而不是登入頁面或錯誤訊息。保留原始連結，檢查有效期限與網路連線；確認格式不相容後，再評估是否需要轉換訂閱。轉換過程會涉及設定內容與憑證傳送，請先了解接收方及其處理方式。
查看匯入問題 →該用系統代理還是 TUN？
先用接管範圍較明確的系統代理測試基本連線。只有在目標應用程式不讀取代理設定，或確實需要接管更廣泛的流量時，再啟用 TUN。接管範圍擴大，也會增加路由與 DNS 的檢查項目，不要只因為有開關就全部開啟。
了解網路接管相關術語 →下載用戶端後，還需要什麼？
還需要合法可用的設定來源、與用戶端相容的協定，以及系統要求的網路授權。用戶端是流量管理工具，安裝完成不代表已經有代理服務。準備好這些條件後，再依教學完成匯入、選擇策略群組與連線測試。
查看首次設定步驟 →Clash 技術筆記
聚焦實際設定問題：先說明現象與原理，再指出檢查位置和相關參數。以下是最新三篇筆記；基礎操作請從教學開始，平台差異與命令列部署則可參閱完整文件。
Clash 訂閱更新失敗排查與自動更新間隔設定
釐清連結失效、更新請求受阻、請求未經代理，以及格式不相容等不同問題。配合用戶端的更新入口，說明如何檢查自動更新間隔與更新時使用的網路路徑，避免將設定下載失敗和代理連線失敗混為一談。
閱讀筆記 →Linux 部署 mihomo：圖形介面用戶端與命令列 systemd 服務兩種方式
分別說明桌面用戶端安裝與無圖形介面環境的核心部署。依照設定目錄、執行權限、終端機代理變數與 systemd 服務整理操作步驟，協助分辨前景測試成功與長期背景執行所需的額外設定。
閱讀筆記 →Clash TUN 模式與系統代理差異：流量接管原理與適用情境
比較應用程式主動遵循代理設定與透過虛擬介面接管流量的差異。說明 DNS 處理、stack 選項與權限需求，並整理兩種方式的適用情境，方便排查瀏覽器能上網、其他應用程式卻仍直接連線的狀況。
閱讀筆記 →