Web Deploy / 1 min read

Cloudflare Pages 部署个人博客

记录使用 Astro、MDX 和 Cloudflare Pages 构建静态个人博客时的关键配置。

2026年5月28日 AstroCloudflare Pages部署MDX

为什么选择 Cloudflare Pages

个人博客最重要的是稳定、快速、维护成本低。Cloudflare Pages 很适合 Astro 这类静态站点:构建产物直接放在 dist,没有数据库,也不需要复杂后端。

部署时最关键的两个配置是:

npm run build
dist

第一个是构建命令,第二个是构建输出目录。

Astro 的静态优先思路

Astro 的优势是把文章、组件和页面编译成静态 HTML。MDX 让文章可以包含更复杂的内容,例如代码块、公式和组件。

---
import Layout from '@/components/Layout.astro';
---

<Layout title="Blog">
  <h1>King's Digital Garden</h1>
</Layout>

构建检查

每次部署前我会先本地运行:

npm install
npm run build

如果 dist 目录能正常生成,Cloudflare Pages 通常就可以直接部署。

一个小公式

静态站点的维护成本可以理解为:

Cost=BuildTime+ContentMaintenance+DeploymentRiskCost = BuildTime + ContentMaintenance + DeploymentRisk

目标是让部署风险尽可能低,把精力放回内容和项目本身。