原文：Hosting
作者：Steve Smith
翻译：娄宇(Lyrics)
校对：何镇汐、许登洋(Seay)
为了运行 Core 应用程序，你需要使用 WebHostBuilder 配置和启动一个宿主.
什么是宿主？
Core 应用程序需要在宿主中执行。宿主必须实现 IWebHost 接口，这个接口暴露了功能和服务的集合，以及Start方法。宿主通常使用 WebHostBuilder 的实例进行创建，该实例构建并返回一个 WebHost 实例。WebHost引用服务器来处理请求。学习更多关于 服务器。
宿主和服务器的不同之处是什么？
宿主负责应用程序启动和生命周期管理。服务器负责接受 HTTP 请求。确保应用程序服务和服务器可用并正确配置也是宿主职责的一部分。你可以把宿主看作是服务器的包装。宿主被配置为使用一个特定的服务器；服务器并不知道它的宿主。
设置宿主
使用WebHostBuilder实例创建一个宿主。这通常是在你的应用程序入口点：public static void Main，（在项目模板的Program.cs文件中）。一个典型的Program.cs如下所示，演示如何使用WebHostBuilder来构建一个宿主。
using System;using System.Collections.Generic;using System.IO;using System.Linq;using System.Threading.Tasks;using Microsoft.AspNetCore.Hosting;namespace WebApplication1{public class Program{public static void Main(string[] args){var host = new WebHostBuilder().UseKestrel().UseContentRoot(Directory.GetCurrentDirectory()).UseIISIntegration().UseStartup<Startup>().Build();host.Run();}}}
WebHostBuilder负责创建宿主，宿主会启动应用程序服务器。WebHostBuilder需要你提供实现了 IServer （上面代码中的UseKestrel） 接口的服务器。UseKestrel指定应用程序会使用 Kestrel 服务器。
服务器的内容根 ( content root )决定它将在哪里搜索内容文件，比如 MVC 视图文件。默认的内容根是应用程序运行的文件夹。
注解
指定
Directory.GetCurrentDirectory作为内容根时，当应用程序启动时会使用 Web 项目的根目录作为应用程序的内容根（比如，从 Web 项目文件夹调用dotnet run）。Visual Studio 和dotnet new的模板是默认使用Directory.GetCurrentDirectory作为内容根的。
如果应用程序需要使用 IIS，需要在构建宿主时调用UseIISIntegration方法。注意这不是像UseKestrel那样配置一个服务器。为了让 Core 使用 IIS，你必须同时指定UseKestrel和UseIISIntegration。Kestrel 被设计为在代理后运行而不应该直接部署到互联网。UseIISIntegration指定 IIS 为反向代理服务器。
注解
UseKestrel与UseIISIntegration行为区别非常大。IIS 只是作为一个反向代理。UseKestrel创建 Web 服务器并且对代码进行托管。UseIISIntegration指定 IIS 作为反向代理服务器。它同时也检查了 IIS/IISExpress 使用的环境变量并做出比如使用哪个动态端口，设置什么 Header 等决定。然而它不处理或者创建IServer。
配置一个宿主（以及一个 Core 应用程序）的最小实现仅仅包含一个服务器和应用程序请求管道的配置：
var host = new WebHostBuilder().UseKestrel().Configure(app =>{app.Run(async (context) => await context.Response.WriteAsync("Hi!"));}).Build();host.Run();
注解
当设置一个宿主，你可以提供
Configure和ConfigureServices方法，或者定义一个Startup类（也必须定义这些方法，参见 :doc:startup）。多次调用ConfigureServices会进行追加配置；多次调用Configure或者UseStartup会替换之前的设置。
配置宿主
WebHostBuilder提供了方法用于为宿主设置大多数可用的配置值，它也可以被设置为直接使用UseSetting以及相关的键。比如，指定应用程序名字：
new WebHostBuilder().UseSetting("applicationName", "MyApp")
宿主配置值
应用程序名string
键:applicationName。这个配置设定指定的值将从IHostingEnvironment.ApplicationName返回。
捕获启动异常bool
键：captureStartupErrors。默认是false。当值为false时，在启动过程中的错误会导致宿主退出。当值为true时，宿主会捕捉Startup类中的任何异常，并试图启动服务器。同时将为每个请求显示错误页面（一般的，或详细的，这取决于下面提到的详细错误设置）。 可使用CaptureStartupErrors方法设置。
new WebHostBuilder().CaptureStartupErrors(true)
内容根string
Key:contentRoot。默认是应用程序集所在的文件夹（针对 Kestrel；IIS 默认使用 Web 项目根目录）。这个设置决定了 Core 从哪里开始搜索内容文件，比如 MVC 视图。内容根同时被作为 Web 根设置 的基础路径使用。可使用UseContentRoot方法设置。路径必须是存在的，否则宿主会启动失败。
new WebHostBuilder().UseContentRoot("c:\\mywebsite")
详细错误bool
键：detailedErrors。默认是false。当值是true时（或者当环境设置为“Development”时），应用程序会显示详细的启动错误信息，而不仅仅是一般的错误页。可使用UseSetting设置。
new WebHostBuilder().UseSetting("detailedErrors", "true")
当详细错误设置为false并且捕捉启动异常是true时，服务器在每个请求的（错误）响应中显示一般错误页。
当详细错误设置为true并且捕捉启动异常是true时，服务器在每个请求的（错误）响应中显示详细错误页。
环境string
键：environment。默认是“Production”。可以设置为任何值。框架定义的值包含“Development”，“Staging”，以及“Production”。值不区分大小写。参见 environments。可使用UseEnvironment方法设置。
new WebHostBuilder().UseEnvironment("Development")
注解
默认情况下，环境是从
ASPNETCORE_ENVIRONMENT环境变量中读取。当使用 Visual Studio，环境变量可能在launchSettings.json文件中进行设置。
服务器 URLsstring
键：urls。设置分号（;）来分隔服务器应该响应的 URL 前缀。比如，"http://localhost:123"。域名可以用“”替换，表明服务器需要针对任何使用指定端口及协议的 IP 地址或域名监听请求（比如，“http://:5000”或者 “https://*:5001”）。协议（“http://”或者“https://”）必须包含在每个URL里。前缀由配置好的服务器解释；服务器之间支持的格式会有所不同。
new WebHostBuilder().UseUrls("http://*:5000;http://localhost:5001;https://hostname:5002")
启动程序集string
键：startupAssembly。决定搜索Startup类的程序集。可使用UseStartup方法设置。可以使用WebHostBuilder.UseStartup<StartupType>指定特定的引用类型。如果调用多次UseStartup方法，最后一个调用的生效。
new WebHostBuilder().UseStartup("StartupAssemblyName")
Web 根string
键：webroot。如果不指定，默认是(Content Root Path)\wwwroot，如果该路径存在。如果这个路径不存在，则使用一个没有文件操作的提供器。可使用UseWebRoot方法设置。
new WebHostBuilder().UseWebRoot("public")
使用 configuration 来设置宿主所需的配置值。这些值可能随后被重写。可使用UseConfiguration指定。
public static void Main(string[] args){var config = new ConfigurationBuilder().AddCommandLine(args).AddJsonFile("hosting.json", optional: true).Build();var host = new WebHostBuilder().UseConfiguration(config).UseKestrel().Configure(app =>{app.Run(async (context) => await context.Response.WriteAsync("Hi!"));}).Build();host.Run();}
在上面的例子中，可以通过命令行参数配置宿主，或者在hosting.json文件中进行配置。要指定在特定的网址上运行宿主，你可以从命令行传递所需要的值：
dotnet run --urls "http://*:5000"
Run方法启动 Web 应用程序并且阻止调用线程，直到宿主关闭。
host.Run();
你可以通过调用宿主的Start方法来以非阻塞方式运行宿主。
using (host){host.Start();Console.ReadLine();}
传递一个 URL 列表到Start方法，它将监听指定的 URL：
var urls = new List<string>() {"http://*:5000","http://localhost:5001"};var host = new WebHostBuilder().UseKestrel().UseStartup<Startup>().Start(urls.ToArray());using (host){Console.ReadLine();}
排序的重要性
WebHostBuilder首先读取某些环境变量中的设置（如果环境变量中设置了）。这些环境变量必须采用格式ASPNETCORE_{configurationKey}，因此假如要设置默认情况下服务器监听的 URL，你需要设置ASPNETCORE_URLS。
你可以通过指定配置来重写任何环境变量（使用UseConfiguration）或者明确地设置值（例如使用UseUrls）。宿主会使用任何选项最后设置的值。因此，UseIISIntegration必须出现在UseUrls之后，因为它将替换 IIS 动态提供的 URL。如果你想以编程方式设置默认 URL 的值，但是允许他通过配置重写，你需要如下配置宿主：
var config = new ConfigurationBuilder().AddCommandLine(args).Build();var host = new WebHostBuilder().UseUrls("http://*:1000") // default URL.UseConfiguration(config) // override from command line.UseKestrel().Build();
