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关闭时不带;webpackdevtool: 'source-map'常带;需实际下载确认)。 - 包可从公共 registry、企业镜像或可读的私有 registry 获取。
利用步骤
- 取得 tarball URL 并下载:
npm view <pkg> dist.tarball后curl -L,或用npm pack <pkg>@<version>;优先直接下载 registry tarball,避免在本地执行包内prepare/postinstall脚本。 - 解包并枚举
.map:tar -tzf pkg.tgz | grep -i '\.map$';同时检查 bundle 末尾是否有//# sourceMappingURL=或内联的data:application/json;base64,...。 - 解析 map 的
sources/sourcesContent,确认是否带原始文件内容;带内容则直接写盘还原目录树。 - 在还原源码中检索
api、baseURL、http、token、secret、prompt、permission、allowlist、process.env等关键词,整理内部接口、配置与安全逻辑。 - 对源码中暴露的端点与参数做后续授权/鉴权测试;把源码版本与公开版本对齐,用于补丁差异和漏洞挖掘。
- 若
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、Electronapp.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(tscsourceMap: false,webpackdevtool: false,Vitebuild.sourcemap: false)。 - 加固:确实需要 source map 做错误监控时,构建后上传到私有监控平台(如 Sentry)并从发布产物删除;CI 增加“tarball 内不得出现
.map”的阻断规则;发布走可审计的流水线,避免手工npm publish。 - 防御:默认把已发布包视为公开代码,不在源码中硬编码密钥、内部域名或敏感提示词;对泄露的旧版本做凭据轮换与攻击面复查。