tungns1207/masque_keyword repository overview

⁠Traffic Capture Testbed

This repository contains an automated testing environment using Docker to capture and analyze network traffic via a SOCKS5 proxy (Masque).

⁠🚀 Quick Start Guide

Follow these three steps to deploy the container and start capturing traffic.

⁠Prerequisites ( On your host machine)

CRITICAL: Before running the container, you must increase the UDP buffer sizes for QUIC to work properly.

sudo sysctl -w net.core.rmem_max=7500000
sudo sysctl -w net.core.wmem_max=7500000

⁠Step 1: Start the Docker Container

Run the following command to start the container in the background (detached mode). This command also mounts your current working directory on the host machine to /workspace/output_data inside the container, ensuring your captured files are safely saved to your host.

sudo docker run --init --rm -d --name masque_testbed1 -v "$(pwd):/workspace/output_data" tungns1207/masque_keyword:3

⁠Step 2: Access the Container

Open an interactive bash shell inside the running container to execute the script:

sudo docker exec -it masque_testbed1 /bin/bash

⁠Step 3: Run the Capture Script

Once inside the container (root@...:/workspace#), execute the Python script. Ensure you have your input list of URLs (e.g., cleaned_websites.txt) ready in the workspace.

python3 traffic_capture.py --trace_file_dir output_data/ --target_websites url.txt --websites_count 10 --gap_count 0 --access_count 500

⁠⚙️ Script Parameters (Arguments)

You can customize the script's behavior using the following command-line arguments:

⁠📁 Output Structure

Once the script finishes, check your mounted folder on the host machine. You will see the following structure:

output_data/
├── www_google_com/
│   ├── 1_www_google_com.pcap
│   └── 2_www_google_com.pcap
└── ...
├── www_google_com/
   ├── 1_www_google_com.csv
   └── 2_www_google_com.csv
   └── ...

This command to unlock permisson the folder contain pcap and csv:

sudo chown -R $USER:$USER my_docker_data