flomesh/httpbin

HTTP请求与响应服务镜像文档

镜像概述

该Docker镜像提供HTTP请求与响应服务，基于Python + Flask开发，主要用于测试和调试HTTP请求与响应。镜像包含两个标签版本，分别基于不同的代码仓库：

• latest：基于https://github.com/simonkowallik/httpbin%E4%BB%93%E5%BA%93
• ken：基于https://github.com/postmanlabs/httpbin%E4%BB%93%E5%BA%93

核心功能与特性

• 支持HTTP请求信息获取（请求头、参数、数据等）
• 支持多种HTTP方法测试（GET、POST、PUT、DELETE等）
• 可模拟不同HTTP状态码响应（200、404、500等）
• 支持Cookie、表单数据、文件上传等常见HTTP场景测试
• 提供基本的认证和重定向测试功能

使用场景与适用范围

• API开发调试：验证客户端发送的HTTP请求格式和参数
• 前端开发：模拟后端API响应，独立进行前端界面开发
• 教学与学习：学习HTTP协议、请求方法及状态码特性
• 自动化测试：作为测试服务端，验证HTTP客户端功能正确性

使用方法与配置说明

拉取镜像

根据需求拉取不同标签的镜像：

bash
# 拉取基于simonkowallik/httpbin的latest标签
docker pull [镜像名称]:latest

# 拉取基于postmanlabs/httpbin的ken标签
docker pull [镜像名称]:ken

运行容器

基本运行（默认端口80）

bash
# 运行latest标签版本
docker run -d -p 80:80 --name httpbin-service [镜像名称]:latest

# 运行ken标签版本
docker run -d -p 80:80 --name httpbin-service [镜像名称]:ken

自定义端口映射

如需使用非默认端口（如8080）：

bash
docker run -d -p 8080:80 --name httpbin-service [镜像名称]:latest

访问服务

容器启动后，通过http://localhost:端口访问服务，常用测试端点示例：

• 获取请求信息：http://localhost/get
• 模拟200状态码：http://localhost/status/200
• 测试POST请求：http://localhost/post（可通过curl或API测试工具发送POST数据）
• 获取响应头：http://localhost/headers

配置说明

该镜像默认配置即可满足基本使用需求，无需额外参数。如需高级配置，可参考对应代码仓库文档进行环境变量设置或配置文件挂载。