如何把个人博客部署到 Cloudflare Pages(pages.dev)并隐私绑定域名
不公开源码仓库、不在代码里写入真实域名,通过本地静态构建直接发布到 pages.dev,并在控制台私密绑定自定义域名。
文章目录
#为什么选择静态博客 + pages.dev
教程型个人博客非常适合采用「本地 Markdown 写作 + 本地构建为静态文件 + Cloudflare Pages 托管」的方案:
- 零服务器维护:生成的是纯 HTML、CSS、JavaScript 与 JSON 索引文件,没有后台数据库需要维护。
- 免费 HTTPS 与全球边缘分发:部署后即可直接通过
*.pages.dev访问,自动启用 HTTPS。 - 域名隐私可控:源码、构建脚本和页面元数据全部使用相对路径,不需要在任何代码或配置文件里写入你的真实域名。
#第一步:本地生成静态产物
在项目根目录执行构建命令:
npm.cmd run build构建脚本会读取 content/posts/ 下的 Markdown 教程与 data/resources.json 中的公开资源清单,统一输出到 dist/ 目录:
| 输出路径 | 用途 | 说明 |
|---|---|---|
/index.html | 教程博客首页 | 支持关键词搜索、分类与多标签筛选 |
/posts/<slug>/ | 教程详情页 | 包含目录导航、代码复制与拾集资源联动 |
/resources/ | 拾集静态版 | 离线 JSON 驱动,隐藏登录与后台管理入口 |
/_headers | 安全响应头 | 配置 CSP、nosniff 与 Referrer-Policy |
在发布前,先在本地启动静态预览服务核对页面和链接:
npm.cmd run preview打开 http://127.0.0.1:4175/,确认教程列表、详情页以及跳转到 /resources/ 的筛选链接都可以正常打开。
#第二步:发布到 pages.dev(无需公开代码仓库)
如果你不希望把源码推送到 GitHub 等代码托管平台,可以选择以下两种本地直接上传方式之一:
#方式 A:在 Cloudflare 控制台直接上传文件夹
- 登录 Cloudflare Dashboard,进入 Workers & Pages → Create → Pages。
- 选择 Direct Upload(直接上传),填写一个你喜欢的项目名称(会生成
<项目名>.pages.dev)。 - 将本地生成好的
dist文件夹拖拽上传,等待部署完成即可访问。
#方式 B:使用 Wrangler CLI 命令行部署
如果本机已经登录 Wrangler,只需要一条命令即可发布更新:
npx wrangler pages deploy dist --project-name your-project-name#第三步:绑定自己的域名而不暴露在代码里
当你准备好使用自己的域名时,不需要修改项目里的任何代码:
- 在 Cloudflare Dashboard 打开你的 Pages 项目,进入 Custom domains(自定义域名)。
- 点击 Set up a custom domain,按照提示添加域名与 DNS 记录。
- 因为站内所有导航、文章链接和跳转到 拾集 的链接都使用站内相对路径,无论访客通过
*.pages.dev还是你的独立域名访问,都会保持在当前访问域名下,不会互相暴露。