Asp.Net Core 中怎么发布到IIS

在Asp.Net Core开发中，将应用程序发布到IIS（Internet Information Services）是一个常见的需求。IIS是Windows服务器上的一个强大的Web服务器，能够托管和管理Web应用程序。本文将详细介绍如何将Asp.Net Core应用程序发布到IIS，并确保其正常运行。

1. 准备工作

在开始之前，确保你已经完成了以下准备工作：

• 安装IIS：确保目标服务器上已经安装了IIS。如果没有安装，可以通过“服务器管理器”中的“添加角色和功能”来安装IIS。
• 安装.NET Core Hosting Bundle：Asp.Net Core应用程序需要.NET Core运行时和ASP.NET Core模块来运行。你可以从.NET Core下载页面下载并安装.NET Core Hosting Bundle。这个包包含了.NET Core运行时、ASP.NET Core模块以及其他必要的组件。
• 安装Visual Studio：如果你在本地开发环境中使用Visual Studio，确保已经安装了最新版本的Visual Studio，并且已经安装了.NET Core SDK。

2. 发布Asp.Net Core应用程序

2.1 使用Visual Studio发布

1. 打开项目：在Visual Studio中打开你的Asp.Net Core项目。
2. 发布配置：右键点击项目，选择“发布”。在发布窗口中，选择“文件夹”作为发布目标。
3. 选择发布位置：选择一个本地文件夹作为发布的目标位置。你可以选择发布到本地磁盘的某个目录，或者直接发布到IIS的网站目录。
4. 发布：点击“发布”按钮，Visual Studio将会编译项目并将所有必要的文件发布到指定的文件夹中。

2.2 使用命令行发布

如果你更喜欢使用命令行工具，可以使用dotnet publish命令来发布应用程序。

1. 打开命令行：打开命令提示符或PowerShell，并导航到你的项目目录。
2. 发布命令：运行以下命令来发布应用程序：

   dotnet publish -c Release -o ./publish

这将会在./publish目录下生成发布文件。

3. 配置IIS

3.1 创建IIS网站

1. 打开IIS管理器：在服务器上打开IIS管理器。
2. 添加网站：在左侧的连接树中，右键点击“站点”，选择“添加网站”。
3. 配置网站：
   • 网站名称：输入一个唯一的网站名称。
   • 物理路径：选择你发布应用程序的文件夹路径。
   • 绑定：配置IP地址、端口和主机名。如果你不确定，可以使用默认的*:80绑定。
4. 确认：点击“确定”创建网站。

3.2 配置应用程序池

1. 打开应用程序池：在IIS管理器中，点击左侧的“应用程序池”。
2. 选择应用程序池：找到你刚刚创建的网站对应的应用程序池。
3. 设置.NET CLR版本：右键点击应用程序池，选择“高级设置”。在“常规”部分，将“.NET CLR版本”设置为“无托管代码”。
4. 设置托管管道模式：在“高级设置”中，将“托管管道模式”设置为“集成”。

3.3 配置Web.config

Asp.Net Core应用程序需要一个web.config文件来配置IIS。如果你使用Visual Studio发布，这个文件通常会自动生成。如果你手动发布，可以创建一个web.config文件，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified"/>
    </handlers>
    <aspNetCore processPath="dotnet" arguments=".\YourApp.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="InProcess"/>
  </system.webServer>
</configuration>

确保arguments属性中的YourApp.dll与你的应用程序入口点DLL文件名称一致。

4. 测试应用程序

1. 启动网站：在IIS管理器中，右键点击你创建的网站，选择“管理网站” -> “启动”。
2. 访问网站：在浏览器中输入网站的URL（例如http://localhost），查看应用程序是否正常运行。

5. 常见问题排查

• 500.19错误：通常是由于web.config文件配置错误或缺少必要的模块。检查web.config文件是否正确，并确保安装了.NET Core Hosting Bundle。
• 502.5错误：通常是由于应用程序无法启动。检查应用程序日志，确保dotnet命令能够正确启动应用程序。
• 权限问题：确保IIS应用程序池的账户对发布文件夹有足够的权限。

6. 总结

通过以上步骤，你可以成功将Asp.Net Core应用程序发布到IIS，并确保其正常运行。发布过程中可能会遇到一些问题，但通过仔细检查配置和日志，通常可以快速解决。希望本文对你有所帮助，祝你发布顺利！