Silta Drupal Nginx 镜像文档

镜像概述和主要用途

本镜像基于轻量级Nginx构建，集成了Silta平台针对Drupal应用的特定Nginx配置，旨在简化Drupal应用的部署流程并提供优化的运行环境。主要用途是作为Drupal应用的Web服务器，处理HTTP请求、静态资源服务及PHP-FPM通信，通过预配置的优化参数提升Drupal应用性能。

核心功能和特性

• 轻量级基础：基于***Nginx轻量级镜像构建，减少镜像体积和资源占用
• Silta定制配置：包含Silta平台特有的Nginx配置模板，针对Drupal架构优化
• Drupal专用配置：预设URL重写规则、缓存控制、静态资源处理策略，适配Drupal核心功能
• PHP-FPM集成：优化的FastCGI配置，支持与Drupal后端PHP-FPM服务高效通信
• 安全增强：包含基础安全 headers 配置，防护常见Web安全风险
• 灵活扩展：支持通过环境变量和挂载文件自定义配置，适应不同部署需求

使用场景和适用范围

• 部署Drupal 7/8/9/10版本应用的Web服务层
• 基于Silta工具链的Drupal项目开发、测试及生产环境
• 需要标准化Drupal Nginx配置的容器化部署场景
• 对资源占用敏感且需要优化性能的Drupal应用环境

详细使用方法和配置说明

基本使用（docker run）

docker run -d \
  -p 80:80 \
  -v /path/to/drupal/codebase:/var/www/html \
  -e PHP_FPM_HOST=drupal-php \
  -e DRUPAL_ROOT=/var/www/html \
  --name silta-nginx-drupal \
  [镜像名称]

参数说明：

• -p 80:80：映射容器80端口到主机
• -v /path/to/drupal/codebase:/var/www/html：挂载本地Drupal代码目录到容器内Web根目录
• -e PHP_FPM_HOST：指定PHP-FPM服务地址（必填，通常为Drupal PHP容器名称或IP）
• -e DRUPAL_ROOT：Drupal应用根目录路径（默认：/var/www/html）

Docker Compose 集成示例

version: '3.8'

services:
  nginx:
    image: [镜像名称]
    ports:
      - "80:80"
    volumes:
      - ./drupal:/var/www/html
    environment:
      - PHP_FPM_HOST=php
      - DRUPAL_ROOT=/var/www/html
      - NGINX_ERROR_LOG_LEVEL=warn
    depends_on:
      - php

  php:
    image: [drupal-php-image]
    volumes:
      - ./drupal:/var/www/html

核心环境变量配置

配置自定义

如需修改默认配置，可通过以下方式实现：

1. 挂载自定义配置文件（推荐）：

   docker run -d \
     -p 80:80 \
     -v /path/to/drupal:/var/www/html \
     -v /path/to/custom-nginx.conf:/etc/nginx/conf.d/default.conf \
     [镜像名称]
   

2. 扩展默认配置： 创建/etc/nginx/conf.d/目录下的额外.conf文件，容器会自动加载该目录下所有配置文件：

   docker run -d \
     -p 80:80 \
     -v /path/to/drupal:/var/www/html \
     -v /path/to/custom-configs:/etc/nginx/conf.d/ \
     [镜像名称]
   

注意事项

• 确保Drupal代码目录权限正确配置，容器内Nginx进程用户需有读取权限
• 生产环境建议配合HTTPS反向代理使用，或通过挂载SSL证书配置HTTPS
• 自定义配置时需保留Drupal必要的URL重写规则和PHP处理配置