pangramia/nginx-video-testdata

Nginx OpenResty 监控与测试镜像

镜像概述

本镜像基于Nginx OpenResty构建，集成了Prometheus指标暴露功能，并内置测试MP4文件。OpenResty作为增强型Nginx，提供Lua脚本扩展能力，结合Prometheus监控指标，可实现Web服务性能监控；内置的测试MP4文件则便于快速验证媒体服务功能。

核心功能与特性

• OpenResty基础：基于Nginx OpenResty，支持Lua脚本扩展，可实现复杂业务逻辑
• Prometheus监控：内置指标暴露模块，可通过HTTP端点输出Prometheus兼容的监控数据（如请求量、响应时间、连接数等）
• 测试媒体文件：包含示例MP4文件，用于快速验证媒体服务部署效果
• 轻量部署：优化镜像体积，适合开发测试与轻量级生产环境部署

使用场景

• Web服务开发与测试环境搭建
• Nginx/OpenResty配置验证
• Prometheus监控方案测试与验证
• 媒体服务（如视频点播）功能演示与测试
• 性能基准测试环境构建

使用方法

基本部署

通过docker run命令快速启动容器：

bash
docker run -d -p 80:80 --name openresty-metrics [镜像名称]

参数说明：

• -p 80:80：映射容器80端口到主机80端口，用于HTTP访问
• --name openresty-metrics：指定容器名称

访问验证

容器启动后，可通过以下端点验证功能：

1. 默认页面：访问 http://localhost，查看OpenResty默认欢迎页面
2. Prometheus指标：访问 http://localhost/metrics，获取Prometheus格式监控数据
3. 测试MP4文件：访问 http://localhost/test.mp4，播放内置测试视频文件

配置说明

环境变量

可通过环境变量调整基本配置：

示例：指定自定义指标路径

bash
docker run -d -p 8080:8080 -e NGINX_PORT=8080 -e METRICS_PATH=/prometheus-metrics [镜像名称]

docker-compose配置

创建docker-compose.yml文件进行多容器协同部署：

yaml
version: '3'
services:
  openresty:
    image: [镜像名称]
    ports:
      - "80:80"
    environment:
      - NGINX_PORT=80
      - METRICS_PATH=/metrics
    restart: always

启动命令：docker-compose up -d

监控指标说明

通过/metrics端点暴露的主要指标包括：

• nginx_http_requests_total：总请求数（按状态码分类）
• nginx_http_request_duration_seconds：请求响应时间分布
• nginx_http_connections：当前连接数（active、reading、writing、waiting）
• nginx_upstream_requests_total：上游服务请求数（如有配置）

可直接对接Prometheus+Grafana实现监控可视化。