风记WINDY NOTES

如何把个人博客部署到 Cloudflare Pages(pages.dev)并隐私绑定域名

不公开源码仓库、不在代码里写入真实域名,通过本地静态构建直接发布到 pages.dev,并在控制台私密绑定自定义域名。

文章目录

#为什么选择静态博客 + pages.dev

教程型个人博客非常适合采用「本地 Markdown 写作 + 本地构建为静态文件 + Cloudflare Pages 托管」的方案:

  • 零服务器维护:生成的是纯 HTML、CSS、JavaScript 与 JSON 索引文件,没有后台数据库需要维护。
  • 免费 HTTPS 与全球边缘分发:部署后即可直接通过 *.pages.dev 访问,自动启用 HTTPS。
  • 域名隐私可控:源码、构建脚本和页面元数据全部使用相对路径,不需要在任何代码或配置文件里写入你的真实域名。

#第一步:本地生成静态产物

在项目根目录执行构建命令:

powershell
npm.cmd run build

构建脚本会读取 content/posts/ 下的 Markdown 教程与 data/resources.json 中的公开资源清单,统一输出到 dist/ 目录:

输出路径用途说明
/index.html教程博客首页支持关键词搜索、分类与多标签筛选
/posts/<slug>/教程详情页包含目录导航、代码复制与拾集资源联动
/resources/拾集静态版离线 JSON 驱动,隐藏登录与后台管理入口
/_headers安全响应头配置 CSP、nosniff 与 Referrer-Policy

在发布前,先在本地启动静态预览服务核对页面和链接:

powershell
npm.cmd run preview

打开 http://127.0.0.1:4175/,确认教程列表、详情页以及跳转到 /resources/ 的筛选链接都可以正常打开。

#第二步:发布到 pages.dev(无需公开代码仓库)

如果你不希望把源码推送到 GitHub 等代码托管平台,可以选择以下两种本地直接上传方式之一:

#方式 A:在 Cloudflare 控制台直接上传文件夹

  1. 登录 Cloudflare Dashboard,进入 Workers & Pages → Create → Pages。
  2. 选择 Direct Upload(直接上传),填写一个你喜欢的项目名称(会生成 <项目名>.pages.dev)。
  3. 将本地生成好的 dist 文件夹拖拽上传,等待部署完成即可访问。

#方式 B:使用 Wrangler CLI 命令行部署

如果本机已经登录 Wrangler,只需要一条命令即可发布更新:

powershell
npx wrangler pages deploy dist --project-name your-project-name

#第三步:绑定自己的域名而不暴露在代码里

当你准备好使用自己的域名时,不需要修改项目里的任何代码:

  1. 在 Cloudflare Dashboard 打开你的 Pages 项目,进入 Custom domains(自定义域名)。
  2. 点击 Set up a custom domain,按照提示添加域名与 DNS 记录。
  3. 因为站内所有导航、文章链接和跳转到 拾集 的链接都使用站内相对路径,无论访客通过 *.pages.dev 还是你的独立域名访问,都会保持在当前访问域名下,不会互相暴露。

本文关联的拾集资源

打开拾集资源页 ↗
学习资料developer.mozilla.org

MDN Web Docs

查阅 HTML、CSS、JavaScript 与 Web API 文档,用示例理解网页背后的原理。