Strapi v5 快速入门指南

以下是 Strapi v5 快速入门指南，通过最简步骤快速搭建内容管理系统：

---

一、环境准备

1. Node.js：需 v18+（推荐 v20.x）

   node -v  # 验证版本
   

2. 包管理器：npm/yarn/pnpm 任选

   npm install -g yarn  # 可选安装yarn
   

---

二、创建项目

1. 新建Strapi应用（自动使用v5最新版）

   yarn create strapi-app my-project --quickstart
   # 或使用npm
   npx create-strapi-app@latest my-project --quickstart
   

   • --quickstart 参数默认使用SQLite数据库
2. 自动启动
   • 项目创建完成后，浏览器会自动打开 http://localhost:1337/admin
   • 完成管理员账号注册

---

三、核心操作流程

1. 创建内容类型

1. 进入管理后台 ➔ Content-Type Builder
2. 点击 Create new collection type
3. 输入显示名称（如 Article）➔ 继续
4. 添加字段：
   • Text：标题（title，类型选Short text）
   • Rich Text：内容（content）
   • Media：封面图（cover，类型选Single media）
   • Relation：关联分类（可选）
5. 点击 Save 完成模型创建

2. 添加内容

1. 左侧菜单进入 Content Manager
2. 选择刚创建的 Article 集合类型
3. 点击 Create new entry 添加内容
4. 发布内容：保存后点击 Publish

3. 配置API权限

1. 进入 Settings ➔ Users & Permissions ➔ Roles
2. 编辑 Public 角色
3. 找到对应的内容类型（如 article）
4. 勾选 find 和 findOne 权限
5. 点击 Save 保存设置

---

四、访问API

1. 获取内容列表

   GET http://localhost:1337/api/articles
   

2. 获取单条内容

   GET http://localhost:1337/api/articles/1
   

3. 过滤查询（示例：按标题搜索）

   GET http://localhost:1337/api/articles?filters[title][$contains]=strapi
   

---

五、常用开发命令

命令	作用
yarn develop	启动开发服务器
yarn build	构建生产环境
yarn start	运行生产构建
yarn strapi console	进入交互式CLI

---

六、配置文件说明

• 数据库配置：./config/database.js

  module.exports = ({ env }) => ({
    connection: {
      client: 'postgresql', // 切换数据库类型
      connection: {
        host: env('DATABASE_HOST'),
        port: env.int('DATABASE_PORT'),
        database: env('DATABASE_NAME'),
        user: env('DATABASE_USERNAME'),
        password: env('DATABASE_PASSWORD'),
      },
    },
  });
  

• 环境变量：使用 .env 文件存储敏感信息

---

七、扩展建议

1. 自定义API：在 ./src/api/**/controllers/ 下修改控制器
2. 安装插件：

   yarn add @strapi/provider-upload-aws-s3  # 示例：AWS S3上传插件
   

3. 内容审核：使用 Draft & Publish 系统管理内容状态

---

注意事项：

1. 生产环境务必更换默认的SQLite数据库
2. 使用 --quickstart 时自动启用 CORS，正式部署需检查安全配置
3. v5 强化了 TypeScript 支持，可通过 --typescript 参数创建TS项目