零基础完整复刻:Cloudflare 博客项目全流程
这个章节是你当前博客项目的“完整复刻手册”。
目标读者:
- 没有代码基础
- 第一次接触 GitHub、Cloudflare、Nuxt、Decap CMS
- 希望照着文档一步步做,最终得到与你当前项目一致的结果
学习方式建议:
- 严格按顺序学习,不要跳步骤
- 每做完一节就执行“本节验收”
- 发现报错先看“常见问题”再继续
你可以直接从下面目录开始:
章节目录
第 1 节
第 1 节:先把地基打好(目标、账号、工具)
你要先准备哪些账号和工具,为什么必须先做这一步,以及每个工具在项目里的职责。
第 2 节
第 2 节:本地跑起来(Nuxt + Content + 环境变量)
从零启动本地站点,理解 .env、内容模型、页面路由和构建脚本。
第 3 节
第 3 节:连接 GitHub 与 Cloudflare Pages(自动部署主链路)
把仓库 adkeb/blog 接入 Pages,设置正确构建参数,避开常见部署报错。
第 4 节
第 4 节:域名、DNS 与 301 跳转(主域统一)
把裸域 xuyangfly.site 301 到 www,解决规则不生效与代理记录问题。
第 5 节
第 5 节:预览链路(Cloudflare Tunnel + Access)
把草稿预览和后台放到私有入口,确保 Tunnel 失效不影响公开主站。
第 6 节
第 6 节:Decap CMS 与 GitHub OAuth Worker
从 Netlify 失败场景迁移到 Cloudflare Worker OAuth 网关,打通 /admin 可视化编辑。
第 7 节
第 7 节:评论系统 giscus 与空白问题修复
配置 giscus 参数、环境变量同步,并修复登录后评论空白、刷新后评论空白问题。
第 8 节
第 8 节:章节体系(父文 + 子文 + 旧链接 301)
实现章节化写作、章节目录占位符、子文章路由与 legacySlugs 迁移跳转。
第 9 节
第 9 节:夜间模式、最终检查与上线清单
完成夜间模式与主题持久化,给出发布前最终检查清单,确保你能稳定长期维护。