如何将 Blazor 项目发布并部署到 IIS 服务器上？

Blazor 是微软推出的基于 Web 的前端框架，可以用 C# 代替 JavaScript 写交互逻辑。开发完成后，我们通常需要把 Blazor 应用部署到 IIS，以便通过浏览器对外提供服务。下面介绍具体的发布与部署步骤。

一、在 Visual Studio 中发布 Blazor 项目

打开你的 Blazor 项目，右键点击项目选择“发布”。可以选择发布到文件夹，这样最方便后续手动复制到服务器。

• 目标选择“文件夹”
• 指定一个本地输出目录，例如 D:publishblazor
• 点击发布，等待生成完成

发布成功后，目录里会包含 wwwroot 文件夹、bin 目录、web.config 等文件。

二、准备 IIS 服务器环境

在 Windows 服务器上，需要先安装 IIS 和 ASP.NET Core 托管捆绑包，否则 IIS 无法运行 Blazor 应用。

安装 IIS

通过“服务器管理器”添加角色，勾选 Web 服务器 IIS。确保包含“应用程序开发”下的相关功能。

安装托管捆绑包

下载并安装 ASP.NET Core 托管捆绑包，它包含 .NET Runtime 和 IIS 的 ASP.NET Core 模块。

三、在 IIS 中创建站点

打开 IIS 管理器，按如下流程操作：

1. 新建应用程序池，命名为 BlazorPool，.NET CLR 版本选“无托管代码”
2. 新建网站，物理路径指向发布文件夹
3. 绑定端口，例如 80 或 5000
4. 应用程序池选择刚才建的 BlazorPool

四、检查权限与 web.config

IIS 用户需要对发布目录有读取和执行权限。发布生成的 web.config 一般已配置好，核心内容如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet" arguments=".你的项目.dll" stdoutLogEnabled="false" stdoutLogFile=".logsstdout" />
    </system.webServer>
  </location>
</configuration>

其中 arguments 里的 dll 名称要和实际发布生成的主程序集一致。

五、启动并验证

在 IIS 中启动站点，浏览器访问对应地址。如果看到 Blazor 页面正常渲染并可以交互，说明部署成功。

注意：若页面空白，先检查应用程序池是否运行，以及事件查看器中是否有 dotnet 相关报错。

常见部署问题

按照以上步骤，你就能把 Blazor 项目顺利发布和部署到 IIS 上，供用户访问使用。

BlazorIIS部署ASP.NET_Core修改时间：2026-07-27 02:30:27