How chimurai/http-proxy-middleware works
http-proxy-middleware is a Node.js HTTP/WebSocket proxy middleware with Connect/Express-style and Hono entry points. A host server invokes the middleware; it filters requests, chooses and normalizes a target, rewrites the path, then delegates proxying to httpxy. Plugins and response/request helpers support error handling, events, logging, and body or response manipulation. Edges reflect the sampled middleware implementation, SOURCE INDEX references, and README capabilities; unsampled integrations are represented only where documented.
Main entry points: http-proxy-middleware.ts Proxy middleware · get-plugins.ts Plugin selection · index.ts Public API · factory.ts Middleware factory
Components 20
Server integrations
- Public API
src/index.ts - Middleware factory
src/factory.ts - Hono adapter
src/factory-hono.ts
Request preparation
- Path filter
src/path-filter.ts - Target router
src/router.ts - Path rewriter
src/path-rewriter.ts - IPv6 normalization
src/utils/ipv6.ts
Proxy execution
- Proxy middleware
src/http-proxy-middleware.ts - Proxy engine
Hooks and helpers
- Request body repair
src/handlers/fix-request-body.ts - Form-data serializer
src/handlers/fix-request-body-utils/stringify-form-data.ts - Response interceptor
src/handlers/response-interceptor.ts - Plugin selection
src/get-plugins.ts - Proxy event hooks
src/plugins/default/proxy-events.ts - Proxy error diagnostics
src/plugins/default/debug-proxy-errors-plugin.ts - Error responses
src/plugins/default/error-response-plugin.ts - Request logging
src/plugins/default/logger-plugin.ts - Logger utility
src/logger.ts
Other components
- Node server
- Upstream service
Connections 20
- Node server → Public API: mounts middleware
README.md - Public API → Middleware factory: exports factory
src/index.ts - Public API → Hono adapter: exports Hono entry
src/factory-hono.ts - Middleware factory → Proxy middleware: constructs
src/factory.ts - Hono adapter → Proxy middleware: adapts requests
src/factory-hono.ts - Proxy middleware → Path filter: checks paths
src/http-proxy-middleware.ts - Proxy middleware → Target router: selects target
src/http-proxy-middleware.ts - Proxy middleware → IPv6 normalization: normalizes target
src/http-proxy-middleware.ts - Proxy middleware → Path rewriter: rewrites path
src/http-proxy-middleware.ts - Proxy middleware → Proxy engine: proxies HTTP and WebSocket
src/http-proxy-middleware.ts - Proxy engine → Upstream service: forwards traffic
README.md - Request body repair → Form-data serializer: serializes form data
src/handlers/fix-request-body.ts - Plugin selection → Proxy error diagnostics: selects default plugins
src/get-plugins.ts - Plugin selection → Error responses: selects default plugins
src/get-plugins.ts - Plugin selection → Request logging: selects default plugins
src/get-plugins.ts - Plugin selection → Proxy event hooks: selects default plugins
- Proxy middleware → Plugin selection: registers plugins
src/http-proxy-middleware.ts - Request logging → Logger utility: gets logger
src/plugins/default/logger-plugin.ts - Proxy middleware → Response interceptor: supports response hooks
README.md - Proxy error diagnostics → Request body repair: recommends repair helper
src/plugins/default/debug-proxy-errors-plugin.ts