Hosting Bundle (Gói cài đặt hosting)

.NET Hosting Bundle (gói hosting .NET) là một trình cài đặt cho .NET Runtime (môi trường chạy .NET) và ASP.NET Core Module. Gói này cho phép các ứng dụng ASP.NET Core chạy với IIS.

Cài đặt .NET Hosting Bundle

Nếu Hosting Bundle được cài đặt trước IIS, việc cài đặt bundle phải được sửa chữa lại. Chạy trình cài đặt Hosting Bundle lại sau khi cài đặt IIS.

Nếu Hosting Bundle được cài đặt sau khi cài đặt phiên bản 64-bit (x64) của .NET, các SDK có thể xuất hiện là bị thiếu (No .NET SDKs were detected). Để giải quyết vấn đề này, xem Troubleshoot and debug ASP.NET Core projects.

Các thay đổi breaking change (thay đổi gây phá vỡ tương thích) và tư vấn bảo mật được báo cáo trên Announcements repo. Thông báo có thể được lọc theo phiên bản cụ thể bằng cách chọn bộ lọc Label.

Tải trực tiếp

Tải trình cài đặt bằng các liên kết sau:

Phiên bản hiện tại: .NET Hosting Bundle installer (tải trực tiếp)
Các phiên bản trước và pre-release

Yêu cầu Visual C++ Redistributable

Trên các phiên bản Windows cũ hơn, ví dụ như Windows Server 2012 R2, hãy cài đặt Visual Studio C++ 2015, 2017, 2019 Redistributable. Nếu không, một thông báo lỗi khó hiểu trong Windows Event Log sẽ báo rằng The data is the error.

Current x64 VS C++ redistributable Current x86 VS C++ redistributable

Các phiên bản trình cài đặt cũ hơn

Để lấy phiên bản trình cài đặt cũ hơn:

Điều hướng đến trang Download .NET.
Chọn phiên bản .NET mong muốn.
Trong cột Run apps - Runtime, tìm hàng của phiên bản .NET runtime mong muốn.
Tải trình cài đặt bằng liên kết Hosting Bundle.

Một số trình cài đặt chứa các phiên bản release đã đạt đến end of life (EOL - hết vòng đời hỗ trợ) và không còn được Microsoft hỗ trợ. Để biết thêm thông tin, xem chính sách hỗ trợ.

ASP.NET Core Module tương thích tiến và lùi với các phiên bản .NET đang được hỗ trợ.

Tùy chọn

Các tham số sau có thể dùng khi chạy trình cài đặt từ command shell với quyền admin:

OPT_NO_ANCM=1: Bỏ qua cài đặt ASP.NET Core Module.
OPT_NO_RUNTIME=1: Bỏ qua cài đặt .NET runtime. Dùng khi server chỉ host self-contained deployments (SCD).
OPT_NO_SHAREDFX=1: Bỏ qua cài đặt ASP.NET Shared Framework (ASP.NET runtime). Dùng khi server chỉ host self-contained deployments (SCD).
OPT_NO_X86=1: Bỏ qua cài đặt x86 runtime. Dùng tham số này khi bạn biết rằng sẽ không host các ứng dụng 32-bit. Nếu có khả năng bạn sẽ host cả ứng dụng 32-bit và 64-bit trong tương lai, không dùng tham số này và hãy cài đặt cả hai runtime.
OPT_NO_SHARED_CONFIG_CHECK=1: Vô hiệu hóa việc kiểm tra sử dụng IIS Shared Configuration khi shared configuration (applicationHost.config) nằm trên cùng máy với cài đặt IIS. Chỉ có từ ASP.NET Core 2.2 trở lên. Để biết thêm thông tin, xem Advanced configuration.

Để biết thông tin về IIS Shared Configuration, xem ASP.NET Core Module with IIS Shared Configuration.

Khi chạy trình cài đặt Hosting Bundle với các tùy chọn đã đặt, giá trị của mỗi tùy chọn được lưu trong registry. Các lần cài đặt tiếp theo từ cùng một dải phiên bản Major.Minor sẽ sử dụng các tùy chọn tương tự, trừ khi một bộ tùy chọn khác được truyền rõ ràng từ command line. Nếu lần cài đặt đầu tiên của hosting bundle không có tùy chọn nào được truyền, mỗi tùy chọn được đặt giá trị mặc định là 0 trong registry. Giá trị 0 có nghĩa là tùy chọn đó tắt, tức là người dùng không từ chối component đó.

Khởi động lại IIS

Sau khi Hosting Bundle được cài đặt, có thể cần khởi động lại IIS thủ công. Ví dụ, dotnet CLI tooling (công cụ dòng lệnh) có thể không tồn tại trong PATH để chạy các tiến trình worker của IIS.

Để khởi động lại IIS thủ công, dừng Windows Process Activation Service (WAS) rồi khởi động lại World Wide Web Publishing Service (W3SVC) và các service phụ thuộc. Thực thi các lệnh sau trong command shell với quyền admin:

console

net stop was /y
net start w3svc

Phiên bản module và log trình cài đặt Hosting Bundle

Để xác định phiên bản của ASP.NET Core Module đã cài đặt:

Trên hệ thống hosting, điều hướng đến %PROGRAMFILES%\IIS\Asp.Net Core Module\V2.
Tìm file aspnetcorev2.dll.
Nhấp chuột phải vào file và chọn Properties từ menu ngữ cảnh.
Chọn tab Details. File version và Product version đại diện cho phiên bản module đã cài đặt.

Log trình cài đặt Hosting Bundle cho module được tìm thấy tại C:\Users\%UserName%\AppData\Local\Temp. File có tên dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log, trong đó {TIMESTAMP} là dấu thời gian của file.