V2Ray 订阅格式解析：Base64、原生 JSON 与分享链接转换

先区分编码、容器与协议

处理 V2Ray 订阅时，最容易混淆的是“编码格式”“配置容器”和“代理协议”三个层级。Base64 是一种文本编码方式，它负责把原始字节转换成便于传输的字符；JSON 是结构化数据格式，可以保存完整内核配置，也可以只保存某个节点的字段；VMess、VLESS 则是代理协议，决定客户端与服务端如何交换必要信息。三者不处于同一层级，不能简单理解为互相替代。

常见订阅响应看起来是一长串无明显分隔的字符，解码后往往是多行分享链接。此时 Base64 只是外包装，真正可导入的内容位于解码结果中。另一类订阅地址直接返回 JSON，其中可能包含节点数组，也可能是一份带有入站、出站、路由和 DNS 设置的内核配置。还有一些地址直接返回逐行排列的 vmess:// 或 vless:// 链接，不再增加外层编码。

因此，识别格式时应从外到内判断：先看 HTTP 响应得到的是普通文本还是 JSON，再判断普通文本是否需要 Base64 解码，最后检查解码内容属于分享链接列表、单节点对象还是完整配置。仅凭文件扩展名、字符串长度或订阅地址结尾无法可靠确定内容类型。

Base64 订阅如何识别与解码

传统 Base64 订阅通常把若干分享链接按行连接，再对整段文本编码。客户端更新订阅时，会获取响应正文、尝试解码、按换行符拆分条目，然后分别解析每个 URI。换行可能采用 LF 或 CRLF，规范的解析过程需要兼容两者，并忽略首尾空白和空行。

标准 Base64 字符表包含大小写字母、数字、加号和斜杠，末尾可能带一个或两个等号作为填充。URL 安全变体会把加号和斜杠替换为减号与下划线，而且有时省略末尾填充。某些订阅生成端还会在正文前加入不可见标记，或者返回带有额外空格的内容。转换工具若只接受一种字符表，可能在订阅本身仍有效时报告“解码失败”。

解码后的结果通常类似下面的行式结构。这里展示的是结构示意，域名使用保留后缀，不对应可连接服务：

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.invalid&path=%2Fconnect#Office
vmess://eyJ2IjoiMiIsInBzIjoiVGVzdCIsImFkZCI6Im5vZGUuaW52YWxpZCJ9

第一行是参数位于 URI 中的 VLESS 分享链接；第二行的 vmess:// 后仍包含一段编码文本，需要继续解码才能看到单节点 JSON。也就是说，外层订阅和单条 VMess 分享链接可能分别使用一次 Base64。只解开订阅外层并不代表已解析节点字段，连续解码时也不能把普通 UUID、路径或备注误当成新的编码层。

浏览器或命令行工具解码时，还要注意文本字符集。节点备注通常使用 UTF-8；如果工具把结果按其他字符集处理，中文备注可能出现乱码，但服务器地址、端口和 UUID 未必受到影响。乱码不应通过删除节点字段来处理，正确方法是保持 UTF-8，并在重新编码前确认换行和 URI 百分号编码没有被改变。

原生 JSON 配置的层级与边界

原生 V2Ray 或 Xray JSON 配置通常描述一个可直接交给内核处理的运行结构。它不仅包含远端节点，还可能包含本地监听端口、DNS、日志、路由规则、策略以及多个出站。下面是经过缩减的结构示意：

