Proxy Benchmark Suite

A modular testing and benchmark suite designed to evaluate the leak resilience of different Linux transparent proxy techniques.

Structure

• Makefile: The core entry point for preparing and running benchmarks.
• requirements.txt: Python dependencies (NSE, Scapy, pytest, and cached TTP requirements).
• src/orchestrator.py: Harness that runs targets inside isolated network namespaces via NSE, injects native L3 application traffic, and sniffs the external veth link.
• targets/: Installer hooks for each benchmark target (Anonsurf, TTP).
• pcap/: Directory containing captured network leak traces and auto-generated Markdown reports.

Usage

1. Setup the Environment

Create the virtual environment and install dependencies:

make setup

2. Run Anonsurf Benchmark

make test-anonsurf

This installs and starts the mocked Anonsurf inside the test_arena namespace, runs the leak injection test, and saves the leaked packets to pcap/anonsurf_leaks.pcap.

3. Run TTP Benchmark

make test-ttp

This installs TTP in editable mode, starts Tor inside the namespace, runs the leak injection test, and saves the results to pcap/ttp_leaks.pcap.

4. Cleanup

Remove PCAP logs and clean up namespaces:

make clean