Strapi (v4+) 容器化镜像文档

镜像概述和主要用途

镜像名称：naskio/strapi
支持版本：Strapi v4+（最新版本）

Strapi 是一个开源的内容管理框架（Content Management Framework），旨在简化 API 的创建过程，提供安全、高效的 API 构建能力。本 Docker 镜像将 Strapi v4+ 版本容器化，支持快速部署和运行 Strapi 项目，适用于开发环境快速启动和生产环境稳定部署。

核心功能和特性

• 双模式自动切换：根据 NODE_ENV 环境变量自动选择运行模式
  • 开发环境（NODE_ENV=development）：执行 strapi develop 命令，支持热重载和开发工具
  • 生产环境（NODE_ENV=production）：执行 strapi start 命令，优化性能并禁用开发相关功能
• 项目生命周期支持：可创建新 Strapi 项目或运行现有项目
  • 容器内 /srv/app 目录为空时，自动执行 strapi new 创建新项目
  • 挂载现有项目目录到 /srv/app 时，直接运行该项目
• 多数据库兼容：通过环境变量配置支持 SQLite、PostgreSQL、MySQL、MongoDB 等数据库
• 生产环境安全优化：生产模式下自动禁用 Content-Type Builder 插件，避免运行时修改数据模型

使用场景和适用范围

• 开发环境：快速初始化 Strapi 新项目，利用热重载功能进行 API 和数据模型开发
• 生产环境：部署已开发完成的 Strapi 项目，通过容器化确保环境一致性和稳定性
• 容器化部署需求：适用于需要通过 Docker 或 Docker Compose 管理服务的场景，如 CI/CD 流程、Kubernetes 集群部署等

使用方法和配置说明

基本使用流程

该镜像支持两种核心场景：创建新 Strapi 项目和运行现有 Strapi 项目，具体行为由 /srv/app 目录是否存在项目文件及 NODE_ENV 环境变量决定。

Docker 快速部署示例

开发环境启动（创建新项目）

docker run -d \
  -p 1337:1337 \
  -e NODE_ENV=development \
  -e DATABASE_CLIENT=postgres \
  -e DATABASE_HOST=db \
  -e DATABASE_PORT=5432 \
  -e DATABASE_NAME=strapi_db \
  -e DATABASE_USERNAME=postgres \
  -e DATABASE_PASSWORD=password \
  naskio/strapi

生产环境启动（运行现有项目）

需挂载现有项目目录到容器 /srv/app：

docker run -d \
  -p 1337:1337 \
  -e NODE_ENV=production \
  -v ./path/to/your/strapi/project:/srv/app \
  naskio/strapi

Docker Compose 部署示例

创建 docker-compose.yml 文件，配置如下：

version: "3"
services:
  strapi:
    image: naskio/strapi
    environment:
      NODE_ENV: development  # 或 production
      DATABASE_CLIENT: postgres
      DATABASE_HOST: postgres
      DATABASE_PORT: 5432
      DATABASE_NAME: strapi
      DATABASE_USERNAME: strapi_user
      DATABASE_PASSWORD: strapi_pass
    ports:
      - "1337:1337"
    depends_on:
      - postgres  # 若使用外部数据库，需配置对应服务
    # volumes:
    #   - ./app:/srv/app  # 挂载现有项目时取消注释

  postgres:
    image: postgres:14
    environment:
      POSTGRES_USER: strapi_user
      POSTGRES_PASSWORD: strapi_pass
      POSTGRES_DB: strapi
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

启动命令：docker-compose up -d

环境变量配置

推荐生产环境部署方式

对于生产环境，建议基于 node:18 构建自定义镜像，以确保依赖版本可控和部署稳定性。示例 Dockerfile 如下：

FROM node:18-alpine

# 设置工作目录
WORKDIR /app

# 复制依赖文件并安装
COPY package.json yarn.lock ./
RUN yarn install --frozen-lockfile  # 锁定依赖版本，避免自动更新

# 复制项目文件
COPY . .

# 构建管理面板（生产环境必需）
RUN yarn build

# 暴露端口
EXPOSE 1337

# 启动生产服务
CMD ["yarn", "start"]

构建命令：docker build -t my-strapi-app .
运行命令：docker run -d -p 1337:1337 -e NODE_ENV=production my-strapi-app

官方资源

• Strapi 官方文档：[***]
• 镜像 GitHub 仓库：[***]
• Docker Hub 镜像页：[***]