CLASH TROUBLE LABEL
Clash 常見問題與故障排查
依問題發生的位置尋找處理方法。建議先確認基礎網路與訂閱狀態，再檢查用戶端設定、系統代理、TUN、DNS 與本機安全性原則，避免原因未明時反覆重新安裝。
BASIC NOTES
基礎認知
先區分用戶端、訂閱、節點與執行模式。概念混用時，常會把訂閱問題誤判為用戶端故障。
Clash 用戶端與代理訂閱有什麼關係？
Clash 用戶端負責讀取設定、比對規則，並將網路請求轉交給所選節點，本身不提供代理線路。訂閱網址通常由服務提供者產生，內容包含節點、策略群組與規則。安裝用戶端後，仍須匯入有效訂閱，或自行撰寫完整設定檔，才能建立可用連線。
規則模式、全域模式與直連模式有什麼差別？
規則模式會依照設定檔中的 rules，由上而下判斷流量去向，適合日常使用；全域模式會將大部分流量交給指定策略群組，常用於暫時測試節點；直連模式不經過代理節點，可用來確認問題是否來自 Clash。切換模式無法修復失效節點，排查時仍須搭配日誌與延遲測試。
設定檔、訂閱與節點可以混用嗎？
可以，但必須釐清各自的更新來源。遠端訂閱更新時，可能會覆蓋直接在用戶端內修改的節點或規則，因此長期修改應寫入覆寫設定或另行維護的 YAML 檔案。匯入多個訂閱後，也要檢查策略群組是否引用正確的節點名稱，避免名稱變更造成策略群組內容為空。
Clash 免費節點為什麼經常無法連線？
公開節點通常有容量有限、位址頻繁變動與上線時間不固定等情況，延遲測試成功也不代表實際連線能持續穩定。遇到無法連線時，應先更新來源，再分別測試多個節點，並確認系統時間、DNS 與本地網路正常。不要將公開設定中的控制連接埠或驗證資訊直接用於重要環境。
SETUP LABEL
安裝設定
重點檢查訂閱回傳內容、設定檔結構、系統授權，以及開機啟動後的狀態恢復。
匯入訂閱後為什麼沒有顯示節點？
先查看訂閱更新紀錄，確認回傳內容是 Clash 可識別的 YAML，而不是登入頁面、到期提示或空白檔案。接著檢查訂閱網址是否完整、裝置時間是否正確，以及服務提供者是否限制請求方式。若設定能下載但節點清單為空，應檢查 proxies 與 proxy-groups 欄位及 YAML 縮排。
訂閱失效或更新失敗時該怎麼處理？
先在訂閱提供者的頁面確認方案狀態與訂閱網址是否已變更，再回到用戶端手動更新。若顯示逾時，可暫時關閉系統代理後重試，或切換至其他網路以排除目前網路阻擋。若顯示解析錯誤，應保留錯誤行號並檢查回傳檔案；反覆重新安裝用戶端通常無法恢復失效訂閱。
啟用 TUN 模式時為什麼需要管理員權限？
TUN 模式需要建立虛擬網卡、調整路由並接管部分系統流量，因此 Windows、macOS 與 Linux 都可能要求管理員授權。授權遭拒後，應退出用戶端並以適當權限重新啟動，同時檢查系統網路擴充功能、驅動程式或服務是否允許。企業裝置也可能受到本機安全性原則限制。
Clash 開機自動啟動後沒有自動連線怎麼辦？
開機自動啟動只代表用戶端程序啟動，不一定會自動選取設定、恢復系統代理或開啟 TUN。請分別檢查啟動設定、上次的策略選擇與代理開關，並確認作業系統沒有延遲或阻止背景啟動。若設定檔位於外接磁碟或同步資料夾，也要確保啟動時該路徑已可讀取。
OPERATION NOTES
使用技巧
請求進入用戶端後，還要經過連接埠接管、規則比對、策略選擇與 DNS 解析等環節。
開啟系統代理後，瀏覽器仍然直連怎麼辦？
先確認用戶端顯示的 HTTP 或 mixed-port 與系統代理連接埠一致，再檢查瀏覽器是否使用獨立代理設定、擴充功能或安全軟體。部分程式不遵循系統代理，需要改用 TUN 模式，或在程式內設定代理。排查時可查看 Connections 或日誌，確認請求是否確實進入 Clash。
Windows 應用程式無法連網時，如何處理 UWP 回送？
部分採用應用程式容器的 Windows 程式預設無法存取本機回送代理，因此瀏覽器可用，商店應用程式卻可能失敗。可在用戶端提供的 UWP 回送工具中勾選目標應用程式並儲存，然後重新啟動該應用程式。若應用程式使用系統層級網路服務，仍須檢查系統代理、TUN 與防火牆規則。
修改 Clash 規則後為什麼沒有立即生效？
調整規則後需要儲存並重新載入設定，既有連線也可能繼續沿用舊策略。可關閉目標程式的現有連線，或在用戶端連線清單中終止對應工作階段後再次測試。同時確認新規則位於 MATCH 之前，並檢查網域規則、IP 規則與策略群組名稱是否與設定中的定義完全一致。
Clash GeoIP 或規則集更新失敗怎麼辦？
先確認規則集網址可存取、設定中的路徑可寫入，並查看日誌中的 HTTP 狀態或檔案讀取錯誤。更新期間不要同時讓多個用戶端寫入同一個資料夾。若更換 GeoIP 或規則集檔案，應核對設定引用的檔名與格式，並重新載入設定；舊連線不會自動依新規則重新比對。
FAULT FINDING
故障排查
從常見故障點逐層檢查：基礎網路、訂閱、節點、DNS、路由、虛擬網卡與設定語法。
所有 Clash 節點都顯示逾時，應從哪裡開始查？
先關閉 Clash，確認基礎網路是否能正常存取，再檢查系統時間、訂閱有效性與本地 DNS。接著選擇不同協定與地區的節點分別測試，避免只根據一次延遲結果下判斷。若所有節點同時失敗，應優先排查目前網路、防火牆、代理連接埠衝突與服務提供者狀態，而不是逐一刪除節點。
節點延遲正常，但網頁打不開是什麼原因？
延遲測試通常只會驗證指定測試網址是否可達，不代表 DNS 解析、目標網站路由與實際傳輸都正常。請檢查目前選取的策略群組、規則命中結果與 DNS 日誌，並嘗試終止舊連線後重試。若只有特定網站失敗，可確認是否被誤分到 DIRECT，或被網域解析至無法連線的位址。
開啟 TUN 後斷網，或與其他 VPN 發生衝突怎麼辦？
多個 VPN、虛擬網卡或安全軟體可能同時修改預設路由與 DNS，導致流量迴圈或出口遺失。先關閉其他網路接管工具，只保留 Clash TUN 進行測試；若仍然斷網，請還原系統 DNS、重新啟動虛擬網卡並檢查路由。確認單獨執行正常後，再逐項啟用其他工具以找出衝突來源。
設定檔顯示 YAML 解析錯誤時，如何定位問題？
從錯誤訊息所提供的行號附近開始檢查，常見原因包括縮排層級不一致、冒號後缺少空格、清單符號位置錯誤，以及含特殊字元的文字未正確加上引號。不要一次修改整份檔案，可先還原原始設定，再逐段加入變更並重新載入。請使用空格縮排，不要在同一份檔案中混用定位字元。