manureyesi/batch-opos-galicia-nginx

Nginx Docker镜像文档

1. 镜像概述和主要用途

Nginx（发音为"engine-x"）是一款由Igor Sysoev开发的开源HTTP和反向代理服务器，同时支持IMAP/POP3/SMTP代理功能。作为Docker镜像，Nginx提供了便捷的部署方式，无需复杂环境配置即可快速启动高性能服务器实例。其主要用途包括：

• 作为HTTP服务器托管静态网站或应用资源
• 作为反向代理转发请求至后端应用服务器
• 实现负载均衡，分发流量至多个后端节点
• 提供HTTP缓存以加速内容交付
• 作为邮件代理服务器处理IMAP/POP3/SMTP协议

2. 核心功能和特性

高性能架构

• 采用事件驱动、异步非阻塞处理模型，支持数万并发连接
• 基于内存池管理，减少内存碎片和系统调用开销
• 高效的请求处理流水线，降低延迟

丰富的代理能力

• 完整的反向代理功能，支持HTTP、HTTPS、FastCGI、uWSGI、SCGI等协议
• 内置负载均衡策略：轮询、加权轮询、IP哈希、最少连接等
• 支持WebSocket代理，适用于实时通信场景

缓存与加速

• 内置HTTP缓存机制，可缓存静态资源和API响应
• 支持缓存键自定义、缓存有效期控制及条件请求处理
• 压缩传输（gzip/brotli）减少网络带宽消耗

安全与扩展

• 完整支持SSL/TLS协议，包括SNI、OCSP stapling和现代密码套件
• 模块化设计，支持第三方模块扩展功能
• 内置请求限制、访问控制和HTTP安全头配置

轻量级与稳定性

• 低内存占用（通常运行时仅需数MB内存）
• 高可靠性，支持热部署（无需重启即可应用配置更改）
• 广泛的平台支持，兼容各类Linux发行版及容器环境

3. 使用场景和适用范围

静态资源服务

• 托管HTML、CSS、JavaScript、图片等静态资源
• 适用于个人博客、企业官网、静态应用（如React/Vue单页应用）

反向代理与API网关

• 作为前端应用与后端服务间的中间层，隐藏后端架构
• 实现请求路由、认证鉴权、请求转换和响应处理

负载均衡器

• 在多实例部署环境中分发流量，提高系统可用性和吞吐量
• 适用于微服务架构、高并发API服务和分布式应用

邮件代理

• 作为IMAP/POP3/SMTP代理，实现邮件服务器的负载均衡和安全过滤

CDN节点

• 作为边缘节点缓存静态内容，降低源站压力并加速用户访问

4. 使用方法和配置说明

4.1 基础使用

通过以下命令快速启动Nginx容器：

bash
docker run --name my-nginx -p 80:80 -d nginx

• --name my-nginx：指定容器名称为my-nginx
• -p 80:80：将容器的80端口映射到主机的80端口
• -d：后台运行容器
• nginx：使用最新版Nginx镜像（默认标签为latest）

启动后，访问http://localhost即可看到Nginx默认欢迎页面。

4.2 自定义配置

4.2.1 挂载自定义配置文件

将本地配置文件挂载到容器中替换默认配置：

bash
docker run --name my-nginx -p 80:80 -v /path/to/nginx.conf:/etc/nginx/nginx.conf:ro -d nginx

• /path/to/nginx.conf：本地Nginx配置文件路径
• /etc/nginx/nginx.conf：容器内Nginx主配置文件路径
• :ro：以只读模式挂载，防止容器内修改配置文件

4.2.2 挂载网站根目录

将本地静态文件目录挂载到容器的默认网站根目录：

bash
docker run --name my-nginx -p 80:80 -v /path/to/website:/usr/share/nginx/html:ro -d nginx

• /path/to/website：本地静态文件目录（包含index.html等）
• /usr/share/nginx/html：容器内Nginx默认网站根目录

4.3 Docker Compose示例

创建docker-compose.yml文件实现更复杂部署：

yaml
version: '3'
services:
  nginx:
    image: nginx:alpine  # 使用轻量级Alpine版本
    container_name: my-nginx
    ports:
      - "80:80"
      - "443:443"  # 映射HTTPS端口
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./conf.d:/etc/nginx/conf.d:ro  # 挂载虚拟主机配置
      - ./html:/usr/share/nginx/html:ro  # 静态文件目录
      - ./ssl:/etc/nginx/ssl:ro  # SSL证书目录
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）
    networks:
      - nginx-network

networks:
  nginx-network:
    driver: bridge

启动服务：

bash
docker-compose up -d

4.4 配置参数与环境变量

Nginx官方镜像本身不提供环境变量注入配置的功能，所有配置需通过挂载配置文件实现。常用配置路径：

• 主配置文件：/etc/nginx/nginx.conf
• 虚拟主机配置目录：/etc/nginx/conf.d/（默认包含default.conf）
• 网站根目录：/usr/share/nginx/html
• 日志目录：/var/log/nginx（包含access.log和error.log）

典型虚拟主机配置示例（conf.d/my-site.conf）：

nginx
server {
    listen 80;
    server_name example.com www.example.com;

    root /usr/share/nginx/html;
    index index.html index.htm;

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

    # 启用gzip压缩
    gzip on;
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
}

4.5 高级用法：反向代理与负载均衡

创建负载均衡配置（conf.d/load-balancer.conf）：

nginx
# 定义后端服务器组
upstream backend_servers {
    server backend1:8080 weight=5;  # 权重5
    server backend2:8080;            # 默认权重1
    server backend3:8080 backup;     # 备份服务器
}

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

    location / {
        proxy_pass http://backend_servers;
        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使用时，需确保Nginx容器与后端服务在同一网络中。

5. 注意事项

• 数据持久化：建议将配置文件、网站内容和日志目录通过数据卷（-v）挂载，避免容器删除导致数据丢失
• 配置验证：修改配置后，可通过docker exec -it my-nginx nginx -t验证配置语法正确性
• 版本选择：生产环境建议使用特定版本标签（如nginx:1.25-alpine）而非latest，确保环境一致性
• 资源限制：在高并发场景下，可通过--memory和--cpus参数限制容器资源使用，避免影响主机系统