v2rayN、v2rayNG 訂閱匯入教學:設定入口、Base64 與 URI 格式說明

整理 v2rayN、v2rayNG 訂閱分組設定入口與更新步驟,並說明 Base64 和 URI 訂閱格式的差異。

本文重點

先確認取得的是訂閱網址還是單一節點連結,再前往客戶端的訂閱分組設定。儲存網址只會建立分組,還需更新訂閱才會載入節點清單。本文分別說明桌面版與 Android 的操作方式,並整理 URI、Base64 格式差異及更新錯誤排查,適合第一次匯入,或遇到「儲存成功卻沒有節點」的使用者。

先分清訂閱網址、節點連結與設定檔

訂閱網址通常是一組 HTTPS URL。客戶端會透過網址取得多筆節點設定,再將設定加入指定分組。網址可能含有識別權杖與查詢參數,請從服務提供者的訂閱頁面完整複製;不要複製瀏覽器中的帳戶首頁,也不要刪除問號後的內容。

以 vmess:// 或 vless:// 開頭的文字,通常是單一節點的分享連結。這類連結描述一個節點,並非用來定期取得節點清單的 HTTPS 網址。若貼到訂閱網址欄位,通常會出現網址無效或下載失敗;請改用主畫面的剪貼簿匯入功能。

訂閱網址

建議

將網址填入訂閱分組的 URL 欄位,再執行更新。之後節點新增、刪除或參數調整,都可透過後續更新同步至客戶端。

適用情境:初次設定、長期管理一組節點。

單一 URI 連結

使用「從剪貼簿匯入」或掃描節點 QR Code。匯入的是當下那筆設定,通常不會與訂閱來源建立更新關係。

適用情境:臨時新增、排查單一節點。

完整設定檔

內容可能包含入站、出站、DNS 與路由。完整設定檔和訂閱清單是不同類型的資料,不應直接填入訂閱 URL 欄位。

適用情境:熟悉設定檔結構及對應匯入方式的使用者。

在 v2rayN 新增網址並更新訂閱

開啟桌面版主畫面,從頂端的「訂閱分組」進入。不同介面框架或版本的按鈕位置可能略有差異,以下以「訂閱分組設定」作為操作入口;請勿將「從剪貼簿匯入分享連結」當成新增訂閱網址的功能。

  1. 開啟分組設定

    點選「訂閱分組」→「訂閱分組設定」。先確認是否已有相同來源的分組,避免重複新增後出現兩組相似節點。

  2. 填入訂閱網址

    在設定視窗中點選新增,輸入方便辨識的別名,再將完整訂閱網址貼到「可選地址(Url)」或相應的 URL 欄位。別名可自行設定,網址則必須保持原樣。

  3. 儲存並選取分組

    確認儲存,返回主畫面並選取剛建立的訂閱分組。此時清單空白不代表匯入失敗:儲存操作尚未向伺服器取得節點。

  4. 更新訂閱

    開啟「訂閱分組」選單,選擇目前訂閱的更新指令。選單可能提供「透過代理」與「不透過代理」;若目前沒有可用代理,請先嘗試不透過代理更新。

  5. 確認匯入結果

    查看底部訊息或記錄,確認更新完成,再檢查目前分組中的節點名稱與協定。選取節點後,依需求設定系統代理或 TUN;完成匯入不代表所有程式都會自動透過代理連線。

在 v2rayNG 建立訂閱分組

v2rayNG 是使用 Xray 核心的 Android 客戶端。訂閱管理位於側邊選單;主畫面右上角的「+」通常用於匯入分享連結、掃描 QR Code 或手動新增設定。這兩種入口都能新增節點,但管理方式不同。

  1. 前往訂閱設定

    在主畫面點選左上角選單,進入「訂閱分組設定」。若目前版本顯示「訂閱分組」,進入後請確認頁面有分組名稱與訂閱 URL 編輯欄位。

  2. 新增訂閱分組

    點選右上角「+」,填寫備註與訂閱 URL。貼上後請檢查網址開頭與結尾,移除複製時夾帶的空格、換行或聊天軟體附加文字,再儲存。

  3. 返回並更新

    回到主畫面,在右上角的更多選單中執行訂閱更新。若畫面提供「更新目前分組訂閱」,請先切換至目標分組再更新;若要更新所有分組,則使用相應的全部更新指令。

  4. 選取節點並連線

    確認節點清單已載入,點選要使用的設定,再按下連線按鈕。首次連線時,請依 Android 提示允許建立 VPN 連線;這項授權是在接管流量時要求,不是在儲存訂閱時要求。

若節點已匯入但應用程式無法連網,請分開判斷「訂閱更新成功」與「節點連線成功」。前者只表示訂閱回應已成功解析;後者還取決於伺服器狀態、協定參數、裝置時間與本機網路。請勿為了解決連線問題而連續刪除並重建訂閱。

