simonkowallik/httpbin

httpbin：HTTP请求与响应服务

镜像概述

本镜像为httpbin的自定义分支，针对个人需求进行了更新和优化。由于https://github.com/postmanlabs/httpbin长期未更新，作者维护了此版本，提供HTTP请求与响应测试功能，支持多种Web服务器配置。

核心功能和特性

• 提供完整的HTTP请求与响应测试能力
• 支持多种Web服务器环境（nginx、nginx unit、httpd等）
• 内置HTTPS/HTTP2支持，自动生成TLS证书（可自定义替换）
• 支持自定义HTTP响应头和标签
• 提供Alpine和Debian多种基础镜像版本，满足不同环境需求

支持的Docker标签

标签详细说明

:nginx

• 支持HTTPS和HTTP2
• 可通过Docker映射自定义配置和证书：
  • /etc/nginx/ssl/dhparam.pem
  • /etc/nginx/ssl/eccert.pem (ecdsa证书)
  • /etc/nginx/ssl/eckey.pem (ecdsa密钥)
  • /etc/nginx/ssl/cert.pem (rsa证书)
  • /etc/nginx/ssl/key.pem (rsa密钥)
  • /etc/nginx/ssl/chain.pem
  • /etc/nginx/nginx.conf
  • /etc/uwsgi/uwsgi.ini

:unit

• 支持HTTPS和HTTP2
• 可通过Docker映射自定义配置和证书：
  • /var/lib/unit/certs/bundle (证书 bundle，需按 cat cert.pem cachain.pem key.pem > bundle 格式创建)
  • /var/lib/unit/conf.json

:httpd 和 :httpd-alpine

• 支持HTTPS
• 可通过Docker映射自定义配置和证书：
  • /usr/local/apache2/conf/ssl/dhparam.pem
  • /usr/local/apache2/conf/ssl/eccert.pem (ecdsa证书)
  • /usr/local/apache2/conf/ssl/eckey.pem (ecdsa密钥)
  • /usr/local/apache2/conf/ssl/cert.pem (rsa证书)
  • /usr/local/apache2/conf/ssl/key.pem (rsa密钥)
  • /usr/local/apache2/conf/ssl/chain.pem
  • /usr/local/apache2/conf/httpd.conf
  • /usr/local/apache2/conf/extra/vhosts/*.conf
  • /etc/uwsgi/uwsgi.ini

使用方法

简单示例

sh
# 运行基础版本（仅HTTP）
docker run -p 80:80 docker.xuanyuan.run/simonkowallik/httpbin

# 运行nginx版本（支持HTTPS/HTTP2）
docker run -p 80:80 -p 443:443 docker.xuanyuan.run/simonkowallik/httpbin:nginx

# 运行httpd版本
docker run -p 80:80 -p 443:443 docker.xuanyuan.run/simonkowallik/httpbin:httpd

# 运行httpd-alpine版本
docker run -p 80:80 -p 443:443 docker.xuanyuan.run/simonkowallik/httpbin:httpd-alpine

# 运行unit版本
docker run -p 80:80 -p 443:443 docker.xuanyuan.run/simonkowallik/httpbin:unit

高级特性

在每个响应中返回自定义HTTP头

通过环境变量 XHTTPBIN_X_<header-name> 设置自定义HTTP头：

shell
docker run -it --rm -p 80:80 -p 443:443 \
  -e XHTTPBIN_X_instance_id="instance-id-1" \
  ***-ghcr.xuanyuan.run/simonkowallik/httpbin:unit

验证自定义头：

shell
curl -vsk http://localhost/get
# 响应中将包含:
# < X-instance-id: instance-id-1

在/tags端点设置自定义标签

通过环境变量 HTTPBIN_<tag-name> 设置自定义标签：

shell
docker run -it --rm -p 80:80 -p 443:443 \
  -e HTTPBIN_Instance=1 \
  -e HTTPBIN_2ndTag="Some Value" \
  ***-ghcr.xuanyuan.run/simonkowallik/httpbin:nginx

访问/tags端点查看标签：

shell
curl -vsk http://localhost/tags
# 响应:
# {
#   "2ndTag": "Some Value",
#   "Instance": "1"
# }

贡献者

感谢 https://github.com/v-slenter 对 #9 的贡献。