ASP.NET Core設(shè)置URLs的五種方法
前言
在使用ASP.NET Core 3.1開發(fā)時,需要配置服務器監(jiān)聽的端口和協(xié)議,官方幫助文檔進行簡單說明,文檔中提到了4種指定URL的方法
- 設(shè)置
ASPNETCORE_URLS
環(huán)境變量; - 使用
dotnet --urls
命令行參數(shù); - 使用
urls
作為鍵進行配置; - 使用
UseUrls
擴展方法;
為便于講清楚URLs設(shè)置方法,創(chuàng)建名為AspNetCoreUrl
的ASP.NET Core Web API程序進行說明,默認情況下,啟動ASP.NET Core后,監(jiān)聽以下URLs:
http://localhost:5000/
https://localhost:5001/
URL格式
主要有三種URL格式表達方式,可以查看官方文檔(https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/servers/kestrel?view=aspnetcore-3.1)
格式1:{scheme}://{loopbackAddress}:{port}
,例如http://localhost:5000/
、https://localhost:5001/
格式2:{scheme}://{IPAddress}:{port}
,例如http://127.0.0.1:5000/
、https://192.168.1.100:5001/
格式3:{scheme}://*:{port}
,例如http://*:5000/
、https://domain.com:5001/
前提條件
在開始測試幾種URLs設(shè)置方法前,需要先生成AspNetCoreUrl
程序,然后在生成的根目錄下打開命令行工具進行相應的測試
如圖,我這里的程序根目錄為D:\AspNetCoreUrl\AspNetCoreUrl\bin\Debug\netcoreapp3.1
,使用的終端為微軟官方的Windows PowerShell
方法1 使用環(huán)境變量
在不修改AspNetCoreUrl
任何源代碼的情況下(即創(chuàng)建項目時的程序默認狀態(tài))生成程序,定位到生成的根目錄下,打開命令行終端
# 環(huán)境變量僅在當前命令行窗口生效 $Env:ASPNETCORE_URLS = "http://localhost:7000;https://localhost:7010" # 或者使用DOTNET_URLS環(huán)境變量同樣可生效 $Env:DOTNET_URLS = "http://localhost:8000;https://localhost:8010" # 運行AspNetCoreUrl程序 dotnet AspNetCoreUrl.dll
如果使用Windows命令行(即cmd命令行),使用下面的方式設(shè)置
# 環(huán)境變量僅在當前命令行窗口生效 set ASPNETCORE_URLS=http://localhost:7000;https://localhost:7010 # 將ASPNETCORE_URLS變量保存到用戶環(huán)境變量中 setx ASPNETCORE_URLS "http://localhost:7000;https://localhost:7010" # 加/m參數(shù),將ASPNETCORE_URLS變量保存到系統(tǒng)環(huán)境變量中 setx ASPNETCORE_URLS "http://localhost:7000;https://localhost:7010" /m # 運行AspNetCoreUrl程序 dotnet AspNetCoreUrl.dll
注意:使用setx設(shè)置環(huán)境變量后,需要打開新的Windows命令行窗口才會使用環(huán)境變量生效
在Linux系統(tǒng)中使用以下命令設(shè)置環(huán)境變量
# 環(huán)境變量僅在當前終端生效,關(guān)閉終端后需要重新設(shè)置 export ASPNETCORE_URLS=http://localhost:7000;https://localhost:7010
方法2 使用命令行參數(shù)
在生成程序的根目錄下,使用dotnet --urls
命令,并帶上urls參數(shù)
dotnet AspNetCoreUrl.dll --urls http://localhost:7001;https://localhost:7011
方法3 使用配置文件
在生成程序的根目錄下,打開appsettings.json
文件,添加url配置項,然后雙擊AspNetCoreUrl.exe
運行
{ "urls":"http://localhost:7002;http://localhost:7012" }
運行結(jié)果如下圖
方法4 使用UseUrls
這種方法需要修改源代碼,打開Program.cs
文件,修改CreateHostBuilder
方法內(nèi)容,主要是添加UseUrls擴展方法然后生成程序。
public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); // 使用UseUrls設(shè)置監(jiān)聽的端口和協(xié)議 webBuilder.UseUrls("http://localhost:7003", "https://localhost:7013"); });
注意:運行前需要將appsettings.json
文件恢復到默認狀態(tài),即沒有配置urls的狀態(tài),否則配置文件中設(shè)置會覆蓋代碼中的方法。
方法5 使用Kestrel
這種方法并不在官方文檔中,因為該方法僅限于使用Kestrel的時候生效,在創(chuàng)建ASP.NET Core應用程序時,默認使用Kestrel來托管應用,使用這種方法也有相應的應用場景,這里簡單介紹下該方法的使用
打開Program.cs
文件,修改CreateHostBuilder
方法內(nèi)容
public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); // 配置Kestrel服務 webBuilder.UseKestrel(kestrelServerOptions => { kestrelServerOptions.ListenLocalhost(7004); kestrelServerOptions.ListenLocalhost(7014, listenOptions => listenOptions.UseHttps()); }); });
優(yōu)先級
前面介紹的5種方法都在獨立運行,如果將這5種方法同時用上,會有什么樣的效果呢,下面來測試下,為了便于測試,每種方法都使用了不同的端口進行區(qū)分,下面顯示了使用全部方法的運行結(jié)果:
可以看到,生效的是使用Kestrel方法,現(xiàn)在將Kestrel這種注釋掉,運行結(jié)果如下:
可以看到此時生效的是使用命令行參數(shù)方法,如果不使用命令行參數(shù)方法,運行結(jié)果如下:
生效的是配置文件中的設(shè)置,現(xiàn)在刪除配置文件中urls的配置,運行結(jié)果如下:
生效的是UseUrls擴展方法,現(xiàn)在注釋掉UseUrls方法代碼,運行結(jié)果如下:
生效的是環(huán)境變量,如果不設(shè)置環(huán)境變量,則使用默認值,即http://localhost:5000/
和https://localhost:5001/
。
總結(jié)
本文介紹了ASP.NET Core幾種常用的設(shè)置URLs的方法,大家可以根據(jù)項目實際情況選擇其中一種或幾種,如果同時使用幾種URLs設(shè)置方法,則需要留意配置的優(yōu)先級問題,經(jīng)過測試得出
Kestrel > 命令行 > 配置文件 > UseUrls > 環(huán)境變量 > 默認值
如果你想自己試一試,代碼地址:
gitee:https://gitee.com/gyhgis/AspNetCoreUrl
github:https://github.com/gyhgis/AspNetCoreUrl
到此這篇關(guān)于ASP.NET Core設(shè)置URLs的五種方法的文章就介紹到這了,更多相關(guān)ASP.NET Core設(shè)置URLs 內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
ASP.NET Core根據(jù)環(huán)境變量支持多個 appsettings.json配置文件
這篇文章主要介紹了ASP.NET Core根據(jù)環(huán)境變量支持多個 appsettings.json配置文件,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2020-08-08在 .NET Core 中使用 Diagnostics (Diagnostic Source) 記錄跟蹤信息
今天給大家講一下在 .NET Core 2 中引入的全新 DiagnosticSource 事件機制,為什么說是全新呢? 在以前的 .NET Framework 有心的同學應該知道也有 Diagnostics,那么新的 .NET Core 中有什么變化呢?跟隨小編一起看看吧2021-06-06.net?core利用PdfSharpCore操作PDF實例教程
操作pdf是我們?nèi)粘i_發(fā)中經(jīng)常遇到的功能,下面這篇文章主要給大家介紹了關(guān)于.net?core利用PdfSharpCore操作PDF實例的相關(guān)資料,文中通過示例代碼介紹的非常詳細,需要的朋友可以參考下2022-12-12relaxlife.net發(fā)布一個自己開發(fā)的中文分詞程序
relaxlife.net發(fā)布一個自己開發(fā)的中文分詞程序...2007-03-03ASP.NET在IIS上注冊報0x800702e4錯誤解決方法
報一個0x800702e4 請求的操作需要提升的錯誤。解決的方法和前面大同小異,給這個aspnet_regiis.exe創(chuàng)建一個快捷方式,給它的目標后面加上 一個-i,再右擊這個快捷方式,以管理員身份運行,就行了2012-08-08