用 GitHub + Cloudflare 搭一个 AI 知识库网站

本主题记录如何把一个 Git 仓库变成一个私有的、自动部署的文档网站 —— 也就是你正在看的这个站是怎么来的。

本主题包含

• 搭建记录 —— 叙事复盘：目标、架构、技术选型理由，以及搭建过程中踩的坑。想理解"为什么这么做"看这篇。
• 部署操作清单 —— 可照做的 runbook：从本地验证、推 GitHub、连 Cloudflare Pages，到加访问鉴权的分步命令。想"重做一遍"看这篇。

一句话架构

本地编辑 Markdown → git push → GitHub 私有仓库
   → (webhook) → Cloudflare Pages 自动 build+deploy → 网站更新

存储层 GitHub、托管层 Cloudflare Pages、鉴权层 Cloudflare Access，三层解耦、各自可换。