measurementlab/wehe-py3

Wehe 镜像文档

镜像概述和主要用途

Wehe是一款用于重放记录的网络流量并分析结果的工具，主要用途包括网络流量重放、通信行为分析及结果存储。该工具支持容器化部署，服务器和客户端可使用同一Docker镜像运行，适用于需要模拟网络流量并分析其行为的场景。

核心功能和特性

• 网络流量重放：支持基于pcap文件生成pickle格式的重放文件，可重放原始或随机负载的网络流量。
• SSL加密通信：通过certGenerator.py生成自定义证书，加密侧信道通信，保障数据传输安全。
• 容器化部署：支持Docker构建和运行，提供Docker Compose配置用于服务器-客户端联动测试。
• 结果持久化：容器内/data目录专门用于保存重放分析结果，便于后续查看和分析。
• 服务器客户端一体：同一Docker镜像可同时作为服务器和客户端运行，简化部署流程。

使用场景和适用范围

适用场景

• 网络流量行为分析与模拟
• 通信安全测试（如侧信道通信加密验证）
• 网络应用行为复现与调试
• 网络流量特征研究

适用人群

• 网络安全研究人员
• 网络管理员
• 需要重放记录流量并分析结果的技术人员

详细使用方法和配置说明

容器化部署

构建Docker镜像

克隆项目代码后，进入项目目录执行以下命令构建镜像：

bash
docker build . -t wehe

运行Docker容器

构建完成后，使用以下命令运行容器，需指定SSL密钥目录、网络模式及服务器地址：

bash
docker run -v <本地SSL密钥目录绝对路径>:/wehe/ssl --net=host --env SUDO_UID=$UID -itd wehe <服务器公网IP/主机名>

参数说明：

• -v <本地SSL密钥目录绝对路径>:/wehe/ssl：挂载本地SSL密钥目录到容器内/wehe/ssl，用于SSL加密通信。
• --net=host：使用主机网络模式，确保容器与主机网络环境一致。
• --env SUDO_UID=$UID：设置环境变量SUDO_UID为当前用户ID，避免权限问题。
• -itd：i（交互模式）、t（伪终端）、d（后台运行）；移除d可在前台运行并查看STDOUT输出。
• <服务器公网IP/主机名>：指定服务器的公网IP或主机名。

结果存储：容器内/data目录用于保存重放分析结果。

SSL加密配置

为启用SSL加密通信，需生成自定义证书：

bash
python3 certGenerator.py

生成的证书需放置于本地SSL密钥目录，通过-v参数挂载到容器内/wehe/ssl目录。

测试容器

服务器和客户端可通过同一镜像运行，项目提供docker-compose.yaml用于验证服务器启动及客户端连接：

启动测试

bash
docker-compose build wehe-server
docker-compose up

该测试将验证服务器能否正常启动，以及客户端能否从容器内连接服务器并运行测试。若客户端或服务器启动失败，可能是构建顺序问题。

创建自定义测试

准备重放流量

1. 将记录的网络流量pcap文件保存至两个目录（如the/dir/to/pcap和the/dir/to/pcapRandom）。
2. 在两个目录中分别创建client_ip.txt，内容为pcap文件中的客户端IP地址。

生成重放文件

在客户端执行以下命令生成pickle格式的重放文件：

• 生成原始负载重放文件：

  bash
  sudo python3 replay_parser.py --pcap_folder={the/dir/to/pcap}
  

• 生成位反转随机负载重放文件：

  bash
  sudo python3 replay_parser.py --pcap_folder={the/dir/to/pcapRandom} --randomPayload=True --invertBit=True
  

部署至服务器

将生成的pickle文件目录（the/dir/to/pcap和the/dir/to/pcapRandom）通过scp复制到服务器。

重放操作步骤

服务器端

1. 修改folders.txt内容，指定重放pickle文件所在目录（如../replayTraces/Youtube和../replayTraces/YoutubeRandom）。
2. 启动服务器和分析器：

   bash
   ./restartServers.sh
   

客户端

假设服务器为wehe3.meddle.mobi（可修改python_lib.py中class Instance自定义服务器），执行以下命令重放记录流量：

bash
python3 replay_client.py --pcap_folder={重放文件目录} --serverInstance=wehe