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

三种格式：地址、节点列表与完整配置

“V2Ray 订阅”不是单一的文件规范。日常收到的订阅地址通常是一个 HTTPS URL，客户端访问它后，才取得节点列表。返回内容可能是逐行排列的分享链接，也可能是这份列表经过 Base64 编码后的文本。地址负责获取和更新，内容负责描述节点，二者不能互相替代。

Base64 是编码，不是加密；能解码的人通常也能看到服务器地址与身份凭据。不要把订阅 URL、解码后的节点列表或完整配置粘贴到公开讨论区。订阅 URL 中的令牌还可能允许他人持续获取更新，不能因为它看起来不像密码就公开。

v2rayN 与 v2rayNG：选对导入入口

v2rayN 是桌面客户端，v2rayNG 是使用 Xray 内核的 Android 客户端。两者常用的订阅流程都面向节点列表，能够解析哪些协议和参数还取决于客户端及内核版本。不能把“支持 JSON”理解成“订阅更新入口能直接接受任意 JSON”。

1. 建立订阅组

   v2rayN 主界面进入「订阅分组」→「订阅分组设置」，添加分组并填写订阅 URL。这里填写地址，不粘贴整段 Base64 内容。

2. 更新节点

   返回「订阅分组」菜单，选择「更新全部订阅（不通过代理）」；如果地址需要经过现有代理访问，再尝试对应的「通过代理」更新项。不同界面的标点与名称可能略有差异。

3. 测试单条

   在 v2rayN 使用「服务器」→「从剪贴板导入批量 URL」。在 v2rayNG 使用主界面「+」→「从剪贴板导入」，只复制协议链接本身，不带引号与说明文字。

4. 安卓订阅

   v2rayNG 主界面右上角菜单进入「订阅分组设置」，通过「+」添加地址并保存，再返回主界面菜单执行「更新订阅」。若所用版本菜单名称不同，以订阅分组与更新功能为准。

v2flyNG 使用 v2fly 内核，不应把适用于 Xray 的所有扩展参数原样套用过去。尤其是 REALITY、特定流控等能力，必须先确认内核支持；本文的字段转换示例针对 Xray，不作为跨内核兼容承诺。

Base64 解码与重编码：只转换外层包装

常见 Base64 订阅的生成过程是：将每条节点链接放在独立的一行，再对整份 UTF-8 文本编码。因此，正确的解码结果通常仍是链接，而不是 JSON。部分提供方直接返回明文链接列表，这时不需要再做一次解码。

在 Mac 上，可以先复制 Base64 订阅正文，再在终端执行下面的命令。命令读取剪贴板并把结果输出到当前终端，不会替你访问订阅地址。输出中包含凭据，操作时避免共享终端画面。

pbpaste | base64 -D

反向操作时，先在本地纯文本文件中按行保存分享链接，再编码文件。以下命令假定当前目录已经存在 nodes.txt；它生成的是静态文本文件，不会自动得到一个可供客户端更新的订阅 URL。

base64 -i nodes.txt -o subscription.txt

• 解码失败时，先排除误复制的引号、代码围栏以及网页提示文字；HTTP 错误页面也不是订阅正文。
• 标准 Base64 与 URL 安全变体的字符表不同，后者可能使用 -、_，并省略末尾补位。不要把所有内容都当成标准 Base64 直接处理。
• vmess:// 的常见分享格式自身还有一层编码过的 JSON。整份订阅解码后看到它是正常现象，不代表所有行都要继续整体解码。
• vless:// 通常直接使用 URI 字段与查询参数。不要照搬 VMess 的内部 JSON 结构来解析 VLESS 链接。

vless:// 转 JSON：逐字段映射

下面用 TCP + TLS 展示最小映射。服务器域名为文档示例域名，UUID 为格式示例，不能直接连接。实际使用时，需要由服务提供方给出匹配的地址、端口、UUID 与 TLS 参数；不能只替换域名就假定可用。

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

这些数字用于解释配置，不是测速结果，也不是所有客户端的默认值。远端端口和本地监听端口属于连接的两端，不要求相同。下面是一份用于说明字段的 Xray 配置，监听地址限定为本机回环地址。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ],
  "outbounds": [
    {
      "tag": "proxy",
      "protocol": "vless",
      "settings": {
        "vnext": [
          {
            "address": "node.example.com",
            "port": 443,
            "users": [
              {
                "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "tcp",
        "security": "tls",
        "tlsSettings": {
          "serverName": "node.example.com"
        }
      }
    }
  ]
}

遇到 WebSocket、gRPC、REALITY 或 Vision 时，还需要映射路径、服务名、公钥、短 ID、指纹或 flow 等相应字段。不要给 TCP 示例随手添加一个 flow=xtls-rprx-vision 就当成转换完成；传输方式、服务端配置和内核能力必须一起核对。

JSON 转分享链接：哪些内容会丢失

反向转换要先找到目标出站，再读取它的协议、服务器、用户和传输设置。上面的 JSON 只有一个 VLESS 出站，因此可以还原为对应链接；若配置包含多个服务器或多个用户，则需要分别生成链接，不能用一条 URI 表示全部对象。

1. 确认目标为 protocol: "vless"，读取 vnext 内的地址、端口和用户 UUID。
2. 把传输网络与安全类型分别写入 type 和 security，再补齐协议所需的查询参数。
3. 对查询参数值与备注做百分号编码。例如路径 /edge?x=1 应写为 %2Fedge%3Fx%3D1，防止问号被误解析。
4. 若服务器地址为 IPv6，URI 中的地址需要方括号；不要直接用冒号拆分整个地址。
5. 在目标客户端重新导入后，逐项核对节点编辑页，再做实际连接测试。

即使链接能成功导入，客户端仍会使用自己的系统代理、TUN、DNS 与路由设置。原始 JSON 中“国内直连、其余代理”的规则不会随着一个 VLESS 节点自动迁移。系统代理决定哪些应用把请求交给客户端，路由规则决定接收后的请求走哪个出站，这是不同层次。

导入失败与连接失败：按阶段排查

先观察故障发生在哪一步：订阅请求失败、正文解析失败，还是节点已经出现在列表中却无法连接。节点出现说明至少通过了部分格式解析，不说明 UUID、TLS 参数或远端服务一定正确。