Do you kown Asp.Net Core -- 配置Kestrel端口

简介: Kestrel介绍在Asp.Net Core中,我们的web application 其实是运行在Kestrel服务上,它是一个基于libuv开源的跨平台可运行 Asp.Net Core 的web服务器。

Kestrel介绍

Asp.Net Core中,我们的web application 其实是运行在Kestrel服务上,它是一个基于libuv开源的跨平台可运行 Asp.Net Core 的web服务器。

在开发阶段,我们可以直接使用Kestrel服务器用来测试,也可以使用IISExpress。在使用IISExpress其实也需要启动一个Kestrel服务器,通过IISExpress反向代理请求到Kestrel,很多时候我更喜欢使用Kestrel,因为可以实时看到log。

配置端口

在Socket开发中,服务器都会绑定到某个ip某个端口进行监听,等待客户端的连接,然后交换数据,Kestrel同样需要对某个端口进行监听,客户端会请求这个端口然后建立连接进行数据交换。我们说的配置url或者配置端口,其实本质上都是建立对某个端口的监听。

配置规则

我们知道在Kestrel通过绑定Urls参数实现绑定ip和端口,.Net Core允许我们使用多种方式来实现绑定url,我们先了解下绑定的规则:

[http|https]://[ip|localhost|hostname]:port

  1. localhost 或127.0.0.1 代表本机ip,仅允许本机访问
  2. 局域网ip,允许局域网内客户端访问
  3. 端口0代表随机绑定可用端口
  4. '*' 代表0.0.0.0,允许本机、局域网、公网访问

'*'不是特殊字符,任何不能识别成ip的字符都将会绑定到0.0.0.0,so,你看到的hostname:ip 其实并没有真正的绑定到hostname,Kestrel不会识别hostname,所以不允许像iis那样,多个application通过hostname绑定到同一个ip的同一个端口上,所以你需要通过反向代理服务器来实现

通过上述的绑定字符串,Kestrel会解析成相应的ip和端口,然后进行绑定监听。

配置方式

.Net Core提供了多种对Kestrel端口的配置方式,我们可以通过编码、配置文件、命令行参数进行配置,非常便利,接下来我们来看下各种配置方式。

无论那种方式,我们都必须在Kestrel启动之前进行,一般情况我们都在Program.cs中进行。

编码方式

编码方式有2种方式:
1、通过UseKestrel(Action):

var host = WebHost.CreateDefaultBuilder(args)
    .UseStartup<Startup>()
    .UseKestrel(o =>
    {
        o.Listen(IPAddress.Loopback, 5001);
    })
    .Build();

host.Run();

o.Listen(IPAddress.Loopback, 5004) 就是进行绑定,其中第一个参数是IPAddress类型。这种方式不是很便利,阅读性也不好,推荐使用第二种
2、通过UseUrls方式:

var host = WebHost.CreateDefaultBuilder(args)
    .UseStartup<Startup>()
    .UseUrls("http://localhost:5002;http://localhost:5003")
    .Build();

host.Run();

这种方式相对简单,而且不容易出错,但灵活性不强。

通过配置文件

我们可以通过Json文件对Kestrel进行配置,包括我们的url。
1、首先我们需要创建一个json文件,这里以host.json为例:

{
  "urls": "http://*:5004;"
}

2、我们需要在build host的时候告诉Kestrel读取config文件,代码如下:

public static void Main(string[] args)
{
    var config = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("host.json", optional: true)
    .Build();

    var host = WebHost.CreateDefaultBuilder(args)
        .UseStartup<Startup>()
        .UseConfiguration(config)
        .Build();

    host.Run();
}

这种方式相比编码来说较便利,但如果在web运行在容器内的话,修改还是有点麻烦,下面来看下命令行格式。

命令行方式

我们知道.net core我们可以使用dotnet 命令方式去运行 .net core 应用,这种方式使我们的web不再依赖于iis,实现了跨平台。
我们先了解下命令:

> dotnet run [options] [[--] arguments]

dotnet run 命令会把我们的项目编译后直接运行,在开发的时候使用,如果是编译好的项目,则使用:

> dotnet yourproject.dll [[--] arguments]

如果我们需要配置Urls的话,则只要使用参数--urls="http://*:5005",例如:

> dotnet run --urls="http://*:5005"

如果这时候你如此运行,你会发现你的项目并未监听5005端口,因为你还没有对Kestrel进行配置,告诉其读取命令行参数,我们需要在Build host的时候进行如下配置:

public static void Main(string[] args)
{
    var config = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddCommandLine(args)   //添加对命令参数的支持
    .Build();

    var host = WebHost.CreateDefaultBuilder(args)
        .UseStartup<Startup>()
        .Build();

    host.Run();
}

ok,这时候再运行dotnet run命令吧!

关于url配置的问题

Q:url配置支持多域名吗?
A:上面说过,kestrel是不支持主机名解析的,你进行的配置都会绑定到0.0.0.0

Q:url配置支持多个ip吗?
A:支持,但必须是本机所属ip,否则运行则出错

