项目：ASP.NET Core 8.0 Web API
服务器：阿里云 Windows Server + IIS
部署方式：VS Web Deploy 一键发布
一、前置准备
1.1 本地环境
| 项 | 说明 |
|---|---|
| 项目框架 | .NET 8.0 |
| 开发工具 | Visual Studio |
| 发布方式 | Web Deploy（直接推送到远程 IIS） |
1.2 服务器环境
| 项 | 说明 |
|---|---|
| 操作系统 | Windows Server（阿里云） |
| 公网 IP | XXXX |
| Web 服务器 | IIS（已安装） |
1.3 代码调整
Program.cs中 Swagger 原本只在开发环境启用：
// 修改前if(app.Environment.IsDevelopment()){app.UseSwagger();app.UseSwaggerUI();}// 修改后（去掉环境判断，生产也可见）app.UseSwagger();app.UseSwaggerUI();二、服务器端安装与配置
2.1 安装 .NET 8 Hosting Bundle
下载地址：https://dotnet.microsoft.com/zh-cn/download/dotnet/8.0
注意：Hosting Bundle 不是独立板块，它在ASP.NET Core 运行时那一行的链接里，找 “Hosting Bundle” 这个小链接。
安装时选最新版 8.0.29，安装完成后重启 IIS：
iisreset2.2 安装 IIS 管理服务（Management Service）
Web Deploy 需要管理服务来接收远程发布请求。
Install-WindowsFeatureWeb-Mgmt-Service2.3 安装 Web Deploy
下载：https://www.iis.net/downloads/microsoft/web-deploy
选Web Deploy 4.0，安装时选择更改（Change），务必勾选所有子组件（尤其是IIS Deployment Handler），否则 msdeploy 处理器不会注册到 IIS。
2.4 启用远程连接
- 打开 IIS 管理器
- 左侧选中服务器节点（最顶层）
- 双击管理服务
- 先点右侧停止
- 勾选启用远程连接
- 端口保持默认8172
- 点右侧应用→启动
2.5 放行端口
Windows 防火墙
添加入站规则，放行 TCP 端口8172和8080（站点端口）。
阿里云安全组
在阿里云控制台 → 安全组 → 入方向规则，添加：
| 端口 | 协议 | 用途 |
|---|---|---|
| 8080 | TCP | 站点访问 |
| 8172 | TCP | Web Deploy 远程发布 |
2.6 创建 IIS 站点
| 设置项 | 值 |
|---|---|
| 站点名称 | JpaasPrinter |
| 物理路径 | C:\inetpub\wwwroot\JpaasPrinter |
| 绑定端口 | 8080 |
| 应用程序池 .NET CLR 版本 | 无托管代码 |
| 托管管道模式 | 集成 |
2.7 设置文件夹权限
站点物理路径（如C:\inetpub\wwwroot\JpaasPrinter）需要让 IIS 应用池账户读取。
右键文件夹 → 属性 → 安全 → 编辑 → 添加：
IIS AppPool\JpaasPrinter权限勾选：读取和执行、列出文件夹内容、读取。
三、VS 发布配置
3.1 配置发布配置文件
右键项目 →发布→Web 服务器 (IIS)→Web 部署。
| 字段 | 填写内容 |
|---|---|
| 服务器 | XXX |
| 站点名称 | JpaasPrinter（必须和 IIS 里完全一致） |
| 目标 URL | http://XXX:8080 |
| 用户名 | Administrator |
| 密码 | 服务器 Administrator 密码 |
3.2 允许不受信任的证书
Windows Server 的 IIS 管理服务使用自签名证书，VS 默认不信任。两种修复方式：
方式 A（推荐）：编辑Properties\PublishProfiles\IISProfile.pubxml，添加：
<AllowUntrustedCertificate>true</AllowUntrustedCertificate>方式 B：在 VS 发布页面 → 更多连接选项 → 勾选允许不受信任的证书。
四、遇到的问题及解决
问题 1：找不到 Hosting Bundle 下载
现象：.NET 8.0 下载页面没有独立叫 “Hosting Bundle” 的板块。
原因：Hosting Bundle 的下载链接藏在ASP.NET Core 运行时那一行的小字链接里。
解决：展开某个版本号，在"ASP.NET Core 运行时"行中找到 “Hosting Bundle” 链接，或直接访问：https://dotnet.microsoft.com/zh-cn/download/dotnet/thank-you/runtime-aspnetcore-8.0.29-windows-hosting-bundle-installer
问题 2：IIS 里看不到管理服务
现象：装了 Web Deploy 但 IIS 管理器里没有出现"管理服务"功能。
原因：管理服务（Management Service）是 IIS 的一个独立功能，不随 Web Deploy 安装。
解决：
Install-WindowsFeatureWeb-Mgmt-Service问题 3：VS 验证连接报 404
现象：
Web 部署任务失败。远程服务器返回了错误 (404) 未找到。原因（两个可能）：
- 管理服务"启用远程连接"没打勾
- Web Deploy 的 msdeploy.axd 处理器没注册到 IIS
排查：
# 检查 WMSVC 服务和 IIS 管理服务状态Get-ServiceWMSVCGet-WindowsFeatureWeb-Mgmt-ServiceTest-NetConnection8.135.xx.xx-Port 8172# 检查 msdeploy 处理器Get-WebHandler|Where-Object{$_.Name-like"*msdeploy*"}解决：
- 如端口不通 → 检查防火墙和安全组
- 如管理服务没启用 → IIS 管理器里勾选"启用远程连接"
- 如处理器丢失 → 修复 Web Deploy 安装，确保勾选 IIS Deployment Handler
问题 4：证书验证失败
现象：
ERROR_CERTIFICATE_VALIDATION_FAILED原因：IIS 管理服务使用自签名证书，VS 不信任。
解决：在发布配置文件中添加：
<AllowUntrustedCertificate>true</AllowUntrustedCertificate>五、发布时的行为说明
文件替换机制
- ASP.NET Core 使用影子复制：IIS 启动时会从
publish目录复制文件到临时目录再执行，原始文件不被锁定。 - 发布时 Web Deploy 可以直接覆盖原始文件，不会被"文件使用中"拦住。
- 覆盖完成后，ASP.NET Core Module 检测到文件变化，自动回收旧进程，用新文件重新启动。
站点是否停机
发布过程中站点不会主动停止。文件替换后新进程自动启动，切换期间可能 1-3 秒请求失败（502/503），流量小的项目无需在意。
六、快速参考
常用命令
# 重启 IISiisreset# 检查管理服务状态Get-ServiceWMSVC# 检查 IIS 站点列表Get-Website|Select-ObjectName,PhysicalPath,State# 检查端口连通性Test-NetConnection8.135.xx.xx-Port 8172Test-NetConnection8.135.xx.xx-Port 8080# 检查 Web Deploy 处理器Get-WebHandler|Where-Object{$_.Name-like"*msdeploy*"}端口清单
| 端口 | 协议 | 用途 | 需放行位置 |
|---|---|---|---|
| 8080 | TCP | 网站访问 | 阿里云安全组 + Windows 防火墙 |
| 8172 | TCP | Web Deploy 发布 | 阿里云安全组 + Windows 防火墙 |
