valian/nginx-test-page

docker-nginx-test-page

!https://img.shields.io/docker/build/valian/nginx-test-page.svg

镜像概述

这是一个最小化的Nginx（OpenResty）镜像，专为测试Docker集群内的负载均衡设计。最初用于压力测试Docker Swarm网络并通过ELK栈分析结果，同样适用于Kubernetes等其他容器编排工具。

功能预览

bash
>> curl localhost
HOSTNAME=ef25379f3352
IP=12.122.122.12

>> curl localhost/recurse?count=5
12.122.122.12    04ac8923b523    Count 5
12.122.122.12    04ac8923b523    Count 4
12.122.122.12    04ac8923b523    Count 3
12.122.122.12    04ac8923b523    Count 2
12.122.122.12    04ac8923b523    Count 1
12.122.122.12    04ac8923b523    Count 0
# 输出格式：外部IP, 容器ID, 计数器

# 集群负载均衡测试步骤：
# 1. 以多副本形式部署该镜像作为服务（如命名为"nginx-test"）
# 2. 发起递归请求并指定服务主机名
>> curl 'cluster-ip/recurse?count=5&host=nginx-test/recurse'
12.122.122.15    f8f0e76d6e78    Count 5
12.122.122.12    04ac8923b523    Count 4
12.122.122.15    f8f0e76d6e78    Count 3
12.122.122.12    04ac8923b523    Count 2
12.122.122.15    f8f0e76d6e78    Count 1
12.122.122.12    04ac8923b523    Count 0

核心功能与特性

• 支持容器间创建递归请求并合并所有响应结果
• 采用JSON格式日志，可直接发送至logstash等日志收集工具
• 无需额外配置，开箱即用
• 镜像体积小，资源占用低
• 基于OpenResty，具备高性能处理能力

使用场景

• Docker Swarm/Kubernetes等集群环境的负载均衡策略测试
• 容器网络性能压力测试
• 服务请求分发均匀性分析
• 生成跨容器的请求流量用于监控系统验证

使用方法

基本示例

bash
# 启动容器
>> docker run --rm -it -p 80:80 valian/nginx-test-page

# 在另一个终端测试基础响应
>> curl localhost
HOSTNAME=ef25379f3352
IP=12.122.122.12

# 多次重启容器后，仍能正确返回容器ID和公网IP

# 测试递归请求
>> curl localhost/recurse?count=100
12.122.122.12    04ac8923b523    Count 100
12.122.122.12    04ac8923b523    Count 99
...
12.122.122.12    04ac8923b523    Count 0

# 注：单容器运行时，递归请求会在自身容器内完成

Docker Compose扩展示例

bash
# 下载docker-compose配置文件
>> wget https://raw.githubusercontent.com/Valian/docker-nginx-test-page/master/docker-compose.yml

# 启动10个副本
>> docker-compose up --scale nginx-test=10

# 在另一个终端测试跨容器递归请求（使用docker-compose run避免端口冲突）
>> docker-compose run --rm nginx-test curl 'nginx-test:80/recurse?count=100&host=nginx-test/recurse'
12.122.122.12    04ac8923b523    Count 100
12.122.122.12    2ca5192d79d9    Count 99
...
12.122.122.12    c2be082a760c    Count 0
# 输出将显示不同容器ID，验证负载均衡效果

在Docker Swarm或Kubernetes集群中可采用类似方式部署，通过递归请求（如recurse?count=100）可在容器间生成大量请求流量，便于测试集群网络性能。

实现说明

该镜像基于https://openresty.org/en/%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%90%8E%E8%80%85%E6%98%AF%E9%9B%86%E6%88%90%E4%BA%86Lua%E6%94%AF%E6%8C%81%E7%9A%84Nginx%E6%89%A9%E5%B1%95%EF%BC%8C%E5%85%B7%E5%A4%87%E6%9E%81%E9%AB%98%E7%9A%84%E6%80%A7%E8%83%BD%E3%80%82%E9%80%9A%E8%BF%87OpenResty%E7%9A%84%E8%83%BD%E5%8A%9B%EF%BC%8C%E5%8F%AF%E7%9B%B4%E6%8E%A5%E5%9C%A8Nginx%E5%B1%82%E9%9D%A2%E5%AE%9E%E7%8E%B0%E5%AE%B9%E5%99%A8%E9%97%B4%E7%9A%84%E9%80%92%E5%BD%92%E8%AF%B7%E6%B1%82%EF%BC%8C%E6%97%A0%E9%9C%80%E9%A2%9D%E5%A4%96%E6%9C%8D%E5%8A%A1%E7%BB%84%E4%BB%B6%E3%80%82%E8%AF%A6%E7%BB%86%E5%AE%9E%E7%8E%B0%E5%8F%AF%E5%8F%82%E8%80%83%E9%95%9C%E5%83%8F%E5%86%85%E7%9A%84%60nginx.conf%60%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E3%80%82

限制说明

当count参数值过高时，可能导致连接中断。这是因为递归请求会形成"请求链"，每个请求需等待前一个请求完成。

许可证

MIT