# 在 OneXray 中配置 XHTTP 传输

Source: https://onexray.com/zh/docs/protocols/xhttp/
Description: 为 OneXray 节点配置 XHTTP，核对服务端提供的 host、path、mode、安全设置和 extra，避免导入时丢失参数。


XHTTP 是 Xray 的传输方式，不是 VLESS 或 VMess 的替代协议。“VLESS | XHTTP | TLS”分别描述三个不同层次。OneXray 导入完整的传输参数，不使用通用预设替代服务器配置。

## 索取完整传输参数

除了协议凭据、地址和端口，还需要：

- XHTTP 的 `host` 与 `path`。
- 服务端要求的 `mode` 与 `extra`。
- TLS 或 REALITY 参数，包括 server name。
- 服务提供方要求的独立下载路径参数。

不要通过国家标签推测这些值，也不要照搬其他节点的路径。CDN 主机名、连接地址和 TLS server name 可能承担不同职责。

## 导入时保留完整设置

打开“服务器 → 添加服务器”，导入服务提供方的受支持分享链接或 JSON 文件。手动 JSON 使用[节点文件格式](https://onexray.com/zh/docs/configuration/outbound/)，只包含一个节点，将 `streamSettings.network` 设为 `xhttp`，并使用服务提供方给出的 `xhttpSettings`。

分享链接不能表达完整的高级传输参数时，使用 JSON。原样保留所需 `extra`，不要把其中的字段摊平为虚构的根部字段。现有 [TLS 与 REALITY 模板](https://onexray.com/zh/docs/protocols/vless/)解释连接的其他层次，但不是现成的 XHTTP 配置。

导入后核对节点行是否显示 XHTTP，在连接页选择节点，再测试实际访问目标。升级客户端不会修复服务端配置了另一种传输的问题。

## XHTTP 无法连接时

逐项对照原始参数中的 `host`、`path`、模式、安全设置与 `extra`，并确认中间服务支持这套连接方案。不要仅因为某篇通用教程这样写，就改成 WebSocket 或添加 Vision。

配置校验不会探测远程服务，也不能证明中间服务会转发实际请求。参考[兼容性](https://onexray.com/zh/docs/configuration/compatibility/)与[排错指南](https://onexray.com/zh/docs/troubleshooting/)，反馈时提供去除凭据后的错误详情，不要公开真实订阅链接。

[安装 OneXray](https://onexray.com/zh/docs/install/) · [让 AI 编写节点 JSON](https://onexray.com/zh/docs/ai/) · [Xray 传输文档](https://xtls.github.io/config/transport.html)