Getting Started
Install on Windows
Download and install ProxyBridge on Windows 10 or later: what the installer sets up, how the background service lets the app run without administrator rights, who can use it, how to update and uninstall.
Installing ProxyBridge on Windows
ProxyBridge releases are published on the ProxyBridge GitHub releases page and on the download page.
Requirements: Windows 10 or later, 64-bit (x64). You need an administrator account once, to run the installer. After that, day-to-day use does not need administrator rights.
Download and verify
Download the latest ProxyBridge-Setup-X.X.X.exe.
Each release lists a sha256 checksum for every file. Check the download before you run it. In PowerShell:
Get-FileHash .\ProxyBridge-Setup-X.X.X.exe -Algorithm SHA256
Compare the result with the checksum on the releases page. If it differs, do not run the file.
Run the installer
- Run
ProxyBridge-Setup-X.X.X.exeand approve the administrator (UAC) prompt. - If ProxyBridge is already running, the installer asks before closing it. Choose Yes to close it and continue.
- Follow the wizard and finish. Leave Run ProxyBridge now ticked to start the app straight away.
What the installer does
| Action | Details |
|---|---|
| Copies the program files | C:\Program Files\ProxyBridge: ProxyBridge.exe (the app), ProxyBridge_CLI.exe (command line), ProxyBridgeCore.dll (the engine), ProxyBridgeSvc.exe (the background service), WinDivert.dll and WinDivert64.sys (the packet driver) |
| Installs the ProxyBridge Service | A Windows service that starts with Windows and runs the traffic engine with the privileges it needs |
| Creates the ProxyBridge Users group | A local group that decides who may use the service. The account that ran the installer is added to it |
| Locks the install folder | Only SYSTEM and administrators can change the files, so a normal user cannot swap them for something else |
| Adds shortcuts | Start menu and desktop |
Adds the folder to PATH |
So ProxyBridge_CLI works from any terminal |
The installer does not touch your proxy settings, rules or profiles. They live in your own user folder (see Profiles).
Why the app does not ask for administrator rights
Redirecting traffic needs a kernel driver, and drivers need administrator privileges. Older versions asked for UAC every time you opened the app. Now the privileged part lives in the ProxyBridge Service, and the app you see is an ordinary program that talks to it.
ProxyBridge.exe (normal user) <-- private channel --> ProxyBridgeSvc.exe (service) --> WinDivert driver
What this means for you:
- Opening ProxyBridge does not show a UAC prompt.
- Only members of the ProxyBridge Users group (and administrators) can control the service. Other accounts are refused.
- Before sending anything, the app checks that it is talking to the real ProxyBridge service and not another program using the same channel name.
- The service serves one app window at a time. A second ProxyBridge window, or the CLI, will refuse to start while one is already running.
Letting another Windows account use ProxyBridge
An administrator adds the account to the group, then the person signs out and back in:
net localgroup "ProxyBridge Users" <username> /add
If an account that is not allowed opens ProxyBridge, it shows: "This account is not allowed to use the ProxyBridge service. Ask an administrator to add you to the ProxyBridge Users group, then sign out and in. Run as administrator instead?" Choosing Yes runs ProxyBridge elevated in stand-alone mode, described below.
First start
- Open ProxyBridge from the Start menu (or the desktop shortcut).
- The window title shows the active profile, for example ProxyBridge - Default.
- Continue with the Windows quick start to add a proxy and your first rule.
Stand-alone (portable) mode
If the service is not installed, for example when you copy the program files to a folder yourself, ProxyBridge falls back to loading the engine inside the app. This needs administrator rights, so ProxyBridge asks to restart itself elevated and shows the UAC prompt. The folder must contain ProxyBridge.exe, ProxyBridgeCore.dll, WinDivert.dll and WinDivert64.sys side by side.
Use the installer for normal use. It is the only way to run without UAC prompts.
Updating
- From the app: Help > Check for Updates... shows the new version and its release notes. Update Now downloads the installer, starts it and closes ProxyBridge so the files can be replaced. Later dismisses the message, and Don't Ask Again stops the automatic check at startup (you can still check from the Help menu).
- Manually: download the new installer and run it over the old version. It closes ProxyBridge (after asking), stops the service, replaces the files and starts the service again. Your profiles and settings are kept.
- If the app says "The installed ProxyBridge service is a different version than this program", run the installer again so the app and the service match.
Uninstalling
Use Settings > Apps > Installed apps (or Add or remove programs) and remove ProxyBridge. This removes the service, the packet driver, the ProxyBridge Users group, the shortcuts, the Run at Startup entry and the PATH entry.
Your profiles and settings in %APPDATA%\ProxyBridge are left in place, so a reinstall picks up where you stopped. Delete that folder if you want a completely clean removal.
Next steps
- Windows quick start: add a proxy and route your first app in a few minutes
- Proxy servers
- Proxy rules
- Troubleshooting
