5种设置ASP.NET Core应用程序URL的方法

默认情况下,ASP.NET Core应用程序监听以下URL:

•http://localhost:5000•https://localhost:5001

在这篇文章中,我展示了5种不同的方式来更改您的应用程序监听的URL。

•在Program.cs中使用 UseUrls()•环境变量 - 使用DOTNET_URLS或者 ASPNETCORE_URLS•命令行参数 - 设置命令行参数--urls•launchSettings.json - 设置 applicationUrl 属性•KestrelServerOptions.Listen() - 使用 Listen() 手动使用配置Kestrel服务器的地址

我将在下面更详细地介绍每个选项。

UseUrls()

设置绑定URL的第一个也是最简单的方法,在配置IWebHostBuilder的时候使用UseUrls()进行硬编码。


     
     
  1. public class Program
  2. {
  3. public static void Main(string[] args)
  4. {
  5. CreateHostBuilder(args).Build().Run();
  6. }
  7. public static IHostBuilder CreateHostBuilder(string[] args) =>
  8. Host.CreateDefaultBuilder(args)
  9. .ConfigureWebHostDefaults(webBuilder =>
  10. {
  11. webBuilder.UseStartup<Startup>();
  12. webBuilder.UseUrls( "http://localhost:5003", "https://localhost:5004");
  13. });
  14. }

环境变量

.NET Core使用两种类型的配置:

•DOTNET_URLS•ASPNETCORE_URLS

如果您同时设置了这两个环境变量,那么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"

     
     

如上所示,您还可以通过使用分号分隔多个地址来传递多个地址以进行监听(使用HTTP或HTTPS)。

命令行参数

设置主机配置值的另一种方法是使用命令行。如果设置了命令行参数,那么会覆盖环境变量的值, 只需使用--urls参数:

dotnet run --urls "http://localhost:5100"

     
     

和上面一样,您可以通过使用分号将多个URL分开来设置多个URL:

dotnet run --urls "http://localhost:5100;https://localhost:5101"

     
     

环境变量和命令行参数可能是在生产环境中为应用程序设置URL的最常见方法,但是它们对于本地开发来说有点麻烦。通常使用launchSettings.json会更容易。

launchSettings.json

大多数 .NET项目模板在Properties文件夹中都包含launchSettings.json文件,这个文件包含了启动.NET Core应用程序的各种配置文件。


     
     
  1. {
  2. "iisSettings": {
  3. "windowsAuthentication": false,
  4. "anonymousAuthentication": true,
  5. "iisExpress": {
  6. "applicationUrl": "http://localhost:38327",
  7. "sslPort": 44310
  8. }
  9. },
  10. "profiles": {
  11. "IIS Express": {
  12. "commandName": "IISExpress",
  13. "launchBrowser": true,
  14. "environmentVariables": {
  15. "ASPNETCORE_ENVIRONMENT": "Development"
  16. }
  17. },
  18. "TestApp": {
  19. "commandName": "Project",
  20. "launchBrowser": true,
  21. "applicationUrl": "https://localhost:5001;http://localhost:5000",
  22. "environmentVariables": {
  23. "ASPNETCORE_ENVIRONMENT": "Development"
  24. }
  25. }
  26. }
  27. }

launchSettings.json还提供了environmentVariables参数,您可以用它来设置环境变量,就像上面这样,然后我们可以选择不同的启动类型:

KestrelServerOptions.Listen

默认情况下,几乎所有的.NET Core应用程序都配置了Kestrel,如果需要,您可以手动配置Kestrel的端点,也可以配置KestrelServerOptions。


     
     
  1. public class Program
  2. {
  3. public static void Main(string[] args)
  4. {
  5. CreateHostBuilder(args).Build().Run();
  6. }
  7. public static IHostBuilder CreateHostBuilder(string[] args) =>
  8. Host.CreateDefaultBuilder(args)
  9. .ConfigureWebHostDefaults(webBuilder =>
  10. {
  11. webBuilder.UseStartup<Startup>();
  12. webBuilder.UseKestrel(opts =>
  13. {
  14. // Bind directly to a socket handle or Unix socket
  15. // opts.ListenHandle(123554);
  16. // opts.ListenUnixSocket("/tmp/kestrel-test.sock");
  17. opts.Listen(IPAddress.Loopback, port: 5002);
  18. opts.ListenAnyIP( 5003);
  19. opts.ListenLocalhost( 5004, opts => opts.UseHttps());
  20. opts.ListenLocalhost( 5005, opts => opts.UseHttps());
  21. });
  22. });
  23. }

我个人没有以这种方式在Kestrel中设置监听端点,但是很高兴知道可以根据需要完全控制Kestrel。

总结

在这篇文章中,我展示了五种不同的方式来设置应用程序监听的URL。UseUrls()是最简单的一种,但通常不适合在生产中使用, launchSettings.json文件是在开发环境中设置的URL是非常有用的。在生产中我们通常使用命令行参数--urls或者环境变量ASPNETCORE_URLS和DOTNET_URLS, 希望对您有帮助。

原文链接: https://andrewlock.net/5-ways-to-set-the-urls-for-an-aspnetcore-app/[1]  

欢迎扫码关注我们的公众号 【全球技术精选】,专注国外优秀博客的翻译和开源项目分享,也可以添加QQ群 897216102

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值