sdommergues/nginx-test

nginx-test 镜像文档

概述

nginx-test 是一个专为测试环境设计的 Nginx 服务器镜像，基于官方 Nginx 镜像构建，旨在为开发和测试阶段提供便捷的 Web 服务部署方案。该镜像保留了 Nginx 的核心功能，并针对测试场景优化了配置灵活性，方便开发人员快速验证 Web 服务配置、API 接口及静态资源服务。

核心功能与特性

• 基础 HTTP 服务：支持静态文件托管、HTTP 协议处理，满足基本 Web 服务需求
• 反向代理能力：可配置反向代理规则，用于测试后端服务接口转发
• 测试环境优化：默认配置简化，便于快速启动和修改，适合临时测试场景
• 轻量级设计：基于 Alpine 或 slim 基础镜像，镜像体积小，启动速度快
• 配置灵活：支持通过环境变量或挂载配置文件自定义 Nginx 配置

使用场景

• 开发阶段本地 Web 服务测试
• API 接口反向代理测试
• 前端静态资源本地预览
• Nginx 配置文件语法及功能验证
• 临时测试环境的 Web 服务搭建

使用方法

快速启动

通过以下命令快速启动一个基础 Nginx 测试服务：

bash
docker run -d -p 8080:80 --name nginx-test-container nginx-test

启动后，可通过 http://localhost:8080 访问默认测试页面。

挂载自定义配置

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

bash
docker run -d -p 8080:80 \
  -v /path/to/your/nginx.conf:/etc/nginx/nginx.conf:ro \
  --name nginx-test-container nginx-test

环境变量配置

支持通过环境变量调整基础配置（具体变量取决于镜像实现，以下为常见示例）：

• NGINX_PORT：指定服务端口，默认 80
• NGINX_ROOT：指定静态文件根目录，默认 /usr/share/nginx/html
• PROXY_PASS：配置反向代理目标地址，如 http://backend-service:3000

示例（配置反向代理）：

bash
docker run -d -p 8080:80 \
  -e PROXY_PASS=http://backend-service:3000 \
  --name nginx-test-container nginx-test

docker-compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  nginx-test:
    image: nginx-test
    ports:
      - "8080:80"
    environment:
      - NGINX_ROOT=/usr/share/nginx/html/test
      - PROXY_PASS=http://backend:3000
    volumes:
      - ./test-html:/usr/share/nginx/html/test
    depends_on:
      - backend

  backend:
    image: your-backend-image
    ports:
      - "3000:3000"

启动服务：

bash
docker-compose up -d

注意事项

• 该镜像仅适用于测试环境，不建议用于生产环境
• 自定义配置时需确保 Nginx 配置语法正确，可通过 nginx -t 命令验证
• 挂载配置文件时注意文件权限，避免因权限问题导致启动失败