sing-box 支持 XHTTP 吗:官方传输列表里没有
sing-box 文档的 V2Ray 传输只列了 HTTP、WebSocket、QUIC、gRPC、HTTPUpgrade 五种,没有 XHTTP。XHTTP 出自 Xray 的传输方式。订阅里有 XHTTP 节点时该怎么处理,这里讲清楚。
本文目录(6 节 · 约 2 分钟) +
- 01 sing-box 能用的传输有哪些
- 02 XHTTP 是哪来的
- 03 订阅里有 XHTTP 节点怎么办
- 04 自建节点怎么换成 sing-box 能用的传输
- 05 怎么确认节点用的是什么传输
- 06 常见问题
不支持。截至 2026-11-01,sing-box 文档里的 V2Ray 传输只有 HTTP、WebSocket、QUIC、gRPC、HTTPUpgrade 五种,没有 XHTTP。XHTTP 是 Xray 文档里列出的传输方式,用 sing-box 内核的客户端导入这类节点,是连不上的。
sing-box 能用的传输有哪些
sing-box 把这一组传输叫 V2Ray Transport,配置时写在出站的 transport 里,VLESS 等出站都引用这一套。文档列出的取值如下:
| 传输 | type 写法 | 文档里的要点 |
|---|---|---|
| HTTP | http | 不强制 TLS,没配 TLS 时用明文 HTTP 1.1 |
| WebSocket | ws | 要和 Xray-core 兼容时,early_data_header_name 设成 Sec-WebSocket-Protocol |
| QUIC | quic | 不支持额外加密 |
| gRPC | grpc | 标准 gRPC 兼容性好但性能差,默认不编进去 |
| HTTPUpgrade | httpupgrade | 有 host、path、headers 三项 |
文档还单独列了和 v2ray-core 的差别:没有 TCP 传输(纯 HTTP 并进了 HTTP 传输),没有 mKCP,也没有 DomainSocket。
文档开头还有一句评价,说 V2Ray 传输是 v2ray 发明的私有协议,并且把别的协议的名字也搞乱了,举的例子是 Clash 里的 trojan-grpc。
XHTTP 是哪来的
在 Xray 的文档里,XHTTP 和 RAW、mKCP、gRPC、WebSocket、HTTPUpgrade 等并列,是传输方式里的一项,并且有自己单独的一组设置。也就是说,XHTTP 是 Xray 这一侧的东西。
两边名字相近的只有 gRPC、WebSocket、HTTPUpgrade 这几种。服务端如果配的是 XHTTP,sing-box 这边没有对应的 type 可以填。
sing-box 以后会不会加上,官方没有说明。
订阅里有 XHTTP 节点怎么办
用 sing-box 内核的客户端导入订阅时,碰到 XHTTP 节点,sing-box 没有对应的传输可用,这几个节点是用不了的。可以按这个顺序处理:
- 先看订阅里是不是还有别的传输方式的节点,比如 WebSocket、gRPC,换着用。
- 问服务商有没有给 sing-box 用户单独准备的订阅格式。
- 确实只能用 XHTTP,就换一个内核是 Xray 的客户端来连这类节点。
如果不是只有 XHTTP 节点连不上,而是所有节点都超时,那就不是传输方式的问题了,按 所有节点超时的排查顺序 去查。
自建节点怎么换成 sing-box 能用的传输
如果服务端是你自己搭的,可以把 XHTTP 换成两边都有的传输,比如 WebSocket、gRPC 或 HTTPUpgrade。换的时候有几处要对齐:
- 路径:文档提醒,V2Ray 文档要求服务端和客户端的 path 一致,但实际代码允许客户端在 path 后面加后缀,sing-box 的 HTTP 传输沿用了这个行为;WebSocket 和 HTTPUpgrade 没有这个行为,path 必须写得一模一样。
- host:HTTPUpgrade 的 host 在服务端不为空时会被校验,两边要填同一个域名。
- WebSocket 的早期数据:要和 Xray-core 服务端兼容,客户端把
early_data_header_name设成Sec-WebSocket-Protocol,并且和服务端保持一致。 - gRPC:sing-box 默认用的不是标准 gRPC 实现,文档说标准 gRPC 兼容性好但性能差,没有默认编进去。
改完两边一起重启,再用客户端测一次延迟。用机场订阅的读者不用碰这些,服务端配置由服务商决定。
怎么确认节点用的是什么传输
- 分享链接:VLESS、VMess 链接里的
type=参数写的就是传输方式,比如type=ws、type=grpc。 - 客户端节点详情:看「传输」「network」一类的字段。
选订阅之前,也可以先看看 适合 sing-box 的机场推荐,避免买到大部分节点都用不了的套餐。用 Windows 的读者,还可以看看 v2rayN 用户怎么挑订阅。
常见问题
sing-box 新版本加了 XHTTP 吗
没有。截至 2026-11-01,最新正式版是 v1.14.4,预发布到了 1.15.0-alpha。文档站当前内容已经包含 1.15.0 的新字段,传输列表里仍然没有 XHTTP。
HTTPUpgrade 和 XHTTP 是一回事吗
不是。HTTPUpgrade 在 sing-box 和 Xray 的传输列表里都有,是各自列出的一项;XHTTP 只出现在 Xray 的列表里。两者名字相近,配置时不能互相替代。
为什么同一份订阅在别的客户端能用
不同客户端用的内核不同。内核是 Xray 的客户端能识别 XHTTP,sing-box 内核的客户端识别不了,于是同一份订阅在两边表现不一样。
相关文章
sing-box 苹果越狱版有什么额外功能
sing-box 的 iOS 客户端除了 App Store 版,还有一个给越狱设备用的版本。官方写明它多出两项能力:在设备上运行 Tailscale SSH 服务,以及在路由和 DNS 规则里按进程匹配。这篇讲清这两项是什么、安装包怎么区分、和常规版怎么选。
sing-box 路由动作 route、reject、hijack-dns 分别做什么
sing-box 1.11 起路由规则改用 action 字段。route 把连接送到指定出站,reject 拒绝连接,hijack-dns 把 DNS 请求交给内置 DNS 模块。讲清三者区别、旧 block 和 dns 出站怎么改写。
sing-box TLS fragment 和 record_fragment 有什么区别
sing-box 1.12.0 在 TLS 里加了 fragment 和 record_fragment 两个选项。fragment 把握手分段发送、性能较差,record_fragment 把握手拆成多条 TLS 记录。文档建议先试后者,只对确实被拦的域名开。