訂閱更新失敗時的排查順序

先保留可用配置和錯誤證據

訂閲更新失敗不一定意味着當前節點全部失效,也不一定是客户端安裝損壞。不要一開始就刪除現有訂閲;先記錄最後成功更新時間、此次失敗時間和錯誤原文,並備份仍能工作的配置。區分下載失敗、下載成功但解析失敗,以及導入成功但節點無法連接,這三類問題需要不同的排查路徑。

確認導入的是訂閲地址

重新從可信提供方獲取地址,檢查是否複製了多餘空格、缺少字符,或誤用了控制枱登錄頁。鏈接參數中的令牌可能是認證信息,不能隨意刪除,也不要為了截圖方便把完整地址暴露出來。如果服務額度耗盡、訂閲過期或提供方重置了令牌,需要由提供方處理,反覆重裝客户端通常無效。

根據 HTTP 錯誤縮小範圍

401 或 403 通常提示認證或訪問限制,404 可能表示地址失效,429 可能是請求過於頻繁,5xx 則應檢查服務端狀態;這些只是線索,仍要結合響應內容判斷。超時和域名解析錯誤更偏向網絡可達性問題。避免短時間連續點擊更新,按提供方要求等待後重試,並記錄不同網絡環境下是否一致。

檢查更新請求走哪條路線

瀏覽器能打開一個網站,不代表客户端的訂閲更新請求使用相同網絡路徑。檢查當前版本是否支持選擇訂閲更新的代理方式,並在你有權使用的網絡中做單變量對照。核對系統日期時間;如果出現證書錯誤,應檢查時間、地址與可信證書鏈,不要以永久跳過證書驗證作為解決方案。

下載成功但解析失敗

返回的內容可能是登錄提示、錯誤頁面或客户端不支持的格式。結合錯誤中的行號與字段名判斷,但不要把完整私有配置貼到公共論壇。若配置由提供方生成,請提供脱敏錯誤並要求檢查兼容性;若自己編輯,先恢復最小可用版本,確認縮進、列表結構和引用的代理組名稱。

確認恢復,並關閉泄露風險

更新成功後確認當前選中的是新配置,代理組和節點列表完整,再對一個目標執行連接測試。記錄是哪一步解決了問題,避免下次再次盲目修改。如果訂閲鏈接已公開泄露,應在提供方處撤銷或重新生成憑據;只刪除公開帖子不能保證舊鏈接已失效。

下一步

下載中心 · 常見問題

參考資料(專案官方文件)