Strapi怎么用 开源无头CMS搭建教程

Strapi是一个开源的无头CMS，用Node.js构建，可以自定义内容结构，再通过API给前端提供数据，适合做网站和应用后台。它把内容管理与页面展示分开：编辑在后台录入和发布内容，前端则可用React、Vue等技术自由呈现。下面以Strapi 5为例，带你从本地安装到请求数据走一遍。

第一步：安装Strapi

开始前先准备Node.js与npm，并打开终端。进入你打算存放项目的目录，运行命令：npx create-strapi@latest my-project。按终端提示选择配置；想快速体验，也可以运行：npx create-strapi@latest my-project –quickstart。安装过程需要下载依赖，网络较慢时耐心等待，期间不要关闭终端。

项目创建后，进入目录并启动开发服务器：cd my-project，再运行npm run develop。首次启动时，终端会显示后台地址，通常为http://localhost:1337/admin；在浏览器打开它，按页面提示创建管理员账号。登录后就能看到管理面板。开发环境适合本机试用，正式上线前还要配置数据库、环境变量和部署环境。

若安装报错，先确认Node.js与npm能在终端正常运行，再检查网络和项目目录权限。不要在已有重要项目目录里随意执行初始化命令；新手建议单独建一个文件夹。完成安装后，先在后台熟悉左侧菜单，确认服务器仍在运行，再继续创建内容模型。

第二步：创建内容类型和字段

进入后台的Content-Type Builder，点击创建Collection Type，集合类型适合保存多篇文章这类可重复内容。输入名称Article，确认单数和复数API标识后，依次添加字段：用Text保存标题，用Rich Text保存正文，用Date保存发布日期，也可按需要添加图片或布尔字段。字段名称尽量清楚，方便前端调用。

创建字段时按数据特点选择类型：标题一般用短文本，正文用富文本，封面图选媒体字段，分类之间可设置关系。每个字段可配置是否必填、是否唯一以及默认值。完成后保存，Strapi可能提示重启或更新结构，按后台提示确认；此时内容类型会生成管理入口和对应API。

接着打开Content Manager，进入Article集合，点击新建条目，填写标题、正文等内容并保存。若启用了草稿与发布流程，保存不一定代表公众接口已经能读到内容，还需点击Publish发布。先录入一篇简单测试文章，后面请求API时就能检查字段是否符合预期。

配置角色和权限

如果前端要不登录就读取已发布文章，打开Settings，在Users & Permissions Plugin中进入Roles，再选Public。找到Article对应的权限项，勾选find和findOne，分别允许读取列表与单条内容，然后保存。只开放确实需要的读取权限；创建、修改和删除权限不要为了测试随手开放给公众。

保存权限后回到前端测试接口。如果返回403，通常是角色没有对应权限；如果列表为空，检查文章是否已发布、API标识是否正确。涉及写入或用户专属数据时，应使用受控的认证方式与适当权限，不要把高权限API令牌直接放进浏览器代码或公开仓库。

第三步：通过API获取数据

Strapi会按内容类型生成REST接口。若Article的复数API标识是articles，可在浏览器或终端请求http://localhost:1337/api/articles。也可以用fetch在前端获取：fetch(‘http://localhost:1337/api/articles’).then(r => r.json()).then(data => console.log(data))。返回结果通常包含data数组，可遍历其中的文章并渲染标题。

默认响应主要包含顶层字段；关联内容、媒体和组件通常需要通过populate参数请求，例如访问/api/articles?populate=*。需要筛选或排序时，可按REST API支持的查询参数组合请求，并在前端检查响应结构。媒体资源还要留意返回的路径与服务器域名，部署后确保图片地址可从前端访问。

如果接口返回401或403，检查权限或认证配置；若返回404，核对API路径与复数标识；若数据没显示，查看内容是否已发布以及前端读取的字段名。开发阶段可用浏览器开发者工具查看网络请求和JSON响应，逐项定位问题。部署前再配置生产数据库、跨域策略、HTTPS与备份。

如果希望用更直观的方式规划网站页面，也可以了解国内工具墨刀AI；它可作为界面设计与原型协作的补充，和Strapi承担的内容管理、API服务不是同一类工作。官网：modao.cgref.cn。从本地练习开始，先跑通模型、发布和读取，再逐步扩展关系字段与部署配置。