適用於 v2rayN、v2rayNG 與 v2flyNG 訂閱下載失敗、回傳內容無法辨識,或更新後列表空白等情況。請先保留目前可用的節點,再確認連結、請求路徑、回應內容與訂閱群組;每次只變更一項條件進行比對,判斷問題出在下載、解析還是顯示階段,避免把訂閱故障誤認為節點故障。
先區分下載失敗、解析失敗與列表空白
更新訂閱並不是測試節點是否連線。用戶端會先向訂閱網址送出請求,再讀取回應內容、辨識節點項目,最後將結果寫入對應群組。任一環節出錯,介面上都可能顯示「沒有新節點」,但處理方式各不相同。
- 下載失敗:記錄中出現網域名稱解析失敗、連線逾時、憑證錯誤或 HTTP 錯誤狀態。此時應檢查連結與網路,不必先修改 VMess 或 VLESS 節點參數。
- 解析失敗:用戶端已收到內容,但無法辨識出有效節點。常見原因包括收到登入頁面、格式不符,或訂閱內容遭到截斷。
- 列表空白:可能是伺服器確實回傳空內容,也可能是搜尋條件、目前群組或節點篩選規則讓項目未顯示。
- 節點存在但無法連線:表示訂閱至少已完成部分解析。接下來應檢查節點設定、系統時間與伺服器狀態,不要持續重複更新訂閱。
第一步:確認複製的是訂閱連結
訂閱連結、帳戶管理頁面與單一節點分享連結是不同內容。訂閱網址通常使用 https://;vmess://、vless:// 等則是節點分享連結,應透過用戶端對應的匯入功能新增,不能只因為「複製到一長串字元」就當成訂閱網址。
-
重新複製原始網址
請從服務提供者的訂閱入口重新複製,確認沒有連同說明文字、引號或前後空白一起複製。聊天紀錄中顯示為省略形式的連結不能直接使用。
-
檢查查詢參數
確認問號後方的完整內容。訂閱網址中的存取權杖、參數順序或簽章可能用於驗證,請勿自行刪除參數,也不要截掉
&後方的內容。 -
確認連結仍有效
在帳戶頁面確認訂閱權限、到期狀態,以及連結是否已重設。重設後請將新網址儲存至原有群組,舊網址可能會立即失效。
-
單獨更新群組
儲存後只更新這個群組,並記錄結果。不要同時更新多個訂閱,否則其他群組的錯誤容易混在同一段記錄中。
即使瀏覽器能開啟網址,也只能證明瀏覽器透過目前的連線方式取得了某種回應。瀏覽器可能帶有登入 Cookie,或使用與用戶端不同的代理與 DNS;因此,「瀏覽器能開啟」並不能單獨證明用戶端也能取得可解析的訂閱內容。
第二步:比對直連與透過代理下載
「更新訂閱時是否透過代理」與「節點使用哪種路由規則」屬於不同層面。訂閱可能由用戶端本身的 HTTP 請求元件下載,不一定會完全沿用代理核心的 DNS、路由或分流規則。只切換核心的路由模式,不一定能改變訂閱請求的連線路徑。
在 Windows 版 v2rayN 6.x 的常見介面中,可在「訂閱分組」選單選擇「更新全部訂閱(不通過代理)」或「更新全部訂閱(通過代理)」進行比對。其他版本的括號樣式、文字與群組操作入口可能不同,請以目前介面為準;本文不將特定版本的更新方式視為所有版本的預設行為。
- 先試不透過代理:適用於目前沒有可用節點,或懷疑本機代理尚未啟動的情況。失敗後先記錄錯誤,不要立即刪除群組。
- 再試透過代理:先確認目前選取的節點能連上常用網頁,再更新一次。如果選取的節點本身已無法使用,就不能依靠它下載新訂閱。
- 確認本機監聽狀態:若記錄顯示連線至
127.0.0.1遭拒,請檢查用戶端實際監聽的位址與連接埠。10808、10809僅是排查時可能遇到的連接埠範例,不代表所有版本都使用這兩個連接埠,或一定有獨立的 HTTP、SOCKS 監聽。 - 切換一次網路:條件允許時,比較目前網路與另一個可信任的網路。如果只有其中一個網路失敗,優先檢查該網路的 DNS、存取限制或登入驗證頁面。
Android 上可先在 v2rayNG 或 v2flyNG 的「訂閱分組設定」中確認儲存的網址,再從選單選擇「更新訂閱」;選項名稱可能隨版本變動。如果目前版本提供透過代理更新的選項,也可進行相同的比對;若沒有此選項,請勿套用桌面版的選單路徑。每次測試只變更更新路徑或網路其中一項。
利用狀態碼判斷驗證、重新導向與封鎖問題
如果記錄中提供 HTTP 狀態碼,請先查看狀態碼,再檢查回應內容。以下數字是 HTTP 協定狀態,不是測速結果,也不是用戶端版本號。即使回傳 200,內容仍可能是錯誤說明或網頁。
以下列出 HTTP 狀態列及請求元件可能出現的實際錯誤文字。不同用戶端、執行環境與介面語言可能會附帶其他說明,判斷時應確認錯誤發生在哪個步驟,而非只比對某句翻譯。
HTTP 401 Unauthorized
原因與處理方式:請求未附上有效的身分資訊,或權杖已失效。請從帳戶訂閱入口重新複製網址,並確認該介面不會只能在登入後的網頁工作階段中使用。
HTTP 403 Forbidden
原因與處理方式:伺服器拒絕目前的請求,可能與權限、存取政策或防護規則有關。請確認帳戶狀態,並提供發生時間、狀態碼與存取方式給服務提供者;不要只憑 403 就判定帳戶已到期。
HTTP 407 Proxy Authentication Required
原因與處理方式:請求經過的代理要求驗證,問題未必出在訂閱服務。請檢查系統或網路代理的驗證設定,或比對不透過代理的更新結果。
The operation has timed out.
原因與處理方式:請求未能在指定時間內完成,可能卡在名稱解析、連線或讀取階段。請先比對網路與下載路徑,再參考前後記錄定位問題;單純延長逾時時間無法修復失效網址。
遇到 301 或 302 時,請確認最終回應不是登入頁面;遇到 429 時,應停止連續更新,並依照伺服器提供的 Retry-After 提示等待。請勿頻繁點擊更新來測試是否恢復,這可能讓流量限制持續更久。
第三步:檢查回應格式與編碼
訂閱下載成功但仍顯示解析錯誤時,重點是確認「實際收到的內容」。請只在本機或受控環境中檢查回應內容,避免將整段節點設定貼到外部工具。節點內容也可能包含存取憑證,應比照訂閱連結的方式妥善處理。
| 回應特徵 | 可能原因 | 下一步 |
|---|---|---|
以 <!DOCTYPE html> 或 <html 開頭 |
登入頁面、錯誤頁面或網路驗證頁面 | 重新取得原始訂閱入口,檢查最終重新導向與存取權限 |
多行 vmess://、vless:// 等分享連結 |
常見的節點列表格式 | 確認目前用戶端版本是否支援每一種連結及其參數 |
| 一整段 Base64 文字 | 可能是經過編碼的節點列表 | 確認回應內容完整,先交由用戶端解析;必要時僅在本機解碼檢查 |
| JSON 或 YAML 文字 | 可能是完整設定檔、介面錯誤物件或其他格式 | 確認內容符合目前訂閱匯入功能的要求,不能只看副檔名 |
| 空白內容或只有提示文字 | 沒有可用項目,或伺服器回傳服務錯誤 | 確認帳戶權限、節點篩選條件與伺服器說明 |
Base64 解碼成功,不代表節點就能匯入
Base64 是編碼形式,不是訂閱協定。解碼成功只能表示文字符合某種編碼規則,不能證明其中的連結有效。常見的 VMess 分享格式會以 vmess:// 加上 Base64 編碼的 JSON;VLESS 分享連結通常會將識別資訊、位址與傳輸參數寫在 URI 中,兩者不能使用相同欄位處理。
- 不要反覆解碼整段內容:VLESS 連結中的百分比編碼可能用於路徑、備註或查詢參數,整段解碼後再重新組合,可能破壞
&、#等分隔符號的意義。 - 檢查內容是否遭截斷或改寫:複製過程中的換行、全形標點、字元遺漏,以及將
+錯誤轉成空格,都可能影響解析。請優先重新複製來源網址,不要手動補上不確定的內容。 - 確認使用正確的匯入功能:核心能讀取某種設定,不代表用戶端的訂閱功能會將它轉換成節點。完整 JSON 設定、單一節點分享連結與訂閱列表,應分別使用對應功能。
- 檢查相容欄位:舊版用戶端可能不支援某些傳輸或安全參數。請先記下目前版本,再到下載頁確認可用的用戶端;不要為了成功匯入而刪除 TLS、SNI 或其他安全設定。
第四步:確認群組、篩選條件與儲存結果
如果記錄顯示下載完成且已辨識節點,請先檢查列表畫面,不要繼續修改網路設定。在 v2rayN 中,從「訂閱分組」→「訂閱分組設定」確認目前群組的網址;在 v2rayNG 與 v2flyNG 中,進入「訂閱分組設定」確認對應項目。儲存按鈕、篩選選項與重新整理方式會因版本而異,本文不假設三款用戶端的功能完全相同。
- 清除搜尋條件:清空節點搜尋欄,切換至目標訂閱群組或所有節點檢視,排除名稱篩選造成的「列表空白」。
- 檢查篩選條件:如果目前版本提供訂閱正規表示式篩選、包含或排除條件,請先記下原設定,再暫時停用篩選並更新一次。
- 確認變更已儲存:修改網址後請確認已儲存。若只貼在編輯欄位中而未確認,更新時可能仍會使用舊網址。
- 隔離測試:必要時建立一個測試群組,只加入這個訂閱並單獨更新。保留原有群組,避免覆蓋仍可使用的節點。
- 確認實際使用的程式:桌面上有多份 v2rayN 時,請確認目前操作的是哪一份程式及其設定目錄,避免修改了其中一份,啟動的卻是另一份。
「啟用系統代理」、「全域路由」與「更新訂閱時使用代理」並非相同設定。第一項會影響遵循系統代理的應用程式;第二項會影響核心收到連線後的輸出選擇;最後一項才直接說明訂閱請求的下載方式。排查時請記下實際變更的設定,避免將多個開關籠統地說成「已開啟代理」。
再次測試清單與回報資訊
完成修改後,只更新目標群組一次。確認問題是否解決時,應同時查看更新記錄、節點列表與一次實際連線結果:沒有錯誤不一定代表有可用節點,出現節點也不代表每台伺服器都能連線。若訂閱已恢復,但某個節點仍逾時,請將它視為獨立的連線問題處理。
- 已確認儲存的是完整訂閱網址,而非帳戶頁面或單一節點連結。
- 已確認帳戶權限、連結重設狀態,以及修改後是否已儲存。
- 已分別記錄直連與透過可用代理更新的結果,或註明目前版本沒有對應選項。
- 已記錄 HTTP 狀態、錯誤原文與失敗階段,而非只寫「無法使用」。
- 已確認回應內容不是 HTML 登入頁面,且格式符合目前匯入功能的要求。
- 已排除搜尋條件、群組選擇與訂閱篩選造成的列表空白。
- 已保留原始設定備份,重新測試時沒有同時變更 DNS、代理、路由與訂閱格式。
基本匯入操作可參考快速入門;若要進一步區分本機監聽、系統代理與路由問題,可查看疑難排解手冊。先確認故障發生在哪個環節,再只修改該環節對應的設定,比反覆刪除並重建訂閱更能保留排查資訊並驗證結果。