tutorials

将 Astro 部署到 Cloudflare Pages

逐步指导如何将 Astro 网站部署到 Cloudflare Pages,配置自定义域名并获得边缘性能。

Author ·

为什么选择 Cloudflare Pages?

Cloudflare Pages 为托管静态和混合网站提供了出色的免费方案:

  • 免费计划中的无限带宽
  • 拥有 300+ 边缘位置的全球 CDN
  • 自动 HTTPS,提供免费 SSL 证书
  • Git 集成,实现持续部署

设置适配器

首先,安装 Cloudflare 适配器:

npm install @astrojs/cloudflare

然后在 astro.config.mjs 中配置它:

import cloudflare from '@astrojs/cloudflare';

export default defineConfig({
  output: 'static',
  adapter: cloudflare(),
});

部署

将你的 GitHub 仓库连接到 Cloudflare Pages:

  1. 进入 Cloudflare 控制面板
  2. 导航到 Workers & Pages
  3. 创建新的 Pages 项目
  4. 连接你的仓库
  5. 设置构建命令为 npm run build
  6. 设置输出目录为 dist

自定义域名

在 Cloudflare Pages 设置中添加自定义域名非常简单。由于你的域名已经在 Cloudflare 上,DNS 配置是自动的。

性能提示

  • 在 Cloudflare 控制面板中启用 Early Hints
  • 使用 _headers 文件设置自定义缓存策略
  • 利用 Cloudflare 的图片优化处理多媒体页面