先將「更新訂閱」拆成五個檢查點

OpenClash 更新訂閱不是單純將檔案下載到路由器。官方實作會讀取訂閱項、發出請求、測試設定、用 YAML 驗證內容、檢查代理欄位，然後產生或寫入對應設定。早期階段成功，不表示後續檔案必然可由核心載入。

OpenClash 訂閱更新的五個階段
階段成功只代表失敗時優先查看
URL 請求路由器取得 HTTP 回應DNS、TLS、回應碼、重新導向
內容辨識回應像是設定檔是否回傳登入頁、錯誤文字或空內容
YAML/核心驗證語法與關鍵結構可解析錯誤行、縮排、不相容欄位
寫入設定新檔或處理結果已儲存空間、權限、檔名與儲存錯誤
選中並載入目前核心真正使用新設定作用中設定路徑、啟動日誌與連接埠衝突

依這五層閱讀日誌，比圍繞一個紅色提示不斷更換 DNS、轉換服務與核心更有效。先找到第一個失敗階段，後面的錯誤常只是連鎖結果。

手動更新前保留可用設定與訂閱私密

路由器的網路變更容易同時切斷排錯通道。更新前先備份目前可啟動的 YAML、OpenClash UCI 設定與相關自訂檔案，記下作用中設定名稱。備份放到與路由器獨立的可信位置，但不上傳到公開儲存庫或群組。

  • 校準系統時間：時間大幅錯誤可能破壞 HTTPS 憑證驗證，先檢查 NTP 同步。
  • 檢查剩餘空間：設定、規則集與暫存檔都需寫入，下載成功無法排除後續寫入失敗。
  • 確認 WAN 與 DNS：不依賴本次待更新設定時，路由器本身應能解析訂閱網域並建立 HTTPS。
  • 保護 URL：訂閱連結常含 Token。複製日誌或截圖時要遮住查詢參數，不用公開線上解析站「測試」。

不要刪除唯一可用設定後再排查。保留舊設定可驗證外掛程式與核心仍可運作，也保留查閱官方文件的網路通道。

執行一次可觀察的手動更新

暫時關閉自動更新，只選一份訂閱測試。在訂閱頁核對啟用狀態、設定名、地址、User-Agent 與是否使用轉換。先記錄原值，不要同時更換多個轉換地址或自訂範本來嘗試。

  1. 清空日誌或標記起點，記下準備點擊更新的時間。
  2. 對單一訂閱發起一次更新，等待後端結束，不重複點擊或不斷重新整理頁面。
  3. 從日誌起點開始，找到下載、測試、格式驗證、缺少代理欄位或寫入提示。
  4. 成功時核對設定檔時間與大小，並確認 OpenClash 目前選中的路徑就是這份檔案。
  5. 重啟或重載核心，查看第一條解析錯誤，再用一條連線驗證實際流量。

官方腳本具有「下載後測試設定」、「格式驗證失敗」與「更新設定沒有代理欄位」等分支。因此，按鈕已結束並不等於新設定通過後端所有檢查。

對照日誌關鍵句，只修復目前失敗的一層

OpenClash 訂閱更新日誌與處理方向
日誌或現象常見含義下一步
DNS / connect / TLS 錯誤尚未取得有效訂閱內容檢查路由器 DNS、時間與目標網域可達性
HTTP 有回應但格式驗證失敗可能是 HTML、空文字或不相容 YAML查回應類型、訂閱有效期與 User-Agent
Has No Proxy Field內容沒有腳本預期的代理節點結構確認回傳的是 OpenClash/Mihomo 可用格式
Write file failed處理後內容無法寫入檢查空間、檔案系統、目錄權限與檔名
更新後仍是舊節點新檔可能已寫入，但選中路徑或核心未重載對照作用中設定與啟動日誌

使用訂閱轉換就新增一層外部依賴。原訂閱可用，轉換服務、範本取得或參數相容性卻仍可讓結果失敗。保存原設定後，可以服務供應方直接提供的 Mihomo/Clash YAML 做對照，判斷是否出在轉換層。

分享日誌前特別檢查 URL。官方腳本的除錯資訊可能包含訂閱地址或處理參數，不可將整段原樣貼到公開 issue。

恢復手動更新後才重新啟用排程

修復的完成條件包括：日誌顯示單一訂閱完成下載與驗證；新檔已寫入；目前設定路徑指向它；核心重載無錯；並且一個可觀察的節點或規則變化已出現。只看頁面跳出提示不足以驗證整體。

官方 issue #5239 曾回報介面可能未清楚呈現後端失敗結果的特定問題。它說明不應只依賴按鈕瞬間回應，卻不表示每次更新失敗都是同一介面缺陷。仍要用當前版本日誌判斷。

  1. 保留已驗證的舊設定與修復後新設定，不立即清理還原材料。
  2. 手動重複更新一次，確認結果不依賴偶然 DNS 快取或暫時轉換。
  3. 將自動更新設為合理頻率，錯開路由器重啟與 WAN 重撥時段。
  4. 下次排程後檢查日誌時間、檔案時間與核心狀態，完成一次自動流程驗收。

如果問題在同一階段穩定重現，再向 OpenClash 回報外掛版本、OpenWrt 版本與架構、重現時間、去除私密的最小日誌，以及是否啟用轉換。這比單純寫「點更新沒反應」更容易獲得可驗證的回應。

官方來源與版本邊界

版本號、檔案名稱與介面文字可能隨專案更新而變動，操作前請以連結中的專案文件為準。