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 — кроссплатформенный прокси-клиент, который прозрачно перенаправляет TCP- и UDP-трафик определённых приложений в Windows, macOS и Linux через SOCKS5- или HTTP-прокси. Это открытая альтернатива Proxifier.
Он просматривает или расшифровывает мой трафик, как MITM-прокси?Нет. ProxyBridge лишь перенаправляет трафик приложений в SOCKS5- или HTTP-прокси и не просматривает и не изменяет его содержимое. Просмотр и правка трафика — задача его родственного проекта InterceptSuite.
Что нужно моей системе, чтобы его запустить?Windows требует 64-битную Windows 10+ с правами администратора, macOS — версию 13.0+ (Ventura) на ARM или Intel, а Linux — ядро x64 с поддержкой NFQUEUE и 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 — фреймворк Network Extension от Apple, а в Linux — Netfilter NFQUEUE с iptables для перенаправления. Графический интерфейс для Linux написан на GTK3.
Работает ли он с Tor и другими анонимными прокси?Да. В числе поддерживаемых сценариев — направление отдельных приложений через Tor, SOCKS5 или HTTP-прокси, а также анализ трафика приложений, которые сами не поддерживают настройку прокси.
Size
27.9 MB
Stars
6.8K
Age
1y
Commits · 90 Days