V2Ray 订阅格式对照：Base64 订阅、原生 JSON 与 vmess:// 分享链接如何互转

先分清三种格式：订阅地址不是节点配置

结论：先看拿到的内容，再选导入入口。一个以 https:// 开头的订阅地址只是获取入口；它的响应正文才决定客户端收到的是 Base64 节点列表、明文分享链接，还是其他结构。把地址本身做 Base64 解码，不会得到服务器配置。

Base64 不负责保密。订阅地址中的访问令牌、节点 UUID 和分享二维码都可能提供连接权限。排查时使用本地编辑器，不把真实内容粘贴到在线解码站；向他人提供日志前，也要移除这些身份信息。

Base64 订阅解码：外层列表与内层节点分别处理

常见的两层结构是：外层 Base64 解码得到若干条 vmess:// 链接；取其中一条，移除前缀后再次解码，才得到节点 JSON。不能对所有输入固定解码两次。若订阅正文已经以分享链接开头，外层就不需要解码。

1. 取得响应正文

   用本地工具查看订阅返回内容。若看到登录页、验证码或错误页，先处理访问问题；HTML 页面不是节点列表，即使请求返回成功也不代表订阅可用。

2. 识别外层

   正文直接出现 vmess:// 或 vless:// 时，按行读取。若是连续编码文本，再尝试 Base64 解码；以 { 或 [ 开头的内容先按 JSON 检查。

3. 分离节点行

   把解码结果按换行拆开，清除每行首尾空白并过滤空行。不要把多条链接拼成一条，也不要破坏链接内部的字符。

4. 解析单条链接

   对本文所述的 VMess v2 格式，去掉 vmess:// 后解码并解析 JSON。若内容不是该结构，应确认分享格式来源，而不是强行套用字段。

以下函数用于本地浏览器控制台，兼容标准 Base64 与常见的 URL 安全字符，补齐省略的尾部填充，并按 UTF-8 还原中文备注。先阅读代码再执行。函数不会发送网络请求，也不会自动读取剪贴板。

function decodeBase64Utf8(input) {
  let value = input.trim().replace(/\s+/g, "");
  value = value.replace(/-/g, "+").replace(/_/g, "/");

  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(value)) {
    throw new Error("输入含有非 Base64 字符");
  }

  value = value.replace(/=+$/, "");
  if (value.length % 4 === 1) {
    throw new Error("Base64 长度不完整");
  }

  value += "=".repeat((4 - value.length % 4) % 4);
  const binary = atob(value);
  const bytes = Uint8Array.from(binary, char => char.charCodeAt(0));
  return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
}

function readSubscription(body) {
  const text = body.trim();
  const decoded = /^(vmess|vless):\/\//i.test(text)
    ? text
    : decodeBase64Utf8(text);

  return decoded.split(/\r?\n/)
    .map(line => line.trim())
    .filter(Boolean);
}

function readVmess(link) {
  const value = link.trim();
  if (!value.startsWith("vmess://")) {
    throw new Error("需要 vmess:// 链接");
  }
  return JSON.parse(decodeBase64Utf8(value.slice(8)));
}

readSubscription 只演示“明文链接列表或其 Base64 编码”这一种订阅约定，不是通用订阅解析器。遇到其他结构时应停止，检查服务方给出的格式说明。Base64 解码成功也只说明编码可读，不代表节点有效或账号仍有权限。

拆开 vmess://：分享字段怎样映射到原生配置

下面是一个用于结构演示的 VMess v2 节点对象。example.com 是文档示例域名，UUID 也仅用于示例，不能据此连接代理服务。字段 v 的值 "2" 表示分享格式版本，不是客户端或内核版本。

{
  "v": "2",
  "ps": "文档示例",
  "add": "example.com",
  "port": "443",
  "id": "00000000-0000-4000-8000-000000000001",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "example.com",
  "path": "/ws",
  "tls": "tls",
  "sni": "example.com"
}

VMess 与 VLESS 是不同协议。vless:// 常见结构是带用户信息、主机、端口和查询参数的 URI，不能照搬“移除前缀后 Base64 解码 JSON”的流程。把链接前缀从 VMess 改成 VLESS，也不会完成协议转换；服务端必须支持对应协议与身份配置。

