3 分钟产品导览 通过邮件报告紧急安全事件
安全博客

从 npm 供应链事件看安装阶段的安全风险

结合 Nx 和 Shai-Hulud 的公开案例,梳理软件包安装环节需要检查的风险。
本文梳理了安装脚本策略、依赖项审查和隔离验证各自发挥的作用。

从 npm 供应链事件看安装阶段的安全风险

Nx,2025 年 8 月 26 日

构建工具 Nx 的 npm 发布令牌因 GitHub Actions 工作流注入事件泄露,攻击者在数小时内上传了恶意版本。nx 20.9.0 至 20.12.0、21.5.0 至 21.8.0 以及多个 @nx/* 软件包受影响。恶意版本中包含由 postinstall触发的 telemetry.js。

事后分析指出,安装脚本曾试图绕开开发环境中 Claude Code、Gemini CLI 和 Amazon Q CLI 的权限确认。请检查钱包文件、SSH 密钥、 .env 等开发环境中的敏感信息是否被异常访问,并核对以 s1ngularity-repository开头的公开仓库是否被创建。不同分析对 AI 工具是否实际执行了该请求得出了不同结论。Nx 表示,恶意版本缺少 npm 来源证明(provenance)是识别异常的线索。

Shai-Hulud,2025 年 9 月

一个月后,Shai-Hulud 蠕虫被发现。CISA 在 9 月 23 日的警报中称,已有 500 多个 npm 软件包受到感染。受感染的安装脚本以开发环境的机密信息为目标。软件包发布权限一旦泄露,影响可能扩展到其他软件包。请结合安装历史、软件包发布记录,以及开发和 CI 账号中的异常变更排查。

两起事件中,开发人员都只是照常运行 npm install。单靠代码审查无法拦住安装阶段的风险。

默认禁用安装脚本

优先采取的措施是默认禁用依赖项的安装脚本。pnpm 自 10.0 起默认不执行依赖项的生命周期脚本,仅允许 onlyBuiltDependencies中列出的软件包运行安装脚本。npm 可以通过配置禁用安装脚本。

npm config set ignore-scripts true
npm ci --ignore-scripts

onlyBuiltDependencies:
  - esbuild
  - sharp

禁用脚本可能导致原生模块等需要在安装时构建的软件包无法正常安装。启用策略的头几天,可能需要整理安装失败的软件包并建立允许列表。如果恶意代码位于库的正文,安装时也可能毫无异常,直到首次 require时执行。

新引入的版本先在干净环境中验证

新引入的软件包或更换了维护者的软件包,应先在无任何机密信息的环境中试装。最简单的做法是使用没有挂载任何内容的容器。

docker run --rm node:22 \
  sh -c "mkdir /tmp/t && cd /tmp/t && npm init -y >/dev/null && \
         npm install example-package@1.2.3 --foreground-scripts 2>&1" | tee install.log

这样可以观察安装脚本执行了哪些命令、尝试连接哪些地址。若代码只在某个 CI 环境变量存在时或指定日期之后触发,仍可能在干净的容器中表现正常。

在 Genox,Vulnerability Scanner 发现维护者变更或代码混淆等风险信号后,会在 Behavioral Analyzer 沙箱中运行安装流程,观察环境变量访问和对外通信。受前述限制,这一步与阻止安装脚本的策略配合使用。

若已安装受影响版本

如果安装过受影响的版本,请隔离相关计算机或 CI 运行器,并保留日志与变更记录。撤销或轮换可能已暴露的 npm、GitHub 和云服务凭据,并检查 GitHub 组织中是否出现了 s1ngularity-repository 或 Shai-Hulud 仓库, .github/workflows/shai-hulud-workflow.yml 文件是否新建。对于涉及 Nx 的环境,请查看 ~/.bashrc和 ~/.zshrc的变更记录。若确认存在未经批准的配置变更,请先保留证据,再恢复到经过验证的正常配置。

参考资料

和 Genox 谈
范围与时间。

联系我们