fortio/fortio.echosrv

Fortio 回显服务器镜像

镜像概述

Fortio回显服务器镜像是Fortio项目的轻量级版本，专注于提供回显服务器功能。该镜像体积仅4Mb，依赖精简，支持多架构（linux/amd64、linux/arm64、linux/ppc64le、linux/s390x），可用于测试和调试网络服务的请求处理、延迟响应、状态码返回等场景。

核心功能与特性

协议支持

• HTTP回显：接收HTTP请求并返回请求数据，支持自定义延迟、状态码、响应大小等参数
• TCP回显：建立TCP连接并回显接收的数据
• UDP回显：接收UDP数据包并回显内容

关键特性

• 轻量级：4Mb极小镜像体积，启动快速，资源占用低
• 参数可控：支持通过URL查询参数自定义响应行为（延迟、状态码、 payload大小等）
• 多架构支持：适配主流CPU架构，可在各类环境中部署
• 配置灵活：支持自定义端口、绑定地址及默认回显参数

使用场景

• 服务测试：验证HTTP/TCP/UDP服务的请求接收与响应能力
• 延迟模拟：模拟网络延迟场景，测试服务在延迟环境下的表现
• 错误注入：通过自定义状态码（如404、503）测试服务的错误处理机制
• 负载调试：配合Fortio负载测试工具，验证服务在不同负载下的回显性能

使用方法

基本启动命令

shell
# 启动默认回显服务器（HTTP:8080, TCP:8078, UDP:8078）
docker run -p 8080:8080 -p 8078:8078/udp -p 8078:8078 fortio/fortio server

自定义端口配置

shell
# 自定义HTTP端口为8088，TCP端口为8079
docker run -p 8088:8088 -p 8079:8079 fortio/fortio server -http-port 8088 -tcp-port 8079

测试HTTP回显功能

shell
# 基础回显测试
curl -d "test payload" http://localhost:8080/

# 带延迟和状态码的回显测试（10%概率延迟150ms，5%概率返回503状态码）
curl "http://localhost:8080/?delay=150us:10&status=503:5"

测试TCP回显功能

shell
# 使用netcat连接TCP回显服务器
nc localhost 8078

配置参数

服务器配置参数

HTTP回显请求参数（URL查询参数）

示例：自定义默认回显行为

shell
# 启动服务器，默认50%概率延迟500ms，20%概率返回418状态码
docker run -p 8080:8080 fortio/fortio server -echo-server-default-params "delay=500ms:50&status=418:20"

访问 http://localhost:8080/ 时，将有50%概率延迟500ms，20%概率返回418状态码，其余情况正常回显请求内容。