针对 CVE-2026-123007(2026 年 nginx HTTP/2 流控 RCE)的安全远程扫描器。 它还会根据版本和配置标记出 CVE-2026-123633(HTTP/2 释放后使用 RCE),但不会主动探测该漏洞(参见主动探测的是哪个 CVE)。
主动行为测试针对的是 CVE-2026-123007。只需一条命令,即可判断某个端点是否运行着存在漏洞的代码,即使版本横幅撒谎(发行版向后移植会保留旧版本字符串)或已被隐藏。该测试不会使服务器崩溃,也不会利用服务器。它以有界的方式复现漏洞的记账前置条件,而不涉及任何内存不安全操作(详见下文)。
运行前须知: 它是单个文件,请先阅读。只探测你有权测试的主机。主动测试在设计上是安全的(参见为什么可以在生产环境上安全运行),但它确实会发送几 MB 精心构造的 HTTP/2 流量。
$ nginx-h2-probe check www.example.com
[*] www.example.com: active test selected -- this sends a few MB of safe,
non-exploiting test traffic and takes 1-8 minutes.
[.] active attempt 4/14: prefill 128000 pings
[.] active attempt 7/14: prefill 152000 pings
[.] attempt 152000 pings: over-maximum window state reproduced
target: www.example.com:443
ALPN h2 negotiated : True
Server banner : nginx/1.31.8
CVE-2026-123007 behavior : VULNERABLE (flow-control validation matches unfixed
1.9.5-1.31.8 code)
send_window exceeded 2^31-1: YES -- CVE precondition reproduced (bounded, safe)
RESULT: VULNERABLE to CVE-2026-123007 on this endpoint. (exit code 1)
纯 Python 3.8+,零第三方依赖。整个工具就是单个文件 nginx-h2-probe.py,因此无需安装任何东西。
# clone and run (simplest):
git clone https://github.com/MazeResearch/nginx-h2-probe
python3 nginx-h2-probe/nginx-h2-probe.py check www.example.com
# or download just the one file and run it anywhere:
curl -fsSL -O https://raw.githubusercontent.com/MazeResearch/nginx-h2-probe/main/nginx-h2-probe.py
python3 nginx-h2-probe.py check www.example.com
两个可选的附加组件。在克隆的仓库中执行 pip install . 会将 nginx-h2-probe 命令安装到你的 PATH 中(下面的示例使用该简写形式;python3 nginx-h2-probe.py 的效果完全相同)。当你需要从能够访问源站的宿主机上运行时,Docker 会很方便:
docker build -t nginx-h2-probe .
docker run --rm --network host nginx-h2-probe check www.example.com
仅被动式分诊(即时、零主动流量):添加 --passive。用于 CI 的 JSON 输出:添加 --json。
将编码代理指向此仓库,让它运行检查。它会读取 AGENTS.md,该文件要求它默认保持只读,在发送任何流量之前向你发出警告,并且只探测你已声明获准测试的主机。
复制粘贴提示词:
克隆 https://github.com/MazeResearch/nginx-h2-probe 并阅读其 AGENTS.md。检查
HOST是否易受 2026 nginx HTTP/2 RCE(CVE-2026-123007)影响。以被动和只读方式开始,并在发送任何主动流量或探测任何你不确定我是否有权测试的目标之前警告我。
local 子命令时)反向代理配置进行报告。如果某主机易受 123007 影响且进行反向代理(proxy_pass 等),则应将 123633 也视为已暴露。两者均在 nginx 1.30.7(稳定版)和 1.31.9(主线版)中修复。
CVE-2026-123007 中的内存损坏只有在连接流控窗口被驱动到接近 2^63 的值时才可达。此探测将窗口驱动到约 2^31(RFC 9113 最大值)加少量超出,远低于该范围,并且仅使用普通 HTTP/2 帧(GET、PING、WINDOW_UPDATE、RST_STREAM)。它针对的是记账前置条件,而非损坏本身。在已修补的服务器上,效果应为普通的 FLOW_CONTROL_ERROR 处理,与任何不符合规范的客户端相同。
这仍然是对他人服务器的实时流量:每次运行几 MB,耗时 2-8 分钟(最坏约 15 分钟,最多 14 次校准尝试),并会产生一些良性日志噪声("http2 flood detected"、"client violated connection flow control")。请先阅读代码,尽可能在实验室中测试,并且仅对你有权测试的主机运行。
| 判定 | 含义 | 退出码 |
|---|---|---|
VULNERABLE | 流控验证与未修复的 1.9.5-1.31.8 代码匹配;已复现受限的超最大值前置条件 | 1 |
not-vulnerable/not-exposed | 验证与已修复代码匹配 | 0 |
not-exposed (HTTP/2 not enabled) | 所测试的名称未协商 HTTP/2,因此此处无法触达这些 CVE | 0 |
INCONCLUSIVE | 无法获得决定性答案(注释说明需要更改什么) | 2 |
assessment-only | 被动模式:仅横幅/ALPN/版本范围 | 0 |
上述判定针对 CVE-2026-123007。CVE-2026-123633 仅作为版本/配置评估报告(参见哪些 CVE 会被主动探测);在 nginx 主机上运行的 local 子命令会直接检查代理配置。
nginx-h2-probe check HOST [options] # remote check (default command)
--port 443 --sni SNI --path /x --passive --json --insecure
--flood-multiplier 2 # retry hint for INCONCLUSIVE results
nginx-h2-probe local # on-the-nginx-host checks
nginx-h2-probe serve [--token S] # HTTP wrapper (curl-friendly)
直接指定目标也可以:nginx-h2-probe example.com。该包也可以作为模块运行:python -m nginx_h2_probe check example.com。
from nginx_h2_probe import check
result = check("origin.example.com", active=True)
result["verdict"] # "VULNERABLE" | "not-vulnerable/not-exposed" | "inconclusive"
result["over_max_confirmed"] # was the CVE-2026-123007 precondition reproduced?
nginx-h2-probe serve --listen 127.0.0.1 --port 8080 --token SECRET
curl 'http://scanner:8080/probe?token=SECRET&target=origin.example.com&active=1'
# -> {"verdict": "VULNERABLE", "over_max_confirmed": true, ...}
探测一次运行一个。使用 --token 保护该服务,并且只将其指向你获授权测试的目标。
docker run --network host 可避免此问题。--sni。--path 或 local。server_tokens off);主动测试才是解决该问题的手段。local 会拒绝对其给出版本判定(退出码 2),并指向 F5 的公告;远程主动检查仍然有效。官方修复(1.30.7/1.31.9)将 nginx 的连接 WINDOW_UPDATE 检查从 MAX - send_window 改为 MAX - send_window - send_queued,因此修复后的代码在执行 2^31−1 最大值限制时会计入已排队但未发送的 DATA。该探测构造一种状态,使存在漏洞的代码与修复后的代码必须对一次合法更新产生分歧:缓冲区预填 PING ACK,一个小型内存响应已排队但未写出,连接窗口恰好为 2^31−1。然后发送一个 3/2×B 的 WINDOW_UPDATE(存在漏洞的代码接受,修复后的代码拒绝)、一个 RST_STREAM(信用返还仅在未修复代码上越过 2^31−1,即该 CVE 的前提条件,且有界),以及一个 2×B 的最终更新(仅通过下溢检查被接受)。标记 PING 用于分类任何拒绝来自哪一步,自动校准的洪泛会根据目标调整缓冲区填充。完整细节见 src/nginx_h2_probe/core.py,该文件注释详尽,其 docstring 包含完整的安全分析。
为什么不用 curl/requests/httpx?没有任何 HTTP 客户端库能够发出此探测所需的定制 WINDOW_UPDATE 增量、突发节奏的 PING 和定时 RST_STREAM。该探测是一种协议一致性检测工具(类似 TLS 扫描器),而不是 API 客户端,并且按设计仅使用标准库。
python -m unittest discover -s tests -v # unit tests
python scripts/build_standalone.py # regenerate the single-file build
docker build -t nginx-h2-probe . # build the image
欢迎贡献。安全不变量记录在 CONTRIBUTING.md 中。
MIT,按原样提供,不附带任何担保。参见 LICENSE。