VLESS 客户端配置：TLS、REALITY 与 Vision

VLESS 是 OneXray 内置 Xray-core 支持的代理协议。REALITY 是连接安全选项，Vision 是 VLESS 的 flow；它们不是独立的代理协议。请使用服务提供方实际配置的组合。

准备服务器资料

需要地址、端口、用户 ID、encryption 和传输参数。使用 TLS 时，确认 server name 以及所需的指纹或 ALPN；使用 REALITY 时，还需公钥、short ID 等参数。连接地址与 TLS server name 不一定相同。

只有服务端要求且与传输兼容时才填写 xtls-rprx-vision 等 flow，不要给任意 XHTTP 配置额外添加 Vision。传输参数见 XHTTP 指南。

导入链接或 JSON

安装 OneXray，进入“服务器 → 添加服务器”。
导入服务提供方的 vless:// 链接、订阅或节点 JSON 文件。扫描二维码仅支持 iOS 和 Android。
手动编辑 JSON 时，outbounds 数组中只保留一个节点，保存前填入全部真实参数。
核对名称与协议标签，在连接页选择该节点；没有特别需求时使用智能路由即可。

现有 TLS 模板使用示例地址与凭据，不是可直接联网的服务器：

JSON: outbound-vless-tls.json

{
  "outbounds": [
    {
      "tag": "My VLESS server",
      "protocol": "vless",
      "settings": {
        "vnext": [
          {
            "address": "server.example.com",
            "port": 443,
            "users": [
              {
                "id": "00000000-0000-4000-8000-000000000001",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "raw",
        "security": "tls",
        "tlsSettings": {
          "serverName": "server.example.com"
        }
      }
    }
  ]
}

REALITY 模板需要替换公钥占位符以及其他服务器专属参数：

JSON: outbound-vless-reality.json

{
  "outbounds": [
    {
      "tag": "My REALITY server",
      "protocol": "vless",
      "settings": {
        "vnext": [
          {
            "address": "server.example.com",
            "port": 443,
            "users": [
              {
                "id": "00000000-0000-4000-8000-000000000001",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "raw",
        "security": "reality",
        "realitySettings": {
          "serverName": "cover.example.com",
          "fingerprint": "chrome",
          "password": "REPLACE_WITH_REALITY_PUBLIC_KEY",
          "shortId": "0123456789abcdef"
        }
      }
    }
  ]
}

这里的 realitySettings.password 保存服务端公钥，不是私钥。字段范围与命名规则见 outbound 规范。

连接失败时如何检查

导入或配置校验通过不代表服务器可达。逐项比对 ID、端口、flow、传输、server name、公钥和 short ID。给节点改名不会修复来自另一台服务器的 REALITY 密钥。

不要通过关闭 TLS 校验来掩盖证书错误。如果节点可用但部分域名无法访问，先检查路由与 DNS，不要随意更换协议参数。排错指南区分导入、配置校验、启动与实际连接失败。

参考：Xray VLESS 出站。

最后更新于九月 17, 2026

XHTTP 传输