Docker 镜像文档：arm32v7/drupal

注意事项

本镜像为 drupal 官方镜像 的 arm32v7 架构专用仓库。更多信息请参见官方镜像文档中的 "非 amd64 架构说明" 和官方镜像 FAQ 中的 "镜像源码在 Git 中变更后如何处理？"。

快速参考

维护者

Docker 社区（非 Drupal 社区或 Drupal 安全团队）

获取帮助

Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应 Dockerfile 链接

注意：本镜像描述长度超过 Hub 的 25000 字符限制，因此"支持的标签"列表已被截断。详见 docker/hub-feedback#238 和 docker/roadmap#475。

• 参见 GitHub 文档中的"支持的标签及对应 Dockerfile 链接"

快速参考（续）

问题反馈地址

[***]

支持的架构

(更多信息)
amd64、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

镜像 artifact 详情

repo-info 仓库的 repos/drupal/ 目录（历史记录）
（包含镜像元数据、传输大小等）

镜像更新

official-images 仓库的 library/drupal 标签
official-images 仓库的 library/drupal 文件（历史记录）

本描述的来源

docs 仓库的 drupal/ 目录（历史记录）

什么是 Drupal？

Drupal 是一个免费开源的内容管理框架，采用 PHP 编写并基于 GNU 通用公共许可证分发。全球至少 2.1% 的网站使用 Drupal 作为后端框架，涵盖个人博客、企业网站、政治网站及政府网站（如 WhiteHouse.gov 和 data.gov.uk），也用于知识管理和业务协作。

***.org/wiki/Drupal

!logo

核心功能和特性

• 开源免费：基于 GNU GPL 许可证，允许自由使用、修改和分发
• 多数据库支持：原生支持 SQLite、MySQL、PostgreSQL 等主流数据库
• 可扩展性：通过模块（Modules）、主题（Themes）和配置文件（Profiles）扩展功能
• 灵活架构：适合从个人博客到大型政府网站的各类应用场景
• 多架构支持：覆盖 amd64、arm32v7、arm64v8 等多种硬件架构

使用场景和适用范围

• 个人博客：快速搭建个性化内容发布平台
• 企业网站：构建品牌展示、产品介绍、客户互动门户
• 政府与公共机构网站：满足高安全性和可访问性要求（如 WhiteHouse.gov）
• 知识管理系统：组织和共享企业内部文档与信息
• 业务协作平台：支持团队协作、项目管理和流程自动化

如何使用此镜像

启动 drupal 实例的基本命令模式：

$ docker run --name some-drupal -d arm32v7/drupal

若需从主机直接访问实例（无需通过容器 IP），可使用标准端口映射：

$ docker run --name some-drupal -p 8080:80 -d arm32v7/drupal

随后通过浏览器访问 http://localhost:8080 或 [***]。

本镜像支持多种数据库类型，通常通过 Docker 网络实现互联。默认配置下，可使用 SQLite 数据库（无需额外容器，直接写入扁平文件）。以下为不同数据库类型（更适合生产环境）的详细配置说明。

首次访问镜像提供的 Web 服务时，将进入简短的安装流程。下文详细说明配置过程中的"数据库设置"步骤。

MySQL 数据库配置

使用 MySQL 数据库时，需先启动 MySQL 容器，并通过环境变量配置 MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD 和 MYSQL_ROOT_PASSWORD：

$ 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 \
mysql:5.7

在 Drupal 安装向导的"数据库设置"步骤中，输入上述环境变量配置的值：

• 数据库名称/用户名/密码：<访问 MySQL 实例的详情>（即 MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE；详见 mysql 镜像的环境变量说明）
• 高级选项；数据库主机：some-mysql（同一 docker-network 中的容器可通过容器名称相互访问）

PostgreSQL 数据库配置

使用 PostgreSQL 数据库时，需启动 Postgres 容器，并配置 POSTGRES_DB、POSTGRES_USER 和 POSTGRES_PASSWORD 环境变量：

$ docker run -d --name some-postgres --network some-network \
    -e POSTGRES_DB=drupal \
    -e POSTGRES_USER=user \
    -e POSTGRES_PASSWORD=pass \
postgres:11

在 Drupal 安装向导的"数据库设置"步骤中，输入上述环境变量配置的值：

• 数据库类型：PostgreSQL
• 数据库名称/用户名/密码：<访问 PostgreSQL 实例的详情>（即 POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB；详见 postgres 镜像的环境变量说明）
• 高级选项；数据库主机：some-postgres（同一 docker-network 中的容器可通过容器名称相互访问）

