XHTTP/3 跑到 100 个会话就卡住,packet-up 的上传全停了

本文依据 Xray-core GitHub issue #7397(2026 年 11 月 14 日提交,复现版本 v26.11.9,作者用官方二进制在本机回环复现)整理,作者注明 issue 由 Claude 协助整理,数据均来自文中描述的实测。h3 主实验本站没有在本地跑通——本站沙箱禁 UDP,连回环发包都会被拒绝;但 h2 对照组已在本地用同一套配置跑通(110 个会话全回),机制经代码核实。下面只写 issue 里有完整复现和对照的部分,以及本站实际验证过的部分。

先说结论:先看你的 XHTTP 是不是 h3 加 packet-up

如果你用的是 VLESS + XHTTP,ALPN 是 h3,mode 是 packet-up,那么一条 QUIC 连接默认只能开 100 条双向流。每个 XHTTP 会话终身占一条流,packet-up 每次上传还要再占一条,跑满 100 个会话后,整条连接上的会话都发不出上传——包括之前一直正常的那些。

临时绕过办法只改服务端:入站 streamSettings 里加 finalmask.quicParams.maxIncomingStreams,比如改成 4096。作者实测改完后 110 个会话全通。下面先讲现象和复现,再讲根因和怎么改。

现象长什么样

issue 作者的复现环境很干净:服务端和客户端都用官方 v26.11.9 的 Xray-linux-64 二进制,只监听回环地址。客户端是 dokodemo-door 入站(7002)接 VLESS + XHTTP/3 出站,服务端是 VLESS + XHTTP/3 入站(8443),出站是 freedom,目标是本机上的一个回显服务(9002)。为了把测试收小,客户端的 xmux.maxConnections 限成 1,也就是只用一条 QUIC 连接。然后用脚本逐个开 110 个连接,每个发 ping 并保持打开。

结果是:第 100 个会话直接没回复;再回去让第 1、2、50 个会话(之前都正常)重新发一次,同样没回复。也就是说不是“新会话进不来”,而是整条连接上的上传全停了。

复现对照:只有 packet-up 加 h3 会全停

下面是 issue 里的对照表,各组配置相同,只改 mode、ALPN 和服务端是否调大流上限:

组合 结果 结论
packet-up + h3 第 100 个会话没回复;第 1、2、50 个会话再发也没回复 整条连接的上传全停
stream-one + h3(只改 mode) 第 101 个会话没回复;第 1、2、50 个会话再发仍有回复 只挡新建会话,老会话不受影响
packet-up + h2(只改 ALPN) 110 个会话全有回复 h2 不受影响
packet-up + h3,服务端 maxIncomingStreams: 4096 110 个会话全有回复 调大上限可绕过

对照还排除了“单连接测试才触发”的疑问。把客户端改回默认 XMUX 设置(不写 xmux,即 3 条连接),在 main 分支上跑:只发一次请求就空闲的会话,三次运行分别在第 254、259、289 个会话首次失败,随后 99 个原本正常的会话无法上传。每个会话先发 12 个请求再空闲的,700 个会话内没触发——因为客户端在 600 到 900 个请求后会退役旧连接。也就是说日常用着也可能撞上,只是时间点不固定。

根因:流上限是 quic-go 的默认值 100,Xray 没改

issue 作者给出的分析是这样的(附了供维护者核对的代码路径与修复 diff,本文转述,不做独立判断):

  1. XHTTP/3 入站在建 QUIC 连接时,把 streamSettings 里的 quicParams.maxIncomingStreams 原样传给 quic-go(transport/internet/splithttp/hub.go 里 ListenXH 建 quic.Config 的地方)。本站核对过当前 main 的源码,确实是原样透传,没设置就是 0;
  2. quic-go 在这个值为 0 时用默认值:每条连接 100 条双向流;
  3. 每个 XHTTP 会话终身占一条流,packet-up 每次上传还要再占一条,100 占满后,整条连接上谁也发不出上传。

h2 不受影响的原因也写在 issue 里:HTTP/2 入站到流上限后,客户端会另开一条 TCP 连接;QUIC 只有一条连接,没地方可开。

作者附的修复建议是:值未设置时默认给一个很大的数(diff 里是 1 << 16),作者在 main 上改完后,400 个会话用默认客户端设置全程正常。截至发稿,这个 issue 还是 OPEN,没有维护者回复,也没有修复合入。

谁会中招

同时满足下面三条的,就在影响范围内:

  • 入站是 XHTTP,ALPN 只有 h3(即 XHTTP/3);
  • mode 是 packet-up(stream-one 只影响新建会话,stream-up 不在 issue 的复现范围内,别急着下结论);
  • 单条 QUIC 连接上同时保持的会话数多,比如多用户共享一条入站、或者长连接攒得多。

只看这份 issue,还不能确定更早的版本是否同样受影响——复现用的是 v26.11.9,别急着给旧版本下结论。

临时绕过办法:服务端调大 maxIncomingStreams

在服务端入站的 streamSettings 对象里面加一段,和 xhttpSettings、tlsSettings 平级,其他配置不用动:

1
2
3
4
5
"finalmask": {
"quicParams": {
"maxIncomingStreams": 4096
}
}

注意 quicParams 是放在 finalmask 下面,不是直接放在 streamSettings 下面,也不是放在 xhttpSettings 里面——写错位置等于没写。这个字段名本站已在源码里核对过(transport/internet/config.proto 里 QuicParams 的 max_incoming_streams 字段,infra/conf/transport_internet.go 里从 finalmask.quicParams 取值),也用官方 v26.11.9 二进制实机验证过:带这段配置启动,服务端能正常监听 QUIC。

作者在 issue 里明确划了范围:这只是针对当前复现的对照结论。调大上限是绕过,不是修复;等官方合入修复(或者新版本改了默认值)后就不用再写这一段。另外别因为这一个 issue 就切回 h2——h3 的其他优势还在,改一行配置就能绕过。XHTTP 的 mode 怎么选,见3x-ui配置XHTTP节点:搭配Reality怎么设置。

本站核实到哪一步

  • h2 对照组已在本地跑通:官方 v26.11.9 二进制,同一套配置只把 ALPN 从 h3 改成 h2,110 个会话全回,第 1、2、50 个会话再发仍回,和 issue 的对照表一致;
  • h3 主实验本地跑不了:本站沙箱禁 UDP,连发往回环的 UDP 包都会被拒绝(sendmsg: operation not permitted),QUIC 建连的第一步就走不通;
  • 机制经代码核实:hub.go 里建 quic.Config 时 MaxIncomingStreams 确实是原样透传;配置路径 finalmask.quicParams.maxIncomingStreams 已在源码里核对,并用实机启动验证过能正常监听。

怎么自查自己有没有中招

  • 多个会话同时发不出,但重启客户端就恢复,过一阵又出现;
  • 同样的配置换成 h2 就正常;
  • 服务端按上面那节调大 maxIncomingStreams 后恢复。

另外注意:这个 issue 讲的是服务端入站的流上限,不是客户端配置问题。客户端日志里只会看到 GET 请求失败,根因在服务端。

同一天的另一条 Xray UDP 问题

同一天 Xray-core 还冒出另一个 UDP 相关 issue #7396:dokodemo-door 加 tproxy 后 UDP 不出包,TCP 正常。作者当天自查后发现是自家防火墙的问题,已关闭 issue——那篇的来龙去脉见这里。两个 issue 都和 UDP 有关,但根因完全不同,别混成一件事。

来源: