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

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),最近群里不是很活跃,大家进来多发言发言哈~

时间: 2024-08-29 01:21:54

Do you kown Asp.Net Core -- 配置Kestrel端口的相关文章

[转帖]ASP.NET Core的Kestrel服务器

ASP.NET Core的Kestrel服务器 https://cloud.tencent.com/developer/article/1023247 在这篇文章中: 何时使用Kestrel和反向代理服务器 如何在ASP.NET Core应用中使用Kestrel URL 前缀 SSL的URL前缀 下一步 原文地址----Kestrel server for ASP.NET Core By Tom Dykstra, Chris Ross, and Stephen Halter Kestrel是一个

ASP.NET Core 配置 EF 框架服务 - ASP.NET Core 基础教程 - 简单教程,简单编程

原文:ASP.NET Core 配置 EF 框架服务 - ASP.NET Core 基础教程 - 简单教程,简单编程 ASP.NET Core 配置 EF 框架服务 上一章节中我们了解了 Entity Framework 的基本工作原理和 DbContext ,我们也创建了一个自己的 HelloWorldDBContext. 本章节我们就来讲讲如何设置我们的 EF 框架来链接到 SQLite 数据库 配置 EF 框架服务 要让我们的 EF 框架的 DBContext 能够运行起来,我们需要更改一

ASP.NET Core 配置 Entity Framework Core - ASP.NET Core 基础教程 - 简单教程,简单编程

原文:ASP.NET Core 配置 Entity Framework Core - ASP.NET Core 基础教程 - 简单教程,简单编程 ASP.NET Core 配置 Entity Framework Core 上一章节学习完了视图,其实我们应该立即着手讲解模型的,但 ASP.NET Core MVC 中的模型和 Entity Framework 有相当大的关系,所以,在此之前,我们先来讲讲 Entity Framework Core 和如何配置它 本章中,我们将设置和配置我们的应用程

ASP.NET Core 配置 EF SQLite 支持 - ASP.NET Core 基础教程 - 简单教程,简单编程

原文:ASP.NET Core 配置 EF SQLite 支持 - ASP.NET Core 基础教程 - 简单教程,简单编程 ASP.NET Core 配置 EF SQLite 支持 上一章节我有提到 macOS 版的 Visual Studio Community 没有携带 LocalDB,也就是说 LocalDB 暂时不支持 macOS 系统 虽然我可以在 Windows 上继续完成接下来的教程,但我觉得还是感觉不妥,如果其它使用苹果笔记本的人要去哪里找 Windows 的电脑 我临时改变

ASP.NET Core 配置 MVC - ASP.NET Core 基础教程 - 简单教程,简单编程

原文:ASP.NET Core 配置 MVC - ASP.NET Core 基础教程 - 简单教程,简单编程 ASP.NET Core 配置 MVC 前面几章节中,我们都是基于 ASP.NET 空项目 模板创建的 HelloWorld 上做开发 通过这个最基本的 HelloWorld 项目,我们了解了很多知识,初窥了 ASP.NET Core,并对 ASP.NET Core 的运行机制有了一个基本的了解 MVC 模式是 Web 开发中最重要的一个模式之一,通过 MVC,我们可以将控制器.模型和视

asp.net core 配置

ASP.NET Core的配置系统已经和之前版本的ASP.NET有所不同了,之前是依赖于System.Configuration和XML配置文件web.config,现在支持各种格式的配置,比以前灵活多了. 支持一下几种: MemoryConfigurationProvider EnvironmentVariablesConfigurationProvider CommandLineConfigurationProvider JsonConfigurationProvider XmlConfig

在ASP.NET Core配置环境变量和启动设置

ASPNETCORE_ENVIRONMENT ASP.NET Core控制环境切换最核心的东西是"ASPNETCORE_ENVIRONMENT"环境变量,它直接控制当前应用程序运行的环境类型.您可以通过在项目上右键菜单选择"属性"选项,然后切换到"调试"标签来修改此环境变量. 此环境变量框架默认提供了三个值,当然您也可以定义其它的值: Development(开发) Staging(预演) Production(生产) 我们在Startup.cs

ASP.NET Core 配置和使用环境变量

前言 通常在应用程序开发到正式上线,在这个过程中我们会分为多个阶段,通常会有 开发.测试.以及正式环境等.每个环境的参数配置我们会使用不同的参数,因此呢,在ASP.NET Core中就提供了相关的环境API,方便我们更好的去做这些事情. 环境 ASP.NET Core使用ASPNETCORE_ENVIRONMENT来标识运行时环境. ASP.NET Core预设环境 Development:开发环境 Staging:暂存环境(测试环境) Production:正式环境 要取得系统变量ASPNET

asp.net Core 配置默认

app.UseFileServer(new FileServerOptions() { FileProvider = new PhysicalFileProvider(env.ContentRootPath), RequestPath = new PathString(""), EnableDefaultFiles = true,//启用默认文件 EnableDirectoryBrowsing = false//关闭目录浏览 }); app.UseMvc(routes => {