認識 URI 與 Base64 訂閱內容

訂閱網址是取得內容的入口,訂閱格式則是入口回傳的資料。常見內容包括每行一筆的分享 URI,或將整份 URI 清單以 Base64 編碼的文字。客戶端會依支援的格式辨識內容;即使瀏覽器能顯示回傳資料,也不代表它一定是有效訂閱。

逐行 URI 清單

外層格式
多行純文字
常見前綴
vmess://、vless://
節點分隔方式
通常以換行分隔
解析重點
各連結的協定與參數

VMess 分享連結的常見格式會在協定前綴後編碼一段 JSON;請勿將連結內部的編碼與整份訂閱的編碼混為一談。

Base64 編碼清單

外層格式
編碼後的文字字串
解碼結果
通常是逐行排列的 URI 清單
常見變體
標準字元集與 URL 安全字元集
隱私特性
可逆編碼,並非加密

請勿為了「修正格式」而手動編碼訂閱網址。客戶端需要的是原始取得網址,而不是該網址的 Base64 文字。

64
Base64 基本字元集的字元數,不含填充符號
3 → 4
標準 Base64 會將每 3 個位元組編碼為 4 個字元
443
未明確指定連接埠時,HTTPS 訂閱網址使用的預設連接埠

這些數字有助於理解格式與請求入口,並不代表節點連接埠或連線速度。下載訂閱使用的 HTTPS 連接埠,可能與匯入後各節點的伺服器連接埠完全不同。標準 Base64 結尾可能有 = 填充符號,但不能只憑是否含有這個符號判斷內容是否有效。

依失敗階段排查空清單與更新錯誤

先保留原有的可用節點,再更新目標分組。遇到「沒有節點」時,依序確認分組篩選、請求結果與回傳格式。請勿直接認定是 Base64 格式問題,也不要用訂閱轉換取代基本排查。

狀況優先檢查項目下一步
儲存後清單仍為空白是否確實執行更新、是否選錯分組選取目標分組並更新一次,再取消不必要的搜尋篩選。
連線逾時或網域解析失敗是否能連上訂閱網域、目前網路與更新方式分別測試直連與使用現有代理的連線方式,先不要修改節點協定參數。
HTTP 401 或 403權杖是否失效、帳戶權限或伺服器存取限制向服務提供者確認訂閱狀態並重新複製網址;403 不一定只是帳戶已過期。
HTTP 404路徑是否遭截斷、網址是否已更新重新取得完整連結,不要自行猜測路徑或刪除查詢參數。
請求成功,但解析失敗回傳內容是否為登入頁、錯誤頁或不相容的設定格式查看記錄中的提示,並取得適用於 v2rayN 或 v2rayNG 的訂閱輸出。
只載入部分節點協定支援、訂閱篩選條件與客戶端相容性先取消分組篩選,再確認缺少節點的協定與參數;必要時更新客戶端。

伺服器有時會回傳 HTTP 200,但回應本文其實是登入頁或存取封鎖頁面。此時網路請求雖已完成,客戶端卻找不到可辨識的 URI。請修正訂閱入口或聯絡來源提供者,不要反覆將頁面內容轉成 Base64。

若來源只提供特定的完整設定格式,直接請對方提供相容的分享 URI 訂閱會更簡單。格式轉換還涉及協定欄位對應,不能假設只要換一種文字包裝,就能補上客戶端不支援的參數。

電腦與 Android 共用訂閱時,保留各自設定

同一份訂閱可分別加入 v2rayN 與 v2rayNG,但請先確認服務提供者允許的裝置數量與同時連線數。兩端只是各自存取同一個網址,不會互相推送設定;一端更新後,另一端仍須自行更新。

共用訂閱來源,各自管理本機設定

桌面版:v2rayN
  • 在「訂閱分組設定」中儲存同一個有效網址。
  • 更新後,各自選取目前要使用的節點。
  • 個別設定系統代理、TUN、DNS 與路由。
Android 版:v2rayNG
  • 在「訂閱分組設定」中建立自己的分組。
  • 返回主畫面執行訂閱更新。
  • 個別管理 VPN 連線與各應用程式的代理範圍。

共用的是節點來源,不是裝置上的所有設定;回傳內容也可能因請求參數或客戶端判讀方式而有所不同。

一般節點訂閱通常不會同步本機監聽連接埠、路由規則、DNS 政策與個別應用程式清單,也無法取代完整備份。手動修改訂閱節點後,再次更新可能會覆寫這些變更;若要長期保留自訂設定,請另建手動設定並清楚標示用途。

下載v2rayN依平台選擇客戶端