从 0 搭建 IFZPress 技术博客
2026/2/2小于 1 分钟
这篇文章记录从 0 搭建 IFZPress 的关键步骤，便于后续复盘与复用。
背景与目标
希望拥有一个“像 WordPress 一样”的写作后台，但内容仍以 Markdown 形式存储在 Git 仓库中，支持版本控制与自动构建发布。
环境准备
- VuePress v2
- Gitea 作为 Git 后端
- Decap CMS 作为后台编辑界面
- Webhook 触发自动构建
关键步骤
- 配置 Gitea OAuth 应用，拿到 Client ID。
- 在
docs/.vuepress/public/admin/config.yml中填写 OAuth 与仓库信息。 - 通过 webhook 触发
npm run docs:build自动构建并发布。
docker compose up -d --build
curl -X POST http://127.0.0.1:19000/hooks/manual常见问题
- 登录后读写失败：优先检查
/api/v1/的 CORS。 - webhook 401：确认
WEBHOOK_SECRET一致。 - 构建失败：查看
docker logs -f ifzpress-builder。
总结
IFZPress 结合 Gitea 与 Decap CMS，既保留 Git 版本化能力，又具备友好的写作体验， 非常适合个人或小团队的技术博客。