svenstaro/dummyhttp

dummyhttp Docker镜像文档

镜像概述和主要用途

dummyhttp是一个超轻量级、简单易用的HTTP服务器，专为测试和开发场景设计。它允许用户快速配置并启动HTTP服务，返回预定义的响应状态码和响应体，适用于模拟API响应、测试HTTP客户端行为或作为简单HTTP服务演示工具。

核心功能和特性

• 自定义响应状态码：支持配置任意有效的HTTP状态码（如200、404、500等）
• 自定义响应体：可设置返回的文本内容，支持纯文本、JSON等格式
• 自定义Content-Type：可指定响应的MIME类型（默认：text/plain）
• 响应延迟模拟：支持配置响应延迟时间，用于测试超时场景（默认：0秒）
• 端口配置：可指定服务监听的端口（默认：8080）
• 轻量级设计：镜像体积小，启动速度快，资源占用低

使用场景和适用范围

• API模拟：前端开发或服务集成测试中，快速模拟后端API的响应
• HTTP客户端测试：测试HTTP客户端对不同状态码、响应体的处理逻辑
• 演示环境：搭建简单的HTTP服务用于技术演示或教学
• 性能测试：结合延迟配置，测试系统在不同响应速度下的表现
• CI/CD流程：在持续集成/部署流程中作为临时服务端点

使用方法和配置说明

基本使用

通过Docker命令直接运行容器（默认配置）：

bash
docker run -p 8080:8080 svenstaro/dummyhttp

默认配置下，服务监听8080端口，返回状态码200和空响应体。

配置参数

支持通过命令行参数或环境变量进行配置，两种方式效果相同：

高级配置示例

1. 返回JSON响应

bash
docker run -p 8080:8080 svenstaro/dummyhttp \
  --port 8080 \
  --code 200 \
  --body '{"status":"ok","data":"test"}' \
  --content-type application/json

2. 模拟404错误响应

bash
docker run -p 8080:8080 svenstaro/dummyhttp \
  --code 404 \
  --body '{"error":"Not Found"}' \
  --content-type application/json

3. 使用环境变量配置

bash
docker run -p 8080:8080 \
  -e PORT=8080 \
  -e CODE=503 \
  -e BODY="Service Unavailable" \
  -e CONTENT_TYPE=text/plain \
  -e DELAY=2 \
  svenstaro/dummyhttp

4. docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  dummyhttp:
    image: svenstaro/dummyhttp
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - CODE=201
      - BODY='{"created": true, "id": "123"}'
      - CONTENT_TYPE=application/json
      - DELAY=1

启动服务：

bash
docker-compose up

注意事项

• 确保映射的宿主机端口未被占用，或通过-p参数调整端口映射
• 响应体内容较长时，建议通过环境变量或文件挂载传入，避免命令行参数长度限制
• 延迟配置仅影响响应发送前的等待时间，不包括网络传输时间