基本概念
釐清核心、用戶端與代理服務的差異，了解各種模式的作用範圍。
Clash Meta、mihomo 核心與圖形化用戶端有什麼關係？
Clash Meta 是這個核心專案曾使用的名稱，目前專案以 mihomo 為名持續維護。核心負責代理協定、規則比對、DNS 與連線處理；圖形化用戶端則在核心之外提供訂閱管理、策略選擇、系統代理及日誌介面。用戶端名稱不同，不代表使用的核心一定不同。排查設定相容性時，先在關於頁面或啟動日誌確認核心名稱與版本，再查閱相應文件。更新圖形介面不一定會同步更新核心，部分用戶端需要另外到核心管理功能操作。
安裝 Clash Meta 用戶端後，為什麼還需要訂閱？
用戶端提供連線與流量分流功能，本身並不是代理服務。可用的設定通常須包含代理伺服器位址、連接埠、驗證資訊，以及引用這些代理的策略群組與規則。訂閱是分發這類設定的一種方式，應向實際的服務提供者取得；如果已有自架伺服器，也可以自行撰寫設定檔。匯入前請確認訂閱格式適用於 Clash 或 mihomo，並將訂閱連結視為存取憑證妥善保管。不要將完整連結貼到公開日誌、截圖或線上轉換頁面，尤其要留意連結查詢參數中的驗證欄位。
規則模式、全域模式和直連模式該怎麼選？
日常分流通常選擇規則模式，也就是 mode: rule；連線會依照 rules 的順序逐條比對，符合後交由相應策略處理。全域模式會將交由核心處理的連線送入全域策略，仍須選擇可用代理；它不會自動接管未進入核心的應用程式。直連模式則讓核心處理的連線直接連線至目標。排查時可暫時切換為全域模式，確認問題是否來自規則，測試後再切回原模式。模式與流量接管方式是兩回事：啟用全域模式不能取代系統代理或 TUN，也無法保證所有 UDP 流量都會經過代理。
Clash for Windows 停止更新後，原有設定還能移轉嗎？
多數基本 YAML 設定都能移轉，但要分清原始訂閱、用戶端覆寫和腳本。先匯出訂閱網址，備份本機設定、自訂規則與策略群組名稱，再安裝仍持續維護的 mihomo 核心用戶端。優先匯入原始訂閱並確認基本連線正常，再逐項還原覆寫內容。舊用戶端的腳本介面、設定目錄和系統整合功能未必相容，不能只複製整個程式資料夾。移轉完成後，關閉舊用戶端的系統代理、背景服務和開機啟動，避免兩個核心搶用連接埠或重複修改路由。
安裝與設定
從取得訂閱到啟動核心，優先確認回應內容、監聽連接埠和系統權限。
訂閱匯入失敗或更新後失效，該先檢查什麼？
先在設定或訂閱管理中手動更新，查看回應狀態與錯誤內容。401 或 403 通常代表驗證、權限或存取政策有問題；404 則需確認網址，逾時時先確認訂閱網域是否連得上。若下載成功卻顯示解析失敗，請檢查回應內容是否其實是登入頁面、錯誤頁面，或不是 Clash 設定格式。更新訂閱前先保留可用的設定副本，不要反覆刪除重建。也請確認用戶端是否設定透過目前的代理更新訂閱；若代理無法使用，可在網路條件允許時改用直連更新，再聯絡服務提供者確認訂閱期限。
mixed-port: 7890 是什麼？遇到連接埠衝突怎麼處理？
mixed-port 是同時接受 HTTP 和 SOCKS 代理連線的混合監聽連接埠；7890 只是常見設定，並非固定要求。手動設定應用程式代理時，請填入用戶端實際監聽的位址與連接埠，本機通常使用 127.0.0.1。若啟動日誌出現 address already in use，先關閉其他代理用戶端及殘留的核心程序，再檢查連接埠是否被占用。也可以改用未占用的連接埠，但須同步修改系統代理、瀏覽器擴充功能及命令列環境變數。部分用戶端會覆寫訂閱中的連接埠，請以設定介面和啟動日誌顯示的最終值為準。
TUN 模式提示權限不足，如何確認服務正常運作？
TUN 需要建立虛擬網路介面並調整路由，通常須有管理員權限或使用用戶端提供的特權服務。Windows 上先確認服務模式已安裝並啟動，再依用戶端要求授權；macOS 上須完成輔助程式安裝與系統授權；Linux 上則檢查服務帳號是否具備所需的網路權限。不要只看到 TUN 開關已開啟就認定流量接管成功，也要查看建立介面和設定路由的日誌。若提示裝置已被占用，先停止其他 VPN 或虛擬網卡服務。權限恢復後重新啟動核心再試，不建議關閉防火牆或擴大控制介面的公開範圍來避開錯誤。
修改 config.yaml 後發生錯誤，如何找出 YAML 縮排問題？
先保留發生錯誤的檔案，再根據日誌中的行號及前後幾行檢查結構。YAML 縮排請使用空格，不要使用定位字元；同一層的鍵要對齊，清單項目前加連字號，鍵名後的冒號與值之間要留空格。行號通常指出解析器無法繼續的位置，真正的問題可能出在前一行。如果能直接執行核心程式，可使用 mihomo -t -f config.yaml 測試設定，並確認路徑指向實際檔案。也要確認策略群組和規則引用的名稱確實存在。使用訂閱管理的用戶端，建議透過覆寫功能修改；直接編輯下載快取可能在下次更新時被覆蓋。
使用技巧
設定自訂規則、開機啟動、多裝置同步與 DNS 查詢路徑。
Clash 自訂規則要加在哪裡？為什麼新增後沒有生效？
規則模式會依照 rules 的順序比對。自訂規則應放在可能先符合的廣泛規則之前，尤其不能放在最後的 MATCH 之後。例如 DOMAIN-SUFFIX,github.com,PROXY 必須有名為 PROXY 的策略或代理群組，名稱須逐字相符。優先使用用戶端的規則覆寫或前置規則功能，避免修改被訂閱更新覆蓋。儲存後重新載入設定，並在連線詳細資訊中確認實際命中的規則和策略鏈。已建立的長連線可能仍沿用原有路徑，測試前可關閉相關連線後再重新存取。網域規則也無法直接比對應用程式寫死的純 IP 位址請求。
Clash 設定開機啟動後仍無法連線，該檢查哪些選項？
用戶端開機啟動、核心啟動、啟用系統代理和啟用 TUN 是不同狀態，請分別確認。先重新啟動系統，查看用戶端是否已在背景執行、目前設定是否載入、核心是否成功監聽連接埠，再檢查系統代理或 TUN 是否已恢復。使用服務模式時，也要確認系統服務的啟動類型和執行狀態，避免介面已啟動但特權服務尚未就緒。若登入時網路尚未連線，訂閱更新和連線測試可能暫時失敗，可等網路就緒後重試。不要同時啟用多個用戶端的開機啟動；切換用戶端時，先清除舊程式留下的代理與服務設定。
電腦和手機可以共用同一份訂閱與設定嗎？
可以共用訂閱來源，但要先確認服務允許的裝置數量與同時連線限制。代理清單和規則通常可以共用；TUN、DNS 監聽位址、介面名稱、檔案路徑及外部控制介面則可能需要依裝置覆寫。建議將通用設定交由訂閱管理，連接埠和系統整合設定則留在各裝置的用戶端中。同步檔案時不要公開含驗證資訊的訂閱網址，也不要將控制介面的存取憑證提交至公開儲存庫。更換裝置後，請確認策略群組選擇是否還原；即使設定檔相同，系統網路堆疊、VPN 權限和背景執行政策也可能造成不同結果。
如何檢查 Clash DNS 洩漏？fake-ip 是否代表所有流量都已接管？
fake-ip 會透過虛擬位址對應保留網域資訊，但不代表所有 DNS 要求都會自動交由核心處理。檢查時先確認 dns.enable 已啟用，再核對系統 DNS、TUN 的 DNS 劫持規則，以及瀏覽器或應用程式是否另外啟用了加密 DNS。搭配核心日誌和系統網路設定判斷查詢路徑；線上檢測頁面顯示的解析器位置只能作為參考。修改 DNS 後，請清除系統和瀏覽器快取並重新建立連線。檢測結果與預期不同時，不要隨意疊加多組 nameserver；先釐清哪些要求由系統解析、哪些交由核心處理，以及上游 DNS 連線採用的路由。
故障排除
依照症狀進行交叉測試，每次只調整一項設定，並保留可還原的設定檔。
節點測試逾時，是伺服器無法使用還是設定有問題？
測試逾時只表示指定的測試要求未能在時限內完成，不能只憑這一點判定伺服器已失效。先確認系統時間正確、訂閱已更新，再檢查日誌中是否有網域解析失敗、連線遭拒、交握失敗或驗證錯誤。比較同一份設定在其他網路上的表現，有助於分辨本機網路限制和遠端故障；也可以改用同一策略群組中的其他代理交叉測試。若只有速度測試失敗但實際瀏覽正常，請檢查測速網址和逾時設定。回報服務提供者時，保留錯誤類型和發生時間，並隱藏伺服器驗證資訊，不要只傳一張逾時截圖。
系統代理已啟用，為什麼終端機或部分應用程式仍直接連線？
系統代理只是提供代理位址給遵循該設定的應用程式，並非透明接管。部分終端機程式會讀取 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY 環境變數，其他程式則只認自己的代理選項；瀏覽器擴充功能也可能覆蓋系統設定。先確認核心正在執行，再使用 curl -I -x http://127.0.0.1:7890 https://example.com 明確指定代理進行測試，並將連接埠改為實際監聽值。若明確指定代理後可以連線，請檢查應用程式採用的代理來源和排除清單。若要接管不遵循系統代理的應用程式，可評估使用 TUN 模式，但仍須檢查路由、權限及與其他 VPN 的衝突。
Windows 市集應用程式無法連線，如何處理 UWP 回環限制？
部分受到 AppContainer 隔離的應用程式無法直接存取本機回環代理，因此若瀏覽器正常、特定應用程式卻無法連線，就需要檢查回環限制。先確認受影響的應用程式確實使用本機代理，再使用用戶端提供的回環豁免工具，或在系統管理員終端機執行 CheckNetIsolation LoopbackExempt -s 查看目前的豁免清單。手動新增時，使用 CheckNetIsolation LoopbackExempt -a -n= 後接目標應用程式的套件系列名稱，不可填入開始功能表顯示名稱。只授權必要的應用程式，不要一次放行所有應用程式。也可測試以 TUN 接管作為替代方式，但效果仍取決於應用程式的網路行為和路由設定。
Android 鎖定螢幕後斷線或耗電偏高，如何檢查背景執行？
先到系統設定的應用程式管理找到用戶端，檢查電池用量、背景活動和自動啟動權限；選單名稱會因廠牌系統而異。鎖定螢幕後斷線時，可允許應用程式在背景執行，並觀察 VPN 狀態是否仍維持連線，同時確認沒有其他 VPN 應用程式接管連線。若耗電偏高，先檢查是否頻繁重新連線、反覆更新訂閱或持續輸出除錯日誌，再比較關閉不必要的連線測試後有何變化。不要一次更改所有省電選項，每次調整一項，並在相近的網路條件下觀察。訊號較弱、分享行動熱點和大量背景要求也會增加耗電，不能只看用戶端的耗電占比就判定核心異常。
仍需找出問題：查看依症狀整理的故障排除流程 →