elestio/strapi-development

Strapi（由Elestio验证和打包）

镜像概述和主要用途

https://github.com/strapi/strapi-docker 是一款开源、完全可定制且可扩展的JavaScript无头内容管理系统（Headless CMS）。本镜像由Elestio验证和打包，旨在提供稳定、高效的Strapi部署方案，适用于快速开发和管理JavaScript API的场景。通过Elestio镜像，用户可轻松部署功能完备的Strapi实例，满足内容管理、API开发等需求。

核心功能和特性

Strapi核心功能

• 开源免费：基于MIT许可证，源代码完全开放，支持自由定制。
• 无头架构：分离内容管理后端与前端展示，支持多平台（网站、移动应用等）内容分发。
• 可定制性：支持自定义数据模型、API端点、权限控制等。
• 扩展性：通过插件系统扩展功能，如身份验证、文件上传、第三方集成等。
• JavaScript生态：基于Node.js构建，兼容JavaScript/TypeScript，易于前端开发者上手。

Elestio镜像特性

• 同步更新：与Strapi官方源码更新保持同步，通过自动化流程快速发布新版本。
• 及时修复：提供最新的 bug 修复和功能更新，确保镜像稳定性。
• 质量控制：经过Elestio团队的质量检查，确保符合高标准的产品要求。

使用场景和适用范围

• 内容管理系统（CMS）：适用于博客、新闻网站、电商平台等需要灵活管理内容的场景。
• API开发：快速构建和管理RESTful API或GraphQL接口，支持前后端分离架构。
• 应用后端：作为中小型应用的后端服务，处理数据存储、用户认证、权限管理等。
• 开发与生产环境：支持开发（development）和生产（production）模式，满足不同阶段需求。

使用方法和配置说明

Docker Compose部署

以下是使用Docker Compose部署Strapi的示例配置，包含Strapi应用和PostgreSQL数据库服务。

yaml
version: "3"
services:
  strapi:
    image: elestio/strapi-${NODE_ENV}:latest
    restart: always
    env_file: .env
    environment:
      DATABASE_CLIENT: ${DATABASE_CLIENT}
      DATABASE_HOST: db
      DATABASE_PORT: ${DATABASE_PORT}
      DATABASE_NAME: ${DATABASE_NAME}
      DATABASE_USERNAME: ${DATABASE_USERNAME}
      DATABASE_PASSWORD: ${DATABASE_PASSWORD}
      JWT_SECRET: ${JWT_SECRET}
      ADMIN_JWT_SECRET: ${ADMIN_JWT_SECRET}
      APP_KEYS: ${APP_KEYS}
      NODE_ENV: ${NODE_ENV}
    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:9930:1337"            # 端口映射（主机:容器）
    depends_on:
      - db                                # 依赖PostgreSQL服务

  db:
    image: elestio/postgres:latest       # Elestio优化的PostgreSQL镜像
    restart: always
    environment:
      POSTGRES_DB: ${DATABASE_NAME}      # 数据库名称
      POSTGRES_USER: ${DATABASE_USERNAME} # 数据库用户
      POSTGRES_PASSWORD: ${DATABASE_PASSWORD} # 数据库密码
      PGDATA: /var/lib/postgresql/data   # 数据存储路径
    volumes:
      - ./pgdata:/var/lib/postgresql/data # 数据库数据持久化
    ports:
      - "172.17.0.1:24538:5432"          # PostgreSQL端口映射

环境变量配置

创建.env文件，配置以下环境变量（参考示例值）：

访问方式

部署完成后，通过以下地址访问Strapi管理界面：
http://your-domain:9930
（替换your-domain为服务器IP或域名，9930为Docker Compose中映射的主机端口）

维护

日志查看

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

bash
docker-compose logs -f  # -f参数实时跟踪日志

停止服务：

bash
docker-compose down

备份与恢复

由于采用文件夹挂载方式持久化数据，备份和恢复操作简单：

备份数据

1. 停止服务：docker-compose down
2. 进入docker-compose.yml所在目录，执行压缩命令：

   bash
   zip -r strapi_backup.zip .  # 压缩当前目录所有文件（含配置和数据）
   

恢复数据

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

   bash
   unzip strapi_backup.zip -d /path/to/original/folder  # 替换为实际目录
   

2. 启动服务：docker-compose up -d

相关链接

• https://github.com/strapi/strapi-docker
• Strapi官方文档