適合第一次取得訂閱網址、找不到用戶端匯入入口,或更新後看不到設定的使用者。本文依序說明訂閱連結與單節點連結的差異、v2rayN 與 v2rayNG 的實際操作路徑、常見資料格式,以及逾時、空清單、格式錯誤等問題的排查順序。
先分清訂閱連結與單節點連結
訂閱連結通常是以 HTTPS 開頭的網址。用戶端存取此網址後,伺服器會回傳一組設定資料;之後執行「更新訂閱」時,用戶端會重新請求相同網址,並以新結果更新對應群組。訂閱網址本身不一定包含 vmess、vless 等協定名稱,因此不能只從網址外觀判斷其中有哪些節點。
單節點連結則直接描述一筆設定,常見開頭包括 vmess:// 與 vless://。它適合暫時匯入單筆設定,但不會自動建立可定期更新的訂閱關係。把單節點連結填入「訂閱網址」輸入框,或把訂閱網址交給「從剪貼簿匯入 URL」,都可能導致匯入結果為空。
用戶端版本升級後,選單文字可能出現「訂閱群組」、「訂閱設定」或「訂閱群組設定」等些微差異,但判斷入口的方法不變:需要儲存網址並反覆更新,就進入訂閱群組;只匯入一筆以協定前綴開頭的文字,就使用剪貼簿匯入。
訂閱網址
推薦儲存遠端網址,可依群組更新多筆設定;名稱和參數變更後,也能重新擷取。
適合:長期使用、設定數量較多、需要定期更新
單節點 URI
直接匯入一筆 VMess 或 VLESS 設定,不建立後續更新關係。
適合:臨時測試、單筆設定移轉、確認協定參數
批次文字
在同一段文字中逐行放置多個協定連結,可透過剪貼簿批次解析,但仍不等同於訂閱。
適合:離線移轉少量現有設定
v2rayN 桌面版新增與更新訂閱
開始前請完整複製訂閱網址,避免遺漏結尾的存取參數。若網址包含問號、等號或連接符號,應原樣保留,不要手動截斷。訂閱屬於存取憑證,不宜貼入公開記錄、截圖說明或共用文件。
開啟群組
啟動 v2rayN,在主介面選擇「訂閱群組」→「訂閱群組設定」。部分 7.x 介面可直接從左側群組區域進入管理頁面。
新增訂閱
點選「新增」或「+」,在備註中填寫便於辨識的名稱,再將完整 HTTPS 網址貼到 URL 輸入框。
儲存群組
確認啟用狀態後儲存。此時只是記錄訂閱網址,伺服器清單不一定已出現新設定。
執行更新
返回主介面,選擇「訂閱群組」→「更新全部訂閱(不透過代理伺服器)」。目前網路無法直接連線訂閱網址時,再嘗試透過代理伺服器更新。
選擇設定
更新完成後展開對應群組,雙擊一筆設定,或透過右鍵選單將其設為作用中伺服器,再開啟系統代理伺服器。
如果剪貼簿中取得的是 vmess:// 或 vless://,不要新增訂閱群組。請使用「伺服器」→「從剪貼簿匯入批次 URL」,匯入後檢查網址、連接埠、傳輸方式及 TLS 相關欄位。單筆 URI 不會因為點選「更新全部訂閱」而自動變更。
v2rayNG Android 版新增訂閱
v2rayNG 的訂閱管理與單筆設定匯入同樣是兩個不同入口。訂閱網址應進入「訂閱群組設定」,而 QR Code、剪貼簿中的協定連結則屬於單筆設定匯入。本文以 1.10.x 系列介面為基準;在不同螢幕尺寸下,側邊選單可能顯示為左上角的選單按鈕。
進入設定
開啟側邊選單,進入「訂閱群組設定」。不要先點選主介面的單筆設定新增按鈕。
填寫網址
點選右上角「+」,填寫訂閱備註及完整網址。視需要開啟自動更新,但首次新增仍建議先手動更新一次。
儲存並返回
儲存訂閱群組後返回主介面,開啟右上角選單,執行「更新訂閱」。等待完成提示後再查看設定清單。
選取設定
點選清單中的目標設定,使其成為目前的作用中項目,再點選連線按鈕。首次連線時會出現系統網路連線確認提示。
確認結果
連線後查看即時記錄,確認沒有 DNS、握手、憑證名稱或連線逾時錯誤,再使用瀏覽器存取一般 HTTPS 頁面重新測試。
若複製的是單節點 URI,可在主介面使用「從剪貼簿匯入設定」。匯入前確認剪貼簿中只有目標連結,避免前後混入說明文字。批次匯入多筆連結時應一行一筆;某一行損壞通常不會改變其他行的協定參數,但可能讓用戶端顯示部分解析失敗提示。
- 更新後清單為空:先回到訂閱群組設定,確認該群組已啟用,且網址前後沒有空格。
- 更新成功但數量不變:檢查目前檢視的群組是否正確,並確認伺服器回傳內容確實有所變更。
- 連線按鈕立即恢復原狀:開啟記錄,核對連接埠、核心啟動狀態及設定解析錯誤,不要反覆刪除訂閱。
- 需要切換核心:v2rayNG 使用 Xray 核心;需要 v2fly 核心的 Android 用戶端可使用 v2flyNG,但不能假設兩者對新協定參數的支援範圍完全相同。
如何辨識 Base64、VMess 與 VLESS 格式
「Base64 訂閱」通常表示訂閱回應本文經過 Base64 編碼,解碼後才會是一行一筆的協定連結。Base64 是文字編碼方式,不是代理協定,也不決定連線是否加密。用戶端更新訂閱時會負責辨識及解碼,正常情況下無需手動處理。
VMess 單節點通常以 vmess:// 開頭,後面可能是編碼後的 JSON 資料,解碼後可看到網址、連接埠、使用者識別碼、傳輸方式等欄位。VLESS URI 通常直接以查詢參數表達加密層、傳輸層、伺服器名稱、指紋及流控等設定,因此更容易直接看出參數結構。
訂閱網址
- 外觀
- 以 https:// 開頭
- 內容
- 遠端回傳多筆設定
- 更新
- 支援重新擷取
- 匯入入口
- 訂閱群組設定
網址只是資料入口,實際協定取決於回傳內容。
Base64 清單
- 性質
- 文字編碼
- 解碼結果
- 多行協定 URI
- 常見入口
- 訂閱回應本文
- 手動修改
- 通常不需要
出現編碼錯誤時,應先檢查回應是否完整。
VMess URI
- 前綴
- vmess://
- 身分欄位
- UUID
- 常見傳輸方式
- TCP、WebSocket
- 匯入入口
- 剪貼簿批次 URL
編碼後的內容少一個字元,也可能導致整體解析失敗。
VLESS URI
- 前綴
- vless://
- 身分欄位
- UUID
- 參數位置
- 查詢字串
- 匯入入口
- 剪貼簿批次 URL
Reality、SNI、Flow 等參數需要與伺服器設定一致。
訂閱網址結構:
https://sub.example.com/client/feed?id=7319&token=8f2d1a
單節點結構:
vmess://編碼後的設定文字
vless://[email protected]:443?security=reality&type=tcp&flow=xtls-rprx-vision#範例名稱
上方內容僅用於說明結構。實際匯入時不要把範例網址當成可連線設定。尤其是 VLESS URI,security、type、flow、sni、fp 與公鑰等欄位存在組合關係;只保留網址和連接埠,通常不足以建立連線。
更新訂閱時用戶端實際做了什麼
點選更新後,用戶端會先請求訂閱網址,再辨識回應是純文字 URI 清單、Base64 文字,還是相容的結構化內容,接著解析每筆設定並寫入對應群組。請求成功不代表每筆設定都解析成功,因此要同時查看更新提示、設定數量及記錄。
部分訂閱會在設定名稱、伺服器網址或協定參數變更時取代舊記錄。手動修改由訂閱產生的設定,下一次更新後可能會被遠端資料覆寫。需要長期保留的本機調整,應複製為獨立設定,並在名稱中標記來源,避免與自動更新項目混淆。
- 請求階段:解析訂閱網域,建立 HTTPS 連線並等待回應。此階段失敗通常會表現為逾時、網域解析失敗或憑證錯誤。
- 解碼階段:辨識回應本文並嘗試進行 Base64 解碼。內容被登入頁面、錯誤頁面或閘道提示取代時,可能出現格式錯誤。
- 解析階段:逐筆讀取 VMess、VLESS 等設定,檢查必要欄位能否轉換為用戶端內部結構。
- 寫入階段:將結果歸入指定訂閱群組,並根據名稱或內部識別碼處理既有項目。
- 使用階段:使用者選取作用中設定後,核心讀取參數並啟動本機監聽連接埠;到這一步才會建立實際連線。
匯入失敗請依此順序排查
排查重點是先確認失敗發生在請求、解碼、解析,還是核心啟動階段。若訂閱更新時已經報錯,就不必先調整系統代理連接埠;若設定已出現但無法連線,則應轉向檢查協定參數、核心記錄及本機監聽狀態。
訂閱一直更新逾時?
先在瀏覽器中確認訂閱網域能否建立 HTTPS 連線,不要公開頁面本文。v2rayN 在已有可用設定時,可改用「訂閱群組」→「更新全部訂閱(透過代理伺服器)」;沒有可用設定時,應先檢查本機網路及網域解析。
顯示成功但清單是空的?
開啟訂閱群組設定,檢查群組是否啟用、URL 前後是否有空格,並確認目前清單已篩選到該群組。若回應實際上是登入頁面或錯誤說明,用戶端可能無法解析出任何協定連結。
貼上 vmess 連結後沒有反應?
確認使用的是「伺服器」→「從剪貼簿匯入批次 URL」,而不是訂閱網址輸入框。複製時應從 vmess:// 開始,到連結結尾完整保留,中間不要換行。
匯入 vless 後缺少 Reality 參數?
重新複製完整 URI,重點核對 security=reality、伺服器名稱、指紋、公鑰、短識別碼及 Flow。若來源只提供網址、連接埠和 UUID,便需要補齊伺服器要求的其他欄位。
設定出現了但網頁打不開?
先確認已選取作用中設定並開啟系統代理伺服器,再查看核心記錄。若記錄顯示 10808 等本機連接埠已被佔用,應在「設定」→「參數設定」中調整本機監聽連接埠,並同步更新依賴該連接埠的代理設定。
也可以透過交叉測試縮小範圍:同一份訂閱在 v2rayN 能更新、在 v2rayNG 無法更新時,優先檢查 Android 端的網路權限、系統時間及用戶端版本;兩端都失敗時,優先檢查訂閱網址有效期限、請求參數及伺服器回應。在尚未確認訂閱能正常回傳資料前,不要頻繁更換核心設定。
匯入完成後的驗證清單
訂閱匯入只是將設定寫入用戶端。能否正常使用,還取決於作用中設定、核心支援範圍、系統代理伺服器或網路連線狀態、DNS 處理方式,以及遠端參數是否相符。依固定順序驗證,可以避免把本機代理未開啟誤判為訂閱失效。
- 目標訂閱群組已啟用,更新後能看到預期數量的設定。
- 目前作用中項目來自正確群組,網址、連接埠及協定類型都不是空值。
- v2rayN 核心能夠啟動,本機監聽連接埠未被其他程序佔用。
- 桌面版已依需求開啟系統代理伺服器;v2rayNG 已完成系統連線確認。
- 核心記錄沒有持續出現握手、憑證名稱、Reality 參數或 DNS 錯誤。
- 更新訂閱後重新選取作用中設定,避免繼續使用已被取代的舊記錄。
- 單節點連結與訂閱網址分別使用正確入口,不要混用兩種匯入方式。
需要移轉裝置時,優先在新用戶端中重新新增訂閱網址並執行更新,而不是逐筆複製訂閱產生的節點。這樣可以保留群組關係,也能在之後繼續更新。只有本機手動建立、遠端訂閱不會提供的設定,才需要單獨匯出或重新填寫。