用于 CVE-2026-105482 — Node.js:DNS 解析 NUL 名称截断 的离线证据检查工具。它将你报告的 Node.js 运行时版本与 Node.js 2026 年 10 月安全公告中列出的修复版本进行比对,并将结果写入 CSV、JSON 或 HTML。
需要 Python 3.10+,仅使用标准库。单个可执行文件 node_cve_2026_105482_check.py 可单独复制使用。
版本证据,而非对运行中系统的评估。 结果描述的是你提供的版本。它并不表明补丁已部署、缺陷可被触达,或可被利用。
本仓库仅涵盖 CVE-2026-105482。它是一个小型、离线的分诊工具。
unknown;它们绝不会被标记为安全。exploitability: not_tested。fixed_version_reported 表示所提供的版本等于或高于厂商的修复版本。它并非对所部署内容的证明。仅为你获授权评估的系统提供数据。
node --version),以及已知的构建来源。检查器本身从不获取这些信息。# Assess one version and print JSON to stdout
python node_cve_2026_105482_check.py --version 22.23.4 --format json
# Assess the synthetic example inventory and save an HTML report
python node_cve_2026_105482_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_105482_check.py --csv-list inventory.csv --fail-on-finding
# Show all options, or run the local synthetic tests
python node_cve_2026_105482_check.py --help
python -m unittest -v
上面的 inventory.csv 是你自己的文件;其列说明见 CSV 列表。未指定 --format 时,报告为 CSV 格式。未指定 --output 时,输出到 stdout。
预览展示了浅色和深色主题下的 HTML 报告。打开合成示例报告。该报告仅使用示例数据,并非实时评估。
规则日期为 2026-10-24(报告中的 rules_as_of)。这些规则已对照官方 Node.js 发布公告(发布于 2026-10-21)及其中链接的修复版本进行审核。
| Node.js 主版本 | 修复版本 |
|---|---|
| 22.x | 22.23.4 |
| 24.x | 24.22.1 |
| 26.x | 26.12.1 |
普通稳定版本(如 22.20.0 或 v24.22.1)的分类方式如下:
potentially_affected。厂商未确定引入版本,因此每个所列主版本的所有更早版本均按此处理,低于修复版本的版本需要修复。fixed_version_reported。unknown。不假定其已修补。unsupported_runtime。这是升级指引,并非声称该缺陷存在于所有历史构建中。厂商声明停止维护的版本始终受安全发布影响;检查器不会针对此特定缺陷作出该断言。unknown。它们需要明确的厂商证据;不要将未知构建标记为安全。停止维护的主版本为 0(此为推断,因为发布计划仅列出 0.8、0.10 和 0.12)、4–21、23 和 25,取自 2026-10-24 审核的 Node.js 发布计划。此列表内置于检查器中;运行时不会获取发布计划。
版本号并非补丁或构建签名。厂商、回移植和自定义构建可能包含其版本号未显示的修复,也可能缺少这些修复。
至少需要提供 --version、--inventory 或 --csv-list 之一。它们可以组合使用;结果按以下顺序出现:先是 --version 值,然后是 --inventory 文件,最后是 --csv-list 文件。每个版本或清单行描述一个独立的运行时。
| 选项 | 用途 |
|---|---|
--version VERSION(别名 --node-version) | 评估确切的 Node.js 版本。接受前导 v。可重复;每个值是一个独立的运行时。 |
--build-source SOURCE | --version 构建的来源,最多 512 个字符。参见 构建来源。 |
--dns-resolve-or-reverse {true,false}--untrusted-hostnames {true,false}--hostname-validation-before-resolution {true,false} | 应用于每个 --version 输入的操作员观察结果。参见 前置条件观察。 |
--inventory FILE | JSON 清单文件。可重复。 |
--csv-list FILE | CSV 列表文件。可重复。 |
--format {csv,json,html} | 报告格式。默认:csv。 |
--output FILE | 将报告保存到新文件。默认:stdout。 |
--force | 允许 --output 替换现有文件。 |
--brand NAME | HTML 报告中显示的组织名称,最多 512 个字符。默认:CompleteTech LLC。不影响 CSV 或 JSON。 |
--fail-on-finding | 当任何结果为 potentially_affected 或 unsupported_runtime 时以退出码 1 退出。参见 退出码与中断。 |
--tool-version | 打印工具名称和版本。 |
--help | 打印用法和退出状态帮助。 |
--build-source 和 build_source 清单字段说明构建的来源。空值、unknown(默认值)、upstream、official 或 official_upstream 会被视为官方上游构建进行比较;匹配时忽略大小写和前后空白。任何其他值(例如发行版或供应商名称)都会产生 unknown,并带有 version_status vendor_build_unverified,因为上游版本无法显示该构建包含哪些补丁或向后移植。此检查先于版本比较,因此同样适用于已终止支持(end-of-life)和未列出的主版本。
由于默认值会按上游进行比较,因此答案的可靠性取决于“该构建是未经修改的官方发布版本”这一声明。
这些可选的、由操作员提供的观察项会记录在结果旁边。它们未经核实,绝不会改变版本结果,也不构成可达性证明。
| 清单键 | CLI 选项 | 观察项 |
|---|---|---|
dns_resolve_or_reverse | --dns-resolve-or-reverse | DNS 解析或反向解析 |
untrusted_hostnames | --untrusted-hostnames | 不受信任的主机名 |
hostname_validation_before_resolution | --hostname-validation-before-resolution | 解析前的主机名验证 |
报告会将每个观察项显示为 reported_true、reported_false 或 not_reported。
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 以及三个观察项键;schema_version 和 runtime 不是 CSV 列。观察项单元格必须恰好为 true 或 false,或留空。未记录的列或重复列、字段数与表头不一致的行、未加引号单元格内的引号、闭合引号后的文本、未闭合的引号以及 NUL 字符都会被拒绝。
报告格式为 CSV(默认)、JSON 或 HTML。三者均基于相同的证据构建。报告在写入任何内容之前会完整渲染。
--output 时,报告写入 stdout。--output 时,目录必须已存在,且路径必须是新的常规文件。报告会先缓冲并以原子方式发布,不会覆盖。如果文件系统无法创建硬链接,运行会失败,并要求更换文件系统或显式使用 --force。--force 时才会替换已存在的文件。--force,--output 也绝不能是输入文件之一。每个结果记录输入标签和来源、报告的 node_version 和 build_source、status、version_status、fixed_version、exploitability(始终为 not_tested)、evidence_type(operator_reported_version)、evidence_confidence(unknown 结果为 insufficient,否则为 low)、cve、rules_as_of、观察项值、recommendation、notes 和 sources,以及 report_schema_version(1.0)。每个结果的 notes 都包含公告注意事项。
tool、tool_version、report_schema_version、cve、rules_as_of、sources、complete、generated_at 以及按输入顺序排列的 results 数组。=、+、- 或 @,即使前面有空白字符)或制表符、回车符、换行符开头的值会通过前置单引号进行中和处理。notes 等列表用 | 连接。行的 record_type=result。当不存在任何结果时(例如在任何输入完成之前发生中断),会保留一行 record_type=summary,其中包含 report_complete 和规则元数据,但不含资产或判定。report_complete 为 true 或 false。potentially_affected、unsupported_runtime、unknown,然后是 fixed_version_reported。被中断的运行会在页面上标记出来。