{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "udp": true
      }
    }
  ],
  "outbounds": [
    {
      "tag": "proxy",
      "protocol": "vless",
      "settings": {
        "vnext": [
          {
            "address": "node.invalid",
            "port": 443,
            "users": [
              {
                "id": "11111111-2222-3333-4444-555555555555",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "wsSettings": {
          "path": "/connect",
          "headers": {
            "Host": "edge.invalid"
          }
        }
      }
    }
  ]
}

这类配置中的 inbounds 决定本机应用如何接入代理，outbounds 描述流量离开客户端后的处理方式，routing 决定流量应该进入哪个出站，dns 则控制域名解析。分享链接通常只覆盖某个远端出站所需的信息，无法完整表达本地监听、复杂分流、多个出站之间的关系和 DNS 规则。

也有服务把“订阅 JSON”设计成自定义对象，例如顶层包含节点数组、更新时间或分组名称。这种 JSON 不是内核原生配置，字段名和层级由生成端与客户端约定。看到大括号后，不能直接把它交给内核；应先检查是否存在 inbounds、outbounds 等核心结构，或查看客户端是否明确支持该订阅结构。

v2rayN 可以管理节点、订阅和路由，再根据界面设置生成内核运行配置。Android 上的 v2rayNG 使用 Xray 内核，v2flyNG 使用 v2fly 内核。即使三者都能识别常见分享链接，具体内核版本支持的传输参数仍可能不同。把一份完整 JSON 从一个客户端复制到另一个客户端时，本地监听、日志路径或平台相关设置通常需要重新核对。

VMess 与 VLESS 分享链接分别保存什么

VMess 链接：编码后的单节点对象

常见 VMess 分享链接以 vmess:// 开头，后面是一段 Base64 编码的 JSON。解码后常见字段包括版本标识、备注、服务器地址、端口、用户 ID、传输网络、伪装域名、路径和传输安全设置。不同生成工具可能使用简写字段，字段值也可能以字符串形式保存，因此转换时需要进行类型归一化。

VMess 分享对象是长期形成的交换格式，并不等同于完整的 V2Ray 配置规范。某些扩展字段只有特定客户端能够识别，另一些旧字段在新内核中已不再承担原来的作用。转换工具应优先保存明确可映射的信息，不能根据备注文字猜测传输方式，也不应在缺少参数时自动补出与服务端不一致的值。

VLESS 链接：URI 参数直接表达连接信息

VLESS 通常采用标准 URI 风格：用户信息位置保存 UUID，主机和端口紧随其后，查询参数描述加密标记、传输网络、安全层、服务器名称、路径等内容，井号后的片段作为节点备注。查询参数的顺序一般不影响语义，但参数名称、大小写和取值必须按客户端支持范围解析。

URI 中的路径、备注、主机头等内容可能经过百分号编码。例如斜杠、空格和中文备注在链接中会表现为转义序列。解析时应先按 URI 规则拆分结构，再对各字段解码；若先对整条链接做不加区分的替换，可能破坏分隔符或让路径中的特殊字符改变含义。

分享链接没有覆盖的配置

单条链接主要服务于节点交换，不负责携带整个客户端环境。系统代理开关、TUN 设置、本地端口、订阅更新周期、延迟测试方式、路由规则集和 DNS 策略通常不会随节点链接传递。导出后再导入另一台设备，节点可以出现，但原有分流行为未必一起恢复，这是格式边界而不是节点丢失。

格式转换必须保留的关键字段

从订阅列表转换为分享链接、从分享链接生成出站 JSON，或者把完整 JSON 拆成单节点信息时，最重要的是建立字段对应关系。服务器能够建立连接，依赖的不只是地址和端口，还包括身份、传输层、安全层及其附属参数。

1. 服务器地址与端口：域名应保持原样，除非配置明确要求固定地址。提前把域名替换成某次解析得到的地址，可能绕过后续 DNS 更新。
2. 用户身份字段：VMess 和 VLESS 常使用 UUID。复制、解码和重新编码过程中必须保持字符完整，不能把它当作数字处理或移除连字符后自行改变格式。
3. 传输网络：TCP、WebSocket、gRPC 等传输方式需要与服务端一致。仅保留服务器与端口而丢失网络类型，客户端通常会按默认方式连接，结果与原配置不匹配。
4. 传输附加参数：WebSocket 路径与 Host、gRPC 服务名等字段属于连接的一部分。空字符串、根路径和字段缺失有时具有不同含义，转换时不宜合并处理。
5. 安全层参数：TLS 是否启用、服务器名称及相关选项应准确映射。服务器地址与用于安全握手的名称可能不同，不能因为两者看起来相似就覆盖其中一个。
6. 节点备注：备注不决定连接，但会影响节点识别与分组。应使用 UTF-8 保存，并在 URI 片段中正确进行百分号编码。

完整 JSON 转换成分享链接时，损失最明显的是路由和 DNS。假设配置中有 proxy、direct 和 block 三个出站，并由规则决定不同域名进入哪个出站，那么导出 proxy 对应的单条链接后，只能保留这个远端连接。重新导入链接不会自动重建另外两个出站及规则关系。

反向转换也存在边界。分享链接可以生成一个远端出站，但本地入站端口、日志级别、DNS 服务器和路由模式仍需由客户端补充。v2rayN、v2rayNG 与 v2flyNG 通常会用各自的默认设置组合节点信息，因此同一链接在不同设备上导入成功，并不保证最终生成的完整运行配置逐项相同。

订阅导入失败的分层排查

遇到“订阅无法解析”或“导入后没有节点”时，应按获取、解码、拆分、协议解析和连接验证的顺序定位。一次性修改全部字段会掩盖真正原因，也容易把可用配置改坏。

第一步：确认获取到的是订阅正文

订阅地址可能因为授权失效、网络重定向或服务端错误而返回普通提示页。提示页同样是文本，但既不是 Base64，也不是 JSON。检查响应开头是否出现页面标签、错误说明或登录提示，并确认客户端请求后得到的内容与浏览器环境下需要的认证方式一致。

第二步：判断是否需要外层解码

如果正文由 Base64 字符组成，可尝试按标准形式和 URL 安全形式解码。解码后应出现可识别的链接前缀或 JSON 结构。若结果仍是无规律二进制内容，不要反复解码；先确认响应是否经过压缩、字符集是否正确，以及复制过程中是否缺失字符。

第三步：检查行分隔与不可见字符

解码结果有多个链接却只导入一个节点，常见原因是换行没有被正确识别。检查链接之间使用的是 LF、CRLF，还是被转义为字面量字符。文件开头的不可见标记也可能让第一条链接前缀识别失败。清理时只删除明确的空白与标记，不要删除 URI 内部的百分号编码。

第四步：核对协议字段与客户端能力

链接能被识别但提示参数不支持，通常说明分享格式包含当前客户端或内核版本尚未处理的字段。先更新到适合平台的 v2rayN、v2rayNG 或 v2flyNG，再对照原始配置确认传输网络、安全层和附属参数。不要通过随意删除未知参数来追求“导入成功”，因为被删除的字段可能正是服务端要求的连接条件。

第五步：把解析成功与连接成功分开

节点出现在列表中，只能说明文本解析完成。真正连接还取决于服务器状态、域名解析、本地网络、时间设置、传输参数和安全握手。排查时先确认节点字段与源内容一致，再执行真实连接测试；如果多个格式转换后的节点都无法连接，应回到原始链接或原始 JSON 对照，而不是继续叠加转换。

选择格式时看使用目标

如果目标是定期获取多个节点，订阅列表更适合集中更新；如果只需要在设备之间传递一个节点，分享链接更直接；如果需要保存复杂分流、多个出站、本地入站和 DNS 策略，完整 JSON 才能表达足够的信息。格式选择应服从配置范围，而不是比较哪一种字符串看起来更简短。

日常管理中可以把订阅作为节点来源，由客户端负责更新与分组，再在本地维护路由和 DNS。需要迁移复杂配置时，应分别备份节点来源与本地规则，避免把单条分享链接当成完整备份。转换前保留源数据，转换后逐项核对地址、端口、UUID、传输网络、安全设置、路径和服务器名称，可以显著减少“成功导入但无法连接”的情况。