Forwarder Proxy #

Forwarder is a production-ready, fast MITM proxy with PAC support. It’s suitable for debugging, intercepting and manipulating HTTP traffic. It’s used as a core component of Sauce Labs Sauce Connect Proxy. It is a forward proxy, which means it proxies traffic from clients to servers (e.g. browsers to websites), and supports CONNECT requests. It can proxy:

• HTTP/HTTPS/HTTP2 requests
• WebSockets (both HTTP and HTTPS)
• Server Sent Events (SSE)
• TCP traffic (e.g. SMTP, IMAP, etc.)

Features #

• Supports upstream HTTP(S) and SOCKS5 proxies
• Supports PAC files for upstream proxy configuration
• Supports MITM for HTTPS traffic with automatic certificate generation
• Supports custom DNS servers
• Supports augmenting requests and responses with headers
• Supports basic authentication, for websites and proxies

Running #

See the Install instructions for your platform or use the Docker image. When you have Forwarder installed, you can run it with the following command:

• forwarder run - Start HTTP (forward) proxy server
• forwarder pac eval - Evaluate a PAC file for given URL (or URLs)
• forwarder pac server - Start HTTP server that serves a PAC file
• forwarder ready - Readiness probe for the Forwarder

Asking for help #

If you have any questions about Forwarder, please feel free to ask them on the Forwarder Discussions page.