aps.net core 6.0 web API & SwaggerUI & IIS部署

目录

• 一、aps.net core 6.0 web API 项目配置
• • 创建项目
  • 设置 Swagger UI 为起始页
  • 发布项目
  • 二、在 IIS 部署
  • • 安装IIS
    • 安装 Hosting Bundle
    • 三、内网穿透

      本文章的流程概述如下：

      
      （图片来源网络，侵删）

      1、将 asp.net core web API 部署到 IIS

      2、将 Swagger UI 设为起始页

      3、设置内网穿透，允许其他内网用户访问 web API

      我使用的是 VS2022社区版，WebAPI的版本是 .netcore6.0，其他版本可能略有不同，请根据情况适当更改。

      ---

      一、aps.net core 6.0 web API 项目配置

      创建项目

      创建webapi项目

      

      
      （图片来源网络，侵删）

      默认选项即可

      

      运行项目会默认打开 Swagger UI 界面

      

      ---

      设置 Swagger UI 为起始页

      打开 launchSettings.json 文件

      屏蔽以下两行代码

      
      （图片来源网络，侵删）

      

      打开 Program.cs 文件

      屏蔽原来的环境判断，新增以下代码

      

      app.UseSwagger();
      app.UseSwaggerUI(c =>
        {
            c.RoutePrefix = "";
            c.SwaggerEndpoint("/swagger/v1/swagger.json", "ApiHelp V1"); //第二个参数可自定义命名
        });
      

      解释一下，这么做的目的是防止别名出现找不到 swagger.json 的错误

      
      

      再次运行调试，会发现以下变化

      

      发布项目

      发布项目：右击项目 → 发布

      

      选择文件夹

      

      选择文件夹位置，这个位置就是 项目发布后的文件 所在的位置

      

      检查 目标位置 的文件夹是否存在，不然会报错

      点击 更多操作→编辑 可根据自己的项目进行设置

      

      

      设置好后，点击 发布

      当输出显示成功即发布成功；若失败会显示具体信息供排查

      

      ---

      二、在 IIS 部署

      安装IIS

      
      这里就不再阐述了，引用这位博主的文章

      如何安装IIS

      安装 Hosting Bundle

      点击 https://dotnet.microsoft.com/zh-cn/download

      下载安装 Hosting Bundle

      我这里安装的是 Hosting Bundle 6.0，可根据情况适当更改

      

      安装成功后，打开 IIS →模块 后会在列表看到 AspNetCoreModuleV2

      

      

      右键 应用程序池 添加应用程序池

      选择 无托管代码

      

      

      右键 网站 添加网站

      

      点击浏览，则会跳转到 Swagger UI 界面

      

      

      三、内网穿透

      打开 控制面板 → 防火墙

      

      高级设置

      

      入站规则 → 新建规则

      

      端口 → 特定本地端口

      然后一直按 下一步，最后填写 名称 即可完成

      

      

      

      现在，内网的其他小伙伴也可以访问你的 web API 了

      其他用户访问的url需加入你的 ipv4 地址

      例：你的 ipv4 为 192.100.99.1

      本地访问：http://localhost:4040/index.html

      内网访问： http://192.100.99.1:4040/index.html

      ---

      作者在完成这块需求的时候花费了很多时间，在网上查找了很多资料，但大多都是零散不全或跑不通的，踩过很多坑，现在把整个流程记录下来希望能帮助到更多有需要的人。原创不易，希望能得到你的 点赞 和 收藏~