qfact/neos

Neos CMS 镜像文档

镜像概述和主要用途

Neos CMS Docker镜像是基于PHP-FPM构建的容器化解决方案，旨在简化Neos CMS内容管理系统的部署流程。该镜像提供了预配置的运行环境，通过环境变量即可动态调整数据库连接参数，适用于快速搭建Neos CMS应用实例。

核心功能和特性

• 基于PHP-FPM：采用PHP-FPM运行环境，确保Neos CMS所需的PHP运行时支持
• 环境变量配置：通过环境变量灵活设置数据库连接参数，无需手动修改配置文件
• 安全密码管理：支持通过文件（DB_PASSWORD_FILE）存储数据库密码，优先级高于直接设置的DB_PASSWORD
• 内置配置模板：包含数据库配置文件模板，自动应用环境变量值到Neos CMS配置中

使用场景和适用范围

适用于Neos CMS的开发、测试及生产环境部署，尤其适合采用Docker容器化策略的团队，可无缝集成到Docker Compose编排、Kubernetes集群或CI/CD流程中。

详细使用方法和配置说明

环境变量说明

数据库配置文件

镜像内置数据库配置文件 Configuration/Production/Docker/Settings.Database.yaml，内容如下：

yaml
Neos:
  Flow:
    persistence:
      backendOptions:
        driver: pdo_mysql
        host: '%env:DB_HOSTNAME%'
        dbname: '%env:DB_DATABASE%'
        user: '%env:DB_USER%'
        password: '%env:DB_PASSWORD%'

配置文件会自动读取环境变量值并应用到数据库连接配置中，无需手动修改。

部署示例

基础部署（直接设置密码）

bash
docker run -d \
  -p 9000:9000 \
  -e DB_HOSTNAME=mysql-service \
  -e DB_DATABASE=neos_cms_db \
  -e DB_USER=neos_admin \
  -e DB_PASSWORD=your_secure_password \
  --name neos-cms-instance \
  docker.xuanyuan.run/neos-cms:latest

安全密码文件部署

bash
# 创建密码文件
echo "secure_db_password" > /path/to/db-password.txt

# 运行容器（挂载密码文件）
docker run -d \
  -p 9000:9000 \
  -e DB_HOSTNAME=mysql-service \
  -e DB_DATABASE=neos_cms_db \
  -e DB_USER=neos_admin \
  -e DB_PASSWORD_FILE=/run/secrets/db-password \
  -v /path/to/db-password.txt:/run/secrets/db-password:ro \
  --name neos-cms-instance \
  neos-cms:latest