排查 Clash 問題時，先確認問題出在哪個環節：設定檔是否成功載入、節點能否連線，以及應用程式流量是否進入用戶端。依序檢查，比起同時切換模式、修改連接埠或重新安裝，更容易找出原因。

01 / Clash、用戶端和 mihomo 有什麼關係？

用戶端負責操作介面，核心負責處理連線。匯入訂閱、選取節點和啟用系統代理，通常都在用戶端中操作；實際讀取規則、連線至伺服器的則是核心。Clash Meta 專案後來更名為 mihomo，網路上的舊教學可能仍使用舊名稱。

遇到「不支援的代理類型」或「未知欄位」時，別只比對應用程式圖示。請在用戶端的「關於」或核心資訊頁面記下名稱和版本，再確認訂閱是否適用於該核心。舊版 Clash 支援的設定範圍，與目前的 mihomo 並不完全相同。

02 / 安裝完成後，為什麼沒有節點可選？

安裝用戶端不代表已取得代理設定。節點是遠端伺服器的連線資訊，通常由服務提供者透過訂閱提供。訂閱連結是取得及更新設定的網址，不是開啟後就能直接使用的一般網頁。

  1. 從可信來源取得適用於目前用戶端或核心的訂閱連結，別把帳戶管理頁面的網址當成訂閱連結。
  2. 開啟用戶端的「設定檔」頁面，選擇新增遠端設定檔或從 URL 匯入，再貼上完整連結。
  3. 匯入成功後，選取這份設定檔，讓它成為目前生效的設定檔。
  4. 前往「代理」頁面，展開規則引用的策略群組，再選取其中一個節點。策略群組是一組可供規則使用的連線選項。

設定檔清單中出現名稱，不代表核心已切換至該設定檔。如果代理頁面仍只有直連選項，先確認目前選取的設定檔，再檢查日誌是否顯示載入失敗。

03 / 訂閱匯入失敗，先檢查連結還是網路？

先看錯誤訊息，再決定檢查方向。逾時、權限錯誤和解析錯誤是不同問題。一直按更新通常只會重複出現同一個錯誤。

錯誤訊息或現象優先檢查項目下一步
連線逾時、網域解析失敗取得訂閱時使用的網路路徑確認一般網頁能正常開啟，再檢查更新功能是否依賴已失效的代理
HTTP 401 或 403訂閱憑證、帳戶狀態、存取限制前往服務提供者的頁面重新取得連結，別反覆公開測試舊連結
HTTP 404網址是否完整、介面是否已變更重新複製訂閱連結，確認路徑或查詢參數沒有遺漏
YAML 解析失敗回傳內容是否確實為設定檔確認回傳內容是否為登入頁、錯誤頁或不支援的訂閱格式

三步驟縮小問題範圍

  1. 重新複製連結、刪除前後空白，並確認沒有混入中文標點或換行。
  2. 確認服務提供者提供的格式選項，選擇符合目前核心的 Clash 或 mihomo 設定檔。
  3. 如果目前的代理已失效，而訂閱更新設定為透過代理取得，可暫時改用直連更新；反過來說，若直連無法存取訂閱網址，就需要改用一條可正常運作且允許使用的連線路徑。

04 / 匯入成功卻提示設定錯誤，該從哪裡修改？

取得成功和載入成功是兩回事。用戶端可能已下載檔案，但核心無法解析其中內容。先開啟「日誌」，找出這次載入時最早出現的設定錯誤，別只看最後一則啟動失敗訊息。

以下兩行僅示範規則如何引用群組名稱，並非完整設定檔：

rules:
  - DOMAIN-SUFFIX,example.com,網頁代理
  - MATCH,DIRECT

這裡的「網頁代理」必須存在於設定檔的 proxy-groups 中；MATCH 代表比對其餘流量。修改前請先備份原始檔案。遠端訂閱下載的副本可能在下次更新時被覆蓋；若要長期調整，應使用用戶端支援的覆寫或合併功能，並確認設定確實生效。

05 / 節點測速全都逾時，代表節點都故障了嗎？

測速逾時只表示測試請求未能在期限內完成。可能是節點無法連線，也可能是測試網址、DNS 或設定檔選擇有問題。測速數字通常反映連線至指定測試網址的回應時間，不等於下載頻寬。

  1. 先確認裝置本身能連線至一般直連網站，排除網路中斷和 Wi-Fi 登入頁面的影響。
  2. 確認目前設定檔已成功載入，且訂閱尚未到期、流量尚未用完。
  3. 手動選取一個節點，連線至允許使用的目標網站，同時查看連線資訊和日誌。
  4. 若實際瀏覽正常但測速逾時，請檢查測試 URL、逾時時間和測試方式；若實際瀏覽也失敗，再換另一個節點比較。

透過對照測試判斷，別只憑延遲下結論

例如，一個節點顯示 80 ms，另一個顯示 180 ms，只能表示它們在這次測試中的回應時間不同，不能據此認定前者的下載速度一定較快。若多個節點在家中網路都無法連線，改用手機熱點後恢復，應優先檢查本機網路路徑，而非立刻重新安裝用戶端。

日誌出現 connection refused 通常表示連線遭拒；timeout 表示等待時間超出限制；no such host 通常代表網域解析有問題。記下具體目標和時間，才能判斷是本機入口、遠端節點或目標網站發生錯誤。

