igraphql/echo-server

镜像概述

igraphql/echo-server是一款HTTP请求调试工具镜像，适用于客户端与服务器之间存在代理的场景。将客户端或代理服务器指向该镜像替代源服务器，它会返回收到的HTTP请求详细信息（包括请求头、请求体及元数据）作为JSON响应，助力用户高效排查请求相关问题。

核心功能

• 返回HTTP请求完整信息：包含请求体（body）、请求头（headers）和请求元数据（如方法、路径、客户端地址等）
• 日志级别配置：通过环境变量控制是否将响应信息输出到STDOUT
• 多版本适配：提供特权（root用户，80/443端口）和非特权（nginx用户，8080/8443端口）版本，满足不同运行环境需求

使用场景

• 调试代理转发请求：验证代理是否正确传递HTTP请求内容
• 验证客户端请求：检查客户端发送的请求头、体是否符合预期
• API测试辅助：快速查看API接口的请求参数和格式是否正确

配置说明

支持通过环境变量配置：

LOG_LEVEL

• 取值：info
• 类型：字符串
• 默认值：null
• 示例：LOG_LEVEL=info
• 作用：除HTTP响应外，将服务器响应信息输出到STDOUT

部署示例

Docker Run命令

特权版本（latest标签）

bash
docker run -d -p 80:80 igraphql/echo-server

非特权版本（latest-unprivileged标签）

bash
docker run -d -p 8080:8080 igraphql/echo-server:latest-unprivileged

测试示例

使用curl发送请求：

bash
curl http://localhost:80 -d 'Hello World!'

预期响应：

json
{
   "body": "Hello World!",
   "headers": {
      "accept": "*/*",
      "content-length": "12",
      "content-type": "application/x-www-form-urlencoded",
      "host": "localhost",
      "user-agent": "curl/7.29.0"
   },
   "request": {
      "content_length": "12",
      "content_type": "application/x-www-form-urlencoded",
      "path_info": "/",
      "query_string": "",
      "remote_addr": "172.22.0.1",
      "request_method": "POST",
      "request_scheme": "http",
      "request_uri": "/",
      "server_addr": "172.22.0.2",
      "server_name": "localhost",
      "server_port": "80",
      "server_protocol": "HTTP/1.1",
      "server_software": "Unit/1.21.0"
   }
}

版本说明