born05/craft

Craft CMS Docker镜像文档

镜像概述

本Docker镜像是用于部署和运行Craft CMS内容管理系统的容器化解决方案。Craft CMS是一款灵活、强大的开源内容管理系统，适用于构建各类网站和应用。该镜像预配置了Craft CMS运行所需的基础环境，包括Web服务器、PHP运行时及核心依赖，可帮助用户快速搭建Craft CMS运行环境，避免手动配置复杂依赖，提升部署效率。

核心功能和特性

• 环境预配置：内置Nginx/PHP-FPM运行环境，已优化Craft CMS所需的PHP扩展及配置
• 版本兼容性：支持Craft CMS多个稳定版本，可通过标签指定具体版本
• 数据持久化：支持通过数据卷挂载用户上传文件、配置文件及数据库数据，确保数据不丢失
• 灵活配置：通过环境变量自定义数据库连接、安全密钥、基础URL等核心参数
• 隔离性：容器化运行环境，避免与主机系统依赖冲突，确保环境一致性
• 轻量高效：基于官方PHP镜像构建，精简镜像体积，提升运行效率

使用场景和适用范围

• 开发环境：快速搭建本地开发环境，无需手动配置PHP、Web服务器等依赖
• 测试环境：确保测试环境与生产环境一致性，减少环境差异导致的问题
• 生产环境：可用于小型到中型网站的生产部署（建议配合负载均衡和高可用配置）
• 个人博客/企业网站：适合需要灵活内容管理功能的个人或企业站点搭建
• 原型开发：快速构建CMS原型，验证功能需求

使用方法和配置说明

基本使用（Docker Run）

通过以下命令快速启动Craft CMS容器：

bash
docker run -d \
  --name craftcms \
  -p 8080:80 \
  -e CRAFT_APP_ID="your-app-id" \
  -e CRAFT_SECURITY_KEY="your-security-key" \
  -e CRAFT_DB_DRIVER="mysql" \
  -e CRAFT_DB_SERVER="db-host" \
  -e CRAFT_DB_USER="db-user" \
  -e CRAFT_DB_PASSWORD="db-password" \
  -e CRAFT_DB_DATABASE="craft_db" \
  -v ./craft-storage:/app/storage \
  -v ./craft-web:/app/web \
  craftcms/craft

Docker Compose配置

推荐使用docker-compose管理多容器环境（含数据库），示例配置：

yaml
version: '3.8'

services:
  craftcms:
    image: craftcms/craft:latest
    ports:
      - "8080:80"
    environment:
      - CRAFT_APP_ID=your-app-id
      - CRAFT_SECURITY_KEY=your-security-key
      - CRAFT_ENVIRONMENT=production
      - CRAFT_DB_DRIVER=mysql
      - CRAFT_DB_SERVER=db
      - CRAFT_DB_PORT=3306
      - CRAFT_DB_USER=craftuser
      - CRAFT_DB_PASSWORD=craftpassword
      - CRAFT_DB_DATABASE=craftdb
    volumes:
      - craft-storage:/app/storage
      - craft-web:/app/web
    depends_on:
      - db

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DATABASE=craftdb
      - MYSQL_USER=craftuser
      - MYSQL_PASSWORD=craftpassword
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  craft-storage:
  craft-web:
  mysql-data:

启动命令：docker-compose up -d

核心环境变量配置

数据持久化

为确保数据不丢失，需挂载以下目录：

• /app/storage：存储用户上传文件、缓存、日志等数据
• /app/web：网站根目录，包含入口文件及静态资源（如需自定义主题或插件）
• 数据库数据卷（如使用外部数据库，需自行配置持久化）

访问应用

容器启动后，通过 http://localhost:8080 访问Craft CMS安装向导，按提示完成初始配置（设置管理员账户、站点信息等）。生产环境建议配置HTTPS及反向代理（如Nginx）以提升安全性。

注意事项

• 生产环境中需确保CRAFT_SECURITY_KEY保密，避免泄露
• 定期备份挂载的数据卷，防止数据丢失
• 根据实际需求调整PHP内存限制、上传文件大小等配置（可通过自定义php.ini挂载实现）
• 高流量场景建议配合负载均衡及数据库读写分离配置