Q:多个Kestrel能监听一个端口吗?
A:不能

Q:我能通过多种方式进行url配置吗?
A:可以,但最终生效的只有一种,也就是最后配置的方式,没有优先级

Q:Kestrel支持https吗?
A:支持

Q:为什么其他教程中是使用servers.urls呢?
A:我看了下,可能是扩展类的不同吧,目前来说已经改成urls了,而且不需要再额外引用其他类库了

代更。。。。。。

写在最后

最近在看微服务和asp.net core的东西,也希望把一些小知识分享给大家。
最后推荐我的.Net Core QQ学习群:376248054(通关密码:cnblogs),最近群里不是很活跃,大家进来多发言发言哈~

相关文章
|
2月前
|
开发框架 .NET 开发者
简化 ASP.NET Core 依赖注入(DI)注册-Scrutor
Scrutor 是一个简化 ASP.NET Core 应用程序中依赖注入(DI)注册过程的开源库,支持自动扫描和注册服务。通过简单的配置,开发者可以轻松地从指定程序集中筛选、注册服务,并设置其生命周期,同时支持服务装饰等高级功能。适用于大型项目,提高代码的可维护性和简洁性。仓库地址:&lt;https://github.com/khellang/Scrutor&gt;
57 5
|
2月前
|
开发框架 算法 中间件
ASP.NET Core 中的速率限制中间件
在ASP.NET Core中,速率限制中间件用于控制客户端请求速率,防止服务器过载并提高安全性。通过`AddRateLimiter`注册服务,并配置不同策略如固定窗口、滑动窗口、令牌桶和并发限制。这些策略可在全局、控制器或动作级别应用,支持自定义响应处理。使用中间件`UseRateLimiter`启用限流功能,并可通过属性禁用特定控制器或动作的限流。这有助于有效保护API免受滥用和过载。 欢迎关注我的公众号:Net分享 (239字符)
60 1
|
3月前
|
开发框架 .NET C#
在 ASP.NET Core 中创建 gRPC 客户端和服务器
本文介绍了如何使用 gRPC 框架搭建一个简单的“Hello World”示例。首先创建了一个名为 GrpcDemo 的解决方案,其中包含一个 gRPC 服务端项目 GrpcServer 和一个客户端项目 GrpcClient。服务端通过定义 `greeter.proto` 文件中的服务和消息类型,实现了一个简单的问候服务 `GreeterService`。客户端则通过 gRPC 客户端库连接到服务端并调用其 `SayHello` 方法,展示了 gRPC 在 C# 中的基本使用方法。
61 5
在 ASP.NET Core 中创建 gRPC 客户端和服务器
|
2月前
|
开发框架 缓存 .NET
GraphQL 与 ASP.NET Core 集成:从入门到精通
本文详细介绍了如何在ASP.NET Core中集成GraphQL,包括安装必要的NuGet包、创建GraphQL Schema、配置GraphQL服务等步骤。同时,文章还探讨了常见问题及其解决方法,如处理复杂查询、错误处理、性能优化和实现认证授权等,旨在帮助开发者构建灵活且高效的API。
54 3
|
7月前
|
弹性计算 应用服务中间件 Linux
阿里云服务器开放端口完整图文教程
笔者近期开发完成的服务端程序部署在阿里云的ECS云服务器上面,一些应用程序配置文件需要设置监听的端口(如Tomcat的8080、443端口等),虽然通过CentOs 7系统的的「防火墙」开放了对应的端口号,任然无法访问端口号对应的应用程序,后面了解到原来还需要设置云服务器的「安全组规则」,开放相应的端口权限,服务端的接口才能真正开放。
824 1
|
7月前
|
弹性计算 运维 数据安全/隐私保护
云服务器 ECS产品使用问题之如何更改服务器的IP地址或端口号
云服务器ECS(Elastic Compute Service)是各大云服务商阿里云提供的一种基础云计算服务,它允许用户租用云端计算资源来部署和运行各种应用程序。以下是一个关于如何使用ECS产品的综合指南。
|
7月前
|
网络协议 Linux Unix
面试官:服务器最大可以创建多少个tcp连接以及端口并解释下你对文件句柄的理解
面试官:服务器最大可以创建多少个tcp连接以及端口并解释下你对文件句柄的理解
171 0
面试官:服务器最大可以创建多少个tcp连接以及端口并解释下你对文件句柄的理解
|
6月前
|
缓存 NoSQL 网络安全
【Azure Redis 缓存】使用开源工具redis-copy时遇见6379端口无法连接到Redis服务器的问题
【Azure Redis 缓存】使用开源工具redis-copy时遇见6379端口无法连接到Redis服务器的问题
|
6月前
|
网络协议
【qt】TCP的监听 (设置服务器IP地址和端口号)
【qt】TCP的监听 (设置服务器IP地址和端口号)
336 0
|
7月前
|
存储 安全 网络安全
服务器设置了端口映射之后外网还是访问不了服务器
服务器设置了端口映射之后外网还是访问不了服务器