適用於 v2rayN、v2rayNG 與 v2flyNG 的訂閱更新問題。先分辨「未取得訂閱內容」和「已取得內容但沒有可辨識的節點」,再檢查連結權限、回應格式、更新路徑與憑證。保留現有可用設定,每次只調整一個條件,並透過更新記錄確認問題發生在哪個環節。
先找出更新失敗的環節
訂閱更新是用戶端取得伺服器清單的流程,不是測試節點連線。用戶端必須連上訂閱網址、取得回應、解析內容,再寫入指定群組;之後才由 Xray 或 V2Fly 核心使用節點設定建立連線。因此,「訂閱更新成功」不代表每個節點都能連線;「現有節點可用」也不代表訂閱網址仍然有效。
依序檢查連結與權限、內容格式、更新網路及 TLS 憑證。這個順序優先處理容易確認、修改成本較低的項目,並不代表各種網路環境的故障比例都相同。先開啟用戶端記錄,記下本次更新時間與完整錯誤類型,避免把前一次的連線記錄誤認為訂閱錯誤。
- 連線逾時或 DNS 解析失敗:通常尚未取得有效回應,請優先檢查網路與 DNS。
- 回傳 401、403 或 404:表示伺服器已收到請求並回應,請優先確認權限、存取規則與網址。
- 顯示更新完成但節點數為零:請優先檢查回應本文、格式相容性及目前的群組篩選條件。
- 清單正常但節點無法使用:接著檢查節點參數、核心支援與路由,不要反覆重設訂閱。
連結過期或權限變更:先確認訂閱網址
訂閱連結通常包含帳戶權杖。重設訂閱、方案到期、帳戶狀態變更或服務提供者調整介面,都可能使舊網址失效。瀏覽器能登入帳戶頁面,只能證明網頁工作階段有效;用戶端的訂閱請求不一定帶有相同的登入狀態。請複製服務提供者標示的訂閱網址,而非管理頁面的網址。
-
保留現有清單
記下目前的群組名稱與節點數量;如需匯出備份,請存放在安全的本機位置。先不要刪除原有群組,也不要在公開截圖中顯示含有權杖的連結。
-
重新取得網址
前往服務提供者的訂閱管理頁面,確認帳戶狀態後,重新複製適用於該用戶端的網址。保留完整查詢參數,並移除複製時混入的空格、換行與引號。
-
確認群組設定
v2rayN 常見路徑為「訂閱分組」→「訂閱分組設定」,開啟目標群組檢查網址;Android 版可從主畫面選單進入「訂閱分組設定」,編輯相應項目。選單名稱可能因版本而略有不同。
-
只更新目標群組
儲存後只更新該群組,並立即查看記錄。不要同時更新所有來源,否則某個群組的成功訊息可能掩蓋其他群組的錯誤。
重新產生網址通常會使舊權杖失效,其他裝置也必須同步更新。若回應為 403,不要直接判定方案已到期:來源限制、防護頁面及請求頻率限制也可能回傳相同狀態碼。請一併參考狀態碼與服務提供者帳戶頁面的資訊。
節點解析為空:檢查回傳內容與格式
HTTP 請求成功只代表已取得內容,不代表取得的是節點清單。登入頁面、維護通知、防護驗證頁,甚至 JSON 錯誤訊息,都可能以 200 狀態碼回傳。遇到「解析為空」時,先確認內容類型,再考慮更新用戶端;重複貼上相同的錯誤頁面不會改變結果。
| 實際內容 | 辨識線索 | 處理方式 |
|---|---|---|
| 訂閱請求網址 | 通常以 HTTPS 開頭,用來取得清單 | 填入訂閱群組的網址欄位,再執行更新 |
| 單一分享連結 | 通常以 vmess:// 或 vless:// 開頭 | 使用剪貼簿匯入,不要填作遠端訂閱網址 |
| Base64 編碼清單 | 解碼後通常會包含多個分享連結 | 確認用戶端支援相應的訂閱編碼與協定 |
| 其他設定文字 | 可能是 YAML 或完整的 JSON 設定 | 向來源取得適用於目前用戶端的訂閱格式 |
| 網頁或錯誤訊息 | 含有 HTML 標籤、登入提示或權限說明 | 修正網址、權限或存取規則,而非修改節點 |
Base64 是編碼方式,不是加密,也不是協定名稱。字串看起來很長,不代表內容完整有效;不要只憑外觀任意補字元。如需檢查內容,請在受控的本機環境中查看,先確認複製時沒有截斷,再核實解碼結果是否確實包含分享連結。
還要分辨「用戶端能解析分享格式」與「所選核心能執行該設定」。Android 版 v2rayNG 使用 Xray 核心,v2flyNG 使用 V2Fly 核心;遇到 REALITY 等功能時,請確認實際使用的核心及版本是否支援。更換用戶端無法修復失效的權杖,也不會自動將任意設定檔轉換為相容的訂閱格式。
- 清除主畫面的搜尋條件,並確認是否切換到其他訂閱群組。
- 比較更新前後的群組數量,確認節點並未被篩選條件隱藏。
- 若只有部分節點遭略過,請記下相應協定與解析錯誤,不要將所有節點都判定為失效。
更新時未使用代理:分別測試直連與代理路徑
訂閱請求不一定會沿用瀏覽器的網路路徑。部分用戶端可個別設定訂閱更新方式;即使系統代理已啟用,若選擇「不透過代理」更新,仍會使用直連。反之,若更新必須透過目前已失效的節點,使用代理更新也會失敗,形成「必須先更新才能取得可用節點」的循環。
-
測試直連更新
在 v2rayN 的「訂閱分組」選單中,選擇目前訂閱的「不透過代理」更新項目。記下是逾時、解析失敗還是回傳 HTTP 狀態碼,不要只記「失敗」。
-
確認代理可用
選擇一個已確認可用的既有節點,確認核心已啟動,且一般 HTTPS 請求能正常完成。只有延遲測試結果,不足以證明網頁請求也能正常使用。
-
改用代理更新
在同一選單中選擇相應的「透過代理」更新項目。Android 版請先連線至現有可用設定,再從主畫面選單執行訂閱更新,並查看本次記錄確認結果;不能只憑連線圖示判斷請求路徑。
-
比較兩次結果
代理更新成功、直連失敗時,優先檢查直連網路與 DNS;直連成功、代理更新失敗時,優先檢查代理的對外連線與訂閱網域的存取規則。兩者都失敗時,再檢查連結與憑證。
若要檢查桌面版的本機代理連接埠,請以「設定」→「參數設定」中實際顯示的監聽值為準。例如,只有介面確實設定為 127.0.0.1:10808 時,才檢查該連接埠;10808 並非所有版本與協定共用的預設值。HTTPS 訂閱通常會連線到遠端 443 連接埠,與本機代理的監聽連接埠不同。
憑證與網路錯誤:依照原始訊息選擇修復方式
TLS 驗證發生在解析訂閱內容之前。憑證錯誤時,用戶端可能根本尚未取得訂閱本文。先檢查系統日期、時區與自動校時,再確認訂閱網域及憑證鏈。不要把節點設定中的「略過憑證驗證」當成修復訂閱下載的選項,兩者可能位於完全不同的請求層。
錯誤:x509: certificate has expired or is not yet valid
原因與解決方式:憑證有效期限與目前時間不符,可能是裝置時間錯誤或伺服器憑證已過期;先同步系統時間,若問題仍然出現,請聯絡服務提供者更新憑證。
錯誤:x509: certificate signed by unknown authority
原因與解決方式:本機不信任憑證簽發鏈,也可能是網路設備替換了憑證;請更新系統信任存放區,並在可信任的網路上重新測試。應由伺服器補齊憑證鏈,不要匯入來源不明的根憑證。
錯誤:Could not resolve host
原因與解決方式:目前的解析路徑無法取得訂閱網域的 IP 位址;請確認網域拼寫正確、網路已連線,並比較其他可信任網路的解析結果。
錯誤:Connection refused
原因與解決方式:目標連接埠拒絕連線,目標可能是訂閱伺服器或本機代理;先辨認記錄中的主機與連接埠,再檢查服務狀態或代理監聽設定。
不同作業系統與請求元件的錯誤訊息可能有所差異,以上列出的是常見原文,記錄不一定完全相同。若出現「連線重設」或逾時,也不能只憑一句錯誤訊息就判定是憑證問題;必須依錯誤發生的階段判斷。
- Android:可前往系統「設定」→「系統」→「日期與時間」,確認是否已啟用自動設定;實際路徑依裝置系統而異。
- Windows:可前往「設定」→「時間與語言」→「日期與時間」同步時間。
- 公共網路:先完成網路登入驗證;認證頁面攔截可能導致訂閱請求回傳網頁內容。
- 持續出現憑證錯誤:不要直接將網域改成 IP 位址,這可能造成憑證名稱不符,也可能破壞伺服器路由。
恢復更新後的驗證與回報記錄
修復後至少完成一次「確認更新結果」及一次「實際測試節點連線」。先確認目標群組是否出現預期項目,再選擇其中一個節點測試。若更新成功但連線失敗,請保留本次更新成功的記錄,轉而檢查節點參數、核心支援、系統代理與路由規則。
-
確認更新結果
確認記錄中沒有本次更新留下的解析錯誤、清單未被搜尋條件遮住,且群組歸屬正確。節點數量的變化應與來源實際提供的內容相符。
-
測試一個節點
選取一個新項目並啟動連線,瀏覽一般的 HTTPS 網頁。請分別記錄延遲測試與實際連線結果,不要只憑單一測試數字下結論。
-
整理去識別化記錄
記下用戶端版本、作業系統、更新時間、直連或代理方式、HTTP 狀態碼及完整錯誤訊息。傳送前請移除權杖、節點密碼與完整訂閱本文。
若仍需協助,可以用「相同網址直連更新逾時,透過既有節點更新則回傳 403」這類對照結果描述問題。相較於「訂閱壞了」,這樣更容易判斷是網路還是權限問題。不要頻繁重複點選更新;若出現 429 狀態碼或明確的流量限制提示,請依伺服器要求稍候再試。