ThingsGateway/doc/docs/402.mdx

---
id: 402
title: IIS部署
---

import useBaseUrl from "@docusaurus/useBaseUrl";
import Tag from "@site/src/components/Tag.js";
import Highlight from '@site/src/components/Highlight.js';

:::caution 注意

1、必须启用IIS WebSocket协议

2、禁用IIS回收
:::


:::tip `提示`

 如果需要Runtime依赖部署，需要安装ASP.NET Core Runtime，如果是独立发布部署，则不需要安装Runtime

 下载链接:https://dotnet.microsoft.com/zh-cn/download/dotnet

:::


:::tip 精简发布文件

如果需要精简发布后的文件，也就是删除不必要的文件夹，可以编辑 Web 项目的 `.csproj` 并添加 `<SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>`，如：

```cs showLineNumbers  {3}
<PropertyGroup>
  <TargetFramework>net6.0</TargetFramework>
  <SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>
</PropertyGroup>
```

若无需生成 `.pdb` 文件，可以继续添加：

```cs showLineNumbers {2-3}
<PropertyGroup>
  <DebugType>none</DebugType>
  <DebugSymbols>false</DebugSymbols>
</PropertyGroup>
```

:::


## 服务器环境配置

### 第一步

安装.NET Core 运行时捆绑包：[点击下载](https://dotnet.microsoft.com/permalink/dotnetcore-current-windows-runtime-bundle-installer)

### 第二步（命令）

```bash showLineNumbers
net stop was /y
```

### 第三步（命令）

```bash showLineNumbers
net start w3svc
```

### 第四步（命令）

```bash showLineNumbers
set ASPNETCORE_ENVIRONMENT=Production
```

## 部署到 IIS

### 添加新网站

<img src={require("@site/static/img/furion/ds1.png").default} />

### 配置网站信息

<img src={require("@site/static/img/furion/ds2.png").default} />

### 34.1.3.3 配置应用程序池

<img src={require("@site/static/img/furion/ds3.png").default} />

### 34.1.3.4 设置为 `非托管`

<img src={require("@site/static/img/furion/ds4.png").default} />

### 34.1.3.5 重启网站

只需重启网站或应用程序池即可。

## 34.1.4 常见问题

### 34.1.4.1 405 状态码，不支持 `PUT，DELETE` 请求

默认情况下，`IIS`拒绝 `PUT`和 `DELETE` 请求，原因为 `IIS` 默认注册了一个名为 `WebDAVModule` 的自定义 `HttpModule` 导致的。

解决该问题，只需要在 `web.config` 移除即可：

```xml {2-6}
<configuration>
 <system.webServer>
   <modules runAllManagedModulesForAllRequests="true">
     <remove name="webDAVModule"/>
   </modules>
 </system.webServer>
</configuration>
```

微软官方文档：[https://docs.microsoft.com/zh-cn/troubleshoot/developer/webapps/iis/health-diagnostic-performance/http-error-405-website](https://docs.microsoft.com/zh-cn/troubleshoot/developer/webapps/iis/health-diagnostic-performance/http-error-405-website)

<img src={require("@site/static/img/furion/iis5.png").default} />

### 34.1.4.2 `WebSocket`/ `SignalR` 连接报错

如果项目部署在 `IIS` 中出现 `WebSoket`/`SignalR` 不能连接或连接失败等问题，请确保 `IIS` 服务中的 `WebSocket 协议` 是勾选状态

<img src={require("@site/static/img/furion/iis2.png").default} />

### 34.1.4.3 部署之后缺失 `api-ms-win.xxxx.dll` 问题

有时候将发布文件发布到服务器后，出现丢失 `api.ms-win.xxxx.dll` 文件，这时只需要重新发布并选择服务器特定的架构即可。

<img src={require("@site/static/img/furion/iis4.jpg").default} />

<img src={require("@site/static/img/furion/iis3.png").default} />

## 34.1.5 `IIS` 回收问题和配置

通过 `IIS` 部署 `.NET Core` 应用程序，如果启动了系统日志，就会发现经常出现 `Application is shutting down...` 的日志，代表 `IIS` 回收了应用程序池。

对于一个长期在线的网站来说，这是非常不合理的，所以我们可以通过以下配置让 `IIS` 进行长时间不访问便回收的机制。

---

配置步骤如下：

1. 打开 `IIS` 并点击左侧树根节点（计算机名称）并点击右侧的 `Configuration Editor`（配置编辑器）

<img src={require("@site/static/img/furion/iis6.png").default} />

2. 在 `Section`（节）选择 `system.applicationHost/applicationPools` 并设置 `startMode` 为 `AlwaysRunning`，之后点击 `Apply` 保存。

<img src={require("@site/static/img/furion/iis7.png").default} />

3. 点击左侧树根节点（计算机名称）下的 `Application Pools` 并点击最右侧的 `Set Appliation Pool Defaults...`（设置应用程序池默认配置...）

<img src={require("@site/static/img/furion/iis8.png").default} />

4. 设置 `Idle Time-out (minutes)`（闲置超时（分钟）为 `0`

<img src={require("@site/static/img/furion/iis9.png").default} />

这样即可解决 `IIS` 回收问题。

## 34.1.6 卷影（无占用）复制发布替换

正常情况下如果我们代码重新发布后替换 `IIS` 中的文件，这时候会出现文件占用无法进行替换，过去运维人员都是先停止站点后替换再启动。但我们也可以配置 `web.config` 文件启用卷影复制模式实现类似**热更新**操作，如：

```xml showLineNumbers {12-18}
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <!-- To customize the asp.net core module uncomment and edit the following section.
  For more info see https://go.microsoft.com/fwlink/?linkid=838655 -->

  <system.webServer>
    <handlers>
      <remove name="aspNetCore"/>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModulev2" resourceType="Unspecified"/>
    </handlers>
    <aspNetCore processPath="%LAUNCHER_PATH%" arguments="%LAUNCHER_ARGS%" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout">
      <handlerSettings>
        <handlerSetting name="experimentalEnableShadowCopy" value="true" />
        <handlerSetting name="shadowCopyDirectory" value="../ShadowCopyDirectory/" />
        <!-- Only enable handler logging if you encounter issues-->
        <!--<handlerSetting name="debugFile" value=".\logs\aspnetcore-debug.log" />-->
        <!--<handlerSetting name="debugLevel" value="FILE,TRACE" />-->
      </handlerSettings>
    </aspNetCore>
  </system.webServer>
</configuration>
```

关于卷影复制更多知识可查看以下文档：

- [https://devblogs.microsoft.com/dotnet/asp-net-core-updates-in-net-6-preview-3/#shadow-copying-in-iis](https://devblogs.microsoft.com/dotnet/asp-net-core-updates-in-net-6-preview-3/#shadow-copying-in-iis)
- [https://learn.microsoft.com/zh-cn/dotnet/framework/app-domains/shadow-copy-assemblies](https://learn.microsoft.com/zh-cn/dotnet/framework/app-domains/shadow-copy-assemblies)