1. 项目概述ASP.NET Core 是微软推出的跨平台、高性能 Web 开发框架而 IIS (Internet Information Services) 是 Windows 平台上最成熟的 Web 服务器之一。将 ASP.NET Core 应用部署到 IIS 是许多企业级应用的标准选择这种组合既能利用 ASP.NET Core 的现代特性又能享受 IIS 的强大管理功能和稳定性。在实际工作中我发现很多开发者在部署 ASP.NET Core 应用到 IIS 时会遇到各种问题比如模块配置错误、权限设置不当、发布方式选择错误等。本文将详细介绍从项目发布到 IIS 配置的完整流程包含我在实际项目中积累的经验技巧。2. 环境准备2.1 服务器环境配置在开始部署前需要确保服务器满足以下条件Windows Server 版本建议使用 Windows Server 2016 或更高版本IIS 安装通过添加角色和功能安装 IIS需要包含以下组件Web 服务器 (IIS)管理工具中的 IIS 管理控制台ASP.NET 4.8 (用于向后兼容).NET Core 托管捆绑包这是 ASP.NET Core 在 IIS 中运行的关键组件安装 .NET Core 托管捆绑包的命令行方法# 下载最新版托管捆绑包 Invoke-WebRequest -Uri https://dotnet.microsoft.com/permalink/dotnetcore-current-windows-runtime-bundle-installer -OutFile dotnet-hosting.exe # 静默安装 .\dotnet-hosting.exe /install /quiet /norestart注意安装完成后需要重启服务器或至少重启 IIS 服务可以使用命令net stop was /y net start w3svc2.2 开发环境配置开发机器上需要安装最新版 .NET SDK安装 Visual Studio (可选但推荐)确保项目能在本地正常运行3. 项目发布准备3.1 发布配置设置在项目根目录的 Properties/PublishProfiles 文件夹下创建发布配置文件。以下是典型的文件夹发布配置示例Project PropertyGroup PublishProtocolFileSystem/PublishProtocol ConfigurationRelease/Configuration TargetFrameworknet8.0/TargetFramework PublishDirbin\Release\net8.0\publish\/PublishDir SelfContainedfalse/SelfContained RuntimeIdentifierwin-x64/RuntimeIdentifier PublishSingleFilefalse/PublishSingleFile PublishReadyToRuntrue/PublishReadyToRun /PropertyGroup /Project关键参数说明SelfContained: false 表示使用框架依赖部署RuntimeIdentifier: 指定目标运行时环境PublishReadyToRun: 启用预编译提升启动性能3.2 发布命令可以通过多种方式发布项目Visual Studio 发布右键项目 → 发布 → 选择文件夹发布配置目标位置后点击发布按钮命令行发布dotnet publish -c Release -p:PublishProfileFolderProfile发布完成后会在指定目录生成以下关键文件应用程序 DLLweb.config (IIS 配置文件)wwwroot 静态文件依赖的 NuGet 包4. IIS 站点配置4.1 创建应用程序池打开 IIS 管理器右键应用程序池 → 添加应用程序池配置参数名称与项目相关的有意义名称.NET CLR 版本无托管代码托管管道模式集成立即启动是经验分享我建议为每个应用创建独立的应用程序池这样可以隔离不同应用避免相互影响。同时将回收设置为固定时间间隔如每天凌晨而不是基于内存或请求数。4.2 创建网站右键站点 → 添加网站填写基本信息网站名称描述性名称物理路径指向发布文件夹绑定类型http 或 httpsIP 地址全部未分配端口80 (http) 或 443 (https)主机名如果有域名则填写设置应用程序池选择之前创建的专用池身份验证匿名身份验证启用ASP.NET 模拟禁用Windows 身份验证按需启用4.3 权限配置这是最容易出问题的环节需要确保应用程序池标识对发布文件夹有读取和执行权限IIS_IUSRS 组对发布文件夹有读取权限如果应用需要写入日志或上传文件需要配置相应目录的写入权限可以使用以下 PowerShell 命令设置权限$folderPath C:\path\to\published\app $acl Get-Acl $folderPath $accessRule New-Object System.Security.AccessControl.FileSystemAccessRule(IIS AppPool\YourAppPoolName, ReadAndExecute, ContainerInherit,ObjectInherit, None, Allow) $acl.AddAccessRule($accessRule) Set-Acl -Path $folderPath -AclObject $acl5. 高级配置与优化5.1 web.config 调整ASP.NET Core 发布时会自动生成 web.config但有时需要手动调整?xml version1.0 encodingutf-8? configuration location path. inheritInChildApplicationsfalse system.webServer handlers add nameaspNetCore path* verb* modulesAspNetCoreModuleV2 resourceTypeUnspecified / /handlers aspNetCore processPathdotnet arguments.\YourApp.dll stdoutLogEnabledtrue stdoutLogFile.\logs\stdout hostingModelinprocess environmentVariables environmentVariable nameASPNETCORE_ENVIRONMENT valueProduction / /environmentVariables /aspNetCore /system.webServer /location /configuration关键参数说明hostingModel: inprocess (推荐) 或 outofprocessstdoutLogEnabled: 生产环境建议设为 falseenvironmentVariables: 可设置各种环境变量5.2 性能优化启用静态内容缓存在 IIS 中找到HTTP 响应头设置添加过期时间如 7 天配置输出缓存安装输出缓存模块对静态资源配置缓存策略启用动态压缩在 IIS 中启用动态内容压缩配置压缩级别5.3 HTTPS 配置申请 SSL 证书在 IIS 中绑定 443 端口配置 HSTS (HTTP Strict Transport Security)6. 常见问题排查6.1 错误 500.19这是最常见的错误之一通常由以下原因引起web.config 格式错误缺少模块权限问题解决方法检查事件查看器中的详细错误信息确保安装了 .NET Core 托管捆绑包验证应用程序池标识对文件夹有足够权限6.2 错误 502.5通常表示进程启动失败可能原因应用程序 DLL 路径错误缺少依赖项端口冲突解决方法检查应用程序池设置查看 Windows 事件日志获取详细信息尝试手动运行 dotnet YourApp.dll 看是否有错误6.3 静态文件无法访问可能原因静态文件中间件未正确配置wwwroot 文件夹权限问题MIME 类型未配置解决方法确保 app.UseStaticFiles() 在 Startup 中调用检查静态文件是否确实发布到了 wwwroot在 IIS 中添加缺少的 MIME 类型7. 部署自动化对于频繁部署的场景可以考虑自动化7.1 PowerShell 部署脚本# 停止网站 Stop-WebSite -Name YourSiteName # 发布应用 dotnet publish -c Release -o C:\publish\output # 同步文件 robocopy C:\publish\output \\server\share\YourApp /MIR # 启动网站 Start-WebSite -Name YourSiteName # 回收应用池 Restart-WebAppPool -Name YourAppPool7.2 CI/CD 集成可以在 Azure DevOps 或 GitHub Actions 中配置自动化部署流水线典型步骤包括代码检出运行测试发布应用部署到服务器运行健康检查8. 监控与维护部署完成后建议设置日志收集配置 IIS 日志设置 ASP.NET Core 日志考虑使用 Application Insights性能监控使用性能计数器监控关键指标设置警报阈值定期维护清理日志文件更新 .NET Core 运行时检查证书过期时间9. 实际经验分享经过多个项目的实践我总结了以下经验部署模式选择框架依赖部署更节省空间独立部署适合环境严格控制的场景进程模型In-process 模式性能更好Out-of-process 模式更易于调试性能调优启用 ReadyToRun 编译可提升启动速度合理配置垃圾回收模式安全建议总是使用 HTTPS限制应用程序池权限定期更新运行时故障排查技巧首先检查 Windows 事件日志启用 stdout 日志获取详细信息使用失败请求跟踪功能10. 总结将 ASP.NET Core 应用部署到 IIS 是一个多步骤的过程需要关注环境配置、权限设置、性能优化等多个方面。本文详细介绍了从开发环境准备到生产环境部署的完整流程包含了我在实际项目中积累的经验和最佳实践。记住成功的部署不仅仅是让应用运行起来还需要考虑性能、安全性和可维护性。建议在项目初期就建立自动化部署流程并制定完善的监控方案。