有以下六种监听方式:
UseUrls(),在Program.cs配置程序监听的URLs,硬编码配置监听方式,适合调试使用
lanuchSettings.json,使用applicationUrls属性来配置URLs,发布后无此文件,适合调试使用
环境变量,使用DOTNET_URLS
或者ASPNETCORE_URLS
配置URLs
命令行参数,当使用命令行启动应用时,使用--urls参数指定URLs
KestrelServerOptions.Listen()
,使用Listen()
方法手动配置Kestral
服务器监听的地址(此方式可以自己添加证书)
appsettings.json中添加Urls节点--"Urls": "http://*:9991;https://*:9993"
URL格式:
localhost:http://localhost:5000
- 指定ip:在你机器上可用的指定IP地址(例如
http://192.168.8.31:5005
) - 任何ip:使用"任何"IP地址(例如
http://*:6264
)
注意,针对"任何"IP地址的格式 - 你不一定必须使用
*
,你可以使用任何字符,只要不是IP地址或者localhost
, 这意味着你可以使用http://*
,http://+
,http://mydomain
,http://example.org
. 以上所有字符串都具有相同的行为,可以监听任何IP地址。如果你想仅处理来自单一主机名的请求,你需要额外配置主机过滤。
UseUrls():
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"); }); }
环境变量:
DOTNET_URLS
ASPNETCORE_URLS
如果你同时使用2种环境变量,系统会优先使用
ASPNETCORE_URLS
中定义的参数
命令行:
dotnet run --urls "http://localhost:5100" dotnet run --urls "http://localhost:5100;https://localhost:5101"
KestrelServerOptions.Listen():
几乎所有的ASP.NET Core应用默认都会使用Kestrel
服务器。如果你想的话,你可以手动配置Kestrel
服务器节点,或者使用IConfiguration
配置KestrelServerOptions
。
/// <summary> /// 添加服务器启动配置信息 /// </summary> /// <param name="services"></param> /// <returns></returns> public static IServiceCollection AddKestrelServer(this IServiceCollection services) { //https://www.humankode.com/asp-net-core/develop-locally-with-https-self-signed-certificates-and-asp-net-core services.Configure<KestrelServerOptions>(options => { options.AllowSynchronousIO = true;//允许同步IO,AddWebMarkupMin这个插件需要用到。 #if DEBUG options.AddServerHeader = true; #else options.AddServerHeader = false; #endif //取出configuration对象 IConfiguration configuration = (IConfiguration)options.ApplicationServices.GetService(typeof(IConfiguration)); IConfigurationSection configurationSection = configuration.GetSection("Hosts"); if (configurationSection.Exists()) { EndPoint endPoint = null; Certificate certificate = null; EndPoints enpPoints = configurationSection.Get<EndPoints>(); foreach (KeyValuePair<string, EndPoint> pair in enpPoints.Protocols) { endPoint = pair.Value; certificate = endPoint.Certificate; if (certificate == null) { options.Listen(System.Net.IPAddress.Parse(endPoint.Address), endPoint.Port); } else { options.Listen(System.Net.IPAddress.Parse(endPoint.Address), endPoint.Port, opts => { opts.UseHttps(new System.Security.Cryptography.X509Certificates.X509Certificate2(certificate.FileName, certificate.Password)); }); } } } }); return services; }
url配置:
{ "Hosts": { "Protocols": { "Http": { "Address": "0.0.0.0", "Port": "7777" } } } }