![Screenshot 2024-02-29 at 3 41 29 PM](https://private-user-images.githubusercontent.com/47127634/309081965-804756f9-156e-4796-bea6-00d5d7bb1706.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MTQ3NTU0NjQsIm5iZiI6MTcxNDc1NTE2NCwicGF0aCI6Ii80NzEyNzYzNC8zMDkwODE5NjUtODA0NzU2ZjktMTU2ZS00Nzk2LWJlYTYtMDBkNWQ3YmIxNzA2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA1MDMlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNTAzVDE2NTI0NFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWE5NzQ1MDAxNGFkMmIzZWYxNzNhOWNiNzUxYmMxZWFjOWEzMmY0MjAzNjZhNTgxNzVjOTlkNzgyZDY1M2ZhZTkmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.yifoYsnUFm8SukmiFeqQbFP6-tqVKmAx6raqXmZXEPg)
NetDiffusion is an innovative tool designed to address the challenges of obtaining high-quality, labeled network traces for machine learning tasks in networking. Privacy concerns, data staleness, and the limited availability of comprehensive datasets have long hindered research and development efforts. NetDiffusion leverages a controlled variant of a Stable Diffusion model to generate synthetic network traffic that not only boasts high fidelity but also adheres to protocol specifications.
Our approach outperforms current state-of-the-art synthetic trace generation methods by producing packet captures that exhibit higher statistical similarity to real network traffic. This improvement is crucial for enhancing machine learning model training and performance, as well as for supporting a wide range of network analysis and testing tasks beyond ML-centric applications.
- High-Fidelity Synthetic Data: Generate network traffic that closely resembles real-world data in terms of statistical properties and protocol compliance.
- Compatibility: Produced traces are compatible with common network analysis tools, facilitating easy integration into existing workflows.
- Versatility: Supports a wide array of network tasks, extending the utility of synthetic traces beyond machine learning applications.
- Open Source: NetDiffusion is open-source, encouraging contributions and modifications from the community to meet diverse needs.
# SSH to Linux server via designated port (see following for example)
ssh -L 7860:LocalHost:7860 username@server_address
# Clone the repository
git clone git@github.com:noise-lab/NetDiffusion_Generator.git
# Navigate to the project directory
cd NetDiffusion_Generator
# Install dependencies in the virtual env of choice (we recommend Conda)
pip install -r requirements.txt
Store raw pcaps used for fine-tuning into 'NetDiffusion_Code/data/fine_tune_pcaps' with the application/service labels as the filenames, e.g.,'netflix_01.pcap'.
# Navigate to preprocessing dir
cd data_preprocessing/
# Run preprocessing conversions
python3 pcap_to_img.py
# Navigate to fine-tune dir and the khoya subdir for task creation
# (replace the number in 20_network with the average number of pcaps per traffic type used for fine-tuning)
cd ../fine_tune/kohya_ss_fork/model_training/
mkdir -p example_task/{image/20_network,log,model}
# Leverage Stable Diffusion WebUI for initial caption creation
cd ../../sd-webui-fork/stable-diffusion-webui/
# Lunch WebUI
bash webui.sh
- Open the WebUI via the ssh port on the preferred browser, example address: http://localhost:7860/
- Under
extras/batch_from_directory
, enter the absolute path for/NetDiffusion_Code/data/preprocessed_fine_tune_imgs
and/NetDiffusion_Code/fine_tune/kohya_ss_fork/model_training/test_task/image/20_network
as the input/output directories. - Under
extras/batch_from_directory
, set thescale to
parameter towidth = 816
andheight = 768
for resource-friendly fine-tuning (adjust based on resource availability). - Enable the
caption
parameter underextras/batch_from_directory
and clickgenerate
. - Terminate
webui.sh
# Change the caption prompt for explicit prompt-to-image correlation,
# For example, 'pixelated network data, type-0' refers to NetFlix pcap,
# Adjust the script based on fine-tuning task.
cd ../../ && python3 caption_changing.py
# Navigate to fine-tuning directory
cd kohya_ss_fork
# Grant execution access
chmod +x ./setup.sh
# Set up configuration
./setup.sh
# Set up accelerate environment (gpu and fp16 recommended)
accelerate config
# Fine-tune interface initialization
bash gui.sh
- Open the fine-tuning interface via the ssh port on the preferred browser, example address: http://localhost:7860/
- Under
LoRA\Training
, load the configuration file via the absolute path for '/NetDiffusion_Code/fine_tune/LoraLowVRAMSettings.json' - Under
LoRA\Training\Folders
, enter the absolute paths for/NetDiffusion_Code/fine_tune/kohya_ss_fork/model_training/test_task/image
,/NetDiffusion_Code/fine_tune/kohya_ss_fork/model_training/test_task/model
, and/NetDiffusion_Code/fine_tune/kohya_ss_fork/model_training/test_task/log
for the Image/Output/Logging folders, respectively, and adjust the model name if needed. - Under
LoRA\Training\Parameters\Basic
, adjust the Max Resolution to match the resolution from data preprocessing, e.g., 816,768. - Click on Start Training to begin the fine-tuning. Adjust the fine-tuning parameters as needed due to different generation tasks may have different parameter requirement to yield better synthetic data quality.
# Copy the fine-tuned LoRA model (adjust path namings as needed) to Stable Diffusion WebUI
cp model_training/test_task/model/test_task_model.safetensors ../sd-webui-fork/stable-diffusion-webui/models/Lora/
# Navigate to the generation directory
cd ../sd-webui-fork/stable-diffusion-webui/
# Initialize Stable Diffusion WebUI
bash webui.sh
- Open the WebUI via the ssh port on the preferred browser, example address: http://localhost:7860/
- Install ControlNet extension for the WebUI and restart the WebUI: https://github.com/Mikubill/sd-webui-controlnet
- To generate an image representation of a network trace, enter the corresponding caption prompt with the LoRA model extension under 'txt2img'. For example 'pixelated network data, type-0 <lora:test_task_model:1>' for NetFlix data.
- Adjust the generation resolution to match the resolution from data preprocessing, e.g., 816,768.
- Adjust the seed to match the seed used in fine-tuning, default is
1234
. - Enable Hires.fix to scale to
1088, 1024
. - From training data, sample a real pcap image (that belongs to the same category as the desired synthetic traffic) as input to the ControlNet interface, and set the Control Type (we recommend canny).
- Click
Generate
to complete the generation. Note that extensive adjustments on the generation and ControlNet parameters may be needed to yield the best generation result as the generation tasks and training data differ from each other.
- Once enough instances of image representations of desired synthetic traffic are generated, place all of such instances under
/NetDiffusion_Code/data/generated_imgs
. - Navigate to the
/NetDiffusion_Code/post-generation/
folder
# Run the following to do the post-generation heuristic for reconversion back to pcaps and protocol compliance checking.
# Adjust the color processing threshold in color_processor.py as required for best generation results.
python3 color_processor.py && python3 img_to_nprint.py && python3 mass_reconstruction.py
This completes the post-generation pipeline with the final nprints and pcaps stored in /NetDiffusion_Code/data/replayable_generated_nprints
and /NetDiffusion_Code/data/replayable_generated_pcaps
, respectively.
@article{jiang2024netdiffusion,
title={NetDiffusion: Network Data Augmentation Through Protocol-Constrained Traffic Generation},
author={Jiang, Xi and Liu, Shinan and Gember-Jacobson, Aaron and Bhagoji, Arjun Nitin and Schmitt, Paul and Bronzino, Francesco and Feamster, Nick},
journal={Proceedings of the ACM on Measurement and Analysis of Computing Systems},
volume={8},
number={1},
pages={1--32},
year={2024},
publisher={ACM New York, NY, USA}
}