Astro 部署到 Cloudflare Pages

这个项目使用 Astro 静态输出，Cloudflare Pages 只负责执行构建并托管 dist/。

Pages 构建配置

在 Cloudflare Pages 中连接 Git 仓库后，使用以下配置：

Framework preset: Astro
Build command: pnpm run build
Build output directory: dist
Root directory: /

仓库使用 pnpm-lock.yaml 锁定依赖，Pages 会据此使用 pnpm 安装依赖。

生产环境必须设置：

SITE_URL=https://me.983768.xyz

astro.config.mjs 使用这个变量设置 Astro 的 site：

const site = process.env.SITE_URL ?? 'https://me.983768.xyz';

export default defineConfig({
  site,
});

这个值会影响 canonical URL、RSS、robots.txt 和 Sitemap，生产环境应始终使用正式域名。

推送前执行：

pnpm run build

构建完成后至少确认这些文件存在：

dist/index.html
dist/rss.xml
dist/robots.txt
dist/sitemap-index.xml
dist/_headers

Pagefind 搜索索引也会在构建阶段生成。若 Content Schema、内部链接或 Starlight 页面存在问题，应在部署前处理。

Cloudflare Pages 会为分支和 Pull Request 创建预览地址。建议把检查分成两层：

预览域名不应该替代生产环境的 SITE_URL，否则生成的站点元数据会指向临时地址。

当前站点不需要 SSR，因此不需要 Cloudflare adapter。未来如果增加必须在请求时运行的 API 或认证页面，再评估 @astrojs/cloudflare，不要提前引入运行时复杂度。