Docker镜像：arm64v8/drupal

镜像概述和主要用途

arm64v8/drupal是Drupal官方镜像的arm64v8架构构建版本。Drupal是一款免费开源的内容管理框架（CMF），采用PHP开发并基于GNU通用公共许可证（GPL）发布。它被广泛用作网站后端框架，支持从个人博客到企业、政府网站（如WhiteHouse.gov、data.gov.uk）等各类场景，同时也适用于知识管理系统和业务协作平台。目前全球至少2.1%的网站使用Drupal作为后端框架。

注意：本镜像由Docker社区维护，非Drupal社区或Drupal安全团队官方维护。

核心功能与特性

• 开源免费：基于GPL许可证，源代码可自由获取和修改
• 多数据库支持：兼容SQLite、MySQL、PostgreSQL等多种数据库
• 模块化架构：通过模块（Modules）扩展功能，支持自定义开发
• 主题系统：提供灵活的主题（Themes）机制，支持界面定制
• 多架构支持：除arm64v8外，还提供amd64、arm32v6、arm32v7等多种架构版本
• 可扩展性：支持从个人站点到大型企业平台的不同规模需求

适用场景和适用范围

• 个人博客：快速搭建个人内容发布平台
• 企业网站：构建品牌展示、产品推广等商业网站
• 政府/机构网站：满足高安全性和可访问性要求的官方站点
• 知识管理系统：构建企业内部文档库、知识库
• 协作平台：支持团队内容协作和信息共享

详细使用方法和配置说明

基本用法

启动基础实例

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

端口映射（主机访问）

将容器内80端口映射到主机8080端口：

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

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

数据库配置

Drupal支持多种数据库，推荐使用Docker网络连接独立数据库容器。首次访问时需通过Web界面完成数据库配置，以下为常见数据库的配置示例。

MySQL配置

1. 启动MySQL容器（创建自定义网络便于容器通信）：

$ docker network create some-network
$ 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=rootpassword \
  mysql:5.7

2. 启动Drupal容器并连接到同一网络：

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

3. Drupal安装向导中的数据库配置：
   • 数据库类型：MySQL
   • 数据库名称：drupal（对应MYSQL_DATABASE）
   • 数据库用户名：user（对应MYSQL_USER）
   • 数据库密码：password（对应MYSQL_PASSWORD）
   • 高级选项 > 数据库主机：some-mysql（MySQL容器名称，同一网络内可通过容器名访问）

PostgreSQL配置

1. 启动PostgreSQL容器：

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

2. 启动Drupal容器：

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

3. Drupal安装向导中的数据库配置：
   • 数据库类型：PostgreSQL
   • 数据库名称：drupal（对应POSTGRES_DB）
   • 数据库用户名：user（对应POSTGRES_USER）
   • 数据库密码：password（对应POSTGRES_PASSWORD）
   • 高级选项 > 数据库主机：some-postgres（PostgreSQL容器名称）

持久化存储（Volumes）

默认情况下，镜像未配置持久化卷。为避免容器重启后数据丢失，需挂载核心目录（模块、主题、配置等）。推荐挂载以下目录：/var/www/html/modules、/var/www/html/profiles、/var/www/html/themes、/var/www/html/sites。

方法1：Bind Mount（主机目录直接挂载）

1. 初始化主机目录（复制镜像中的默认站点配置）：

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

2. 挂载目录启动容器：

$ docker run --name some-drupal -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 \
  -p 8080:80 \
  arm64v8/drupal

方法2：Docker Volume（Docker管理的卷）

1. 创建卷并初始化站点配置：

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

2. 挂载卷启动容器：

$ docker run --name some-drupal -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 \
  -p 8080:80 \
  arm64v8/drupal

Docker Compose配置示例

使用docker-compose快速部署Drupal+PostgreSQL环境，创建compose.yaml文件：

# 访问地址：http://localhost:8080
# Drupal安装时数据库配置：
# - 数据库类型：PostgreSQL
# - 数据库名称：postgres
# - 用户名：postgres
# - 密码：example
# - 数据库主机：postgres

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

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

volumes:
  drupal-modules:
  drupal-profiles:
  drupal-themes:
  drupal-sites:

启动服务：

$ docker compose up -d

添加PHP扩展或依赖

本镜像仅包含基础PHP环境，如需额外扩展（如gd、xmlrpc等），需基于此镜像构建自定义镜像。参考PHP镜像文档的扩展安装方法，示例Dockerfile方向：

FROM arm64v8/drupal:10-apache
RUN apt-get update && apt-get install -y \
    libpng-dev \
    && docker-php-ext-install gd

以非root用户运行

参考PHP镜像的“以任意用户运行”文档，通过--user参数指定用户ID，或在自定义镜像中配置用户权限。

镜像变体

arm64v8/drupal:<version>（默认变体）

基于Apache的标准变体，包含PHP和Apache服务，直接提供Web访问能力。标签中的版本号（如10、9）对应Drupal版本，基础镜像为Debian（标签可能包含Debian代号，如bookworm）。适合大多数场景，开箱即用。

arm64v8/drupal:<version>-fpm（FPM变体）

包含PHP-FPM（FastCGI进程管理器），需配合反向代理（如Nginx、Apache）使用。注意：FastCGI协议不加密，严禁直接暴露到公网，仅在私有容器网络内使用。示例Nginx配置可参考PHP-FPM文档。

配置参数

数据库环境变量（外部数据库容器）

许可证

• Drupal软件许可证：GNU General Public License
• 镜像中其他依赖（如Debian系统组件、PHP等）的许可证信息可参考repo-info仓库。

使用本镜像需遵守所有包含软件的许可证要求。