訂閱失敗常見原因包括連結過期、token 錯誤、網路存取失敗、TLS 驗證失敗、用戶端不支援回傳格式或伺服器端限流。重新從服務供應商管理介面複製完整 URL,在用戶端的遠端訂閱入口更新;狀態碼不變時直接讓提供方核對帳號和介面。
401、403、404 和解析錯誤分別說明什麼
在日誌裡找到本次更新對應的 HTTP 狀態或首個解析錯誤;401/403 指向認證,404 指向位址,回傳 HTML 則說明拿到的不是設定。
- 連結是否完整,是否包含 token 或認證參數(參見 Secret 與 token 安全)
- 瀏覽器存取是否回傳 401、403、404 或空白內容
- 用戶端日誌是否出現 timeout、TLS、YAML 或 parse 錯誤
- 訂閱回傳內容是否為 Clash/Mihomo 支援的設定格式
根據回傳結果重新匯入訂閱
- 複製完整訂閱連結,避免多出空格和換行
- 在用戶端中使用訂閱匯入入口,不要當作本機 YAML 檔案匯入(參見 設定入門)
- 根據 HTTP 狀態判斷是否為認證、過期或伺服器端問題
- 如果回傳 YAML 解析錯誤,把錯誤行號意見回饋給設定提供方
訂閱連結通常包含私密 token,應按密碼處理
不要把完整訂閱 URL 發到公開論壇、工單截圖或 GitHub issue
更新失敗不一定代表用戶端故障
