CONFIG / 設定筆記
從流量入口到規則出口，透過欄位了解客戶端如何處理連線。
Clash 是以規則分流為核心的代理工具生態系，不同客戶端負責安裝、設定管理與系統整合，核心則負責實際處理連線。使用時不必一次讀完所有設定：先確認設定檔能載入、策略群組能選擇，再逐步了解模式、DNS 與規則。下方範例呈現獨立欄位片段，適合對照現有設定閱讀，並非可直接取代訂閱的完整連線方案。
在規則模式下，核心會由上而下檢查每條規則，符合的第一條規則就會交由指定策略處理。需要個別處理的網站應排在一般規則前面，最後以 MATCH 接住其餘連線。下方的 Proxy 是策略群組名稱，必須與設定檔中的定義完全一致。修改後可在客戶端的連線頁面查看目標網域、符合的規則與實際出口；若結果不如預期，先檢查規則順序，不要反覆更換整份訂閱。
rules:
- DOMAIN-SUFFIX,example.com,Proxy
- GEOIP,CN,DIRECT
- MATCH,Proxyrule 依規則選擇出口，global 會將進入核心的連線交由全域策略處理，direct 則直接連線至目標。模式不會取代系統代理或 TUN 設定，也不代表所有應用程式都已接入核心。初次設定建議保留規則模式，遇到單一網站的問題時，再暫時切換至全域模式比較。若兩種模式都無法連線，應繼續檢查設定檔、策略群組與網路，而不是把全域模式當成萬用修復開關。切換客戶端介面中的模式後，請以目前生效的設定為準。
# 規則模式
mode: rule
# 其他可選值：global、direct
# mode: globalFake-IP 會在 DNS 查詢時回傳用於映射的位址，核心據此將後續連線對應至原始網域，方便套用網域規則。這需要正確接管流量並設定 DNS 路徑；單獨填入欄位，不代表系統查詢已進入客戶端。若區域網路裝置或特定應用程式不相容，可針對網域設定過濾，再查看查詢與連線記錄。優先沿用客戶端或訂閱中已調校的 DNS 方案，避免同時修改多個解析選項，導致無法判斷問題來源。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
fake-ip-filter:
- "*.lan"策略群組可將規則與實際出口分開管理。select 群組允許在介面中手動選擇項目，規則只需指向群組名稱，不必隨著選擇變動逐一修改。下方僅以內建的 DIRECT 示範結構，因此所有選項仍會直接連線，不會提供遠端代理功能。實際使用時，應匯入合法取得的設定檔，再將正確名稱加入群組。若客戶端提示找不到代理，先核對名稱、大小寫與引用關係，並確認修改的是目前啟用的設定檔。
proxy-groups:
- name: Proxy
type: select
proxies:
- DIRECT
rules:
- MATCH,ProxyYAML 以縮排表示階層，清單前的連字號和冒號後的空格都會影響解析。修改前先匯出備份，每次只改一類欄位，然後重新載入。訂閱更新可能會重新產生原始檔案，需要長期保留的連接埠或規則，優先使用客戶端支援的覆寫或合併功能。不同客戶端處理陣列取代及新增順序的方式不盡相同，儲存後應查看執行中設定確認結果。不要只看編輯器中的文字，就認定核心已套用修改。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
# 縮排使用空格，不使用定位字元
dns:
enable: true想先完成連線？可以先看快速入門；需要了解特定名詞時，請開啟術語表。上方視窗中的範例僅包含直接連線出口，目的是說明設定結構。
CLIENTS / 平台下載
先確認作業系統與處理器架構，再選擇對應的客戶端。安裝檔與系統需求集中列於下載頁。
日常桌面使用可先看看 Clash Plus，也可以比較 Clash Verge Rev、FlClash 等客戶端。安裝前請前往「設定 → 系統 → 系統資訊」確認處理器類型，不要只憑電腦品牌判斷架構。首次啟動後，先匯入設定，再於客戶端開啟系統代理；需要接管更多應用程式時，再查看 TUN 的權限要求。
Clash for Windows 已停止維護，下載頁已將其列入封存項目。準備從舊客戶端遷移時，先匯出設定並記下連接埠與策略群組選擇，不要將舊程式資料夾整個覆蓋到新客戶端。
前往下載從 Apple 選單開啟「關於這台 Mac」，根據晶片資訊選擇 Apple Silicon 或 Intel 安裝檔。下載頁提供 Clash Plus、Clash Verge Rev 和 FlClash 等選項。先將 App 移至「應用程式」再啟動，依實際提示完成系統代理或網路延伸功能授權；不同客戶端所需權限不盡相同。
如果鑰匙圈提示反覆出現，先確認要求是由剛啟動的客戶端所發出，再依教學檢查授權記錄。退出客戶端後若網頁仍無法開啟，可前往系統網路設定確認代理是否已還原。
前往下載下載頁依序整理 Clash Plus、Clash Meta for Android、FlClash 與 Surfboard。選擇安裝檔時請留意裝置架構；匯入設定並啟動後，系統會要求建立 VPN 連線，完成授權後，狀態列通常會顯示相應圖示。該圖示表示網路通道已建立，不代表設定中的每個出口都能使用。
需要在背景持續執行時，請檢查系統的電池管理與背景限制。若使用 Surfboard，也應確認設定檔格式相容，不能只憑副檔名判斷能否直接匯入。
前往下載iPhone 與 iPad 使用者可前往下載頁開啟 Clash Plus 的 App Store 頁面，並查看官方網站 clashplus.io。安裝後，依客戶端提供的入口匯入訂閱或設定；首次啟用連線時，請允許系統新增 VPN 設定。授權完成後，再檢查目前的設定檔與策略群組，避免把「允許新增設定」誤認為已完成所有連線設定。
行動網路與 Wi-Fi 可能採用不同的 DNS 設定及網路限制。切換網路後若遇到連線異常，先查看連線記錄與設定狀態，再依故障排除指南逐項檢查。
前往下載桌面環境可選擇 Clash Verge Rev 或 FlClash，並依 Linux 發行版的套件格式查看安裝方式。安裝完成後，還要確認桌面環境中的系統代理設定是否生效；終端工具通常需要另外設定代理環境變數，不能只因瀏覽器能連線，就認定所有程式都已接入。
伺服器與路由器使用者可在下載頁的核心區查看 mihomo。直接執行核心時，需自行管理設定檔路徑、服務權限與記錄檔；初次使用建議先透過圖形化客戶端了解設定之間的關係。
前往下載QUICKSTART / 三步入門
先完成一套可驗證的連線流程，再調整進階選項。
開啟客戶端的「設定」或「Profiles」頁面，選擇透過連結匯入，貼上合法取得的訂閱網址；若已有 YAML 檔案，則選擇匯入本機檔案。等待下載與解析完成後，再選取這份設定檔。介面通常會顯示設定名稱或更新時間；若出現解析失敗，應先檢查連結是否回傳設定文字，而不是帳戶登入頁面。
訂閱網址可能包含帳戶存取憑證，請勿將完整網址貼到公開討論區。匯入成功只代表檔案可被識別，接下來仍須確認其中的策略群組與出口可用。初次操作時請保留原始檔案，避免一邊匯入一邊修改，之後難以還原。
前往「代理」或「策略群組」頁面，先選擇規則模式，再於主要策略群組中選定可用出口。有些設定包含多層策略群組，需要繼續展開才能看到最終選項；群組名稱只是設定作者定義的標籤，無法直接代表連線是否正常。先保留原有規則與 DNS 設定，減少同時變動的因素。
桌面版接著開啟系統代理，行動裝置則依提示建立 VPN 連線。TUN 適合需要更完整接管流量的情境，但會涉及權限與路由設定；若瀏覽器已能依規則連線，就不必為了「開啟所有功能」而同時啟用所有接管選項。
在瀏覽器中開啟一個已知可連線的網站，再前往客戶端的「連線」或「記錄」頁面，查看是否出現對應請求、符合哪條規則，以及最後使用哪個策略。若看得到請求但無法連線，應繼續檢查出口與 DNS；完全看不到請求，則先確認應用程式是否使用系統代理，以及連接埠是否一致。
驗證時每次只修改一項，重新開啟網頁後比較結果。完成後記住暫停連線及還原系統代理的位置，方便網路異常時恢復原狀。完整教學會進一步說明設定更新、模式切換與常見錯誤的處理順序。
OPEN SOURCE / 專案關係
了解專案來源、客戶端維護情況與設定更新，比只看名稱更有幫助。
Clash 最初以規則代理與 YAML 設定為核心，逐步形成使用生態系。原始專案停止維護後，社群持續發展相關核心與圖形化客戶端。Clash Meta 後來更名為 mihomo，因此在教學、設定說明與客戶端選項中，可能會看到這些不同名稱。名稱有承襲關係，但不能因此推斷所有舊欄位、新協定與客戶端功能都完全相容。
遇到特定欄位無效時，先在客戶端的「關於」或核心頁面確認實際使用的核心，再查看相應文件。舊教學有助於理解基本概念，但不應直接拿來判斷目前支援的功能範圍。尤其是 DNS、TUN 與規則提供者等部分，設定方式可能隨核心功能及客戶端整合方式而變動。
Clash Verge Rev、FlClash 等圖形化客戶端主要負責設定管理、介面呈現、系統代理與權限整合；mihomo 則負責解析設定、比對規則並建立連線。客戶端與核心專案各有自己的維護時程，應用程式介面變更不一定代表核心行為也同時改變。下載時應依平台與實際需求選擇，不要只因名稱中含有 Clash 就認定功能相同。
開源授權說明程式碼使用、修改與散布的條件，不代表不同專案由同一發布者統一管理。本網站品牌用於整理下載資訊與中文說明，各客戶端的維護單位請以其專案資料為準。想了解各專案的分工，可閱讀Clash、Clash Meta 與 mihomo 關係整理，再決定要遷移或保留哪些設定。
更新客戶端通常會影響介面、系統整合或隨附核心；更新訂閱則主要會變更節點、策略群組與規則內容。若連線問題是在訂閱更新後出現，應先比對設定變化，而不是直接重新安裝應用程式。升級客戶端前，請匯出目前的設定、記錄覆寫內容與代理連接埠，確認新環境能載入後再清除舊檔案。
管理訂閱涉及服務網址與帳戶權限。客戶端能讀取某種協定，不代表任何來源的連結都值得信任。只匯入來源清楚且有權使用的設定；公開求助時，請遮蔽訂閱網址中的存取參數、帳戶資訊與節點憑證。本網站提供欄位與操作參考，不散布所謂的通用免費節點，也不保證第三方服務的連線品質。
mihomo 專案採用 GPL-3.0 授權，可在公開儲存庫查看實作方式、問題討論與發布說明。若打算自行編譯或散布修改後的程式，應完整閱讀授權條款及相關相依套件說明；只想日常使用的話，則可從圖形化客戶端開始，不必先建立編譯環境。
右側指令只會將公開原始碼下載至本機資料夾，不會安裝客戶端、建立代理連線或修改系統網路。複製後可在已安裝 Git 的終端機中執行。若只是想查詢欄位含義，直接開啟本網站的設定欄位參考或術語表會更直接；需要確認實作細節時，再搭配原始碼與專案文件閱讀。
NOTES / 最新文章
從實際操作遇到的錯誤著手，依序檢查設定，並保留有助於釐清問題的連線記錄。
連線狀態不代表請求已成功抵達目標。依序檢查系統代理、連接埠占用、策略群組選擇、規則命中、DNS 與 Fake-IP，釐清請求尚未進入核心或進入後連線失敗，避免反覆重新安裝造成更多干擾。
閱讀故障排除清單 →訂閱下載逾時、解析失敗與憑證錯誤需要分別處理。先確認網路請求是否成功，再判斷回傳內容能否作為設定檔讀取；同時了解自動更新間隔與本機覆寫的關係，避免更新後遺失手動調整。
查看更新設定 →遇到「無法打開」、網路延伸功能授權，或鑰匙圈提示反覆出現時，先確認提示來源與所需權限，再前往相應的系統設定處理。文章會逐步說明檢查位置，並區分應用程式啟動、代理授權與連線驗證三個階段。
閱讀權限說明 →尚未安裝客戶端時，請從平台下載入口開始；已能連線但特定網站異常時，優先閱讀與實際情況相符的故障排除文章。需要調整設定結構時，再對照欄位參考逐項修改，不要一次替換整套網路設定。
查看所有文章 →