针对 CVE-2026-58045 — Node.js:zlib 同步 API 伪造 TypedArray 崩溃 的离线版本证据检查器。
它将你报告的 Node.js 运行时版本与 Node.js 安全公告中列出的修复版本进行比较,并将结果写入 CSV、JSON 或自包含的 HTML 报告。要求 Python 3.10+,仅使用标准库;可执行文件为单个文件,可单独复制。
本仓库仅涵盖 CVE-2026-58045。该检查器提供的是分诊证据,而非运行时评估。
unknown。exploitability: not_tested。node --version 的输出,接受带前导 v 的形式)。CI 在 Ubuntu 和 Windows 上,于 Python 3.10 和 3.14 上运行测试套件和 --help。
# Assess one reported version and print JSON to stdout
python node_cve_2026_58045_check.py --version 22.23.2 --format json
# Assess the synthetic example inventory and save an HTML report
python node_cve_2026_58045_check.py --inventory examples/inventory.example.json --format html --output report.html
# Assess your own CSV list (CSV to stdout by default); exit 1 on a finding
python node_cve_2026_58045_check.py --csv-list inventory.csv --fail-on-finding
# Show all options, then run the local tests
python node_cve_2026_58045_check.py --help
python -m unittest -v
打开合成示例报告。仅为示例数据;这不是实时评估。
至少提供 --version、--inventory 或 --csv-list 中的一项;否则检查器会报告用法错误。这三个来源可以在一次运行中组合使用,每个输入都会成为一行结果。JSON、CSV 和 HTML 均基于同一份证据渲染。
| 选项 | 描述 |
|---|---|
--version VERSION(别名 --node-version) | 评估显式提供的 Node.js 版本。可重复使用;每个值描述一个独立的运行时。接受前导 v。 |
--build-source SOURCE | --version 构建的来源,最多 512 个字符。unknown(默认值)、upstream、official 或 official_upstream 会按上游进行比较;任何其他值(例如供应商名称)会产生 unknown 并附带 vendor_build_unverified。 |
--zlib-synchronous-api {true,false} | 操作员报告的观察结果,应用于 --version 输入。 |
--attacker-controlled-typedarray-object {true,false} | 操作员报告的观察结果,应用于 --version 输入。 |
--inventory FILE | JSON 对象或条目数组。可重复使用。 |
--csv-list FILE | 包含 node_version 列的 CSV。可重复使用。 |
--format {csv,json,html} | 报告格式。默认:csv。 |
--output FILE | 将报告保存到新文件。默认:stdout。 |
--force | 替换已存在的输出文件。未指定时,绝不覆盖已存在的文件。 |
--brand NAME | HTML 报告中显示的组织名称,最多 512 个字符。默认:CompleteTech LLC。 |
--fail-on-finding | 当任何结果为 potentially_affected 或 unsupported_runtime 时以退出码 1 退出。参见退出码。 |
--tool-version | 打印工具名称和版本。 |
输出保护:
--output 必须指定现有目录中的文件。除非显式指定 --force,否则已存在的报告会受到保护,并且即使指定 --force 也不能覆盖输入文件。--force 时,检查器使用硬链接发布;如果文件系统无法做到这一点,则会报错失败而不是覆盖。--build-source 仅适用于 --version 输入;inventory 和 CSV 条目携带各自的值。Inventory 是可选的;--version 不需要它。Inventory 条目可以包含操作员报告的前置条件观察结果。这些永远不会改变版本结果或确立可达性。
| 观察键 | 含义 |
|---|---|
zlib_synchronous_api | 操作员报告:zlib 同步 API |
attacker_controlled_typedarray_object | 操作员报告:攻击者控制的 TypedArray 对象 |
每个观察结果为 true、false 或未报告,并在结果中显示为 reported_true、reported_false 或 not_reported。
--inventory)文件包含一个对象或一个由 1 到 10,000 个对象组成的数组。每条记录需要整数 schema_version: 1 和字符串 node_version。可选字段为 runtime(仅限 "node")、label、build_source 以及上述观察键,每个均为布尔值或 null。未知键、重复键、非有限数字和无效类型会被拒绝。examples/inventory.example.json 是一个合成示例:
[
{
"schema_version": 1,
"label": "example-service",
"runtime": "node",
"node_version": "22.23.2",
"build_source": "unknown",
"zlib_synchronous_api": null,
"attacker_controlled_typedarray_object": null
}
]
--csv-list)第一行必须是包含 node_version 的表头。可选列为 label、build_source、zlib_synchronous_api 和 attacker_controlled_typedarray_object;观测单元格的值必须恰好为 true、false 或留空。schema_version 和 runtime 不是 CSV 列。重复或未记录的列、字段数与表头不一致的行、未加引号单元格内的裸引号、闭合引号之后的文本、NUL 字符以及没有数据行的文件都会被拒绝。
node_version,label,build_source,zlib_synchronous_api
22.23.2,example-service,upstream,
当 label 缺失时(JSON 或 CSV),结果会被标记为 <不带扩展名的文件名>:<条目编号>,编号从 1 开始。
已于 2026-10-24 对照官方发布公告及关联的修复版本进行复核。
| Node.js 主版本 | 修复版本 |
|---|---|
| 22.x | 22.23.2 |
| 24.x | 24.18.1 |
| 26.x | 26.5.1 |
厂商在发布公告中未指明引入该问题的版本。对于每个列出的主版本,低于其修复版本的版本都需要进行修复。未列出的、自定义/回移植的以及预发布构建需要明确证据;不要将未知构建标记为安全。
上报版本按检查顺序分类如下:
| 上报证据 | status | version_status |
|---|---|---|
| 无版本,或仅含空白字符 | unknown | version_not_disclosed |
有效的 X.Y.Z 后跟后缀(预发布、nightly/rc、包后缀、自定义构建) | unknown | qualified_version_unverified |
其他任何非纯 X.Y.Z 发布版本 | unknown | unrecognized_or_partial_version |
| 纯版本,但来源为厂商、发行版、自定义或无法识别的构建 | unknown | vendor_build_unverified |
| 纯版本,属于已列出的主版本,且低于其修复版本 | potentially_affected | below_fixed_version |
| 纯版本,属于已列出的主版本,且等于或高于其修复版本 | fixed_version_reported | at_or_above_fixed_version |
| 未列出且已停止维护的主版本(0、4–21、23、25) | unsupported_runtime | unsupported_release_line |
| 其他任何未列出的主版本,包括未来主版本 | unknown | release_line_not_in_rules |
说明:
v。如果引擎针对同一运行时收到相互冲突的版本,结果同样保持为 unknown(conflicting_versions)。potentially_affected,因为尚未确定引入版本。已列出的修复版本及同一主版本上更晚的纯版本为 fixed_version_reported。unsupported_runtime,作为升级指引,而非声称该特定缺陷存在于每个历史构建中。停止维护状态来自 2026-10-24 复核的 Node.js 发布计划(见来源与出处);主版本 0 属于推断,因为该计划仅列出 0.8、0.10 和 0.12。unknown。上游版本无法显示厂商构建包含哪些补丁。status | 含义 |
|---|---|
potentially_affected | 上报版本低于其主版本的修复发布版本,需要进行修复审查。这并不代表已确认可利用性。 |
fixed_version_reported | 上报版本等于或高于修复发布版本。这并非已部署补丁的证明:请确认正在运行的进程或容器实际使用了该发布版本。 |
unsupported_runtime | 上报的主版本已停止维护。应将其视为升级指引,而非关于该特定缺陷的发现。 |
unknown | 证据缺失或无法分类。请收集确切的上游版本和构建来源,然后重新运行检查器。 |