Clash 常見問題

Clash 最初指的是代理核心及其設定生態系；Clash Meta 是以此為基礎發展的核心分支，後續改以 mihomo 名稱持續維護。一般安裝的圖形介面客戶端負責顯示訂閱、代理群組及設定，核心則負責實際處理連線。客戶端名稱相近，不代表核心與支援的設定欄位完全相同。遇到通訊協定或設定不相容時，請先在「關於」頁面確認客戶端與核心資訊，再對照訂閱要求判斷，不要只憑名稱選擇設定。

客戶端負責讀取設定並轉送流量，安裝程式本身通常不包含可直接使用的代理服務。請準備有權使用的訂閱連結或設定檔，匯入後選擇代理群組，再啟用系統代理，或視需要啟用 TUN。看到設定名稱只代表匯入完成，還要確認代理群組中有可選節點、設定已啟用，而且目標應用程式的流量確實進入客戶端。訂閱到期或流量用量已達上限時，請向訂閱服務提供者確認。

先依作業系統篩選，再確認處理器架構及最低系統需求。Windows、macOS、Android 和 iOS 可優先查看 Clash Plus；Linux 則可先查看 Clash Verge Rev。若要沿用舊設定，也要確認客戶端核心支援使用的通訊協定、規則及 DNS 欄位。Apple Silicon 與 Intel 安裝檔不能混用；Android 也應確認是 ARM64 或 ARM 架構。可用軟體、下載方式及封存狀態，請以下載中心各平台的清單為準。

規則模式會依目前設定中的規則，決定連線使用代理或直接連線，適合日常使用。全域模式會將進入核心的一般連線交由全域代理群組處理，適合短暫切換測試，但仍須選擇可用節點。直連模式則讓進入核心的連線直接連至目的地，並不代表關閉系統代理或結束客戶端。這三種模式只會影響已由客戶端接管的流量；若應用程式的流量沒有進入代理，切換模式也不會改變連線路徑。

訂閱連結通常含有可識別帳戶的存取憑證，不應直接貼到論壇、群組聊天或公開截圖。排查時可提供錯誤訊息、客戶端與核心資訊，以及已遮蔽敏感內容的設定片段。除了訂閱網址，也要檢查節點密碼、授權要求標頭及記錄中的完整 URL。若連結已公開，請透過服務提供者的管理後台重設或撤銷，再更新客戶端中的網址；只刪除聊天紀錄，無法確保舊連結失效。

先確認複製的是訂閱網址，而不是帳戶登入頁或訂閱管理頁面。檢查網址前後是否多了空格、換行或漏掉參數，再查看匯入結果與記錄。若收到的是登入頁面、存取遭拒或空白內容，請先處理帳戶授權及網路存取問題。若提示格式不支援，請向服務提供者確認是否有適用於目前核心的 Clash 設定。匯入成功後還要啟用該設定，並確認代理群組引用了正確的節點或代理提供者。

TUN 需要建立虛擬網路介面並調整路由，通常比系統代理需要更多權限。Windows 請依客戶端說明安裝服務元件，並確認服務正在執行；必要時可用系統管理員權限測試一次。macOS 請檢查系統跳出的網路延伸功能或輔助元件授權；Linux 則確認服務權限及 TUN 裝置是否可用。反覆切換開關無法取代授權。完成授權後重新啟動客戶端，再查看記錄確認介面建立及路由設定是否成功。

先在系統網路設定中確認代理位址指向本機，連接埠也與客戶端目前的監聽連接埠相同；不要假設所有客戶端都使用相同連接埠。退出其他代理工具，並暫時停用會接管代理的瀏覽器擴充功能。Firefox 等瀏覽器也可能使用獨立代理設定，請確認是否設為使用系統代理。接著開啟新頁面並查看客戶端的連線記錄；完全沒有記錄時，先檢查流量接管方式；有記錄但連線失敗時，再檢查規則、節點及 DNS。

Android 通常一次只允許一個應用程式使用系統 VPN 通道。先關閉其他 VPN 應用程式，以及使用本機 VPN 運作的防火牆或網路過濾工具，再重新授權 Clash 建立連線。若系統設定了永遠開啟的 VPN，或禁止未經 VPN 的連線，也要確認這些設定套用至哪些應用程式。連線成功後，檢查客戶端的應用程式清單，確認目標應用程式沒有被排除。不要為了解決衝突就清除所有設定，請先保留訂閱及必要設定。

先備份設定，再依錯誤訊息中的行號檢查附近內容。YAML 階層依賴空格縮排，請勿使用 Tab；清單項目、冒號後的空格及成對引號也都要正確。行號有時指向發現錯誤的位置，真正缺少的引號可能在上一行。格式檢查通過後若仍提示未知欄位，請確認核心是否支援該欄位。訂閱產生的設定通常會在更新時遭到覆寫，長期調整請使用客戶端提供的覆寫或合併功能。

