alexfalkowski/status

HTTP状态码测试服务镜像

概述

该镜像提供了一个轻量级HTTP服务，作为httpstat.us的替代方案，用于生成指定的HTTP状态码响应。通过简单配置即可模拟各类HTTP状态（如200、404、500等），支持自定义响应头、延迟和响应体，适用于开发和测试环境中验证HTTP客户端对不同响应的处理逻辑。

核心功能特性

• 多状态码支持：覆盖所有标准HTTP状态码（1xx-5xx）
• 自定义配置：可设置响应延迟、响应体内容及响应头信息
• 轻量级设计：基于精简基础镜像，资源占用低，启动快速
• 无依赖运行：无需额外服务，单容器即可提供完整功能

使用场景

• API客户端开发测试（验证错误处理逻辑）
• 前端应用HTTP状态响应模拟
• 负载均衡器/反向代理健康检查测试
• HTTP缓存机制验证
• 网络超时与重试策略调试

使用方法

基本用法

通过docker run启动容器，指定所需HTTP状态码：

bash
docker run -d -p 8080:80 --name http-status-test <镜像名称> -e STATUS_CODE=200

访问http://localhost:8080即可获得200状态码响应。

环境变量配置

高级示例

1. 模拟503服务不可用状态

bash
docker run -d -p 8080:80 \
  -e STATUS_CODE=503 \
  -e RESPONSE_BODY="Service Unavailable" \
  -e HEADER_Retry-After=60 \
  <镜像名称>

2. 带延迟的404响应

bash
docker run -d -p 8080:80 \
  -e STATUS_CODE=404 \
  -e DELAY=2000 \
  -e RESPONSE_BODY='{"error": "Resource not found"}' \
  -e HEADER_Content-Type=application/json \
  <镜像名称>

Docker Compose配置

yaml
version: '3'
services:
  http-status:
    image: <镜像名称>
    ports:
      - "8080:80"
    environment:
      - STATUS_CODE=200
      - DELAY=500
      - RESPONSE_BODY="OK"
      - HEADER_Content-Type=text/plain
    restart: always

访问验证

启动后通过curl或浏览器验证：

bash
curl -I http://localhost:8080  # 查看响应头和状态码
curl http://localhost:8080    # 查看响应体内容