docker-nginx-full 镜像文档

镜像概述

docker-nginx-full 是一个基于 OpenResty 编译的 Nginx Docker 镜像，集成了 OpenSSL，并启用了所有标准 Nginx 插件。该镜像旨在提供完整的 Nginx 功能支持，适用于需要全面 Nginx 特性的场景。

核心功能与特性

功能亮点

• 完整插件支持：启用所有标准 Nginx 插件，包括但不限于 ngx_http_ssl_module、ngx_http_proxy_module、ngx_http_gzip_module 等
• OpenResty 集成：基于 OpenResty 构建，支持 Lua 脚本扩展，增强 Nginx 功能灵活性
• OpenSSL 支持：内置 OpenSSL，提供安全的 HTTPS 通信能力
• 轻量级设计：优化的 Docker 镜像构建，保持较小体积的同时确保功能完整性

技术特性

• 基于官方 Nginx 源码编译，确保兼容性
• 支持自定义 Nginx 配置文件
• 多平台支持（取决于镜像构建架构）

使用场景与适用范围

该镜像适用于以下场景：

• 需要完整 Nginx 插件支持的 Web 服务器部署
• 复杂反向代理、负载均衡场景
• 需要 Lua 脚本扩展的 Nginx 应用（基于 OpenResty）
• 要求 OpenSSL 特定版本或功能的 HTTPS 服务
• 开发/测试环境中需要快速部署完整 Nginx 功能的场景

使用方法与配置说明

基本使用

快速启动

通过以下命令启动容器，映射默认 HTTP (80) 和 HTTPS (443) 端口：

docker run -d \
  --name nginx-full \
  -p 80:80 \
  -p 443:443 \
  nginxproxymanager/docker-nginx-full

挂载自定义配置

若需使用自定义 Nginx 配置，可通过挂载配置文件或目录实现：

docker run -d \
  --name nginx-full \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/nginx.conf:/etc/nginx/nginx.conf:ro \
  -v /path/to/conf.d:/etc/nginx/conf.d:ro \
  nginxproxymanager/docker-nginx-full

Docker Compose 配置示例

创建 docker-compose.yml 文件：

version: '3'
services:
  nginx-full:
    image: nginxproxymanager/docker-nginx-full
    container_name: nginx-full
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./conf.d:/etc/nginx/conf.d:ro
      - ./ssl:/etc/nginx/ssl:ro
      - ./www:/usr/share/nginx/html
    restart: unless-stopped

启动服务：

docker-compose up -d

配置参数

环境变量

目前该镜像未定义特定环境变量，主要通过挂载配置文件进行自定义。

目录结构

容器内主要配置目录：

• /etc/nginx/nginx.conf: Nginx 主配置文件
• /etc/nginx/conf.d/: 额外配置文件目录（.conf 文件会被自动加载）
• /usr/share/nginx/html: 默认网站根目录
• /var/log/nginx/: 日志目录

自定义配置示例

创建自定义 nginx.conf：

worker_processes auto;

events {
    worker_connections 1024;
}

http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    types_hash_max_size 2048;

    server {
        listen 80;
        server_name localhost;

        location / {
            root /usr/share/nginx/html;
            index index.html index.htm;
        }
    }
}

注意事项

• 该镜像包含所有标准 Nginx 插件，镜像体积可能大于精简版 Nginx 镜像
• 自定义配置时需确保兼容 Nginx 版本及已启用的插件
• 更多详细配置与高级用法请参考 官方 GitHub 仓库