Skip to content

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

test(windows): e2e - real installer, service, Live Connections counters, permissions and app

AnoF-Cyber1f9b3d01ceed
diff --git a/.github/workflows/build-windows.yml b/.github/workflows/build-windows.yml
index ac8a2b1..660f71a 100644
--- a/.github/workflows/build-windows.yml
+++ b/.github/workflows/build-windows.yml
@@ -110,6 +110,18 @@ jobs:
.\tests\e2e\run_e2e.ps1 -PbDir .\output
shell: pwsh
+ # The same idea for the parts around the engine: it runs the real installer, the ProxyBridge Service, the app's own
+ # client code (Live Connections, pause, logging switches, rule changes, permissions), the real app and the real
+ # uninstaller. It installs ProxyBridge on the runner, so it runs after the step above. Best effort, same reasons.
+ # See Windows\tests\e2e\run_e2e_service.ps1.
+ - name: Real-traffic end-to-end tests, installer and service (best effort)
+ continue-on-error: true
+ timeout-minutes: 25
+ run: |
+ cd Windows
+ .\tests\e2e\run_e2e_service.ps1 -PbDir .\output
+ shell: pwsh
+
- name: Upload end-to-end logs
if: always()
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
@@ -120,6 +132,9 @@ jobs:
Windows/tests/e2e/out/*.err
Windows/tests/e2e/out/*.out
Windows/tests/e2e/out/*.pbprofile
+ Windows/tests/e2e/out_service/*.log
+ Windows/tests/e2e/out_service/*.err
+ Windows/tests/e2e/out_service/*.out
if-no-files-found: ignore
retention-days: 7
diff --git a/.gitignore b/.gitignore
index 163d43c..e942a8d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -133,6 +133,7 @@ Windows/**/*.res
Windows/tests/out/
Windows/tests/e2e/out/
+Windows/tests/e2e/out_service/
# the end-to-end test helper is a script we ship
!Windows/tests/e2e/*.py
diff --git a/Windows/tests/e2e/e2e_common.ps1 b/Windows/tests/e2e/e2e_common.ps1
new file mode 100644
index 0000000..84ea408
--- /dev/null
+++ b/Windows/tests/e2e/e2e_common.ps1
@@ -0,0 +1,88 @@
+# e2e_common.ps1 - helpers shared by run_e2e.ps1 (the engine through the CLI) and run_e2e_service.ps1 (installer, service, app).
+# Dot-source it AFTER $Out (a fresh output folder) and $bin (a folder inside it) exist. It downloads the pinned Nexus Proxy,
+# patches its UDP part, and defines: Start-Bg, Wait-Port, Count, Check, Skip, New-Client, Invoke-Curl, Has-Body, Get-Ok,
+# plus $procs (processes to stop at the end), $results (the checks), $node and $python.
+
+# ---- the real SOCKS5 proxy: Nexus Proxy, pinned to a commit and checked against its hash
+$nexusSha = '3b7ffe3b78400ae4a4e6f1ba7cbe5c689023f23a'
+$nexusHash = 'D20D00364FD4344D333760DF74053CAB85070960590A54559DDA8AD5B7B07E4B'
+$nexusJs = Join-Path $Out 'nexus.js'
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/InterceptSuite/nexus-proxy/$nexusSha/script.js" -OutFile $nexusJs -UseBasicParsing
+if ((Get-FileHash $nexusJs -Algorithm SHA256).Hash -ne $nexusHash) { Write-Host "nexus.js hash mismatch" -ForegroundColor Red; exit 2 }
+
+# Stock Nexus cannot do UDP ASSOCIATE with current Node.js: its relay socket is IPv6 (dual-stack) but is bound to the IPv4
+# address '0.0.0.0', which Node rejects, so it answers "general failure". The Linux suite carries the same fix as a patch
+# (Linux/tests/nexus-linux-udp.patch). It only changes the UDP part of the test proxy, never ProxyBridge. Each edit must
+# match exactly once, so a new Nexus version cannot silently slip through unpatched.
+$nx = [IO.File]::ReadAllText($nexusJs)
+$edits = @(
+ @("udpRelay.bind(0, '0.0.0.0', () => {", "udpRelay.bind(0, '::', () => {"),
+ @("udpRelay.send(data, port, host);", "udpRelay.send(data, port, host.includes(':') ? host : '::ffff:' + host);"),
+ @("handleRemoteToClient(msg, rinfo, udpRelay, remoteMap) {", "handleRemoteToClient(msg, rinfo, udpRelay, remoteMap) {`n rinfo = { ...rinfo, address: rinfo.address.replace(/^::ffff:/i, '') };")
+)
+foreach ($e in $edits) {
+ $n = ([regex]::Matches($nx, [regex]::Escape($e[0]))).Count
+ if ($n -ne 1) { Write-Host "Nexus UDP patch: expected one match of '$($e[0])', found $n" -ForegroundColor Red; exit 2 }
+ $nx = $nx.Replace($e[0], $e[1])
+}
+$nexusJs = Join-Path $Out 'nexus-udp.js'
+[IO.File]::WriteAllText($nexusJs, $nx)
+$node = (Get-Command node -ErrorAction Stop).Source
+$python = (Get-Command python -ErrorAction Stop).Source
+
+
+$procs = New-Object System.Collections.Generic.List[object]
+function Start-Bg($exe, $argv, $log) {
+ $p = Start-Process -FilePath $exe -ArgumentList $argv -RedirectStandardOutput $log -RedirectStandardError "$log.err" -PassThru -WindowStyle Hidden
+ $procs.Add($p); return $p
+}
+function Wait-Port([int]$port, [int]$seconds) {
+ $end = (Get-Date).AddSeconds($seconds)
+ while ((Get-Date) -lt $end) {
+ try { $c = New-Object Net.Sockets.TcpClient; $c.Connect('127.0.0.1', $port); $c.Close(); return $true } catch { Start-Sleep -Milliseconds 300 }
+ }
+ return $false
+}
+function Count([string]$file, [string]$text) {
+ # read with sharing: the proxy that writes the log still has it open
+ if (-not (Test-Path $file)) { return 0 }
+ try {
+ $fs = [IO.File]::Open($file, 'Open', 'Read', 'ReadWrite')
+ $sr = New-Object IO.StreamReader($fs); $t = $sr.ReadToEnd(); $sr.Close()
+ } catch { return 0 }
+ return ([regex]::Matches($t, [regex]::Escape($text))).Count
+}
+
+$results = New-Object System.Collections.Generic.List[object]
+function Check([string]$name, [bool]$ok, [string]$detail = '') {
+ $results.Add([pscustomobject]@{ Test = $name; Result = $(if ($ok) { 'PASS' } else { 'FAIL' }); Detail = $detail })
+ Write-Host (" {0} {1}{2}" -f $(if ($ok) { 'PASS' } else { 'FAIL' }), $name, $(if (-not $ok -and $detail) { " ($detail)" } else { '' }))
+}
+
+function Skip([string]$name, [string]$why) {
+ $results.Add([pscustomobject]@{ Test = $name; Result = 'SKIP'; Detail = $why })
+ Write-Host (" SKIP {0} ({1})" -f $name, $why)
+}
+
+# a test client: a copy of a real program under a name of our own, so a rule can match it alone
+function New-Client([string]$name, [string]$source = "$env:SystemRoot\System32\curl.exe") {
+ $p = Join-Path $bin "$name.exe"; Copy-Item $source $p; return $p
+}
+# one request; returns the exit code, the HTTP status and the file the body went to
+function Invoke-Curl([string]$exe, [string]$url, [string[]]$extra = @(), [int]$maxTime = 25, [string]$outFile = '') {
+ $bodyFile = if ($outFile) { $outFile } else { Join-Path $Out ("body_{0}.bin" -f [guid]::NewGuid().ToString('N').Substring(0, 8)) }
+ $a = @('-s', '-S', '-o', $bodyFile, '-w', '%{http_code}', '--max-time', "$maxTime", '--connect-timeout', '15') + $extra + @($url)
+ $status = (& $exe @a 2>&1 | Out-String).Trim()
+ return [pscustomobject]@{ Exit = $LASTEXITCODE; Status = $status; Body = $bodyFile }
+}
+function Has-Body($r, [string]$text) { (Test-Path $r.Body) -and ((Get-Content $r.Body -Raw -ErrorAction SilentlyContinue) -match [regex]::Escape($text)) }
+# expect success: tries twice because the internet is not ours
+function Get-Ok([string]$exe, [string]$url, [string]$needle, [string[]]$extra = @()) {
+ for ($i = 0; $i -lt 2; $i++) {
+ $r = Invoke-Curl $exe $url $extra
+ if ($r.Exit -eq 0 -and $r.Status -match '^[23]' -and (Has-Body $r $needle)) { return $r }
+ Start-Sleep -Seconds 2
+ }
+ return $r
+}
+
diff --git a/Windows/tests/e2e/run_e2e.ps1 b/Windows/tests/e2e/run_e2e.ps1
index d7a4b30..1c8bb6a 100644
--- a/Windows/tests/e2e/run_e2e.ps1
+++ b/Windows/tests/e2e/run_e2e.ps1
@@ -44,91 +44,11 @@ New-Item -ItemType Directory -Path $Out | Out-Null
$Out = (Resolve-Path $Out).Path
$bin = Join-Path $Out 'bin'; New-Item -ItemType Directory -Path $bin | Out-Null
-# ---- the real SOCKS5 proxy: Nexus Proxy, pinned to a commit and checked against its hash
-$nexusSha = '3b7ffe3b78400ae4a4e6f1ba7cbe5c689023f23a'
-$nexusHash = 'D20D00364FD4344D333760DF74053CAB85070960590A54559DDA8AD5B7B07E4B'
-$nexusJs = Join-Path $Out 'nexus.js'
-Invoke-WebRequest -Uri "https://raw.githubusercontent.com/InterceptSuite/nexus-proxy/$nexusSha/script.js" -OutFile $nexusJs -UseBasicParsing
-if ((Get-FileHash $nexusJs -Algorithm SHA256).Hash -ne $nexusHash) { Write-Host "nexus.js hash mismatch" -ForegroundColor Red; exit 2 }
-
-# Stock Nexus cannot do UDP ASSOCIATE with current Node.js: its relay socket is IPv6 (dual-stack) but is bound to the IPv4
-# address '0.0.0.0', which Node rejects, so it answers "general failure". The Linux suite carries the same fix as a patch
-# (Linux/tests/nexus-linux-udp.patch). It only changes the UDP part of the test proxy, never ProxyBridge. Each edit must
-# match exactly once, so a new Nexus version cannot silently slip through unpatched.
-$nx = [IO.File]::ReadAllText($nexusJs)
-$edits = @(
- @("udpRelay.bind(0, '0.0.0.0', () => {", "udpRelay.bind(0, '::', () => {"),
- @("udpRelay.send(data, port, host);", "udpRelay.send(data, port, host.includes(':') ? host : '::ffff:' + host);"),
- @("handleRemoteToClient(msg, rinfo, udpRelay, remoteMap) {", "handleRemoteToClient(msg, rinfo, udpRelay, remoteMap) {`n rinfo = { ...rinfo, address: rinfo.address.replace(/^::ffff:/i, '') };")
-)
-foreach ($e in $edits) {
- $n = ([regex]::Matches($nx, [regex]::Escape($e[0]))).Count
- if ($n -ne 1) { Write-Host "Nexus UDP patch: expected one match of '$($e[0])', found $n" -ForegroundColor Red; exit 2 }
- $nx = $nx.Replace($e[0], $e[1])
-}
-$nexusJs = Join-Path $Out 'nexus-udp.js'
-[IO.File]::WriteAllText($nexusJs, $nx)
-$node = (Get-Command node -ErrorAction Stop).Source
-$python = (Get-Command python -ErrorAction Stop).Source
+. (Join-Path $PSScriptRoot 'e2e_common.ps1')
$PORT_OPEN = 31080; $PORT_AUTH = 31081; $PORT_HTTP = 33128; $PORT_MID = 31082; $PORT_DEAD = 31999 # nothing listens on the last one
$logOpen = Join-Path $Out 'nexus-open.log'; $logAuth = Join-Path $Out 'nexus-auth.log'; $logHttp = Join-Path $Out 'http-proxy.log'; $logMid = Join-Path $Out 'nexus-mid.log'
-$procs = New-Object System.Collections.Generic.List[object]
-function Start-Bg($exe, $argv, $log) {
- $p = Start-Process -FilePath $exe -ArgumentList $argv -RedirectStandardOutput $log -RedirectStandardError "$log.err" -PassThru -WindowStyle Hidden
- $procs.Add($p); return $p
-}
-function Wait-Port([int]$port, [int]$seconds) {
- $end = (Get-Date).AddSeconds($seconds)
- while ((Get-Date) -lt $end) {
- try { $c = New-Object Net.Sockets.TcpClient; $c.Connect('127.0.0.1', $port); $c.Close(); return $true } catch { Start-Sleep -Milliseconds 300 }
- }
- return $false
-}
-function Count([string]$file, [string]$text) {
- # read with sharing: the proxy that writes the log still has it open
- if (-not (Test-Path $file)) { return 0 }
- try {
- $fs = [IO.File]::Open($file, 'Open', 'Read', 'ReadWrite')
- $sr = New-Object IO.StreamReader($fs); $t = $sr.ReadToEnd(); $sr.Close()
- } catch { return 0 }
- return ([regex]::Matches($t, [regex]::Escape($text))).Count
-}
-
-$results = New-Object System.Collections.Generic.List[object]
-function Check([string]$name, [bool]$ok, [string]$detail = '') {
- $results.Add([pscustomobject]@{ Test = $name; Result = $(if ($ok) { 'PASS' } else { 'FAIL' }); Detail = $detail })
- Write-Host (" {0} {1}{2}" -f $(if ($ok) { 'PASS' } else { 'FAIL' }), $name, $(if (-not $ok -and $detail) { " ($detail)" } else { '' }))
-}
-
-function Skip([string]$name, [string]$why) {
- $results.Add([pscustomobject]@{ Test = $name; Result = 'SKIP'; Detail = $why })
- Write-Host (" SKIP {0} ({1})" -f $name, $why)
-}
-
-# a test client: a copy of a real program under a name of our own, so a rule can match it alone
-function New-Client([string]$name, [string]$source = "$env:SystemRoot\System32\curl.exe") {
- $p = Join-Path $bin "$name.exe"; Copy-Item $source $p; return $p
-}
-# one request; returns the exit code, the HTTP status and the file the body went to
-function Invoke-Curl([string]$exe, [string]$url, [string[]]$extra = @(), [int]$maxTime = 25, [string]$outFile = '') {
- $bodyFile = if ($outFile) { $outFile } else { Join-Path $Out ("body_{0}.bin" -f [guid]::NewGuid().ToString('N').Substring(0, 8)) }
- $a = @('-s', '-S', '-o', $bodyFile, '-w', '%{http_code}', '--max-time', "$maxTime", '--connect-timeout', '15') + $extra + @($url)
- $status = (& $exe @a 2>&1 | Out-String).Trim()
- return [pscustomobject]@{ Exit = $LASTEXITCODE; Status = $status; Body = $bodyFile }
-}
-function Has-Body($r, [string]$text) { (Test-Path $r.Body) -and ((Get-Content $r.Body -Raw -ErrorAction SilentlyContinue) -match [regex]::Escape($text)) }
-# expect success: tries twice because the internet is not ours
-function Get-Ok([string]$exe, [string]$url, [string]$needle, [string[]]$extra = @()) {
- for ($i = 0; $i -lt 2; $i++) {
- $r = Invoke-Curl $exe $url $extra
- if ($r.Exit -eq 0 -and $r.Status -match '^[23]' -and (Has-Body $r $needle)) { return $r }
- Start-Sleep -Seconds 2
- }
- return $r
-}
-
try {
# ---- proxies
Write-Host "`n=== starting proxies" -ForegroundColor Cyan
diff --git a/Windows/tests/e2e/run_e2e_service.ps1 b/Windows/tests/e2e/run_e2e_service.ps1
new file mode 100644
index 0000000..904062a
--- /dev/null
+++ b/Windows/tests/e2e/run_e2e_service.ps1
@@ -0,0 +1,405 @@
+<#
+.SYNOPSIS
+ Real end-to-end test of the way people actually use ProxyBridge for Windows: the real installer, the ProxyBridge Service
+ (LocalSystem, named pipe), the same client library the app uses, the Live Connections data, the permissions around the
+ service, the real app (ProxyBridge.exe) applying a profile, and the real uninstaller.
+
+.DESCRIPTION
+ run_e2e.ps1 tests the engine through the CLI. This one tests everything around it that the CLI never touches:
+
+ installer silent install: files, service (auto start), "ProxyBridge Users" group, folder permissions, PATH, shortcuts
+ permissions a user outside the group is DENIED, a member can connect (needs a temporary local user; SKIP if not possible)
+ service path proxies, rules, start/stop, pause, Log Every Connection, traffic logging, rule enable/disable/move/delete,
+ a second client (BUSY), a client that dies (the engine is released), with real traffic
+ live data Live Connections: process, proxy, rule, destination, and sent/received compared with the real transfer
+ the app ProxyBridge.exe started with a profile applies it to the service and the traffic follows
+ uninstaller service, group, driver, files and PATH are really gone
+
+ It INSTALLS SOFTWARE, LOADS THE KERNEL DRIVER and creates a local user. It is meant for a disposable CI runner (the
+ "Real-traffic end-to-end tests, installer and service" step of build-windows.yml) and refuses to run elsewhere unless
+ -IKnowThisLoadsTheKernelDriver is given.
+
+.PARAMETER PbDir Folder with the compile.ps1 output (ProxyBridge-Setup-*.exe).
+.PARAMETER Out Where logs and test files go.
+#>
+param(
+ [string]$PbDir = (Join-Path $PSScriptRoot '..\..\output'),
+ [string]$Out = (Join-Path $PSScriptRoot 'out_service'),
+ [switch]$IKnowThisLoadsTheKernelDriver
+)
+$ErrorActionPreference = 'Stop'
+
+if ($env:GITHUB_ACTIONS -ne 'true' -and -not $IKnowThisLoadsTheKernelDriver) {
+ Write-Host "This test installs ProxyBridge, loads the WinDivert kernel driver and creates a local user. It is for a CI runner." -ForegroundColor Yellow
+ Write-Host "Run it on a throw-away VM with -IKnowThisLoadsTheKernelDriver if you really mean to." -ForegroundColor Yellow
+ exit 2
+}
+$id = [Security.Principal.WindowsIdentity]::GetCurrent()
+if (-not (New-Object Security.Principal.WindowsPrincipal($id)).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
+ Write-Host "Administrator rights are required (installer, service, driver)." -ForegroundColor Red; exit 2
+}
+
+$PbDir = (Resolve-Path $PbDir).Path
+$setup = Get-ChildItem -Path $PbDir -Filter 'ProxyBridge-Setup-*.exe' -ErrorAction SilentlyContinue | Select-Object -First 1
+if (-not $setup) { Write-Host "No ProxyBridge-Setup-*.exe in $PbDir" -ForegroundColor Red; exit 2 }
+if (Get-Service ProxyBridgeSvc -ErrorAction SilentlyContinue) { Write-Host "ProxyBridge is already installed here; this test needs a clean machine." -ForegroundColor Red; exit 2 }
+
+if (Test-Path $Out) { [IO.Directory]::Delete($Out, $true) }
+New-Item -ItemType Directory -Path $Out | Out-Null
+$Out = (Resolve-Path $Out).Path
+$bin = Join-Path $Out 'bin'; New-Item -ItemType Directory -Path $bin | Out-Null
+
+. (Join-Path $PSScriptRoot 'e2e_common.ps1')
+
+$PORT_OPEN = 31080; $PORT_HTTP = 33128
+$logOpen = Join-Path $Out 'nexus-open.log'; $logHttp = Join-Path $Out 'http-proxy.log'
+$inst = Join-Path $env:ProgramFiles 'ProxyBridge'
+$testUser = 'pbe_user'
+$publicDir = 'C:\Users\Public\pbe'
+$driver = $null; $gui = $null; $uninstalled = $false
+
+# ---- the helper that talks to the service like the app does (built from the app's own client code)
+Write-Host "`n=== building the service test client" -ForegroundColor Cyan
+$vcvars = $null
+$vsWhere = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe"
+if (Test-Path $vsWhere) {
+ $vsPath = & $vsWhere -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath
+ if ($vsPath) { $c = Join-Path $vsPath 'VC\Auxiliary\Build\vcvarsall.bat'; if (Test-Path $c) { $vcvars = $c } }
+}
+$svcClient = Join-Path $bin 'svc_client.exe'
+$bat = Join-Path $Out 'build_client.bat'
+$lines = @('@echo off'); if ($vcvars) { $lines += "call `"$vcvars`" x64 >nul" }
+$lines += "cd /d `"$PSScriptRoot`""
+$lines += "cl /nologo /W3 /wd4996 /D_CRT_SECURE_NO_WARNINGS svc_client.c /Fo:`"$bin\\`" /Fe:`"$svcClient`" /link user32.lib advapi32.lib"
+Set-Content -Path $bat -Value $lines -Encoding ASCII
+$buildLog = & cmd /c "`"$bat`" 2>&1"
+if (-not (Test-Path $svcClient)) { Write-Host ($buildLog -join "`n"); Write-Host "svc_client.exe did not build" -ForegroundColor Red; exit 2 }
+Write-Host "svc_client.exe built"
+
+# ---- a small driver for the helper: send a line, read the answer; events are kept on the side
+Add-Type -TypeDefinition @'
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Threading;
+public class SvcDrv {
+ Process p; readonly object L = new object();
+ List<string> replies = new List<string>(); List<string> events = new List<string>(); int ri = 0;
+ public SvcDrv(string exe) {
+ var psi = new ProcessStartInfo(exe) { UseShellExecute = false, RedirectStandardInput = true, RedirectStandardOutput = true, CreateNoWindow = true };
+ p = Process.Start(psi);
+ p.OutputDataReceived += (s, e) => { if (e.Data == null) return; lock (L) { if (e.Data.StartsWith("EVT\t")) events.Add(e.Data); else replies.Add(e.Data); } };
+ p.BeginOutputReadLine();
+ }
+ string Next(int ms) {
+ var end = DateTime.UtcNow.AddMilliseconds(ms);
+ while (DateTime.UtcNow < end) {
+ lock (L) { if (ri < replies.Count) return replies[ri++]; }
+ if (p.HasExited) { lock (L) { if (ri < replies.Count) return replies[ri++]; } return null; }
+ Thread.Sleep(20);
+ }
+ return null;
+ }
+ public string First(int ms) { return Next(ms); }
+ public string[] Cmd(string c, int ms) {
+ p.StandardInput.WriteLine(c); p.StandardInput.Flush();
+ var o = new List<string>(); string l;
+ while ((l = Next(ms)) != null) { o.Add(l); if (!c.StartsWith("flows") || l.StartsWith("END\t")) break; }
+ return o.ToArray();
+ }
+ public string[] Events() { lock (L) { return events.ToArray(); } }
+ public bool Exited { get { return p.HasExited; } }
+ public int Pid { get { return p.Id; } }
+ public void Kill() { try { p.Kill(); } catch { } }
+ public void Quit() { try { p.StandardInput.WriteLine("quit"); p.StandardInput.Flush(); p.WaitForExit(5000); } catch { } }
+}
+'@
+
+function Svc([string]$cmd, [int]$ms = 20000) { $r = $script:driver.Cmd($cmd, $ms); return $r }
+function Svc-Id([string]$cmd) { $r = Svc $cmd; if ($r.Count -ge 1 -and $r[0] -match "^OK`t(\d+)$") { return [int]$Matches[1] }; return 0 }
+function Svc-Ok([string]$cmd) { $r = Svc $cmd; return ($r.Count -ge 1 -and $r[0] -like 'OK*') }
+function Get-Flows {
+ $out = @()
+ foreach ($l in (Svc 'flows')) {
+ $f = $l -split "`t"
+ if ($f[0] -eq 'FLOW' -and $f.Count -ge 13) {
+ $out += [pscustomobject]@{ Id = [uint64]$f[1]; Pid = [int]$f[2]; Udp = $f[3] -eq '1'; V6 = $f[4] -eq '1'; Host = $f[5]; Port = [int]$f[6]
+ Sent = [uint64]$f[7]; Received = [uint64]$f[8]; Name = $f[9]; Rule = [int]$f[10]; Proxy = [int]$f[11]; AgeMs = [uint64]$f[12] }
+ }
+ }
+ return $out
+}
+function Conn-Events([string]$proc) { @($script:driver.Events() | Where-Object { $_ -match "^EVT`tCONN`t[^`t]*$([regex]::Escape($proc))`t" }).Count }
+function Probe([string]$exe = $svcClient) { ((& $exe --probe 2>&1 | Out-String).Trim() -split "`n")[0].Trim() }
+
+function Via-Open([string]$label, [string]$client, [string]$url = 'http://example.com/') {
+ $before = Count $logOpen '[CONNECT]'
+ $r = Get-Ok $client $url 'Example Domain'
+ Check $label ($r.Exit -eq 0 -and (Has-Body $r 'Example Domain') -and (Count $logOpen '[CONNECT]') -gt $before) "exit $($r.Exit) status $($r.Status)"
+}
+function Direct-Open([string]$label, [string]$client, [string]$url = 'http://example.com/') {
+ $before = Count $logOpen '[CONNECT]'
+ $r = Get-Ok $client $url 'Example Domain'
+ Check $label ($r.Exit -eq 0 -and (Has-Body $r 'Example Domain') -and (Count $logOpen '[CONNECT]') -eq $before) "exit $($r.Exit) status $($r.Status)"
+}
+
+try {
+ # ======================= installer =======================
+ Write-Host "`n=== silent install" -ForegroundColor Cyan
+ $p = Start-Process -FilePath $setup.FullName -ArgumentList '/S' -PassThru -Wait
+ Check 'Installer finishes silently' ($p.ExitCode -eq 0) "exit code $($p.ExitCode)"
+ $svc = Get-Service ProxyBridgeSvc -ErrorAction SilentlyContinue
+ for ($i = 0; $i -lt 30 -and $svc -and $svc.Status -ne 'Running'; $i++) { Start-Sleep -Seconds 1; $svc.Refresh() }
+ Check 'Installed files: app, CLI, engine, service, driver, uninstaller' (@('ProxyBridge.exe', 'ProxyBridge_CLI.exe', 'ProxyBridgeCore.dll', 'ProxyBridgeSvc.exe', 'WinDivert.dll', 'WinDivert64.sys', 'uninst.exe' |
+ Where-Object { -not (Test-Path (Join-Path $inst $_)) }).Count -eq 0) "folder $inst"
+ Check 'The ProxyBridge Service exists and is running' ($svc -and $svc.Status -eq 'Running') "status $(if ($svc) { $svc.Status } else { 'missing' })"
+ Check 'The service starts with Windows (automatic)' ((& sc.exe qc ProxyBridgeSvc | Out-String) -match 'AUTO_START')
+ Check 'The "ProxyBridge Users" group exists' ((& net.exe localgroup 'ProxyBridge Users' 2>&1 | Out-String) -match 'ProxyBridge Users')
+ $usersLine = @(& icacls.exe $inst) | Where-Object { $_ -match 'BUILTIN\\Users:' } | Select-Object -First 1
+ Check 'Install folder: ordinary users can read and run, not modify' ($usersLine -match '\(RX\)' -and $usersLine -notmatch '\((F|M|W)\)') "$usersLine"
+ Check 'The install folder is on the machine PATH' (([Environment]::GetEnvironmentVariable('Path', 'Machine') -split ';') -contains $inst)
+ $lnk = @("$env:APPDATA\Microsoft\Windows\Start Menu\Programs\ProxyBridge\ProxyBridge.lnk", "$env:ProgramData\Microsoft\Windows\Start Menu\Programs\ProxyBridge\ProxyBridge.lnk") | Where-Object { Test-Path $_ }
+ Check 'Start Menu shortcut exists' ([bool]$lnk)
+ Check 'The installed CLI starts (--help)' ((& (Join-Path $inst 'ProxyBridge_CLI.exe') --help 2>&1 | Out-String) -match 'ProxyBridge')
+
+ # ======================= proxies and clients =======================
+ Write-Host "`n=== starting proxies" -ForegroundColor Cyan
+ Start-Bg $node @($nexusJs, '--port', "$PORT_OPEN", '--verbose') $logOpen | Out-Null
+ Start-Bg $python @((Join-Path $PSScriptRoot 'http_proxy.py'), '--port', "$PORT_HTTP", '--log', $logHttp) "$Out\http-proxy.out" | Out-Null
+ foreach ($pt in $PORT_OPEN, $PORT_HTTP) { if (-not (Wait-Port $pt 20)) { Write-Host "proxy on port $pt did not start" -ForegroundColor Red; exit 2 } }
+ $names = 'svc', 'http', 'block', 'flow', 'order', 'nomatch', 'gui', 'after'
+ $exe = @{}; foreach ($n in $names) { $exe[$n] = New-Client "pbe_$n" }
+ $bigUrl = 'https://speed.cloudflare.com/__down?bytes=26214400'; $bigSize = 26214400
+
+ # ======================= who may use the service =======================
+ Write-Host "`n=== permissions" -ForegroundColor Cyan
+ $userReady = $false
+ try {
+ $pw = 'Pbe-' + [guid]::NewGuid().ToString('N').Substring(0, 12) + '!aA1'
+ New-LocalUser -Name $testUser -Password (ConvertTo-SecureString $pw -AsPlainText -Force) -AccountNeverExpires | Out-Null
+ New-Item -ItemType Directory -Path $publicDir -Force | Out-Null
+ Copy-Item $svcClient (Join-Path $publicDir 'svc_client.exe')
+ $cred = New-Object Management.Automation.PSCredential(".\$testUser", (ConvertTo-SecureString $pw -AsPlainText -Force))
+ $userReady = $true
+ } catch { Skip 'Permissions: a user outside the group is refused' "could not create a local test user: $($_.Exception.Message)" }
+ if ($userReady) {
+ function Probe-As {
+ $o = Join-Path $publicDir 'probe.txt'; if (Test-Path $o) { Remove-Item $o -Force }
+ Start-Process -FilePath (Join-Path $publicDir 'svc_client.exe') -ArgumentList '--probe' -Credential $cred -WorkingDirectory $publicDir `
+ -RedirectStandardOutput $o -NoNewWindow -Wait -ErrorAction Stop
+ if (Test-Path $o) { return ((Get-Content $o -Raw).Trim() -split "`n")[0].Trim() }; return ''
+ }
+ try {
+ $a = Probe-As
+ Check 'A normal user who is not in "ProxyBridge Users" is refused (DENIED)' ($a -match 'DENIED') "answer: $a"
+ Add-LocalGroupMember -Group 'ProxyBridge Users' -Member $testUser
+ $a = Probe-As
+ Check 'The same user can connect once added to "ProxyBridge Users"' ($a -eq 'CONNECTED') "answer: $a"
+ } catch { Skip 'Permissions: refused outside the group, allowed inside' "could not start a process as the test user: $($_.Exception.Message)" }
+ }
+ Check 'An administrator can connect' ((Probe) -eq 'CONNECTED')
+
+ # ======================= the service path with real traffic =======================
+ Write-Host "`n=== connect, add proxies and rules, start" -ForegroundColor Cyan
+ $driver = New-Object SvcDrv($svcClient)
+ $first = $driver.First(20000)
+ Check 'The client connects to the service' ($first -eq 'CONNECTED') "answer: $first"
+ if ($first -ne 'CONNECTED') { throw 'cannot continue without a connection to the service' }
+ $pA = Svc-Id "proxy`tsocks5`t127.0.0.1`t$PORT_OPEN`t-`t-`t1"
+ $pB = Svc-Id "proxy`thttp`t127.0.0.1`t$PORT_HTTP`t-`t-`t1"
+ Check 'Two proxy servers are added through the service' ($pA -gt 0 -and $pB -gt 0 -and $pA -ne $pB) "ids $pA, $pB"
+ $rS = Svc-Id "rule`tpbe_svc.exe`t*`t*`t*`ttcp`tproxy`t$pA`t0"
+ $rH = Svc-Id "rule`tpbe_http.exe`t*`t*`t*`ttcp`tproxy`t$pB`t0"
+ $rB = Svc-Id "rule`tpbe_block.exe`t*`t*`t*`ttcp`tblock`t0`t0"
+ $rF = Svc-Id "rule`tpbe_flow.exe`t*`t*`t*`ttcp`tproxy`t$pA`t0"
+ $rO1 = Svc-Id "rule`tpbe_order.exe`t*`t*`t*`ttcp`tproxy`t$pA`t0"
+ $rO2 = Svc-Id "rule`tpbe_order.exe`t*`t*`t*`ttcp`tdirect`t0`t0"
+ Check 'Rules are added through the service' (($rS, $rH, $rB, $rF, $rO1, $rO2 | Where-Object { $_ -le 0 }).Count -eq 0) "ids $rS $rH $rB $rF $rO1 $rO2"
+ Check 'Rules keep the order they were added in' ((Svc-Id "rulepos`t$rO1") -lt (Svc-Id "rulepos`t$rO2"))
+ Check 'The engine starts' (Svc-Ok 'start')
+ $null = Svc-Ok "logall`t0"
+ if (-not (Wait-Port 34010 30)) { throw 'the relay did not come up' }
+ Start-Sleep -Seconds 2
+
+ Write-Host "`n=== real traffic through the service-driven engine" -ForegroundColor Cyan
+ Via-Open 'Proxy rule: the page comes back through the SOCKS5 proxy' $exe.svc
+ $bh = Count $logHttp '[CONNECT]'
+ $r = Get-Ok $exe.http 'http://example.com/' 'Example Domain'
+ Check 'A second rule sends another program through the HTTP proxy' ($r.Exit -eq 0 -and (Has-Body $r 'Example Domain') -and (Count $logHttp '[CONNECT]') -gt $bh)
+ $r = Invoke-Curl $exe.block 'http://example.com/' @() 10
+ Check 'Block rule: the connection fails' ($r.Exit -ne 0 -and -not (Has-Body $r 'Example Domain'))
+
+ # ---- Live Connections: who, which proxy, which rule, and real byte counts
+ Write-Host "`n=== Live Connections against a real, rate-limited transfer" -ForegroundColor Cyan
+ $flowFile = Join-Path $Out 'flow.bin'; $httpFile = Join-Path $Out 'flow_http.bin'
+ $cf = Start-Process -FilePath $exe.flow -ArgumentList @('-s', '-S', '-o', $flowFile, '--limit-rate', '1M', '--max-time', '100', '--connect-timeout', '15', $bigUrl) -PassThru -WindowStyle Hidden
+ $ch = Start-Process -FilePath $exe.http -ArgumentList @('-s', '-S', '-o', $httpFile, '--limit-rate', '300k', '--max-time', '60', '--connect-timeout', '15', $bigUrl) -PassThru -WindowStyle Hidden
+ $mine = $null; $other = $null
+ for ($i = 0; $i -lt 40 -and (-not $mine -or -not $other); $i++) {
+ Start-Sleep -Milliseconds 500
+ $fl = Get-Flows
+ $mine = $fl | Where-Object { $_.Pid -eq $cf.Id -and -not $_.Udp } | Select-Object -First 1
+ $other = $fl | Where-Object { $_.Pid -eq $ch.Id -and -not $_.Udp } | Select-Object -First 1
+ }
+ if ($mine) {
+ Check 'Live Connections lists the program with its real name and process id' ($mine.Name -eq 'pbe_flow.exe') "name '$($mine.Name)' pid $($mine.Pid)"
+ Check 'Live Connections shows the destination (host and port)' ($mine.Port -eq 443 -and $mine.Host -match 'cloudflare|\d+\.\d+\.\d+\.\d+') "$($mine.Host):$($mine.Port)"
+ Check 'Live Connections shows which proxy server this connection goes to' ($mine.Proxy -eq $pA) "proxy id $($mine.Proxy), expected $pA"
+ Check 'Live Connections shows which rule matched' ($mine.Rule -eq $rF) "rule id $($mine.Rule), expected $rF"
+ } else { foreach ($t in 'name and process id', 'destination', 'proxy server', 'matching rule') { Check "Live Connections shows the $t" $false 'the transfer never appeared in the list' } }
+ if ($other) {
+ Check 'A program on another rule shows the other proxy and rule at the same time' ($other.Proxy -eq $pB -and $other.Rule -eq $rH -and $other.Name -eq 'pbe_http.exe') "proxy $($other.Proxy)/$pB rule $($other.Rule)/$rH name $($other.Name)"
+ } else { Check 'A program on another rule shows the other proxy and rule at the same time' $false 'the second transfer never appeared in the list' }
+
+ # sample the counters while the transfer runs at about 1 MB/s
+ $lastRecv = 0; $lastSent = 0; $s1 = $null; $s2 = $null
+ if ($mine) {
+ Start-Sleep -Seconds 2
+ $s1 = Get-Flows | Where-Object { $_.Id -eq $mine.Id } | Select-Object -First 1; $t1 = Get-Date
+ Start-Sleep -Seconds 4
+ $s2 = Get-Flows | Where-Object { $_.Id -eq $mine.Id } | Select-Object -First 1; $t2 = Get-Date
+ if ($s1 -and $s2) {
+ $rate = ($s2.Received - $s1.Received) / ($t2 - $t1).TotalSeconds
+ Check 'Received bytes grow while the transfer runs' ($s2.Received -gt $s1.Received) "$($s1.Received) -> $($s2.Received)"
+ Check 'The received rate matches the real rate limit (about 1 MB/s)' ($rate -gt 600000 -and $rate -lt 1900000) ("{0:N0} bytes/s" -f $rate)
+ Check 'Sent bytes are only the request (a download sends very little)' ($s2.Sent -gt 0 -and $s2.Sent -lt 100000) "sent $($s2.Sent)"
+ } else { foreach ($t in 'Received bytes grow while the transfer runs', 'The received rate matches the real rate limit (about 1 MB/s)', 'Sent bytes are only the request (a download sends very little)') { Check $t $false 'the flow disappeared while sampling' } }
+ # keep sampling until it ends, remember the last values
+ $end = (Get-Date).AddSeconds(80)
+ while (-not $cf.HasExited -and (Get-Date) -lt $end) {
+ $x = Get-Flows | Where-Object { $_.Id -eq $mine.Id } | Select-Object -First 1
+ if ($x) { $lastRecv = $x.Received; $lastSent = $x.Sent }
+ Start-Sleep -Milliseconds 700
+ }
+ }
+ $null = $cf.WaitForExit(15000)
+ $len = if (Test-Path $flowFile) { (Get-Item $flowFile).Length } else { 0 }
+ Check 'The rate-limited download itself arrived complete' ($cf.HasExited -and $cf.ExitCode -eq 0 -and $len -eq $bigSize) "exit $(if ($cf.HasExited) { $cf.ExitCode }), $len bytes"
+ if ($mine -and $len -eq $bigSize) {
+ Check 'At the end the received counter equals the real transfer size (within a second of data and TLS overhead)' ($lastRecv -ge ($bigSize * 0.9) -and $lastRecv -le ($bigSize * 1.05 + 100000)) "counter $lastRecv, file $bigSize"
+ }
+ Start-Sleep -Seconds 6
+ Check 'A finished connection leaves the list' (-not (Get-Flows | Where-Object { $_.Pid -eq $cf.Id }))
+ if (-not $ch.HasExited) { Stop-Process -Id $ch.Id -Force }
+
+ # ---- pause, logging switches
+ Write-Host "`n=== pause, Log Every Connection, traffic logging" -ForegroundColor Cyan
+ $null = Svc-Ok "enabled`t0"; Start-Sleep -Seconds 1
+ Direct-Open 'Paused: a Proxy rule is not applied (traffic goes direct)' $exe.svc
+ $r = Get-Ok $exe.block 'http://example.com/' 'Example Domain'
+ Check 'Paused: a Block rule is not applied either' ($r.Exit -eq 0 -and (Has-Body $r 'Example Domain'))
+ $null = Svc-Ok "enabled`t1"; Start-Sleep -Seconds 1
+ Via-Open 'Resumed: the Proxy rule applies again' $exe.svc
+
+ $null = Svc-Ok 'clearlogs'; $null = Svc-Ok "logall`t0"
+ $r = Get-Ok $exe.nomatch 'http://example.com/' 'Example Domain'; Start-Sleep -Seconds 2
+ Check 'Log Every Connection off: a program with no rule is not logged' ((Conn-Events 'pbe_nomatch.exe') -eq 0) "$(Conn-Events 'pbe_nomatch.exe') events"
+ $null = Svc-Ok "logall`t1"
+ $r = Get-Ok $exe.nomatch 'http://example.com/' 'Example Domain'; Start-Sleep -Seconds 2
+ Check 'Log Every Connection on: that connection is logged' ((Conn-Events 'pbe_nomatch.exe') -ge 1) "$(Conn-Events 'pbe_nomatch.exe') events"
+ $null = Svc-Ok "logall`t0"
+
+ $before = Conn-Events 'pbe_svc.exe'
+ $r = Get-Ok $exe.svc 'http://example.com/' 'Example Domain'; Start-Sleep -Seconds 2
+ Check 'Traffic logging on: a proxied connection is logged with its process' ((Conn-Events 'pbe_svc.exe') -gt $before)
+ $null = Svc-Ok "traffic`t0"; Start-Sleep -Seconds 1
+ $before = Conn-Events 'pbe_svc.exe'; $bo = Count $logOpen '[CONNECT]'
+ $r = Get-Ok $exe.svc 'http://example.com/' 'Example Domain'; Start-Sleep -Seconds 2
+ Check 'Traffic logging off: nothing is logged, but the traffic still goes through the proxy' ((Conn-Events 'pbe_svc.exe') -eq $before -and (Count $logOpen '[CONNECT]') -gt $bo)
+ $null = Svc-Ok "traffic`t1"
+
+ # ---- editing rules while running
+ Write-Host "`n=== rules changed while the engine runs" -ForegroundColor Cyan
+ Via-Open 'Order: the first rule (Proxy) wins' $exe.order
+ $null = Svc-Ok "disable_rule`t$rO1"; Start-Sleep -Seconds 1
+ Direct-Open 'Disable the first rule: the next one (Direct) applies' $exe.order
+ $null = Svc-Ok "enable_rule`t$rO1"; Start-Sleep -Seconds 1
+ Via-Open 'Enable it again: Proxy applies again' $exe.order
+ Check 'Move the Direct rule to the top' (Svc-Ok "move_rule`t$rO2`t1")
+ Check 'The rule list order changed' ((Svc-Id "rulepos`t$rO2") -lt (Svc-Id "rulepos`t$rO1"))
+ Start-Sleep -Seconds 1
+ Direct-Open 'After the move the Direct rule wins' $exe.order
+ $null = Svc-Ok "delete_rule`t$rS"; Start-Sleep -Seconds 1
+ Direct-Open 'Delete a rule: that program goes direct' $exe.svc
+ Check 'Deleting a rule that is already gone is refused' (-not (Svc-Ok "delete_rule`t$rS"))
+
+ # ---- one client at a time, and a client that dies
+ Write-Host "`n=== second client, and a client that is killed" -ForegroundColor Cyan
+ Check 'A second client is told the service is BUSY' ((Probe) -match 'BUSY') "answer: $(Probe)"
+ $null = Svc-Id "rule`tpbe_after.exe`t*`t*`t*`ttcp`tproxy`t$pA`t0"
+ Via-Open 'Before the kill: a fresh rule proxies' $exe.after
+ $driver.Kill(); $driver = $null
+ Start-Sleep -Seconds 4
+ Check 'The service keeps running after its client was killed' ((Get-Service ProxyBridgeSvc).Status -eq 'Running')
+ Direct-Open 'The engine was released: the program is no longer proxied' $exe.after
+ $p2 = Probe
+ Check 'A new client can connect after the old one died' ($p2 -eq 'CONNECTED') "answer: $p2"
+
+ # ======================= the real app =======================
+ Write-Host "`n=== the real ProxyBridge app applies a profile to the service" -ForegroundColor Cyan
+ $appData = Join-Path $Out 'appdata'; $profDir = Join-Path $appData 'ProxyBridge\profiles'
+ New-Item -ItemType Directory -Path $profDir -Force | Out-Null
+ $profile = @{ Version = '1.0'; IsTrafficLoggingEnabled = $true
+ ProxyConfigs = @(@{ Id = 1; Name = 'nexus-open'; Type = 'SOCKS5'; Host = '127.0.0.1'; Port = "$PORT_OPEN"; Username = ''; Password = ''; SendDomainToProxy = $true })
+ ProxyRules = @(@{ Name = 'pbe_gui.exe'; ProcessName = 'pbe_gui.exe'; TargetHosts = '*'; TargetPorts = '*'; TargetDomains = '*'; Protocol = 'TCP'
+ Action = 'PROXY'; IsEnabled = $true; LocalhostViaProxy = $false; ProxyConfigId = 1 }) }
+ ($profile | ConvertTo-Json -Depth 6) | Set-Content -Path (Join-Path $profDir 'e2e.pbprofile') -Encoding UTF8
+ (@{ ActiveProfileName = 'e2e'; CheckForUpdatesOnStartup = $false; LastUpdateCheck = ''; StartWithWindows = $false } | ConvertTo-Json) |
+ Set-Content -Path (Join-Path $appData 'ProxyBridge\settings.json') -Encoding UTF8
+ Direct-Open 'Before the app starts the program is not proxied' $exe.gui
+ $oldAppData = $env:APPDATA; $env:APPDATA = $appData
+ try { $gui = Start-Process -FilePath (Join-Path $inst 'ProxyBridge.exe') -PassThru } finally { $env:APPDATA = $oldAppData }
+ $win = $false
+ for ($i = 0; $i -lt 60 -and -not $gui.HasExited; $i++) { $gui.Refresh(); if ($gui.MainWindowHandle -ne 0) { $win = $true; break }; Start-Sleep -Milliseconds 500 }
+ Check 'The app starts and opens its window' ($win -and -not $gui.HasExited) "window title '$($gui.MainWindowTitle)'"
+ if ($win) {
+ Start-Sleep -Seconds 5
+ Check 'The app connected to the service (the service is busy for others)' ((Probe) -match 'BUSY')
+ Via-Open 'The profile rule is applied: the program goes through the proxy' $exe.gui
+ [void]$gui.CloseMainWindow()
+ if (-not $gui.WaitForExit(15000)) { Stop-Process -Id $gui.Id -Force; Check 'The app closes when asked' $false 'had to be killed' } else { Check 'The app closes when asked' $true }
+ Start-Sleep -Seconds 3
+ Check 'The service keeps running after the app closed' ((Get-Service ProxyBridgeSvc).Status -eq 'Running')
+ Direct-Open 'After the app closed the engine is released (no proxy)' $exe.gui
+ Check 'The service accepts a new client after the app closed' ((Probe) -eq 'CONNECTED')
+ }
+}
+catch {
+ Write-Host "STOPPED: $($_.Exception.Message)" -ForegroundColor Red
+ Check 'The service test ran to the end' $false $_.Exception.Message
+}
+finally {
+ foreach ($p in $procs) { try { if (-not $p.HasExited) { Stop-Process -Id $p.Id -Force } } catch { } }
+ if ($driver) { $driver.Kill() }
+ if ($gui) { try { if (-not $gui.HasExited) { Stop-Process -Id $gui.Id -Force } } catch { } }
+ Get-Process -Name 'pbe_*' -ErrorAction SilentlyContinue | Stop-Process -Force -ErrorAction SilentlyContinue
+ try { Remove-LocalUser -Name $testUser -ErrorAction SilentlyContinue } catch { }
+ if (Test-Path $publicDir) { Remove-Item $publicDir -Recurse -Force -ErrorAction SilentlyContinue }
+ Start-Sleep -Seconds 1
+}
+
+# ======================= uninstaller =======================
+Write-Host "`n=== silent uninstall" -ForegroundColor Cyan
+if (Test-Path (Join-Path $inst 'uninst.exe')) {
+ $u = Start-Process -FilePath (Join-Path $inst 'uninst.exe') -ArgumentList @('/S', "_?=$inst") -PassThru -Wait
+ Check 'Uninstaller finishes silently' ($u.ExitCode -eq 0) "exit code $($u.ExitCode)"
+ Start-Sleep -Seconds 2
+ Check 'The service is gone' (-not (Get-Service ProxyBridgeSvc -ErrorAction SilentlyContinue))
+ Check 'The "ProxyBridge Users" group is gone' ((& net.exe localgroup 'ProxyBridge Users' 2>&1 | Out-String) -notmatch 'Members')
+ Check 'The WinDivert driver service is gone' (-not (Get-Service WinDivert -ErrorAction SilentlyContinue))
+ Check 'The program files are removed' (@('ProxyBridge.exe', 'ProxyBridge_CLI.exe', 'ProxyBridgeCore.dll', 'ProxyBridgeSvc.exe', 'WinDivert.dll', 'WinDivert64.sys' |
+ Where-Object { Test-Path (Join-Path $inst $_) }).Count -eq 0)
+ Check 'The install folder is removed from the machine PATH' (-not (([Environment]::GetEnvironmentVariable('Path', 'Machine') -split ';') -contains $inst))
+ Check 'The uninstall entry is removed' (-not (Test-Path 'HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\ProxyBridge'))
+ Remove-Item $inst -Recurse -Force -ErrorAction SilentlyContinue
+} else { Skip 'Uninstaller' 'the installation did not complete' }
+
+Write-Host "`n================ summary ================" -ForegroundColor Cyan
+$results | Format-Table Test, Result -AutoSize | Out-String | Write-Host
+$failed = @($results | Where-Object { $_.Result -eq 'FAIL' })
+if ($failed.Count) {
+ Write-Host "--- failed checks ---"; $failed | ForEach-Object { Write-Host " $($_.Test) ($($_.Detail))" }
+ Write-Host "$($failed.Count) of $($results.Count) checks failed" -ForegroundColor Red; exit 1
+}
+Write-Host "All $($results.Count) checks passed" -ForegroundColor Green
+exit 0
diff --git a/Windows/tests/e2e/svc_client.c b/Windows/tests/e2e/svc_client.c
new file mode 100644
index 0000000..cfbc996
--- /dev/null
+++ b/Windows/tests/e2e/svc_client.c
@@ -0,0 +1,131 @@
+// svc_client.c - test helper for run_e2e_service.ps1.
+//
+// Talks to the installed ProxyBridge Service exactly like the app does (it includes the app's own pipe client,
+// gui\api\pb_ipc.h), but is driven by text commands on stdin instead of menus, and answers on stdout. This lets the
+// end-to-end test add proxies and rules, start the engine, read the Live Connections data and watch the connection events
+// of the real service while real traffic flows.
+//
+// svc_client.exe interactive: one command per line (fields separated by TAB), see the list below
+// svc_client.exe --probe connect, print CONNECTED (or why not) and exit - used to test who may use the service
+//
+// Answers: OK[\t..] | ERR[\t..] | FLOW lines followed by END\t<count> | EVT\t... (asynchronous log and connection events)
+// proxy <socks5|http> <host> <port> <user|-> <pass|-> <sendDomain 0|1> OK <id>
+// rule <process> <hosts> <ports> <domains> <tcp|udp|both> <proxy|direct|block> <proxyId> <localhost 0|1> OK <id>
+// enable_rule|disable_rule|delete_rule <id> move_rule <id> <position> rulepos <id>
+// start | stop | enabled <0|1> | logall <0|1> | traffic <0|1> | clearlogs | flows | sleep <ms> | quit
+#ifndef _CRT_SECURE_NO_WARNINGS
+#define _CRT_SECURE_NO_WARNINGS
+#endif
+#include <windows.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <stdarg.h>
+#include "../../gui/api/pb_ipc.h"
+
+static CRITICAL_SECTION g_out;
+
+static void out(const char* fmt, ...)
+{
+ EnterCriticalSection(&g_out);
+ va_list ap; va_start(ap, fmt); vprintf(fmt, ap); va_end(ap);
+ fflush(stdout);
+ LeaveCriticalSection(&g_out);
+}
+static void oneline(char* s) { for (; *s; s++) if (*s == '\n' || *s == '\r' || *s == '\t') *s = ' '; }
+
+static void on_log(const char* m)
+{
+ char b[1024]; strncpy(b, m ? m : "", sizeof(b) - 1); b[sizeof(b) - 1] = 0; oneline(b);
+ out("EVT\tLOG\t%s\n", b);
+}
+static void on_conn(const char* proc, DWORD pid, const char* ip, unsigned short port, const char* info)
+{
+ char p[300], i[300], f[400];
+ strncpy(p, proc ? proc : "", sizeof(p) - 1); p[sizeof(p) - 1] = 0; oneline(p);
+ strncpy(i, ip ? ip : "", sizeof(i) - 1); i[sizeof(i) - 1] = 0; oneline(i);
+ strncpy(f, info ? info : "", sizeof(f) - 1); f[sizeof(f) - 1] = 0; oneline(f);
+ out("EVT\tCONN\t%s\t%lu\t%s\t%u\t%s\n", p, (unsigned long)pid, i, (unsigned)port, f);
+}
+
+static const char* why(int rc)
+{
+ switch (rc) { case PB_IPC_NO_SERVICE: return "NO_SERVICE"; case PB_IPC_BUSY: return "BUSY"; case PB_IPC_BAD_VERSION: return "BAD_VERSION"; case PB_IPC_DENIED: return "DENIED"; }
+ return "UNKNOWN";
+}
+
+static int split(char* line, char** f, int max)
+{
+ int n = 0;
+ while (n < max) { f[n++] = line; char* t = strchr(line, '\t'); if (!t) break; *t = 0; line = t + 1; }
+ return n;
+}
+
+int main(int argc, char** argv)
+{
+ InitializeCriticalSection(&g_out);
+ PBApi api;
+ int rc = PB_LoadService(&api);
+ if (rc != PB_IPC_OK) { out("CONNECT_FAILED\t%s\n", why(rc)); return 3; }
+ out("CONNECTED\n");
+ if (argc > 1 && strcmp(argv[1], "--probe") == 0) return 0;
+
+ api.SetLogCallback(on_log);
+ api.SetConnectionCallback(on_conn);
+
+ static PBFlow flows[PB_FLOWS_MAX_GUI];
+ char line[8192];
+ while (fgets(line, sizeof(line), stdin))
+ {
+ size_t l = strlen(line);
+ while (l && (line[l - 1] == '\n' || line[l - 1] == '\r')) line[--l] = 0;
+ if (!l) continue;
+ char* f[16] = { 0 };
+ int n = split(line, f, 16);
+ const char* c = f[0];
+
+ if (!strcmp(c, "proxy") && n >= 7)
+ {
+ PBProxyType t = _stricmp(f[1], "http") == 0 ? PB_PROXY_HTTP : PB_PROXY_SOCKS5;
+ UINT32 id = api.AddProxyConfig(t, f[2], (unsigned short)atoi(f[3]), strcmp(f[4], "-") ? f[4] : NULL, strcmp(f[5], "-") ? f[5] : NULL, atoi(f[6]) != 0);
+ if (id) out("OK\t%u\n", id); else out("ERR\tproxy\n");
+ }
+ else if (!strcmp(c, "rule") && n >= 9)
+ {
+ PBRuleProtocol p = !_stricmp(f[5], "udp") ? PB_PROTO_UDP : !_stricmp(f[5], "both") ? PB_PROTO_BOTH : PB_PROTO_TCP;
+ PBRuleAction a = !_stricmp(f[6], "direct") ? PB_ACTION_DIRECT : !_stricmp(f[6], "block") ? PB_ACTION_BLOCK : PB_ACTION_PROXY;
+ UINT32 id = api.AddRule(f[1], f[2], f[3], f[4], p, a, (UINT32)atoi(f[7]), atoi(f[8]) != 0);
+ if (id) out("OK\t%u\n", id); else out("ERR\trule\n");
+ }
+ else if (!strcmp(c, "enable_rule") && n >= 2) out(api.EnableRule((UINT32)atoi(f[1])) ? "OK\n" : "ERR\tenable_rule\n");
+ else if (!strcmp(c, "disable_rule") && n >= 2) out(api.DisableRule((UINT32)atoi(f[1])) ? "OK\n" : "ERR\tdisable_rule\n");
+ else if (!strcmp(c, "delete_rule") && n >= 2) out(api.DeleteRule((UINT32)atoi(f[1])) ? "OK\n" : "ERR\tdelete_rule\n");
+ else if (!strcmp(c, "move_rule") && n >= 3) out(api.MoveRuleToPosition((UINT32)atoi(f[1]), (UINT32)atoi(f[2])) ? "OK\n" : "ERR\tmove_rule\n");
+ else if (!strcmp(c, "rulepos") && n >= 2) out("OK\t%u\n", api.GetRulePosition((UINT32)atoi(f[1])));
+ else if (!strcmp(c, "start")) out(api.Start() ? "OK\n" : "ERR\tstart\n");
+ else if (!strcmp(c, "stop")) out(api.Stop() ? "OK\n" : "ERR\tstop\n");
+ else if (!strcmp(c, "enabled") && n >= 2) { api.SetEnabled(atoi(f[1]) != 0); out("OK\n"); }
+ else if (!strcmp(c, "logall") && n >= 2) { api.SetLogEveryConnection(atoi(f[1]) != 0); out("OK\n"); }
+ else if (!strcmp(c, "traffic") && n >= 2) { api.SetTrafficLoggingEnabled(atoi(f[1]) != 0); out("OK\n"); }
+ else if (!strcmp(c, "clearlogs")) { api.ClearConnectionLogs(); out("OK\n"); }
+ else if (!strcmp(c, "sleep") && n >= 2) { Sleep((DWORD)atoi(f[1])); out("OK\n"); }
+ else if (!strcmp(c, "flows"))
+ {
+ UINT32 cnt = api.GetFlows(flows, PB_FLOWS_MAX_GUI);
+ for (UINT32 i = 0; i < cnt; i++)
+ {
+ const PBFlow* x = &flows[i];
+ char nm[64], hs[96]; strncpy(nm, x->name, sizeof(nm) - 1); nm[sizeof(nm) - 1] = 0; oneline(nm);
+ strncpy(hs, x->host, sizeof(hs) - 1); hs[sizeof(hs) - 1] = 0; oneline(hs);
+ out("FLOW\t%llu\t%lu\t%u\t%u\t%s\t%u\t%llu\t%llu\t%s\t%u\t%u\t%u\n", (unsigned long long)x->id, (unsigned long)x->pid, (unsigned)x->is_udp,
+ (unsigned)x->is_ipv6, hs, (unsigned)x->port, (unsigned long long)x->sent, (unsigned long long)x->received, nm,
+ (unsigned)x->rule_id, (unsigned)x->proxy_config_id, (unsigned)x->age_ms);
+ }
+ out("END\t%u\n", cnt);
+ }
+ else if (!strcmp(c, "quit")) { api.Stop(); out("OK\n"); return 0; }
+ else out("ERR\tunknown command or missing arguments\n");
+ }
+ api.Stop(); // stdin closed: leave the engine stopped
+ return 0;
+}