06 / 已啟用系統代理，為什麼瀏覽器還是沒有變化？

系統代理只是告知遵循該設定的應用程式，將請求傳送至本機代理連接埠。它不會自動接管所有程式。第一步是確認系統設定的位址，與核心實際監聽的位址一致。

  1. 在用戶端設定或執行中的設定檔裡，尋找 HTTP 連接埠或混合連接埠。混合連接埠可同時接收 HTTP 和 SOCKS 代理請求。
  2. 假設本機混合連接埠確實是 7890，系統代理就應設為 127.0.0.1:7890。請勿將範例連接埠視為所有用戶端的預設值。
  3. 在 Windows 11 中，開啟「設定」→「網路和網際網路」→「Proxy」，檢查手動 Proxy 設定；在 macOS 中，開啟「系統設定」→「網路」→目前的連線→「詳細資訊」→「代理伺服器」。
  4. 檢查瀏覽器的代理擴充功能、獨立代理設定，以及其他正在執行的網路工具，避免它們覆寫系統設定。

在 Windows PowerShell 中，可使用以下命令直接測試本機 HTTP 代理入口。請先將連接埠改為實際使用的值：

curl.exe --proxy http://127.0.0.1:7890 --connect-timeout 10 -I https://example.com

這個命令會明確指定代理，不受瀏覽器是否遵循系統代理影響。它只能證明對該測試網站的一次請求結果：如果無法連線至 127.0.0.1，請先檢查核心是否正在執行、連接埠是否正確；如果請求已進入用戶端但仍無法瀏覽，再檢查規則和節點。

07 / 規則、全域、直連模式該選哪一種？

日常使用先選規則模式，排查問題時再短暫切換。三種模式會決定進入核心的請求如何選擇出口，但不會決定應用程式流量是否進入用戶端。

規則通常會由上而下比對，符合後便套用相應策略。因此，同一個網站在規則模式下直連、在全域模式下走節點，可能是規則結果不同，不一定是用戶端故障。開啟「連線」查看目標網域、符合的規則和實際策略鏈，比只看網頁能否開啟更有幫助。

08 / 什麼時候需要 TUN 模式？啟用後斷網怎麼辦？

需要接管不遵循系統代理的流量時，再考慮使用 TUN。TUN 是虛擬網路介面，會透過系統路由將符合條件的流量交給核心處理。可能需要管理員權限或用戶端服務模式，實際支援情況取決於系統、核心和設定。

啟用前先確認基本連線

  1. 先透過明確指定代理的請求或瀏覽器，確認至少有一個節點能正常連線至目標網站。
  2. 記下目前的系統代理、DNS 和其他 VPN 狀態，避免同時變更多個設定。
  3. 依用戶端要求安裝服務或授予網路權限，再啟用 TUN，並確認是否建立介面、是否出現路由或權限錯誤。

如果啟用後連直連網站都無法開啟，先關閉 TUN，確認原本的網路是否恢復，再檢查權限、路由衝突和 DNS 設定。DNS 會將網域名稱解析為 IP 位址；DNS 設定異常時，可能出現連線仍正常但網域無法解析的情況。

不要將其他教學中的 fake-ip、DNS 劫持或路由欄位整段貼進現有設定檔。fake-ip 是透過虛擬位址輔助網域映射的機制，是否適用須依目前的 DNS 和路由方案判斷。企業網路、其他 VPN 和虛擬機網路也可能與 TUN 衝突。

09 / 瀏覽器能用，為什麼遊戲或商店應用程式不能用？

先查看失敗應用程式的連線是否出現在用戶端中。瀏覽器能用，只代表瀏覽器的連線路徑正常，不代表其他應用程式採用相同的代理方式。

迴路豁免只處理特定應用程式存取本機介面的限制，無法修復過期訂閱，也無法讓不支援的協定突然變得可用。先確認應用程式身分和失敗路徑，再使用可信用戶端提供的對應工具；不要為了測試而一次放行所有應用程式。

10 / 更新訂閱或退出用戶端後出現異常，如何安全復原？

先恢復上一條可用路徑，再處理長期修復。更新訂閱可能會變更節點名稱、策略群組成員和規則；退出用戶端後，系統也可能仍保留指向本機連接埠的代理設定。這兩類問題應分開處理。

訂閱更新後無法使用

  1. 確認目前啟用的是哪一份設定檔，以及最近一次更新是否確實成功。
  2. 重新檢查策略群組的選擇。原本手動選取的節點若已改名或移除，群組中的結果可能隨之變更。
  3. 查看設定檔載入日誌；若有確認可用的本機備份，可暫時切換回去測試，但請留意其中的節點和憑證也可能已過期。
  4. 恢復後再逐項移轉自訂規則，避免直接將舊規則覆蓋到結構已變更的新設定檔。

退出後無法上網

先確認系統代理是否仍指向 127.0.0.1。用戶端停止監聽後，繼續使用這個代理就會連線失敗。請關閉殘留的代理設定；若曾使用 TUN，也要確認介面和路由已恢復。別以刪除整個設定資料夾取代這項檢查。

延伸閱讀：依問題選擇內容

初次安裝與匯入可接著閱讀使用文件；需要確認欄位階層、策略群組引用和規則順序時，請參閱YAML 手冊；常見操作問題可到常見問題繼續查找。排查時一次只修改一個項目，並保留修改前後的結果。