托管和部署 ASP.NET Core Blazor

本文介绍如何托管和部署 Blazor 应用。

发布应用

发布应用，用于发布配置中的部署。

dotnet publish -c Release

发布应用程序会触发项目依赖项的还原并生成项目，然后创建部署资产。 在生成过程期间，将删除未使用的方法和程序集，以减少应用下载大小并缩短加载时间。

默认发布位置

IIS

若要在 IIS 中托管 Blazor 应用，请参阅以下资源：

• IIS 托管
  • 将 ASP.NET Core 应用发布到 IIS
  • 使用 IIS 在 Windows 上托管 ASP.NET Core
• 托管和部署 ASP.NET Core 服务器端 Blazor 应用：Blazor Web App 应用（.NET 8 或更高版本）和在 IIS 上运行的应用（.NET 7 或更早版本），包括在 Azure 虚拟机（VM）上运行 Windows 操作系统的 IIS 和 Azure 应用服务。
• 使用 IIS 托管和部署 ASP.NET CoreBlazor WebAssembly：独立Blazor WebAssembly应用（所有 .NET 版本）和托管Blazor WebAssembly应用（.NET 7 或更早版本）。
• IIS 子应用程序托管
  • 在发布应用之前，请遵循 应用基础路径指南 。 这些示例使用应用基路径 /CoolApp，展示了如何从应用设置或其他配置提供程序获取基路径。
  • 按照高级配置中的子应用程序配置指南进行操作。 根站点下的子应用文件夹路径将成为子应用的虚拟路径。 对于 /CoolApp 的应用基路径，Blazor 应用放置在根站点下名为 CoolApp 的文件夹中，子应用采用虚拟路径 /CoolApp。

不支持在 ASP.NET Core 应用之间共享应用池，包括 Blazor 应用。 当使用 IIS 进行托管时，为每个应用使用一个应用池，并避免使用 IIS 的虚拟目录来承载多个应用。

Blazor Server MapFallbackToPage 配置

本部分仅适用于 Blazor Server应用。 MapFallbackToPage 不支持在 Blazor Web App 和 Blazor WebAssembly 应用中。

在应用需要具有包含自定义资源和 Razor 组件的单独区域的场景中：

• 在应用的 Pages 文件夹中创建一个文件夹来保存资源。 例如，在名为 Admin 的新文件夹中创建应用的管理员部分 (Pages/Admin)。

• 为该区域创建一个根页面 (_Host.cshtml)。 例如，从应用的主要根页面 (Pages/Admin/_Host.cshtml) 创建 Pages/_Host.cshtml 文件。 不要在 Admin @page 页面中提供 _Host 指令。

• 向该区域的文件夹添加布局（例如 Pages/Admin/_Layout.razor）。 在该单独区域的布局中，请设置 <base> 标记 href 来匹配该区域的文件夹（例如 <base href="/Admin/" />）。 出于演示目的，请将 ~/ 添加到页面中的静态资源。 例如：

  • ~/css/bootstrap/bootstrap.min.css
  • ~/css/site.css
  • ~/BlazorSample.styles.css（示例应用的命名空间为 BlazorSample）
  • ~/_framework/blazor.server.js(Blazor 脚本）

• 如果想让该区域具有自己的静态资产文件夹，请在 Program.cs 中添加文件夹并将它的位置指定为静态文件中间件（例如 app.UseStaticFiles("/Admin/wwwroot")）。

• 将 Razor 组件添加到该区域的文件夹。 至少，针对该区域使用正确的 Index 指令将 @page 组件添加到区域文件夹。 例如，根据应用的默认 Pages/Admin/Index.razor 文件添加 Pages/Index.razor 文件。 在文件顶部将 Admin 区域指示为路由模板 (@page "/admin")。 根据需要添加其他组件。 例如，使用 Pages/Admin/Component1.razor 指令添加 @page 并指示为路由模板 @page "/admin/component1。

• 在 Program.cs 中，在紧挨到 MapFallbackToPage 页面的回退根页面路径之前为该区域的请求路径调用 _Host：

  ...
  app.UseRouting();
  
  app.MapBlazorHub();
  app.MapFallbackToPage("~/Admin/{*clientroutes:nonfile}", "/Admin/_Host");
  app.MapFallbackToPage("/_Host");
  
  app.Run();