怎么用Decap CMS给客户做内容后台

---

Decap CMS 是一个基于 Git 的内容管理系统，给静态网站生成器用的。它的前身是 Netlify CMS，2023 年 2 月改了名，现在由 decaporg 组织维护。简单说，它把内容管理的后台塞进静态网站的 /admin 路径里，编辑保存的内容直接提交到 Git 仓库，不需要单独买服务器、也不用搭数据库。

适合谁

个人博客维护者。用 Hugo、Jekyll、Eleventy 这类静态生成器搭博客的人，平时写文章要么命令行敲 Markdown、要么本地编辑器写完再 push。Decap CMS 装好后，浏览器打开网站 /admin 就能写、能改、能发布，免去本地环境折腾。

小团队内容协作。几个人一起维护公司官网、文档站或项目落地页，不是每个人都熟悉 Git 提交流程。Decap CMS 提供可视化的富文本编辑、图片上传、草稿管理，编辑人员只负责写，不碰命令行。

想把手写 Markdown 交付给客户的开发者。给客户做展示站、作品集，客户日后要自己改文案、加案例，把 Decap CMS 装进项目里，交付时附一份说明，客户自己更新内容，不用反复找你改代码。

能解决什么问题

静态网站没有后台的问题。静态网站生成器产物是纯 HTML 文件，部署简单、加载快，但没有内容管理界面。Decap CMS 用单页应用解决这个缺口，拉到 /admin 路径，登录后就能编辑。

多人提交内容的冲突与权限问题。内容以 Git 仓库为存储层，每次保存都是一次提交，天然有版本记录，改坏了能回滚。配合 Git 平台的账号体系，谁改了什么一目了然。

内容模型需要规范化的场景。团队内容多、栏目杂，Decap CMS 用一份 YAML 配置文件描述内容模型——文章有哪些字段、哪些是必填、用列表还是对象，编辑界面跟着配置走，不会填出结构不一致的内容。

怎么开始用

官方提供了两种安装方式。快速版适合不想折腾构建系统的场景：一个 HTML 文件加一份配置文件，JavaScript 和 CSS 全部走 CDN 加载。/admin/index.html 大致长这样：

<!doctype html>
<html>
<head>
  <meta charset="utf-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Content Manager</title>
</head>
<body>
  <!-- Include the script that builds the page and powers Decap CMS -->
  <script src="https://unpkg.com/decap-cms@^3.0.0/dist/decap-cms.js"></script>
</body>
</html>

然后在同目录下建一个 config.yml，写清楚内容模型和后端连接方式。README 中明确说明：配置好后，用户访问 /admin/ 会被提示登录，认证通过后就能创建或编辑内容。

另一种安装方式走 npm 包，适合已经用构建工具的站点，灵活性更高，但要求你的静态网站生成器支持 npm 依赖，上手门槛也更高。

优点和坑

优点：纯开源，MIT 协议，star 数 19425，fork 3141，社区活跃，文档站有完整的核心概念说明。部署模型轻——单页应用 + 配置文件 + CDN，不引入额外服务。内容数据不锁定，全在 Git 仓库里，哪天不用它了，Markdown 文件还在。

坑：第一个，身份验证依赖外部服务。登录认证要对接 Git 平台（或 OpenID 提供商），小站点用默认方式还行，碰到企业内网或自建 Git 服务就要自己配认证，这不是零配置的事。第二个，没有数据库代理的角色权限模型。官方把进阶的权限管理、集中用户管理放进了「Decap Turbo」的付费服务里，开箱即用的权限粒度比较粗糙。第三个，编辑界面高度依赖配置文件。内容模型一旦复杂，YAML 写起来不轻松，等于把原来写模板的工作转移成写配置。第四个，它不解决静态网站的构建和部署问题——你仍然需要自己的构建流程，Decap CMS 只管内容编辑这一层。

适合你吗

适合：已经在用静态网站生成器的人，尤其觉得「每次改内容要走 Git」太折腾的；小团队要共用后台、但不想碰数据库和服务器的；以及做外包站点、想把内容维护权交给甲方的开发者。

不适合：没有静态网站、打算从零搭一个完整 CMS 的，那不如直接考虑带后端的传统方案；对权限体系有复杂要求的企业场景，免费版覆盖不住；不想维护配置文件、希望后台完全自动生成的人，也省省 —— Decap CMS 的灵活性恰恰建立在配置之上。

常见问题

Decap CMS 是什么？

Decap CMS 是一个基于 Git 的开源内容管理系统，专门为 Hugo、Jekyll 等静态网站生成器设计。它提供一个可视化后台（通常在 /admin 路径），让用户无需命令行就能编辑内容，所有修改都会以 Markdown 文件形式直接提交到 Git 仓库，无需额外服务器或数据库。

Decap CMS 免费吗？有什么限制？

Decap CMS 是 MIT 协议的开源软件，完全免费。但它的免费版本权限管理粒度较粗，复杂的权限管理和集中用户管理功能属于付费服务「Decap Turbo」。此外，身份认证依赖外部 Git 平台（如 GitHub），自建 Git 服务需要额外配置。

Decap CMS 怎么安装？

安装 Decap CMS 有两种主要方式。对于不想折腾构建的站点，最快的方法是：在网站 /admin 目录下创建一个 index.html 文件（引入 CDN 脚本）和一个 config.yml 配置文件。用户访问 /admin 路径即可登录使用。另一种是通过 npm 包安装，适合已有构建工具的项目。

Decap CMS 适合什么样的人用？

它非常适合三类用户：1）使用静态生成器（如 Hugo）的个人博客作者，想摆脱命令行写文章；2）需要多人协作编辑公司官网或文档的小团队，成员不熟悉 Git；3）为外包客户建站的开发者，交付后客户可自行更新内容，无需频繁返工。

Decap CMS 和传统 CMS 相比有什么优缺点？

优点：部署轻量（单页应用+CDN），内容数据不锁定（全在 Git 仓库），有版本记录可回滚。缺点：不解决网站构建和部署问题；内容模型完全依赖 YAML 配置文件编写，复杂结构配置较繁琐；免费版权限管理功能较为基础。

相关工具推荐

• 为 Django 项目选择内容后台？看看 Wagtail 开源 CMS
• 客户批量开通与管理？免费的 CtrlPanel 计费方案
• 需要免费字体？打包下载 Google Fonts 开源字体库