Cloudflare 中文文档
Pages
编辑这个页面
跳转官方原文档
Set theme to dark (⇧+D)

Blazor

Blazor是一个 SPA 框架,可在浏览器中使用 C# 代码而非 JavaScript。在本指南中,你将使用 Blazor 构建一个网站,并使用 Cloudflare Pages 进行部署。

​​ 安装 .NET

Blazor 使用 C#。你需要最新版本的 .NET SDK 才能继续创建 Blazor 项目。如果你的系统中没有安装 SDK,请下载并运行安装程序。

​​ 创建新的 Blazor WASM 项目

Blazor有两种托管模式: Blazor 服务器需要服务器为最终用户提供 Blazor 应用程序,而 Blazor WebAssembly则在浏览器中运行。Blazor 服务器与 Cloudflare 边缘网络模式不兼容,因此本指南仅使用 Blazor WebAssembly。

运行以下命令创建一个新的 Blazor WebAssembly (WASM) 应用程序:

​​ 创建构建脚本

要进行部署,Cloudflare Pages 需要一种构建 Blazor 项目的方法。在项目的根目录下创建一个 build.sh 文件。用以下内容填充该文件(如果你使用的不是最新的 .NET SDK,请适当更新.dotnet-install.sh行):

你的 build.sh 文件必须是可执行的,这样编译命令才会起作用。运行 chmod +x build.sh 即可。

​​ 在你继续之前

所有框架指南都假定你已经对 Git 有了基本了解。如果你是 Git 的新手,请参考这本 Git 手册摘要,了解如何在本地机器上设置 Git。

如果使用 SSH 克隆,则必须在每台用于从 GitHub 推送或拉取的计算机上 生成 SSH 密钥

更多信息请参阅 GitHub 文档 Git 文档

​​ 创建一个 .gitignore 文件

创建.gitignore 文件可确保只将需要的内容推送到 GitHub 仓库。运行以下命令创建.gitignore文件:

​​ 创建 GitHub 仓库

访问 repo.new,创建一个新的 GitHub 仓库。创建新仓库后,进入新创建的项目目录,准备并在终端运行以下命令将本地应用程序推送到 GitHub:

​​ 使用 Cloudflare 页面部署

将网站部署到页面:

  1. 登录 Cloudflare 仪表板 并选择你的账户。
  2. 账户主页 中,选择 **工作者和页面**
  3. 选择 创建应用程序> 页面> 连接到 Git

选择你创建的新 GitHub 仓库,并在设置构建和部署部分提供以下信息:

Configuration option Value
Build command ./build.sh

配置网站后,你可以开始首次部署。在部署之前,你应该能看到 Cloudflare 页面正在安装 dotnet、项目依赖项并构建网站。

部署网站后,你将在 *.pages.dev上为你的项目收到一个唯一的子域。 每次你向 Blazor 网站提交新代码时,Cloudflare Pages 都会自动重建你的项目并进行部署。你还可以访问新拉取请求上的 预览部署,这样你就可以在将更改部署到生产环境之前预览网站的外观。

​​ 疑难解答

​​ 文件超过 25 MiB 限制

如果收到错误信息 Error: Asset "/opt/buildhome/repo/output/wwwroot/_framework/dotnet.wasm" is over the 25MiB limit,请执行以下操作之一解决此问题:

  1. 通过以下 指南缩小资产规模。

或者

  1. 删除输出(rm output/wwwroot/_framework/*.wasm)中的*.wasm文件,并修改你的 Blazor 应用程序,改为 加载 Brotli 压缩文件

​​ 了解更多

完成本指南后,你已成功将 Blazor 网站部署到 Cloudflare Pages。要开始使用其他框架,请参阅框架指南列表