如何调整Kestrel的端口

ASP.NET Core 中调整 Kestrel 服务器的端口可以通过多种方式实现。以下是详细的配置方法:


1. 通过 appsettings.json 配置文件

这是最推荐的方式,支持不同环境(Development/Production)的差异化配置。

json 复制代码
{
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://localhost:5000"  // 默认HTTP端口
      },
      "Https": {
        "Url": "https://localhost:5001" // 默认HTTPS端口
      }
    }
  }
}

修改示例(将 HTTP 改为 8080,HTTPS 改为 8443):

json 复制代码
{
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://localhost:8080"
      },
      "Https": {
        "Url": "https://localhost:8443"
      }
    }
  }
}

2. 通过代码直接配置(Program.cs)

WebApplicationBuilder 构建阶段直接指定端口:

csharp 复制代码
var builder = WebApplication.CreateBuilder(args);

// 配置Kestrel端口
builder.WebHost.ConfigureKestrel(serverOptions =>
{
    serverOptions.ListenAnyIP(8080);    // 监听所有IP的8080端口(HTTP)
    serverOptions.ListenAnyIP(8443, listenOptions => 
    {
        listenOptions.UseHttps("certificate.pfx", "password"); // HTTPS配置
    });
});

var app = builder.Build();
app.Run();

3. 使用命令行参数

启动应用时通过命令行参数指定:

bash 复制代码
dotnet run --urls "http://localhost:8080;https://localhost:8443"

4. 环境变量配置

通过操作系统环境变量配置(适合容器化部署):

bash 复制代码
# Linux/macOS
export ASPNETCORE_URLS="http://localhost:8080;https://localhost:8443"

# Windows
set ASPNETCORE_URLS=http://localhost:8080;https://localhost:8443

5. 多端口监听配置

允许同时监听多个端口:

csharp 复制代码
builder.WebHost.ConfigureKestrel(serverOptions =>
{
    serverOptions.ListenAnyIP(8080);    // HTTP
    serverOptions.ListenAnyIP(8081);    // 第二个HTTP端口
    serverOptions.ListenAnyIP(8443, opts => opts.UseHttps()); // HTTPS
});

6. 动态端口绑定(随机端口)

让系统自动分配可用端口:

csharp 复制代码
builder.WebHost.UseUrls("http://*:0"); // 随机HTTP端口

通过代码获取实际分配的端口:

csharp 复制代码
var app = builder.Build();
app.Run();

// 获取实际端口(需在Run之后获取)
var port = app.Services.GetService<IServer>()
    .Features.Get<IServerAddressesFeature>()
    .Addresses.First().Split(':').Last();

7. 不同环境的差异化配置

appsettings.Development.jsonappsettings.Production.json 中分别定义:

开发环境(appsettings.Development.json)

json 复制代码
{
  "Kestrel": {
    "Endpoints": {
      "Http": { "Url": "http://localhost:5000" }
    }
  }
}

生产环境(appsettings.Production.json)

json 复制代码
{
  "Kestrel": {
    "Endpoints": {
      "Http": { "Url": "http://*:80" },
      "Https": { "Url": "https://*:443" }
    }
  }
}

验证配置是否生效

启动应用时观察控制台输出:

csharp 复制代码
Now listening on: http://localhost:8080
Now listening on: https://localhost:8443

总结

场景 推荐方式
开发环境快速修改 命令行参数或 launchSettings.json
生产环境固定端口 appsettings.json + 代码配置
容器化部署 环境变量配置
需要动态端口 代码绑定端口 0 + 获取实际端口

选择最适合你场景的方式,通常推荐使用 appsettings.json 进行集中化管理。

相关推荐
paopaokaka_luck3 小时前
基于Spring Boot+Vue的吉他社团系统设计和实现(协同过滤算法)
java·vue.js·spring boot·后端·spring
Flobby5293 小时前
Go语言新手村:轻松理解变量、常量和枚举用法
开发语言·后端·golang
Warren984 小时前
Java Stream流的使用
java·开发语言·windows·spring boot·后端·python·硬件工程
程序视点5 小时前
IObit Uninstaller Pro专业卸载,免激活版本,卸载清理注册表,彻底告别软件残留
前端·windows·后端
xidianhuihui5 小时前
go install报错: should be v0 or v1, not v2问题解决
开发语言·后端·golang
进击的铁甲小宝7 小时前
Django-environ 入门教程
后端·python·django·django-environ
掘金码甲哥7 小时前
Go动态感知资源变更的技术实践,你指定用过!
后端
王柏龙8 小时前
ASP.NET Core MVC中taghelper的ModelExpression详解
后端·asp.net·mvc
无限大68 小时前
算法精讲:二分查找(二)—— 变形技巧
后端
勇哥java实战分享8 小时前
基于 RuoYi-Vue-Pro 定制了一个后台管理系统 , 开源出来!
后端