rattydave/httptest

docker-httptest

镜像概述和主要用途

轻量级Docker容器，当接收到HTTP请求时返回系统信息（uname -a输出），主要用于集群测试、反向代理配置验证及SSL测试等场景。

核心功能和特性

• 轻量级设计，资源占用低
• 接收HTTP请求时返回主机系统信息（uname -a输出）
• 支持与反向代理（如nginx-proxy）集成
• 兼容SSL证书配置（通过letsencrypt-nginx-proxy-companion）
• 支持多架构构建，适配多种硬件平台

使用场景和适用范围

• 集群环境负载均衡测试（验证请求分发）
• 反向代理配置正确性验证
• SSL证书部署及HTTPS访问测试
• 多架构环境兼容性测试

详细使用方法和配置说明

基本设置

轻量级Docker容器，当接收到HTTP请求时会显示uname -a输出，适用于集群测试。

bash
docker run -d --rm --name httptest -p 80:8000 rattydave/httptest

自动更新

若需自动更新镜像，建议使用watchtower工具。

bash
docker run -d \
    --name watchtower \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower

反向代理设置

该场景需配置域名和nginx-proxy（一款易用的反向代理容器）。

1. 首先将域名解析至Docker主机IP（可配置A记录、AAAA记录或CNAME记录）。

2. 启动nginx-proxy容器：

bash
docker run -d --name nginx-proxy \
    --publish 80:80 \
    --publish 443:443 \
    --volume /etc/nginx/certs \
    --volume /etc/nginx/vhost.d \
    --volume /usr/share/nginx/html \
    --volume /var/run/docker.sock:/tmp/docker.sock:ro \
    jwilder/nginx-proxy

3. 启动httptest容器：

bash
docker run -d \
    --env "VIRTUAL_HOST=hostname.com" \
    --env "VIRTUAL_PORT=8000" \
    rattydave/httptest

4. 测试：打开浏览器访问[***] -a输出。多次刷新页面，信息不会变化（单容器实例）。

集群设置

在反向代理设置基础上，启动多个配置相同的httptest容器即可实现集群测试。

启动第二个httptest容器（命令与反向代理设置中的步骤3完全相同）：

bash
docker run -d \
    --env "VIRTUAL_HOST=hostname.com" \
    --env "VIRTUAL_PORT=8000" \
    rattydave/httptest

测试：多次刷新浏览器，可观察到请求在不同容器实例间切换（显示不同主机信息）。可通过相同方式添加更多实例，实现多节点负载测试。

添加SSL证书

如需为反向代理配置SSL证书，可使用与nginx-proxy配套的letsencrypt-nginx-proxy-companion容器。

1. 启动证书管理容器：

bash
docker run --detach \
    --name nginx-proxy-letsencrypt \
    --volumes-from nginx-proxy \
    --volume /var/run/docker.sock:/var/run/docker.sock:ro \
    --env "DEFAULT_EMAIL=your@email.com" \
    jrcs/letsencrypt-nginx-proxy-companion

注意：将your@email.com替换为实际***地址。

2. 修改httptest容器配置，添加SSL相关环境变量：

bash
docker run -d \
    --env "VIRTUAL_HOST=hostname.com" \
    --env "VIRTUAL_PORT=8000" \
    --env "LETSENCRYPT_HOST=hostname.com" \
    rattydave/httptest

3. 测试：通过浏览器访问[***]

构建架构支持

该镜像支持以下架构：

• linux/arm/v5
• linux/arm/v6
• linux/arm/v7
• linux/arm64/v8
• linux/386
• linux/ppc64le
• linux/s390x
• linux/amd64
• linux/mips64le
• linux/riscv64