01 · 分享鏈接與訂閱內容

分享鏈接描述一個配置,訂閱地址用來獲取一組配置並持續更新。支持的訂閱協議包括 VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hy2、TUIC、WireGuard 和 AnyTLS。內容可以是標準鏈接、Base64 包裝的多行鏈接或 v2rayN 內部分享格式。

一個普通網頁地址不是訂閱內容;如果下載結果是登錄頁或錯誤頁,客戶端會解析失敗。應使用提供方給出的訂閱 URL,完整保留其路徑和查詢參數。

02 · 添加並更新訂閱

進入訂閱分組設置,新增一個分組並填寫容易識別的備註。在“可選地址”粘貼完整 URL,保存後執行更新訂閱。更新成功後進入對應分組,選擇配置設爲活動項。

  1. 首次使用沒有可用代理時,可先選擇不通過代理更新;已有可用節點時可嘗試通過代理更新。
  2. 確認啓用更新開關。關閉該開關的分組會被跳過。
  3. 查看日誌中的下載和解析結果。成功更新後原來的延遲、速度測試數據會清空。
  4. 活動配置屬於更新分組時,客戶端會重新處理該活動項;隨後再測試連接。
過濾、合併與請求設置

03 · 內部鏈接的結構

內部格式用於保留普通分享鏈接不能完整表達的配置字段。ConfigType 標識配置類型,後面的載荷是 JSON 的 URL-safe Base64 編碼。Base64 只改變表示方式,不保護密碼。

內部鏈接適合在 v2rayN 之間傳遞;第三方客戶端不一定支持。導入前保持完整前綴和載荷,不要把 URL-safe Base64 中的 -、_ 手動換成其他字符。

Internal share format複製
v2rayn://<ConfigType>/<URL-safe Base64 JSON>

04 · JSON 載荷與引用

普通配置包含類型、版本、備註、地址、端口及協議所需認證字段。IndexId 可爲空;當策略組或鏈式代理需要引用配置時,應爲被引用項提供穩定且唯一的 IndexId。

下面僅展示內部 HTTP 配置的結構,example.com 與用戶名密碼都是示意值。載荷編碼後仍包含憑據,分享前應確認接收對象。

JSON · illustrative HTTP profile複製
{
  "IndexId": "example-http",
  "ConfigType": 10,
  "ConfigVersion": 4,
  "Remarks": "Example HTTP",
  "Address": "example.com",
  "Port": 8080,
  "Username": "example-user",
  "Password": "replace-me"
}

05 · 策略組與動態篩選

策略組可用 ProtoExtraObj.ChildItems 引用其他配置的 IndexId;SubChildItems 設爲 self 時,可結合 Filter 正則篩選當前訂閱分組。內部格式不支持自定義配置。

訂閱中的節點會在更新時重新生成,手動綁定這些節點可能失效。需要自動跟隨更新的組,應使用訂閱分組與別名正則篩選;手工選擇項更適合穩定的自建配置。鏈式代理中的順序按實際流量方向排列。

策略組設置代理鏈設置

06 · 下載成功但沒有節點

先看返回內容是否爲支持格式,而不是網頁、驗證碼或訪問錯誤;再檢查別名過濾是否把全部節點排除了。合併多個訂閱時,內容類型應一致。提供方可能根據 User Agent 返回不同格式,未明確要求時保留默認值。

不要用重複導入來掩蓋解析問題。保留原分組,先修正 URL、格式或過濾條件,再重新更新;必要時用單條分享鏈接確認客戶端解析能力。

07 · 訂閱分組字段

分組可以單獨保存來源,也可以合併相同格式的內容。保存後需要執行更新,過濾和請求設置纔會應用到新獲取的內容。

字段行爲
可選地址 / 更多地址主 URL 放可選地址;其他 URL 用逗號分隔。合併時類型應一致,更多地址非空會停用訂閱轉換
別名正則過濾更新後只保留匹配的別名;空結果先檢查表達式
訂閱轉換目標類型經轉換服務獲取內容;多地址合併時不生效
User Agent默認 v2rayN/版本號,可能影響提供方返回格式
自定義 HTTP 標頭7.25.6 新增;只填寫提供方要求的請求頭,認證值屬於敏感信息
前置 / 落地代理別名引用唯一的現有配置名稱
自定義配置的 Socks 端口訂閱被解析成自定義配置時,將此端口寫入配置項

08 · 備份和還原

備份對象是整個 guiConfigs 文件夾,包含客戶端設置、配置數據庫與自定義配置。使用“備份和還原”保存 ZIP;非 Windows 系統要明確填寫 zip 擴展名,還原對話框只接受 ZIP。

還原會替換相應配置並重啓客戶端,操作前先備份當前狀態。自動重啓失敗時手動啓動。備份包含訂閱 URL 和憑據,保存在自己控制的位置;遷移後檢查本地文件路徑和核心可執行文件是否在新設備存在。

參考資料官方文檔

步驟與參數已在本頁展開,參考鏈接用於標註資料來源。覈對日期:2026-10-19。