daohualiuxiang
/
AspNetCore.Docs
mirror of https://github.com/dotnet/AspNetCore.Docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update Kestrel topic endpoint config section (#11266) 

Fixes #11263

Moves the URL-setting approaches up in the *Endpoint configuration* section prior to their first mention in the section (provides context for the following remarks).

Thanks @gaziqbal.
pull/11286/head
Luke Latham 2019-03-05 14:35:11 -06:00 committed by Rick Anderson
parent 1fd1d3af01
commit 3e581bfabf
1 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
aspnetcore/fundamentals/servers/kestrel.md
View File

@ -4,7 +4,7 @@ author: guardrex
description: Learn about Kestrel, the cross-platform web server for ASP.NET Core.
ms.author: tdykstra
ms.custom: mvc
ms.date: 02/13/2019
ms.date: 03/04/2019
uid: fundamentals/servers/kestrel
---
# Kestrel web server implementation in ASP.NET Core
@ -411,6 +411,17 @@ By default, ASP.NET Core binds to:
* `http://localhost:5000`
* `https://localhost:5001` (when a local development certificate is present)
Specify URLs using the:
* `ASPNETCORE_URLS` environment variable.
* `--urls` command-line argument.
* `urls` host configuration key.
* `UseUrls` extension method.
The value provided using these approaches can be one or more HTTP and HTTPS endpoints (HTTPS if a default cert is available). Configure the value as a semicolon-separated list (for example, `"Urls": "http://localhost:8000;http://localhost:8001"`).
For more information on these approaches, see [Server URLs](xref:fundamentals/host/web-host#server-urls) and [Override configuration](xref:fundamentals/host/web-host#override-configuration).
A development certificate is created:
* When the [.NET Core SDK](/dotnet/core/sdk) is installed.
@ -424,7 +435,7 @@ Call <xref:Microsoft.AspNetCore.Server.Kestrel.Core.KestrelServerOptions.Listen*
`UseUrls`, the `--urls` command-line argument, `urls` host configuration key, and the `ASPNETCORE_URLS` environment variable also work but have the limitations noted later in this section (a default certificate must be available for HTTPS endpoint configuration).
ASP.NET Core 2.1 `KestrelServerOptions` configuration:
ASP.NET Core 2.1 or later `KestrelServerOptions` configuration:
### ConfigureEndpointDefaults(Action&lt;ListenOptions&gt;)
@ -479,17 +490,6 @@ Supported configurations described next:
Kestrel listens on `http://localhost:5000` and `https://localhost:5001` (if a default cert is available).
Specify URLs using the:
* `ASPNETCORE_URLS` environment variable.
* `--urls` command-line argument.
* `urls` host configuration key.
* `UseUrls` extension method.
For more information, see [Server URLs](xref:fundamentals/host/web-host#server-urls) and [Override configuration](xref:fundamentals/host/web-host#override-configuration).
The value provided using these approaches can be one or more HTTP and HTTPS endpoints (HTTPS if a default cert is available). Configure the value as a semicolon-separated list (for example, `"Urls": "http://localhost:8000;http://localhost:8001"`).
*Replace the default certificate from configuration*
<xref:Microsoft.AspNetCore.WebHost.CreateDefaultBuilder*> calls `serverOptions.Configure(context.Configuration.GetSection("Kestrel"))` by default to load Kestrel configuration. A default HTTPS app settings configuration schema is available for Kestrel. Configure multiple endpoints, including the URLs and the certificates to use, either from a file on disk or from a certificate store.