IIS 部署 .NET 6 WebApi 实战指南(附优缺点分析)

在 .NET 开发体系里,IIS 一直是部署 WebApi 的主力工具。

很多人接口写得很熟练,但真正涉及部署时,却容易卡在环境、权限、证书这些细节上。

今天我们从 0 到 1,把 .NET 6 WebApi 部署到 IIS 上跑起来,同时聊聊它适合做什么、不适合做什么。


一、环境准备

部署前,先确认三件事:

1️⃣ 已安装 IIS

控制面板 → 启用或关闭 Windows 功能 → 勾选:

  • Internet Information Services

  • Web 管理工具

  • 万维网服务

  • 应用程序开发功能

安装完成后访问:

复制代码
http://localhost

能看到默认页面说明成功。


2️⃣ 安装 .NET 6 Hosting Bundle

这是最关键的一步。

如果服务器没有安装对应版本的 Hosting Bundle,接口基本都会报:

HTTP Error 500.30 - ANCM In-Process Start Failure

下载地址(.NET 6):

https://dotnet.microsoft.com/en-us/download/dotnet/6.0https://dotnet.microsoft.com/en-us/download/dotnet/6.0


3️⃣ WebApi 已发布为 Release

在 Visual Studio 中:

右键项目 → 发布 → 文件夹 → 选择发布路径

发布完成后会得到:

  • xxx.dll

  • web.config

  • wwwroot

这就是 IIS 要指向的物理目录。


二、在 IIS 中创建站点

打开 IIS 管理器:

网站 → 右键 → 添加网站

配置如下:

  • 物理路径:选择刚才发布后的文件夹

  • 端口:例如 80(测试环境)

  • 应用程序池:默认即可(.NET Core 不依赖传统 CLR)

完成后访问:

复制代码
http://localhost:80/swagger

如果能打开 Swagger 页面,说明部署成功。


三、常见问题排查

❌ 500.30 启动失败

大概率是没有安装 Hosting Bundle,或者版本不匹配。


❌ 403 无权限访问

给站点文件夹添加权限:

  • IIS_IUSRS

  • 或 Everyone(测试环境可用)

生产环境建议精细化控制权限。


❌ 端口冲突

执行:

netstat -ano

查看端口是否被占用。


四、IIS 部署 WebApi 的优势

在 Windows 服务器环境下,IIS 部署 WebApi 仍然是非常稳妥的方案。

1️⃣ 集成度高

与 Windows 深度整合,无需额外学习 Linux 运维体系。


2️⃣ 稳定成熟

应用程序池回收机制完善,长期运行稳定。


3️⃣ 权限体系清晰

基于 Windows 账户体系控制访问权限,安全性高。


4️⃣ 操作可视化

对不熟悉服务器命令行的人非常友好。


五、那 IIS 适合部署 Vue 吗?

结论:不太理想。

原因很简单。

Vue 属于单页应用(SPA),它需要:

  • URL Rewrite 重写规则

  • 处理 history 路由模式

  • 各种重定向配置

  • applicationHost.config 相关调整

如果不正确配置,刷新页面直接 404。

IIS 本质上更偏向传统 Web 服务,并不是为现代前端应用优化的服务器。

简单静态页面还可以,但复杂前端项目维护成本较高。

如果是前后端分离项目,通常会采用:

👉 IIS 负责 WebApi

👉 Nginx 负责前端静态资源与反向代理

这才是更主流的生产架构。


六、关于 HTTPS 的说明

本文演示采用的是 HTTP 测试部署方式。

但在生产环境中,必须启用 HTTPS。

尤其是涉及:

  • 登录

  • Token 传输

  • 用户数据

  • 支付接口

如果你有部署 HTTPS 的实际需求,可以在评论区留言。

我可以单独整理一期完整内容,包括:

  • SSL 证书类型说明

  • 免费证书申请流程

  • IIS 绑定证书步骤

  • 强制 HTTP 跳转 HTTPS

  • 常见证书报错排查

  • 多域名 / 泛域名场景处理

当系统真正对外开放时:

HTTP 只是开发阶段的选择,HTTPS 才是上线的入场券。

相关推荐
用户298698530141 天前
.NET 文档自动化:Spire.Doc 设置奇偶页页眉/页脚的最佳实践
后端·c#·.net
赵榕2 天前
ClaimsPrincipal序列化为Json的正确姿势
.net
追逐时光者3 天前
一款使用 C# 编写专为 Windows 11 打造的文件资源管理器增强工具!
后端·.net
用户298698530145 天前
程序员效率工具:Spire.Doc如何助你一键搞定Word表格排版
后端·c#·.net
牧马人win5 天前
SmartDapper.Repository
.net
mudtools6 天前
搭建一套.net下能落地的飞书考勤系统
后端·c#·.net
玩泥巴的7 天前
搭建一套.net下能落地的飞书考勤系统
c#·.net·二次开发·飞书