chrislusf/teeproxy

teeproxy

https://img.shields.io/docker/pulls/chrislusf/teeproxy.svg?maxAge=604800](https://hub.docker.com/r/chrislusf/teeproxy/)

镜像概述

teeproxy是一个反向HTTP代理工具，能够将每个传入请求复制为多个请求并转发到不同服务器，仅返回指定服务器的结果。它主要用于新系统上线前的影子模式测试或A/B测试，帮助验证新系统的稳定性和负载处理能力。

核心功能

• 支持GET、POST及所有HTTP方法的请求复制
• 可配置多个目标服务器（生产系统与备用系统）
• 灵活设置请求超时、主机头重写、请求比例分配
• 支持HTTPS配置、客户端IP转发及连接复用控制

使用场景

• 影子模式测试：将生产流量复制到新系统，验证其在真实负载下的运行情况，不影响现有服务
• A/B测试：按比例将部分请求转发到不同版本的系统，评估性能差异和功能稳定性

配置说明

基础参数

• -l: 指定监听端口（如:8888）
• -a: 生产系统地址（如http://localhost:9000）
• -b: 备用系统地址（可多个，如http://localhost:9001）

超时配置

• -a.timeout int: 生产流量超时时间（毫秒，默认2500）
• -b.timeout int: 备用系统流量超时时间（毫秒，默认1000）

主机头重写

• -a.rewrite bool: 是否重写生产系统的主机头（默认false）
• -b.rewrite bool: 是否重写备用系统的主机头（默认false）

请求比例分配

• -p float64: 转发到备用系统的请求比例（默认100.0，即全部）

HTTPS配置

• -key.file string: TLS私钥文件路径
• -cert.file string: TLS证书文件路径

客户端IP转发

• -forward-client-ip: 是否添加X-Forwarded-For和Forwarded头（默认false）

连接处理

• -close-connections: 是否关闭连接复用（默认false）

部署示例

Docker Run命令

bash
docker run -d -p 8888:8888 docker.xuanyuan.run/chrislusf/teeproxy -l :8888 -a http://prod-server:9000 -b http://test-server:9001 -p 50.0

该命令启动teeproxy监听8888端口，将50%的请求复制到测试服务器，返回生产服务器结果。

Docker Compose示例

yaml
version: '3'
services:
  teeproxy:
    image: chrislusf/teeproxy
    ports:
      - "8888:8888"
    command: "-l :8888 -a [***] -b [***] -a.timeout 3000 -b.timeout 1500"