如何调整Kestrel的端口

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

---

1. 通过 appsettings.json 配置文件

这是最推荐的方式，支持不同环境（Development/Production）的差异化配置。

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

修改示例（将 HTTP 改为 8080，HTTPS 改为 8443）：

{
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://localhost:8080"
      },
      "Https": {
        "Url": "https://localhost:8443"
      }
    }
  }
}

---

2. 通过代码直接配置（Program.cs）

在 WebApplicationBuilder 构建阶段直接指定端口：

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. 使用命令行参数

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

dotnet run --urls "http://localhost:8080;https://localhost:8443"

---

4. 环境变量配置

通过操作系统环境变量配置（适合容器化部署）：

# Linux/macOS
export ASPNETCORE_URLS="http://localhost:8080;https://localhost:8443"

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

---

5. 多端口监听配置

允许同时监听多个端口：

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

---

6. 动态端口绑定（随机端口）

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

builder.WebHost.UseUrls("http://*:0"); // 随机HTTP端口

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

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

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

---

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

在 appsettings.Development.json 和 appsettings.Production.json 中分别定义：

开发环境（appsettings.Development.json）：

{
  "Kestrel": {
    "Endpoints": {
      "Http": { "Url": "http://localhost:5000" }
    }
  }
}

生产环境（appsettings.Production.json）：

{
  "Kestrel": {
    "Endpoints": {
      "Http": { "Url": "http://*:80" },
      "Https": { "Url": "https://*:443" }
    }
  }
}

---

验证配置是否生效

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

Now listening on: http://localhost:8080
Now listening on: https://localhost:8443

---

总结

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

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