详解ASP.NET Core中配置监听URLs的五种方式
默认情况下,asp. net core应用会监听一下2个url:
- http://localhost:5000
- https://localhost:5001
在本篇博文中,我将展示如何使用五种不同的方式改变应用监听的urls。
在asp.net core项目启动时,有多种配置监听url的方式,在我之前的一篇博客中,已经展示了在asp.net core 1.0中如何应用不同的方式配置,在asp.net core 3.x中,大部分方式还是一样的。
- useurls() - 在program.cs配置程序监听的urls
- 环境变量 - 使用dotnet_urls或者aspnetcore_urls配置urls
- 命令行参数 - 当使用命令行启动应用时,使用--urls参数指定urls
- 使用launchsettings.json - 使用applicationurl属性来配置urls
- kestrelserveroptions.listen() - 使用listen()方法手动配置kestral服务器监听的地址
下面我来详细说明一下每个一种方式。
哪些url可以使用?
在本篇我描述是你可以绑定的"urls", 但是你不能使用所有的urls. 这里有三种你可以绑定的urls
ipv4和ipv6的主机名(例如http://localhost:5000
). 这种url的格式是{scheme}://{loopbackaddress}:{port}
在你机器上可用的指定ip地址(例如), 这种url的格式是
{scheme}://{ipaddress}:{port}
针对给定端口,使用"任何"ip地址(例如http://*:6264
), 这种url的格式是{scheme}://*:{port}
在以上说明的几种格式中,端口号也可以是选填的, 如果你忽略它,系统会使用默认端口(http使用80端口,https使用443端口)。
使用哪一种格式的urls取决于你的部署方式。例如,如果你你将多个应用托管在同一台“裸机”中,你可能需要显示指定ip地址。但是如果你使用了容器托管,那么你可以使用localhost
作为地址。
注意,针对"任何"ip地址的格式 - 你不一定必须使用*
,你可以使用任何字符,只要不是ip地址或者localhost
, 这意味着你可以使用http://*
, http://+
, http://mydomain
, http://example.org
. 以上所有字符串都具有相同的行为,可以监听任何ip地址。如果你想仅处理来自单一主机名的请求,你需要额外配置主机过滤。
现在你已经了解了你需要监听的urls类型,接下来你就需要告诉你的应用如何使用它们。我这里我将展示五种可能使用到方式。
useurls()
首先,最简单的方式,当配置iwebhostbuilder
时,你可以使用useurls()
方法硬编码绑定的urls。
public class program { public static void main(string[] args) { createhostbuilder(args).build().run(); } public static ihostbuilder createhostbuilder(string[] args) => host.createdefaultbuilder(args) .configurewebhostdefaults(webbuilder => { webbuilder.usestartup<startup>(); webbuilder.useurls("http://localhost:5003", "https://localhost:5004"); }); }
硬编码一个urls从来都不是一个干净可扩展解决方案的选择,所以这种方式通常只会用来做demo.
幸运的是,你也可以从外部配置文件、环境变量或者命令行参数中加载urls配置。
环境变量
.net core中允许使用两种配置方式
- 应用程序级配置是你通常在应用程序中使用的配置,它是用
appsettings.json
配置文件和环境变量中加载的。 - 主机配置用于配置应用程序的基础配置,例如主机环境和主机urls
当我们在考虑如何配置应用urls时,主机配置是让我们感兴趣的一种。默认主机配置的值来自三个不同的地方。
- 以
dotnet_
开头的环境变量。 - 命令行参数
- 以
aspnetcore_
开头的环境变量。这种方式仅限asp.net core应用,基于通用主机的worker service是不适用的。
如果你没有手动复写过useurls()
方法,asp.net core会使用系统配置的中urls
键的值。基于描述,你可以使用一下两种方式配置urls
dotnet_urls
aspnetcore_urls
如果你同时使用2种环境变量,系统会优先使用aspnetcore_urls
中定义的参数
你可以根据你的开发环境使用一些通用方式配置环境变量。例如,使用命令行
setx aspnetcore_urls http://localhost:5001
使用powershell
$env: aspnetcore_urls = http://localhost:5001
或者使用bash命令
export aspnetcore_urls=http://localhost:5001;https://localhost:5002
从以上例子中不难发现,如果想要配置多个地址,只需要用分号间隔即可。
命令行参数
另外一种设置主机配置的方式是使用命令行参数。如果同时配置了环境变量和命令行参数,命令行参数的值会覆盖环境变量配置的值。这里我们可以使用--urls
参数来配置urls
dotnet run --urls http://localhost:5100
和之前的例子一样,这里你可以使用分号间隔配置多个urls
dotnet run --urls http://localhost:5100;https://localhost:5101
在生产环境中,配置urls的最常用方式是使用环境变量或者命令行参数,但是在本地开发环境中,可能就有点笨重了,这时候使用launchsetting.json
来配置urls可能更简单一点。
launchsettings.json
大部分.net core项目模板中都包含了一个名为launchsetting.json
的文件, 这个文件通常放在properties
文件夹中。这个文件中包含了启动asp.net core项目的各种配置。一个典型的launchsetting.json
文件中包含了两部分定义,一部分是命令行启动项目时的配置,一部分是使用iis express启动项目时的配置。具体使用哪一部分是由visual studio中的"debug"下拉列表控制的:
在launchsettings.json
文件中,我们使用applicationurl
属性就可以配置应用绑定的urls - 在如下的例子中,你可以看到在iissettings
节点下有一个配置,在testapp
节点下有一个配置。
{ "iissettings": { "windowsauthentication": false, "anonymousauthentication": true, "iisexpress": { "applicationurl": "http://localhost:38327", "sslport": 44310 } }, "profiles": { "iis express": { "commandname": "iisexpress", "launchbrowser": true, "environmentvariables": { "aspnetcore_environment": "development" } }, "testapp": { "commandname": "project", "launchbrowser": true, "applicationurl": "https://localhost:5001;http://localhost:5000", "environmentvariables": { "aspnetcore_environment": "development" } } } }
你不需要特别指定使用这个文件 - dotnet run
命令会自动加载它。
launchsettings.json
文件中也提供了额外的环境变量配置参数environmentvariables
,在上面的例子中你就可以发现它们。
当你从命令行使用dotnet run
命令启动你的应用时,你的应用会从"project"命令下的applicationurl
参数中加载配置https://localhost:5001;http://localhost:5000
,当你使用iisexpress
命令启动项目的时候,你的应用会从iissettings.iisexpress
节点的applicationurl
参数中加载配置http://localhost:38327
当你做本地开发的时候,这个文件是配置环境最简单的方式。事实上,如果你不想使用launchsettings.json
文件,你需要特别配置。
dotnet run --no-launch-profile
以上命令会跳过launchsettings.json
文件的加载,并使用主机环境变量配置来决定绑定的urls。
到目前为止,所有的实现方案都是间接为kestrel
服务器配置urls, 但是实际上你还可以直接配置。
kestrelserveroptions.listen()
几乎所有的asp.net core应用默认都会使用kestrel
服务器。如果你想的话,你可以手动配置kestrel
服务器节点,或者使用iconfiguration
配置kestrelserveroptions
。
我从来没有这样做过,这里有非常多的配置项,因此在大多数情况下,我建议参考文档。例如,你可以使用listen()
函数显式配置kestrelserveroptions
public class program { public static void main(string[] args) { createhostbuilder(args).build().run(); } public static ihostbuilder createhostbuilder(string[] args) => host.createdefaultbuilder(args) .configurewebhostdefaults(webbuilder => { webbuilder.usestartup<startup>(); webbuilder.usekestrel(opts => { // bind directly to a socket handle or unix socket // opts.listenhandle(123554); // opts.listenunixsocket("/tmp/kestrel-test.sock"); opts.listen(ipaddress.loopback, port: 5002); opts.listenanyip(5003); opts.listenlocalhost(5004, opts => opts.usehttps()); opts.listenlocalhost(5005, opts => opts.usehttps()); }); }); }
以上配置为kestrel
服务器设置了多个监听地址。在上面的例子中,使用了硬编码,但是实际上可以改用iconfiguration
绑定。当你使用以上方式为kestrel
服务器配置urls时,如果你还是用了其他方式对urls进行了配置,那么它覆盖其他方式的配置。如果发生这种情况,你会在程序日志中看到如下警告:
warn: microsoft.aspnetcore.server.kestrel[0]
overriding address(es) 'http://localhost:5007'. binding to endpoints defined in usekestrel() instead.
info: microsoft.hosting.lifetime[0]
now listening on: http://127.0.0.1:5002
info: microsoft.hosting.lifetime[0]
now listening on: http://[::]:5003
对我个人而言,我没有遇到过使用这方式为kestrel
服务器配置urls的场景, 但是当你需要的时候,你就可以完全控制kestrel
服务器配置。
总结
在本篇博文中,我展示了通过五种不同的方式,来设置应用程序的监听urls. useurls()
是最简单的,但是基本上不太适合在生产环境中使用。 通过命令行参数--urls
以及aspnetcore_
/dotnet
环境变量是生产环境的常用方式。在开发环境中,launchsetting.json
文件是最有用的配置方式。如果你需要细粒度的配置,你可以直接使用kestrel
服务器自带的配置选项。
到此这篇关于详解asp.net core中配置监听urls的五种方式的文章就介绍到这了,更多相关asp.net core监听urls内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!
原文: 5 ways to set the urls for an asp.net core app
作者: andrew lock
译者: lamond lu