lukaszlach/docker-tc

Docker Traffic Control

Docker Traffic Control 可通过标签或HTTP API为Docker容器设置网络速率限制，并模拟延迟、丢包、数据包重复及损坏等网络条件，完全由Bash编写并以Docker镜像形式分发。

镜像概述

该工具通过监听Docker事件，自动对带有指定标签的容器应用网络规则，同时提供HTTP API和命令行界面手动管理规则，帮助开发者测试应用在不同网络环境下的表现。

核心功能

• 速率限制：设置容器带宽上限（支持多种单位及百分比）
• 网络模拟：模拟延迟、丢包、数据包重复与损坏
• 自动管理：通过容器标签自动应用规则
• 手动控制：HTTP API（GET/LIST/DELETE/PUT/POST）和命令行界面管理规则
• 跨平台限制：仅支持Linux系统（MacOS/Windows不支持）

使用场景

• 测试应用在低带宽、高延迟环境下的性能
• 验证应用对网络丢包或数据包损坏的容错能力
• 模拟分布式系统中不同节点的网络差异

配置说明

运行Daemon

需使用NET_ADMIN权限和host网络模式，挂载Docker套接字：

bash
docker run -d \
    --name docker-tc \
    --network host \
    --cap-add NET_ADMIN \
    --restart always \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /var/docker-tc:/var/docker-tc \
    lukaszlach/docker-tc

或使用docker-compose：

bash
git clone https://github.com/lukaszlach/docker-tc.git
cd docker-tc
docker-compose up -d

容器标签使用

为容器添加以下标签启用网络控制：

• com.docker-tc.enabled=1：启用规则（必填）
• com.docker-tc.limit：带宽限制（如1mbps、70.5%）
• com.docker-tc.delay：延迟（如100ms）
• com.docker-tc.loss：丢包率（如50%）
• com.docker-tc.duplicate：数据包重复率（如50%）
• com.docker-tc.corrupt：数据包损坏率（如10%）

示例：

bash
docker network create test-net
docker run -it \
    --net test-net \
    --label "com.docker-tc.enabled=1" \
    --label "com.docker-tc.limit=1mbps" \
    --label "com.docker-tc.delay=100ms" \
    --label "com.docker-tc.loss=50%" \
    --label "com.docker-tc.duplicate=50%" \
    --label "com.docker-tc.corrupt=10%" \
    busybox \
    ping google.com

HTTP API

• GET：获取容器规则（curl localhost:4080/<容器ID或名称>）
• LIST：列出所有容器规则（curl -X LIST localhost:4080）
• DELETE：删除容器规则（curl -X DELETE localhost:4080/<容器ID或名称>）
• PUT：恢复容器规则监听（curl -X PUT localhost:4080/<容器ID或名称>）
• POST：手动设置规则（curl -d'delay=300ms' localhost:4080/<容器ID或名称>）

命令行设置

创建别名简化操作：

bash
alias docker-tc='curl -sSf -X "$1" "localhost:4080/$2?$3"'

使用示例：

bash
docker-tc get 221517ae59d1
docker-tc set my-container-name 'delay=300ms&rate=1000kbps'

构建镜像

bash
git clone https://github.com/lukaszlach/docker-tc.git
cd docker-tc
make

Swarm部署（理论）

由于Docker Swarm限制，暂无法作为服务部署，以下为理论命令：

bash
docker service create \
    --name docker-tc \
    --mode global \
    --restart-condition any \
    --network host \
    --cap-add NET_ADMIN \
    --mount "type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock" \
    --mount "type=bind,src=/var/docker-tc,dst=/var/docker-tc" \
    lukaszlach/docker-tc

许可协议

MIT License Copyright (c) 2018 Łukasz Lach <***> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, subject to the conditions specified in the original license.