訂閱連結匯入失敗或更新失敗怎麼辦?

訂閱失敗的常見原因包括連結過期、token 錯誤、網路存取失敗、TLS 驗證失敗、用戶端不支援回傳格式或伺服器端限流。

  • 訂閱與設定匯入
  • 疑難排解
簡要回答

訂閱失敗常見原因包括連結過期、token 錯誤、網路存取失敗、TLS 驗證失敗、用戶端不支援回傳格式或伺服器端限流。重新從服務供應商管理介面複製完整 URL,在用戶端的遠端訂閱入口更新;狀態碼不變時直接讓提供方核對帳號和介面。

401、403、404 和解析錯誤分別說明什麼

在日誌裡找到本次更新對應的 HTTP 狀態或首個解析錯誤;401/403 指向認證,404 指向位址,回傳 HTML 則說明拿到的不是設定。

  • 連結是否完整,是否包含 token 或認證參數(參見 Secret 與 token 安全
  • 瀏覽器存取是否回傳 401、403、404 或空白內容
  • 用戶端日誌是否出現 timeout、TLS、YAML 或 parse 錯誤
  • 訂閱回傳內容是否為 Clash/Mihomo 支援的設定格式

根據回傳結果重新匯入訂閱

  1. 複製完整訂閱連結,避免多出空格和換行
  2. 在用戶端中使用訂閱匯入入口,不要當作本機 YAML 檔案匯入(參見 設定入門
  3. 根據 HTTP 狀態判斷是否為認證、過期或伺服器端問題
  4. 如果回傳 YAML 解析錯誤,把錯誤行號意見回饋給設定提供方

訂閱連結通常包含私密 token,應按密碼處理

不要把完整訂閱 URL 發到公開論壇、工單截圖或 GitHub issue

更新失敗不一定代表用戶端故障