evilfreelancer/docker-craftcms

Docker容器中的CraftCMS

基于Alpine Linux和最新稳定版PHP构建的超小型CraftCMS镜像，用于快速部署CraftCMS内容管理系统。支持多种部署方式，灵活适配开发、测试及生产环境。

核心功能

• 超小镜像体积，基于轻量Alpine Linux
• 集成最新稳定版PHP环境
• 支持Dockerfile自定义构建、命令行直接运行、docker-compose组合部署
• 灵活的卷挂载，可持久化存储、模板、静态资源等
• 环境变量配置数据库连接、安全密钥等核心参数

使用场景

• 快速搭建CraftCMS网站原型
• 开发环境的本地部署与测试
• 生产环境的容器化部署
• 多环境（开发/测试/生产）的一致化配置

配置说明

环境变量

• SECURITY_KEY: CraftCMS安全密钥（必填）
• DB_DSN: 数据库连接字符串（如mysql:host=mysql;port=3306;dbname=craft-production）
• DB_USER: 数据库用户名
• DB_PASSWORD: 数据库密码

卷挂载推荐路径

• /app/storage: 系统日志、缓存等存储目录
• /app/templates: 网站模板目录
• /app/web/assets: 静态资源（图片、文档等）目录
• /app/web/cpresources: CraftCMS资源目录

部署示例

1. 通过Dockerfile自定义构建

在CraftCMS项目根目录创建Dockerfile：

dockerfile
FROM docker.xuanyuan.run/evilfreelancer/docker-craftcms
ADD ["composer.json", "templates/", "/app"]
ADD ["web/resources/", "/app/resources"]
WORKDIR /app
RUN composer update && chown -R apache:apache /app

构建镜像：

bash
docker build . --tag craftcms-local

2. 命令行直接运行

bash
docker run -e SECURITY_KEY=your_security_key -d -p 80:80 docker.xuanyuan.run/evilfreelancer/docker-craftcms:3

3. docker-compose组合部署（含MySQL）

创建docker-compose.yml：

yml
version: "2"
services:
  mysql:
    image: docker.xuanyuan.run/mysql:5.7
    restart: unless-stopped
    ports:
      - 3306:3306
    environment:
      - MYSQL_DATABASE=craft-production
      - MYSQL_ROOT_PASSWORD=root_pass
      - MYSQL_USER=craft
      - MYSQL_PASSWORD=craft_pass
    volumes:
      - ./databases/mysql:/var/lib/mysql
      - ./logs/mysql:/var/log/mysql
  craftcms:
    image: docker.xuanyuan.run/evilfreelancer/docker-craftcms:3
    restart: unless-stopped
    ports:
      - 80:80
    environment:
      - SECURITY_KEY=your_security_key
      - DB_DSN=mysql:host=mysql;port=3306;dbname=craft-production
      - DB_USER=craft
      - DB_PASSWORD=craft_pass
    volumes:
      - ./craft/storage/logs:/app/storage/logs
      - ./craft/templates:/app/templates
      - ./craft/web/assets:/app/web/assets

启动服务：

bash
docker-compose up -d

后续操作

部署完成后访问http://localhost，通过http://localhost/index.php?p=admin/install完成CraftCMS安装流程。

相关链接

• https://hub.docker.com/r/evilfreelancer/alpine-apache-php7/
• https://github.com/craftcms/craft