本清單適用於在 v2rayN 按下更新訂閱後逾時、出現 HTTP 錯誤，或更新完成卻沒有節點的情況。先區分請求失敗與解析失敗，再檢查回應內容、更新路徑、用戶端識別與分組篩選；每次只變更一項設定，並保留原始設定與已去識別化的記錄，避免一併清除仍可使用的節點。
先判斷問題發生在哪個步驟
訂閱網址提供的是節點設定集合，不是可直接連線的節點。v2rayN 必須先向網址發出請求、辨識回應格式，最後才會將節點寫入對應分組。節點能否連線是後續問題：成功取得訂閱，不代表遠端伺服器一定連得上；現有節點可以上網，也不代表訂閱網址仍有效。
在主畫面開啟「訂閱分組」選單，優先只更新目前要排查的分組。WPF 與 Desktop 介面，以及不同版本的選單文字可能略有差異；以下以「更新目前訂閱（不透過代理）」與「更新目前訂閱（透過代理）」這類清楚區分連線路徑的操作為準。請勿將系統代理開關視為訂閱更新路徑的替代方案。
| 看到的狀況 | 優先檢查項目 | 下一步 |
|---|---|---|
| 等待很久後逾時 | DNS、網路路徑、代理出口 | 比較直連與代理更新 |
| HTTP 401 或 403 | 權杖、存取限制、請求標頭 | 確認帳戶與訂閱專用網址 |
| HTTP 200，但解析結果為空 | 回應內容與格式相容性 | 確認回傳的是網頁還是空內容 |
| 顯示匯入成功，但目前清單為空 | 分組選擇、搜尋與篩選 | 切換目標分組並清除搜尋條件 |
| 有節點，但全部無法連線 | 節點設定或執行中的核心 | 接著檢查連線與核心記錄 |
確認網址有效：先排除登入頁與失效權杖
請從訂閱服務商的帳戶頁面重新複製「訂閱網址」，不要複製帳戶管理頁、方案說明頁，或登入後的瀏覽器網址。網址中的查詢參數通常包含存取權杖，少一個字元就可能變成另一個請求。貼到「訂閱分組設定」後，檢查開頭和結尾是否混入空格、換行或中文引號，尤其不要手動刪除問號後的內容。
-
備份目前設定
使用用戶端提供的備份功能；若要備份設定資料夾，請先結束 v2rayN，再複製實際的資料目錄。還有可用節點時，不要先刪除所有分組。
-
確認訂閱網址
前往「訂閱分組」→「訂閱分組設定」，編輯目標分組，對照服務商頁面重新貼上完整網址，同時確認修改的是發生錯誤的分組。
-
確認帳戶狀態
檢查訂閱是否到期、權杖是否已重設，以及服務商是否要求更新網址。重設後舊網址失效是正常情況，請勿繼續反覆重試。
-
檢視回應內容
在可信任的本機環境中檢查回應狀態與內容類型。若看到登入表單、驗證碼或方案頁面，請向服務商索取供用戶端使用的訂閱介面，不要將網頁另存後匯入。
瀏覽器能開啟網址只能作為參考。瀏覽器可能帶有登入 Cookie、使用不同的代理，或已自動通過網頁驗證；v2rayN 發出的訂閱請求不一定具備這些條件。HTTP 200 也只代表請求收到成功回應，不代表內容中包含節點。
Base64 與節點格式：有內容不代表能解析
常見的訂閱內容是由多條分享連結組成的文字，外層再以 Base64 編碼；有些介面則會直接回傳明文連結。Base64 是編碼，不是加密。即使內容可以解碼，裡面仍可能是到期通知、錯誤說明，或用戶端無法辨識的設定格式，必須繼續檢查解碼後的內容。
- 外層訂閱編碼：解碼後通常會看到逐行排列的分享連結。檢查時請只在本機處理，不要將完整結果傳給他人。
- VMess 分享內容：
vmess://後方的傳統分享資料可能還有自己的 Base64 編碼層，與整份訂閱的外層編碼並非同一層。 - VLESS 分享內容：
vless://通常以 URI 結構表示位址與參數，不可直接將整條連結當成 Base64 解碼。 - 格式不相容：為其他設定體系產生的 YAML、網頁 HTML 或錯誤 JSON，不會因為改成
.txt副檔名，就變成 v2rayN 可匯入的訂閱。
若同一份回應中只有部分節點能匯入，請優先檢查失敗項目的協定、傳輸參數與用戶端解析支援度。若一個節點都沒有，先確認介面回傳格式是否正確，再考慮編碼異常。不要一開始就修改核心設定：訂閱文字尚未經用戶端解析時，切換 Xray 或 V2Ray 核心通常無法解決下載到網頁的問題。
| 內容特徵 | 代表情況 | 處理方式 |
|---|---|---|
<!DOCTYPE html> 或 <html | 回傳的是網頁 | 確認訂閱介面、登入要求與網頁防護 |
| JSON 錯誤物件 | 介面回傳業務錯誤 | 查看錯誤說明，確認帳戶或權杖 |
| 空白內容或只有空格 | 沒有可供解析的資料 | 聯絡服務商確認訂閱是否已分配節點 |
| 多行協定分享連結 | 可能是可辨識的明文訂閱 | 確認協定支援與項目是否完整 |
| 長串編碼文字 | 可能是外層 Base64 | 在本機解碼後再判斷，不要只憑外觀下結論 |
更新路徑：分別測試直連與透過代理
「不透過代理更新」與「透過代理更新」處理的是連線至訂閱伺服器的網路路徑，不會修改伺服器上的訂閱內容。直連無法存取介面時，透過代理出口可能有助於請求成功；反過來，訂閱介面也可能限制代理出口，或只允許特定網路存取，此時改用直連反而可行。
-
先測試直連
選取目標分組，在「訂閱分組」選單中執行不透過代理的更新。記下錯誤發生時間與狀態碼，不要連續點擊多次。
-
確認現有節點可用
若保留了可用節點，請先選取該節點並確認核心已啟動，再實際瀏覽可正常存取的網頁。只看到節點已選取，並不能證明本機代理可用。
-
改用代理更新
執行透過代理更新，並比較結果。若只有這種方式成功，問題較可能出在直連路徑，而非訂閱格式。
-
一次只調整一項
若兩種方式都失敗，先保留原始網址並比較錯誤是否相同；不要同時修改 DNS、User-Agent 與節點參數，否則無法判斷是哪項變更生效。
透過代理更新仍需要本機監聽連接埠。前往「設定」→「參數設定」，確認目前的本機入站監聽設定；例如實際監聽位址為 127.0.0.1:10808 時，測試工具必須使用該連接埠及其支援的代理協定。此處的 10808 僅為確認範例，不是所有版本與設定都固定使用的值，更不能以遠端節點連接埠取代。
錯誤：Connection refused
原因與解法：目標主動拒絕連線。若記錄指向 127.0.0.1 的本機代理連接埠，請先確認核心是否已啟動，以及連接埠是否與目前設定相符，再重試代理更新。若指向遠端位址，則檢查對應的遠端服務。
錯誤：No such host is known.
原因與解法：主機名稱解析失敗。請確認訂閱網域是否完整複製，並檢查目前請求路徑實際使用的 DNS。修改節點的 SNI 無法解決訂閱網域解析失敗。
錯誤：A task was canceled.
原因與解法：請求可能因逾時或取消而結束；僅憑這句訊息無法判定介面已失效。請參考前後記錄判斷是否逾時，再分別測試直連與代理路徑。
User-Agent 與 HTTP 狀態碼：依介面要求確認
User-Agent 是請求標頭中用來識別用戶端的欄位，部分訂閱介面會依此選擇輸出格式或限制存取。在「訂閱分組」→「訂閱分組設定」中編輯目標分組；若目前版本提供「User-Agent」欄位，請優先保留預設值，或填入服務商明確指定的值。若沒有此欄位，請勿將識別字串加到訂閱 URL 後方。
修改 User-Agent 並非通用解法。瀏覽器識別字串可能讓介面回傳網頁；錯誤的用戶端識別資訊也可能使伺服器輸出不相容的內容。每次只修改一個分組，更新後比較狀態碼與內容類型；若沒有改善，請還原原值。遇到網頁驗證時，應請服務商提供適合用戶端使用的介面，而不是嘗試繞過驗證。
錯誤：Response status code does not indicate success: 403 (Forbidden).
原因與解法：伺服器拒絕目前的請求，可能與權杖、出口位址或請求標頭限制有關。請先確認訂閱權限與網址，再依服務商要求檢查 User-Agent；不能只憑 403 就斷定單一原因。
錯誤：Response status code does not indicate success: 404 (Not Found).
原因與解法：找不到目標資源，也可能是介面刻意隱藏已失效的資源。請從帳戶頁面重新取得訂閱網址，不要猜測路徑或自行刪改參數。
錯誤：Response status code does not indicate success: 429 (Too Many Requests).
原因與解法：請求觸發頻率限制。請停止手動連續點擊，並暫停過於頻繁的自動更新；依回應中的 Retry-After 或服務商說明等待後再試。
以上是常見的 HTTP 用戶端錯誤訊息，實際大小寫與附加文字可能因版本而異。記下數字狀態碼，比只截取「更新失敗」更有用。若回傳 5xx，通常應確認介面或上游服務狀態；不斷切換本機協定無法直接修復伺服器錯誤。
分組與篩選：更新成功後為什麼仍看不到節點
請求與解析都成功後，清單仍為空，也可能只是顯示範圍不正確。先切換到剛更新的訂閱分組，清除搜尋框內容，再確認是否設有節點名稱篩選。接著回到「訂閱分組設定」，檢查目前版本提供的「啟用更新」、篩選關鍵字、正規表示式篩選與去重選項；排查時先記下原值，再暫時移除篩選條件。
- 確認更新對象：名稱相同的分組容易混淆，請同時比對分組備註與訂閱網址，避免修改了某個分組，卻更新了另一個。
- 確認名稱篩選：正規表示式範圍過廣或含有意外空格，可能會排除所有節點；請先清除篩選，再確認匯入數量。
- 區分去重與失敗：去重可能使新增數量少於回應中的項目數，這不代表下載失敗；請比對更新記錄與分組節點總數。
- 確認分組是否參與更新：若該分組停用了更新，執行更新所有訂閱時可能會略過它；請先確認分組允許參與更新。
常見問題與檢查重點
瀏覽器能下載訂閱，為什麼 v2rayN 仍然更新失敗？
先比較兩者是否使用相同的網路出口，再確認瀏覽器下載的是否確實為節點文字。瀏覽器可能帶有登入 Cookie；若內容是登入頁或驗證頁，請改用用戶端專用的訂閱網址。之後再確認服務商要求的 User-Agent。
所有節點都不見了，還能透過代理更新嗎？
透過代理更新需要可用的代理連線方式。請先從本機備份還原已知可用的設定，或使用服務商提供的其他合法連線方式；若沒有可用的連線方式，請優先測試直連，或向服務商索取可存取的訂閱介面。僅開啟系統代理開關無法建立連線。
換成 v2rayNG 就能匯入，是否代表桌面版壞了？
不能直接下結論。先確認兩端取得的是同一份回應，而不只是使用相同的 URL：網路出口、User-Agent 與介面分流都可能不同。若回應一致，再比較用戶端對特定協定與傳輸參數的支援度；v2rayNG 使用 Xray 核心，v2flyNG 使用 v2fly 核心，但訂閱解析相容性仍須視用戶端版本而定。
更新後有節點，但全部測試失敗，還要繼續修改訂閱嗎？
先停止修改訂閱。確認核心能否啟動，檢查系統時間、節點位址、連接埠與 TLS 參數，並查看連線階段的核心記錄。訂閱更新與節點連線是兩個不同階段；清單已產生後，排查重點應轉向特定節點與網路路徑。
有效的複查必須同時確認「請求成功、內容可辨識、分組中有節點」，不能只看更新動作是否結束。若後續仍需回報問題，請提供 v2rayN 的實際版本、所用介面、作業系統、更新方式、HTTP 狀態碼與已去識別化的錯誤文字；請勿在記錄中公開節點帳戶、訂閱權杖或完整回應內容。
- 重複檢查同一分組時，保持網址與篩選條件不變，每次只切換一個待確認的因素。
- 更新成功後，先在目標分組查看節點，再單獨測試選定節點是否能連線。
- 確認問題已解決後，恢復合適的自動更新排程，並保留可還原的本機備份。