先分清下載、解析與啟用設定
匯入遠端訂閱會經過取得內容、讀取設定與啟用設定三個步驟。這些步驟可能出現在同一個介面,但故障原因並不相同。先記下錯誤是在按下匯入、手動更新,還是切換至新設定時發生。以 Clash Verge Rev 為例,可在側邊欄的「訂閱」管理設定,並從「日誌」查看切換設定後核心回報的錯誤。不同版本的按鈕位置可能略有不同;若下載失敗,也要保留訂閱頁面的提示,因為請求可能在內容交給核心前就已失敗。
| 錯誤訊息或現象 | 優先檢查 |
|---|---|
| HTTP 401、403、404 或 410 | 伺服器拒絕存取或路徑無效;確認目前的訂閱網址與帳戶狀態。 |
no such host 或 lookup … timeout | 訂閱網域解析狀況,以及目前網路的 DNS 狀態。 |
certificate has expired or is not yet valid | 裝置時鐘、憑證有效期限,以及錯誤訊息涉及的網域。 |
類似 yaml: line 12 的提示 | 回應內容是否為 YAML,再檢查本機副本第 12 行及其前幾行。 |
| 設定已匯入,但啟用時顯示找不到策略群組 | 規則的目標、群組名稱,以及合併設定後的引用關係。 |
訂閱連結過期、失效或回傳登入頁面
- 前往訂閱服務商的帳戶頁面確認服務狀態,並重新複製適用於該用戶端的訂閱網址。確認網址是否以預期的
https://開頭,複製時也不要帶入引號、換行或整段分享說明。請勿手動刪除查詢參數。 - 確認服務商近期是否重設過訂閱權杖。帳戶仍在有效期內,不代表連結一定有效;權杖重設後,舊連結也可能失效。先保留目前可用的舊設定,再依服務商說明更新網址或新增一筆設定進行測試。
- 比對服務狀態與 HTTP 回應。
401通常表示驗證有問題;403代表伺服器拒絕請求,可能與存取政策有關;404也可能只是路徑輸入錯誤。429表示請求過於頻繁;若回應含有Retry-After,請依指示等待,避免持續點選重新整理。
HTTP 200 只代表收到回應。登入頁面、公共 Wi-Fi 的驗證頁面,以及伺服器錯誤提示,也可能以 200 回傳。若服務商支援將回應儲存至本機,可用文字編輯器查看開頭;若出現 <!doctype html> 或 <html>,應先查明為何取得的是網頁,而不是修改 YAML。瀏覽器可能帶有登入 Cookie,但用戶端的請求通常不會共用這個工作階段,因此能在瀏覽器開啟,不能單獨證明訂閱可以匯入。
網路逾時、DNS 與憑證錯誤
先確認請求能否連上訂閱服務
HTTPS 網址若未明確指定連接埠,通常會使用 TCP 443。no such host 表示錯誤發生在網域解析階段;若 dial tcp 後接著連線逾時,請查看日誌是否已列出目標 IP。單獨出現 timeout,無法判斷問題出在 DNS、建立連線,還是伺服器回應過慢。先完成目前網路要求的登入,再透過一個有權限使用且可信任的網路進行比對;每次只更換網路,不要同時更換連結與設定。
如果日誌明確顯示無法連線至 127.0.0.1 的某個連接埠,請先將該連接埠與用戶端顯示的本機監聽連接埠比對。系統代理可能仍指向已關閉的用戶端,也可能是訂閱更新設定為透過尚未啟動的代理連線。先記下原本的設定,恢復本機正常連線後再試一次。啟用 TUN 無法修復過期權杖或錯誤的檔案格式,也不應作為首次匯入失敗時的預設處理方式。
確認裝置時間,再判斷憑證錯誤類型
在 Windows 11 中開啟「設定 → 時間與語言 → 日期與時間」,確認「自動設定時間」已啟用,並選擇「立即同步」。同時確認顯示的日期與時區。同步時間後若仍出現憑證過期提示,請向服務商確認訂閱網域的憑證狀態。若提示 certificate signed by unknown authority,則應檢查系統信任鏈,或請管理員確認受管理網路的憑證政策。請勿關閉憑證驗證來匯入訂閱。
YAML 解析錯誤與 Clash、mihomo 格式差異
訂閱是一種提供內容的方式,不代表採用固定格式。同一服務商可能分別提供 Clash 設定、mihomo 專用設定,以及通用節點清單。由單筆節點 URI 組成的文字,或經過編碼的節點清單,都不能直接當成完整的 Clash YAML 匯入。只有 proxies 清單的檔案,也可能是供 proxy-providers 引用的資料,而不是預期中包含代理群組與規則的主要設定。請優先在服務商提供的選項中,選擇與用戶端及核心相符的格式。
- 語法錯誤:若曾在本機編輯設定,請檢查錯誤行與上一段的縮排層級、清單項目前的連字號,以及未成對的引號。縮排請使用空格。
mapping values are not allowed in this context通常表示結構有問題,錯誤行不一定是最早寫錯的位置。 - 欄位或協定不支援:Clash Meta 後來以 mihomo 的名稱持續維護。原版 Clash 與 mihomo 支援的設定範圍不同,例如原版 Clash 不支援
hysteria2節點。遇到不支援的代理類型時,請確認實際執行的核心與版本;不能只看用戶端名稱,也不要把類型名稱改成其他協定來通過驗證。 - 引用錯誤:設定即使成功讀取,也可能無法啟用。例如規則
MATCH,手動選擇引用名為「手動選擇」的策略;合併覆寫後,若該策略已更名或刪除,核心載入時就可能回報找不到策略。請檢查最終生效的設定,而不只是遠端來源檔案。
只有在原始訂閱確實是設定檔時,才適合用本機副本診斷語法。如果用戶端支援匯入本機檔案,可用未修改的副本進行比對:本機設定能啟用、遠端仍失敗,應優先檢查下載流程與回應差異;兩者都在同一行出現語法錯誤,則應優先檢查來源檔案。遠端更新可能覆蓋本機修改;確認問題後,請回報服務商,或將必要修改保存在用戶端支援的獨立覆寫設定中。
更新失敗但舊設定仍在:如何重新測試
舊設定仍顯示節點,表示用戶端可能正在使用上次儲存的內容,不能據此判定這次更新成功。反過來說,新設定已啟用但沒有可用節點,也不一定代表訂閱匯入失敗:若設定透過 proxy-providers 另外取得節點,主要設定網址與提供者網址是兩次獨立請求。先確認日誌中的錯誤對應哪個項目,再決定要檢查主要訂閱還是提供者。
- 保留目前可用的設定,記下操作時間、用戶端與核心版本、失敗階段,以及第一則具體錯誤訊息。
- 每次只變更一個條件,例如改用從帳戶頁面重新複製的連結,或校準系統時間。接著手動更新一次,確認是否出現新的成功紀錄。
- 確認啟用的是剛更新的設定。檢查預期的策略群組與節點來源是否已載入;請等設定成功啟用後,再測試節點延遲。延遲測試逾時應另外檢查節點或測試目標,不能據此反推訂閱已過期。
若仍無法找出原因,請將已去識別化的紀錄提交給訂閱服務商或用戶端維護者:說明是首次匯入或更新失敗、能否在另一個可信任的網路重現,以及本機副本是否出現相同錯誤。這些資訊比單說「無法匯入」更能縮小問題範圍。