TYPO3 Docker镜像

镜像概述和主要用途

用于最新TYPO3 LTS版本的Docker镜像，提供Composer和非Composer（legacy）两种项目类型支持，适用于快速部署TYPO3网站。镜像支持AMD64和ARM64架构，可rootless运行，简化TYPO3的安装、配置与维护流程。

镜像类型

仓库包含两种镜像类型：

• 默认镜像：用于管理基于Composer的TYPO3项目，推荐新项目使用此类型，基于composer create-project typo3/cms-base-distribution的项目结构。
• legacy镜像：位于legacy目录，适用于非Composer项目，不推荐新项目使用。

所有镜像均发布在Docker Hub。

Rootless支持

镜像设计支持非root用户运行：

• 非root用户运行时，使用端口8080
• root用户运行时，Apache会切换至www-data用户并监听端口80

有关rootless模式下运行TYPO3调度器的说明，参见定时任务部分或podman-compose.yaml文件。

先决条件

需安装容器运行时环境，如Docker、Podman等。

快速启动

每个版本目录中提供配置文件：

• docker-compose.yaml：适用于rootful部署
• podman-compose.yaml：适用于rootless部署

部署步骤：

1. 创建项目目录并进入
2. 复制对应配置文件到目录中
3. 启动容器：

# Docker Compose (rootful)
docker-compose up -f docker-compose.yaml

# Podman Compose (rootless)
podman-compose --in-pod false -f podman-compose.yaml up

Composer based镜像使用

基于Composer的镜像假设项目结构与composer create-project typo3/cms-base-distribution创建的一致：

• 若项目根目录无composer.json，将自动创建TYPO3基础发行版项目
• 公共文件从/var/www/html/public/目录提供服务

Legacy镜像使用

Legacy镜像适用于现有非Composer项目：

• 不推荐新项目使用
• 公共文件从/var/www/html/public/目录提供服务

环境变量

基础配置

• TYPO3_CONTEXT - TYPO3上下文，可选Production或Development，默认Production
• TYPO3_PROJECT_NAME - 项目名称（仅用于设置），默认New TYPO3 Project
• TYPO3_DB_DRIVER - 数据库驱动，默认pdoMysql

数据库配置（必填项）

• TYPO3_DB_HOST - 数据库主机名
• TYPO3_DBNAME - 数据库名称
• TYPO3_DB_USERNAME - 数据库用户名
• TYPO3_DB_PASSWORD - 数据库密码

数据库可选配置

• TYPO3_DB_PORT - 数据库端口，默认3306

管理员设置（必填项）

• TYPO3_SETUP_ADMIN_EMAIL - 管理员邮箱
• TYPO3_SETUP_ADMIN_USERNAME - 管理员用户名
• TYPO3_SETUP_ADMIN_PASSWORD - 管理员密码

高级配置

• TYPO3_SETUP_CREATE_SITE - 设置期间是否创建站点
• COMPOSER_UPDATE - 运行composer update（仅Composer镜像），默认false
• COMPOSER_NO_DEV - 跳过开发依赖安装（仅Composer镜像），默认false
• MODIFY_CONFIGURATION - 基于环境变量修改TYPO3配置，默认true
• SETUP_TYPO3 - 自动设置TYPO3（无settings.php时），默认true
• SETUP_EXTENSIONS - 处理扩展配置（如数据库schema变更），默认false
• FIX_FILE_PERMISSIONS - 自动修复文件权限，默认true
• SET_OWNER - root运行时设置文件所有者为www-data，默认true
• MANAGE_SRC - 为TYPO3源文件创建符号链接（仅legacy镜像），默认true

Secrets管理

支持通过文件挂载传递敏感信息，环境变量名以_FILE结尾，挂载文件路径需指向包含敏感值的文件。示例：

docker run -e TYPO3_SETUP_ADMIN_PASSWORD_FILE=/run/secrets/typo3-admin-password \
  -v ./admin-password:/run/secrets/typo3-admin-password \
  -d crinis/typo3:tag

支持的_FILE变量：TYPO3_DB_HOST_FILE、TYPO3_DB_PORT_FILE、TYPO3_DBNAME_FILE、TYPO3_DB_USERNAME_FILE、TYPO3_DB_PASSWORD_FILE、TYPO3_SETUP_ADMIN_EMAIL_FILE、TYPO3_SETUP_ADMIN_USERNAME_FILE、TYPO3_SETUP_ADMIN_PASSWORD_FILE

卷

• /var/www/html/ - TYPO3安装根目录，建议挂载以持久化项目数据

对于legacy镜像，可仅挂载/var/www/html/public/目录。如需为特定子目录使用不同存储后端，可单独挂载子目录。

镜像标签

推荐使用具体版本标签以避免意外更新，格式示例：crinis/typo3:13.4-php8.4-apache

TYPO3 12

• 12-php8.4-apache、12.4-php8.4-apache、12、12.4
• Legacy标签：legacy-12-php8.4-apache、legacy-12.4-php8.4-apache、legacy-12.4.26-php8.4-apache（补丁版本）、legacy-12、legacy-12.4、legacy-12.4.26

TYPO3 13

• 13-php8.4-apache、13.4-php8.4-apache、13、13.4、latest
• Legacy标签：legacy-13-php8.4-apache、legacy-13.4-php8.4-apache、legacy-13.4.4-php8.4-apache（补丁版本）、legacy-13、legacy-13.4、legacy-13.4.4、legacy-latest

定时任务

可使用相同镜像的第二个容器运行定时任务，实现关注点分离：

Rootful部署

默认创建/var/spool/cron/crontabs/www-data文件（TYPO3调度器每5分钟运行），需设置入口点：

entrypoint: /usr/sbin/cron -f

详见docker-compose.yaml

Rootless部署

使用Supercronic替代原生cron，默认/typo3/crontab文件（每5分钟运行），需设置入口点：

entrypoint: /usr/local/bin/supercronic /typo3/crontab

详见podman-compose.yaml

作者

Crinis

许可证

本项目采用MIT许可证 - 详见LICENSE.md文件。镜像包含使用不同许可证的第三方软件。

致谢

镜像使用TYPO3 Console简化TYPO3的设置与配置流程。