V2Ray 订阅格式全解:Base64 订阅、原生 JSON 与分享链接互转

三种格式的区别：订阅负责分发，JSON 负责运行

先分清“获取地址”和“返回内容”。订阅地址通常是带访问凭据的 HTTPS URL，客户端访问后才取得节点数据。Base64 订阅是常见的返回内容格式，不是代理协议，也不意味着所有订阅都采用同一种编码。把订阅地址本身做 Base64 解码，通常得不到节点。

分享链接主要描述一个远端连接：地址、端口、身份凭据、传输方式及 TLS 参数。完整 JSON 还可以包含本地监听、DNS、分流规则和多个出站。因此，节点能够导出为分享链接，不等于整套运行配置能够完整装进链接。

Base64 解码：先解外层，再识别协议

传统 Base64 订阅可以理解为两层结构：外层把整份链接列表编码，内层每一行仍然遵循各自协议的分享格式。去掉外层后，看到 vmess:// 很正常；不要继续对所有链接使用同一种解码规则。

• VMess 常见分享格式：vmess:// 后面是 Base64 编码的 JSON，常见字段包括 add、port、id、net、tls。
• VLESS 常见分享格式：vless:// 后面是 URI 结构，身份信息、主机和端口位于主体，传输参数放在查询串中；它不是一整段 Base64 JSON。
• 名称与字符集：中文备注需要正确处理 UTF-8；URI 片段中的百分号编码与 Base64 是两套不同规则。
• 编码变体：有些内容采用 URL 安全字符 -、_，或省略末尾的 =，解码工具需要先规范化。

下面的 JavaScript 仅演示本地 UTF-8 编解码。输入 节点 时，编码结果为 6IqC54K5；这是一段字符测试，不是可连接的节点。处理真实订阅时，只在可信的本地环境中操作，不要把含令牌的内容提交到在线转换服务。

function decodeBase64Utf8(input) {
  let value = input.trim().replace(/\s+/g, "")
    .replace(/-/g, "+").replace(/_/g, "/");
  value = value.padEnd(Math.ceil(value.length / 4) * 4, "=");
  const bytes = Uint8Array.from(atob(value), char => char.charCodeAt(0));
  return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
}

function encodeBase64Utf8(text) {
  const bytes = new TextEncoder().encode(text);
  let binary = "";
  for (const byte of bytes) binary += String.fromCharCode(byte);
  return btoa(binary);
}

console.log(encodeBase64Utf8("节点"));       // 6IqC54K5
console.log(decodeBase64Utf8("6IqC54K5"));   // 节点

解码成功只代表编码层可读。结果如果是登录页面、到期提示或其他 HTML，就没有得到有效节点列表。此时继续编码或换扩展名不会修复订阅，需要回到订阅地址和访问权限检查。

v2rayN 导入：订阅地址与剪贴板分开处理

需要后续更新节点时，优先添加订阅分组；只拿到一条或多条分享链接时，使用剪贴板导入。以下按 v2rayN 中文界面的菜单名称说明，不同桌面界面可能调整按钮位置，括号与空格也可能略有差异，应以实际菜单为准。

1. 辨认输入

   HTTPS 获取地址用于订阅分组；以 vmess://、vless:// 开头的内容用于节点导入。不要把完整 JSON 粘贴进订阅地址栏。

2. 添加分组

   打开「订阅分组」→「订阅分组设置」，新增分组，填写备注和订阅地址，保存。地址中的查询参数与访问令牌需要完整保留。

3. 更新订阅

   在「订阅分组」菜单选择「更新全部订阅(不通过代理)」。若直连请求失败，且已有可用代理连接，再尝试「更新全部订阅(通过代理)」，查看更新日志中的结果。

4. 导入链接

   对于分享链接，先复制完整文本，再打开「服务器」→「从剪贴板导入批量URL」。多条链接按行排列；常见桌面界面也可用 Ctrl+V 执行剪贴板导入。

5. 检查参数

   打开导入后的节点编辑窗口，核对地址、端口、传输协议及 TLS 设置。导入成功不代表连接可用，随后查看核心日志，确认是否存在字段不支持或握手失败。

安卓端也需要区分这两种入口：v2rayNG 使用 Xray 内核，v2flyNG 使用 v2fly 内核。能读入同一份链接列表，不代表两者都支持其中每一种传输参数。尤其遇到 VLESS、REALITY 等组合时，应先确认目标客户端及内核支持情况，而不是反复改变 Base64 外层。

分享链接与原生 JSON：哪些能转，哪些会丢

分享链接转 JSON 的本质是字段映射，不是把文本外面加一对大括号。客户端读取链接，建立节点记录，再按所选内核生成运行配置。反向导出时，通常只能取出某个出站对应的连接参数，不能自动携带整套 DNS、路由与本地监听。

下面是一份结构演示配置，只包含监听 127.0.0.1:10808 的 SOCKS 入站与直连出站，不包含远端代理服务器，也不应作为代理节点导入。它说明完整 JSON 可以根本没有可转换成 VMess 或 VLESS 链接的对象。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    }
  ]
}

确实需要加载完整配置时，使用 v2rayN「服务器」→「添加自定义配置服务器」这类专用入口，按界面选择配置文件和匹配内核。自定义配置中的监听端口可能与现有实例冲突；日志出现地址已被占用时，先停止冲突实例或调整端口，而不是修改节点身份信息。

把链接列表重新编码为订阅正文

已经导出多条分享链接时，可以按“一行一个链接”的方式组成文本，再对整个 UTF-8 文本进行 Base64 编码。这能生成传统订阅正文，但不会自动生成可更新的订阅地址。地址仍需要一个可信的 HTTPS 服务返回这份正文。

1. 保留每条链接的协议前缀、查询参数与备注，不要手动删掉看似重复的 TLS 或传输字段。
2. 使用换行符 \n 连接各条链接，不要插入项目符号、引号、JSON 数组括号或表格分隔符。
3. 对完整文本编码一次；不要把每条完整分享链接先单独编码，再拼成另一份无法识别的列表。
4. 本地解码一次，确认能逐行还原原文，再用目标客户端试导入。核对节点数量和关键字段，而不只看成功提示。

从完整 JSON 批量提取链接时，还要处理多个出站、标签引用和传输字段映射。目标分享格式无法表达的字段必须另行记录。转换工具输出了链接，只能说明完成了部分序列化，不能证明与原配置行为一致。

导入失败排查：先检查内容，再检查内核

排错时固定顺序：先确认订阅请求取得有效正文，再确认分享链接能解析，最后检查运行内核与连接参数。把“下载失败”“格式不支持”“连接失败”分开记录，才能避免在错误的层级反复转换。