Strapi 容器化镜像文档

!Strapi

1. 镜像概述和主要用途

概述

strapi/base 是 Strapi 的官方基础镜像，用于构建 strapi/strapi 应用镜像。它提供标准化的运行环境，支持将 Strapi 应用容器化，简化生产环境部署流程。

主要用途

• 作为构建 Strapi 应用镜像的基础层，提供必要的依赖和运行时环境。
• 支持生产环境中 Strapi 应用的打包、分发和部署。
• 确保应用在容器化环境中的一致性和可移植性。

2. 核心功能和特性

• 简化 API 创建：集成 Strapi 框架核心能力，使 API 开发简单、安全且高效。
• 开源内容管理框架：作为先进的开源内容管理框架，支持零配置构建功能强大的 API。
• 容器化优化：专为 Docker 容器化设计，预配置基础依赖（如 Node.js、npm 等），减少构建复杂度。
• 生产环境适配：支持生产环境所需的性能优化和安全配置，满足企业级部署需求。
• 可扩展性：允许通过自定义 Dockerfile 和配置扩展功能，适配不同项目场景。

3. 使用场景和适用范围

使用场景

• 生产环境部署：将 Strapi 应用容器化，简化部署、扩展和维护流程。
• 团队协作开发：提供统一的运行环境，避免因环境差异导致的兼容性问题。
• API 服务构建：快速搭建基于 Strapi 的 API 后端，支持博客、电商、内容平台等场景。

适用范围

• 开发者：需要容器化部署 Strapi 应用的个人或团队开发者。
• 企业：需将 Strapi 作为 API 后端或内容管理系统的企业级应用。
• 项目类型：博客、电商平台、内容管理系统、API 服务等需要灵活数据管理的项目。

4. 详细使用方法和配置说明

4.1 准备工作

• 已安装 Docker 环境（Docker Engine 20.10+）。
• 本地已创建 Strapi 项目（参考 Strapi 官方文档）。

4.2 创建 Dockerfile

在 Strapi 项目根目录下创建 Dockerfile，基于 strapi/base 构建自定义应用镜像。示例参考仓库中的 ./examples/custom 目录。

基础 Dockerfile 结构：

# 基于 strapi/base 镜像
FROM strapi/base

# 设置工作目录
WORKDIR /app

# 复制项目依赖文件（优先复制 package.json 以利用 Docker 缓存）
COPY package.json package-lock.json ./

# 安装生产依赖
RUN npm install --production

# 复制项目源代码
COPY . .

# 构建 Strapi 应用（生成优化后的前端资源）
RUN npm run build

# 暴露 Strapi 默认端口（1337）
EXPOSE 1337

# 启动应用
CMD ["npm", "start"]

4.3 构建应用镜像

在项目根目录执行以下命令构建镜像：

docker build -t my-strapi-app:latest .

• -t my-strapi-app:latest：指定镜像名称和标签（可自定义）。
• .：表示使用当前目录的 Dockerfile。

4.4 启动容器

构建完成后，通过 docker run 启动容器：

docker run -d -p 1337:1337 --name my-strapi-container my-strapi-app:latest

• -d：后台运行容器。
• -p 1337:1337：映射容器端口 1337 到主机端口 1337。
• --name my-strapi-container：指定容器名称。

5. Docker 部署方案示例

5.1 Docker Compose 配置（推荐）

创建 docker-compose.yml 管理多服务（如 Strapi + 数据库），示例如下：

version: '3.8'

services:
  strapi:
    build: .  # 基于当前目录 Dockerfile 构建
    image: my-strapi-app:latest
    ports:
      - "1337:1337"  # 端口映射
    environment:
      # Strapi 核心环境变量（根据实际需求调整）
      - NODE_ENV=production  # 生产环境模式
      - DATABASE_CLIENT=postgres  # 数据库客户端（支持 postgres/mysql/sqlite 等）
      - DATABASE_HOST=db  # 数据库服务名称（与下方 db 服务对应）
      - DATABASE_PORT=5432  # 数据库端口
      - DATABASE_NAME=strapi  # 数据库名称
      - DATABASE_USERNAME=strapi  # 数据库用户名
      - DATABASE_PASSWORD=strapi  # 数据库密码
      - PORT=1337  # 应用监听端口
    depends_on:
      - db  # 依赖 db 服务启动后再启动
    restart: unless-stopped  # 异常退出时自动重启

  db:
    image: postgres:14  # 使用 PostgreSQL 14 镜像（可替换为其他数据库）
    environment:
      - POSTGRES_DB=strapi
      - POSTGRES_USER=strapi
      - POSTGRES_PASSWORD=strapi
    volumes:
      - postgres_data:/var/lib/postgresql/data  # 持久化数据库数据
    restart: unless-stopped

volumes:
  postgres_data:  # 定义数据卷，持久化数据库数据

启动服务：

docker-compose up -d  # 后台启动所有服务

5.2 构建仓库镜像

若需构建本仓库中的基础镜像（非应用镜像），可通过仓库提供的构建脚本操作：

# 查看构建选项
./bin/build.js --help

# 示例：构建指定版本的 strapi/base 镜像
./bin/build.js --version 4.15.0 --platform linux/amd64

6. 配置参数与环境变量

6.1 Strapi 核心环境变量

strapi/base 镜像本身不包含应用级配置，需在 Dockerfile 或部署时通过 environment 传递 Strapi 应用配置，常用变量如下：

6.2 自定义构建参数

构建镜像时可通过 --build-arg 传递自定义参数（如 Node.js 版本），示例：

docker build --build-arg NODE_VERSION=18.x -t my-strapi-app:latest .

7. 注意事项

• 数据持久化：生产环境需通过 Docker 数据卷（Volumes）持久化 Strapi 上传文件和数据库数据，避免容器重启后数据丢失。
• 安全配置：务必设置 ADMIN_JWT_SECRET 等敏感参数，避免使用默认值。
• 版本兼容性：确保 strapi/base 版本与项目中 Strapi 版本匹配，避免依赖冲突。
• 资源限制：部署时根据应用规模配置容器 CPU/内存限制（如 docker run --memory=2g），避免资源耗尽。