BotFramework部署至IIS遇阻，寻求非Azure/隧道部署方案

前提准备 #

• 确保你的IIS服务器已安装ASP.NET Core托管捆绑包（针对.NET Core/.NET 5+ Bot），或IISNode模块（针对Node.js Bot），这是IIS托管Bot的核心依赖。
• 服务器需具备公网可访问的IP地址，且计划使用的端口（如443/80）已在防火墙及网络安全组中开放。

正确部署步骤 #

.NET Core/.NET Bot #

1. 生成部署包
   在项目根目录执行命令：

   dotnet publish -c Release --self-contained false
   

   （--self-contained false表示依赖服务器上的.NET运行时，若服务器未装对应版本，可改为true打包运行时）
   发布产物默认在bin/Release/{.NET版本}/publish目录下。

2. IIS网站配置

   • 新建网站，物理路径指向上述publish文件夹。
   • 设置绑定：选择对应的IP、端口，若需HTTPS需配置SSL证书。
   • 配置应用程序池：
     • .NET版本选择无托管代码（因为.NET Core应用自主托管Kestrel，IIS做反向代理）。
     • 应用程序池身份设置为LocalSystem或具备部署文件夹读写权限的账户。

3. Bot参数配置
   修改publish文件夹下的appsettings.json，确保MicrosoftAppId和MicrosoftAppPassword与Bot Framework Portal中注册的Bot信息完全一致（无需Azure资源，仅需在Portal完成Bot基础注册）。

Node.js Bot #

1. 准备部署文件
   打包项目所有文件（含package.json、index.js等），确保已执行npm install生成node_modules（或在服务器上执行该命令）。

2. IIS配置

   • 新建网站，物理路径指向项目文件夹。
   • 安装IISNode后，添加web.config文件，示例配置：

     <configuration>
       <system.webServer>
         <handlers>
           <add name="iisnode" path="index.js" verb="*" modules="iisnode" />
         </handlers>
         <rewrite>
           <rules>
             <rule name="BotFramework">
               <match url="api/messages" />
               <action type="Rewrite" url="index.js" />
             </rule>
           </rules>
         </rewrite>
         <iisnode nodeProcessCommandLine="C:\Program Files\nodejs\node.exe" />
       </system.webServer>
     </configuration>
     

   • 应用程序池设置为No Managed Code，确保身份有文件夹读写权限。

常见失败排查（针对复制文件部署无效的情况） #

• 依赖缺失：直接复制开发环境文件未包含发布所需的依赖项，必须用dotnet publish或完成npm install生成完整部署包。
• 权限不足：应用程序池身份无部署文件夹的读写权限，导致Bot无法写入日志或加载配置，可尝试临时将身份设为LocalSystem测试。
• 端点不可达：用curl -X POST http://{你的服务器IP}:{端口}/api/messages测试，若返回405 Method Not Allowed说明端点正常（Bot仅接受POST请求），若返回500/无法连接，检查防火墙、端口占用及IIS站点状态。
• 日志分析：查看IIS事件查看器的「应用程序」日志，或.NET Bot的stdout日志（默认在部署文件夹的logs目录），定位具体错误信息。
• Bot配置错误：MicrosoftAppId/MicrosoftAppPassword不匹配，会导致Bot无法验证请求，需严格与Portal注册信息一致。

内容的提问来源于stack exchange，提问作者Dana Nafez