GoReplay 是一个用于 HTTP(S) 流量捕获、回放与测试的工具，可以帮助开发人员在压力测试、故障复现等场景中模拟真实的生产流量。它的主要用途包括流量录制、流量回放、流量过滤、流量转发、限速等。以下详细介绍 GoReplay 的功能及实际操作示例。

1. 流量录制

GoReplay 允许通过命令行录制 HTTP 请求流量，并保存到文件或其他输出目标。录制的流量可以是原始请求和响应数据，记录下来后可以用来模拟或测试。

示例：录制 HTTP 流量

# 捕捉所有通过本地 8080 端口的 HTTP 请求，并将流量保存到 requests.gor 文件中
./gor --input-raw :8080 --output-file requests.gor

• --input-raw :8080：设置 GoReplay 捕获本地 8080 端口的 HTTP 流量。
• --output-file requests.gor：将捕获的流量数据保存到名为 requests.gor 的文件中。

2. 流量回放

GoReplay 支持将之前录制的流量重放到目标服务器。回放的流量与原始请求保持一致，可以进行性能测试、负载均衡测试等。

示例：回放流量到单台服务器

# 回放已录制的流量到目标地址 localhost:8080
./gor --input-file requests.gor --output-http "http://localhost:8080"

• --input-file requests.gor：指定录制的流量文件 requests.gor。
• **--output-http "http://localhost:8080"**：将流量回放到 http://localhost:8080。

示例：回放流量到多台服务器

# 将流量回放到两台服务器 localhost:8080 和 localhost:8081
./gor --input-file requests.gor --output-http "http://localhost:8080,http://localhost:8081"

• **--output-http "http://localhost:8080,http://localhost:8081"**：流量将被回放到指定的两个服务器上，轮询分发。

3. 请求过滤

GoReplay 提供了灵活的过滤机制，允许根据请求的特定特征（如请求路径、方法、头部等）来过滤流量。通过过滤，可以选择只回放满足某些条件的请求，避免不必要的流量影响测试结果。

示例：根据 URI 过滤请求

# 只回放路径为 /api/test 的请求
./gor --input-file requests.gor --output-http "http://localhost:8080" --filter "req.uri == '/api/test'"

• --filter "req.uri == '/api/test'"：只回放 URI 为 /api/test 的请求，其他请求将被忽略。

示例：根据请求方法过滤

# 只回放 POST 请求
./gor --input-file requests.gor --output-http "http://localhost:8080" --filter "req.method == 'POST'"

• --filter "req.method == 'POST'"：只回放 HTTP 方法为 POST 的请求。

示例：根据请求头过滤

# 只回放包含某个请求头的请求
./gor --input-file requests.gor --output-http "http://localhost:8080" --filter "req.headers['User-Agent'] == 'Mozilla/5.0'"

• --filter "req.headers['User-Agent'] == 'Mozilla/5.0'"：过滤出 User-Agent 为 Mozilla/5.0 的请求。

4. 限速机制

GoReplay 提供了流量限速的功能，允许设置请求回放的速率，避免回放时对目标系统产生过高的压力。

示例：设置回放速率为每秒 1000 个请求

# 将流量回放到目标服务器，限制回放速率为每秒 1000 个请求
./gor --input-file requests.gor --output-http "http://localhost:8080" --rate 1000

• --rate 1000：每秒钟最多回放 1000 个请求，超出的请求将被排队等待。

示例：设置回放速率为每秒 1 个请求

# 将流量回放到目标服务器，限制回放速率为每秒 1 个请求
./gor --input-file requests.gor --output-http "http://localhost:8080" --rate "1/s"

• --rate "1/s"：每秒仅回放 1 个请求，适用于对性能压力小的测试。

示例：设置回放速率为每秒 10 KB

# 将流量回放到目标服务器，限制回放流量为每秒 10KB
./gor --input-file requests.gor --output-http "http://localhost:8080" --rate "10KB/s"

• --rate "10KB/s"：每秒传输的数据量限制为 10KB，用于模拟带宽限制场景。

5. 捕捉流量并输出到终端

GoReplay 支持将捕获的 HTTP 请求实时输出到终端，便于开发者查看请求详情。

示例：输出请求信息到终端

# 捕捉流量并输出到终端（标准输出）
./gor --input-raw :8080 --output-stdout

• --output-stdout：将捕获到的请求实时输出到终端，开发者可以在终端中查看每个请求的详细信息。

6. 流量转发到单台或多台服务器

GoReplay 支持将捕获的流量转发到多个目标服务器进行处理，适用于负载均衡或者分布式测试场景。

示例：流量转发到单台服务器

# 将流量回放到单台服务器 localhost:8080
./gor --input-file requests.gor --output-http "http://localhost:8080"

示例：流量转发到多台服务器

# 将流量回放到两台服务器 localhost:8080 和 localhost:8081
./gor --input-file requests.gor --output-http "http://localhost:8080,http://localhost:8081"

• **--output-http "http://localhost:8080,http://localhost:8081"**：回放流量时，GoReplay 会将流量轮询发送到多个目标服务器，适用于测试负载均衡机制。

7. 完整的使用场景示例

假设我们要完成以下任务：

• 录制 HTTP 流量。
• 过滤出 URI 为 /api/test 的请求。
• 限制回放速率为每秒 500 个请求。
• 将流量回放到两台服务器上。

步骤 1：录制流量

# 捕捉并录制流量，保存到 requests.gor 文件
./gor --input-raw :8080 --output-file requests.gor

步骤 2：回放流量

# 回放录制的流量，过滤 URI 为 /api/test 的请求，每秒最多回放 500 个请求，回放到两台服务器
./gor --input-file requests.gor --output-http "http://localhost:8080,http://localhost:8081" --filter "req.uri == '/api/test'" --rate 500

总结

GoReplay 提供了强大的流量录制、回放、过滤、限速、输出和转发功能，能够模拟真实生产环境中的流量情况，支持负载均衡测试、性能测试、故障复现等应用场景。其高度的灵活性使得用户可以根据需求精准控制流量回放行为，例如设置回放速率、选择特定请求进行回放、输出流量信息等。

GoReplay 在流量模拟方面的强大功能，对于大规模系统的性能测试、分布式环境中的流量复现，或者在多台服务器间模拟负载均衡行为，具有重要的价值和应用前景。