在客戶端開啟連線記錄，再從目標應用程式發出新的網路要求，確認目標網域、符合的規則及所選代理鏈。既有的長連線可能會繼續沿用舊路徑，因此切換設定後請重新建立連線。只看網頁顯示的出口 IP 位址，無法判斷所有分流結果；規則模式下，不同網站可能使用不同路徑。若沒有記錄，請檢查應用程式是否遵循系統代理，或是否被 TUN 的應用程式設定排除；不要只憑開關顏色判斷流量是否已接管。

不一定要同時啟用。系統代理適合遵循系統代理設定的瀏覽器及一般應用程式；TUN 則可接管更多不會主動使用代理的程式，但需要設定路由、DNS 及權限。初次排查時建議只保留一種流量接管方式，先確認運作正常，再依客戶端說明搭配使用。兩個開關同時啟用不代表速度更快，也無法自動修復失效節點。若啟用 TUN 後出現異常，請檢查介面、路由及 DNS 記錄，不要繼續疊加其他代理工具。

在訂閱或設定管理頁面找到自動更新間隔，依需求設定，並確認更新是在客戶端執行時進行，還是由背景服務執行。更換訂閱網址後，先手動更新一次，確認更新時間及錯誤訊息。個人規則、代理群組調整及 DNS 設定，應盡量透過客戶端支援的覆寫或合併功能保存，不要只修改下載的訂閱內容。更新後確認目前啟用的設定；若原有節點遭移除，也要重新選取代理群組中的節點。

讓電腦和手機連上彼此可存取的可信任區域網路，在客戶端啟用允許區域網路連線，並確認監聽位址接受區域網路要求。手機 Wi-Fi 的手動代理伺服器應填入電腦的區域網路位址，連接埠則填入客戶端實際使用的 HTTP 或混合連接埠，而非手機自己的回送位址。電腦防火牆只需允許必要的本機網段；不要將代理連接埠轉送至公網。手動設定的 HTTP 代理不會涵蓋手機上的所有應用程式，請另外確認各應用程式是否使用此設定。

GeoIP 資料用於依 IP 所屬地區比對規則；更新失敗可能造成地區判斷不準確，但不會直接讓所有網域規則失效。先檢查記錄中的資料檔案路徑及更新網址是否可存取，再確認設定使用的是 MMDB 或其他地理資料格式，以及相應檔案是否存在。不同格式的檔案不能只靠重新命名互換。更新完成後，依客戶端要求重新載入設定或重新啟動核心，並透過連線記錄確認相關規則是否實際命中。

先區分下載失敗和內容解析失敗。下載失敗時，檢查訂閱是否到期、網址是否已重設、系統時間是否正確，以及目前網路能否連上訂閱服務。解析失敗時，查看回應內容是否其實是網頁或錯誤訊息，再確認設定格式及核心支援狀況。不要短時間內連續大量更新，部分服務會限制要求頻率。若舊設定仍可使用，請先保留並暫停覆寫；回報服務提供者時，提供狀態碼及已遮蔽敏感資訊的錯誤內容，不要公開完整訂閱網址。

全部逾時不一定代表訂閱失效，也可能是測試網址無法連線、本機 DNS 異常、防火牆封鎖或節點服務故障。先確認裝置不經代理時可正常上網，再選一個節點實際連線至目標網站，並對照連線記錄判斷。測試結果僅代表對特定測試網址的探測，不能取代實際連線。若改用可信任的網路後恢復，請繼續檢查原網路的限制；若只有特定節點失敗，請換其他節點測試，再向服務提供者回報節點及發生時間。

先在客戶端關閉系統代理與 TUN，再結束程式，確認系統網路設定沒有殘留指向本機的代理。基本網路恢復後重新啟動客戶端，只啟用一種流量接管方式，並選擇已知可用的節點。觀察問題出在網域名稱解析、節點連線還是規則比對；必要時可短暫切換至全域模式比較。若結束程式後仍無法上網，請繼續檢查系統 DNS、路由及其他 VPN 設定。尚未確認原因前，不要同時修改多個網路參數。

部分使用 AppContainer 沙箱的 Windows 應用程式，預設無法存取本機回送代理，因此可能出現瀏覽器正常、應用程式卻連線失敗的情況。先確認該應用程式確實使用本機代理，再使用客戶端提供的 UWP 回送工具，只為需要的應用程式新增回送豁免；此操作可能需要系統管理員權限。並非所有市集應用程式都受相同限制；若清單中沒有該應用程式，請勿隨意套用其他套件名稱。也可依客戶端文件評估使用 TUN，並透過連線記錄確認效果。

先查看記錄中是否有解析逾時、解析失敗或解析器連線錯誤，再確認設定中的 DNS 上游是否能依預期路徑存取。加密 DNS 位址正確，不代表目前網路一定連得到；其伺服器網域名稱可能也需要先行解析。若使用 fake-ip，請確認相關流量已由客戶端接管，並檢查是否與其他 DNS 工具衝突。修改 DNS 後重新建立連線，必要時清除系統快取。不要一次替換所有解析設定；請保留可還原的設定，逐項驗證解析及實際連線。