用于 CVE-2026-56846 — Node.js:HTTP/2 保留头部内存耗尽 的离线证据检查器。它将运维人员报告的 Node.js 运行时版本与厂商安全公告中列出的修复版本进行比较,并生成一份保守的、仅基于版本的分诊报告。要求 Python 3.10+,仅使用标准库;可执行文件可单独复制使用。
版本证据,而非暴露测试。 结果描述的是你报告的版本。它们不能证明存在可到达的易受攻击代码路径、已部署的运行时已打补丁,或任何内容曾被利用。
该检查器:
--version、JSON 清单或 CSV 列表)与 Node.js 22.x 和 24.x 的修复版本进行比较;该检查器从不:
exploitability: not_tested;隐藏版本、自定义构建、相互冲突的证据以及未覆盖的发布线均保持为 unknown。公开 URL 不是清单。
# Assess one reported version and print JSON
python node_cve_2026_56846_check.py --version 22.23.2 --format json
# Assess the synthetic example inventory and save an HTML report
python node_cve_2026_56846_check.py --inventory examples/inventory.example.json --format html --output report.html
# Assess a CSV list (CSV is the default format) and exit 1 on a finding
python node_cve_2026_56846_check.py --csv-list inventory.csv --fail-on-finding
# Show all options, then run the local-only test suite
python node_cve_2026_56846_check.py --help
python -m unittest -v
不会自动扫描当前机器:所有版本都由你提供。--version 可重复使用;每个值描述一个独立的运行时。
打开合成示例报告。仅为示例数据;这不是实时评估。
至少提供一个输入:--version、--inventory 或 --csv-list。输入可以在一次运行中组合使用,每个输入都会生成自己的结果行。
| 选项 | 用途 |
|---|---|
--version VERSION(别名 --node-version) | 离线评估显式提供的 Node.js 版本。接受前导 v。可重复;每个值是一个独立的运行时。 |
--build-source SOURCE | --version 构建的来源,最多 512 个字符。unknown(默认值)、upstream、official 和 official_upstream 会作为上游发布版本进行比较(不区分大小写匹配);任何其他值(例如供应商名称)都会产生 unknown 并附带 vendor_build_unverified。 |
--http2-service {true,false} | 应用于每个 --version 输入的运维人员观察结果。 |
--untrusted-http2-clients {true,false} | 应用于每个 --version 输入的运维人员观察结果。 |
--inventory FILE | JSON 对象或条目数组。可重复。 |
--csv-list FILE | 包含 node_version 列的 CSV 列表。可重复。 |
--format {csv,json,html} | 报告格式。默认:csv。 |
--output FILE | 将报告保存到现有目录中的新文件。默认:stdout。 |
--force | 替换已存在的输出文件。输入文件永远不会被覆盖,即使使用 --force 也不行。 |
--brand NAME | HTML 报告中显示的组织名称,最多 512 个字符。默认:CompleteTech LLC。 |
--fail-on-finding | 当结果为 potentially_affected 或 unsupported_runtime 时以退出码 1 退出(参见退出码)。 |
--tool-version | 打印工具名称和版本。 |
除非显式指定 --force,否则现有报告会受到保护。--build-source、--brand 以及两个观察选项会在读取任何输入之前进行检查。
清单文件包含一个对象或一个对象数组。每条记录需要一个值为 1 的整数 schema_version 和一个字符串 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",
"http2_service": null,
"untrusted_http2_clients": null
}
]
CSV 列表需要包含 node_version 列的表头行。可选列为 label、build_source、http2_service 和 untrusted_http2_clients;观测单元格只能填写 true、false 或留空。重复或未记录的列、字段数与表头不一致的行、未加引号单元格中的裸引号以及 NUL 字符都会被拒绝。没有 label 的条目以文件名和行号命名。
| 观测 | 含义 |
|---|---|
http2_service | 操作员报告存在 HTTP/2 服务。 |
untrusted_http2_clients | 操作员报告存在不受信任的 HTTP/2 客户端。 |
观测由操作员提供且未经核实。它们被记录为 reported_true、reported_false 或 not_reported,且绝不会改变版本结果或确立可达性。
规则截至 2026-10-24,已对照官方发布公告及关联的修复版本进行审查。
| Node.js 主版本 | 修复版本 |
|---|---|
| 22.x | 22.23.2 |
| 24.x | 24.18.1 |
对于每个列出的主版本,低于其修复版本的版本需要修复。未列出的、自定义/回移植以及预发布构建需要明确证据;不要将未知构建标记为安全。厂商在发布公告中未指明引入版本,因此每个指定主版本的更早版本均被视为 potentially_affected。
厂商、发行版或自定义构建来源会首先被检查,且始终产生 unknown;其余行适用于上游构建来源。
| 报告的版本 | status | version_status |
|---|---|---|
| 低于所列主版本修复版本的普通稳定版 | potentially_affected | below_fixed_version |
| 所列修复版本,或该主版本上更晚的普通版本 | fixed_version_reported | at_or_above_fixed_version |
| 在嵌入式 Node.js 发布计划中已过生命周期终止的主版本(0、4–21、23 和 25) | unsupported_runtime | unsupported_release_line |
| 上述未列出的其他主版本,包括活跃和未来主版本 | unknown | release_line_not_in_rules |
| 厂商、发行版、自定义或无法识别的构建来源 | unknown | vendor_build_unverified |
| 预发布、nightly/rc、带包后缀或其他限定版本 | unknown | qualified_version_unverified |
格式错误或不完整的版本,例如 22.23 | unknown | unrecognized_or_partial_version |
| 缺失或空版本 | unknown | version_not_disclosed |
unsupported_runtime 是升级指导,并非声称此特定缺陷存在于每个历史构建中。厂商、回移植或自定义构建需要厂商证据,即使在生命周期终止的主版本上也保持 unknown,因为其上游版本无法显示包含哪些补丁。版本元数据不是补丁或构建签名。
status | 含义 |
|---|---|
potentially_affected | 报告的版本低于其主版本的修复版本,需要修复审查。 |
fixed_version_reported | 报告的版本等于或高于修复版本。这不是已部署补丁的证明;请确认正在运行的进程或容器实际使用了该版本。 |
unsupported_runtime | 报告的主版本已过生命周期终止。将其视为升级指导。 |
unknown | 证据缺失或无法分类。收集确切的上游版本和构建来源,然后再次运行检查器。 |
每个结果都有 exploitability: not_tested。evidence_type 始终为 operator_reported_version;evidence_confidence 对于已分类结果为 low,对于 unknown 为 insufficient。每行还带有 recommendation 和 notes,重复公告中的注意事项。操作员提供的前提条件绝不会改变版本结果或确立可达性。
报告的已修复版本并不等于已验证部署的补丁,potentially_affected 也不等于已确认的可利用性。操作失败(退出码 2)不是评估结果,也不能说明本应被评估的版本情况。
所有格式都会在写入任何内容之前完整渲染到内存中,并携带相同的证据。
tool、tool_version、report_schema_version(1.0)、cve、rules_as_of、sources、complete、generated_at 以及一个 results 数组。=、+、- 或 @ 开头的值。结果行使用 record_type=result。当不存在结果时,record_type=summary 行会保留 report_complete 和规则元数据,但不包含资产或判定。备注和来源用 | 连接。CSV 在写入报告前会拒绝 NUL 字符。--brand 设置组织名称。CSV 会在结果列后追加 tool、tool_version 和 UTC generated_at,而 report_complete 记录运行是否完成。所有结果行和空摘要都携带此报告元数据。每次 CLI 运行会捕获一个时间戳,如果因中断需要恢复则复用该时间戳;它是报告生成时间,而不是证据获取时间。JSON 和 HTML 使用相同的时间戳。
分发的独立文件由 SHA256SUMS 标识。运行时无需 Git 或网络查询。