跳到主要内容
api工厂
安全

依赖供应链安全:lockfile 审计、npm audit 与投毒防范

api工厂资讯栏目 约 6 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:2025 年 9 月的 npm 投毒事件证明,流行度不等于安全性——chalk、debug 等 18 个周下载量合计超 26 亿次的包被注入恶意代码,随后的 Shai-Hulud 蠕虫更感染了 500 多个包并窃取开发者密钥。防线不复杂:提交 lockfile、CI 只用 npm ci、新版本缓几天再升、npm audit 进流水线、发布账号上抗钓鱼 2FA。

一、事件复盘:攻击者不攻你,攻你信任的上游

2025 年 9 月 8 日,攻击者通过钓鱼拿到知名维护者的 npm 账号,向 chalk、debug、ansi-styles 等 18 个基础包发布恶意版本。注入的浏览器端代码会拦截 fetch 与钱包 API,篡改加密转账的收款地址。恶意版本约两小时后被下架,但窗口期内自动构建的项目已经中招。一周后出现的 Shai-Hulud 蠕虫更进一步:窃取 GitHub 与云厂商密钥、用受害者自己的 npm 权限感染其维护的其他包,实现自我繁殖。CISA 于 2025 年 9 月 23 日发布警报,确认超过 500 个包受影响。registry 本身没有被攻破——被攻破的是「人」与「信任」。事件之后,GitHub 宣布收紧 npm 发布机制:强制 2FA 或短时效令牌、推广 trusted publishing、逐步淘汰经典 token。平台在补洞,项目侧的纪律仍要自己建。

二、你的攻击面在哪

  1. 传递依赖:你只声明了 50 个包,node_modules 里可能有 1500 个,任何一个被投毒都算你的。
  2. 安装脚本:preinstall/postinstall 在 npm install 时自动执行,是恶意代码最爱的入口。
  3. 自动升级:^ 与 ~ 范围加上没有 lockfile 的构建,等于每次构建都赌一次上游清白。
  4. 仿冒包名:typosquatting 与依赖混淆,装错一个字母、公私源配置不当就中招。

三、lockfile 纪律:构建可复现

bash
# CI 中永远用 ci,严格按 lockfile 安装
npm ci
# pnpm 等价写法
pnpm install --frozen-lockfile
# 本地升级后提交 lockfile 变更,走代码评审

lockfile 锁定整棵依赖树的精确版本与完整性哈希。要清醒认识它的边界:lockfile 只保证「装到的和上次一样」,如果锁定的版本本身已投毒,它反而会忠实复现毒版本——所以必须配合审计、告警与延迟升级,而不是锁完就高枕无忧。

四、npm audit 进流水线

bash
npm audit --audit-level=high
npm audit fix --package-lock-only
npm audit signatures
  • audit 把依赖树提交给 registry 比对已知漏洞;--audit-level=high 让高危以上才阻断 CI,避免低危噪音淹没流水线。
  • audit fix 自动升级到兼容的安全版本;跨大版本需要 --force,务必人工评审后再动。
  • audit signatures 校验 registry 签名与 provenance 证明,确认包确实来自声称的构建来源。
  • 局限要说清楚:audit 只查「已公开披露」的漏洞,投毒包从发布到被披露有几小时窗口,这段时间它查不出来,延迟升级正是为了躲开这个窗口。

五、投毒防范清单

  1. 新版本缓升:恶意版本大多在数小时到数天内被下架,让 Renovate/Dependabot 延迟几天再提升级 PR。
  2. 审查安装脚本:pnpm 可默认禁止依赖生命周期脚本,按需白名单放行。
  3. 账号安全:GitHub/npm 启用抗钓鱼的 FIDO 安全密钥,淘汰长期经典 token——事件中正是 TOTP 被钓鱼骗走。
  4. 发布侧用 trusted publishing:CI 用短期 OIDC 凭证直接发布,没有长期 token 可偷。
  5. 最小权限:CI 构建任务不持有生产部署密钥;开发机不放长期云密钥,用短期会话凭证。
  6. 定期瘦身:每半年清理不用的依赖,每个依赖都是攻击面。
  7. 开启告警:Dependabot 安全更新与密钥扫描在多数套餐里免费,没有理由不开。

六、疑似中招的应急流程

  1. 比对 lockfile 与缓存中的包版本和官方公布的受影响清单。
  2. 锁定已知安全版本,清理缓存后重装重建。
  3. 轮换一切可能暴露的凭证:GitHub token、npm token、云密钥、API key。
  4. 检查 GitHub 是否出现陌生仓库、workflow、webhook——蠕虫会公开外传密钥。
  5. 排查网络日志中的陌生外联端点,评估影响面并留档。

七、减少依赖面本身:能不自建就不自建

供应链安全的终极手段是少引依赖。登录、支付、订单、CMS 这类通用能力,用成熟 SaaS 的开放接口替代一堆自建轮子,能显著缩小攻击面。api工厂(https://www.it120.cc/)提供全开放前后台接口与六端 SDK(apifm-wxapi、apifm-webapi、apifm-uniapp 等),统一返回 {code,data,msg},一个 SDK 覆盖会员、商品、支付、短信等能力,比引入十几个功能各异的 npm 包更容易审计与升级,SDK 文档见 https://www.it120.cc/sdk/index.html 。

八、把防线写进 CI:最小流水线示例

yaml
steps:
  - run: npm ci
  - run: npm audit --audit-level=high
  - run: npm audit signatures
  - run: npm test

四步的含义:先按 lockfile 复现依赖,再查已知漏洞与签名,最后跑测试,任何一步失败都阻断合并。升级依赖的 PR 额外要求人工评审 lockfile 差异,重点看新增的传递依赖与安装脚本。把安全检查变成和单元测试一样的默认关卡,而不是出事后才想起的补救动作。

文章标签

供应链安全npmlockfile依赖审计投毒防范

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。