♧ Godown 安全知识树

npm 发布包夹带 cli.js.map:用 sourcesContent 还原厂商完整源码

pentest/recon · verified

一句话结论

npm 包发布时若未用 .npmignore 或 package.json 的 files 白名单排除构建调试产物,含 sourcesContent 的 .map 文件会随 tarball 一起分发;任何能下载该包的人都能在本地把厂商完整的 TypeScript/JavaScript 源码逐文件还原出来,泄露内部实现、隐藏接口、提示词与权限判断等本不应公开的信息。

原理

  • 打包工具(tsc/webpack/esbuild/Vite 等)可同时输出 bundle 与 source map;source map 是 JSON,sources 记录原始文件路径,sourcesContent 记录每个原始文件的完整文本,mappings 记录压缩后位置到原始行列的映射。
  • npm publish 上传的是由 package.json 的 files 字段、.npmignore(无 .npmignore 时退回 .gitignore)共同筛选后的 tarball;很多项目只在 .gitignore 里忽略 *.map 或从未配置发布白名单,构建目录中的 .map 因此被原样打进包。
  • 与“生产 Web 站点暴露 .map”不同,这里的泄露发生在供应链分发环节:不需要目标站点可访问、不需要猜路径,只要包在公共 registry(或攻击者可读的私有 registry/镜像)上,下载 tarball 即可离线分析,且版本可固定、可长期复现。
  • sourcesContent 存在时,还原不依赖目标源码仓库或构建环境,直接用脚本把数组写回文件即可;即使没有 sourcesContent,sources 与 mappings 仍能暴露内部目录结构、模块名和代码组织方式。
  • 泄露的危害是信息面而非直接执行:完整源码可暴露未公开 API、内部域名、feature flag、鉴权与工具门禁逻辑、嵌入的 system prompt、注释中的 TODO/凭据线索,为后续漏洞挖掘和社会工程提供高价值情报;若源码中确实硬编码密钥,则进一步升级为凭据泄露。

触发条件

  • 发布到 npm 的 tarball 内包含 .map 文件(通常是 cli.js.map、index.js.map、*.mjs.map 等构建产物)。
  • 项目未在 .npmignore 或 package.json#files 中排除 *.map,或 .npmignore 缺失且 .gitignore 未覆盖构建目录。
  • source map 含 sourcesContent(tsc 默认 inlineSources 关闭时不带;webpack devtool: 'source-map' 常带;需实际下载确认)。
  • 包可从公共 registry、企业镜像或可读的私有 registry 获取。

利用步骤

  1. 取得 tarball URL 并下载:npm view <pkg> dist.tarball 后 curl -L,或用 npm pack <pkg>@<version>;优先直接下载 registry tarball,避免在本地执行包内 prepare/postinstall 脚本。
  2. 解包并枚举 .map:tar -tzf pkg.tgz | grep -i '\.map$';同时检查 bundle 末尾是否有 //# sourceMappingURL= 或内联的 data:application/json;base64,...。
  3. 解析 map 的 sources/sourcesContent,确认是否带原始文件内容;带内容则直接写盘还原目录树。
  4. 在还原源码中检索 api、baseURL、http、token、secret、prompt、permission、allowlist、process.env 等关键词,整理内部接口、配置与安全逻辑。
  5. 对源码中暴露的端点与参数做后续授权/鉴权测试;把源码版本与公开版本对齐,用于补丁差异和漏洞挖掘。
  6. 若 sourcesContent 为空,退而利用 sources 中的路径推断工程结构,并结合 bundle 字符串提取补充。

PoC

# 1. 直接下载 registry 上的发布包(不执行包内脚本)
url=$(npm view <package>@<version> dist.tarball)
curl -sL "$url" -o pkg.tgz

# 2. 看包里是否夹带 source map
tar -tzf pkg.tgz | grep -iE '\.(js|mjs|cjs)\.map$|\.map$'

# 3. 解包
tar -xzf pkg.tgz
import json, pathlib

m = json.load(open("package/cli.js.map", encoding="utf-8"))
print("sources:", len(m.get("sources", [])),
      "with content:", sum(c is not None for c in m.get("sourcesContent", [])))

out = pathlib.Path("restored")
for name, content in zip(m.get("sources", []), m.get("sourcesContent", [])):
    if content is None:
        continue
    p = out / name.replace("webpack://", "").replace("..", "_").lstrip("/")
    p.parent.mkdir(parents=True, exist_ok=True)
    p.write_text(content, encoding="utf-8")
# 4. 在还原源码中找内部接口与安全逻辑
grep -rniE 'https?://|baseURL|api[_-]?key|secret|token|allowlist|system.?prompt' restored | head -50

内联 source map 的变体:从 bundle 中提取 //# sourceMappingURL=data:application/json;base64,<b64>,base64 解码后按上面的 JSON 逻辑处理,无需额外请求。

变体与关联

  • 变体:VS Code 扩展 .vsix、Electron app.asar、Docker 镜像层、Python wheel/sdist、Maven jar 等发布产物同样可能夹带 .map、source jar 或未编译源码;检查思路一致:先列包内文件,再找调试/源码产物。
  • 变体:私有 registry 或企业 npm 镜像同步了上游 tarball,泄露面从“公网任何人”缩小到“能读镜像的人”,但内部源码同样暴露给低权限开发者或供应链攻击者。
  • 关联:[[pentest-recon-sourcemap-leak-frontend-source-restore-api-discovery]](生产 Web 站点暴露 .map 的前端源码还原与隐藏接口发现)是同一底层机制在部署侧的形态;本卡是其供应链分发侧形态,获取渠道、触发条件与利用场景不同。
  • 关联:[[code-analysis-vuln-discovery-cve-patch-diff-audit]](用 npm tarball 与上游源码比对做补丁审计);本卡提供了从 tarball 内 .map 直接取得“上游源码”的一条捷径。
  • 边界:发布流程已用 files 白名单或删除 *.map、sourcesContent 被剥离、包仅通过不可读私有 registry 分发时,该路径失效;拿到源码本身不等于拿到可利用漏洞,仍需继续做代码审计与授权测试。

检测与防御

  • 检测:发布前执行 npm pack --dry-run 或对生成的 tarball 做 tar -tzf,检查是否含 *.map、*.ts、测试用例、.env 等非运行时文件;对已发布版本定期扫描 registry tarball 中的 .map 与 sourcesContent。
  • 修复:package.json 使用 files 白名单只发布运行所需文件;补充 .npmignore 排除 *.map、dist/**/*.map、源码与测试目录;构建时关闭 source map(tsc sourceMap: false,webpack devtool: false,Vite build.sourcemap: false)。
  • 加固:确实需要 source map 做错误监控时,构建后上传到私有监控平台(如 Sentry)并从发布产物删除;CI 增加“tarball 内不得出现 .map”的阻断规则;发布走可审计的流水线,避免手工 npm publish。
  • 防御:默认把已发布包视为公开代码,不在源码中硬编码密钥、内部域名或敏感提示词;对泄露的旧版本做凭据轮换与攻击面复查。