部署Starlight至Cloudflare

Starlight 是一个基于 Astro 框架构建的全功能文档主题。这个指南将帮助你开始一个新项目。

查看手动配置以将 Starlight 添加到现有的 Astro 项目中。

前提条件

开始之前，你需要：

一个 Cloudflare 账号。如果你暂时还没有，可通过 Cloudflare 官网免费注册。
一个可以访问的域名（Cloudflare Workers 免费提供的域名中国区无法访问）。
一个 GitHub 账号（可选，但推荐用于版本控制和部署）。
安装 Wrangler CLI 来管理你的 Cloudflare Workers 项目。
安装 Node.js 和 npm 来运行 Astro 项目。

开始使用

参考链接：Starlight 文档

在你的终端中运行以下命令来创建一个新的 Astro + Starlight 项目：

npm create astro@latest -- --template starlight

启动开发服务器

在本地工作时，Astro 的开发服务器使你能预览你的工作，并在你进行更改时自动刷新你的浏览器。

在你的项目目录中，运行以下命令来启动开发服务器：

npm run dev

这将在你的终端上记录一个包含本地预览网址的消息。打开这个网址开始浏览你的网站。

部署你的 Astro 站点至 Cloudflare

要将你的 Astro 站点部署到 Cloudflare Workers，你需要使用 Wrangler CLI 来构建和发布你的项目。首先，确保你已经在 Cloudflare 上创建了一个 Worker，并且已经配置了 Wrangler。

安装 Wrangler CLI

npm install wrangler@latest --save-dev

安装 @astrojs/cloudflare 适配器 (EN)。

安装中的选择可以全部yes。

npx astro add cloudflare

修改 wrangler.jsonc 文件，确保它包含以下内容：

{
 "compatibility_date": "2026-03-13",
 "compatibility_flags": ["nodejs_compat","global_fetch_strictly_public"],
 "name": "mao",
 "main": "@astrojs/cloudflare/entrypoints/server",
 "assets": {
  "directory": "./dist",
  "binding": "ASSETS"
 },
 "observability": {
  "enabled": true
 }
}

使用 CI/CD 进行部署

登录至 Cloudflare dashboard 并导航至 Workers & Pages 页面。选择 Create（创建）。

在 Import a repository（导入仓库）选项下，选择一个 Git 账号，然后选择包含你 Astro 项目的仓库。

配置项目：

Build command（构建命令）：npx astro build Deploy command（部署命令）：npx wrangler deploy 点击 Save and Deploy（保存并部署）。你现在可以在它提供的 workers.dev 子域名下，预览 Worker 部署的结果了。

如何将自定义域名绑定到 Cloudflare Worker

要将自定义域名绑定到 Cloudflare Worker，你需要在 Cloudflare 上加入域，并将你的 Worker 绑定到该域名。以下是具体步骤：

登录到你的 Cloudflare 账号，并选择你想要绑定的域名。
导航到 域 设置页面，选择加入域：
在 加入域 页面，对现有域进行添加。
导航到 Workers 页面，选择你的 Worker，然后点击 设置。
在 设置 页面，找到 域和路由 部分，点击 添加。
输入你想要绑定的自定义域名（例如 www.yourdomain.com）。
点击 添加域。

免费域名

DigitalPlat 提供免费域名，适合测试和开发用途。

默认注册成功后会获得一个免费域名，给官方的GitHub仓库Star后会获得一个额外的免费域名配额。

你可以在 DigitalPlat 上注册一个免费域名，并将其绑定到你的 Cloudflare Worker。

邀请奖励

邀请朋友注册，双方在成功注册后都可获得 +1 个域名配额。邀请链接