Windows Server IIS 安装 .NET 8 运行环境操作文档

一、环境要求

• 操作系统：

• Windows Server 2016

• Windows Server 2019

• Windows Server 2022

• IIS Web Server 已安装。

• 服务器可以访问互联网，或提前准备离线安装包。

二、安装 IIS 组件

打开 服务器管理器 → 添加角色和功能。

安装以下角色服务：

Web 服务器（IIS）

勾选：

Web 服务器

• 常见 HTTP 功能

• 默认文档

• HTTP 错误

• 静态内容

应用程序开发

• .NET Extensibility 4.8

• ASP.NET 4.8

• ISAPI Extensions

• ISAPI Filters

• WebSocket Protocol（推荐）

安全性

• 请求筛选

管理工具

• IIS 管理控制台

安装完成后重启服务器。

三、安装 .NET 8 Runtime

下载并安装：

• .NET 8 Runtime（x64）

• ASP.NET Core Runtime 8.0（x64）

建议直接安装：

ASP.NET Core Hosting Bundle 8.0

该安装包包含：

• .NET Runtime

• ASP.NET Core Runtime

• IIS Module（ANCM）

• IIS 与 ASP.NET Core 集成组件

安装命令示例：

dotnet-hosting-8.0.x-win.exe /quiet /norestart

安装完成后建议重启服务器：

shutdown /r /t 0

四、验证安装

打开 CMD 或 PowerShell：

dotnet --info

正常情况下会显示类似：

.NET SDK:
 Version:   8.0.xxx

Host:
 Version:   8.0.xxx
 Architecture: x64

查看已安装运行时：

dotnet --list-runtimes

示例输出：

Microsoft.AspNetCore.App 8.0.x
Microsoft.NETCore.App 8.0.x

五、验证 IIS 模块安装

执行：

%windir%\\System32\\inetsrv\\appcmd list modules | findstr AspNetCoreModuleV2

正常输出：

MODULE "AspNetCoreModuleV2"

说明 IIS 已成功安装 ASP.NET Core 模块。

六、创建 IIS 应用程序池

打开 IIS 管理器：

1. 应用程序池

2. 添加应用程序池

3. 配置如下：

说明：

ASP.NET Core 程序运行在独立的 Kestrel 进程中，因此 IIS 应用程序池必须选择：

无托管代码（No Managed Code）

七、发布 ASP.NET Core 8 程序

开发服务器执行：

dotnet publish -c Release -o publish

生成目录例如：

publish
│
├── web.config
├── xxx.dll
├── xxx.exe
└── appsettings.json

将整个 publish 目录复制到 IIS 网站目录，例如：

D:\\WebSite\\TestApi

八、创建 IIS 网站

打开 IIS 管理器：

1. 网站

2. 添加网站

配置：

点击确定完成创建。

九、权限配置

确保 IIS 应用程序池身份对网站目录具有读取权限。

例如：

IIS AppPool\\DotNet8

授予：

• 读取

• 列出目录

• 读取和执行

如果程序需要写日志或上传文件，还需授予：

• 修改

• 写入

十、常见故障排查

1、HTTP Error 500.30 - ANCM In-Process Start Failure

通常原因：

• 未安装 Hosting Bundle

• 程序版本与服务器 Runtime 不一致

• 配置文件错误

检查：

dotnet --list-runtimes

2、HTTP Error 500.31 - Failed to Find Native Dependencies

原因：

服务器缺少对应版本 Runtime。

解决：

安装对应版本的 ASP.NET Core Hosting Bundle。

3、HTTP Error 502.5 - Process Failure

原因：

应用程序启动失败。

查看日志：

stdoutLogEnabled="true"
stdoutLogFile=".\\logs\\stdout"

日志目录：

网站目录\\logs\\

同时查看 Windows 事件查看器：

Windows 日志
 └── 应用程序

十一、常用检查命令

查看 .NET 版本：

dotnet --info

查看 Runtime：

dotnet --list-runtimes

查看 SDK：

dotnet --list-sdks

查看 IIS 模块：

%windir%\\System32\\inetsrv\\appcmd list modules

查看 IIS 网站：

%windir%\\System32\\inetsrv\\appcmd list site

查看应用程序池：

%windir%\\System32\\inetsrv\\appcmd list apppool

十二、推荐生产环境配置

• 启用 HTTPS

• 配置自动回收时间

• 开启 Failed Request Tracing

• 配置日志轮转

• 配置 Windows Defender 排除目录

• 开启应用程序预热

• 定期备份网站及配置文件

推荐排除目录：

网站目录
日志目录
临时目录

以减少实时扫描对性能的影响。