CONFIG / 問題排查佇列
先分清楚「流量是否進入核心」與「進入後套用哪條規則」。以下片段分別用來檢查各個環節，並非可獨立運作的完整訂閱。代理群組名稱必須與現有設定一致；範例中的 PROXY 需替換成實際存在的群組名稱。
規則模式適合在同一台裝置上並用直連與代理。將運作模式設為 rule，先列出需要明確處理的網域，再設定地理規則，最後以 MATCH 作為兜底。與全域模式不同，規則模式不會將所有請求交給同一個代理群組；與直連模式不同，它仍會依設定執行分流。造訪目標網站後，開啟連線紀錄，核對符合的規則與最終出口。範例中只有造訪未符合其他規則的目標時，流量才會套用醒目標示的規則，並非每次請求都會走這裡。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXYTUN 透過虛擬網路介面接管流量，適用於不遵循系統代理設定的程式；但啟用後不代表所有連線都會走代理，實際結果仍由規則決定。桌面用戶端通常需要服務模式或管理員權限；行動裝置則透過系統 VPN 授權運作。先確認一般系統代理可正常連線，再啟用 TUN、自動路由與介面偵測，避免一次引入多個未知因素。若要與其他 VPN 共用，先停用其中一個再測試；若無法連線至內網位址，應檢查路由排除設定，而非反覆更換節點。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53DNS 設定決定網域如何解析，以及 DNS 請求會從哪裡送出。啟用 fake-ip 後，核心可先回傳對應的映射位址，再於連線階段依網域分流；這與直接回傳真實位址的方式不同。只調整增強模式，無法保證系統 DNS 已被接管；還要檢查 TUN 的攔截設定、瀏覽器安全 DNS，以及應用程式內建的解析器。以下列出基本欄位，上游位址需依網路環境選擇。重新測試時，請同時查看解析紀錄與連線規則；檢測網站顯示的解析器所在地只能作為線索，無法單獨證明有 DNS 洩漏。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-query匯入訂閱是為了解決設定來源與後續更新問題。圖形用戶端中的遠端設定通常包含節點、代理群組和規則；proxy-providers 則只負責提供節點，兩種入口不可混為一談。先在設定頁面匯入服務提供者給的網址，確認更新成功後，再設為目前使用的設定；不要將網址貼到公開分享頁面，也不要提交給不熟悉的轉換網站。以下片段示範節點提供器的更新結構，範例網址需替換，引用該提供器的代理群組也須另外定義。更新失敗時，先查看 HTTP 狀態碼，再檢查有效期限與本機快取。
proxy-providers:
remote:
type: http
url: "https://example.com/proxies.yaml"
path: ./providers/remote.yaml
interval: 86400覆寫可保留本機連接埠、DNS 或規則調整，避免每次更新訂閱後都得重新編輯。不同用戶端的合併設定、擴充腳本與覆寫入口各有不同，不能把某個前端的操作流程當成核心通用功能。先備份原始設定，再只覆寫需要調整的欄位，啟動後檢查最後產生的執行設定。尤其要確認清單欄位採用取代還是附加，否則自訂規則可能被排在兜底規則之後。相較於直接修改遠端快取，獨立覆寫更容易還原；發生問題時，暫時停用覆寫即可縮小排查範圍。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: infoPACKAGES / 依作業系統選擇
用戶端負責介面、設定管理與系統整合；核心負責處理協定與執行規則。挑選時先確認作業系統和處理器架構，再查看維護狀況與功能支援。Clash教學站整理下載入口與設定方式，並非各用戶端專案的官方網站，也不提供代理服務或訂閱帳號。
建議先從 Clash Plus 開始，也可依使用習慣挑選 Clash Verge Rev、FlClash 或 Clash Nyanpasu。下載前確認作業系統類型與安裝權限；首次啟動先匯入設定，再開啟系統代理。需要 TUN 時，請確認服務模式已成功安裝，避免把權限錯誤誤認為訂閱失效。
前往下載 →先在「關於這台 Mac」確認裝置採用 Apple Silicon 還是 Intel，再選擇相符的安裝檔。可比較 Clash Plus、Clash Verge Rev 與 FlClash 的介面和維護狀況。首次啟動若出現系統安全提示，請依系統設定中的授權流程處理，不要為了單一應用程式關閉整套安全防護。
前往下載 →可先試用 Clash Plus，再比較 Clash Meta for Android、FlClash 與 Surfboard 的設定相容性。首次連線需要授予系統 VPN 權限；若切換至背景後連線中斷，請檢查電池最佳化與背景執行限制。安裝檔架構須符合裝置，設定格式也要與所選用戶端相容。
前往下載 →下載頁提供 Clash Plus 的 App Store 入口及官方網站 clashplus.io。安裝後匯入支援的訂閱或設定，並允許新增 VPN 設定檔。系統顯示 VPN 已連線，只代表通道已建立；仍需實際造訪目標網頁，確認規則與出口符合預期。
前往下載 →桌面環境可選用 Clash Verge Rev 或 FlClash，並依 Linux 發行版選擇對應套件。無桌面的伺服器與路由器則較適合直接執行 mihomo 核心。圖形介面的系統代理開關不一定會影響終端機程式，需搭配環境變數、應用程式代理設定或 TUN，確認實際流量路徑。
前往下載 →已停止維護的用戶端仍可用來理解舊版設定，但不應只因熟悉舊介面就忽略維護狀況。移轉至 mihomo 生態系時，請優先檢查協定欄位、代理群組引用與 DNS 參數；成功匯入檔案不代表每個欄位都會生效。同時執行多個代理用戶端也可能造成連接埠與路由衝突，初次驗證時請只保留一個。
查看所有用戶端 → · 查看用戶端比較評測 →QUICKSTART / 最簡連線流程
先讓最簡單的連線流程正常運作，再加入覆寫、自訂規則和 TUN。請準備支援的訂閱網址、可正常連網的裝置，以及原始設定的備份。用戶端本身不會產生可用節點；完成安裝不等於已取得代理服務。
在用戶端的設定或訂閱頁面新增遠端網址，並執行一次更新。看到節點與代理群組後，再將這份設定設為目前使用項目。若清單是空的，先查看更新日誌中的狀態碼與解析錯誤；訂閱連結可能包含帳號識別資訊，請勿將完整網址貼在公開截圖中。此時先不要修改 DNS，保留可還原的起點。
選擇規則模式，在代理群組中選定可用出口，再開啟系統代理。桌面瀏覽器通常可透過這個方式完成首次測試；行動裝置則依提示授予 VPN 權限。若某個應用程式不使用系統代理，再另外評估是否啟用 TUN。不要同時切換全域模式、修改連接埠和路由，否則即使測試成功，也難以判斷是哪項設定發揮作用。
分別造訪預期走代理與預期直連的網站，查看連線頁面中的網域、符合的規則與代理鏈。網頁無法開啟時，記下具體錯誤：解析失敗、連線逾時與憑證異常的排查方向各不相同。測試結束後關閉代理再造訪一次，確認系統代理已正常還原。只看開關變色不算完成驗證，設定檔也不會因為儲存了就自動正確。
SOURCE / 核心與前端的分工
評估用戶端是否適合長期使用，可先確認它依賴哪個核心、如何更新設定，以及發生錯誤時能否查看執行日誌。專案名稱相近，不代表由同一位維護者負責，也不代表功能與更新時程完全相同。
原版 Clash 專案停止維護後，社群持續以相容的規則語法與設定結構發展。mihomo 延續 Clash.Meta 的技術路線，維護協定、路由與 DNS 等功能。教學中提到的 Clash、Clash Meta 與 mihomo 有歷史淵源，但不能簡單視為同一個軟體名稱；舊教學中的欄位、專屬功能與平台限制，仍須對照目前的核心文件確認。
Clash Verge Rev、FlClash、Clash Nyanpasu 等前端提供訂閱管理、系統匣選單、系統代理與服務整合；真正建立連線、解析規則和處理流量的是核心。前端更新不一定代表協定實作也有所變更；反過來說，更換核心後介面可能沒有變化，但支援的欄位可能已不同。回報錯誤時，應一併記錄用戶端名稱、作業系統與核心資訊，方便判斷問題所在。
mihomo 儲存庫採用 GPL-3.0 授權發布程式碼，可透過原始碼、提交紀錄與問題討論確認功能來源。程式碼可供檢視，不代表任意設定都安全：開放監聽位址、啟用區域網路存取或公開控制介面時，仍須自行檢查存取範圍。規則與訂閱也是輸入資料，來源不明時不要直接覆寫長期使用的設定，更不要把控制介面憑證提供給他人。
程式更新會修正介面或核心問題；訂閱更新會同步節點與規則；GeoIP、GeoSite 資料更新則會影響地理分流結果，三者並非同一個按鈕。更新前保留可正常運作的設定，更新後檢查啟動日誌與重要網站的規則比對結果。若只是訂閱回應錯誤，反覆重新安裝用戶端通常無法解決；若欄位不相容，則應確認目前執行的核心是否支援該設定。
依現象查找資料：不清楚 mixed-port 與控制介面的差異，可查看名詞解釋；匯入成功卻無法連線，先參考常見問題；需要逐平台確認系統代理、權限和背景執行限制，則請查看全平台安裝與設定指南。本站以可重現的操作與設定說明為主，不以下載量或評分取代技術依據。
FIELD NOTES / 最新故障排除筆記
快速教學協助建立首次連線，以下筆記則處理連線後的細節。閱讀時，先把遇到的現象整理成一句可驗證的問題，例如「瀏覽器可以連線，但終端機不行」或「規則正確，但網域解析逾時」，再依據證據縮小範圍，比一次複製整份設定更可靠。
依序檢查訂閱是否過期、節點連線狀況、系統代理連接埠、TUN 權限、規則模式與 DNS 污染，找出無法上網的真正原因。
閱讀故障排除筆記 →逐一說明 default-nameserver、nameserver、fallback、fallback-filter 與 TUN 下 dns-hijack 的用途，並附上可直接套用的設定片段。
閱讀設定筆記 →梳理原版核心、Premium 到 mihomo 的演進，以及 Verge、FlClash、Nyanpasu 等前端與核心的相依關係，協助你選出合適的用戶端。
閱讀生態系筆記 →調整 DNS 時，建議保留修改前後的解析結果，並記錄瀏覽器是否啟用安全 DNS；調整規則時，保留目標網域與實際符合的規則行。日誌應能指出「哪裡失敗」，而不只是截下一個紅色圖示。分享前請刪除帳號相關資訊；重現步驟越精簡，越容易找出問題。
查看所有文章 →