ASP.NET Core 模块(ANCM)深度解析与IIS集成指南

什么是ASP.NET Core模块(ANCM)

ASP.NET Core模块(ANCM)是一个原生IIS模块，它作为IIS管道的一部分运行，使ASP.NET Core应用能够在IIS上托管运行。这个模块是连接IIS和ASP.NET Core应用的关键桥梁。

两种托管模式

ANCM支持两种不同的托管模式，每种模式都有其特点和适用场景：

进程内托管模式(In-Process)

这是ASP.NET Core 3.0及更高版本的默认模式，特点包括：

• 应用直接在IIS工作进程(w3wp.exe)中运行
• 使用IIS HTTP服务器(IISHttpServer)替代Kestrel
• 性能更高，延迟更低
• 更好的诊断体验

关键配置：

<PropertyGroup>
  <AspNetCoreHostingModel>InProcess</AspNetCoreHostingModel>
</PropertyGroup>

进程外托管模式(Out-of-Process)

在这种模式下：

• IIS作为反向代理工作
• 请求被转发到后端运行的Kestrel服务器
• 需要额外的进程间通信开销

配置方法：

<PropertyGroup>
  <AspNetCoreHostingModel>OutOfProcess</AspNetCoreHostingModel>
</PropertyGroup>

安装ANCM

ANCM随.NET Core运行时一起安装，通过.NET Core托管捆绑包提供。安装步骤：

1. 下载最新版.NET Core托管捆绑包
2. 在服务器上运行安装程序
3. 确保IIS已安装并启用了必要的功能

web.config配置详解

ANCM通过web.config文件中的aspNetCore节点进行配置。以下是关键配置属性：

核心属性

属性	描述	默认值
processPath	启动应用的执行文件路径	必需
arguments	传递给执行文件的参数	可选
hostingModel	托管模式(inprocess/outofprocess)	inprocess
stdoutLogEnabled	是否启用标准输出日志	false
stdoutLogFile	日志文件路径	aspnetcore-stdout

示例配置

框架依赖部署(FDD)配置：

<aspNetCore processPath="dotnet"
            arguments=".\MyApp.dll"
            stdoutLogEnabled="true"
            stdoutLogFile=".\logs\stdout"
            hostingModel="inprocess">
  <environmentVariables>
    <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
  </environmentVariables>
</aspNetCore>

独立部署(SCD)配置：

<aspNetCore processPath=".\MyApp.exe"
            stdoutLogEnabled="true"
            stdoutLogFile=".\logs\stdout"
            hostingModel="inprocess" />

环境变量管理

可以在web.config中设置环境变量，这些变量会覆盖系统环境变量：

<environmentVariables>
  <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Staging" />
  <environmentVariable name="CUSTOM_PATH" value="D:\config" />
</environmentVariables>

应用离线机制

当在应用根目录放置app_offline.htm文件时：

1. ANCM尝试优雅关闭应用
2. 在shutdownTimeLimit指定时间内等待应用关闭
3. 期间所有请求返回app_offline.htm内容
4. 超时后强制终止进程

常见问题与解决方案

1. 端口冲突：确保没有其他应用占用相同端口
2. 权限问题：应用池身份需有足够权限访问应用目录
3. 启动失败：检查stdout日志获取详细错误信息
4. 环境变量不生效：确保在正确位置设置变量

最佳实践

1. 生产环境使用进程内托管以获得最佳性能
2. 开发环境可以启用stdout日志便于调试
3. 不要在生产环境设置ASPNETCORE_ENVIRONMENT=Development
4. 为每个应用使用独立的应用池
5. 定期清理日志文件防止磁盘空间耗尽

通过合理配置ANCM，可以充分发挥ASP.NET Core在IIS上的性能优势，同时保持与现有IIS生态系统的兼容性。