1. astro.config.mjs 文件配置#

如果 使用 Cloudflare 提供的默认 *.pages.dev 域名，可以保持配置，在项目中找到 astro.config.mjs 文件，修改 site 配置：

1
import { defineConfig } from "astro/config";
2

3
export default defineConfig({
4
  site: "https://your-project-name.pages.dev",
5
  ...
6
});

没想好域名就先空着。我习惯先把部署跑通，回头再补，不然一开始就卡在域名上。

2. 构建输出目录#

Astro 默认的构建输出目录是： dist/

Cloudflare Pages 会直接使用该目录作为站点发布内容，无需额外配置。

1. 创建 Pages 项目#

• 在 Cloudflare 控制台
• 左侧菜单：Workers 和 Pages
• 创建应用程序

• 选择 Connect to Git，并授权 GitHub

• 选择底部的 Get started

2. 构建配置（关键步骤）#

选择你的 Astro 博客仓库

在 Build settings 中填写以下内容：

配置项	推荐值
框架预设	Astro
构建命令	pnpm build
构建输出目录	dist

Root directory 一般不用改，除非你把 Astro 项目放在子目录里。

3. 保存并首次部署#

点击 保存并部署，Cloudflare Pages 会自动执行：

1. 拉取 GitHub 仓库代码
2. 安装依赖
3. 执行构建命令
4. 发布站点

部署完成后会拿到一个地址，类似：

https://fuwari-d9b.pages.dev

成功判断标准：

• 能正常打开上述地址
• 首页样式与静态资源加载正常
• 刷新页面不会出现 404

1. 添加自定义域名#

路径：

打开需要配置的项目，进入设置页面，填写自定义域名

2. DNS 配置#

我当时域名就在 Cloudflare，直接一键添加了 CNAME 记录，指向 your-project-name.pages.dev。如果域名在其他服务商，手动加一条就行。

HTTPS

• Cloudflare Pages 会自动签发 HTTPS 证书
• 无需手动申请或配置证书