· 故障排除 · 約 7 分鐘閱讀

Clash 訂閱連結失效或解析失敗:錯誤訊息與逐步檢查指南

整理 Clash 訂閱匯入失敗的常見原因,涵蓋連結過期、格式不相容、網路阻擋與 YAML 語法錯誤,並提供逐步檢查方法。

先確認失敗發生在哪個步驟

先保留仍可使用的舊設定,再開啟 Clash 用戶端的記錄或訂閱更新詳情。手動更新一次並記下時間,找出第一則相關錯誤。匯入訂閱會經過三個步驟:取得回應、解析設定、由核心載入。介面顯示的「更新失敗」可能指其中任何一步。

錯誤訊息或現象優先檢查項目
401、403、404帳戶狀態、連結完整性、伺服器存取限制
no such host、timeout、x509網域解析、連線路徑、憑證信任
HTTP 200,卻顯示格式無效回應內容是設定檔、登入頁面,還是通用節點清單
yaml: line 12 或 unsupported proxy type分別檢查 YAML 結構與核心支援範圍

401、403、404:檢查連結與帳戶狀態

  1. 從服務商的帳戶頁面重新複製連結。選擇標示適用於 Clash 或 mihomo 的訂閱入口。確認貼上的內容沒有引號、換行或尾端空白。保留原始查詢參數,不要手動刪改 ? 後的內容,也不要從介面上被截斷的顯示文字複製。
  2. 確認有效期限與權杖狀態。帳戶仍可登入,不代表舊訂閱網址仍然有效。若剛續訂、重設訂閱或轉換服務,請優先使用帳戶頁面目前提供的網址建立新設定;成功載入後,再考慮取代舊項目。
  3. 依狀態碼縮小問題範圍。401 通常表示驗證未通過;403 表示要求遭拒,可能與帳戶權限、存取頻率或閘道規則有關;404 可能是路徑已變更,也可能是伺服器隱藏了資源狀態。429 表示要求過多,請依服務商指示等待,不要連續重新整理。

如果瀏覽器可以開啟,但 Clash 用戶端回傳 403,請先用 Safari 的「檔案」→「新增無痕瀏覽視窗」再次確認。一般視窗可能帶有已登入的 Cookie,而訂閱更新器通常不會共用瀏覽器工作階段。無痕瀏覽的結果也不一定與 Clash 用戶端完全相同,兩者可能使用不同的要求識別資訊與連線路徑。如果只有登入後才能看到內容,請向服務商確認複製的是訂閱直連網址,而不是網頁入口。

逾時、解析失敗與憑證錯誤:檢查 macOS 網路

確認目前連線與代理連接埠

在 macOS 13 或更新版本中,開啟「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「代理伺服器」。確認網頁代理伺服器與安全網頁代理伺服器指向仍在監聽的位址。例如系統設定填入 127.0.0.1:7890,但 Clash 用戶端目前的混合連接埠已改為 7897,讀取系統代理設定的 App 就可能無法連線。這兩個連接埠僅供排查示例,實際設定請以 Clash 用戶端介面為準。

訂閱更新器是否使用系統代理,取決於所用的 Clash 用戶端及其下載設定。如果更換設定前還能更新,請先切回舊設定測試。如果系統代理或 TUN 可能影響測試,請在允許使用的網路上每次只調整一個選項,並比對同一條訂閱的結果。Safari 能開啟頁面,不代表更新器一定能連線。

分辨 DNS、逾時與 TLS 問題

  • no such host:先確認網域拼字,再查看目前網路服務「詳細資訊」中的「DNS」。連上公共 Wi-Fi 時,先確認已完成網路登入頁面的驗證。
  • i/o timeout:先確認錯誤發生於解析、連線,還是等待回應。有條件時,使用另一個獲准的網路重新測試一次。如果只在某個網路上失敗,優先檢查該網路的代理設定或存取規則,不要立刻重設訂閱。
  • x509: certificate signed by unknown authority 或憑證過期:檢查「系統設定」→「一般」→「日期與時間」,確認系統時間正確。若問題仍未解決,請聯絡網路管理員或服務商;不要停用憑證驗證,也不要安裝來源不明的根憑證。

