V2Ray 订阅格式详解:Base64 订阅、原生 JSON 与分享链接的互相转换

先分清订阅地址、响应正文与节点配置

形如 https://sub.example.com/list?token=demo 的地址，只负责让客户端请求内容，不能单凭网址判断返回格式。本文域名、UUID 和参数均为结构示例，不提供可用连接。实际订阅地址中的令牌通常具有访问权限，分享地址就可能泄露整组节点。

传统 V2Ray 订阅常把多条分享链接按行连接，再对整段文本进行 Base64 编码。也有服务直接返回未编码的链接列表，或按客户端请求返回不同内容。因此，浏览器打开的结果和客户端更新时取得的结果不一定相同。

v2rayN 与 v2rayNG 分别从哪里导入

两个客户端都能管理常见的 VMess、VLESS 分享链接及传统链接订阅，但“识别文本”不代表目标内核一定支持其中全部参数。界面名称会随版本变化，以下按功能入口区分，避免把订阅 URL 粘贴到单节点字段。

v2rayNG 使用 Xray 内核；v2flyNG 使用 V2Fly 内核。即使某份 JSON 语法正确，也不能据此认定两个内核都支持其中的安全机制或配置字段。尤其涉及 VLESS、REALITY 等组合时，应先确认目标内核能力，再讨论格式转换。格式转换不能增加协议支持。

Base64 订阅解码：先检查外层，再看每行

第一步是确认拿到响应正文，而不是下载错误页面。正文若以 <!DOCTYPE html>、登录提示或接口错误开头，就不是等待解码的订阅内容。只改文件后缀、反复导入，无法解决鉴权过期或服务端返回错误的问题。

1. 把响应正文保存为本地文本，保留原件。删除复制时带入的说明文字，不要把 URL 当作 Base64 正文。
2. 若正文已经以 vmess:// 或 vless:// 开头，先按明文链接列表处理，不再解码整个正文。
3. 若正文是一长段编码字符，进行一次外层 Base64 解码，再按换行拆分，清除空行。
4. 逐行检查协议前缀。某行是 vmess:// 时，其后还可能有一层 VMess 分享信息编码；这不代表整个订阅需要无限重复解码。

下面代码仅用于在本地空白页面的开发者工具控制台中处理已取得的文本，不会请求订阅地址。先执行函数定义，再用 decodeSubscription(prompt("粘贴订阅响应正文")) 调用。不要在不可信网页的控制台处理真实凭据。

function decodeSubscription(input) {
  const raw = String(input ?? "").trim();
  if (!raw) throw new Error("正文为空");
  if (/^(vmess|vless):\/\//i.test(raw)) return raw;

  let encoded = raw.replace(/\s/g, "")
    .replace(/-/g, "+").replace(/_/g, "/");
  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) {
    throw new Error("内容不符合 Base64 字符规则");
  }
  encoded = encoded.replace(/=+$/, "");
  if (encoded.length % 4 === 1) {
    throw new Error("编码长度异常，请检查是否复制完整");
  }
  encoded += "=".repeat((4 - encoded.length % 4) % 4);
  const bytes = Uint8Array.from(atob(encoded), c => c.charCodeAt(0));
  return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
}

分享链接生成 Base64：按行连接再编码

明文列表转成传统 Base64 订阅正文，操作顺序是“每行一条链接 → UTF-8 字节 → Base64”。这只生成静态正文，并不会自动创建一个可更新的订阅服务。把结果保存到本地文件，也不等于客户端已经拥有可访问的订阅 URL。

const link = "vless://[email protected]:443?encryption=none&security=tls&type=tcp&sni=node.example.com#Example-TLS";

function encodeSubscription(links) {
  const text = links.map(item => item.trim()).filter(Boolean).join("\n");
  const bytes = new TextEncoder().encode(text);
  let binary = "";
  for (const byte of bytes) binary += String.fromCharCode(byte);
  return btoa(binary);
}

const encoded = encodeSubscription([link]);
console.log(encoded);
console.log(decodeSubscription(encoded) === link);

中文备注也会进入编码内容，所以不宜直接对含中文的字符串调用 btoa。先使用 TextEncoder 转为 UTF-8 字节，可避免字符超出范围。最后一行的往返比较应得到 true；它验证编码过程没有改变示例文本，不验证节点是否可连接。

以上数字是协议编码规则和配置示例，不是测速结果，也不是所有客户端版本的默认值。Base64 不是压缩；忽略尾部填充时，编码后的长度约为原字节数的四分之三的倒数，即约增加三分之一。

分享链接与原生 JSON：字段映射不等于完整迁移

以刚才的 VLESS 链接为例，主机与端口进入出站服务器设置，UUID 进入用户设置，security=tls 对应 TLS，sni 对应 TLS 的服务器名称。下面是 Xray 风格的单个出站对象，不是可直接运行的完整配置文件，需要放入完整配置的 outbounds 数组。

{
  "tag": "proxy",
  "protocol": "vless",
  "settings": {
    "vnext": [
      {
        "address": "node.example.com",
        "port": 443,
        "users": [
          {
            "id": "11111111-1111-4111-8111-111111111111",
            "encryption": "none"
          }
        ]
      }
    ]
  },
  "streamSettings": {
    "network": "tcp",
    "security": "tls",
    "tlsSettings": {
      "serverName": "node.example.com"
    }
  }
}

若要构成运行配置，还要明确本地入站、出站选择及必要的路由设置。例如假设本地 SOCKS 监听为 127.0.0.1:10808，调用它的应用也必须填写这个地址与端口。远端 443 不能填成本地代理端口；两者分别位于链路两端。

VMess 常见分享形式则是 vmess:// 后接 Base64 编码的分享对象。对象里的 add、port、id、net、path 等字段属于分享约定，不是内核原生配置的顶层字段。把解码出的对象直接保存为运行配置，通常会因结构不匹配而失败。

转换后验证：更新成功与连接成功分开看

订阅更新成功只说明客户端取得并解析了部分或全部内容，不代表所有节点都可用。建议保留原订阅分组，把转换结果导入单独的测试分组；先验证一条，再批量处理。手动导出的静态链接也不会继承原订阅的更新关系。

1. 核对记录：比较转换前后的节点数量，检查是否有空行、重复记录或不支持的协议被跳过。
2. 核对字段：打开节点编辑界面，检查地址、端口、UUID、传输、路径、SNI 和安全机制；不要只看备注相同。
3. 核对运行：选中测试节点并查看内核日志。配置解析错误、鉴权失败与连接超时应分别处理。
4. 核对应用接入：确认系统代理或应用代理指向实际本地监听端口，再检查路由是否把测试请求送入预期出站。