Cloudflare Pages 部署最佳实践

为什么选择 Cloudflare Pages？

Cloudflare Pages 提供了业界领先的静态站点托管服务：

• 全球 CDN：300+ 数据中心，毫秒级响应
• 免费 HTTPS：自动颁发和续期 SSL 证书
• Preview Deployments：每个 PR 自动生成预览链接
• 无限带宽：免费套餐无带宽限制
• 自定义域名：轻松绑定自己的域名

构建配置

在 Cloudflare Pages 面板中设置：

配置项	值
Framework preset	Astro
Build command	npm run build
Build output	dist
Node.js version	20

缓存策略

利用 public/_headers 为静态资源配置长效缓存：

/_astro/*
  Cache-Control: public, max-age=31536000, immutable

Astro 生成的资源文件名包含内容哈希，因此可以安全地设置 immutable。

安全 Headers

/*
  X-Content-Type-Options: nosniff
  X-Frame-Options: DENY
  X-XSS-Protection: 1; mode=block
  Referrer-Policy: strict-origin-when-cross-origin

自定义域名

1. 进入项目设置 → Custom domains
2. 输入域名并点击确认
3. 在 DNS 设置中添加 CNAME 记录指向 xxx.pages.dev
4. 等待 SSL 证书签发（通常几分钟内完成）

Preview Deployments

每次推送到非主分支时，Cloudflare Pages 会自动部署预览环境，URL 格式为：

https://<branch>.<project>.pages.dev

这对于 Code Review 和 UI 审查非常有用。