simonkowallik/httpbin

httpbin：HTTP请求与响应服务

镜像概述

本镜像为httpbin的自定义分支，针对个人需求进行了更新和优化。由于https://github.com/postmanlabs/httpbin%E9%95%BF%E6%9C%9F%E6%9C%AA%E6%9B%B4%E6%96%B0%EF%BC%8C%E4%BD%9C%E8%80%85%E7%BB%B4%E6%8A%A4%E4%BA%86%E6%AD%A4%E7%89%88%E6%9C%AC%EF%BC%8C%E6%8F%90%E4%BE%9BHTTP%E8%AF%B7%E6%B1%82%E4%B8%8E%E5%93%8D%E5%BA%94%E6%B5%8B%E8%AF%95%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8DWeb%E6%9C%8D%E5%8A%A1%E5%99%A8%E9%85%8D%E7%BD%AE%E3%80%82

核心功能和特性

• 提供完整的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 simonkowallik/httpbin

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

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

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

# 运行unit版本
docker run -p 80:80 -p 443:443 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.io/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.io/simonkowallik/httpbin:nginx

访问/tags端点查看标签：

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

贡献者

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