跳到正文
返回

Cloudflare 是怎么把仓库变成网站的

前两篇认识了 GitHub 和 Git:GitHub 是放东西的仓库,Git 是往里搬东西的工具。这篇讲最后一步:仓库里的文件,是怎么变成一个能打开的网站的。

答案是 Cloudflare Pages。它干的事,用一句话说就是:你只管写文章、推代码,剩下的事它全包了。

以前做网站,要准备一堆东西

在没有这种服务之前,想把网站放到网上,得自己准备:买一台服务器,装系统,装运行环境,配域名,还要备案。哪一步卡住,网站就上不了线。

现在不一样了。代码放在 GitHub,Cloudflare 负责把代码变成网站,再把它送到读者面前。你不用买服务器,不用装环境,不用管备份。

Cloudflare Pages 是什么

打个比方:它像一个自动化的印刷厂加发行站。

你把稿子(代码和文章)放进 GitHub 这个仓库,它发现仓库变了,就自动取走稿子,排版印刷(这一步叫构建),印好之后送到全球各地的书店(这叫 CDN 节点)。读者打开网址,拿到的就是离他最近那家书店里的那份。

所以你从来没碰过服务器,网站却一直在全世界跑着。

第一次:把仓库接进来(只做一次)

自动部署不是天生就有的,第一次要手动把 GitHub 仓库接到 Cloudflare 上,整个过程点几下鼠标就行:

1. 打开 Workers 和 Pages,点创建应用程序。

Cloudflare 的 Workers 和 Pages 页面,点右上角创建应用程序

2. 点 Continue with GitHub,连上 GitHub 账号。

创建新项目页面,点 Continue with GitHub

这里是选从哪开始:连 GitHub、连 GitLab、从模板开始,或者直接传静态文件。想让它以后自动部署,就选 Continue with GitHub。

3. 选导入现有 Git 存储库。

开始使用页面,导入现有 Git 存储库,点开始使用

这里有两个路:导入 Git 存储库,和拖放文件。拖放是手动的,每次改完都要重新拖一遍;选导入 Git 存储库,以后推代码就自动部署,选这个。

4. 选 GitHub 账号,找到你的仓库。

从帐户部署站点,搜索 blog,点仓库,点开始设置

仓库多的时候不用一页页翻,搜索框里输入仓库名就能找到,点仓库,再点开始设置。

5. 设置构建和部署,保存。

设置构建和部署:生产分支 main,框架 Astro,构建命令 pnpm build,输出目录 dist

这页就填几项:

  • 项目名称:blog,项目名决定了默认的 xxx.pages.dev 地址。
  • 生产分支:main,只有这个分支的变动会发布到正式网站。
  • 框架预设:选 Astro,Cloudflare 会按 Astro 的规矩来构建。
  • 构建命令:pnpm build。
  • 构建输出目录:dist,构建好的网页就放在这个文件夹里。

填完点保存并部署,第一次部署就开始了。以后再也不用管这页,除非换框架或者改构建方式。

以后每次:文章从写好到能打开,5 步走完

接进来之后,一篇文章从写好到能打开,是这么走的:

1. 本地写好,推到 GitHub

git add .
git commit -m "加了一篇文章"
git push

这一步是第二篇讲过的内容。推完,文章就躺在 GitHub 的仓库里了,但它还只是文件,不是网站。

2. Cloudflare 发现仓库变了

Cloudflare 一直盯着 main 分支。仓库一变,它就自动开始干活,不用你去点什么。这个叫自动部署,我的项目里它是开着的。

3. 跑构建,把文章变成网页

Cloudflare 按刚才设置好的去跑构建命令。页面上填的是:

pnpm build

它实际跑的是项目里 package.json 的 build 那一行:

astro check && astro build && pagefind --site dist && node copy-pagefind.mjs

看着长,其实就四件事:

  • astro check:检查一下有没有写错,比如文章格式不对。
  • astro build:把 .md 文章和模板拼成真正的网页,放到 dist 文件夹里。
  • pagefind --site dist:给站内搜索做索引,不然搜索框搜不到东西。
  • node copy-pagefind.mjs:把搜索用的文件复制到正确的位置。

这一步是在 Cloudflare 的机器上跑的,不是你的电脑。你的电脑关机了也没关系。

4. 发布到全球节点

构建好的网页,会被送到 Cloudflare 在全球几百个城市的节点上。读者在美国打开,拿的是美国节点上的那份;读者在欧洲打开,拿的是欧洲节点上的那份。就近拿,所以打开快。

5. 打开域名就能看

构建加发布一般几分钟。完了打开生产域名就能看到新文章:

https://blog-2a6.pages.dev

每次部署除了生产域名,还会给一个带一串字符的预览链接,比如 https://69a645bf.blog-2a6.pages.dev。这个链接指向的就是某一次具体的部署,方便你对照着看。

部署页面怎么看

Cloudflare 的项目面板里,Production 这一栏就是部署记录:

Cloudflare Pages 的 Production 面板,自动部署已启用

从左到右分别是:

  • Environment:Production,正式环境。
  • Source:这次部署是从哪个分支、哪次提交来的,比如 main 7636a2c。
  • Deployment:这次部署的预览链接。
  • Status:打勾就是成功了,显示几分钟前部署完。

如果哪次部署失败了,Status 那里会变红,点旁边的 Details 就能看到构建日志,错在哪一行写得清清楚楚。常见原因就两个:文章格式写错了,或者构建命令里要用的东西没装好。照着日志改,改完再推一次就行。

改完文章,要做什么

什么都不用做。

改完文章,add、commit、push,然后等几分钟,刷新页面就能看到新的。这就是自动部署的意思:你只负责推,剩下的全是它的事。

如果推完刷新还是旧的,先别慌,大概率是浏览器缓存。按 Ctrl + F5 硬刷新一次,或者等一会儿再看,一般就好了。

为什么选它

三点理由:

  • 不用买服务器。 个人博客的量,免费额度完全够用。
  • 不用备案。 因为部署在海外节点,不走国内的备案流程。
  • 打开快。 全球节点就近访问,读者不用跨半个地球来取页面。

当然它也有边界:如果网站要跑很重的后端逻辑,或者要存大量用户数据,就得另想办法。但对个人博客这种以文章为主的站,它正好。

结尾

三篇写下来,整条链就通了:

GitHub 是仓库,Git 是搬东西的工具,Cloudflare 是印刷厂加发行站。写文章、提交、推送、自动构建、发布,链上的每一步都有人替你干了,你只管写。

下期预告:这篇讲的是没后端的静态站,用 Pages 部署。下一篇写有后端的项目怎么用 Workers 部署。



上一篇
认识 Git:给文件装个时光机,改错了也能回去
下一篇
买个域名,托管到 Cloudflare