数据卷（Volumes）配置

默认情况下，本镜像不包含任何卷定义。关于卷配置的详细讨论参见 docker-library/drupal#3（推荐阅读）。

社区共识认为 /var/www/html/modules、/var/www/html/profiles 和 /var/www/html/themes 通常应配置为卷（未来版本可能会显式声明 VOLUME），而 /var/www/html/sites 的处理较为复杂，因其内容需从镜像初始化。

使用绑定挂载（bind-mounts）

若使用绑定挂载，可通过以下命令预初始化主机的 sites 目录：

$ docker run --rm arm32v7/drupal tar -cC /var/www/html/sites . | tar -xC /主机路径/sites

然后将其挂载到新容器：

$ docker run --name some-drupal --network some-network -d \
    -v /主机路径/modules:/var/www/html/modules \
    -v /主机路径/profiles:/var/www/html/profiles \
    -v /主机路径/sites:/var/www/html/sites \
    -v /主机路径/themes:/var/www/html/themes \
    arm32v7/drupal

使用 Docker Volumes

$ docker volume create drupal-sites
$ docker run --rm -v drupal-sites:/temporary/sites arm32v7/drupal cp -aRT /var/www/html/sites /temporary/sites
$ 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 \
    arm32v7/drupal

使用 docker compose

drupal 的 compose.yaml 示例：

# Drupal 与 PostgreSQL
#
# 通过 "http://localhost:8080" 访问
#
# 初始化安装时：
# 数据库类型：PostgreSQL
# 数据库名称：postgres
# 数据库用户名：postgres
# 数据库密码：example
# 高级选项；数据库主机：postgres

services:
  drupal:
    image: arm32v7/drupal:10-apache
    ports:
      - 8080:80
    volumes:
      - /var/www/html/modules
      - /var/www/html/profiles
      - /var/www/html/themes
      # 利用 Docker 特性：新的匿名卷会用镜像中对应路径的内容初始化
      - /var/www/html/sites
    restart: always

  postgres:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: example
    restart: always

运行 docker compose up，等待初始化完成后，通过 http://localhost:8080 或 [***] 访问。安装时选择 postgres 数据库，参数如下：dbname=postgres、user=postgres、pass=example、hostname=postgres。

添加额外库/扩展

本镜像不包含任何额外 PHP 扩展或库，即使是热门插件所需的依赖。由于插件数量众多且可能依赖任意 PHP 扩展，包含所有扩展会大幅增加镜像体积。

如需添加 PHP 扩展，需基于本镜像构建自定义镜像。php 镜像文档 详细说明如何编译扩展。此外，drupal:7 Dockerfile 提供了实际示例。

Docker Hub 的以下功能可帮助保持依赖镜像更新：

• 自动构建（Automated Builds）：每次推送代码变更时，Docker Hub 自动构建 Dockerfile。

以任意用户运行

参见 php 镜像文档的"以任意用户运行"部分。

镜像变体

arm32v7/drupal 镜像提供多种变体，适用于不同场景：

arm32v7/drupal:<version>

默认镜像。若不确定需求，建议使用此变体。既可作为临时容器（挂载源码并启动应用），也可作为基础镜像构建其他镜像。

部分标签可能包含 bookworm 或 trixie 等名称，这些是 Debian 的发行版代号，表示镜像基于该版本构建。若需安装额外软件包，建议显式指定发行版代号以减少版本变更风险。

arm32v7/drupal:<version>-fpm

此变体包含 PHP FastCGI 进程管理器（FPM），是推荐的 PHP FastCGI 实现。

使用此变体需配合反向代理（如 NGINX、Apache 或其他支持 FastCGI 协议的工具）。

参考资源：

• FPM 官方配置参考
• @md5 的简化示例
• Pascal Landau 的详细文章
• Stack Overflow 讨论
• Apache httpd Wiki 示例

警告：FastCGI 协议本身缺乏安全性，在私有容器网络外暴露极度危险——除非明确了解风险并接受后果，否则不要使用 Docker 的 --publish（-p）标志发布此变体的端口。

许可证

查看本镜像包含软件的 许可信息。

与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础发行版的 Bash 等），这些软件可能采用其他许可证。

自动检测到的额外许可信息可在 repo-info 仓库的 drupal/ 目录 中找到。

对于预构建镜像的使用，镜像用户有责任确保其使用符合所有包含软件的相关许可证要求。