# VMessAEAD 客户端与 JSON 导入

Source: https://onexray.com/zh/docs/protocols/vmess/
Description: 将 VMessAEAD 分享链接或原生 VMess outbound JSON 导入 OneXray，保留 WebSocket、TLS 参数，并区分旧 VMess 二维码格式。


OneXray 支持 VMess outbound 配置与 VMessAEAD 分享链接。不能仅根据 `vmess://` 开头判断格式：当前 URI 与旧 Base64 二维码 JSON 使用相同的 scheme。

## 支持哪种格式

使用符合 [Xray 分享链接规范](https://github.com/XTLS/Xray-core/discussions/716)的 VMessAEAD URI，或原生 Xray outbound JSON。不支持旧 `vmess://Base64(JSON)` VMessQrCode 格式；把它放进订阅也不会变成新 URI。

如果来源只提供旧格式，请索取 VMessAEAD 或包含完整参数的原生 Xray JSON。不要把 VMess 链接前缀改成 VLESS；这不会改变服务器协议或凭据。

## 准备资料并导入

需要服务器地址、端口、UUID、VMess security、传输及 TLS 参数。使用 WebSocket 时，确认 Host 与 path，并单独复制服务提供方的 TLS server name。

1. 进入“服务器 → 添加服务器”，导入受支持链接或节点文件。
2. 手动 JSON 使用根部包含 `outbounds` 的对象，数组中只填写一个节点。
3. 导入后核对名称、VMess 协议与传输标签。
4. 在连接页选择节点，完成平台前置设置，再测试实际需要访问的目标。

以下现有 WebSocket/TLS 示例包含占位符，必须替换后才能使用，不是公开可用节点：

[JSON: outbound-vmess-ws.json](https://onexray.com/examples/outbound-vmess-ws.json)

```json
{
  "outbounds": [
    {
      "tag": "My VMess server",
      "protocol": "vmess",
      "settings": {
        "vnext": [
          {
            "address": "server.example.com",
            "port": 443,
            "users": [
              {
                "id": "00000000-0000-4000-8000-000000000001",
                "security": "auto"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "wsSettings": {
          "path": "/proxy",
          "host": "server.example.com"
        },
        "tlsSettings": {
          "serverName": "server.example.com"
        }
      }
    }
  ]
}
```


文件结构见 [outbound JSON 规范](https://onexray.com/zh/docs/configuration/outbound/)。普通服务器导入不会安装路由、DNS 或本地入站；完整配置请使用 [Raw JSON](https://onexray.com/zh/docs/configuration/raw-json/)。

## 排查失败

未导入节点时，先区分链接格式不支持还是服务器参数无效。节点导入后无法连接，则核对 UUID、传输路径、Host、security 与 TLS。解析成功不会验证远程服务器是否可用。

修改字段前先查阅[兼容性](https://onexray.com/zh/docs/configuration/compatibility/)和[排错指南](https://onexray.com/zh/docs/troubleshooting/)，不要公开凭据。

[安装 OneXray](https://onexray.com/zh/docs/install/) · [VMess 出站参考](https://xtls.github.io/config/outbounds/vmess.html)