ProxyBridge

ProxyBridge Documentation

Install ProxyBridge, create rules and route any application through a SOCKS5 or HTTP proxy, whatever its own proxy settings.

Getting Started

5 articles

Configuration

3 articles

Windows Guide

9 articles

Proxy servers (Windows)

Add, edit, test and remove SOCKS5 and HTTP proxy servers in ProxyBridge for Windows. Authentication, DNS handling, the proxy test, and running several proxies at once.

Proxy rules (Windows)

Every field of a ProxyBridge rule on Windows: applications, hosts and domains, ports, protocol, action and localhost handling. How rules are ordered and matched, with worked examples.

Profiles (Windows)

Save, switch, export, import, rename and delete ProxyBridge profiles on Windows. What a profile contains, where the files live, and the .pbprofile format you can share between Windows, macOS and Linux.

Connections, Live Connections and logs (Windows)

See what ProxyBridge is doing on Windows: the Connections log, the Activity Log, the Live Connections table with bytes sent and received, log filters, and the logging settings.

Settings, tray and pausing (Windows)

Pause ProxyBridge without closing it, use the system tray, start it with Windows, change language and text size, and check for updates. A tour of every menu in ProxyBridge for Windows.

Command line (CLI) on Windows

Run a ProxyBridge profile without the window using ProxyBridge_CLI.exe on Windows: options, verbosity levels, examples for scripts and servers, and what the CLI does and does not read from a profile.

Use cases and recipes (Windows)

Worked examples for ProxyBridge on Windows: route a browser through Burp Suite, intercept a desktop app that ignores proxy settings, route one site, split traffic between proxies, block an app, proxy UDP, and watch what a program connects to.

Troubleshooting and limits (Windows)

Fix common ProxyBridge problems on Windows: traffic not going through the proxy, apps that stop connecting, service and permission messages, UDP, QUIC and HTTP/3, localhost, IPv6, plus the limits to know about.

How ProxyBridge works on Windows

What happens to a packet in ProxyBridge for Windows: the WinDivert driver, rule matching, the local relay, the SOCKS5 and HTTP handshake, UDP, domain names, the background service and its security model.

macOS Guide

9 articles

Proxy servers (macOS)

Add, edit, test and remove SOCKS5 and HTTP proxy servers in ProxyBridge for macOS. Authentication, the DNS (send hostname) option, the four-step proxy test, UDP support and running several proxies at once.

Proxy rules (macOS)

Every field of a ProxyBridge rule on macOS: bundle identifiers and process names, hosts and domains, ports, protocol and action. How rules are matched, why UDP rules match on the app only, how wildcard rules behave, and worked examples.

Profiles (macOS)

Save, switch, rename, delete, export and import ProxyBridge profiles on macOS. What a profile contains, where the data is stored, and the .pbprofile format you can edit and run from the command line.

Connections and logs (macOS)

See what ProxyBridge is doing on macOS: the Connections log, the Activity Logs, how lines are produced and how many are kept, searching, the Enable Traffic Logging switch, and what each line means.

Settings, menu bar and updates (macOS)

Every menu in ProxyBridge for macOS: how routing starts and stops, the menu bar icon, Close to Menu Bar, Run at Startup, update checks and installing an update, Documentation and About.

Command line (macOS)

Run a ProxyBridge profile on macOS without the window: the proxybridge command, its options, verbosity levels, output, every error message, the update check, and how to use it from scripts.

Use cases and examples (macOS)

Worked examples for ProxyBridge on macOS: send a browser or desktop app through Burp Suite or mitmproxy, route curl through Tor, split traffic between proxies, block telemetry and QUIC, send everything except some apps, use it as a connection monitor, and run without a window.

Troubleshooting and limits (macOS)

Fix common ProxyBridge problems on macOS: the extension needs approval, nothing in Connections, a rule does not match, domain rules, proxy errors, UDP and HTTP/3, DNS and VPN conflicts. Includes every message you may see and the known limits.

How ProxyBridge works on macOS

How the macOS version redirects connections with a Network Extension: what the app and the system extension each do, how TCP, UDP and DNS are handled, how rules are matched, what is stored where, and the security model.

Linux Guide

9 articles

Proxy servers (Linux)

Add, edit, test and remove SOCKS5 and HTTP proxy servers in ProxyBridge for Linux. Authentication, the default proxy, DNS via proxy, the proxy test with its five steps, and running several proxies at once.

Proxy rules (Linux)

Every field of a ProxyBridge rule on Linux: program names and paths, hosts and domains, ports, protocol, action and localhost handling. How rules are ordered and matched, what is always direct, and worked examples.

Profiles (Linux)

Save, switch, duplicate, export, import, rename and delete ProxyBridge profiles on Linux. What a profile contains, where the files live, and the .pbprofile format you can share between Linux, Windows and macOS.

Connections, Live Connections and logs (Linux)

See what ProxyBridge is doing on Linux: the Connections log, the Activity Logs, the Live Connections table with bytes sent and received, log filters, and the logging settings.

Settings, pausing and start at boot (Linux)

Every menu in ProxyBridge for Linux: pause and resume, start and stop the engine, the ProxyBridge service, Start at Boot, text size, update checks, Documentation and About.

Command line (Linux)

Run ProxyBridge on Linux without a window: the ProxyBridge command, its options, verbosity levels, output, error messages, update check, and how to use it from systemd, scripts and CI.

Use cases and examples (Linux)

Worked examples for ProxyBridge on Linux: send a browser or desktop app through Burp Suite or mitmproxy, route curl through Tor, split traffic between proxies, block telemetry, test QUIC and HTTP/3, run in CI or at boot.

Troubleshooting and limits (Linux)

Fix common ProxyBridge problems on Linux: it will not start, a rule does not match, domain rules, UDP and HTTP/3, proxy errors, containers and WSL. Includes every message you may see and the known limits.

How ProxyBridge works on Linux

How the Linux version redirects connections with eBPF: what the kernel decides, what the relay does, how UDP, DNS and domain rules work, what happens when ProxyBridge stops, and the security model.

Guides

1 articles