uplex/http-echo

镜像概述

uplex/http-echo是一个轻量级HTTP服务器镜像，核心功能是将收到的HTTP请求详情（包括请求头、请求体、URI等）完整回显到响应中，帮助开发者快速验证请求参数和交互逻辑。

核心功能

1. 请求详情回显：返回服务器地址、名称、请求时间、URI、请求ID，以及完整的请求头和请求体。
2. 响应头自定义：通过带指定前缀（默认X-Set-）的请求头设置响应头（如X-Set-Foo: bar会在响应中添加Foo: bar）。
3. 通用响应状态：对所有请求（任意URL和方法）返回200 OK状态码。
4. 灵活日志配置：支持日志输出到文件、标准输出或关闭日志，格式包含请求ID便于追踪。

使用场景

• 测试HTTP客户端发送的请求参数是否正确。
• 调试API接口的请求头传递逻辑。
• 验证Webhook或第三方服务的请求内容。
• 学习HTTP协议的请求与响应交互机制。

配置说明

命令行参数

• -address host:port：监听地址，默认:7357（所有地址的7357端口）。
• -log logfile：日志输出位置，-为标准输出，/dev/null关闭日志，默认stdout。
• -set_prefix prefix：响应头前缀，默认X-Set-。
• -version：打印版本信息并退出。

Docker部署示例

拉取镜像

bash
docker pull uplex/http-echo

启动容器

bash
docker run -d -p 7357:7357 uplex/http-echo

测试示例

1. 回显请求内容：

bash
curl -d 'foo=bar&baz=quux' http://localhost:7357/foo/bar/baz

2. 设置响应头：

bash
curl -I -H 'X-Set-Foo: bar' -H 'X-Set-Baz: quux' http://localhost:7357/test