返回更新列表
新发布Aug 21, 2026

retire.js v5.5.0

用于检测使用已知漏洞JavaScript库的扫描器。还可以生成它所找到库的SBOM。

分享

Retire.js

你所需要的,也必须被淘汰

Web 和 Node.js 应用都有庞大的 JavaScript 库生态系统可供使用。虽然这些库能显著加快开发速度,但它们也需要持续维护,以确保安全漏洞得到及时修复。2013 年,“使用含有已知漏洞的组件”被加入 OWASP Top 10 关键安全风险清单,凸显了过时或不安全的依赖可能对 Web 应用构成的严重威胁。Retire.js 的诞生就是为了帮助开发者识别存在已知漏洞的 JavaScript 库版本,尤其是那些不在包清单中、而是直接下载并纳入源码管理的库。

Retire.js 可以通过多种方式使用:

  1. 作为命令行扫描器
  2. 作为 Chrome 扩展 - 未在 Chrome 网上应用店正式提供
  3. 作为 Burp 扩展或 ZAP 插件
  4. 作为 Firefox 扩展 - Manifest V3 开发版本;请参阅安装说明。
  5. 无头网站扫描器
  6. 作为 grunt 插件(已弃用)
  7. 作为 gulp 任务(已弃用)

命令行扫描器

扫描 Web 应用或 Node 应用,以检测其中使用的存在漏洞的 JavaScript 库和/或 Node.JS 模块。如果你尚未安装,需要先安装 node/npm。在应用的源代码文件夹中运行:

$ npm install -g retire
$ retire

SBOM 生成

retire.js 可以生成 CycloneDX 格式的 SBOM:

$ retire --outputformat cyclonedx

cyclonedx 生成 CycloneDX 1.4 XML。如需 JSON 格式以及更新的规范版本,请使用 cyclonedxJSON(1.4)、cyclonedxJSON1_6 或 cyclonedxJSON1_7。cyclonedxJSON1_6_VEX 和 cyclonedxJSON1_7_VEX 变体还会包含 vulnerabilities 部分。

默认情况下,如果 retire.js 发现漏洞,将以代码 13 退出。可通过 --exitwith 0 覆盖此行为。

Chrome 和 Firefox 扩展

扫描访问过的站点,查找存在已知漏洞的 JavaScript 库。工具栏徽章和共享的 Analyst Console 会显示检测结果、公告详情、搜索和 JSON 导出。请参阅 Chrome 和 Firefox 的开发说明。

Burp 扩展和 ZAP 插件

@h3xstream 已将 Retire.js 适配为渗透测试工具 Burp 的插件。

ZAP 团队官方支持 Retire.js 插件,可通过 ZAP Marketplace 获取,并且默认包含在 ZAP 每周发布版本中:https://www.zaproxy.org/docs/desktop/addons/retire.js/

无头站点扫描器

retire-site-scanner https://github.com/RetireJS/retire-site-scanner 可用于以无头模式扫描网站(与使用 chrome/firefox 扩展相对)。

Grunt 插件(已弃用)

一个用于运行 Retire.js 的 Grunt 任务,可作为应用程序构建流程或其他自动化工作流的一部分。

Gulp 任务(已弃用)

一个 Gulp 任务示例,可用于你的 gulpfile 中自动监视和扫描项目文件。你可以按需修改监视模式和(可选的)Retire.js 选项。

const c = require("ansi-colors");

var gulp = require("gulp");
var beeper = require("beeper");
var log = require("fancy-log");
var spawn = require("child_process").spawn;

gulp.task("retire:watch", ["retire"], function (done) {
  // Watch all javascript files and package.json
  gulp.watch(["js/**/*.js", "package.json"], ["retire"]);
});

gulp.task("retire", function () {
  // Spawn Retire.js as a child process
  // You can optionally add option parameters to the second argument (array)
  var child = spawn("retire", [], { cwd: process.cwd() });

  child.stdout.setEncoding("utf8");
  child.stdout.on("data", function (data) {
    log(data);
  });

  child.stderr.setEncoding("utf8");
  child.stderr.on("data", function (data) {
    log(c.red(data));
    beeper();
  });
});

捐赠

捐赠将用于资助该工具和漏洞仓库的维护。

分类