Drupal Docker镜像文档

镜像概述与主要用途

Drupal是一款免费开源的内容管理框架（CMS），采用PHP开发并基于GNU通用公共许可证（GPL）发布。它被广泛用于构建各类网站和应用，从小型个人博客到大型企业、政府平台，包括白宫官网（WhiteHouse.gov）和英国数据.gov.uk等知名站点。此外，Drupal也适用于知识管理系统和业务协作平台。

核心功能与特性

• 多数据库支持：兼容SQLite（默认，文件型数据库）、MySQL、PostgreSQL等多种数据库
• 模块化架构：支持通过模块（Modules）、主题（Themes）和配置文件（Profiles）扩展功能
• 跨架构兼容：支持amd64、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x等多种硬件架构
• Docker化部署：支持卷挂载（Volumes）、网络隔离和容器编排工具（如Docker Compose）
• 灵活配置：可通过环境变量和自定义Dockerfile扩展PHP模块或调整运行参数

使用场景与适用范围

• 个人/小型网站：个人博客、小型企业官网，利用SQLite简化部署
• 中大型网站：企业门户、电商平台，配合MySQL/PostgreSQL提升性能
• 政府/机构平台：需要高安全性和可扩展性的政务网站、公共服务平台
• 协作系统：内部知识管理、团队协作平台，通过模块扩展定制功能

快速参考

维护与支持

• 维护者：Docker社区（非Drupal社区或Drupal安全团队）
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux、Stack Overflow
• 提交问题：[***]

镜像信息

• 支持标签：详见官方文档
• 支持架构：amd64、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x（更多信息）
• 镜像元数据：repo-info仓库的repos/drupal/目录（包含传输大小、历史记录等）
• 镜像更新：official-images仓库的library/drupal标签及配置文件
• 文档源代码：docs仓库的drupal/目录

使用方法

基本运行

启动一个简单的Drupal容器：

docker run --name some-drupal -d drupal

端口映射

将容器内80端口映射到主机8080端口，以便通过主机访问：

docker run --name some-drupal -p 8080:80 -d drupal

通过浏览器访问 http://localhost:8080 或 [***] 即可进入Drupal初始化界面。

数据库配置

Drupal支持多种数据库，推荐通过Docker网络连接数据库容器。首次访问时需在初始化界面配置数据库参数。

MySQL

1. 启动MySQL容器（需指定环境变量配置数据库）：

docker run -d --name some-mysql --network some-network \
  -e MYSQL_DATABASE=drupal \       # 数据库名称
  -e MYSQL_USER=user \             # 数据库用户
  -e MYSQL_PASSWORD=password \     # 用户密码
  -e MYSQL_ROOT_PASSWORD=password \ # root密码
mysql:5.7

2. 在Drupal初始化界面的“数据库设置”步骤中输入：
   • 数据库类型：MySQL
   • 数据库名称：drupal（对应MYSQL_DATABASE）
   • 数据库用户名：user（对应MYSQL_USER）
   • 数据库密码：password（对应MYSQL_PASSWORD）
   • 高级选项 > 数据库主机：some-mysql（容器名称，同一网络内可解析）

PostgreSQL

1. 启动PostgreSQL容器：

docker run -d --name some-postgres --network some-network \
  -e POSTGRES_DB=drupal \          # 数据库名称
  -e POSTGRES_USER=user \          # 数据库用户
  -e POSTGRES_PASSWORD=pass \      # 用户密码
postgres:11

2. 在Drupal初始化界面的“数据库设置”步骤中输入：
   • 数据库类型：PostgreSQL
   • 数据库名称：drupal（对应POSTGRES_DB）
   • 数据库用户名：user（对应POSTGRES_USER）
   • 数据库密码：pass（对应POSTGRES_PASSWORD）
   • 高级选项 > 数据库主机：some-postgres（容器名称）

卷挂载

为持久化存储模块、主题、配置文件等，需挂载卷。推荐挂载以下目录：/var/www/html/modules（模块）、/var/www/html/profiles（配置文件）、/var/www/html/themes（主题）、/var/www/html/sites（站点配置）。

方法1：绑定挂载（Bind-Mount）

1. 先将容器内的sites目录初始化到主机（避免挂载空目录覆盖初始化文件）：

docker run --rm drupal tar -cC /var/www/html/sites . | tar -xC /path/on/host/sites

2. 启动容器并挂载目录：

docker run --name some-drupal --network some-network -d \
  -v /path/on/host/modules:/var/www/html/modules \
  -v /path/on/host/profiles:/var/www/html/profiles \
  -v /path/on/host/sites:/var/www/html/sites \
  -v /path/on/host/themes:/var/www/html/themes \
drupal

方法2：Docker卷（Volume）

1. 创建卷并初始化sites目录：

docker volume create drupal-sites
docker run --rm -v drupal-sites:/temporary/sites drupal cp -aRT /var/www/html/sites /temporary/sites

2. 启动容器并挂载卷：

docker run --name some-drupal --network some-network -d \
  -v drupal-modules:/var/www/html/modules \
  -v drupal-profiles:/var/www/html/profiles \
  -v drupal-sites:/var/www/html/sites \
  -v drupal-themes:/var/www/html/themes \
drupal

使用docker compose部署

以下是Drupal与PostgreSQL的compose.yaml示例：

# Drupal with PostgreSQL
# 访问地址：http://localhost:8080
# 初始化Drupal时的数据库配置：
# - 数据库类型：PostgreSQL
# - 数据库名称：postgres
# - 数据库用户名：postgres
# - 数据库密码：example
# - 高级选项 > 数据库主机：postgres

services:
  drupal:
    image: drupal:10-apache
    ports:
      - 8080:80
    volumes:
      - /var/www/html/modules
      - /var/www/html/profiles
      - /var/www/html/themes
      - /var/www/html/sites  # 匿名卷，自动用镜像内容初始化
    restart: always

  postgres:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: example  # 数据库密码
    restart: always

执行docker compose up启动服务，完成后访问http://localhost:8080进行初始化。

镜像变体

drupal:<version>

默认镜像，基于Debian系统，包含Apache Web服务器和PHP环境。适用于大多数场景，可直接运行或作为基础镜像扩展。标签中的bookworm、trixie等为Debian版本代号，建议显式指定以避免系统更新导致的兼容性问题。

drupal:<version>-fpm

包含PHP-FPM（FastCGI进程管理器），需配合反向代理（如NGINX、Apache）使用。注意：FastCGI协议不加密，仅建议在私有容器网络内使用，禁止直接暴露到公网（避免使用-p参数发布端口）。

扩展与自定义

添加PHP扩展

默认镜像不包含额外PHP扩展，如需添加，需基于此镜像构建自定义镜像。参考PHP镜像文档的扩展安装方法，示例Dockerfile：

FROM drupal:10-apache
RUN apt-get update && apt-get install -y \
    libpng-dev \
  && docker-php-ext-install gd  # 安装GD扩展（图像处理）

以任意用户运行

支持以非root用户运行容器，详见PHP镜像文档的“以任意用户运行”部分。

许可信息

• Drupal软件许可：GNU通用公共许可证
• 镜像包含的其他软件：可能包含Debian基础系统组件（如Bash）及依赖库，各自遵循其原始许可协议。
• 使用责任：使用前请确保遵守所有包含软件的许可条款，用户需自行承担合规责任。

镜像元数据及额外许可信息可参考repo-info仓库的drupal/目录。