一.Toxiproxy
1.介绍
Toxiproxy 是一个“故障注入 TCP 代理”。你把应用原本要连的服务，例如 Redis/MySQL/API，改成连 Toxiproxy 的本地监听端口；Toxiproxy 再转发到真实服务。测试时你可以动态给这个代理加延迟、断连、限速、超时、丢包等故障。
官方仓库：https://github.com/Shopify/toxiproxy
2.两部分组成
toxiproxy-server：
服务端进程。真正负责监听端口、转发 TCP 流量、注入故障，并提供 HTTP 管理 API。默认管理地址通常是 127.0.0.1:8474。
toxiproxy-cli：
命令行客户端。它本身不代理流量，只是连接 toxiproxy-server 的管理 API，帮你创建 proxy、启停 proxy、添加/删除 toxic。
一句话总结：toxiproxy-server 是实际代理和故障注入器，toxiproxy-cli 是管理它的命令行工具；你通过 create 建代理，通过 toxic add/remove 动态制造和撤销网络故障。
二.使用方法
1.启动 server
1）基本用法：
toxiproxy-server
2）指定管理 API 监听地址：
toxiproxy-server -host 127.0.0.1 -port 8474
3）使用配置文件启动：
toxiproxy-server -config toxiproxy.json
配置文件示例：
[
{
"name": "redis",
"listen": "127.0.0.1:8666",
"upstream": "127.0.0.1:6379",
"enabled": true
}
]
4）常见参数作用
-host 管理 API 绑定的 host
-port 管理 API 端口，默认常见为 8474
-config 启动时加载 proxy 配置
-version 查看版本
2.创建代理
1）假设真实 Redis 在 127.0.0.1:6379，希望应用改连 127.0.0.1:8666：
toxiproxy-cli create redis --listen 127.0.0.1:8666 --upstream 127.0.0.1:6379
3.查看所有 proxy：
toxiproxy-cli list
4.查看单个 proxy：
toxiproxy-cli inspect redis
5.启用/禁用：
toxiproxy-cli enable redis
toxiproxy-cli disable redis
6.删除：
toxiproxy-cli delete redis
如果 toxiproxy-server 不在默认地址，需要指定 host：
toxiproxy-cli --host 127.0.0.1:8474 list
有些版本参数名可能是 --host，有些帮助里会显示全局 API 地址参数，建议本机确认：
toxiproxy-cli --help
toxiproxy-server --help
7.添加故障 toxic
核心命令格式一般是：
toxiproxy-cli toxic add <proxy-name> \
--type <toxic-type> \
--toxicName <name> \
--toxicity <0.0-1.0> \
--attribute key=value
toxicity 表示影响比例：
1.0 100% 流量都受影响
0.5 大约 50% 流量受影响
0.0 不生效
方向通常有：
upstream 客户端 -> 服务端
downstream 服务端 -> 客户端
1）示例：给 Redis 增加 2 秒延迟：
toxiproxy-cli toxic add redis \
--type latency \
--toxicName redis_latency \
--toxicity 1.0 \
--attribute latency=2000 \
--attribute jitter=100
删除 toxic：
toxiproxy-cli toxic remove redis --toxicName redis_latency
8.常见 toxic 类型
1）latency：延迟。
toxiproxy-cli toxic add redis \
--type latency \
--attribute latency=1000 \
--attribute jitter=200
2）timeout：连接/读写超时，常用于模拟服务卡死。
toxiproxy-cli toxic add redis \
--type timeout \
--attribute timeout=5000
3）bandwidth：限速，单位通常是 KB/s。
toxiproxy-cli toxic add redis \
--type bandwidth \
--attribute rate=100
4）slow_close：延迟关闭连接。
toxiproxy-cli toxic add redis \
--type slow_close \
--attribute delay=3000
5）slicer：把数据切成小块发送，模拟分片/慢传输。
toxiproxy-cli toxic add redis \
--type slicer \
--attribute average_size=1024 \
--attribute size_variation=512 \
--attribute delay=100
6）limit_data：限制传输字节数，超过后断开。
toxiproxy-cli toxic add redis \
--type limit_data \
--attribute bytes=1024
三.示例（完整使用流程）
示例一：
1. 启动管理服务
toxiproxy-server
2. 创建代理
toxiproxy-cli create redis --listen 127.0.0.1:8666 --upstream 127.0.0.1:6379
3. 模拟网络延迟
toxiproxy-cli toxic add redis --type latency --toxicName latency_2s --toxicity 1.0 --attribute latency=2000
4. 恢复正常
toxiproxy-cli toxic remove redis --toxicName latency_2s
5. 模拟服务不可用
toxiproxy-cli disable redis
6. 恢复
toxiproxy-cli enable redis
示例二：模拟延迟
1. 启动管理服务
nohup ./toxiproxy-server &
2. 创建代理
./toxiproxy-cli create --listen 192.168.206.26:8099 --upstream 192.168.206.26:80 proxy-service-name1
3. 模拟网络延迟
添加1s延迟
./toxiproxy-cli toxic add -t latency -a latency=1000 proxy-service-name1
修改延迟为5s
./toxiproxy-cli toxic update -n latency_downstream -a latency=5000 proxy-service-name1
4. 查看当前延迟情况
./toxiproxy-cli inspect proxy-service-name1
6. 删除模拟
./toxiproxy-cli delete proxy-service-name1