bprodoehl/wan-emulator

docker-wan-emulator 镜像文档

镜像概述

docker-wan-emulator是一个用于广域网(WAN)环境模拟的Docker容器，主要通过netem工具配置网络特性，帮助模拟真实广域网中的网络条件，适用于测试网络应用在不同网络环境下的性能表现。

核心功能与特性

• WAN环境模拟：基于netem工具实现网络特性模拟，支持配置网络延迟等参数
• 灵活配置：通过uci命令配置网络接口、启用状态及延迟参数
• 容器化部署：轻量级容器化设计，易于集成到测试环境和CI/CD流程
• 接口适配：支持指定网络接口（如eth0）进行网络特性配置

使用场景与适用范围

适用场景

• 网络应用性能测试：模拟不同延迟条件下应用的响应速度和稳定性
• 网络协议调试：测试协议在高延迟网络环境中的行为表现
• 应用兼容性验证：验证应用在广域网环境下的兼容性和容错能力
• 教学与研究：演示网络延迟对通信的影响

适用人群

• 开发工程师：测试应用在不同网络环境下的表现
• 测试工程师：构建网络测试环境，验证应用鲁棒性
• 网络研究人员：模拟特定网络条件进行协议研究

使用方法与配置说明

基本使用流程

1. 部署容器并赋予网络管理权限
2. 通过uci命令配置netem参数
3. 应用配置并验证网络特性

Docker运行示例

bash
# 启动容器并赋予网络管理权限
docker run -d --name wan-emulator --cap-add=NET_ADMIN docker-wan-emulator

配置netem参数

容器内部通过uci命令进行netem参数配置，示例配置流程如下：

bash
# 进入容器
docker exec -it wan-emulator sh

# 添加netem接口配置
uci add netem interface

# 配置网络接口（通常为eth0）
uci set netem.@interface[0].ifname=eth0

# 启用netem配置
uci set netem.@interface[0].enabled=1

# 设置延迟参数（单位：秒）
uci set netem.@interface[0].delay=1

# 设置延迟参数（单位：毫秒）
uci set netem.@interface[0].delay_ms=100

# 提交配置
uci commit netem

配置参数说明

注意：总延迟为delay（秒）与delay_ms（毫秒）之和，实际配置时需根据测试需求调整参数值。容器需通过--cap-add=NET_ADMIN获取网络管理权限以应用netem配置。