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…

这是什么?ProxyBridge 是一款跨平台代理客户端,可以把特定 Windows、macOS 或 Linux 应用的 TCP 和 UDP 流量透明地转发到 SOCKS5 或 HTTP 代理上,是 Proxifier 的开源替代品。
它会像 MITM 代理那样检查或解密我的流量吗?不会。ProxyBridge 只把应用流量转发到 SOCKS5 或 HTTP 代理,不会查看或修改其内容。检查和编辑流量是其姊妹项目 InterceptSuite 的工作。
运行它需要我的系统满足什么条件?Windows 需要 64 位 Windows 10 及以上版本并具有管理员权限;macOS 需要 13.0 及以上版本(Ventura),支持 ARM 或 Intel 架构;Linux 需要支持 NFQUEUE 的 x64 内核以及 iptables。
安装时有哪些需要注意的陷阱?有。已发现有假冒 ProxyBridge 的下载网站捆绑恶意软件,因此只应从官方 GitHub 仓库或 interceptsuite.com 安装;社区提供的 winget 包不是官方版本,且可能已过时。
到底谁会用它?安全研究人员和测试人员。他们需要在不修改目标应用的前提下,强制让不支持代理的应用(如游戏、桌面客户端、数据库、RDP 或 SSH 工具)通过 Burp Suite、Tor 或 InterceptSuite 等工具联网。
ProxyBridge 会把我的流量或数据发送到任何地方吗?不会。除了自身的更新检查源,它不会连接任何外部服务器,而且该检查只在应用启动或手动检查更新时运行。
按应用划分的路由规则是如何工作的?规则可以针对特定进程、IP、端口、协议(TCP/UDP)以及支持通配符的主机名,让你把每个应用路由到代理、完全阻止,或允许其直连;规则集可以以 JSON 格式导入和导出。
InterceptSuite 是什么?它和 ProxyBridge 有什么关系?InterceptSuite 是同一团队开发的完整 MITM SOCKS5 代理,可以检查并实时编辑 TLS、TCP 和 UDP 流量。将 ProxyBridge 指向它,就能查看并修改 ProxyBridge 正在转发的内容。
每个操作系统上是什么在实际拦截数据包?Windows 使用 WinDivert 内核驱动,macOS 使用 Apple 的 Network Extension 框架,Linux 则使用 Netfilter NFQUEUE 配合 iptables 进行重定向;Linux 图形界面基于 GTK3 构建。
它能与 Tor 或其他匿名代理一起使用吗?可以。其列出的使用场景包括通过 Tor、SOCKS5 或 HTTP 代理转发特定应用的流量,以及分析本身不支持代理设置的应用的流量。
Size
27.8 MB
Stars
6.8K
Age
1y
Commits · 90 Days