emicklei/zazkia

Zazkia Docker镜像文档

镜像概述

Zazkia是一款专注于模拟TCP连接问题的工具，旨在帮助开发和测试人员评估网络应用在不稳定网络环境下的表现。通过模拟延迟、丢包、连接中断等TCP异常场景，可有效验证应用的容错能力和恢复机制。

核心功能和特性

• TCP连接问题模拟：支持模拟延迟、丢包、连接中断等多种TCP连接异常
• 灵活配置：可通过参数自定义异常类型及程度
• 轻量级设计：资源占用低，易于集成到测试环境
• 透明转发：可作为中间代理转发流量并施加网络异常

使用场景和适用范围

• 网络应用健壮性测试：验证应用在弱网络环境下的稳定性
• 故障恢复测试：测试应用在TCP连接中断后的恢复能力
• 网络协议调试：辅助分析TCP协议实现中的异常处理逻辑
• CI/CD集成：作为自动化测试环节，确保网络异常处理机制有效

使用方法和配置说明

基本使用（Docker Run）

通过Docker命令直接运行：

bash
docker run -d --name zazkia emicklei/zazkia [参数]

常用参数说明

典型应用示例

示例1：模拟延迟和丢包

将本地8080端口流量转发到example.com:80，并添加500ms延迟和10%丢包率：

bash
docker run -d -p 8080:8080 --name zazkia emicklei/zazkia \
  --port 8080 \
  --target example.com:80 \
  --delay 500 \
  --loss 10

示例2：Docker Compose配置

创建docker-compose.yml：

yaml
version: '3'
services:
  zazkia:
    image: emicklei/zazkia
    ports:
      - "8080:8080"
    command: --port 8080 --target example.com:80 --delay 300 --loss 5
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 确保目标服务器地址和端口可访问
• 高丢包率或长延迟可能影响测试效率，建议根据场景调整参数
• 容器需要网络访问权限以转发流量到目标服务器
• 更多详细配置请参考官方文档：https://github.com/emicklei/zazkia