· 入門指南 · 約 10 分鐘

v2rayN 訂閱更新失敗排解與自動更新間隔設定

整理訂閱更新失敗的常見原因:連結過期、更新時未使用代理,以及憑證與裝置時間不同步,並說明如何在 v2rayN 和 v2rayNG 設定自動更新。

本文重點

先分辨是訂閱下載失敗、內容解析失敗,還是節點連線失敗,再檢查連結授權、更新路徑和裝置時間。手動更新成功後再設定自動更新:桌面版確認分組的分鐘數,Android 版則確認目前版本是否提供自動更新選項及其時間單位,最後觀察一次實際執行結果。

訂閱更新失敗發生在哪個步驟?

訂閱並不等於代理連線。用戶端會向訂閱網址發出請求、取得節點描述,再轉換為本機設定。v2rayN 的訂閱下載由用戶端處理,不能只因 Xray 核心正在執行,就認定訂閱請求已透過代理傳送。系統代理、訂閱更新指令和用戶端內部的下載設定,也是彼此不同的選項。

讀取訂閱網址 建立下載連線 接收訂閱內容 解析節點項目 寫入本機分組

更新記錄停在不同位置,處理方式也不同。連線逾時應先檢查網路路徑;HTTP 403 應先確認授權與伺服器政策;下載成功卻沒有節點,則應檢查回應格式。把這三種情況一概稱為「節點失效」,往往會誤刪仍可使用的本機設定。

畫面顯示優先檢查暫勿修改
要求逾時或連線遭拒直連與代理路徑、目前節點、本機監聽連接埠節點 UUID、傳輸方式
HTTP 401、403 或 410帳戶狀態、連結權杖、訂閱網址是否已重設路由規則與 DNS 分流
收到內容,但匯入 0 個項目是否回傳登入頁面、格式是否受用戶端支援自動更新間隔
匯入成功,但連線失敗節點連線記錄、伺服器狀態、傳輸參數已成功的訂閱下載路徑

先確認連結與帳戶狀態

訂閱網址通常含有存取權杖,應視同密碼妥善保管。請從服務供應商的帳戶頁面重新複製完整網址,避免誤把頁面網址、QR Code 圖片網址或遭通訊軟體截斷的文字當成訂閱網址。重設訂閱權杖後,舊網址可能立即失效;用戶端裡還留著舊節點,也不代表舊訂閱連結仍有效。

  1. 保留現有設定

    先記下目前可用的節點與分組名稱。排解問題期間,請勿反覆刪除整個分組或清空所有伺服器清單;必要時使用用戶端提供的匯出功能備份,並妥善保管含有憑證的檔案。

  2. 重新複製網址

    從服務供應商的帳戶頁面複製訂閱連結,取代分組中的舊網址。檢查前後是否有空格或換行,以及查詢參數是否完整;請勿手動刪改權杖或參數。

  3. 單獨更新分組

    在 v2rayN 主畫面選取對應分組,執行「訂閱分組」→「更新目前訂閱(不透過代理)」,並記下更新時間、狀態碼和錯誤訊息。選單中的括號與空格可能因介面版本而略有不同。

  4. 確認帳戶狀態

    確認帳戶是否已到期、流量是否用盡,以及訂閱是否遭到暫停。HTTP 403 也可能是存取政策或頻率限制所致,不能只憑狀態碼就判定帳戶已過期。

分辨直連更新與代理更新

若目前網路無法直接連線至訂閱網域,可透過已確認可用的節點下載訂閱。在 v2rayN 中,先啟動該節點,再執行「訂閱分組」→「更新目前訂閱(透過代理)」。這比反覆切換系統代理,更容易確認這次更新使用的連線路徑。若清單中已沒有任何可用節點,透過代理更新也無法自行恢復連線。

本機連接埠應以實際設定為準。例如,若 HTTP 代理實際監聽於 127.0.0.1:10809,卻將要求傳送至 127.0.0.1:10808,可能會連到不同協定的連接埠,或遭到拒絕連線。這兩組數字僅供排查參考,並非所有版本的預設值。請檢查 v2rayN「設定」→「參數設定」中的本機監聽設定,並與執行記錄核對。

依錯誤原文縮小排查範圍

開啟用戶端的資訊或記錄區域,複製這次訂閱更新附近的完整錯誤行,不要只看「更新失敗」的通知。以下是可能遇到的底層錯誤訊息;實際措辭會因執行環境和用戶端版本而異,應依錯誤類型判斷,不必要求記錄內容完全一致。

Response status code does not indicate success: 403 (Forbidden).

原因與解法:伺服器拒絕了目前的要求,可能與權杖、帳戶狀態或存取政策有關。請重新複製帳戶頁面提供的訂閱網址,停止連續重試,並向服務供應商確認遭拒原因。

The operation has timed out.

原因與解法:要求未能在允許時間內完成。先比較直連與透過代理兩種更新方式,再檢查目前節點和網路;單純延長逾時時間,無法連上無法存取的網址。

No such host is known.

原因與解法:網域解析失敗。檢查訂閱網域是否拼錯、裝置 DNS 設定及網路連線;若更新要求未進入核心,修改核心的 dns.servers 不一定會影響這次解析。

The remote certificate is invalid because of errors in the certificate chain: NotTimeValid

原因與解法:憑證效期檢查未通過,可能是裝置時間錯誤,也可能是伺服器憑證已過期。先同步裝置的日期與時間,再重新嘗試;若時間正確仍出現錯誤,應請訂閱服務維護人員檢查憑證。

Connection refused

