ProxyBridge README

The project's README from github.com/InterceptSuite/ProxyBridge. As one markdown file: README.md.

ProxyBridge

ProxyBridge Logo

Build Windows Build macOS Build Linux Total Downloads

InterceptSuite%2FProxyBridge | Trendshift   InterceptSuite%2FProxyBridge | Trendshift

ProxyBridge is a lightweight, open-source universal proxy client (Proxifier alternative) that provides transparent proxy routing for applications on Windows, macOS, and Linux. It redirects TCP and UDP traffic from specific processes through SOCKS5 or HTTP proxies, with the ability to route, block, or allow traffic on a per-application basis. ProxyBridge fully supports both TCP and UDP proxy routing and works at the system level, making it compatible with proxy-unaware applications without requiring any configuration changes.

[!TIP] ProxyBridge routes your traffic - InterceptSuite lets you see inside it. Full MITM proxy with SSL/TLS inspection, live request editing, scripting, and support for TCP, UDP, StartTLS, DTLS and more. Built by the same team. Try InterceptSuite →

Table of Contents

💖 Support ProxyBridge Development
If you find ProxyBridge useful, consider sponsoring to support ongoing development and new features!

Sponsor InterceptSuite

Download

🌐 Official Download Portal

Visit our Official Download Page for the latest automated builds and platform detection.

📦 Release Packages

Platform Download Link Package Type System Requirements
Windows Download Installer .exe Windows 10+ (64-bit), Admin privileges
macOS Download Installer .pkg (Universal) macOS 13.0+ ARM/x64 (Ventura or later)
Linux Download Tarball .tar.gz x64 Kernel with NFQUEUE support

Linux One-Command Quick Install:

curl -Lo deploy.sh https://raw.githubusercontent.com/InterceptSuite/ProxyBridge/refs/heads/master/Linux/deploy.sh && sudo bash deploy.sh

macOS via Homebrew (official):

brew install --cask proxybridge

Windows via winget:

winget install InterceptSuite.ProxyBridge

[!WARNING] The winget package is community-maintained and not official. It may lag behind releases or be unverified. For guaranteed-latest, verified builds always use the Official Download Page.

[!NOTE] For historical versions, change logs, and direct access to raw assets, visit the GitHub Releases page.

Features

[!CAUTION] Beware of Fake ProxyBridge Downloads

Multiple fake ProxyBridge download sources have been identified. Some of these sources distribute unwanted binaries and malicious software.

❌ Do NOT download ProxyBridge from any third-party or unofficial sources.

✅ Official ProxyBridge sources (only):

If you prefer not to use prebuilt binaries, you may safely build ProxyBridge yourself by following the Contribution Guide and compiling directly from the official source code.

ProxyBridge does not communicate with any external servers except its own update feed at https://download.interceptsuite.com/proxybridge.json for update checks (triggered only on app launch or manual update checks);

Documentation

[!IMPORTANT] 📖 Full Documentation

Everything you need to get started and go deep:

  • Installation and setup guides
  • Proxy rules and rule configuration
  • CLI reference
  • UDP, IPv6, HTTP/3, DTLS setup
  • Troubleshooting and advanced usage

interceptsuite.com/docs/proxybridge

Screenshots

macOS

ProxyBridge macOS Main Interface
ProxyBridge GUI - Main Interface

Proxy Settings macOS
Proxy Settings Configuration

Proxy Rules macOS
Proxy Rules Management

Add/Edit Rule macOS
Add/Edit Proxy Rule

Windows

GUI

ProxyBridge Windows Main Interface
ProxyBridge GUI - Main Interface

Proxy Settings
Proxy Settings Configuration

Proxy Rules
Proxy Rules Management

Proxy Tester
Proxy Tester

CLI

ProxyBridge CLI
ProxyBridge CLI Interface

Linux

GUI

ProxyBridge Linux Main Interface
ProxyBridge GUI - Main Interface

