droptica/nginx Docker 镜像 - 轩辕镜像

Nginx for Drupal 镜像文档

镜像概述

Nginx for Drupal 是专为Drupal内容管理系统设计的Web服务器镜像，基于官方Nginx构建并针对Drupal特性优化。该镜像集成了Drupal运行所需的核心配置，包括URL重写规则、PHP-FPM连接支持、缓存策略及安全头配置，旨在简化Drupal应用的部署流程，降低环境配置复杂度。

核心功能与特性

• Drupal专用配置：预配置符合Drupal规范的Nginx规则，支持Clean URLs（无URL参数的友好链接）、.htaccess功能转换及路径别名解析。
• PHP-FPM集成：默认配置PHP-FPM后端连接，适配Drupal的PHP运行需求，支持动态调整连接参数。
• 性能优化：内置FastCGI缓存、静态资源缓存（JS/CSS/图片）及Gzip压缩，提升Drupal页面加载速度。
• 安全增强：预设安全HTTP头（如X-Content-Type-Options、X-Frame-Options、Content-Security-Policy），限制***请求。
• 版本兼容：支持Drupal 7/8/9/10版本，自动适配不同版本的目录结构和配置需求。
• 灵活扩展：支持自定义配置覆盖、SSL/TLS证书挂载及日志持久化。

使用场景

• 开发环境：快速搭建本地Drupal开发环境，无需手动配置Nginx规则。
• 测试环境：模拟生产环境配置，验证Drupal功能及性能。
• 生产环境：部署中小型Drupal网站（如企业官网、博客、电商平台），提供稳定的Web服务支撑。

使用方法

前置条件

• 已安装Docker Engine（20.10+）或Docker Desktop。
• 已准备Drupal代码目录（本地路径或数据卷）。
• 需配合PHP-FPM容器（如php:8.1-fpm、drupal/php-fpm）使用。

基本部署（Docker Run）

bash
docker run -d \
  --name nginx-drupal \
  -p 80:80 \  # HTTP端口映射
  -e PHP_FPM_HOST=php-fpm \  # PHP-FPM容器名称/IP
  -e PHP_FPM_PORT=9000 \     # PHP-FPM监听端口
  -v /path/to/drupal:/var/www/html \  # 挂载Drupal代码目录
  nginx-for-drupal:latest

生产环境部署（Docker Compose）

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  nginx:
    image: nginx-for-drupal:latest
    ports:
      - "80:80"
      - "443:443"  # 若启用SSL
    environment:
      - PHP_FPM_HOST=php
      - PHP_FPM_PORT=9000
      - DRUPAL_ROOT=/var/www/html  # Drupal根目录（默认无需修改）
      - ENABLE_SSL=true  # 启用SSL（需挂载证书）
    volumes:
      - ./drupal:/var/www/html  # Drupal代码目录
      - ./nginx/ssl:/etc/nginx/ssl  # SSL证书目录（包含cert.pem和key.pem）
      - ./nginx/conf.d:/etc/nginx/conf.d  # 自定义配置覆盖（可选）
      - nginx-logs:/var/log/nginx  # 日志持久化
    depends_on:
      - php

  php:
    image: php:8.1-fpm
    volumes:
      - ./drupal:/var/www/html
    environment:
      - PHP_MEMORY_LIMIT=256M  # 根据Drupal需求调整PHP内存

volumes:
  nginx-logs:  # 日志数据卷

启动服务：

bash
docker-compose up -d

环境变量配置

自定义配置

如需修改Nginx配置，可通过以下方式：

1. 覆盖默认配置：挂载自定义配置文件到/etc/nginx/conf.d/目录，文件名以.conf结尾（如drupal-custom.conf），配置将自动加载并覆盖默认规则。

2. 修改SSL证书：启用SSL时，需将证书文件（cert.pem公钥、key.pem私钥）挂载到/etc/nginx/ssl/目录，镜像将自动配置HTTPS监听。

注意事项

• 权限配置：确保Drupal代码目录权限允许Nginx读取（容器内运行用户为nginx，UID/GID=101）。
• 版本兼容性：Drupal 7需额外配置$conf['clean_url'] = 1;（数据库variable表或settings.php）。
• 性能调优：生产环境建议调整worker_processes（默认=CPU核心数）及worker_connections（默认=1024），通过自定义配置文件实现。
• 日志管理：建议通过数据卷挂载日志目录，避免容器内日志占满存储空间。

配置示例：启用SSL并自定义缓存

1. 准备SSL证书：将cert.pem和key.pem放入本地./nginx/ssl/目录。

2. 创建自定义配置文件./nginx/conf.d/cache.conf：

nginx
# 调整FastCGI缓存大小
fastcgi_cache_path /var/cache/nginx levels=1:2 keys_zone=DRUPAL:100m inactive=60m;
fastcgi_cache_key "$scheme$request_method$host$request_uri";
# 延长静态资源缓存时间
location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
  expires 30d;
  add_header Cache-Control "public, max-age=2592000";
}

3. 启动服务：

bash
docker-compose up -d