原因與解法:目標位址未接受這項連線。若記錄中的目標是本機,請檢查核心是否正在執行、連接埠是否一致;若目標是遠端訂閱伺服器,則應檢查遠端服務狀態,請勿直接修改節點驗證欄位。

Windows 可在「設定」→「時間與語言」→「日期與時間」開啟自動設定時間,並執行同步。Android 通常可在「設定」→「系統」→「日期與時間」找到相關選項;不同裝置可能會將其歸在其他系統設定分類。憑證錯誤也可能是網路進行 HTTPS 檢查或憑證鏈錯誤所致,請勿關閉憑證驗證來規避問題。

v2rayN 自動更新間隔設定

先成功手動更新一次,再啟用定時更新。v2rayN 常見的桌面介面可在「訂閱分組」→「訂閱分組設定」管理訂閱;編輯目標分組後,可檢查「自動更新間隔(分鐘)」。本文以顯示此欄位的介面為操作參考;若目前版本的欄位不同,請以實際標籤和單位為準,不要將小時數直接填入分鐘欄位。

  1. 開啟目標分組

    進入「訂閱分組」→「訂閱分組設定」,編輯需要定期更新的分組。先確認備註與訂閱網址,避免修改到其他同名分組。

  2. 輸入分鐘數

    在「自動更新間隔(分鐘)」中,可先設定為 360,也就是 6 小時。這是初始建議,並非通用預設值;若服務供應商規定更低的請求頻率,請遵守其限制。

  3. 確認下載路徑

    若目前版本提供「透過代理更新」之類的選項,請依照前面成功的方式設定;若沒有獨立選項,請查看該版本的訂閱下載設定,並透過記錄確認背景工作是否成功。

  4. 儲存並觀察

    儲存分組後,讓程式保持執行,並檢查下次觸發時的訂閱記錄。不要只看節點數量:即使內容沒有變更,成功更新後的項目數也可能相同。

預期間隔分鐘欄位填入值設定考量
6 小時360適用於需要較即時取得節點變更的情況
12 小時720節點變更不頻繁時,可減少請求次數
24 小時1440每天取得更新,仍須考量程式的執行時間

自動更新需要程式持續執行並由系統排程,並非伺服器主動推送。結束 v2rayN、關機或進入睡眠期間,不要期待工作能依照時鐘準時執行。請勿將 0 當成「立即更新」:不少介面中,這代表停用定時更新;儲存前請先閱讀欄位說明。

v2rayNG 更新與背景執行限制

Android 版 v2rayNG 使用 Xray 核心,但訂閱仍由用戶端介面管理。先從主畫面選單進入「訂閱分組設定」,確認目標分組已啟用且網址正確,再返回主畫面選單執行「更新目前分組訂閱」。若介面使用「更新訂閱」等名稱,請先確認更新的是目前分組還是所有分組。

  1. 先手動更新

    連線至可用節點後更新目標分組,確認更新提示與節點清單。Android 版是否透過目前代理下載,也會受到版本與設定影響,請依實際更新結果判斷。

  2. 確認功能選項

    查看「設定」及目標分組的編輯頁面,確認是否提供自動更新訂閱的開關與間隔。v2rayNG 各版本的功能和選項位置不盡相同,不要直接套用 v2rayN 的分組分鐘數欄位。

  3. 確認間隔單位

    若目前版本提供間隔設定,請依欄位標籤選擇 6 小時或等效數值;只有欄位標示「分鐘」時,才填入 360。儲存後請等待一次實際觸發,確認不只是開啟了選項。

  4. 檢查背景執行權限

    在系統「設定」→「應用程式」→「v2rayNG」→「電池」中,檢查背景活動限制;實際名稱依裝置系統而定。即使允許背景執行,也不保證鎖定螢幕後能精確到分鐘觸發。

更新後確認與常見問題

訂閱更新成功只表示節點描述已寫入本機,不代表其中每個節點都能建立連線。更新完成後,請檢查分組、所選節點和記錄,再測試實際連線。若服務供應商刪除或重新命名節點,請重新確認目前的選擇,避免繼續使用已移除的項目。

更新成功了,為什麼節點數量沒變?

伺服器提供的內容可能沒有變動。先查看這次的成功提示,再確認分組中的節點位址或備註是否更新;不要以「數量必須增加」作為成功標準,也別連續按更新來確認。

設定 360 分鐘後,關機期間還會更新嗎?

不會由已停止的用戶端執行。開機後先啟動 v2rayN,必要時手動更新一次;是否補執行錯過的工作,以及何時重新計時,取決於目前版本的實作方式。

手動透過代理可以更新,自動更新卻失敗?

確認定時工作觸發時節點是否正在執行,以及背景更新是否採用相同路徑。比對觸發時間附近的記錄;若當時程式尚未建立連線,請先恢復可用節點,再手動更新。

出現 429 後要把間隔改成 1 分鐘嗎?

不應縮短間隔。HTTP 429 表示請求受到頻率限制,應停止連續重試並依伺服器說明等待;若回應中含有 Retry-After,請依提示再送出要求,並適度延長自動更新間隔。

自動更新會自動切換節點嗎?

更新訂閱與選擇節點是兩回事。更新主要是取得最新節點資料,不代表會自動選取延遲最低的節點;若目前項目已遭刪除,請回到目標分組重新選取可用節點,並查看連線記錄。

最後請保留清楚的排查記錄:發生時間、目標分組、直連或代理、HTTP 狀態,以及更新前後的項目數。提供這些資訊通常比反覆重新安裝更有幫助。若想了解系統代理與核心路由各自的作用,可接著閱讀使用指南和設定參考。

用戶端與安裝檔