martinstiehr/echo-server

martinstiehr/echo-server 镜像文档

概述

martinstiehr/echo-server是一个轻量级回声服务器Docker镜像，主要功能是接收HTTP请求并以JSON格式返回完整的请求信息。该镜像无需复杂配置，启动快速，资源占用低，是开发和测试阶段调试网络请求的实用工具。

核心功能与特性

• 请求信息完整返回：接收请求后返回HTTP方法、URL路径、头信息、查询参数及请求体等详细内容
• 轻量级设计：镜像体积小，启动迅速，对系统资源占用低
• 即开即用：无需额外配置，启动后可立即接收和响应请求
• 全面HTTP方法支持：兼容GET、POST、PUT、DELETE等所有标准HTTP方法
• 端口灵活映射：默认使用5000端口，支持通过Docker端口映射自定义主机访问端口

使用场景

• API开发调试：验证客户端发送的请求格式、头信息和参数是否符合预期
• 网络连通性测试：快速测试服务器与客户端之间的网络连接状态
• 前端开发模拟：模拟后端API响应，便于前端开发和界面调试
• 教学演示：直观展示HTTP请求结构和参数传递方式

使用方法

基本部署

通过以下命令快速启动echo-server容器：

bash
docker run -p 5000:5000 --rm -d martinstiehr/echo-server:latest

参数说明：

• -p 5000:5000：端口映射，将容器内5000端口映射到主机5000端口（格式：主机端口:容器端口）
• --rm：容器停止后自动清理容器文件
• -d：后台运行容器
• martinstiehr/echo-server:latest：指定使用最新版本的镜像

访问与测试

容器启动后，可通过发送HTTP请求测试服务：

GET请求示例

bash
curl http://localhost:5000/user?name=test&age=20

响应示例（JSON格式）：

json
{
  "method": "GET",
  "url": "/user?name=test&age=20",
  "headers": {
    "Host": "localhost:5000",
    "User-Agent": "curl/7.68.0",
    "Accept": "*/*"
  },
  "query": {
    "name": "test",
    "age": "20"
  },
  "body": ""
}

POST请求示例（带请求体）

bash
curl -X POST -H "Content-Type: application/json" -d '{"username":"demo","password":"123456"}' http://localhost:5000/login

响应示例：

json
{
  "method": "POST",
  "url": "/login",
  "headers": {
    "Host": "localhost:5000",
    "User-Agent": "curl/7.68.0",
    "Accept": "*/*",
    "Content-Type": "application/json",
    "Content-Length": "36"
  },
  "query": {},
  "body": "{\"username\":\"demo\",\"password\":\"123456\"}"
}

自定义端口配置

若需使用主机其他端口（如8080），修改端口映射参数即可：

bash
docker run -p 8080:5000 --rm -d martinstiehr/echo-server:latest

此时服务可通过 http://localhost:8080 访问。