App decap-cms 可嵌入静态站点的开源内容管理后台

一、项目介绍

静态站点（Hugo、Jekyll、Next 等）速度快、便宜、安全，但非技术的编辑人员要改一篇稿子，往往得去碰 Git 和 Markdown，门槛劝退。很多小团队因此被迫上沉重的传统 CMS，又丢了静态站的优势。
Decap CMS（前身 Netlify CMS）给出折中方案：它只是一个前端应用，往静态站点里塞一个 HTML 文件和一份配置文件，就能在浏览器里提供可视化的内容编辑后台。编辑保存后，它通过 Git Gateway 或 GitHub 直接提交改动，内容仍以 Markdown/JSON 落在仓库里。

二、项目基本信息

三、核心优势

• 零后端：纯前端应用，随静态站点一起托管
• Git 作为数据库：内容以文件形式存仓库，版本可追溯
• 可视化编辑：表单、预览、媒体库，非技术人员也能用
• 接入简单：一个 HTML 加一个 config 即可启用
• 可扩展：自定义预览、小部件和后端认证

四、适用场景

适合博客、文档站、营销页等静态站点，给编辑提供友好后台，同时保留静态部署的低成本与高安全性。

五、安装教程

当前最新版本 decap-cms@3.17.3。按下方命令安装（如遇网络问题可切换镜像源）：

<!-- 在静态站点中放一个 admin/index.html -->
<link rel="stylesheet" href="https://unpkg.com/decap-cms@^3.17.3/dist/decap-cms.css">
<script src="https://unpkg.com/decap-cms@^3.17.3/dist/decap-cms.js"></script>

常见报错：依赖缺失时先升级运行环境（如 Node、Python、.NET、JDK）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。

六、使用示例

下面是一段可直接运行或参考的真实示例：

# admin/config.yml 示例
backend:
  name: github
  repo: owner/site
  branch: main
media_folder: "static/uploads"
collections:
  - name: "posts"
    label: "文章"
    folder: "_posts"
    create: true
    fields:
      - { name: title, label: 标题, widget: string }
      - { name: body, label: 正文, widget: markdown }

七、常见问题

问：编辑保存后内容去哪了？答：按配置直接提交到 GitHub 等仓库的对应目录。问：需要服务器吗？答：不需要，它随静态站点托管，认证走 Git Gateway 或外部身份提供方。

八、总结

decap-cms 用一个清晰的设计，把把复杂能力装进轻量入口这件事从重复劳动变成了可复用、可维护的工程能力。它不追求大而全，而是把核心痛点解决得足够扎实，这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。