本文总结 Webhook 自动构建的关键配置点，以及常见故障排查思路。

构建触发

• 推送到主分支触发构建
• 使用 WEBHOOK_SECRET 做签名校验

构建性能

• 首次依赖安装较慢
• 可考虑缓存 node_modules 或构建产物

常见问题

• 401：签名不匹配
• 404：静态目录未更新
• 500：构建命令失败

结语

本文整理一套“后台写作 + Git 版本化 + 自动发布”的高效流程， 适合团队协作或长期个人维护。

为什么需要后台写作

纯 Markdown 写作虽然轻便，但多人协作、权限管理和发布流程会变复杂。 Decap CMS 提供了可视化编辑与权限校验，让内容生产更稳定。

推荐流程

1. 在 /admin/ 登录并编辑文章。
2. 保存后自动提交到仓库，保留版本记录。
3. Webhook 触发构建并发布到站点。

小结

当你把写作、审阅、发布流程固化后，博客就能持续迭代。

这篇文章记录从 0 搭建 IFZPress 的关键步骤，便于后续复盘与复用。

背景与目标

希望拥有一个“像 WordPress 一样”的写作后台，但内容仍以 Markdown 形式存储在 Git 仓库中，支持版本控制与自动构建发布。

环境准备

• VuePress v2
• Gitea 作为 Git 后端
• Decap CMS 作为后台编辑界面
• Webhook 触发自动构建

关键步骤

1. 配置 Gitea OAuth 应用，拿到 Client ID。
2. 在 docs/.vuepress/public/admin/config.yml 中填写 OAuth 与仓库信息。
3. 通过 webhook 触发 npm run docs:build 自动构建并发布。