转成原生 JSON：节点之外还要补齐入站

原生配置不是把解码后的节点 JSON 换一个文件名。下面给出 Xray 常见 VMess、WebSocket、TLS 结构的完整示例：本地提供 SOCKS 入站，出站使用上面的演示节点。具体字段仍应以实际安装的内核版本为准；不能把它视为所有 V2Fly 版本都接受的统一配置。

{
  "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": "vmess",
      "settings": {
        "vnext": [
          {
            "address": "example.com",
            "port": 443,
            "users": [
              {
                "id": "00000000-0000-4000-8000-000000000001",
                "alterId": 0,
                "security": "auto"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "tlsSettings": {
          "serverName": "example.com",
          "allowInsecure": false
        },
        "wsSettings": {
          "path": "/ws",
          "headers": {
            "Host": "example.com"
          }
        }
      }
    }
  ]
}

这个示例没有添加分流规则，默认流量交给首个出站。它也不会自动设置系统代理；应用需要明确使用 127.0.0.1:10808 的 SOCKS 服务。127.0.0.1 限制监听于本机，不应为了排错直接改成面向所有网卡的地址。

• 先查端口。若现有客户端已占用 10808，第二个内核可能启动失败。可停止重复实例，或同步修改本地入站与应用端代理端口。
• 保持证书验证。示例保留 allowInsecure: false。证书错误应检查系统时间、服务器名与证书链，而不是直接关闭验证。
• 区分配置作用域。通过客户端导入自定义配置时，系统代理、TUN 和内置路由是否继续生效取决于导入模式，不应假定与普通节点模式相同。

反向转换：分享链接只能带走部分配置

由单个 VMess 出站生成分享链接，需要先从原生配置提取服务器、用户及传输字段，组装为前文的 v2 分享对象，再按 UTF-8 编码成 Base64，最后加上 vmess:// 前缀。不能把整个原生配置直接编码后加此前缀，那样得到的结构不符合常见节点导入约定。

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

function createVmessLink(share) {
  return "vmess://" + encodeBase64Utf8(JSON.stringify(share));
}

function createBase64Subscription(links) {
  return encodeBase64Utf8(links.join("\n"));
}

createVmessLink 接收的是已按字段表整理好的分享对象，不负责自动提取复杂配置，也不验证节点参数。createBase64Subscription 接收分享链接数组，生成常见订阅正文；它并不会创建一个可更新的订阅地址，后者还需要由受控服务提供响应。

• 原生配置有多个服务器或多个用户时，必须明确选取哪个组合。不要默认数组中的所有内容都属于同一条链接。
• 本地入站、DNS、路由、日志级别和多出站策略通常无法通过一条 VMess 分享链接完整保留。
• 高级传输字段若没有对应的分享格式约定，可能在导入时丢失。需要完整迁移时，应使用配置备份并确认目标内核兼容。

客户端导入：订阅、剪贴板与自定义配置分开使用

客户端能识别某种外层格式，不等于其内核支持里面的所有协议与传输。v2rayN 是桌面客户端；v2rayNG 使用 Xray 内核；v2flyNG 使用 V2Fly 内核。先匹配连接参数与内核能力，再选择导入入口。以下菜单以常见中文界面为参照，不同发布版本可能调整名称和位置。

v2rayN 常见订阅更新操作位于「订阅分组」→「更新当前订阅（不通过代理）」。这一项控制获取订阅时是否经过代理，不会把节点的连接方式改成直连。若订阅站点必须经代理访问，应选择对应的通过代理更新方式，并先确认现有代理链路可用。

1. 更新失败先看响应。地址过期、访问令牌失效或返回网页时，不应继续做节点格式转换。先检查更新日志与订阅权限。
2. 导入失败先看结构。检查是否多复制了引号、缺少前缀，或把完整 JSON 错当成分享链接。中文备注乱码时检查 UTF-8 编解码。
3. 连接失败再看参数。节点已出现在列表却无法连接，应核对 UUID、端口、WebSocket 路径、Host、TLS 与 SNI，而不是反复重做 Base64 编码。
4. 手工修改单独保存。订阅更新可能重建节点条目。临时修改的节点宜复制到独立分组，并记录与订阅原值的差异。

常见问题：解码成功为什么仍然不能使用