Drupal (riscv64) Docker 镜像文档

镜像概述与主要用途

本镜像为 官方 Drupal 镜像 的 riscv64 架构专用版本，用于在 RISC-V 64 位架构环境中部署 Drupal 内容管理系统。Drupal 是一款基于 PHP 开发的免费开源内容管理框架，遵循 GNU 通用公共许可证发布，广泛应用于个人博客、企业官网、政府平台（如 WhiteHouse.gov）等各类网站，同时支持知识管理与业务协作场景。

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

核心功能与特性

• 多版本支持：提供 Drupal 10.x、11.x 等稳定版本，适配 PHP 8.3、8.4 运行环境
• 灵活部署选项：支持 Apache Web 服务器、PHP-FPM 进程管理器及 Alpine 轻量级基础镜像
• 数据库兼容性：兼容 MySQL、PostgreSQL 等主流关系型数据库
• 架构优化：专为 RISC-V 64 位架构构建，确保指令集兼容性与运行效率
• 可扩展性：支持通过自定义 Dockerfile 添加 PHP 扩展及依赖库
• 持久化存储：支持数据卷挂载，实现模块、主题、配置文件的持久化管理

支持的标签及 Dockerfile 链接

Drupal 11.2 系列

• Apache 变体：
  11.2.5-php8.4-apache-trixie, 11.2-php8.4-apache-trixie, 11-php8.4-apache-trixie, php8.4-apache-trixie, 11.2.5-php8.4-apache, 11.2-php8.4-apache, 11-php8.4-apache, php8.4-apache, 11.2.5-php8.4, 11.2-php8.4, 11-php8.4, php8.4, 11.2.5-apache-trixie, 11.2-apache-trixie, 11-apache-trixie, apache-trixie, 11.2.5-apache, 11.2-apache, 11-apache, apache, 11.2.5, 11.2, 11, latest

• FPM 变体：
  11.2.5-php8.4-fpm-trixie, 11.2-php8.4-fpm-trixie, 11-php8.4-fpm-trixie, php8.4-fpm-trixie, 11.2.5-php8.4-fpm, 11.2-php8.4-fpm, 11-php8.4-fpm, php8.4-fpm, 11.2.5-fpm-trixie, 11.2-fpm-trixie, 11-fpm-trixie, fpm-trixie, 11.2.5-fpm, 11.2-fpm, 11-fpm, fpm

• Alpine FPM 变体：
  11.2.5-php8.4-fpm-alpine3.22, 11.2-php8.4-fpm-alpine3.22, 11-php8.4-fpm-alpine3.22, php8.4-fpm-alpine3.22, 11.2.5-php8.4-fpm-alpine, 11.2-php8.4-fpm-alpine, 11-php8.4-fpm-alpine, php8.4-fpm-alpine

其他版本标签

完整标签列表及对应 Dockerfile 链接可参考 官方仓库，包含 Drupal 10.x、11.1.x 等版本的 PHP 8.3/8.4、Apache/FPM/Alpine 组合。

使用场景与适用范围

• 个人博客与中小型网站：通过单容器快速部署，搭配 SQLite 数据库实现轻量化运行
• 企业级应用：结合 MySQL/PostgreSQL 数据库与 Docker Compose 实现高可用部署
• 开发测试环境：利用容器隔离特性，快速搭建一致的 Drupal 开发环境
• RISC-V 架构场景：满足嵌入式设备、边缘计算节点等 RISC-V 平台的 CMS 部署需求

使用方法与配置说明

基础使用

快速启动容器

docker run --name some-drupal -d riscv64/drupal

端口映射（主机可访问）

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

启动后通过 http://localhost:8080 或 [***] 访问 Drupal 安装向导。

数据库配置

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=rootpass \
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
   • 数据库名称/用户名/密码：对应 POSTGRES_DB/POSTGRES_USER/POSTGRES_PASSWORD
   • 数据库主机：some-postgres（容器名称）

数据卷管理

Drupal 的模块、主题、配置文件建议通过数据卷持久化存储，避免容器重建导致数据丢失。

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

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

docker run --rm riscv64/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 \
riscv64/drupal

方法 2：Docker 命名卷

1. 创建并初始化卷：

docker volume create drupal-sites
docker run --rm -v drupal-sites:/temporary/sites riscv64/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 \
riscv64/drupal

Docker Compose 部署

示例 compose.yaml（PostgreSQL 版本）

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

services:
  drupal:
    image: riscv64/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、mbstring），需基于本镜像构建自定义镜像：

FROM riscv64/drupal:11-php8.4-apache
RUN apt-get update && apt-get install -y \
    libpng-dev \
    && docker-php-ext-install gd mbstring \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

以非 root 用户运行

参考 PHP 镜像文档 的 "以任意用户运行" 章节，通过 --user 参数指定运行用户：

docker run --name some-drupal -u 1000:1000 -d riscv64/drupal

镜像变体

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

基于 Debian（如 trixie 版本）构建，包含 Apache Web 服务器，适合直接部署无需额外反向代理的场景。标签中的 trixie 等名称对应 Debian 发行版代号，用于明确基础系统版本。

riscv64/drupal:<version>-fpm

包含 PHP-FPM（FastCGI 进程管理器），需配合 NGINX 等反向代理使用，适用于生产环境的高性能部署。使用时需注意：不要直接暴露 FPM 端口到公网，仅通过私有网络与反向代理通信。

riscv64/drupal:<version>-fpm-alpine

基于 Alpine Linux 构建的轻量级 FPM 变体，镜像体积更小，适合资源受限的场景（如嵌入式设备）。

配置参数与环境变量

数据库容器环境变量

维护与支持

• 维护方：Docker 社区
• 支持渠道：
  • Docker 社区 Slack
  • Server Fault
  • Stack Overflow
• 镜像更新：通过 official-images 仓库 跟踪更新

许可证信息

Drupal 遵循 GNU 通用公共许可证。镜像中包含的其他软件（如 Debian 系统组件、PHP 等）可能具有独立许可证，详细信息可参考 repo-info 仓库。使用本镜像即表示您同意遵守所有包含软件的许可证条款。