Skip to content

Force Proxy to any Windows/MacOS/Linux Application TCP and UDP traffic

Refactor Windows build workflow and update documentation for native C implementation

AnoF-Cyber36766cf90031
diff --git a/.github/workflows/build-windows.yml b/.github/workflows/build-windows.yml
index e8e3364..d733172 100644
--- a/.github/workflows/build-windows.yml
+++ b/.github/workflows/build-windows.yml
@@ -21,9 +21,6 @@ jobs:
- name: Checkout code
uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
- # No .NET or MSVC setup action needed - the GUI/CLI/core are native C built with cl.exe,
- # which compile.ps1 auto-detects via vswhere.exe (pre-installed on windows-latest runners).
-
- name: Install NSIS
run: |
choco install nsis -y
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b6d0f16..5377aaf 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -49,17 +49,26 @@ Feature suggestions are welcome! Please provide:
### Pull Requests
-**IMPORTANT: Before Creating a Pull Request**
-
-1. **Create a GitHub Issue First**
- - If you want to fix a bug or add a new feature, **create a GitHub issue first**
- - This allows us to track and confirm whether:
- - The feature is already implemented in our development branch
- - We plan to include that feature (some features may not align with project goals)
- - Your pull request will be accepted before you invest time coding
- - If a GitHub issue already exists for the bug/feature you want to work on:
- - Comment on the existing issue mentioning you plan to fix it
- - **Do NOT create a duplicate issue**
+**IMPORTANT: Open an Issue and WAIT for a Reply Before You Start Coding**
+
+Please read this carefully - it is the most common source of wasted effort.
+
+1. **Create a GitHub Issue First - then wait for maintainer confirmation**
+ - Before writing **any** code, **open a GitHub issue** describing the bug you want to fix or the feature you want to add.
+ - **Then stop and wait for a maintainer to reply.** Do **not** start coding, and do **not** open a pull request yet.
+ - The whole point of the issue is to let us tell you *before you invest time* whether:
+ - The feature/fix is **already implemented** in the `dev` branch (not yet released, so you can't see it).
+ - It is **already being worked on** by someone else or by us right now.
+ - It **doesn't align** with the project's goals and would be declined regardless of quality.
+ - Only once a maintainer confirms it's not already done / in progress and that it fits the project should you fork, code, and open a PR.
+
+ > [!WARNING]
+ > **Opening an issue and a pull request at the same time defeats the purpose.**
+ > Several contributors have forked, built a feature, opened a brand-new issue, and immediately opened a PR for it in one go. By then the work is already done - so if the feature was already implemented, already in progress, or out of scope, **your effort is wasted and the PR will be closed.** The issue exists so we can catch that *beforehand*. Please wait for our reply on the issue before you build anything.
+
+ - If a GitHub issue for the bug/feature **already exists**:
+ - Comment on it saying you'd like to work on it and wait for a maintainer to assign it / give the go-ahead.
+ - **Do NOT create a duplicate issue.**
2. **Fork the `dev` Branch**
- **Always fork and create pull requests against the `dev` branch**
@@ -91,8 +100,7 @@ Feature suggestions are welcome! Please provide:
### Windows
**Prerequisites:**
-- Visual Studio 2022 or later (with C++ tools)
-- .NET 10.0 SDK
+- Visual Studio 2022 or later (with the "Desktop development with C++" workload) - the core DLL, CLI and GUI are all native C built with `cl.exe`
- PowerShell 5.1 or later
- Git
- **WinDivert 2.2.2-A** - Download from: https://www.reqrypt.org/windivert.html
@@ -139,28 +147,27 @@ Test-Path C:\WinDivert-2.2.2-A\include\windivert.h
**What compile.ps1 Does:**
1. Compiles `ProxyBridgeCore.dll` from C source code (using MSVC or GCC)
2. Copies WinDivert runtime files (`WinDivert.dll`, `WinDivert64.sys`, `WinDivert32.sys`)
-3. Publishes GUI app (`ProxyBridge.exe`) with .NET single-file deployment
-4. Publishes CLI app (`ProxyBridge_CLI.exe`) as single executable
+3. Builds the native C GUI (`ProxyBridge.exe`) with `cl.exe`
+4. Builds the native C CLI (`ProxyBridge_CLI.exe`) as a single executable
5. Optionally signs all binaries (requires code signing certificate)
-6. Builds NSIS installer (`ProxyBridge-Setup-3.1.0.exe`) if NSIS is installed
+6. Builds NSIS installer (`ProxyBridge-Setup-4.0.10-Beta.exe`) if NSIS is installed
**Output:**
All compiled files are placed in `Windows/output/` directory:
- `ProxyBridgeCore.dll` - Native C library
-- `ProxyBridge.exe` - GUI application
-- `ProxyBridge_CLI.exe` - CLI application
+- `ProxyBridge.exe` - Native C GUI application
+- `ProxyBridge_CLI.exe` - Native C CLI application
- `WinDivert.dll`, `WinDivert64.sys` - WinDivert files
-- `ProxyBridge-Setup-3.1.0.exe` - Installer (if NSIS installed)
-- Additional .NET runtime DLLs
+- `ProxyBridge-Setup-4.0.10-Beta.exe` - Installer (if NSIS installed)
**Project Structure:**
- `Windows/src/` - C library core (ProxyBridge.c, ProxyBridge.h)
- `ProxyBridge.c` - Main packet interception logic
- Uses WinDivert for kernel-level packet capture
-- `Windows/gui/` - Avalonia GUI (.NET 10.0)
- - GUI application using Avalonia UI framework
-- `Windows/cli/` - Command-line interface (.NET 10.0)
- - CLI application for headless operation
+- `Windows/gui/` - Native C (Win32) GUI application
+ - `main.c` - entry point and main window; `ui/`, `api/`, `loc/`, `profile/`, `res/` subfolders
+- `Windows/cli/` - Native C command-line interface
+ - `main.c` - CLI application for headless operation
- `Windows/installer/` - NSIS installer script
- `ProxyBridge.nsi` - Installer configuration
- `Windows/compile.ps1` - Build script
@@ -456,43 +463,17 @@ static bool check_proxy_rules(const char *process, uint32_t dest_ip,
- Free allocated memory
- Use meaningful variable names
-### C# (Windows GUI/CLI)
+### C (Windows GUI/CLI)
-```csharp
-// Follow .NET naming conventions
-public class ProxySettingsViewModel : ViewModelBase
-{
- private string _proxyHost = "127.0.0.1";
-
- // Properties use PascalCase
- public string ProxyHost
- {
- get => _proxyHost;
- set => this.RaiseAndSetIfChanged(ref _proxyHost, value);
- }
-
- // Methods use PascalCase
- public async Task SaveSettingsAsync()
- {
- // Use meaningful names
- var settings = new ProxySettings
- {
- ProxyHost = ProxyHost,
- ProxyPort = ProxyPort
- };
-
- await _configManager.SaveAsync(settings);
- }
-}
-```
+The Windows GUI and CLI are native C built against the Win32 API - the same standards as the core apply.
**Standards:**
-- Use 4 spaces for indentation
-- Follow C# naming conventions (PascalCase for public, camelCase for private)
-- Use `async/await` for asynchronous operations
-- Handle exceptions appropriately
-- Use `using` statements for IDisposable
-- Add XML documentation comments for public APIs
+- Use 4 spaces for indentation (no tabs)
+- Maximum line length: 100 characters
+- Always use braces for if/while/for blocks
+- Use the **secure CRT** variants (`_snwprintf_s`, `strcpy_s`, `strncpy_s`, ...) - the banned unbounded functions are rejected in review
+- Free every allocation; guard against double-free and leaks (the GUI is long-running)
+- Keep the build warning-clean under `/W4`
### Swift (macOS)
diff --git a/README.md b/README.md
index a7ddb2d..dcc8768 100644
--- a/README.md
+++ b/README.md
@@ -113,7 +113,7 @@ winget install InterceptSuite.ProxyBridge
>
> 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 the GitHub API for update checks (triggered only on app launch or manual update checks);
+> 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);
@@ -270,7 +270,7 @@ This project is built on top of [WinDivert](https://reqrypt.org/windivert.html)
Based on the StreamDump example from WinDivert:
https://reqrypt.org/samples/streamdump.html
-The Windows GUI is built using [Avalonia UI](https://avaloniaui.net/) - a cross-platform XAML-based UI framework for .NET, enabling a modern and responsive user interface.
+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.
diff --git a/SECURITY.md b/SECURITY.md
index 0fb265e..a03f436 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -6,11 +6,11 @@ We actively support the following versions of ProxyBridge with security updates:
| Version | Supported | Platform |
| ------- | ------------------ | -------- |
-| 3.1.x | :white_check_mark: | Windows, macOS |
-| 3.0.x | :x: | Windows, macOS |
+| 4.0.x | :white_check_mark: | Windows, macOS, Linux |
+| 3.x | :x: | Windows, macOS |
| < 3.0 | :x: | All |
-**Note:** Only the latest minor version (3.1.x) receives security updates. Please upgrade to the latest version to ensure you have all security fixes.
+**Note:** Only the latest release line (4.0.x) receives security updates. Please upgrade to the latest version to ensure you have all security fixes.
## Reporting a Vulnerability
@@ -68,8 +68,8 @@ ProxyBridge operates with the following security considerations:
#### Windows Architecture
- **Three Components:**
- **ProxyBridgeCore.dll** - Native C library for packet interception (WinDivert-based)
- - **ProxyBridge.exe** - Avalonia-based GUI application (.NET 10.0)
- - **ProxyBridge_CLI.exe** - Command-line interface application (.NET 10.0)
+ - **ProxyBridge.exe** - Native C (Win32) GUI application
+ - **ProxyBridge_CLI.exe** - Native C command-line interface application
- **Requires Administrator privileges** to install and run WinDivert kernel driver
- **Kernel-level packet interception** via WinDivert.sys driver
- **Local TCP relay server** runs on port 34010 (127.0.0.1 only)
@@ -126,8 +126,6 @@ ProxyBridge operates with the following security considerations:
5. **Third-party Dependencies:**
- **Windows:**
- WinDivert 2.x (kernel driver + userspace library) - trusted, open-source
- - Avalonia UI 11.x framework
- - .NET 10.0 runtime
- **macOS:**
- Apple NetworkExtension framework (system component)
- Swift standard library
@@ -231,6 +229,6 @@ We thank the security research community for helping keep ProxyBridge secure. Sp
---
-**Last Updated:** January 2026
+**Last Updated:** July 2026
Thank you for helping keep ProxyBridge and our users safe! 🛡️
diff --git a/Windows/README.md b/Windows/README.md
index e524735..4155b30 100644
--- a/Windows/README.md
+++ b/Windows/README.md
@@ -404,7 +404,6 @@ Case 2: Packet match with proxy rule
- Administrator privileges (required for WinDivert driver)
- Visual Studio 2019 or later (MSVC - recommended) **or** MinGW-w64 (GCC)
- WinDivert 2.2.2-A or later
-- .NET 10 SDK (for the GUI)
### Using the PowerShell Build Script (Recommended)
diff --git a/Windows/gui/main.c b/Windows/gui/main.c
index df73c99..6b5525f 100644
--- a/Windows/gui/main.c
+++ b/Windows/gui/main.c
@@ -986,7 +986,7 @@ int WINAPI wWinMain(HINSTANCE hInst, HINSTANCE hPrev, PWSTR cmd, int show)
UpdateTitle();
// Wire callbacks + toggles, add configs (before Start so the UDP relay starts), start,
- // then add rules - mirroring the C# startup order.
+ // then add rules.
g_api.SetLocalhostViaProxy(g_localhost);
g_api.SetTrafficLoggingEnabled(g_trafficLog);
g_api.SetLogCallback(PBLogCb);