Strapi 无头 CMS

Strapi 是什么

Strapi 是一款开源、可自托管的无头 CMS（Headless CMS），完全使用 JavaScript/TypeScript 编写。它的核心思路是：开发者定义内容模型，Strapi 自动生成完整 API，任何前端、移动端或 IoT 设备都可以直接消费这些内容。

与传统的“一体化 CMS”不同，Strapi 只负责内容管理与接口输出，不限制前端技术栈。

核心能力

• Content-Type Builder：在管理后台可视化设计内容结构，无需写代码。
• 自动 API：每个内容类型都会自动生成 REST 与 GraphQL 接口。
• 角色与权限：开箱即用的细粒度 RBAC，可控制不同角色对接口的访问。
• 媒体库：内置文件上传与图片管理。
• 国际化（i18n）：支持多语言内容。
• 草稿与发布：内容可先存草稿，确认后再发布。
• TypeScript 支持：一等公民级别的类型支持，数据库可选 SQLite、PostgreSQL、MySQL、MariaDB。
• 插件体系：可开发自定义插件，后台面板也可定制。

请求处理架构

Strapi 的后端采用分层设计，每个请求依次经过：

Routes → Middlewares → Controllers → Services

理解这条链路，是进行后端定制（自定义路由、鉴权中间件、业务逻辑）的基础。

快速开始

使用官方脚手架创建项目：

npx create-strapi@latest my-project

该命令会生成一个包含认证、权限、内容管理、内容类型构建器和文件上传等默认功能的项目。具体的 Node.js 版本、数据库等环境要求，请以官方文档的 Requirements 页面为准。

部署方式

• 自托管：Strapi 不提供官方 Docker 镜像，需要基于自己的项目构建镜像。社区工具 @strapi-community/dockerize 可以生成适配项目的 Dockerfile 与 docker-compose.yml。
• Strapi Cloud：官方托管平台，内置数据库、媒体库与 CDN，省去 DevOps 工作。

适合谁使用

如果你正在做前后端分离的网站、App 或小程序，需要一个能快速产出内容接口、又不想从零写后台的系统，Strapi 是很合适的选择。它同样适合搭建 MVP、企业内部系统后端，以及需要多语言与权限协作的内容平台。

注意事项

• 跨大版本升级时请先阅读官方迁移指南，避免破坏性变更。
• 深度定制后台与插件需要一定的 Node.js 与框架分层知识。
• 高并发场景下建议自行规划缓存、数据库索引与部署架构。

社区与文档

官方文档、Discord、GitHub Discussions 与贡献指南都较为完善，社区内容（教程、模板、starter）丰富，遇到问题通常能较快找到答案。