针对 nginx 1.31.8 中连接级 HTTP/2 发送窗口泄漏的概念验证:流清理时只归还仍未被阻塞的 DATA 帧,因此在套接字阻塞之前计入连接窗口的字节永远不会被归还。连接会永久损失可用窗口,之后一个完全合法的 WINDOW_UPDATE 会被以 FLOW_CTRL_ERROR 拒绝。
该 PoC 是一个运行在 127.0.0.1 上的自包含 Docker 实验环境——无需外部主机,除 Docker 和 Python 3 外无构建依赖(h2 已内置)。
使用固定到存在漏洞版本的官方镜像。 该缺陷位于二进制文件中,因此无需构建任何内容——只需将实验配置和资源以只读方式挂载到原版 nginx:1.31.8-alpine 之上:
docker run -d --name defex-ngnix -p 127.0.0.1:18443:18443 \
-v "$PWD/conf/nginx.conf:/etc/nginx/nginx.conf:ro" \
-v "$PWD/conf/cert.pem:/opt/lab/cert.pem:ro" \
-v "$PWD/conf/key.pem:/opt/lab/key.pem:ro" \
-v "$PWD/conf/big.bin:/opt/lab/html/big.bin:ro" \
-v "$PWD/conf/index.html:/opt/lab/html/index.html:ro" \
-v "$PWD/data:/opt/lab/data" \
nginx:1.31.8-alpine
./defex_ngnix.sh # prove it against the running container
./defex_ngnix.sh 8443 # same on another host port
固定该标签。nginx:alpine 是浮动标签,且已更新到 1.31.9,该版本已修复——此时运行会在第 5 阶段失败。如果你更倾向于使用 docker build / docker run,随附的 Dockerfile 会以一次性构建的方式完成相同的挂载。
该脚本不会调用任何 docker 命令。 你启动容器,脚本只通过 HTTP 与容器通信。全部 8 个阶段都必须通过。若失败,容器会保持原样以便检查。最后一个阶段是对照组:在启用和不启用重置的情况下施加相同负载,证明泄漏出在清理路径中,而非负载本身。
poc/_vendor 目录树(无需 pip install)已于 2026-11-19 针对 nginx:alpine = 1.31.8 验证。每次运行针对全新启动的容器均以 11 个 [PASS] 和 0 个 [FAIL] 结束。更新或已修复的构建预计会在第 5 和/或第 6 阶段失败——这正是信号。
仅测试了上述实验环境。其他部署、较旧分支以及位于 nginx 之前的反向代理均未测试。
当 DATA 帧被排队时,ngx_http_v2_filter_module.c 会从连接窗口中减去每个 DATA 帧的负载:
ngx_http_v2_queue_frame(h2c, frame);
h2c->send_window -= frame_size; /* charged on queueing */
stream->send_window -= frame_size;
ngx_http_v2_filter_cleanup() 本应在流终止时归还该 payload,但它遍历输出队列时使用了
if (frame->stream == stream && !frame->blocked) {
*fn = frame->next;
window += frame->length;
因此,那些已经计入并随后在套接字上被阻塞的帧会被跳过。它们的字节数会永远从 h2c->send_window 中扣除。该字段是一个普通的 size_t,所以这种损害只会表现为连接窗口再也无法达到 MAX。只有每流窗口是有符号的(ssize_t),因为 SETTINGS_INITIAL_WINDOW_SIZE 的变更可能会使该窗口变为负值。
连接级别的 WINDOW_UPDATE 路径只将新的增量与 NGX_HTTP_V2_MAX_WINDOW - h2c->send_window 进行比较:
if (window > NGX_HTTP_V2_MAX_WINDOW - h2c->send_window) {
... "client violated connection flow control" ...
return ngx_http_v2_connection_error(h2c, NGX_HTTP_V2_FLOW_CTRL_ERROR);
}
h2c->send_window += window;
因此,发生漂移的窗口会使 MAX - h2c->send_window 比应有的值更大,于是服务器会接受正确构建本应拒绝的增量。窗口本身永远不会超过 2^31-1(这正是该检查所强制保证的),这意味着连接会永久损失可用的窗口:对端持续被拒绝其应得的字节。
阶段 5 — 溢出。 客户端通告 INITIAL_WINDOW_SIZE = 2^31-1,在 1 KiB 的套接字缓冲区之后打开 1000 个流,使 HEADERS 帧无法发出,然后排空,再发送两个满尺寸的增量。第二个增量之所以合法,仅仅是因为这种漂移:
[PASS] server rejected the WINDOW_UPDATE (1 log line(s))
increment 2147418112 not allowed for window 2081882111
阶段 6 — 清理后泄漏。 400 个流,之后除最后一个外全部 RST。 被阻止的 DATA 帧的字节不会被返回,因此窗口始终 达不到 MAX,最后的增量被拒绝:
[PASS] window leaked after stream reset - increment rejected
increment 2147418112 not allowed for window 2147401727
2147483647 - 2147401727 = 81920 —— 恰好是五个 16 KiB 的 DATA 帧,其
载荷在 399 个流被清理后仍从窗口中缺失。
服务器保持健康,之后仍能协商 HTTP/2。
阶段 7 —— 对照组。 同样的 400 流负载运行两次,一次带重置, 一次不带。两次运行都会泄漏,但带重置的那次结束时更高: 清理确实归还了一些东西,只是跳过了被阻塞的帧。
with resets -> window 1921441791
without resets -> window 1898053631
[PASS] cleanup gives back only unblocked frames - window stays short
因此,阶段 6 并不只是“发生了一些负载”:在两组中,窗口都远低于 MAX,而且顺序与源码中的 !frame->blocked 过滤条件一致。如果你想观察窗口在持续扰动下如何下沉,poc/window_growth.py 会重复该循环若干次。
| 路径 | 作用 |
|---|---|
defex_ngnix.sh | 8 阶段纯 HTTP 驱动脚本,带颜色输出 |
Dockerfile | nginx:alpine(1.31.8)+ 实验配置与资源 |
conf/nginx.conf | TLS + http2 on,4 KiB 输出缓冲区,info 级别日志写入 lab.log,日志通过 /__lab.log 暴露 |
conf/big.bin | 4 MiB 载荷 |
poc/flow_control.py | 阶段 5,窗口溢出 |
poc/blocked_frames.py | 阶段 6,流清理后的泄漏 |
poc/leak_control.py | 阶段 7,带/不带重置的对照 |
poc/window_growth.py | 可选,重复扰动循环 |
poc/_vendor | h2 / hpack / hyperframe,无需 pip |
data/ | 宿主机目录,启动容器时将其绑定挂载到 /opt/lab/data |
你在 shell 中写入的任何内容都会进入 /opt/lab/data,该目录从 data/ 绑定挂载而来。容器由你自行重建,因此该目录是重启后唯一能保留工作成果的地方。
error_log 指向真实文件,而不是 /dev/stderr:符号链接的日志无法被截断,tail/grep 会永远阻塞在管道上。它通过 /__lab.log 发布,因此脚本无需 docker exec 即可读取;每个阶段都会记住字节偏移量,只查看该点之后产生的行。
--with-debug,因此 send GOAWAY 永远不会写入日志;info 级别的流控违规才是可用的信号。GOAWAY 本身排在阻塞的套接字之后,通常不会到达。worker_connections 4096 和 http2_max_concurrent_streams 5000 使 1000 个流舒适地低于这两个限制。docker rm -f defex-ngnix 进行拆除。