从零搭建个人博客：GitHub + Firefly + Cloudflare Pages

1. 创建自己的博客仓库#

打开 Firefly 官方仓库。

如果页面有 Use this template，选择 Create a new repository，填写自己的账号和仓库名称。我使用的仓库名称是 litumast-blog。

也可以使用 Fork 创建自己的副本。后面的操作都在自己账号下的仓库中进行。

创建完成后，应能看到 src、public、package.json 等文件和目录。记住页面左上角的默认分支名称，我的仓库是 master，其他仓库可能是 main。

2. 修改网站基本信息#

打开仓库中的 src/config/siteConfig.ts，点击铅笔图标进入编辑模式。

找到相应字段，替换成自己的内容。例如：

1
title: "里托大师的博客",
2
subtitle: "记录学习与生活",
3
site_url: "https://litumast.top",
4
description: "分享学习笔记、生活记录和一些想法。",

这只是需要修改的字段示例，不是整个文件。保留文件中其余配置，以及原来的引号、逗号和括号。

如果暂时没有自己的域名，等 Pages 部署成功后，将 site_url 改成实际分配的 https://项目名.pages.dev 地址。

修改完成后点击 Commit changes。如果弹窗提供分支选项，选择直接提交到默认分支，再确认提交。

网页上的编辑必须提交才会保存到仓库；仅在编辑框中输入文字，还没有完成发布。

1. 找到 Pages 入口#

登录 Cloudflare 控制台，进入 Workers & Pages，点击创建应用。

我当时看到的是一个写着 Make something new 的页面，里面有 GitHub、GitLab、Hello World 等选项。Pages 入口在这张卡片下方的小字中：

想要部署 Pages？开始使用

点击这里的“开始使用”，再选择 导入现有 Git 存储库。

界面之后可能调整；关键是确认自己进入的是 Pages 的 Git 部署流程。

2. 连接 GitHub#

按提示连接 GitHub 账号，授权访问自己的博客仓库，然后选中 litumast-blog。

如果列表里找不到仓库，检查 GitHub 的授权范围是否包含它。选择仓库后进入“设置构建和部署”。

3. 填写构建设置#

我成功部署时使用的是：

生产分支必须与自己的仓库一致。输出目录输入框外如果已经显示 /，框内只填 dist 即可。

在“环境变量（高级）”中，我添加了：

这些是我这次部署的版本，不是所有 Firefly 版本都必须照抄。 创建仓库后，应查看 package.json：engines.node 表示 Node.js 要求，packageManager 表示项目指定的包管理器版本。将构建环境与自己的仓库要求对应起来。

Pages 会安装依赖，此页面不需要另填安装命令。这次使用主题的静态构建方式，环境变量中没有添加 CF_WORKERS。

构建环境的版本设置可参考 Cloudflare 构建环境文档。

4. 保存并部署#

点击 保存并部署，等待安装依赖、构建和发布完成。

成功后，我拿到的地址是：

1
https://litumast-blog.pages.dev

打开实际分配的地址，检查首页和文章。如果构建失败，先看具体错误日志，再修改配置；只看最后一句“部署失败”通常找不到原因。

到这里，博客已经有可访问的地址了。接下来是给它绑定自己的域名。

1. 从 Pages 添加自定义域#

进入 Workers & Pages → 博客项目 → 自定义域 → 设置自定义域，输入自己的域名。

如果出现“DNS 转移管理”，按提示开始接入。在“添加站点”页面选择 连接域名，选择免费方案，并扫描已有 DNS 记录。

这里的“连接域名”是将 DNS 交给 Cloudflare 管理。域名的注册和续费仍在 Spaceship。

2. 检查导入的记录#

自动扫描不一定包含所有记录，需要与原 DNS 平台核对。使用域名邮箱或其他子域服务的人，还应保留对应的记录。

我之前试过其他托管平台，扫描结果中出现了两条旧博客的根域名 A 记录。我在确认它们指向旧站点后，将它们替换成新博客的 CNAME：

@ 表示根域名。内容填写自己项目的 Pages 地址，不加 https:// 和末尾斜杠。不要为了处理博客解析而清空其他服务的记录。

3. 修改名称服务器#

继续激活后，Cloudflare 会分配两条名称服务器地址。

一定复制自己页面提供的两条地址，不要使用其他教程里的示例。

我在 Spaceship 中的操作顺序是：

1. 打开“域名管理器”，选择自己的域名。
2. 进入“名称服务器和 DNS”。
3. 点击名称服务器旁的“更改”。
4. 选择“自定义名称服务器”。
5. 用 Cloudflare 提供的两条地址替换原来的 Spaceship 名称服务器。
6. 保存设置。

这是修改名称服务器，不是在“高级 DNS”中新增两条 NS 记录。若原平台已开启 DNSSEC，先按迁移提示处理并关闭旧 DNSSEC，接入完成后再配置。

4. 等待激活#

返回 Cloudflare 检查名称服务器。我的页面提示通常需要 1～2 小时，最长可能到 24 小时，以实际检测结果为准。

等待期间不必反复更换地址。当页面显示“您的域现在受 Cloudflare 保护”时，说明域名接入已经完成。