chimurai/http-proxy-middleware
Http Proxy Middleware
This project is a Node.js HTTP reverse proxy middleware designed to route incoming HTTP and WebSocket traffic to target backend services. It functions as a dynamic routing engine and API gateway tool, providing the capability to consolidate multiple backend services behind a single entry point.
The middleware features a WebSocket proxy bridge that manages protocol upgrade handshakes to maintain persistent bidirectional communication. It also includes a request and response transformer used to intercept and modify headers, bodies, and URL paths during transit.
The system provides broad traffic management capabilities, including request filtering via glob matching and path patterns, as well as dynamic request routing. It supports detailed data transformation through path rewriting, cookie attribute adjustment, and request or response body modification.
The project is written in TypeScript.
Features
- HTTP Request Forwarders - Forwards incoming HTTP requests to target backend servers while maintaining headers and body content.
- HTTP Reverse Proxies - Provides a central entry point for Node.js applications to route incoming network traffic to backend microservices.
- API Gateways - Consolidates multiple backend services behind a single interface to manage traffic distribution and request path rewriting.
- Connection Forwarders - Manages persistent bidirectional WebSocket communication by routing protocol upgrade handshakes to backend servers.
- WebSocket Protocol Upgrades - Manages HTTP upgrade handshakes to transparently forward persistent WebSocket connections to backend servers.
- Request Filters - Uses path patterns and glob matching to determine which incoming requests are forwarded to the target.
- HTTP Request Routing - Implements a routing engine to direct network requests to different target servers using path patterns and glob matching.
- Request Routing - Directs network requests to target servers at runtime using path matching and asynchronous logic.
- Node.js Proxy Servers - Implements a Node.js-based proxy server for routing HTTP and WebSocket traffic with customizable transformations.
- Traffic Routing - Directs network requests to multiple backend targets based on path patterns, glob matching, or custom logic.
- WebSocket and Protocol Proxying - Handles protocol upgrade handshakes to maintain persistent bidirectional WebSocket communication between clients and servers.
- Request and Response Transformers - Provides a configurable layer to inject, remove, or rewrite request and response headers and bodies during transit.
- Dynamic Target Selection - Determines the target backend server at runtime by evaluating incoming request paths against patterns or asynchronous logic.
- WebSocket Traffic Routers - Manages persistent bidirectional communication by forwarding real-time WebSocket upgrade handshakes and data streams.
- Request Interception Middleware - Integrates into the server request pipeline to intercept and modify network traffic before it reaches the backend.
- Request Path Rewriters - Transforms outgoing request URLs and incoming redirect headers using regular expressions to align environment paths.
- HTTP Stream Piping - Routes incoming network data directly to target servers using streams to maintain low memory usage.
- Header Rewriters - Intercepts and modifies response headers to change location hostnames, protocols, or cookie domains.
- Proxy Configurations - Provides adjustable settings for SSL verification, timeout thresholds, and header manipulation.
- Proxy Scripting Extensions - Offers a plugin system and event subscription mechanism for adding custom logic to the proxy pipeline.
- Request Header Configuration - Injects or updates HTTP request headers on outgoing calls to ensure correct routing and connectivity.
- Cookie and Redirect Rewriting - Adjusts domain and path settings within set-cookie headers to maintain routing consistency in proxied environments.
- Proxy Lifecycle Hooks - Exposes internal proxy stages as a subscription system to execute custom logic during the request-response lifecycle.
- Body Manipulators - Provides interfaces to intercept and modify the content of HTTP response bodies using raw data buffers.
- Development Proxies - Bypasses CORS restrictions by forwarding local frontend requests to remote backend APIs during development.
- API Gateway Utilities - Acts as a utility for consolidating multiple backend services behind a single entry point to bypass CORS.
- HTTP Clients - Proxy middleware for Express and Connect.
