elestio/strapi-mysql-development

Strapi（由Elestio验证和打包）- MySQL版本

镜像概述和主要用途

https://github.com/strapi/strapi-docker 是一款开源、完全可定制且可扩展的基于JavaScript的无头CMS（内容管理系统）。本镜像由Elestio验证和打包，集成MySQL数据库支持，旨在提供开箱即用的Strapi部署方案，帮助开发者快速构建和管理JavaScript API。

若需创建易于维护的JavaScript API，可通过https://elest.io/%E9%83%A8%E7%BD%B2%E5%AE%8C%E5%85%A8%E6%89%98%E7%AE%A1%E7%9A%84Strapi%E6%9C%8D%E5%8A%A1%EF%BC%8C%E7%AE%80%E5%8C%96%E5%9F%BA%E7%A1%80%E8%AE%BE%E6%96%BD%E7%AE%A1%E7%90%86%E6%B5%81%E7%A8%8B%E3%80%82

核心功能和特性

Strapi核心功能

• 开源免费：基于MIT许可证，代码完全开放，支持自由定制。
• 无头架构：仅提供后端API，与前端框架（React、Vue等）无关，灵活适配多端需求。
• 可扩展性：支持通过插件扩展功能，如身份验证、权限管理、数据验证等。
• 直观管理界面：内置Web管理面板，支持可视化配置内容模型和API端点。

Elestio镜像特性

• 同步更新：与Strapi官方源码保持同步，通过自动化流程快速发布新版本。
• 及时修复：提供最新的bug修复和功能更新，确保稳定性和安全性。
• 质量控制：经过Elestio团队严格测试，符合生产环境标准。

使用场景和适用范围

• API开发：适用于需要快速构建RESTful或GraphQL API的开发者。
• 内容管理：适合需要灵活管理内容结构（如博客、电商、文档）的项目。
• 多环境支持：可部署于开发、测试和生产环境，支持通过环境变量配置差异化参数。
• 中小型项目：轻量化架构，适合资源有限但需高效开发的团队。

详细使用方法和配置说明

Docker Compose部署

以下是通过Docker Compose启动Strapi（含MySQL）的示例配置：

yaml
version: "3"
services:
  strapi:
    image: docker.xuanyuan.run/elestio/strapi-mysql-${NODE_ENV}:${SOFTWARE_VERSION_TAG}  # 镜像名称（含环境和版本标签）
    restart: always  # 自动重启策略
    env_file: .env  # 加载环境变量文件
    environment:
      DATABASE_CLIENT: ${DATABASE_CLIENT}  # 数据库客户端（固定为mysql）
      DATABASE_HOST: db  # 数据库服务名（与下方db服务对应）
      DATABASE_PORT: ${DATABASE_PORT}  # 数据库端口
      DATABASE_NAME: ${DATABASE_NAME}  # 数据库名称
      DATABASE_USERNAME: ${DATABASE_USERNAME}  # 数据库用户名
      DATABASE_PASSWORD: ${DATABASE_PASSWORD}  # 数据库密码
      JWT_SECRET: ${JWT_SECRET}  # JWT密钥
      ADMIN_JWT_SECRET: ${ADMIN_JWT_SECRET}  # 管理员JWT密钥
      APP_KEYS: ${APP_KEYS}  # 应用密钥
      NODE_ENV: ${NODE_ENV}  # 运行环境（development/production）
    volumes:
      - ./config:/opt/app/config  # 配置文件持久化
      - ./src:/opt/app/src  # 源码持久化（开发环境）
      - ./.env:/opt/app/.env  # 环境变量文件映射
      - ./public/uploads:/opt/app/public/uploads  # 上传文件持久化
      - ./entrypoint.sh:/opt/app/entrypoint.sh  # 自定义入口脚本（可选）
    ports:
      - "172.17.0.1:57250:1337"  # 端口映射（主机端口:容器端口）
    depends_on:
      - db  # 依赖db服务启动

  db:
    image: docker.xuanyuan.run/elestio/mysql:8.0  # MySQL镜像（8.0版本）
    restart: always
    environment:
      MYSQL_USER: ${DATABASE_USERNAME}  # 数据库用户名（需与Strapi配置一致）
      MYSQL_ROOT_PASSWORD: ${DATABASE_PASSWORD}  # MySQL root密码
      MYSQL_PASSWORD: ${DATABASE_PASSWORD}  # 数据库用户密码（需与Strapi配置一致）
      MYSQL_DATABASE: ${DATABASE_NAME}  # 数据库名称（需与Strapi配置一致）
    volumes:
      - ./mysql:/var/lib/mysql  # 数据库数据持久化
    ports:
      - "172.17.0.1:22501:3306"  # MySQL端口映射

环境变量配置

创建.env文件，配置以下环境变量（示例值仅供参考，需根据实际情况修改）：

访问方式

部署完成后，通过以下地址访问Strapi管理界面：
http://your-domain:57250

首次访问需使用ADMIN_EMAIL和ADMIN_PASSWORD登录，完成初始配置（如创建内容模型、设置权限等）。

维护操作

日志查看

Strapi容器日志输出至stdout，可通过以下命令查看实时日志：

bash
docker-compose logs -f

停止服务

停止并移除容器（数据卷不会删除）：

bash
docker-compose down

备份与恢复

基于Docker Compose的目录挂载机制，备份和恢复可通过文件系统操作实现：

创建备份

进入docker-compose.yml所在目录，执行以下命令创建压缩包（包含所有配置和数据）：

bash
zip -r strapi_backup.zip .

恢复数据

将备份文件解压至原目录：

bash
unzip strapi_backup.zip -d /path/to/original/folder

重启服务

恢复后启动容器：

bash
docker-compose up -d

相关链接

• https://github.com/strapi/strapi-docker
• https://docs.strapi.io/
• https://elest.io/open-source/strapi-mysql