excodibur/strapi

Strapi (v4+) 容器化镜像

镜像概述

Strapi是一款开源内容管理框架（CMF），旨在帮助开发者高效构建安全且强大的API。本镜像提供Strapi v4及以上版本的容器化部署方案，支持新项目初始化和现有项目运行，适配开发与生产环境需求。

核心功能

• 支持创建新Strapi项目（默认使用SQLite数据库）
• 可运行已有Strapi项目（通过挂载项目目录）
• 根据NODE_ENV自动切换命令：开发环境执行strapi develop，生产环境执行strapi start
• 生产环境自动禁用Content-Type Builder插件
• 支持配置多种数据库（SQLite、PostgreSQL、MySQL、MongoDB），通过环境变量设置参数

使用场景

• 开发者快速初始化Strapi项目进行本地开发测试
• 部署Strapi应用到生产环境提供API服务
• 对现有Strapi项目进行容器化改造，简化运维流程

配置说明

环境变量

• NODE_ENV：环境类型，可选development（开发）或production（生产）
• 数据库配置变量（创建新项目时生效）：
  • DATABASE_CLIENT：数据库类型（sqlite/postgres/mysql/mongo）
  • DATABASE_HOST：数据库主机地址
  • DATABASE_PORT：数据库端口
  • DATABASE_NAME：数据库名称
  • DATABASE_USERNAME：数据库用户名
  • DATABASE_PASSWORD：数据库密码
  • DATABASE_SSL：是否启用SSL（布尔值）
  • EXTRA_ARGS：传递给strapi new的额外参数

部署示例

Docker Compose方式

创建docker-compose.yml文件：

yaml
version: "3"
services:
  strapi:
    image: naskio/strapi
    environment:
      NODE_ENV: development # 或 production
    ports:
      - "1337:1337"
    # volumes:
    #   - ./app:/srv/app # 挂载现有Strapi项目目录

Docker Run方式

shell
docker run -d -p 1337:1337 naskio/strapi --env NODE_ENV=development

运行现有项目

将现有Strapi项目目录挂载到容器/srv/app路径：

yaml
# docker-compose.yml添加volumes配置
volumes:
  - ./your-strapi-project:/srv/app

生产部署推荐

生产环境建议基于Node.js镜像构建自定义项目镜像，示例Dockerfile：

dockerfile
FROM node:18
# 或 FROM strapi/base:latest

WORKDIR /app

COPY package.json .
COPY yarn.lock .

RUN yarn install --frozen-lockfile

COPY favicon.ico ./favicon.ico
COPY src/ src/
COPY public/ public/
COPY database/ database/
COPY config/ config/

RUN yarn build

EXPOSE 1337

CMD ["yarn", "start"]

官方文档

• Strapi官方文档：https://docs.strapi.io/
• Strapi官方Docker镜像（未升级到v4）：https://github.com/strapi/strapi-docker