Proxy Settings Linux
Proxy Settings Configuration

Proxy Rules Linux
Proxy Rules Management

Add/Edit Rule Linux
Add/Edit Proxy Rule

CLI

ProxyBridge Linux CLI
ProxyBridge CLI Interface

Use Cases

InterceptSuite

ProxyBridge is a proxy client - it routes your application traffic through any SOCKS5 or HTTP proxy. It does not inspect or modify the traffic itself.

InterceptSuite is a MITM SOCKS5 proxy server built for traffic interception and analysis. Point ProxyBridge at InterceptSuite and you can inspect everything:

ProxyBridge routes the traffic in. InterceptSuite sees inside it.

Try InterceptSuite →

License

MIT License - See LICENSE file for details

Author

Sourav Kalal / InterceptSuite

Credits

Windows Implementation: This project is built on top of WinDivert by basil00. WinDivert is a powerful Windows packet capture and manipulation library that makes kernel-level packet interception possible. Special thanks to the WinDivert project for providing such a robust foundation.

Based on the StreamDump example from WinDivert: https://reqrypt.org/samples/streamdump.html

The Windows GUI and CLI are written in native C using the Win32 API, keeping the footprint small and startup instant.

macOS Implementation: Built using Apple's Network Extension framework for transparent proxy capabilities on macOS.

Linux Implementation: Built using Linux Netfilter NFQUEUE for kernel-level packet interception and iptables for traffic redirection. The GUI uses GTK3 for native Linux desktop integration.

ProxyBridge (InterceptSuite/ProxyBridge)

Searching Database…

What is this?ProxyBridge is a cross-platform proxy client that transparently redirects TCP and UDP traffic from specific Windows/macOS/Linux applications through SOCKS5 or HTTP proxies, acting as an open-source alternative to Proxifier.
Does it inspect or decrypt my traffic like a MITM proxy would?No. ProxyBridge only reroutes application traffic into a SOCKS5 or HTTP proxy; it does not look at or modify the contents. Inspecting and editing traffic is the job of its sibling project, InterceptSuite.
What does my system need to run it?Windows needs 64-bit Windows 10+ with admin privileges, macOS needs 13.0+ (Ventura) on ARM or Intel, and Linux needs an x64 kernel with NFQUEUE support plus iptables.
Any install pitfalls to watch out for?Yes — fake ProxyBridge download sites bundling malware have been found, so only install from the official GitHub repo or interceptsuite.com, and treat the community winget package as unofficial/possibly outdated.
Who would actually use this?Security researchers and testers who need to force proxy-unaware apps (games, desktop clients, databases, RDP/SSH tools) through tools like Burp Suite, Tor, or InterceptSuite without modifying the target application.
Does ProxyBridge send my traffic or data anywhere?No, it does not contact any external servers except its own update-check feed, which only runs on app launch or manual update checks.
How do the per-application routing rules work?Rules target specific processes, IPs, ports, protocols (TCP/UDP) and hostnames with wildcard support, letting you route each app to a proxy, block it entirely, or allow it direct access; rule sets can be imported and exported as JSON.
What is InterceptSuite and how does it relate to ProxyBridge?InterceptSuite is a full MITM SOCKS5 proxy from the same team that can inspect and live-edit TLS/TCP/UDP traffic; pointing ProxyBridge at it lets you see and modify what ProxyBridge is routing.
What's actually doing the packet interception on each OS?Windows uses the WinDivert kernel driver, macOS uses Apple's Network Extension framework, and Linux uses Netfilter NFQUEUE with iptables for redirection; the Linux GUI is built with GTK3.
Does it work with Tor or other anonymity proxies?Yes, the listed use cases include routing specific applications through Tor, SOCKS5, or HTTP proxies as well as analyzing traffic from apps that don't natively support proxy settings.
Size
27.8 MB
Stars
6.8K
Age
1y
Commits · 90 Days