Broccoli2Shell:Node.js、Python 等主流环境中的 Brotli 解码器远程代码执行漏洞
如果你的代码(或它依赖的任何库)会解压他人可控的 Brotli 数据,你就处于风险之中。这种情况比你想象的更常见,因为 HTTP 客户端会自行解压 Brotli 响应。
- 你的应用会抓取 URL
Node 内置的
fetch()会自动解码Content-Encoding: br的响应。Python 的requests/urllib3和aiohttp在安装了 Brotli 包时也是如此。无论是通过 webhook、链接预览、爬虫还是"从 URL 导入"功能,任何与你通信的服务器都可以发送攻击载荷。 - 你的应用接受上传或请求体
Express 5.0.0–5.3.0 和 body-parser 2.0.0–2.3.0 会在
raw()、json()等解析器中解压 Brotli 请求体。解码br请求体的 Python 框架和中间件也以同样方式暴露风险。裸的node:http服务器则不会自行解码请求体。 - 你的应用直接调用解码器
包括
zlib.brotliDecompress*()、createBrotliDecompress()、brotli.decompress(),以及在处理压缩包、缓存或队列消息时用到它们的任何库。
Express 和 body-parser 本身并不包含这个漏洞,它们只是触发漏洞的途径,升级它们没有用。Node.js 自带了一份 Brotli 副本,因此系统的 libbrotli 无关紧要,起决定作用的只有 Node.js 的版本。
漏洞细节
Brotli 流被划分为多个块,解码器在读取时会在不同块类型之间切换。修复之前,c/dec/decode.c 中的 DecodeBlockTypeAndLength() 只返回一个简单的布尔值,调用方因此无法区分"流格式损坏"和"还需要更多输入"。而在快速路径上,解码器甚至完全忽略了返回值。
一个精心构造的流可以请求一次不可能发生的块切换。解码器把它理解为"需要更多输入",于是持续把攻击者的字节追加到一个八字节的内部缓冲区中,造成越界写入。这次覆写会破坏附近的解码器状态,从而让一个损坏的流演变成内存泄露甚至代码执行。
上游修复见 google/brotli 仓库的提交 0ed4268,以及 50a9b70、b418fa8 和 da98063。该修复会让解码器向调用方返回硬格式错误 BROTLI_DECODER_ERROR_FORMAT_BLOCK_SWITCH(错误码 −17)。该漏洞对应 CWE-252(未检查返回值)和 CWE-787(越界写入)。
Python
PyPI 上的 Brotli 和 brotlicffi 包编译的是同一个 C 解码器。即使你的代码没有显式导入它们,只要环境中安装了其中之一,相关客户端就会自动使用它:
- urllib3(以及依赖它的 requests)会发送
Accept-Encoding: br头部并解码 Brotli 响应。 - aiohttp 在安装了 Brotli 时会启用它。
- httpx 通过
httpx[brotli]扩展包使用该功能。 - Scrapy 及其他爬虫工具。某些版本会将 Brotli 作为依赖自动安装。
不要只依赖漏洞扫描器。在披露初期,pip-audit、Dependabot 和 Safety 并未稳定地标记出受影响的 PyPI 版本。CVE 记录中只提及了上游 Google 仓库,未包含 PyPI 包。虽然 GitHub 的安全公告现已同时列出这两个包(PYSEC-2026-4322 和 PYSEC-2026-4323),但仍建议手动核查。
如果你的绑定来自 Linux 发行版(例如 python3-brotli)而非 PyPI,那么修复将通过发行版的安全更新提供。
其他软件
漏洞位于 Google 的参考 C 解码器中,而非 Node.js 或 Python 本身。任何捆绑或链接 Brotli 1.0.3 至 1.2.0 的软件均可能受影响,即便尚未有公告点名。
- 系统库。即
libbrotlidec,通常以libbrotli1、brotli等名称打包。动态链接该库的程序,在发行版发布修复包并重启程序后即可修复;静态链接或内置(vendored)的副本则需要重新构建。 - 封装 C 代码的绑定层。包括 Java JNI 封装、PHP 和 Ruby 扩展,以及 Go cgo 绑定。请查找捆绑了 1.0.10、1.1.1 或 1.2.1 版本的发布。
- 使用 C 库解码
br内容的代理、CDN、HTTP 客户端及归档工具。
其他语言重写的解码器不受影响。pdf.js、iText 和 HtmlUnit 所使用的 Java、JavaScript 和 C# 移植版都无法触发此漏洞。Go 移植版(andybalholm/brotli)存在相同的逻辑错误,但该错误只会导致崩溃,且已于 10 月 23 日修复。Rust 的 brotli-decompressor 库能够捕获该状况并返回错误。只有 C 语言解码器存在代码执行的风险。
自带独立副本的项目
许多项目随附了 C 解码器的私有副本,而非使用系统库。分发更新无法修复这些问题:每个项目都必须更新其自带的副本。我们在 GitHub 上搜索了这些 vendored 副本,阅读了它们的头部信息,并于 2026 年 10 月 25 日进行了最后一次复核。如果副本中包含了新的 BLOCK_SWITCH 错误代码,则视为已修补。
| 项目 | 自带副本 | 解码的不可信输入 |
|---|---|---|
| .NET runtime | 1.1.0 | BrotliDecoder、BrotliStream、HttpClient 的自动解压,以及使用 请求解压中间件 的 ASP.NET Core 应用中的请求体。微软已确认正在 issue #136422 中处理响应。 |
| DuckDB | 未修补 | Brotli 压缩的 Parquet 文件。修复正在进行中,见 PR #27791。 |
| Apache Arrow(捆绑构建) | 1.0.9 | Brotli 压缩的 Parquet 文件。问题追踪于 issue #55166。PR #55167(迁移到 Brotli 1.0.10)已获批准但尚未合并。 |
| v8-jsi | 1.2.0 | 与 Node.js 相同的路径,因为它捆绑了 Node.js |
| 7-Zip-zstd | 1.2.0 | 用户打开的归档文件和 .br 文件。问题追踪于 issue #579。 |
| p7zip | 1.0.9 | 用户打开的压缩包和 .br 文件 |
| EDK II | 1.2.0 | 压缩的固件段。进展见 issue #13378。 |
| woff2(Makefile 构建) | 1.0.3 | 传给 woff2_decompress 的 WOFF2 字体。CMake 构建则链接系统库,不受影响。进展见 issue #207,修复方案已在 PR #208 中提出。 |
| 项目 | 修复版本 | 详情 |
|---|---|---|
Ruby brotli gem | 0.9.1 | 捆绑 Brotli 1.2.1,且拒绝在未打补丁的系统 libbrotli 上构建。已于 10 月 24 日发布(issue #64)。 |
| PHP brotli 扩展 | 0.21.1 | 捆绑 Brotli 1.2.1,已于 10 月 24 日发布(PR #105)。 |
| UEFITool | A76 | 捆绑 Brotli 1.2.1,已于 10 月 24 日发布(issue #492)。 |
| MuPDF | 1.28.0 | 其 Brotli 分支早在披露前(2026 年 4 月)就合入了上游修复,因此所有 1.28.x 版本均已修复。1.27.x 版本仍捆绑受影响的解码器。 |
| ClickHouse | master 分支 | 10 月 25 日在 PR #127419 中升级到 Brotli 1.2.1,并回移到 26.10。26.9、26.8 和 26.3 LTS 的回移仍在进行中。尚未包含在任何发布版本中:最新版 26.10.2.103 发布于修复之前。 |
| NanaZip | main 分支 | 已于 10 月 24 日更新至 Brotli 1.2.1(3da1c6a)。尚未发布正式版本:最新的 7.0.1873.0 发布于修复之前。 |
| GraalJS (graal-nodejs) | master 分支 | 修复已于 10 月 22 日合并。尚未发布正式版本:GraalVM 每季度发布安全更新,而最新的 25.4.4.1.1 发布于修复之前。 |
| YDB | main 分支 | 已于 10 月 23 日通过上游修复补丁(343f6be)完成更新。尚未发布正式版本。 |
| libjxl | main 分支 | 已于 10 月 24 日通过 PR #5062 更新至 Brotli 1.2.1。尚未发布正式版本:最新的 v0.12.0 发布于修复之前。 |
在制作此列表之前已修复的项目: Node.js、Bun、Chromium、Firefox、brotlicffi、ngx_brotli、Brotli4j、SumatraPDF、Ghostscript、CatBoost 以及 YTsaurus,还有 Gentoo、Solus 和 VMware Photon 软件包。
此列表并不完整。GitHub 的代码搜索会跳过子模块和某些非常庞大的仓库,私有仓库或在构建时通过 vendor 方式引入的副本完全不会显示。此处列出的项目未必在所有配置下都会调用该解码器。如果您维护上述项目之一,请更新至 1.0.10、1.1.1 或 1.2.1(或直接摘取提交 0ed4268)即可修复。
检查您的版本
Node.js
node --version
# 若版本低于 22.23.4、24.22.1 或 26.12.1,或处于已结束生命周期(EOL)的版本线,则受影响
# 查看此 Node 二进制文件内置的 Brotli 版本
node -p "process.versions.brotli"
# 在容器镜像内检查
docker run --rm --entrypoint node <image> --version
Python
pip show Brotli brotlicffi
# 查看哪些包依赖它
pipdeptree -r -p Brotli
# 检查 lock 文件
grep -i brotli poetry.lock uv.lock requirements*.txt Pipfile.lock 2>/dev/null
# 在容器镜像内检查
docker run --rm --entrypoint pip <image> show Brotli brotlicffi
系统库
dpkg -l | grep -i brotli # Debian, Ubuntu
rpm -qa | grep -i brotli # RHEL, Fedora
apk info -v | grep -i brotli # Alpine
# 查找加载了该解码器的运行中进程
sudo grep -l brotlidec /proc/*/maps 2>/dev/null
代码运行在哪里,就检查哪里:生产环境、预发布环境、CI 流水线、构建镜像、Serverless 运行时以及开发人员的笔记本电脑。优先修补那些会抓取非你控制 URL,或接受 Content-Encoding: br 请求体的服务。
修复方法
升级
# Node.js:通过你的版本管理器、基础镜像或包源进行升级
nvm install 24.22.1 # 或 22.23.4 / 26.12.1
FROM node:24.22.1-slim # Dockerfile
# Python
pip install -U "Brotli>=1.2.1" "brotlicffi>=1.2.1.0"
# 然后提高版本约束,并重新生成 poetry.lock / uv.lock / requirements.txt
之后,重启所有进程,重新构建所有镜像并重新部署。务必更新锁文件中的版本锁定,否则下次构建时会重新安装存在漏洞的版本。
暂时无法升级
- Python:卸载
Brotli和brotlicffi。urllib3、requests 和 aiohttp 将回退到使用 gzip 和 deflate。同时移除httpx[brotli]等扩展依赖,否则下次安装时这些包会重新被引入。 - 入站流量:在代理、负载均衡器或 WAF 层拒绝携带
Content-Encoding: br的请求体。多家提供商(包括 Vercel)已在披露日发布当天部署了相应的 WAF 规则。 - 出站流量:从
Accept-Encoding中移除br的效果不如预期,因为恶意服务器仍可强行发送 Brotli 数据。WAF 无法看到你的应用获取的响应。只有升级运行时或库才能彻底覆盖这一路径。
Node.js 官方未发布任何缓解方案。对于 Node.js,升级运行时是唯一完整的修复方式。
利用现状
- Imperva Red Team 在官方未修改的 Node.js 24.22.0 Linux arm64 镜像上执行了攻击者提供的代码。他们通过抓取响应和 Express 请求体两种途径投递了载荷。经过多次尝试才成功,且他们尚未公开该漏洞利用代码。
- 公开的概念验证(PoC)已于 2026-10-22 出现在 GitHub 上。据报道,它仅在故意弱化的构建中才能达到代码执行。在标准构建中,它仅导致崩溃和有限的内存读取。
时间线
- 2026 年 2 月根据 OpenSourceMalware 的分析,修复代码首次进入 Brotli 源码。
- 2026 年 10 月 21 日Node.js 发布 22.23.4、24.22.1 和 26.12.1;Google 发布 Brotli 1.0.10、1.1.1 和 1.2.1。
- 2026 年 10 月 22 日NVD 发布 CVE-2026-111497,GitHub 发布 GHSA-9v8h-qqgm-4m35。Brotli 1.2.1 上架 PyPI,Imperva 发布研究文章,公开 PoC 出现。
- 2026 年 10 月 23 日brotlicffi 1.2.1.0 上架 PyPI。研究人员发布针对 Python 的分析,GitHub 将相关 PyPI 包加入安全通告。