buger/goreplay

GoReplay镜像说明

镜像概述

GoReplay是一款开源的HTTP流量捕获与重放工具，旨在通过真实流量持续验证系统稳定性。它能够捕获生产环境的实时HTTP请求，并将其重放到测试环境，帮助开发者在代码部署、配置变更或基础设施调整前，用真实数据验证系统兼容性与性能。

核心功能

• 实时捕获HTTP流量，记录真实用户请求细节
• 将捕获的流量重放到测试环境，模拟真实负载场景
• 支持流量过滤、修改与速率控制，适配不同测试需求
• 轻量级设计，对生产环境性能影响极小

使用场景

1. 代码发布验证：在生产环境捕获流量，重放到预发布环境，验证新代码是否兼容真实业务请求
2. 配置变更测试：调整系统参数（如缓存策略、负载均衡规则）后，用历史流量验证变更效果
3. 基础设施迁移：迁移到新服务器或云环境时，用真实流量测试新环境的稳定性与性能瓶颈

配置说明

GoReplay通过命令行参数配置核心功能，关键参数示例：

• -input-raw <interface:port>：捕获指定端口的HTTP流量（如-input-raw :8080）
• -output-file <path>：将捕获的流量保存到文件（如-output-file ./traffic.gor）
• -output-http <target-url>：将流量重放到目标服务（如-output-http http://test-service:80）
• -rate <value>：控制重放速率（如-rate 200%表示两倍速重放）

部署示例

捕获生产流量到文件

bash
docker run -d --name goreplay-capture \
  --network host \
  -v $(pwd)/data:/data \
  buger/goreplay \
  -input-raw :80 \
  -output-file /data/traffic.gor

从重放文件测试目标服务

bash
docker run -d --name goreplay-replay \
  -v $(pwd)/data:/data \
  buger/goreplay \
  -input-file /data/traffic.gor \
  -output-http http://test-app:8080 \
  -rate 150%

Docker Compose集成测试

yaml
version: '3.8'
services:
  goreplay:
    image: buger/goreplay
    command: ["-input-raw", ":80", "-output-http", "[***]"]
    network_mode: host
    depends_on:
      - test-app
  
  test-app:
    image: your-test-app:latest
    ports:
      - "8080:80"
    environment:
      - ENV=test