翻譯如下:
支持的操作系統
Windows 7及更高版本
Windows Server 2008 R2及更高版本
概念上,本文檔中描述的IIS配置也適用於在Nano Server IIS上托管ASP.NET Core應用程序,但是請參閱Nano Server上的ASP.NET Core 以獲取特定說明。
IIS配置
啟用Web服務器(IIS)服務器角色並建立角色服務。
Windows桌面操作系統:
導航到:控制面板>程序>程序和功能>打開或關閉Windows功能(屏幕左側), 打開Internet信息服務和Web管理工具組。 選中IIS Management Console 的框。 選中World Wide Web Services的框。 接受World Wide Web Services 的默認功能或自定義IIS功能 以滿足您的需要。
Windows Server操作系統:
對於服務器操作系統,請通過管理菜單或服務器管理器中的鏈接使用添加角色和功能向導。 在服務器角色步驟中,選中Web服務器(IIS)的框。
在“角色服務”步驟上,選擇所需的IIS角色服務或接受所提供的默認角色服務。
繼續執行確認步驟以啟用Web服務器角色和服務。
安裝.NET核心Windows Server主機包
在服務器上安裝.NET Core Windows Server Hosting軟件包。該包將安裝.NET核心運行時,.NET核心庫和ASP.NET核心模塊。該模塊在IIS和Kestrel服務器之間創建反向代理。
重新啟動服務器或執行net stop was / y,然后從命令行啟動net start w3svc,以檢索對系統PATH的更改。
有關ASP.NET核心模塊的更多信息,包括模塊的配置和使用web.config設置環境變量,使用app_offline.htm掛起請求處理和激活模塊日志記錄,請參閱ASP.NET核心模塊配置參考。
應用程序配置
啟用IISIntegration組件
在應用程序依賴項中包含對Microsoft.AspNetCore.Server.IISIntegration軟件包的依賴項。通過將.UseIISIntegration()擴展方法添加到WebHostBuilder(),將IIS集成中間件合並到應用程序中。
var host = new WebHostBuilder() .UseKestrel() .UseContentRoot(Directory.GetCurrentDirectory()) .UseIISIntegration() .UseStartup<Startup>() .Build();
請注意,調用.UseIISIntegration()的代碼不會影響代碼的可移植性。
為IISIntegration服務設置IISOptions
要配置IISIntegration服務選項,請在ConfigureServices中包含IISOptions的服務配置。
services.Configure<IISOptions>(options => { ... });
常見錯誤
以下不是完整的錯誤列表。 如果您遇到此處未列出的錯誤,請在下面的DISQUS部分留下詳細的錯誤消息(單擊顯示注釋以打開DISQUS面板)。
要診斷IIS部署的問題,請研究瀏覽器輸出,通過事件查看器檢查服務器的應用程序日志,並啟用模塊日志記錄。 ASP.NET Core模塊日志將在web.config中<aspNetCore>元素的stdoutLogFile屬性中提供的路徑上找到。 屬性值中提供的路徑上的任何文件夾必須在部署中存在。 您還必須設置stdoutLogEnabled =“true”以啟用模塊日志記錄。 使用publish-iis工具創建web.config文件的應用程序將默認stdoutLogEnabled設置為false,因此必須手動提供文件或修改文件以啟用模塊日志記錄。