다음을 통해 공유

.NET Core 호스팅 번들

참고

이 문서의 최신 버전은 아닙니다. 현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

경고

이 버전의 ASP.NET Core는 더 이상 지원되지 않습니다. 자세한 내용은 .NET 및 .NET Core 지원 정책을 참조 하세요. 현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

중요

이 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.

현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.

.NET Core 호스팅 번들은 .NET Core 런타임 및 ASP.NET Core 모듈용 설치 관리자입니다. 번들을 통해 ASP.NET Core 앱을 IIS에서 실행할 수 있습니다.

.NET Core 호스팅 번들 설치

중요

IIS 이전에 호스팅 번들이 설치된 경우 번들 설치를 복구해야 합니다. IIS를 설치한 후 호스팅 번들 설치 프로그램을 다시 실행합니다.

.NET Core의 64비트(x64) 버전을 설치한 후 호스팅 번들이 설치된 경우 SDK가 누락된 것처럼 보일 수 있습니다( .NET Core SDK가 검색되지 않음). 문제를 해결하려면 ASP.NET Core 프로젝트 문제 해결 및 디버그를 참조하세요.

주요 변경 내용 및 보안 권고는 공지 리포지토리에 보고됩니다. 레이블 필터를 선택하여 공지를 특정 버전으로 제한할 수 있습니다.

직접 다운로드

다음 링크를 사용하여 설치 관리자를 다운로드합니다.

Visual C++ 재배포 가능 패키지 요구 사항

이전 버전의 Windows(예: Windows Server 2012 R2)에는 Visual Studio C++ 2015, 2017, 2019 재배포 가능 패키지를 설치하세요. 그렇지 않으면 Windows 이벤트 로그의 혼란스러운 오류 메시지가 다음을 보고합니다. The data is the error.

현재 x64 VS C++ 재배포 가능 패키지현재 x86 VS C++ 재배포 가능 패키지

이전 버전의 설치 프로그램

이전 버전의 설치 관리자를 가져오려면:

  1. .NET Core 다운로드 페이지로 이동합니다.
  2. 원하는 .NET Core 버전을 선택합니다.
  3. 앱 실행 - 런타임 열에서 원하는 .NET Core 런타임 버전의 행을 찾습니다.
  4. 호스팅 번들 링크를 사용하여 설치 관리자를 다운로드합니다.

경고

일부 설치 관리자는 EOL(수명 종료)에 도달한 릴리스 버전을 포함하고 Microsoft에서 더 이상 지원되지 않습니다. 자세한 내용은 지원 정책을 참조하세요.

ASP.NET Core 모듈은 .NET의 지원 내 릴리스와 전방향 및 이전 버전과 호환됩니다.

옵션

  1. 관리자 명령 셸에서 설치 관리자를 실행할 때 다음 매개 변수를 사용할 수 있습니다.

    • OPT_NO_ANCM=1: ASP.NET Core 모듈 설치를 건너뜁니다.
    • OPT_NO_RUNTIME=1: .NET Core 런타임 설치를 건너뜁니다. 서버에서 SCD(자체 포함 배포)만 호스트하는 경우에 사용됩니다.
    • OPT_NO_SHAREDFX=1: ASP.NET 공유 프레임워크(ASP.NET 런타임) 설치를 건너뜁니다. 서버에서 SCD(자체 포함 배포)만 호스트하는 경우에 사용됩니다.
    • OPT_NO_X86=1: x86 런타임 설치를 건너뜁니다. 32비트 앱을 호스팅하지 않음을 아는 경우 이 매개 변수를 사용합니다. 향후 32비트와 64비트 앱을 모두 호스트할 수 있는 기회가 있는 경우 이 매개 변수를 사용하지 않고 두 런타임을 모두 설치합니다.
    • OPT_NO_SHARED_CONFIG_CHECK=1: 공유 구성(applicationHost.config)이 IIS 설치와 동일한 컴퓨터에 있는 경우 IIS 공유 구성 사용에 대한 검사를 사용하지 않도록 설정합니다. ASP.NET Core 2.2 이상 호스팅 번들러 설치 관리자에 대해서만 사용할 수 있습니다. 자세한 내용은 고급 구성을 참조하세요.

참고 항목

IIS 공유 구성에 대한 자세한 내용은 IIS 공유 구성을 사용하는 ASP.NET Core 모듈을 참조하세요.

참고 항목

옵션을 설정하여 호스팅 번들 설치 관리자를 실행하는 경우 각 옵션의 값은 레지스트리에 저장됩니다. 다른 옵션 집합이 명령줄에서 명시적으로 전달되는 경우가 아니면 동일한 주 버전.부 버전 밴드에서 이후 설치는 동일한 옵션을 사용합니다. 호스팅 번들의 첫 번째 설치에 전달된 옵션이 없는 경우 각 옵션은 레지스트리에 작성된 0의 기본값을 가져옵니다. 값 0은 옵션이 꺼져 있음을 의미합니다. 즉, 사용자가 지정된 구성 요소에서 옵트아웃하지 않습니다.

IIS 다시 시작

호스팅 번들을 설치한 후 수동 IIS 다시 시작이 필요할 수 있습니다. 예를 들어 dotnet CLI 도구(명령)가 IIS 작업자 프로세스 실행 경로에 없을 수 있습니다.

IIS를 수동으로 다시 시작하려면 WAS(Windows Process Activation Service)를 중지한 다음, W3SVC(World Wide Web Publishing 서비스)와 모든 종속 서비스를 다시 시작합니다. 관리자 권한 명령 셸에서 다음 명령을 실행합니다.

net stop was /y
net start w3svc

모듈 버전 및 호스팅 번들 설치 관리자 로그

설치된 ASP.NET Core 모듈의 버전을 확인하려면:

  1. 호스팅 시스템에서 %PROGRAMFILES%\IIS\Asp.Net Core Module\V2.
  2. aspnetcorev2.dll 파일을 찾습니다.
  3. 파일을 마우스 오른쪽 단추로 클릭하고 상황에 맞는 메뉴에서 속성을 선택합니다.
  4. 세부 정보 탭을 선택합니다. 파일 버전 및 제품 버전은 설치된 모듈 버전을 나타냅니다.

모듈의 호스팅 번들 설치 관리자 로그는 C:\Users\%UserName%\AppData\Local\Temp에 있습니다. 파일 이름은 dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log입니다. 여기서 자리 표시자 {TIMESTAMP}는 파일의 타임스탬프입니다.