NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #1571 most downloaded on npm
The one-liner node.js proxy middleware for connect, express, next.js and more
Latest stable
4.2.2
Last release 7 days ago
15 Nov 2026
Ships unpredictably
gaps range from 8 days to 12 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
114 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
ci(github-actions): update actions by @chimurai in #1317
Full Changelog: v4.2.1...v4.2.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
test(HTTP QUERY): add tests for HTTP QUERY method (RFC 10008) by @chimurai in #1277
Full Changelog: v4.2.0...v4.2.1
feat(types): export OnProxyEvent type by @Netail in #1263
Full Changelog: v4.1.1...v4.2.0
fix(fixRequestBody): harden form-data stringification by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1260
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.1.0...v4.1.1
docs(MIGRATION.md): restore MIGRATION.md by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1226
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0...v4.1.0
test(ws): on error event with unreachable websocket target by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1243
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.1.0-beta.1...v4.1.0-beta.2
docs(MIGRATION.md): restore MIGRATION.md by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1226
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0...v4.1.0-beta.1
ESM-only package [BREAKING CHANGE] 💣 http-proxy-middleware now ships as native ES modules only. CommonJS require() usage is no longer supported, so im…
Switched proxy from http-proxy to httpxy ✨ (https://github.com/chimurai/http-proxy-middleware/pull/1160)
This replaces a long-standing core dependency and brings in many upstream fixes and behavior improvements documented by the httpxy project: https://github.com/unjs/httpxy/issues/2
ESM-only package [BREAKING CHANGE] 💣
http-proxy-middleware now ships as native ES modules only. CommonJS require() usage is no longer supported, so imports should use ESM syntax.
Updated Node.js support policy [BREAKING CHANGE] 💣 Dropped Node.js 14, 16, 18, and 20. New minimum supported runtime is Node.js 22.15.0
Removed legacyCreateProxyMiddleware() [BREAKING CHANGE] 💣
The legacy compatibility wrapper has been removed as part of API cleanup. Use createProxyMiddleware() directly.
Added IPv6 literal support ✨
target and forward now support literal IPv6 URLs, for example: http://[::1]:3000.
Experimental Hono support 🧪
Added createHonoProxyMiddleware() for Hono apps, including dedicated subpath support via http-proxy-middleware/hono.
Many thanks to everyone who helped make this release possible. 🙏
node: protocol imports by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1127http-proxy w/ httpxy by @SukkaW in https://github.com/chimurai/http-proxy-middleware/pull/1160Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.5...v4.0.0
target and forward options (ie. "http://[::1]:8000")chore(package.json): remove patch-package by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1217
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.5...v4.0.0-beta.6
ci(github-actions): upgrade streetsidesoftware/cspell-action to v8 by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1211
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.4...v4.0.0-beta.5
chore(eslint): @typescript-eslint/consistent-type-imports by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1195
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.3...v4.0.0-beta.4
chore(package.json): bump dependencies by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1189
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.2...v4.0.0-beta.3
chore: remove legacyCreateProxyMiddleware() [BREAKING CHANGE] by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1175
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.0...v4.0.0-beta.2
chore(deps): fix punycode node deprecation warning by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1109
node: protocol imports by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1127http-proxy w/ httpxy by @SukkaW in https://github.com/chimurai/http-proxy-middleware/pull/1160Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.5...v4.0.0-beta.0
fix(htt-proxy-middleware): harden ws upgrade() by @chimurai in #1329
Full Changelog: v3.0.10...v3.0.11
ci(github-actions): bump actions by @chimurai in #1305
Full Changelog: v3.0.7...v3.0.10
fix(fixRequestBody): harden form-data stringification by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1259
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.6...v3.0.7
chore(deps): fix punycode node deprecation warning by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1109
node: protocol imports by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1127Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.5...v3.0.6
fix(fixRequestBody): check readableLength by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1096
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.4...v3.0.5
chore(package): bump dev dependencies by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1045
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.3...v3.0.4
fix(pathFilter): handle errors by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1043
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.2...v3.0.3
chore(vscode): fix eslint setting by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1030
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.1...v3.0.2
docs(responseInterceptor): fix header manipulation example by @mcgwiz in https://github.com/chimurai/http-proxy-middleware/pull/967
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.0...v3.0.1
docs(examples): move example dependencies from root by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/994
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.1-beta.0...v3.0.1-beta.1
docs(responseInterceptor): fix header manipulation example by @mcgwiz in https://github.com/chimurai/http-proxy-middleware/pull/967
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.0...v3.0.1-beta.0
Read the v3 in Discussions or MIGRATION.md to see what the breaking changes are and how you can migrate them.
Read the v3 in Discussions or MIGRATION.md to see what the breaking changes are and how you can migrate them.
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.4...v3.0.0
This release contains some breaking changes.
Please read the V3 discussion https://github.com/chimurai/http-proxy-middleware/discussions/768 or follow the MIGRATION_V3.md guide.
test(mockttp): fix deprecated functions by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/772
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.0-beta.0...v3.0.0-beta.1
refactor: logging [BREAKING CHANGE]
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.4...v3.0.0-beta.0
fix(htt-proxy-middleware): harden ws upgrade() by @chimurai in #1328
Full Changelog: v2.0.11...v2.0.12
fix(fixRequestBody): wait for request stream to end by @chimurai in #1309
Full Changelog: v2.0.10...v2.0.11
fix: harden proxy-table matching to prevent routing bypass by @G-Rath in #1268
fix: harden proxy-table matching to prevent routing bypass by @G-Rath in https://github.com/chimurai/http-proxy-middleware/pull/1268
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.9...v2.0.10-beta.0
v2.0.10-beta.0 Pre-release
Pre-release
Compare
fix(fixRequestBody): check readableLength by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1097
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.8...v2.0.9
fix(fixRequestBody): prevent multiple .write() calls by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1090
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.7...v2.0.8
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.6...v2.0.7
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.6...v2.0.7
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.7-beta.0...v2.0.7-beta.1
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.7-beta.0...v2.0.7-beta.1
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.6...v2.0.7-beta.0
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.6...v2.0.7-beta.0
fix(proxyReqWs): catch socket errors by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/763
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.5...v2.0.6
fix(error handler): add default handler to econnreset by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/759
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.4...v2.0.5
chore(package): bump dev dependencies by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/714
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.3...v2.0.4
feat(package): optional @types/express peer dependency by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/707
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.2...v2.0.3
chore(package): bump devDependencies by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/651
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.1...v2.0.2
https://github.com/chimurai/http-proxy-middleware/compare/v2.0.0...v2.0.1
https://github.com/chimurai/http-proxy-middleware/compare/v2.0.0...v2.0.1
chore(package): drop node 10 [BREAKING CHANGE]
https://github.com/chimurai/http-proxy-middleware/compare/v1.3.1...v2.0.0
https://github.com/chimurai/http-proxy-middleware/compare/v1.3.0...v1.3.1
https://github.com/chimurai/http-proxy-middleware/compare/v1.2.1...v1.3.0
https://github.com/chimurai/http-proxy-middleware/compare/v1.2.0...v1.2.1
https://github.com/chimurai/http-proxy-middleware/compare/v1.2.0...v1.2.1
Nothing published for this version
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.2...v1.2.0
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.2...v1.2.0
Nothing published for this version
Nothing published for this version
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.1...v1.1.2
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.1...v1.1.2
Nothing published for this version
Nothing published for this version
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.0...v1.1.1
Nothing published for this version
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.6...v1.1.0
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.6...v1.1.0
Removing lodash reduced the bundle size by more than 50% (source: bundlephobia.com):
Before lodash removal: 133.2 kB MINIFIED 45.6 kB MINIFIED + GZIPPED
After lodash removal: 65.6 kB MINIFIED 22.4 kB MINIFIED + GZIPPED
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.5...v1.0.6
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.5...v1.0.6
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.4...v1.0.5
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.4...v1.0.5
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.3...v1.0.4
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.3...v1.0.4
One column per quarter.