Drupal是一款开源内容管理平台,支持数百万网站和应用的运行。
Drupal Docker 镜像(i386架构)文档
镜像概述和主要用途
Drupal 是一个免费开源的内容管理框架,使用 PHP 编写并基于 GNU 通用公共许可证分发。它被用作后端框架,支持全球至少 2.1% 的网站,涵盖个人博客、企业网站、和网站(如 *** 和 ***),也用于知识管理和业务协作。
本镜像是 https://hub.docker.com/_/drupal 的 i386 架构版本,提供了在 i386 平台上运行 Drupal 的容器化解决方案,简化部署和管理流程。
核心功能和特性
- 内容管理框架:支持灵活的内容创建、组织和发布,适用于各类网站需求。
- 多数据库支持:兼容 SQLite(默认,文件型数据库)、MySQL、PostgreSQL 等主流数据库。
- 可扩展性:通过模块(Modules)、主题(Themes)和配置文件(Profiles)扩展功能,支持自定义开发。
- 容器化优势:轻量级、隔离性强,便于环境一致性和快速部署。
- 多架构支持:官方镜像提供包括 i386 在内的多种架构版本(如 amd64、arm64v8 等)。
- 灵活的存储配置:支持 Docker 卷(Volume)和绑定挂载(Bind Mount),方便数据持久化和自定义文件管理。
使用场景和适用范围
- 个人博客/小型网站:快速搭建个人或小型站点,利用 SQLite 简化部署。
- **企业/*网站:结合 MySQL/PostgreSQL 数据库,构建高可用性、可扩展的生产环境。
- 开发/测试环境:通过容器化快速创建隔离的开发环境,避免依赖冲突。
- 知识管理系统:利用 Drupal 的内容组织能力,构建企业内部知识库或协作平台。
详细使用方法和配置说明
基本使用
启动基础 Drupal 容器
直接运行容器(默认使用 SQLite 数据库,适合快速测试):
bashdocker run --name some-drupal -d docker.xuanyuan.run/i386/drupal
映射端口以访问服务
将容器内 80 端口映射到主机 8080 端口,通过 http://localhost:8080 访问:
bashdocker run --name some-drupal -p 8080:80 -d docker.xuanyuan.run/i386/drupal
数据库配置
Drupal 支持多种数据库,以下为常用数据库的配置步骤。
MySQL 数据库
- 启动 MySQL 容器(创建自定义网络便于容器通信):
bashdocker 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 \ # root 密码 mysql:5.7
- 启动 Drupal 容器并连接 MySQL:
bashdocker run --name some-drupal --network some-network -p 8080:80 -d docker.xuanyuan.run/i386/drupal
- Drupal 安装向导配置:
- 数据库类型:MySQL
- 数据库名/用户名/密码:
drupal/user/password(与 MySQL 容器环境变量对应) - 高级选项 > 数据库主机:
some-mysql(同一网络内容器可通过容器名访问)
PostgreSQL 数据库
- 启动 PostgreSQL 容器:
bashdocker 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
- 启动 Drupal 容器并连接 PostgreSQL:
bashdocker run --name some-drupal --network some-network -p 8080:80 -d docker.xuanyuan.run/i386/drupal
- Drupal 安装向导配置:
- 数据库类型:PostgreSQL
- 数据库名/用户名/密码:
drupal/user/password(与 PostgreSQL 容器环境变量对应) - 高级选项 > 数据库主机:
some-postgres
数据持久化(卷管理)
Drupal 的模块、主题、配置等文件需持久化存储,推荐使用 Docker 卷或绑定挂载。
方法 1:绑定挂载(Bind Mount)
- 初始化本地目录(复制容器内默认文件到主机):
bash# 创建本地目录 mkdir -p /path/on/host/{modules,profiles,sites,themes} # 复制容器内 sites 目录内容到本地(其他目录默认为空,可直接挂载) docker run --rm docker.xuanyuan.run/i386/drupal tar -cC /var/www/html/sites . | tar -xC /path/on/host/sites
- 挂载本地目录启动容器:
bashdocker 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 \ -p 8080:80 \ docker.xuanyuan.run/i386/drupal
方法 2:Docker 卷(Volume)
- 创建并初始化卷:
bash# 创建卷 docker volume create drupal-modules docker volume create drupal-profiles docker volume create drupal-sites docker volume create drupal-themes # 初始化 sites 卷(复制容器内默认内容) docker run --rm -v drupal-sites:/temporary/sites docker.xuanyuan.run/i386/drupal cp -aRT /var/www/html/sites /temporary/sites
- 使用卷启动容器:
bashdocker 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 \ -p 8080:80 \ docker.xuanyuan.run/i386/drupal
使用 docker compose 部署
以下是结合 PostgreSQL 数据库的 compose.yaml 示例:
yaml# Drupal + PostgreSQL 部署示例 # 访问地址:http://localhost:8080 # 初始化时数据库配置:类型=PostgreSQL,数据库名=postgres,用户名=postgres,密码=example,主机名=postgres services: drupal: image: docker.xuanyuan.run/i386/drupal:10-apache # 使用 i386 架构的 Drupal 镜像 ports: - "8080:80" # 端口映射 volumes: - drupal-modules:/var/www/html/modules - drupal-profiles:/var/www/html/profiles - drupal-sites:/var/www/html/sites # 自动初始化卷内容 - drupal-themes:/var/www/html/themes restart: always # 自动重启 postgres: image: docker.xuanyuan.run/postgres:16 # PostgreSQL 数据库 environment: POSTGRES_PASSWORD: example # 数据库密码 restart: always # 自动重启 volumes: drupal-modules: drupal-profiles: drupal-sites: drupal-themes:
启动命令:
bashdocker compose up -d
添加 PHP 扩展或额外库
本镜像不包含额外 PHP 扩展,若需添加(如 gd、mysqli 等),需基于本镜像构建自定义镜像。参考 https://github.com/docker-library/docs/blob/master/php/README.md#how-to-install-more-php-extensions,示例 Dockerfile:
dockerfileFROM docker.xuanyuan.run/i386/drupal:10-apache # 安装 gd 扩展及依赖 RUN apt-get update && apt-get install -y \ libfreetype6-dev \ libjpeg62-turbo-dev \ libpng-dev \ && docker-php-ext-configure gd --with-freetype --with-jpeg \ && docker-php-ext-install -j$(nproc) gd
以任意用户运行容器
参考 https://hub.docker.com/_/php/,通过调整文件权限或使用 --user 参数运行非 root 用户容器。
镜像变体
i386/drupal:<version>
默认镜像,基于 Apache 服务器,适合大多数场景。标签中的 bookworm、trixie 等为 Debian 发行版代号,指定基础系统版本,建议生产环境显式指定以避免依赖变更。
i386/drupal:<version>-fpm
包含 PHP-FPM(FastCGI 进程管理器),需配合反向代理(如 Nginx、Apache)使用。注意:PHP-FPM 协议不加密,仅用于私有容器网络,避免直接暴露端口。
配置参数与环境变量
数据库环境变量(外部数据库容器)
| 数据库类型 | 环境变量 | 说明 |
|---|---|---|
| MySQL | MYSQL_DATABASE | 数据库名称 |
| MySQL | MYSQL_USER | 数据库用户 |
| MySQL | MYSQL_PASSWORD | 用户密码 |
| MySQL | MYSQL_ROOT_PASSWORD | root 用户密码(可选) |
| PostgreSQL | POSTGRES_DB | 数据库名称 |
| PostgreSQL | POSTGRES_USER | 数据库用户 |
| PostgreSQL | POSTGRES_PASSWORD | 用户密码 |
支持的标签
完整标签列表请参考 https://github.com/docker-library/docs/tree/master/drupal/README.md#supported-tags-and-respective-dockerfile-links。
维护与支持
- 维护方:Docker 社区(非 Drupal 社区或安全团队)
- 问题反馈:https://github.com/docker-library/drupal/issues
- 帮助渠道:https://dockr.ly/comm-slack、https://stackoverflow.com、Server Fault
许可证
Drupal 软件遵循 https://www.drupal.org/licensing/faq。镜像中包含的其他软件(如 Debian 基础系统组件)可能遵循不同许可证,详细信息见 https://github.com/docker-library/repo-info/tree/master/repos/drupal。使用前请确保符合所有软件的许可证要求。
i386 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务