dunadigital/strapi

Strapi v4 Docker镜像

镜像概述和主要用途

本镜像为Strapi v4提供容器化部署方案，延续原官方Docker项目结构。因官方Strapi Docker项目已停止维护，本镜像在其基础上进行优化，支持AMD64和ARM64v8架构，可自动适配系统架构，简化Strapi应用的部署流程。

核心功能和特性

• 多架构支持：同时提供AMD64和ARM64v8镜像，系统自动选择适配版本
• 镜像体积优化：自4.25.2版本起重构Dockerfile，移除预安装Strapi，显著减小镜像体积
• 自动项目初始化：启动时若未检测到package.json，自动在/srv/app目录安装TypeScript基础项目（需挂载该目录）
• 智能依赖管理：检测到package.json但无node_modules时，自动使用npm或yarn安装依赖（优先yarn，若存在yarn.lock）
• 默认数据库配置：使用MariaDB作为默认数据库，支持通过配置修改为其他数据库

版本更新日志

4.25.6

• 将Strapi更新至4.25.6版本

4.25.5

• 将Strapi更新至4.25.5版本

4.25.2

• 将NodeJS版本更新至20.15
• 重构Dockerfile，不再预安装Strapi，减小镜像体积
• 重构entry.sh脚本，使用yarn create strapi-app替代strapi new创建新项目
• 启动时若未找到package.json，自动在/srv/app安装TypeScript项目（需挂载目录）
• 支持npm/yarn自动依赖安装（根据yarn.lock存在与否选择）
• 默认数据库从PostgreSQL改为MariaDB，可在配置中修改

使用场景和适用范围

适用于需要快速部署Strapi v4的开发者、小型团队或个人项目，尤其适合跨架构部署场景（如AMD64服务器与ARM64v8设备），简化Strapi应用的搭建、维护和迁移流程。

使用方法和配置说明

环境变量配置

主要环境变量说明：

• NODE_ENV：运行环境（如production、development）
• DATABASE_CLIENT：数据库客户端（如mysql、postgres）
• DATABASE_HOST：数据库主机地址
• DATABASE_PORT：数据库端口
• DATABASE_NAME：数据库名称
• DATABASE_USERNAME：数据库用户名
• DATABASE_PASSWORD：数据库密码
• JWT_SECRET：JWT密钥
• ADMIN_JWT_SECRET：管理员JWT密钥
• APP_KEYS：应用密钥（多个密钥用逗号分隔）

Docker Compose部署示例

以下配置包含Strapi服务和MariaDB数据库，支持数据持久化：

yaml
services:
  strapi:
    container_name: strapi
    image: dunadigital/strapi:4.25.6
    environment:
      NODE_ENV: production
      DATABASE_CLIENT: mysql
      DATABASE_HOST: mariadb
      DATABASE_PORT: 3306
      DATABASE_NAME: strapi
      DATABASE_USERNAME: strapi
      DATABASE_PASSWORD: strapi
      JWT_SECRET: YOUR_SECRET  # 替换为实际密钥
      ADMIN_JWT_SECRET: YOUR_SECRET  # 替换为实际密钥
      APP_KEYS: YOUR_SECRET,YOUR_SECRET,YOUR_SECRET,YOUR_SECRET  # 替换为实际密钥
    ports:
      - "1337:1337"  # Strapi默认端口
    volumes:
      - ./app:/srv/app  # 挂载应用目录，持久化项目文件
  mariadb:
    container_name: mariadb
    image: mariadb:10.6
    environment:
      MARIADB_ROOT_PASSWORD: root  # 数据库 root 密码
      MYSQL_DATABASE: strapi  # 数据库名称
      MYSQL_USER: strapi  # 数据库用户名
      MYSQL_PASSWORD: strapi  # 数据库密码
    ports:
      - "3306:3306"  # MariaDB默认端口
    volumes:
      - ./data:/var/lib/mysql  # 挂载数据库目录，持久化数据

部署步骤

1. 创建项目目录，保存上述docker-compose.yml文件
2. 替换配置中的YOUR_SECRET为实际安全密钥
3. 执行docker-compose up -d启动服务
4. 首次启动时，Strapi会自动在./app目录初始化项目
5. 访问http://localhost:1337进入Strapi管理界面