针对 CVE-2026-56848 — Node.js:HTTP/2 可重入发送释放后使用 的离线版本证据检查工具。
它将操作员报告的 Node.js 版本与上游公告中指定的修复版本进行比较,并生成 CSV、JSON 或 HTML 报告。要求 Python 3.10+,仅使用标准库;可执行文件可单独复制使用。
概述 · 快速开始 · 输入 · 选项 · 修复版本 · 结果 · 输出 · 限制与退出码 · 来源 · 许可证
本检查工具比较的是操作员报告的运行时版本。它从不访问网站、执行 Node.js 或项目代码,也不发送漏洞利用载荷,并且没有网络模式。它不会扫描当前机器,公开 URL 也不等同于资产清单。
结果能说明什么、不能说明什么:
exploitability: not_tested。fixed_version_reported 表示所报告的版本等于或高于上游修复版本。它并不证明已部署的运行时已打补丁。unknown。仅从你有权检查的系统中收集版本信息。本仓库中的任何内容都不会评估已部署的目标、证明运行时状态或验证可利用性。
从代码检出目录运行,或单独复制 node_cve_2026_56848_check.py:
# One runtime, JSON on stdout
python node_cve_2026_56848_check.py --version 22.23.2 --format json
# Synthetic JSON inventory to an HTML report file
python node_cve_2026_56848_check.py --inventory examples/inventory.example.json --format html --output report.html
# CSV inventory; exit 1 if any result is potentially_affected or unsupported_runtime
python node_cve_2026_56848_check.py --csv-list inventory.csv --fail-on-finding
# All options
python node_cve_2026_56848_check.py --help
默认格式为 csv,除非指定 --output,否则写入 stdout。--version、--inventory 或 --csv-list 中至少需要提供一个。
打开合成示例报告。仅为示例数据;这不是实时评估。
三种输入类型可以在一次运行中组合使用。JSON、CSV 和 HTML 报告均基于相同的证据构建。
命令行版本。 --version(别名 --node-version)可重复使用;每个值描述一个独立的运行时。接受单个前导 v 和周围的 ASCII 空白字符。
JSON 清单(--inventory FILE,可重复)。一个对象或对象数组。参见 examples/inventory.example.json。
| 字段 | 必需 | 类型与含义 |
|---|---|---|
schema_version | 是 | 整数 1 |
node_version | 是 | 字符串 |
runtime | 否 | 如果存在则为 "node";其他运行时会拒绝 |
label | 否 | 用于在报告中标识条目的字符串 |
build_source | 否 | 字符串;参见构建来源 |
http2_service | 否 | 布尔值或 null:http2 服务 |
untrusted_http2_clients | 否 | 布尔值或 null:不受信任的 http2 客户端 |
未知键、重复键、非有限数字和无效类型会被拒绝。
CSV 列表(--csv-list FILE,可重复)。需要包含 node_version 列的表头行。可选列为 label、build_source、http2_service 和 untrusted_http2_clients;观测单元格为 true、false 或空白。schema_version 和 runtime 不是 CSV 列。未记录或重复的列、字段数不同的行、未加引号单元格内的裸引号、NUL 字符以及没有行的文件会被拒绝。
build_source(或 --build-source)记录构建的来源。空白值、unknown(默认值)、upstream、official 和 official_upstream 均按官方上游构建进行比较。任何其他值(例如发行版或供应商名称)都会产生 unknown 并附带 vendor_build_unverified,因为上游版本号无法表明供应商构建包含哪些补丁或向后移植。由于 unknown 按上游进行比较,请为任何供应商、发行版或自定义构建提供真实来源。
| 选项 | 用途 |
|---|---|
--version VERSION、--node-version VERSION | 要离线评估的 Node.js 版本;可重复 |
--build-source SOURCE | 每个 --version 构建的来源,最多 512 个字符;默认 unknown |
--http2-service {true,false} | 应用于每个 --version 输入的运维观测 |
--untrusted-http2-clients {true,false} | 应用于每个 --version 输入的运维观测 |
--inventory FILE | JSON 清单;可重复 |
--csv-list FILE | CSV 清单;可重复 |
--format {csv,json,html} | 报告格式;默认 csv |
--output FILE | 将报告写入新文件;默认写入 stdout |
--force | 显式替换现有输出文件 |
--brand NAME | HTML 报告中显示的组织名称,最多 512 个字符;CSV 和 JSON 忽略此项 |
--fail-on-finding | 当任何结果为 potentially_affected 或 unsupported_runtime 时以退出码 1 退出 |
--tool-version | 打印工具名称和版本,然后退出 |
--help | 显示用法和退出码 |
--output 要求目录存在且路径为常规文件。除非显式指定 --force,否则现有报告会受到保护,并且即使使用 --force,输入文件也绝不会被覆盖。
于 2026-10-24 对照官方发布公告及关联的修复版本进行审查(报告中的 rules_as_of)。
| Node.js 主版本 | 修复版本 |
|---|---|
| 22.x | 22.23.2 |
| 24.x | 24.18.1 |
| 26.x | 26.5.1 |
这些版本的应用方式:
potentially_affected,需要修复。fixed_version_reported。unknown;不假定它们已修补。unsupported_runtime。这是升级指引,并非声称该特定缺陷存在于每个历史构建中。unknown。不要将未知构建标记为安全。status | 含义 |
|---|---|
potentially_affected | 所报告的版本低于其所属所列主版本的修复版本。需要修复审查;未测试可利用性。 |
fixed_version_reported | 所报告的版本等于或高于修复版本。这不是已部署补丁的证明;请确认正在运行的进程或容器使用的是此版本。 |
unsupported_runtime | 所报告的主版本已停止维护。请迁移到受支持且已修复的版本。 |
unknown | 证据缺失或无法分类;参见 version_status。 |
每个结果还带有一个更具体的 version_status:
version_status | status | 原因 |
|---|---|---|
below_fixed_version | potentially_affected | 低于所列主版本的修复版本 |
at_or_above_fixed_version | fixed_version_reported | 等于或高于所列主版本的修复版本 |
unsupported_release_line | unsupported_runtime | 已停止维护的主版本,且规则中没有修复版本 |
release_line_not_in_rules | unknown | 本规则快照未覆盖的主版本 |
version_not_disclosed | unknown | 未报告版本 |
conflicting_versions | unknown | 同一运行时报告了不同版本 |
qualified_version_unverified | unknown | 普通版本加后缀或预发布标签 |
unrecognized_or_partial_version | unknown | 不是完整的 major.minor.patch 版本 |
vendor_build_unverified | unknown | 非上游构建来源;在版本比较之前检查 |
结果还带有 evidence_type: operator_reported_version 以及 low 的 evidence_confidence,当状态为 unknown 时为 insufficient。所报告的修复版本不是经过验证的已部署补丁,版本元数据也不是补丁或构建签名。
操作员前置条件按结果记录为 reported_true、reported_false 或 not_reported。它们未经核实,绝不会改变版本结果,也不是可达性的证明。
| 清单观察项 | 含义 |
|---|---|
http2_service | http2 服务 |
untrusted_http2_clients | 不受信任的 http2 客户端 |
所有格式都包含工具名称和版本、报告模式版本(1.0)、CVE、rules_as_of、主要来源以及 UTC 的 generated_at。一次运行的时间戳在各格式和中断恢复之间复用。它与 rules_as_of 不同,也不证明获取时间或已部署补丁。
JSON 是一个文档,包含 tool、tool_version、report_schema_version、cve、rules_as_of、sources、complete、generated_at 以及 results 数组。对于中断的运行,complete 为 false。
CSV 为每个字段加引号,并中和公式前缀(=、+、-、@,包括前导空白之后的情况,以及前导制表符或换行符)。备注和来源用 | 连接。列顺序如下:
record_type, input_label, input_source, node_version, build_source, status, version_status,
fixed_version, exploitability, evidence_type, evidence_confidence, cve, rules_as_of,
precondition_http2_service, precondition_untrusted_http2_clients, recommendation, notes,
sources, report_schema_version, report_complete, tool, tool_version, generated_at