镜像概述

wodby/nginx是一个通用Nginx Docker镜像，基于官方Nginx优化构建，旨在提供稳定、可配置的Web服务运行环境。该镜像适用于开发与生产环境，支持多种Web服务场景，可通过自定义配置满足不同业务需求。

核心功能和特性

• 基础Nginx功能：完整支持HTTP/HTTPS协议、虚拟主机配置、URL重写、gzip压缩等核心功能
• 配置灵活性：支持挂载自定义Nginx配置文件，覆盖或扩展默认配置
• 环境变量配置：支持通过环境变量动态调整基础配置参数
• 生产级优化：包含常见性能调优参数（如连接数、超时设置），适合生产环境部署
• 日志管理：标准输出日志支持，便于集成日志收集系统（如ELK Stack）

使用场景和适用范围

• 静态网站托管：部署HTML、CSS、JavaScript等静态资源
• 反向代理：将请求转发至后端应用服务（如PHP-FPM、Node.js、Python应用等）
• 负载均衡：对多个后端服务实例进行请求分发，提升系统可用性
• API网关：作为前端请求入口，实现请求路由、认证鉴权等功能
• 开发环境快速搭建：配合docker-compose快速构建本地Web服务环境

使用方法和配置说明

快速启动（docker run）

docker run -d \
  --name nginx \
  -p 80:80 \
  -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf:ro \
  wodby/nginx

Docker Compose配置示例

version: '3.8'

services:
  nginx:
    image: wodby/nginx
    container_name: nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./conf.d:/etc/nginx/conf.d:ro  # 挂载自定义虚拟主机配置
      - ./static:/usr/share/nginx/html:ro  # 挂载静态资源
      - ./ssl:/etc/nginx/ssl:ro  # 挂载SSL证书
    environment:
      - NGINX_HOST=example.com  # 默认主机名
      - NGINX_PORT=80  # 默认端口
    restart: unless-stopped

核心配置说明

1. 配置文件挂载

默认配置路径：

• 主配置文件：/etc/nginx/nginx.conf
• 虚拟主机配置：/etc/nginx/conf.d/*.conf
• 静态资源目录：/usr/share/nginx/html

通过-v参数挂载自定义配置文件覆盖默认配置，例如：

-v ./my-nginx.conf:/etc/nginx/nginx.conf:ro
-v ./my-site.conf:/etc/nginx/conf.d/my-site.conf:ro

2. 环境变量

常见环境变量说明：

3. 自定义配置示例

静态网站托管配置（保存为./conf.d/static.conf）：

server {
    listen 80;
    server_name example.com;
    root /usr/share/nginx/html;
    index index.html index.htm;

    location / {
        try_files $uri $uri/ =404;
    }
}

反向代理配置（保存为./conf.d/proxy.conf）：

server {
    listen 80;
    server_name api.example.com;

    location / {
        proxy_pass [***]  # 后端服务地址
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

部署示例

使用docker-compose部署静态网站：

version: '3.8'

services:
  nginx:
    image: wodby/nginx
    ports:
      - "80:80"
    volumes:
      - ./conf.d:/etc/nginx/conf.d:ro
      - ./static-files:/usr/share/nginx/html:ro
    environment:
      - NGINX_HOST=example.com
    restart: unless-stopped

启动服务：

docker-compose up -d