HTTP 200 仍解析失敗:確認回應格式

200 只表示伺服器已傳回內容,不代表內容就是設定檔。如果 Clash 用戶端可以預覽回應,請先查看開頭與重要欄位。若出現 <!doctype html>、登入提示或閘道提示,請查明回應為何變成網頁;若出現 JSON 錯誤物件,請先查看伺服器提供的錯誤訊息。將這些內容改成 .yaml 副檔名並不會改變格式。

  • 完整設定檔:通常會看到 proxies: 或 proxy-providers:,也可能包含 proxy-groups: 與 rules:。最上層欄位與引用關係必須符合目前核心的要求。
  • 僅供代理提供者引用的資料:有些 YAML 檔案只包含節點清單,供現有設定中的 proxy-providers 使用。取得這類網址時,請先詢問服務商是否提供完整設定檔入口,不要假設它可以直接取代整份設定。
  • 通用節點訂閱:回應可能是 Base64 文字,也可能逐行列出 ss:// 等 URI。能否匯入取決於 Clash 用戶端是否明確支援此類入口;否則請改用服務商提供的相應格式。

同一個網址也可能依要求識別資訊傳回不同格式。如果瀏覽器預覽與記錄中的內容不一致,請優先使用服務商為目前 Clash 用戶端提供的入口。如果記錄能區分主要設定檔 URL 和代理提供者 URL,也要確認失敗的是哪一個:主要設定檔下載成功,不代表它引用的節點資料也已更新。

YAML 行號與核心錯誤:分開處理

有行號時,先檢查縮排與清單格式

使用本機純文字編輯器開啟設定檔副本。如果記錄指向第 12 行,也要檢查第 11 行及同一層級的欄位。解析器常要讀到下一個項目時,才發現上一項少了引號、冒號或清單標記。縮排請使用空格,不要使用 Tab;同一層級的內容要對齊。以下僅示範規則清單的寫法,並非完整設定檔:

rules:
  - DOMAIN,example.com,DIRECT
  - MATCH,DIRECT

遠端訂閱更新可能會覆寫手動編輯的內容。如果剛下載的原始回應就有語法錯誤,請將去識別化後的行號與錯誤類型回報給服務商;如果只有套用覆寫後才出現錯誤,請先停用最近修改的覆寫項目,再匯入副本測試。

解析成功但無法載入時,再檢查核心

unsupported proxy type 不是縮排錯誤,而是目前的載入器不支援設定中的節點類型。請在 Clash 用戶端的「關於」頁面或啟動記錄中記下用戶端版本與核心版本,例如記錄中的 mihomo v1.19.0;App 版本不能取代核心版本。為 Clash Meta(mihomo)準備的設定可能使用舊版 Clash 核心不支援的通訊協定或欄位,請依服務商說明與核心文件確認。

如果錯誤訊息指出找不到代理或策略群組,請檢查名稱引用。rules 中指定的目標必須對應到內建策略、節點或策略群組;策略群組列出的節點名稱也必須存在。特別留意覆寫是否變更了群組名稱,卻未同步更新規則。不要只刪除錯誤行:刪除最後的兜底規則或指定錯誤策略,可能讓設定成功載入,卻改變流量的路由方式。

修復後,分別確認更新、載入與連線

  1. 確認更新狀態。手動更新一次,核對該項目的更新時間與記錄,確認取得的是新回應而非舊快取。如果使用遠端代理提供者,也要檢查其更新結果。
  2. 確認載入狀態。明確選取剛匯入的設定,查看核心是否接受,以及節點和策略群組是否出現。即使更新成功,若尚未切換設定,介面仍可能顯示舊節點。
  3. 確認連線狀態。分別測試一個預期直接連線的網站,以及一個預期透過代理連線的網站,並在連線記錄中確認規則與出站方式符合預期。如果只有節點逾時,問題已從訂閱匯入轉為節點連線狀況,無須繼續更換訂閱網址。

若問題仍未解決,請記下 macOS 版本、Clash 用戶端版本、核心版本、更新時間、HTTP 狀態碼與第一則已遮蔽敏感資訊的錯誤,並註明能否在另一個獲准的網路上重現。連線與流量接管問題可參閱設定問題診斷。

下載 Clash