arquivei/nginx-vts

Nginx + VTS模块 + Prometheus导出器镜像

镜像概述和主要用途

本镜像基于Alpine Linux构建，提供纯净的Nginx环境，集成了VTS（Virtual Host Traffic Status）模块和Prometheus导出器。VTS模块用于收集Nginx的详细流量、连接和请求状态数据，Prometheus导出器则将这些数据转换为Prometheus兼容格式并通过端口9913提供访问，适用于构建轻量级、可监控的Nginx服务。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低，适合容器化部署
• VTS模块集成：包含nginx-module-vts（https://github.com/vozlt/nginx-module-vts%EF%BC%89%EF%BC%8C%E6%94%AF%E6%8C%81%E7%9B%91%E6%8E%A7Nginx%E8%99%9A%E6%8B%9F%E4%B8%BB%E6%9C%BA%E6%B5%81%E9%87%8F%E3%80%81%E8%BF%9E%E6%8E%A5%E6%95%B0%E3%80%81%E8%AF%B7%E6%B1%82%E6%95%B0%E7%AD%89%E5%85%B3%E9%94%AE%E6%8C%87%E6%A0%87
• Prometheus导出器：内置nginx-vts-exporter（https://github.com/hnlq715/nginx-vts-exporter%EF%BC%89%EF%BC%8C%E9%BB%98%E8%AE%A4%E7%9B%91%E5%90%AC9913%E7%AB%AF%E5%8F%A3%EF%BC%8C%E5%B0%86VTS%E6%A8%A1%E5%9D%97%E6%94%B6%E9%9B%86%E7%9A%84%E6%95%B0%E6%8D%AE%E8%BD%AC%E6%8D%A2%E4%B8%BAPrometheus%E5%8F%AF%E6%8A%93%E5%8F%96%E7%9A%84%E6%8C%87%E6%A0%87%E6%A0%BC%E5%BC%8F

使用场景和适用范围

• 生产环境中需要对Nginx服务器进行性能监控的场景
• 容器化架构中集成Nginx监控能力的部署需求
• 开发测试环境中快速搭建带有监控功能的Nginx服务
• 需要将Nginx监控数据接入Prometheus+Grafana监控系统的场景

使用方法和配置说明

基本部署

使用以下命令快速启动容器：

bash
docker run -d -p 80:80 -p 9913:9913 --name nginx-vts-prometheus [镜像名称]

• -p 80:80：映射Nginx默认HTTP端口
• -p 9913:9913：映射Prometheus导出器端口，用于Prometheus抓取监控数据

自定义配置

如需自定义Nginx配置，可通过挂载配置文件实现：

bash
docker run -d -p 80:80 -p 9913:9913 \
  -v /path/to/nginx.conf:/etc/nginx/nginx.conf \
  -v /path/to/conf.d:/etc/nginx/conf.d \
  --name nginx-vts-prometheus [镜像名称]

验证监控数据

启动容器后，可通过以下方式验证监控数据：

1. 访问Nginx默认页面：http://localhost
2. 查看VTS模块状态页面：http://localhost/status
3. 检查Prometheus导出器指标：http://localhost:9913/metrics

Docker Compose示例

yaml
version: '3'
services:
  nginx:
    image: [镜像名称]
    ports:
      - "80:80"
      - "9913:9913"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./conf.d:/etc/nginx/conf.d
    restart: always

注意事项

• 确保VTS模块在Nginx配置中正确启用，通常需要在nginx.conf中添加如下配置：

  nginx
  http {
      vhost_traffic_status_zone;
      vhost_traffic_status_filter_by_host on;
  }
  

• Prometheus导出器默认从http://localhost/status/format/json获取VTS数据，如需修改数据源，可通过环境变量NGINX_STATUS_URL进行配置