针对 CVE-2026-106069 — Node.js:TLS 前导零 IPv4 解析器不匹配 的离线版本证据检查器。
它将你报告的 Node.js 版本与厂商公告中指定的修复版本进行比较,并生成 CSV、JSON 或无脚本 HTML 分类报告。它是一个仅使用标准库的单个 Python 3.10+ 文件,因此可执行文件可以单独复制。
此检查器比较操作员报告的运行时版本。它从不联系网站、执行 Node.js 或项目代码,也不发送漏洞利用载荷,并且没有网络模式。它不扫描当前机器:版本证据由你提供。
exploitability: not_tested。unknown。CI 在 Ubuntu 和 Windows 上使用 Python 3.10 和 3.14 运行仅本地单元测试和 --help 检查。
# Assess one reported version and print JSON to stdout
python node_cve_2026_106069_check.py --version 22.23.4 --format json
# Assess the synthetic inventory and write an HTML report to a new file
python node_cve_2026_106069_check.py --inventory examples/inventory.example.json --format html --output report.html
# Assess a CSV list and exit 1 if any result is a finding
python node_cve_2026_106069_check.py --csv-list inventory.csv --fail-on-finding
# Show all options, or run the local tests
python node_cve_2026_106069_check.py --help
python -m unittest -v
--version 可重复使用;每个值描述一个独立的运行时。CSV、JSON 和 HTML 报告包含相同的证据,默认格式为输出到 stdout 的 CSV。
打开合成示例报告。仅为示例数据;这不是实时评估,也不描述任何真实系统。
至少提供 --version、--inventory 或 --csv-list 之一。输入可以在一次运行中组合使用。
| 选项 | 用途 |
|---|---|
--version VERSION(别名 --node-version) | 评估显式提供的 Node.js 版本;接受前导 v。可重复。 |
--inventory FILE | JSON 清单文件(单个对象或数组)。可重复。 |
--csv-list FILE | 包含 node_version 列的 CSV 清单文件。可重复。 |
--build-source SOURCE | --version 构建的来源(见下文)。默认 unknown。 |
--tls-client {true,false}--leading-zero-ipv4 {true,false}--platform-resolver-decimal-behavior {true,false} | 操作员报告的观察结果,应用于每个 --version 输入。 |
--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 | 打印检查器名称和版本,然后退出。 |
--build-source 应用于本次运行中的所有 --version 值。默认值 unknown,以及 upstream、official、official_upstream 或空值(不区分大小写比较),均被视为上游构建并按版本进行比较。任何其他值(例如供应商名称)会产生 unknown 并带有 version_status: vendor_build_unverified,因为上游版本无法显示该构建包含哪些补丁或向后移植。
版本会去除 ASCII 空白字符,并接受一个前导 v。仅比较纯 MAJOR.MINOR.PATCH 发行版;预发行版、nightly、rc、带包后缀的版本以及不完整版本保持为 unknown。
除非显式指定 --force,否则现有报告受到保护;即使使用 --force,输入文件也不能被覆盖。输出目录必须已存在。
操作员报告的观察结果是可选的,会记录在报告中,但它们绝不会改变版本结果或确立可达性。
| 观察键 | CLI 标志 | 公告前提条件 |
|---|---|---|
tls_client | --tls-client | tls client |
leading_zero_ipv4 | --leading-zero-ipv4 | leading zero ipv4 |
platform_resolver_decimal_behavior | --platform-resolver-decimal-behavior | platform resolver decimal behavior |
JSON 清单是单个对象或包含 1 到 10,000 条记录的数组。每条记录要求整数 schema_version: 1 和字符串 node_version。可选字段为 runtime: "node"(任何其他运行时都会被拒绝)、label、build_source 以及上述观察键,每个均为布尔值或 null。未知键、重复键、非有限数字和无效类型都会被拒绝。完整的合成记录见 examples/inventory.example.json。
CSV 清单要求包含 node_version 列的表头行。可选列为 label、build_source 以及观察键,值为 true、false 或空白。没有 schema_version 或 runtime 列。重复或未记录的列、字段数与表头不同的行、未加引号单元格内的引号、闭合引号后的文本、未终止的引号、NUL 字符以及没有行的文件都会被拒绝。
没有标签的条目以输入文件和位置命名(例如 inventory:1);--version 输入标记为 Node.js <version>。
每个结果都有一个 status、一个更具体的 version_status,以及一个始终为 not_tested 的 exploitability。
status | 含义 |
|---|---|
potentially_affected | 报告的版本低于其所属主版本的修复版本,需要修复审查。这并不表示已确认可利用性。 |
fixed_version_reported | 报告的版本等于或高于修复版本。这并不构成对已部署补丁的证明。 |
unsupported_runtime | 报告的主版本已停止维护。这是升级指引,并非声称该缺陷存在于所有历史构建中。 |
unknown | 证据缺失或无法分类。这绝不表示运行时是安全的。 |
HTML 报告按 potentially_affected、unsupported_runtime、unknown、fixed_version_reported 的顺序列出结果。已分类结果的证据置信度为 low,unknown 的置信度为 insufficient。
version_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 | 该主版本不在此日期规则快照的覆盖范围内(例如更新的主版本);不假定其已修补。 |
vendor_build_unverified | unknown | 报告了厂商、发行版、自定义或无法识别的构建来源。 |
qualified_version_unverified | unknown | 版本后带有后缀(预发布、nightly、软件包或自定义构建)。 |
unrecognized_or_partial_version | unknown | 文本不是纯 MAJOR.MINOR.PATCH 版本。 |
version_not_disclosed | unknown | 未报告版本。 |
conflicting_versions | unknown | 版本引擎收到了相互冲突的候选版本。清单条目每个只携带一个版本,因此命令行不应出现此情况。 |
规则截至 2026-10-24,已对照官方发布公告及关联的修复版本进行审查。
| Node.js 主版本 | 修复版本 |
|---|---|
| 22.x | 22.23.4 |
| 24.x | 24.22.1 |
| 26.x | 26.12.1 |
potentially_affected。fixed_version_reported。unknown。unsupported_runtime。它们取自 Node.js 发布计划,审查日期为 2026-10-24:主版本 4 至 21、23 和 25,以及根据推断得出的主版本 0,因为该计划仅列出 0.8、0.10 和 0.12。unknown。版本元数据不是补丁或构建签名。
CSV、JSON 和 HTML 报告均由相同的行构建。
tool、tool_version、report_schema_version、cve、rules_as_of、sources、complete、generated_at 以及一个 results 数组。record_type=result。当不存在结果时,单行 record_type=summary 保留 report_complete 和规则元数据,不含资产或判定。每一行都带有规范的 tool、tool_version 和 generated_at 列。--brand 仅更改其页眉中的组织名称。每个结果行包含输入标签和来源、报告的版本和构建来源、status、version_status、fixed_version、exploitability、evidence_type(operator_reported_version)、evidence_confidence、CVE、rules_as_of、三项观察结果(reported_true、reported_false 或 not_reported)、建议、备注、来源以及 report_schema_version。